Tibbo GA1000 User manual

*** USER’S MANUAL ***

FCC ID : XOJGA1000

The Federal Communication Commission Statement

This equipment has been tested and found to comply with the limits for a Class B Digital Device, pursuant to

Part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful

interference in a residential installation. This equipment generates, uses and can radiate radio frequency

energy and, if not installed and used in accordance with the instruction, may cause harmful interference to

radio communication. However, there is no guarantee that interference will not occur in a particular

installation. If this equipment does cause harmful interference to radio or television reception, which can

be determined by turning the equipment off and on, the user is encouraged to try to correct the

interference by one of more of the following measures: -

- Reorient or relocate the receiving antenna.

- Increase the separation between the equipment and receiver.

- Connect the equipment into an outlet on a circuit different from that to which the receiver is

connected.

- Consult the dealer or an experienced Radio/TV technician for help.

Use only shielded cables to connect I/O devices to this equipment. You are cautioned that change or

modifications not expressly approved by the party responsible for compliance could void your authority to

operate the equipment.

THIS DEVICE COMPLIES WITH PART 15 OF FCC RULES. OPERATION IS SUBJECT TO THE

FOLLOWING TWO CONDITIONS: -

1. This device may not cause harmful interference and

2. This device must accept any interference received, including interference that may cause undesired

operation.

The antenna used for this transmitter must not be collocated oroperation in conjunction

with any other antennaor transmitter.

TIDE and Tibbo BASIC User ManualI

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

............................................................................................................................................................... 15The Structure of a Project

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

............................................................................................................................................................ 17Templates

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

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

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

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

............................................................................................................................................................ 22Project Browser

............................................................................................................................................................ 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

............................................................................................................................................................ 32Stepping

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

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

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

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

................................................................................................................................... 39Programming Fundamentals

............................................................................................................................................................... 39Program Structure

............................................................................................................................................................... 40Code Basics

............................................................................................................................................................... 42Naming Conventions

............................................................................................................................................................ 43Variables And Their Types

IIContents

............................................................................................................................................................ 45Type Conversion

............................................................................................................................................................ 48Type conversion in expressions

............................................................................................................................................................ 49Compile-time Calculations

............................................................................................................................................................ 50Arrays

............................................................................................................................................................ 54Structures

............................................................................................................................................................ 55Enumeration Types

............................................................................................................................................................ 57Understanding the Scope of Variables

............................................................................................................................................................ 60Declaring Variables

............................................................................................................................................................ 60Constants

............................................................................................................................................................... 62Introduction to Procedures

............................................................................................................................................................ 64Passing Arguments to Procedures

............................................................................................................................................................ 66Memory Allocation for Procedures

............................................................................................................................................................... 67Introduction to Control Structures

............................................................................................................................................................ 67Decision Structures

............................................................................................................................................................ 68Loop Structures

............................................................................................................................................................ 68Doevents

............................................................................................................................................................... 71Using Preprocessor

............................................................................................................................................................ 73Scope of Preprocessor Directives

............................................................................................................................................................... 74Working with HTML

............................................................................................................................................................ 76Embedding Code Within an HTML File

............................................................................................................................................................... 77Understanding Platforms

............................................................................................................................................................ 78Objects, Events and Platform Functions

Language Reference 78

................................................................................................................................... 79Statements

............................................................................................................................................................... 79Const Statement

............................................................................................................................................................... 79Declare Statement

............................................................................................................................................................... 81Dim Statement

............................................................................................................................................................... 82Doevents Statement

............................................................................................................................................................... 82Do... Loop Statement

............................................................................................................................................................... 84Enum Statement

............................................................................................................................................................... 85Exit Statement

............................................................................................................................................................... 86For... Next Statement

............................................................................................................................................................... 87Function Statement

............................................................................................................................................................... 88Goto Statement

............................................................................................................................................................... 89If.... Then... Else Statement

............................................................................................................................................................... 90Include Statement

............................................................................................................................................................... 91Select-Case Statement

............................................................................................................................................................... 93Sub Statement

............................................................................................................................................................... 94Type Statement

............................................................................................................................................................... 95While-Wend Statement

................................................................................................................................... 96Keywords

............................................................................................................................................................... 96As

............................................................................................................................................................... 97Boolean

............................................................................................................................................................... 97ByRef

............................................................................................................................................................... 97Byte

............................................................................................................................................................... 97ByVal

............................................................................................................................................................... 97Char

............................................................................................................................................................... 97Else

............................................................................................................................................................... 97End

............................................................................................................................................................... 98False

