tide tbasic manual

Copyright Tibbo Technology 2000-2012

TIDE and Tibbo BASIC User Manual

Tibbo Technology Inc.

TIDE and Tibbo BASIC User ManualI

2000-2011 Tibbo Technology Inc.

Table of Contents

Taiko R2 1

................................................................................................................................... 1Legal Information

Overview 4

................................................................................................................................... 4Our Language Philosophy

................................................................................................................................... 7System Components

............................................................................................................................................................... 8Objects

............................................................................................................................................................... 8Events

Getting Started 9

................................................................................................................................... 9Preparing Your Hardware

................................................................................................................................... 10Starting a New Project

................................................................................................................................... 11Writing Code

................................................................................................................................... 14Building, Uploading and Running

................................................................................................................................... 15Compiling a Final Binary

Programming with TIDE 15

................................................................................................................................... 15Managing Projects

............................................................................................................................................................... 16The Structure of a Project

............................................................................................................................................................... 17Creating, Opening and Saving Projects

............................................................................................................................................................... 18Adding, Removing and Saving Files

............................................................................................................................................................... 20Resource Files

............................................................................................................................................................... 20Built-in Image Editor

............................................................................................................................................................... 22Coding Your Project

............................................................................................................................................................ 22Project Brow ser

............................................................................................................................................................ 23Code Auto-completion

............................................................................................................................................................ 24Code Hinting

............................................................................................................................................................ 24Tooltips

.......................................................................................................................................................... 26Supported HTML Tags

............................................................................................................................................................... 26Making, Uploading and Running an Executable Binary

............................................................................................................................................................ 27Two Modes of Target Execution

............................................................................................................................................................... 28Debugging Your Project

............................................................................................................................................................ 28Target States

.......................................................................................................................................................... 29Exceptions

............................................................................................................................................................ 30Program Pointer

............................................................................................................................................................ 30Breakpoints

............................................................................................................................................................ 31The Call Stack and Stack Pointer

............................................................................................................................................................ 33Stepping

............................................................................................................................................................ 33The Watch

.......................................................................................................................................................... 37Scopes in Watch

............................................................................................................................................................ 37Code Profiling

............................................................................................................................................................... 38Project Settings

............................................................................................................................................................... 39Device Explorer

............................................................................................................................................................ 41Upload Function

............................................................................................................................................................... 41Protecting Your Device with a Password

................................................................................................................................... 43Programming Fundamentals

............................................................................................................................................................... 43Program Structure

............................................................................................................................................................... 45Code Basics

............................................................................................................................................................... 47Naming Conventions

IIContents


............................................................................................................................................................... 47Introduction to Variables, Constants and Scopes

............................................................................................................................................................ 48Variables And Their Types

............................................................................................................................................................ 50Type Conversion

............................................................................................................................................................ 52Type conversion in expressions

............................................................................................................................................................ 53Compile-time Calculations

............................................................................................................................................................ 54Arrays

............................................................................................................................................................ 58Structures

............................................................................................................................................................ 59Enumeration Types

............................................................................................................................................................ 61Understanding the Scope of Variables

............................................................................................................................................................ 64Declaring Variables

............................................................................................................................................................ 65Constants

............................................................................................................................................................... 66Introduction to Procedures

............................................................................................................................................................ 68Passing Arguments to Procedures

............................................................................................................................................................ 70Memory Allocation for Procedures

............................................................................................................................................................... 72Introduction to Control Structures

............................................................................................................................................................ 72Decision Structures

............................................................................................................................................................ 72Loop Structures

............................................................................................................................................................ 73Doevents

............................................................................................................................................................... 76Using Preprocessor

............................................................................................................................................................ 78Scope of Preprocessor Directives

............................................................................................................................................................... 79Working with HTML

............................................................................................................................................................ 80Embedding Code Within an HTML File

............................................................................................................................................................... 82Understanding Platforms

............................................................................................................................................................ 82Objects, Events and Platform Functions

Language Reference 83

................................................................................................................................... 83Statements

............................................................................................................................................................... 84Const Statement

............................................................................................................................................................... 84Declare Statement

............................................................................................................................................................... 86Dim Statement

............................................................................................................................................................... 87Doevents Statement

............................................................................................................................................................... 87Do... Loop Statement

............................................................................................................................................................... 88Enum Statement