............................................................................................................................................................... 98For

............................................................................................................................................................... 98Integer

............................................................................................................................................................... 98Next

............................................................................................................................................................... 98Public

............................................................................................................................................................... 98Short

............................................................................................................................................................... 98Step

TIDE and Tibbo BASIC User ManualIII

............................................................................................................................................................... 98String

............................................................................................................................................................... 98Then

............................................................................................................................................................... 99Type

............................................................................................................................................................... 99To

............................................................................................................................................................... 99True

............................................................................................................................................................... 99Word

................................................................................................................................... 99Operators

................................................................................................................................... 101Error Messages

............................................................................................................................................................... 101C1001

............................................................................................................................................................... 101C1002

............................................................................................................................................................... 102C1003

............................................................................................................................................................... 102C1004

............................................................................................................................................................... 102C1005

............................................................................................................................................................... 103C1006

............................................................................................................................................................... 103C1007

............................................................................................................................................................... 104C1008

............................................................................................................................................................... 104C1009

............................................................................................................................................................... 104C1010

............................................................................................................................................................... 105C1011

............................................................................................................................................................... 105C1012

............................................................................................................................................................... 106C1013

............................................................................................................................................................... 106C1014

............................................................................................................................................................... 106C1015

............................................................................................................................................................... 107C1016

............................................................................................................................................................... 107C1017

............................................................................................................................................................... 107C1018

............................................................................................................................................................... 108C1019

............................................................................................................................................................... 108C1020

............................................................................................................................................................... 108C1021

............................................................................................................................................................... 109C1022

............................................................................................................................................................... 109C1023

............................................................................................................................................................... 110C1024

............................................................................................................................................................... 110L1001

............................................................................................................................................................... 110L1002

............................................................................................................................................................... 111L1003

............................................................................................................................................................... 111L1004

............................................................................................................................................................... 111L1005

............................................................................................................................................................... 111L1006

............................................................................................................................................................... 112L1007

............................................................................................................................................................... 112L1008

............................................................................................................................................................... 112L1009

................................................................................................................................... 113Objects, Properties, Methods, Events

Development Environment 113

................................................................................................................................... 113Installation Requirements

................................................................................................................................... 113User Interface

............................................................................................................................................................... 114Main Window

............................................................................................................................................................... 114Operation Modes

............................................................................................................................................................... 115Menu Bar

............................................................................................................................................................ 115File Menu

............................................................................................................................................................ 116Edit Menu

............................................................................................................................................................ 117View Menu

............................................................................................................................................................ 117Project Menu

............................................................................................................................................................ 118Debug Menu

............................................................................................................................................................ 119Image Menu

............................................................................................................................................................ 119Window Menu

IVContents

............................................................................................................................................................ 120Help Menu

............................................................................................................................................................... 120Toolbars

............................................................................................................................................................ 120Project Toolbar

............................................................................................................................................................ 121Debug Toolbar

............................................................................................................................................................ 122Image Editor Toolbar

............................................................................................................................................................ 122Tool Properties Toolbar

.......................................................................................................................................................... 123Selection Tool Properties

.......................................................................................................................................................... 123Paint Tool Properties

.......................................................................................................................................................... 123Eraser Tool Properties

.......................................................................................................................................................... 123Text Tool Properties

.......................................................................................................................................................... 124Line Tool Properties

.......................................................................................................................................................... 124Rectangle Tool Properties

.......................................................................................................................................................... 125Ellipse Tool Properties

.......................................................................................................................................................... 126Zoom Tool Properties

............................................................................................................................................................... 126Status Bar

............................................................................................................................................................... 126Dialogs

............................................................................................................................................................ 127Project Settings

............................................................................................................................................................ 127New Project

............................................................................................................................................................ 128Add File to Project

............................................................................................................................................................ 128Graphic File Properties Dialog

............................................................................................................................................................... 128Panes

............................................................................................................................................................ 128Call Stack

............................................................................................................................................................ 129Output

............................................................................................................................................................ 129Project

.......................................................................................................................................................... 129Browser

.......................................................................................................................................................... 130Files

............................................................................................................................................................ 130Watch

............................................................................................................................................................ 130Colors

............................................................................................................................................................... 131Language Element Icons

Glossary of Terms 131

................................................................................................................................... 131Compilation Unit

................................................................................................................................... 131Compiler

................................................................................................................................... 132Construct

................................................................................................................................... 132Cross-Debugging

................................................................................................................................... 132Identifier

................................................................................................................................... 132Keyword

................................................................................................................................... 132Label

................................................................................................................................... 132Linker

................................................................................................................................... 132P-Code

................................................................................................................................... 132Syscall

................................................................................................................................... 133Target

................................................................................................................................... 133Virtual Machine

Platforms 133

................................................................................................................................... 133Platform Specifications

............................................................................................................................................................... 134EM202 Platform

............................................................................................................................................................ 134Memory Space

............................................................................................................................................................ 134Supported Variabled Types

............................................................................................................................................................ 134Supported Functions (Syscalls)

............................................................................................................................................................ 135Supported Objects

............................................................................................................................................................ 135Platform-dependent Constants

.......................................................................................................................................................... 136Enum pl_redir

TIDE and Tibbo BASIC User ManualV

.......................................................................................................................................................... 136Enum pl_io_num

............................................................................................................................................................... 139EM1000 and EM1000W Platforms

............................................................................................................................................................ 140Memory Space

............................................................................................................................................................ 140Supported Objects

............................................................................................................................................................ 140Platform-dependent Constants

.......................................................................................................................................................... 141Enum pl_redir

.......................................................................................................................................................... 142Enum pl_io_num

.......................................................................................................................................................... 144Enum pl_int_num

.......................................................................................................................................................... 145Enum pl_sock_interfaces

............................................................................................................................................................... 149EM1202 and EM1202W Platforms

............................................................................................................................................................ 149Memory Space

............................................................................................................................................................ 150Supported Objects

............................................................................................................................................................ 150Platform-dependent Constants

.......................................................................................................................................................... 150Enum pl_redir

.......................................................................................................................................................... 151Enum pl_io_num

.......................................................................................................................................................... 153Enum pl_int_num

.......................................................................................................................................................... 154Enum pl_sock_interfaces

............................................................................................................................................................... 158EM1206 and EM1206W Platforms

............................................................................................................................................................ 158Memory Space

............................................................................................................................................................ 159Supported Objects

............................................................................................................................................................ 159Platform-dependent Constants

.......................................................................................................................................................... 159Enum pl_redir

.......................................................................................................................................................... 160Enum pl_io_num

.......................................................................................................................................................... 162Enum pl_int_num

.......................................................................................................................................................... 162Enum pl_sock_interfaces

............................................................................................................................................................... 166DS1202 Platform

............................................................................................................................................................ 167Memory Space

............................................................................................................................................................ 167Supported Objects

............................................................................................................................................................ 167Platform-dependent Constants

.......................................................................................................................................................... 167Enum pl_redir

.......................................................................................................................................................... 169Enum pl_io_num

.......................................................................................................................................................... 170Enum pl_int_num

.......................................................................................................................................................... 170Enum pl_sock_interfaces

............................................................................................................................................................... 174DS1206 Platform

............................................................................................................................................................ 175Memory Space

............................................................................................................................................................ 175Supported Objects

............................................................................................................................................................ 175Platform-dependent Constants

.......................................................................................................................................................... 175Enum pl_redir

.......................................................................................................................................................... 177Enum pl_io_num

.......................................................................................................................................................... 178Enum pl_int_num

.......................................................................................................................................................... 179Enum pl_sock_interfaces

............................................................................................................................................................... 182Common Information

............................................................................................................................................................ 184LED Signals

............................................................................................................................................................ 185Debug Communications

............................................................................................................................................................ 186Project Settings Dialog

.......................................................................................................................................................... 187Device Explorer

................................................................................................................................... 189Function Reference

............................................................................................................................................................... 189Asc Function

............................................................................................................................................................... 190Bin Function

............................................................................................................................................................... 190Cfloat Function

VIContents

............................................................................................................................................................... 191Chr Function

............................................................................................................................................................... 191Date Function

............................................................................................................................................................... 192Daycount Function

............................................................................................................................................................... 192Ddstr Function

............................................................................................................................................................... 193Ddval Function

............................................................................................................................................................... 194Ftostr Function

............................................................................................................................................................... 195Hex Function

............................................................................................................................................................... 195Hours Function

............................................................................................................................................................... 196.Insert Function

............................................................................................................................................................... 197Instr Function

............................................................................................................................................................... 197Lbin Function

............................................................................................................................................................... 198Left Function

............................................................................................................................................................... 198Len Function

............................................................................................................................................................... 199Lhex Function

............................................................................................................................................................... 199Lstr Function

............................................................................................................................................................... 200Lstri Function

............................................................................................................................................................... 200Lval Function

............................................................................................................................................................... 201Md5 Function

............................................................................................................................................................... 202Mid Function

............................................................................................................................................................... 203Mincount Function