............................................................................................................................................................... 89Exit Statement

............................................................................................................................................................... 90For... Next Statement

............................................................................................................................................................... 91Function Statement

............................................................................................................................................................... 93Goto Statement

............................................................................................................................................................... 94If.... Then... Else Statement

............................................................................................................................................................... 95Include Statement

............................................................................................................................................................... 96Includepp Statement

............................................................................................................................................................... 97Select-Case Statement

............................................................................................................................................................... 99Sub Statement

............................................................................................................................................................... 100Type Statement

............................................................................................................................................................... 101While-Wend Statement

................................................................................................................................... 102Keywords

............................................................................................................................................................... 102As

............................................................................................................................................................... 102Boolean

............................................................................................................................................................... 102ByRef

............................................................................................................................................................... 102Byte

............................................................................................................................................................... 102ByVal

............................................................................................................................................................... 103Char

............................................................................................................................................................... 103Else

............................................................................................................................................................... 103End

............................................................................................................................................................... 103False

............................................................................................................................................................... 103For

............................................................................................................................................................... 103Integer

............................................................................................................................................................... 103Next

TIDE and Tibbo BASIC User ManualIII


............................................................................................................................................................... 104Public

............................................................................................................................................................... 104Short

............................................................................................................................................................... 104Step

............................................................................................................................................................... 104String

............................................................................................................................................................... 104Then

............................................................................................................................................................... 104Type

............................................................................................................................................................... 104To

............................................................................................................................................................... 104True

............................................................................................................................................................... 104Word

................................................................................................................................... 105Operators

................................................................................................................................... 106Error Messages

............................................................................................................................................................... 107C1001

............................................................................................................................................................... 107C1002

............................................................................................................................................................... 107C1003

............................................................................................................................................................... 108C1004

............................................................................................................................................................... 108C1005

............................................................................................................................................................... 108C1006

............................................................................................................................................................... 109C1007

............................................................................................................................................................... 109C1008

............................................................................................................................................................... 110C1009

............................................................................................................................................................... 110C1010

............................................................................................................................................................... 111C1011

............................................................................................................................................................... 111C1012

............................................................................................................................................................... 111C1013

............................................................................................................................................................... 112C1014

............................................................................................................................................................... 112C1015

............................................................................................................................................................... 113C1016

............................................................................................................................................................... 113C1017

............................................................................................................................................................... 113C1018

............................................................................................................................................................... 114C1019

............................................................................................................................................................... 114C1020

............................................................................................................................................................... 114C1021

............................................................................................................................................................... 115C1022

............................................................................................................................................................... 115C1023

............................................................................................................................................................... 116C1024

............................................................................................................................................................... 116L1001

............................................................................................................................................................... 116L1002

............................................................................................................................................................... 117L1003

............................................................................................................................................................... 117L1004

............................................................................................................................................................... 117L1005

............................................................................................................................................................... 117L1006

............................................................................................................................................................... 118L1007

............................................................................................................................................................... 118L1008

............................................................................................................................................................... 118L1009

................................................................................................................................... 119Objects, Properties, Methods, Events

Development Environment 119

................................................................................................................................... 119Installation Requirements

................................................................................................................................... 119User Interface

............................................................................................................................................................... 120Main Window

............................................................................................................................................................... 120Operation Modes

............................................................................................................................................................... 121Menu Bar

............................................................................................................................................................ 121File Menu

............................................................................................................................................................ 122Edit Menu

............................................................................................................................................................ 122View Menu

............................................................................................................................................................ 123Project Menu

IVContents


............................................................................................................................................................ 124Debug Menu

............................................................................................................................................................ 124Image Menu

............................................................................................................................................................ 125Window Menu

............................................................................................................................................................ 125Help Menu

............................................................................................................................................................... 126Toolbars

............................................................................................................................................................ 126Project Toolbar

............................................................................................................................................................ 126Debug Toolbar

............................................................................................................................................................ 127Image Editor Toolbar

............................................................................................................................................................ 128Tool Properties Toolbar

.......................................................................................................................................................... 128Selection Tool Properties

.......................................................................................................................................................... 128Paint Tool Properties

.......................................................................................................................................................... 128Eraser Tool Properties

.......................................................................................................................................................... 129Text Tool Properties

.......................................................................................................................................................... 129Line Tool Properties