............................................................................................................................................................... 203Minutes Function

............................................................................................................................................................... 204Month Function

............................................................................................................................................................... 205Random Function

............................................................................................................................................................... 205Right Function

............................................................................................................................................................... 205Sha1 Function

............................................................................................................................................................... 207Str Function

............................................................................................................................................................... 207Strgen Function

............................................................................................................................................................... 208Stri Function

............................................................................................................................................................... 209Strsum Function

............................................................................................................................................................... 209Strtof Function

............................................................................................................................................................... 210Val Function

............................................................................................................................................................... 210Vali Function

............................................................................................................................................................... 211Weekday Function

............................................................................................................................................................... 211Year Function

................................................................................................................................... 212Object Reference

............................................................................................................................................................... 212Sys Object

............................................................................................................................................................ 212Overview

.......................................................................................................................................................... 212On_sys_init Event

.......................................................................................................................................................... 213Buffer Management

.......................................................................................................................................................... 214System Timer

.......................................................................................................................................................... 215PLL Management

.......................................................................................................................................................... 216Serial Number

.......................................................................................................................................................... 217Miscellaneous

............................................................................................................................................................ 217Properties, Methods, Events

.......................................................................................................................................................... 217.Buffalloc Method

.......................................................................................................................................................... 218.Currentpll R/O Property (Selected Platforms Only)

.......................................................................................................................................................... 218.Freebuffpages R/O Property

.......................................................................................................................................................... 219.Halt Method

.......................................................................................................................................................... 219.Newpll Method (Selected Platforms Only)

.......................................................................................................................................................... 220On_sys_init Event

.......................................................................................................................................................... 220On_sys_timer Event

.......................................................................................................................................................... 220.Onsystimerperiod Property (Selected Platforms Only)

.......................................................................................................................................................... 221.Reboot Method

.......................................................................................................................................................... 221.Runmode R/O Property

.......................................................................................................................................................... 221Serialnum R/O Property

.......................................................................................................................................................... 222Setserialnum Method

.......................................................................................................................................................... 222.Resettype R/O Property

.......................................................................................................................................................... 223.Timercount R/O Property

TIDE and Tibbo BASIC User ManualVII

.......................................................................................................................................................... 223.Totalbuffpages R/O Property

.......................................................................................................................................................... 223.Version R/O Property

............................................................................................................................................................... 224Ser Object

............................................................................................................................................................ 224What's new in V1.1

............................................................................................................................................................ 225Overview

.......................................................................................................................................................... 225Anatomy of a Serial Port

.......................................................................................................................................................... 225Three Modes of the Serial Port

....................................................................................................................................................... 226UART Mode

....................................................................................................................................................... 229Wiegand Mode

....................................................................................................................................................... 232Clock/Data Mode

.......................................................................................................................................................... 234Port Selection

.......................................................................................................................................................... 236Serial Settings

....................................................................................................................................................... 239Allocating Memory for Buffers

....................................................................................................................................................... 240Using Buffers

....................................................................................................................................................... 240Buffer Memory Status

....................................................................................................................................................... 241Receiving Data

....................................................................................................................................................... 243Sending Data

....................................................................................................................................................... 244Handling Buffer Overruns

....................................................................................................................................................... 245Redirecting Buffers

....................................................................................................................................................... 245Sinking Data

............................................................................................................................................................ 246Properties, Methods, Events

.......................................................................................................................................................... 248.Autoclose Property

.......................................................................................................................................................... 248.Baudrate Property

.......................................................................................................................................................... 249.Bits Property

.......................................................................................................................................................... 250.Dircontrol Property

.......................................................................................................................................................... 250.Div9600 R/O Property

.......................................................................................................................................................... 251.Enabled Property

.......................................................................................................................................................... 251.Escchar Property

.......................................................................................................................................................... 251.Esctype Property

.......................................................................................................................................................... 253.Flowcontrol Property

.......................................................................................................................................................... 253.Getdata Method

.......................................................................................................................................................... 254.Interchardelay Property

.......................................................................................................................................................... 255.Interface Property

.......................................................................................................................................................... 255.Mode Property

.......................................................................................................................................................... 256.Newtxlen R/O Property

.......................................................................................................................................................... 257.Notifysent Method

.......................................................................................................................................................... 257.Num Property

.......................................................................................................................................................... 258.Numofports R/O Property

.......................................................................................................................................................... 258On_ser_data_arrival Event

.......................................................................................................................................................... 258On_ser_data_sent Event

.......................................................................................................................................................... 259On_ser_esc Event