.......................................................................................................................................................... 129Rectangle Tool Properties

.......................................................................................................................................................... 130Ellipse Tool Properties

.......................................................................................................................................................... 130Zoom Tool Properties

............................................................................................................................................................... 130Status Bar

............................................................................................................................................................... 131Dialogs

............................................................................................................................................................ 131Project Settings

............................................................................................................................................................ 132New Project

............................................................................................................................................................ 132Add File to Project

............................................................................................................................................................ 133Graphic File Properties Dialog

............................................................................................................................................................... 133Panes

............................................................................................................................................................ 133Call Stack

............................................................................................................................................................ 133Output

............................................................................................................................................................ 134Project

.......................................................................................................................................................... 134Brow ser

.......................................................................................................................................................... 134Files

............................................................................................................................................................ 135Watch

............................................................................................................................................................ 135Colors

............................................................................................................................................................... 136Language Element Icons

Glossary of Terms 136

................................................................................................................................... 136Compilation Unit

................................................................................................................................... 136Compiler

................................................................................................................................... 136Construct

................................................................................................................................... 136Cross-Debugging

................................................................................................................................... 137Identifier

................................................................................................................................... 137Keyword

................................................................................................................................... 137Label

................................................................................................................................... 137Linker

................................................................................................................................... 137P-Code

................................................................................................................................... 137Syscall

................................................................................................................................... 137Target

................................................................................................................................... 137Virtual Machine

Platforms 138

................................................................................................................................... 138Platform Specifications

............................................................................................................................................................... 138EM500W

............................................................................................................................................................ 140Platform-specific Constants

.......................................................................................................................................................... 140Enum pl_redir

.......................................................................................................................................................... 141Enum pl_io_num

TIDE and Tibbo BASIC User ManualV


.......................................................................................................................................................... 142Enum pl_io_port_num

.......................................................................................................................................................... 142Enum pl_int_num

.......................................................................................................................................................... 142Enum pl_sock_interfaces

............................................................................................................................................................ 143Connecting External Flash IC

............................................................................................................................................................... 143EM1000 and EM1000W Platforms


.......................................................................................................................................................... 146Enum pl_redir

.......................................................................................................................................................... 147Enum pl_io_num


.......................................................................................................................................................... 150Enum pl_int_num




.......................................................................................................................................................... 153Enum pl_redir

.......................................................................................................................................................... 154Enum pl_io_num


.......................................................................................................................................................... 157Enum pl_int_num




.......................................................................................................................................................... 160Enum pl_redir

.......................................................................................................................................................... 161Enum pl_io_num


.......................................................................................................................................................... 163Enum pl_int_num


............................................................................................................................................................... 164DS1100 Platform


.......................................................................................................................................................... 166Enum pl_redir

.......................................................................................................................................................... 167Enum pl_io_num


.......................................................................................................................................................... 167Enum pl_int_num


............................................................................................................................................................... 168DS1101W Platform


.......................................................................................................................................................... 170Enum pl_redir

.......................................................................................................................................................... 171Enum pl_io_num


.......................................................................................................................................................... 174Enum pl_int_num


............................................................................................................................................................... 174DS1102W Platform


.......................................................................................................................................................... 177Enum pl_redir

.......................................................................................................................................................... 178Enum pl_io_num


.......................................................................................................................................................... 180Enum pl_int_num


............................................................................................................................................................... 181DS1202 Platform


.......................................................................................................................................................... 183Enum pl_redir

.......................................................................................................................................................... 184Enum pl_io_num


.......................................................................................................................................................... 185Enum pl_int_num


............................................................................................................................................................... 186DS1206 Platform


.......................................................................................................................................................... 188Enum pl_redir

.......................................................................................................................................................... 189Enum pl_io_num


.......................................................................................................................................................... 191Enum pl_int_num

VIContents



............................................................................................................................................................... 191Common Information

............................................................................................................................................................ 192Supported Variable Types

............................................................................................................................................................ 192Supported Functions

............................................................................................................................................................ 194GPIO Type

............................................................................................................................................................ 195RTS/CTS Remapping

............................................................................................................................................................ 196Serial Port FIFOs

............................................................................................................................................................ 196Clock Frequency (PLL) Control

............................................................................................................................................................ 197Special Configuration Section of the EEPROM

............................................................................................................................................................ 199Device Serial Number

............................................................................................................................................................ 200Flash Memory Configuration

............................................................................................................................................................ 200Status LEDs

............................................................................................................................................................ 201Setup (MD) Button (Line)

............................................................................................................................................................ 201Connecting GA1000

............................................................................................................................................................ 204Debug Communications

............................................................................................................................................................ 205Serial Channels vs. Serial Ports

................................................................................................................................... 205Function Reference

............................................................................................................................................................... 205Aes128dec Function

............................................................................................................................................................... 206Aes128enc Function

............................................................................................................................................................... 206Asc Function

............................................................................................................................................................... 207Bin Function

............................................................................................................................................................... 207Cfloat Function

............................................................................................................................................................... 208Chr Function

............................................................................................................................................................... 208Date Function

............................................................................................................................................................... 209Daycount Function

............................................................................................................................................................... 210Ddstr Function

............................................................................................................................................................... 210Ddval Function

............................................................................................................................................................... 211Ftostr Function

............................................................................................................................................................... 212Hex Function

............................................................................................................................................................... 213Hours Function

............................................................................................................................................................... 213.Insert Function

............................................................................................................................................................... 214Instr Function

............................................................................................................................................................... 214Lbin Function

............................................................................................................................................................... 215Left Function

............................................................................................................................................................... 215Len Function

............................................................................................................................................................... 216Lhex Function

............................................................................................................................................................... 216Lstr Function

............................................................................................................................................................... 217Lstri Function

............................................................................................................................................................... 218Lval Function

............................................................................................................................................................... 218Md5 Function

............................................................................................................................................................... 219Mid Function

............................................................................................................................................................... 220Mincount Function

............................................................................................................................................................... 221Minutes Function

............................................................................................................................................................... 221Month Function

............................................................................................................................................................... 222Random Function

............................................................................................................................................................... 222Rc4 Function

............................................................................................................................................................... 223Right Function

............................................................................................................................................................... 223Sha1 Function

............................................................................................................................................................... 225Str Function

............................................................................................................................................................... 225Strand Function

............................................................................................................................................................... 226Strgen Function

............................................................................................................................................................... 226Stri Function

............................................................................................................................................................... 227Stror Function

............................................................................................................................................................... 227Strsum Function

............................................................................................................................................................... 228Strtof Function

............................................................................................................................................................... 228Strxor Function

............................................................................................................................................................... 229Val Function

............................................................................................................................................................... 230Vali Function

TIDE and Tibbo BASIC User ManualVII


............................................................................................................................................................... 230Weekday Function

............................................................................................................................................................... 230Year Function

................................................................................................................................... 231Object Reference

............................................................................................................................................................... 232Beep Object

............................................................................................................................................................ 232.Divider Property

............................................................................................................................................................ 233On_beep Event

............................................................................................................................................................ 233.Play Method

............................................................................................................................................................... 234Button Object

............................................................................................................................................................ 234On_button_pressed Event

............................................................................................................................................................ 235On_button_released Event

............................................................................................................................................................ 235.Pressed R/O Property

............................................................................................................................................................ 235.Time R/O Property

............................................................................................................................................................... 236Fd Object

............................................................................................................................................................ 236Overview

.......................................................................................................................................................... 237Sharing Flash Betw een Your Application and Data

.......................................................................................................................................................... 239Fd. Object's Status Codes

.......................................................................................................................................................... 240Direct Sector Access

....................................................................................................................................................... 242Using Checksums

....................................................................................................................................................... 243Upgrading the Firmware/Application

.......................................................................................................................................................... 245File-based Access

....................................................................................................................................................... 245Formatting the Flash Disk

....................................................................................................................................................... 246Disk Area Allocation Details

....................................................................................................................................................... 249Mounting the Flash Disk

....................................................................................................................................................... 249Checking Disk Vitals

....................................................................................................................................................... 249File Names and Attributes

....................................................................................................................................................... 250Creating, Deleting, and Renaming Files

....................................................................................................................................................... 251Reading and Writing File Attributes

....................................................................................................................................................... 252Walking Through File Directory

....................................................................................................................................................... 253Opening Files

....................................................................................................................................................... 254Writing To and Reading From Files

....................................................................................................................................................... 255Removing Data From Files

....................................................................................................................................................... 256Searching Within Files