.......................................................................................................................................................... 259On_ser_overrun Event

.......................................................................................................................................................... 260.Parity Property

.......................................................................................................................................................... 260.Redir Method

.......................................................................................................................................................... 262.Rxbuffrq Method

.......................................................................................................................................................... 262.Rxbuffsize R/O Property

.......................................................................................................................................................... 263.Rxclear Method

.......................................................................................................................................................... 263.Rxlen R/O Property

.......................................................................................................................................................... 264.Send Method

.......................................................................................................................................................... 264.Setdata Method

.......................................................................................................................................................... 265.Sinkdata Property

.......................................................................................................................................................... 265.Txbuffrq Method

.......................................................................................................................................................... 266.Txbuffsize R/O Property

.......................................................................................................................................................... 266.Txclear Method

.......................................................................................................................................................... 266.Txfree R/O Property

.......................................................................................................................................................... 267.Txlen R/O Property

VIIIContents

............................................................................................................................................................... 267Net Object

............................................................................................................................................................ 268Overview

.......................................................................................................................................................... 268Main Parameters

.......................................................................................................................................................... 269Checking Ethernet Status

............................................................................................................................................................ 269Properties, Methods, Events

.......................................................................................................................................................... 269.Mac R/O Property

.......................................................................................................................................................... 270.Ip Property

.......................................................................................................................................................... 270.Netmask Property

.......................................................................................................................................................... 270.Gatewayip Property

.......................................................................................................................................................... 271.Failure R/O Property

.......................................................................................................................................................... 271.Linkstate R/O Property

.......................................................................................................................................................... 271On_net_link_change Event

.......................................................................................................................................................... 272On_net_overrun Event

............................................................................................................................................................... 272Button Object

............................................................................................................................................................ 273On_button_pressed Event

............................................................................................................................................................ 273On_button_released Event

............................................................................................................................................................ 274.Pressed R/O Property

............................................................................................................................................................ 274.Time R/O Property

............................................................................................................................................................... 274Sock Object

............................................................................................................................................................ 275Overview

.......................................................................................................................................................... 276Anatomy of a Socket

.......................................................................................................................................................... 276Socket Selection

.......................................................................................................................................................... 277Handling Network Connections

....................................................................................................................................................... 278TCP connection basics

....................................................................................................................................................... 278UDP "connection" basics

....................................................................................................................................................... 279Accepting Incoming Connections

....................................................................................................................................................... 281Accepting UDP broadcasts

....................................................................................................................................................... 281Understanding TCP Reconnects

....................................................................................................................................................... 283Understanding UDP Reconnects and Port Switchover

....................................................................................................................................................... 286Incoming Connections on Multiple Sockets

....................................................................................................................................................... 287Establishing Outgoing Connections

....................................................................................................................................................... 288Sending UDP broadcasts

....................................................................................................................................................... 290Closing Connections

....................................................................................................................................................... 292Checking Connection Status

....................................................................................................................................................... 294More On the Socket's Asynchronous Nature

.......................................................................................................................................................... 297Sending and Receiving data

....................................................................................................................................................... 297Allocating Memory for Buffers

....................................................................................................................................................... 298Using Buffers in TCP Mode

....................................................................................................................................................... 299Using Buffers in UDP Mode

....................................................................................................................................................... 300TX and RX Buffer Memory Status

....................................................................................................................................................... 301Receiving Data in TCP Mode

....................................................................................................................................................... 303Receiving Data in UDP Mode

....................................................................................................................................................... 304Sending TCP and UDP Data

....................................................................................................................................................... 306"Split Packet" Mode of TCP Data Processing

....................................................................................................................................................... 307Handling Buffer Overruns

....................................................................................................................................................... 308Redirecting Buffers

....................................................................................................................................................... 309Sinking Data

.......................................................................................................................................................... 309Working With Inband Commands

....................................................................................................................................................... 309Inband Message Format

....................................................................................................................................................... 310Inband-related Buffers (CMD, RPL, and TX2)

....................................................................................................................................................... 311Processing Inband Commands

....................................................................................................................................................... 313Sending Inband Replies

.......................................................................................................................................................... 314Using HTTP

....................................................................................................................................................... 315HTTP-related Buffers

....................................................................................................................................................... 317Setting the Socket for HTTP

....................................................................................................................................................... 318Socket Behavior in the HTTP Mode

....................................................................................................................................................... 319Including BASIC Code in HTTP Files

....................................................................................................................................................... 320Generating Dynamic HTML Pages

....................................................................................................................................................... 322URL Substitution