....................................................................................................................................................... 258Closing Files

....................................................................................................................................................... 259Using Disk Transactions

....................................................................................................................................................... 261Understanding Transaction Capacity

.......................................................................................................................................................... 263File-based and Direct Sector Access Coexistence

.......................................................................................................................................................... 264Prolonging Flash Memory Life

............................................................................................................................................................ 265Properties and Methods

.......................................................................................................................................................... 267.Availableflashspace R/O Property

.......................................................................................................................................................... 267.Buffernum Property

.......................................................................................................................................................... 268.Capacity R/O Property

.......................................................................................................................................................... 268.Checksum Method

.......................................................................................................................................................... 269.Close Method

.......................................................................................................................................................... 269.Copyfirmware Method

.......................................................................................................................................................... 270.Copyfirmwarelzo Method

.......................................................................................................................................................... 271.Cutfromtop Method

.......................................................................................................................................................... 271.Create Method

.......................................................................................................................................................... 272.Delete Method

.......................................................................................................................................................... 273.Filenum Property

.......................................................................................................................................................... 273.Fileopened R/O Property

.......................................................................................................................................................... 274.Filesize R/O Property

.......................................................................................................................................................... 274.Find Method

.......................................................................................................................................................... 275.Flush Method

.......................................................................................................................................................... 276.Format Method

.......................................................................................................................................................... 277.Formatj Method

.......................................................................................................................................................... 278.Getattributes Method

.......................................................................................................................................................... 278.Getbuffer Method

.......................................................................................................................................................... 279.Getdata Method

VIIIContents


.......................................................................................................................................................... 280.Getfreespace Method

.......................................................................................................................................................... 280.Getnextdirmember Method

.......................................................................................................................................................... 281.Getnumfiles Method

.......................................................................................................................................................... 281.Getsector Method

.......................................................................................................................................................... 282.Laststatus R/O Property

.......................................................................................................................................................... 282.Maxopenedfiles R/O Property

.......................................................................................................................................................... 283.Maxstoredfiles R/O Property

.......................................................................................................................................................... 283.Mount Method

.......................................................................................................................................................... 284.Numservicesectors R/O Property

.......................................................................................................................................................... 284.Open Method

.......................................................................................................................................................... 285.Pointer R/O Property

.......................................................................................................................................................... 285.Ready R/O Property

.......................................................................................................................................................... 285.Rename Method

.......................................................................................................................................................... 286.Resetdirpointer Method

.......................................................................................................................................................... 287.Sector R/O Property

.......................................................................................................................................................... 287.Setattributes Method

.......................................................................................................................................................... 288.Setbuffer Method

.......................................................................................................................................................... 289.Setdata Method

.......................................................................................................................................................... 289.Setfilesize Method

.......................................................................................................................................................... 290.Setsector Method

.......................................................................................................................................................... 291.Setpointer Method

.......................................................................................................................................................... 292.Totalsize R/O Property

.......................................................................................................................................................... 292.Transactioncapacityremaining R/O Property

.......................................................................................................................................................... 293.Transactioncommit Method

.......................................................................................................................................................... 293.Transactionstart Method

.......................................................................................................................................................... 294.Transactionstarted R/O Property

............................................................................................................................................................... 294IO Object

............................................................................................................................................................ 294Overview

.......................................................................................................................................................... 295Line/Port Manipulation With Pre-selection

.......................................................................................................................................................... 295Line/Port Manipulation Without Pre-selection

.......................................................................................................................................................... 296Controlling Output Buffers

.......................................................................................................................................................... 297Working With Interrupts

............................................................................................................................................................ 298Properties, Events, Methods

.......................................................................................................................................................... 298.Enabled Property (Selected Platforms Only)

.......................................................................................................................................................... 299.Intenabled Property

.......................................................................................................................................................... 299.Intnum Property

.......................................................................................................................................................... 300.Invert Method

.......................................................................................................................................................... 300.Lineget Method

.......................................................................................................................................................... 300.Lineset Method

.......................................................................................................................................................... 301.Num Property

.......................................................................................................................................................... 301On_io_int Event

.......................................................................................................................................................... 302.Portenabled Property (Selected Platforms Only)

.......................................................................................................................................................... 302.Portget Method

.......................................................................................................................................................... 302.Portnum Property

.......................................................................................................................................................... 303.Portset Method

.......................................................................................................................................................... 303.Portstate property

.......................................................................................................................................................... 303.State Property

............................................................................................................................................................... 304Kp Object

............................................................................................................................................................ 304Possible Keypad Configurations

............................................................................................................................................................ 306Key States and Transitions

............................................................................................................................................................ 307Preparing the Keypad for Operation

............................................................................................................................................................ 310Servicing Keypad Events

............................................................................................................................................................ 312Properties, Methods, Events

.......................................................................................................................................................... 312.Autodisablecodes Property

.......................................................................................................................................................... 312.Enabled Property

.......................................................................................................................................................... 313.Longpressdelay Property

.......................................................................................................................................................... 313.Longreleasedelay Property

.......................................................................................................................................................... 314On_kp Event

.......................................................................................................................................................... 314On_kp_overflow Event

TIDE and Tibbo BASIC User ManualIX


.......................................................................................................................................................... 315.Pressdelay Property

.......................................................................................................................................................... 315.Releasedelay Property

.......................................................................................................................................................... 315.Repeatdelay Property

.......................................................................................................................................................... 316.Returnlinesmapping Property

.......................................................................................................................................................... 317.Scanlinesmapping Property

............................................................................................................................................................... 317LCD Object

............................................................................................................................................................ 318Overview

.......................................................................................................................................................... 318Understanging Controller Properties

.......................................................................................................................................................... 320Preparing the Display for Operation

.......................................................................................................................................................... 320Working With Pixels and Colors

.......................................................................................................................................................... 321Lines, Rectangles, and Fills

.......................................................................................................................................................... 322Working With Text

....................................................................................................................................................... 325Raster Font File Format

.......................................................................................................................................................... 329Displaying Images

.......................................................................................................................................................... 330Improving Graphical Performance

............................................................................................................................................................ 333Supported Controllers/Panels

.......................................................................................................................................................... 333Samsung S6B0108 (Winstar WG12864F)

.......................................................................................................................................................... 335Solomon SSD1329 (Ritdisplay RGS13128096)

.......................................................................................................................................................... 336Himax HX8309 (Ampire AM176220)

............................................................................................................................................................ 338Properties and Methods

.......................................................................................................................................................... 339.Backcolor Property

.......................................................................................................................................................... 339.Bitsperpixel R/O Property

.......................................................................................................................................................... 340.Bluebits R/O Property

.......................................................................................................................................................... 340.Bmp Method

.......................................................................................................................................................... 341.Enabled Property

.......................................................................................................................................................... 342.Error R/O Property

.......................................................................................................................................................... 342.Fill Method

.......................................................................................................................................................... 343.Filledrectangle Method

.......................................................................................................................................................... 343.Fontheight R/O Property

.......................................................................................................................................................... 344.Fontpixelpacking R/O Property

.......................................................................................................................................................... 344.Forecolor Property

.......................................................................................................................................................... 345.Getprintw idth Method

.......................................................................................................................................................... 345.Greenbits R/O Property

.......................................................................................................................................................... 346.Height Property

.......................................................................................................................................................... 346.Horline Method

.......................................................................................................................................................... 347.Inverted Property

.......................................................................................................................................................... 347.Iomapping Property

.......................................................................................................................................................... 348.Line Method

.......................................................................................................................................................... 348.Linew idth Property

.......................................................................................................................................................... 348.Lock Method

.......................................................................................................................................................... 349.Lockcount R/O Property

.......................................................................................................................................................... 349.Paneltype R/O Property

.......................................................................................................................................................... 350.Pixelpacking R/O Property

.......................................................................................................................................................... 351.Print Method

.......................................................................................................................................................... 351.Printaligned Method

.......................................................................................................................................................... 352.Rectangle Method

.......................................................................................................................................................... 352.Redbits R/O Property

.......................................................................................................................................................... 353.Rotated Property

.......................................................................................................................................................... 353.Setfont Method

.......................................................................................................................................................... 354.Setpixel Method

.......................................................................................................................................................... 355.Textalignment Property

.......................................................................................................................................................... 355.Texthorizontalspacing Property

tide tbasic manual

Documents

copyright tibbo technology

tibbo basic user manuali2000

new project

managing projects

resource files

table of contentstaiko

final binary programming

legal information overview