CipherLab Series 8 User manual

BASIC Language Programming
Part I: Basics and Hardware Control
For 8 Series Mobile Computers
Version 5.06

Copyright © 2007~2015 CIPHERLAB CO., LTD.
All rights reserved
The software contains proprietary information of CIPHERLAB CO., LTD.; it is provided
under a license agreement containing restrictions on use and disclosure and is also
protected by copyright law. Reverse engineering of the software is prohibited.
Due to continued product development this information may change without notice. The
information and intellectual property contained herein is confidential between CIPHERLAB
and the client and remains the exclusive property of CIPHERLAB CO., LTD. If you find
any problems in the documentation, please report them to us in writing. CIPHERLAB
does not warrant that this document is error-free.
No part of this publication may be reproduced, stored in a retrieval system, or
transmitted in any form or by any means, electronic, mechanical, photocopying,
recording or otherwise without the prior written permission of CIPHERLAB CO., LTD.
For product consultancy and technical support, please contact your local sales
representative. Also, you may visit our web site for more information.
The CipherLab logo is a registered trademark of CIPHERLAB CO., LTD.
All brand, product and service, and trademark names are the property of their registered
owners.
The editorial use of these names is for identification as well as to the benefit of the
owners, with no intention of infringement.
CIPHERLAB CO., LTD.
Website: http://www.cipherlab.com

Version
Date
Notes
5.06 Jun. 22, 2015 Part I
Modified: Appendix I –
SYMBOLOGY PARAMETER TABLE FOR
CCD/LASER/LONG RANGE READER:
: 300~306, 308 updated with 8400
: 312~317 added for Quiet Zone check settings (8200/8400)
Modified: Appendix II – SCAN ENGINE, CCD OR LASER:
: 300~306 updated with 8400
: 308 updated with 8400 (Addon Security)
: 312 ~ 317 added for Quiet Zone check settings (8200/8400)
Part II
Modified: Appendix - Wireless Networking table updated
5.05 Mar. 06, 2015 Part I
Modified: Appendix I – update “Symbology Parameter Table for
CCD/Laser/Long Range Reader” with 180~299 & 300~308
Modified: Appendix II – Scan Engine, CCD or Laser – UPC/EAN
Families: “EAN-13 Addon Mode” and “Addon Security for UPC/EAN”
added
Part II
- None –
5.04 Mar. 28, 2014 Part I
Modified: Appendix I - SYMBOLOGY PARAMETER TABLE I
>No. (N1%): 87 (GTIN -> GTIN-14)
Removed: Appendix I - SYMBOLOGY PARAMETER TABLE II
>No. (N1%): 188 (GS1 formatting for GS1 DataMatrix)
Modified: Appendix II Symbology Parameters –
Scan Engine, CCD or Laser
>UPC/EAN FAMILIES: No. 87 (GTIN -> GTIN-14)
Removed: Appendix II – Scan Engine, CCD or Laser – 2D
SCAN
ENGINE ONLY
>2D SYMBOLOGIES|MAXICODE, DATA MATRIX & QR CODE: No. 188
Part II
Modified: 3.1.2 - Commands
>”A$” variable table updated for SET_NET_PARAMETER
Modified: Appendix II – Net Parameters by Index –
Wireless Networking
>-92~-96 (GET)/92~96 (SET) indexes updated
RELEASE NOTES

5.03 Feb. 19, 2014 Part I
Replace “RSS” with “GS1 DataBar”
Modified: Chapter 1 – Windows 95/98/7 supported (chapter 1, 2)
Modified: 2.3 Configure Menu – descriptions for “Create DBF Files”
command revised
Modified: 4.15 KEYPAD COMMANDS | 4.15.1 GENERAL –
>8000 supports OSK_TOGGLE, GET_TRIGGER,SET_TRIGGER,
SET_PWR_KEY commands
>SET_MIDDLE_ENTER command added for 8400/8700
>SET_PISTOL_ENTER command added for 8200/8700
Modified: 4.18 Fonts | 4.18.4 Special Font Files –
>Turkey (33) added to GET_LANGUAGE, SET_LANGUAGE
Modified: Appendix I - SYMBOLOGY PARAMETER TABLE I
>No. (N1%): 54, 173, 174, 175, 176, 177, 178, 179 added
Modified: Appendix I - SYMBOLOGY PARAMETER TABLE II
>No. (N1%): 94 (Disable TCIF Linked Code 39 by default)
>No. (N1%): 174, 176 ~ 179/181 ~ 188 added
Modified: Appendix II Symbology Parameters –
Scan Engine, CCD or Laser
>Code39: No. 173
>CODE 128/EAN-128/ISBT 128: No. 174
>GS1 DataBar FAMILY: No. 175
>UPC/EAN FAMILIES: No. 54
>UPC/EAN FAMILIES: UPC-E Triple Check descriptions
SCAN ENGINE, 2D OR (EXTRA) LONG RANGE LASER
>CODE 128 | UCC/EAN-128: No. 174
>GS1 DataBar FAMILY: No. 183~185
2D SCAN ENGINE ONLY
>COMPOSITE CODES | CC-A/B/C: No. 186~187
>TLC-39: No. 94 (Disable TCIF Linked Code 39 by default)
>2D SYMBOLOGIES|MAXICODE, DATA MATRIX & QR CODE: No. 188
Modified: Appendix III Scanner Parameter –
>READ REDUNDANCY: No. 182
>USER PREFERENCES: No. 181
Part II
- None –

5.02 Mar. 27, 2013 Part I
Modified: 4.7.2 Code Type –
CodeType Table II: add 8400/8700 2D
scan engine to Composite_CC_A/B/C symbologies (Decimal
47/55/118)
Modified: 4.15.1 General – OSK_TOGGLE, SET_PWR_KEY: support
for 8400/8700 added
Modified: Appendix I – Symbology Parameter Table II: add
8400/8700 2D scan engine to No. 44 (Convert UPC-A to EAN-13)
Modified: Appendix II – Scan Engine, 2D or (extra) Long Range
Laser: add 8400/8700 2D scan engine to No. 44 (Convert UPC-A to
EAN-13)
Part II
- None –
5.01 Dec. 07, 2012 Part I
Modified: 1.1 Directory Structure – Font Files (8200/8400/8700)
Modified: 4.7.2 Code Type Table II – Symbology added (No.
47/55/118)
Added: 4.15 Keypad Commands – OSK_TOGGLE, SET_PWR_KEY
commands added
Modified: 4.15.2 ALPHA KEY – GET_ALPHA_STATE command
removed
Modified: 4.18.1 Font Size – 20x20 added
Modified: 4.18.4 – SELECT_FONT command modified
Modified: Appendix I – Symbology Parameter Table II – value &
description added (No. 44)
Part II
- None –
4.24 Oct 24, 2012 Part I
Modified: 4.15 Keypad Commands
│
4.15.1 General –
SET_TRIGGER, GET_TRIGGER commands added for
8200/8400/8700; CHECK_ENTER_KEY for 8200/8700;
SET_MIDDLE_ENTER for 8200
Modified: 4.16 LCD Commands
│
4.16.1 Properties – BACKLIT
command revised; GET_BKLIT_LEVEL, SET_AUTO_BKLIT,
SET_BKLIT_LEVEL commands added for 8200/8400/8700
Modified: 2.5 Help Menu one command is provided (not three)
Modified: Appendix VII Key Code Table – MCR/LCR/RCR added
for 8200; LCR/RCR added for 8700
Part II
New: 4.3 Scanning for Wi-Fi Hotspots – WIFI_SCAN command
added for 8200/8400/8700

4.23 July. 02, 2012 Part I
New: Add 8700-Long Range followed to CCD, Laser
Part II
New: Appendix II add Wi-Fi Profile index
New: Appendix IV add PCAT — Swiss(German) and Hungarian for
8400/8700.
 New: 4.2 Wi-Fi Profile
4.21 Mar. 14, 2012 Part I
Modified: Appendix I ScannerDesTbl Array |
Symbology Table
II - Note: MSI and Code 11 are disabled for 8400 2D scan engine
by
default.
Modified: Appendix II Symbology Parameters |
Scan Engine,
2D or (Extra) Long Range Laser – Note:
MSI and Code 11 are
disabled for 8400 2D scan engine by default.
Part II
New: 10.3.1 “Command: FTP_ROUTINE$”
| Remarks | FTP Task
Variable Table - Note (4)
4.20 Dec. 12, 2011 Part I
None
Part II
Modified: 8780 removed from the manual.
Modified: 10.3
.1: Parameters to rename / delete FTP files added to
command FTP_ROUTINE$ for 8200 & 8400.

Modified: Appendix V: FTP messages for renaming / deleting FTP
files added.
4.10 Jul. 07, 2011 Part I
Modified: 4.19 Memory Commands — 8700’s updated
Part II
Modified: 5.1 Bluetooth Profiles Supported —
Bluetooth HSP for 8200
removed
Modified: Appendix IV Examples —
Bluetooth HSP (8200 Only)
removed
4.00 Mar. 21, 2011
BASIC Programming Guide split into Part I: Basics and Hardware
Control, and Part II: Data Communications
Modified: add 8200 support
Modified: add 8700 support
 Modified: remove 8580/8590

Part I
3.2.1 Variable Names and Declaration Characters —
add “About Real
Number”
4.6.2 System Information —
SYSTEM_INFORMATION$() for 8200
bootloader version
4.10 Buzzer Commands —
BEEP() allows setting 8200’s speaker
mute
4.15.3 FN Key — Auto Resume mode for 8300 allows re-
pressing the
function key to exit the function mode
Appendix VII Key Code Table — updated for 8200/8700
Part II
Add support of Bluetooth HSP and FTP for 8200
1.3.1 Commands —
SET_COM_TYPE() supports USB Virtual
COM_CDC and Bluetooth HSP for 8200
8.1.2 USB Virtual COM —
add support of USB Virtual COM_CDC for
8200
9 GPS Functionality — add support of GPS for 8700
 10 FTP Functionality

CONTENTS
RELEASE NOTES
....................................................................................................................- 3 -
INTRODUCTION
........................................................................................................................ 1
DEVELOPMENT ENVIRONMENT
........................................................................................ 3
1.1 Directory Structure............................................................................................................. 3
1.2 BASIC Runtime Engines.................................................................................................... 6
1.3 Development Flow............................................................................................................... 7
1.3.1 Download Runtime Engine...................................................................................... 7
1.3.2 Edit/Compile BASIC Programs............................................................................... 7
1.3.3 Download BASIC Object Files................................................................................ 8
USING BASIC COMPILER
..................................................................................................... 9
2.1 File Menu...............................................................................................................................10
2.2 Edit Menu..............................................................................................................................11
2.3 Configure Menu..................................................................................................................13
2.4 Compile Menu .....................................................................................................................15
2.5 Help Menu.............................................................................................................................16
BASICS OF THE CIPHERLAB BASIC LANGUAGE
..................................................... 17
3.1 Constants..............................................................................................................................17
3.1.1 String............................................................................................................................. 17
3.1.2 Numeric........................................................................................................................17
3.2 Variables ...............................................................................................................................18
3.2.1 Variable Names and Declaration Characters .................................................18
3.2.2 Array Variables..........................................................................................................20
3.3 Expression and Operators..............................................................................................21
3.3.1 Assignment Operator..............................................................................................21
3.3.2 Arithmetic Operator.................................................................................................21
3.3.3 Relational Operator..................................................................................................22
3.3.4 Logical Operator........................................................................................................ 22
3.4 Operator Precedence........................................................................................................23
3.5 Labels.....................................................................................................................................23
3.6 Subroutines..........................................................................................................................24
3.7 Programming Style...........................................................................................................26
BASIC COMMANDS
................................................................................................................ 27
4.1 General Commands ..........................................................................................................29
4.2 Commands for Decision Structures............................................................................32
4.3 Commands for Looping Structures.............................................................................37
4.4 Commands for String Processing................................................................................39

CipherLab BASIC Programming Part I
4.4.1 Combining Strings....................................................................................................39
4.4.2 Comparing Strings...................................................................................................39
4.4.3 Getting the Length of a String ............................................................................40
4.4.4 Searching for Strings..............................................................................................40
4.4.5 Retrieving Part of Strings......................................................................................41
4.4.6 Converting for Strings ............................................................................................43
4.4.7 Creating Strings of Repeating Characters ...................................................... 46
4.5 Commands for Event Trapping.....................................................................................47
4.5.1 Event Triggers............................................................................................................47
4.5.2 Lock and Unlock........................................................................................................59
4.6 System Commands...........................................................................................................61
4.6.1 General.........................................................................................................................61
4.6.2 System Information.................................................................................................66
4.6.3 Security........................................................................................................................72
4.6.4 Program Manipulation............................................................................................. 73
4.7 Barcode Reader Commands..........................................................................................78
4.7.1 General.........................................................................................................................78
4.7.2 Code Type....................................................................................................................84
4.7.3 Reader Settings.........................................................................................................88
4.8 RFID Reader Commands.................................................................................................89
4.8.1 Virtual COM.................................................................................................................90
4.8.2 Data Format................................................................................................................90
4.8.3 Authentication............................................................................................................92
4.9 Keyboard Wedge Commands........................................................................................93
4.9.1 Definition of the WedgeSetting Array...............................................................94
4.9.2 Composition of Output String..............................................................................98
4.9.3 Wedge Emulator......................................................................................................100
4.10 Buzzer Commands........................................................................................................102
4.11 LED Command................................................................................................................104
4.12 Vibrator Commands .....................................................................................................106
4.13 Real-Time Clock Commands.....................................................................................107
4.14 Battery Commands.......................................................................................................110
4.15 Keypad Commands.......................................................................................................111
4.15.1 General.....................................................................................................................111
4.15.2 ALPHA Key..............................................................................................................116
4.15.3 FN Key......................................................................................................................117
4.16 LCD Commands .............................................................................................................119
4.16.1 Properties................................................................................................................119
4.16.2 Cursor.......................................................................................................................124
4.16.3 Display......................................................................................................................126
4.16.4 Clear..........................................................................................................................129
4.16.5 Image .......................................................................................................................130
4.16.6 Graphics...................................................................................................................133
4.17 Touch Screen Commands..........................................................................................136
4.18 Fonts ..................................................................................................................................140

CipherLab BASIC Programming Part I
4.18.1 Font Size..................................................................................................................140
4.18.2 Display Capability ................................................................................................140
4.18.3 Multi-language Font File....................................................................................141
4.18.4 Special Font Files .................................................................................................141
4.19 Memory Commands .....................................................................................................144
4.19.1 Flash..........................................................................................................................145
4.19.2 SRAM.........................................................................................................................147
4.19.3 SD Card....................................................................................................................148
4.20 File Manipulation............................................................................................................149
4.20.1 DAT Files..................................................................................................................149
4.20.2 DBF Files and IDX Files......................................................................................157
4.20.3 Error Code...............................................................................................................165
4.21 SD Card.............................................................................................................................166
4.21.1 File System.............................................................................................................166
4.21.2 Directory..................................................................................................................167
4.21.3 File Name................................................................................................................168
SCANNERDESTBL ARRAY
................................................................................................. 169
Symbology Parameter Table for CCD/Laser/Long Range Reader.........................169
Symbology Parameter Table for 2D/Extra Long Range Reader............................178
SYMBOLOGY PARAMETERS
.............................................................................................189
Scan Engine, CCD or Laser..................................................................................................189
Codabar..................................................................................................................................189
Code 2 of 5 Family.............................................................................................................190
Code 39..................................................................................................................................192
Code 93..................................................................................................................................194
Code 128/EAN-128/ISBT 128........................................................................................194
Italian/French Pharmacode ............................................................................................195
MSI...........................................................................................................................................195
Negative Barcode ...............................................................................................................196
Plessey....................................................................................................................................196
GS1 DataBar (RSS) Family.............................................................................................197
Telepen...................................................................................................................................198
UPC/EAN Families...............................................................................................................198
Scan Engine, 2D or (Extra) Long Range Laser............................................................202
Codabar..................................................................................................................................202
Code 2 of 5 ...........................................................................................................................203
Code 39..................................................................................................................................205
Code 93..................................................................................................................................206
Code 128 ...............................................................................................................................206
MSI...........................................................................................................................................207
GS1 DataBar (RSS) Family.............................................................................................208
UPC/EAN Families...............................................................................................................209
UCC Coupon Code..............................................................................................................211
Joint Configuration.............................................................................................................211
Code 11..................................................................................................................................213
2D Scan Engine Only..............................................................................................................214

CipherLab BASIC Programming Part I
1D Symbologies..................................................................................................................214
Composite Codes................................................................................................................216
2D Symbologies..................................................................................................................218
SCANNER PARAMETERS
................................................................................................... 221
Scan Mode..................................................................................................................................221
Comparison Table...............................................................................................................222
Read Redundancy....................................................................................................................224
Time-Out.....................................................................................................................................224
User Preferences......................................................................................................................225
RESERVED HOST COMMANDS
........................................................................................227
DEBUGGING COMMANDS
................................................................................................. 231
Debugging Example................................................................................................................233
Debugging Messages..............................................................................................................234
RUN-TIME ERROR TABLE
................................................................................................. 243
KEY CODE TABLE
..................................................................................................................245
INDEX
........................................................................................................................................249

1
CipherLab BASIC Compiler provides users with a complete programming environment to
develop application programs for CipherLab 8 Series Mobile Computers using the BASIC
language. The Windows-based Basic Compiler comes with a menu-driven interface to
simplify software development and code modifications. Many system configurations, such
as COM port properties and database file settings can be set up in the menus. Using this
powerful programming tool to get rid of lengthy coding, users can develop an application
to meet their own needs efficiently. The CipherLab BASIC Compiler has been modified
and improved since its first release in November 1997. Users can refer to RELEASE.TXT
for detailed revision history.
This manual is meant to provide detailed information about how to use the BASIC
Compiler to write application programs for CipherLab 8 Series Mobile Computers. It is
organized in chapters giving outlines as follows:
Part I: Basics and Hardware Control
Chapter 1 “Development Environment” –
gives a concise introduction about the CipherLab
BASIC Compiler, the development flow for applications, and the BASIC Compiler
Run-time Engines.
Chapter 2 “Using CipherLab BASIC Compiler” –
gives a tour of the programming environment of
the BASIC Compiler.
Chapter 3 “Basics of CipherLab BASIC Language” –
discusses the specific characteristics of the
CipherLab BASIC Language.
Chapter 4 “BASIC Commands” – disc
usses all the supported BASIC functions and statements.
More than 200 BASIC functions and statements are categorized according to their
functions, and discussed in details.
Part II: Data Communications
Chapter 1 “Communication Ports”
Chapter 2 “TCP/IP Communications”
Chapter 3 “Wireless Networking”
Chapter 4 “IEEE 802.11b/g”
Chapter 5 “Bluetooth”
Chapter 6 “GSM/GPRS”
Chapter 7 “Modem, Ethernet & GPRS Connection”
Chapter 8 “USB Connection”
Chapter 9 “GPS Functionality”
Chapter 10 “FTP Functionality”
INTRODUCTION

2
CipherLab BASIC Programming Part I

3
Before you install the CipherLab BASIC Compiler, it is necessary to check that your PC
meets the following minimum requirements:
Items
Requirements
CPU Pentium 75MHz
Operating System Windows 95/98/2000/NT/XP/7/8
Minimum RAM 16 MB
Minimum Hard Disk Space 20 MB
Note: Any mobile computer being programmed will need to have a minimum 128 KB
RAM.
IN THIS CHAPTER
1.1 Directory Structure .......................................................3
1.2 BASIC Runtime Engines.................................................6
1.3 Development Flow.........................................................7
1.1 DIRECTORY STRUCTURE
The CipherLab BASIC Compiler Kit contains a number of directories, namely, BASIC
Compiler, Download Utility,BASIC Runtimes, and Font Files. The purposes and
contents of each directory are listed below.
To set up the BASIC programming environment on your PC, simply copy these directories
from the CD-ROM to your local hard disk.
BASIC Compiler
BC.exe The BASIC Compiler program.
Release.txt The revision history of the BASIC compiler.
Samples Include BASIC source files (.bas), initialization files (.ini) and BASIC object
files (.syn) of the sample programs.
Download Utility
ProgLoad.exe For downloading the following files to mobile computers via RS-232/IrDA,
Cradle-IR, or TCP/IP:
Motorola S format object file (.shx)
 Basic object files (.syn and .ini)
Chapter 1
DEVELOPMENT ENVIRONMENT

4
CipherLab BASIC Programming Part I
BASIC Runtimes
BC8000.shx 8000 generic version
Download font file if not
using system font
BC8200.shx 8200 generic version
BC8300.shx 8300 generic version
BC8400.shx 8400 generic version
BC8500.shx 8500 generic version
BC8700.shx 8700 generic version

5
Chapter 1 Development Environment
Font Files
Font Size
8000, 8300 
Font-Hebrew.shx
Font-Japanese.shx
Font-Japanese12.shx
Font-Korean.shx
Font-Korean12.shx
Font-Nordic.shx
Font-Polish.shx
Font-Russian.shx
Font-SimplifiedChinese.shx
Font-SimplifiedChinese12.shx
Font-TraditionalChinese.shx
Font-TraditionalChinese12.shx
 Font-Multi-Language.shx
 6x8, 8x16
16x16 (4 lines)
6x12, 12x12 (5 lines)
16x16 (4 lines)
6x12, 12x12 (5 lines)
6x8, 8x16
6x8, 8x16
6x8, 8x16
16x16 (4 lines)
6x12, 12x12 (5 lines)
16x16 (4 lines)
6x12, 12x12 (5 lines)
 6x8, 8x16
8200, 8400, 8700 
Font8x00-Hebrew.shx
Font8x00-Japanese.shx
Font8x00-Japanese12.shx
Font8x00-Japanese20.shx
Font8x00-Korean.shx
Font8x00-Korean20.shx
Font8x00-Nordic.shx
Font8x00-Polish.shx
Font8x00-Russian.shx
Font8x00-SimplifiedChinese.shx
Font8x00-SimplifiedChinese12.shx
Font8x00-SimplifiedChinese20.shx
Font8x00-TraditionalChinese.shx
Font8x00-TraditionalChinese12.shx
Font8x00-TraditionalChinese20.shx
Font8x00-Multi-Language.shx
 6x8, 8x16
16x16 (9 lines)
6x12, 12x12 (12 lines)
10x20, 20x20 (7 lines)
16x16 (9 lines)
10x20, 20x20 (7 lines)
6x8, 8x16
6x8, 8x16
6x8, 8x16
16x16 (9 lines)
6x12, 12x12 (12 lines)
10x20, 20x20 (7 lines)
16x16 (9 lines)
6x12, 12x12 (12 lines)
10x20, 20x20 (7 lines)
6x8, 8x16
, 12x16 (9
lines)
8500 
Font8500-Japanese.shx
Font8500-Korean.shx
Font8500-SimplifiedChinese.shx
Font8500-SimplifiedChinese12.shx
Font8500-TraditionalChinese.shx
Font8500-TraditionalChinese12.shx
 Font8500-Multi-Language.shx
 16x16 (9 lines)
16x16 (9 lines)
16x16 (9 lines)
6x12, 12x12 (12 lines)
16x16 (9 lines)
6x12, 12x12 (12 lines)
 6x8, 8x16

6
CipherLab BASIC Programming Part I
1.2 BASIC RUNTIME ENGINES
The BASIC Run-time Engines work as interpreters of the BASIC commands. CipherLab
Mobile Computers have to be loaded with the BASIC Run-time (Engines) to run the
BASIC programs; each has its own Run-time Engine to drive its specific hardware
features. The Run-time Engines are named as “BCxxx.shx”, where “BCxxx” is the model
number of the target mobile computer. For example, “BC8500.shx” is the BASIC
Run-time for 8500 Series.
The BASIC Run-time also provides the capabilities for the user to configure the mobile
computer. With the Run-time Engine loaded, the mobile computer can be set to the
“System Mode”. In the “System Mode”, the user can set up the system settings such as
the system clock and update the user program, and so on. System Menu presented in
the “System Mode” varies, which is hardware-dependant. For detailed functions of
System Menu, please refer to the reference manual for each series of mobile computers.
Note: Press the following key combination to enter System Menu – [7], [9] and the
[POWER] key.

7
Chapter 1 Development Environment
1.3 DEVELOPMENT FLOW
Developing a BASIC program for the mobile computers is as simple as counting 1-2-3.
There are three steps:
Step 1 –Download the BASIC Run-time to the target mobile computer.
Step 2 –Edit and compile the BASIC program.
Step 3 –Download the BASIC object file to the target mobile computer.
1.3.1 DOWNLOAD RUNTIME ENGINE
The BASIC Run-time Engines are programs being loaded on the mobile computers to
execute the BASIC object files. They must exist in the mobile computers before the
BASIC object files are downloaded. To download the Run-time Engine (and/ or any other
programs), the target mobile computer needs to be set to the “Download Mode” first to
receive the new program.
There are two ways to enter the “Download Mode” – one is via System Menu, and the
other via Kernel Menu. For details of how to download a program, please refer to the
reference manual for each series of mobile computers.
Note: After re-installing the battery pack, press the following key combination to enter
Kernel Menu – [1], [7] and the [POWER] key.
After the target mobile computer is set to the “Download Mode” and the connection to
the host PC is properly established, the user can run the download utility on the host PC
to download the BASIC Run-time or any other .shx files to the mobile computer. When
the Run-time Engine is downloaded successfully, the message “Ready for BASIC
Download” will be displayed on the mobile screen.
1.3.2 EDIT/COMPILE BASIC PROGRAMS
The BASIC Compiler, bc.exe, comes with a text editor where users can edit their BASIC
programs. Please refer to the next chapter for general information of the operation.
By default, the text being edited with the editor would be saved as a BASIC source file
(.bas). The system settings defined in the Configuration Menu, including “Target
Machine”, COM port settings, transaction file settings, DBF settings and barcode settings,
would be saved as a system initialization file (.ini) with the same name when the .bas file
is saved. The .ini file should be treated as part of the BASIC program, and should be
included when the BASIC program is distributed.
If the BASIC program compiles without any errors, a BASIC object file (.syn) with the
same name is generated. The .ini file and the .syn file are the two files to be downloaded
to the mobile computer. The .ini file contains the system settings, while the .syn file
contains the BASIC object code.

8
CipherLab BASIC Programming Part I
1.3.3 DOWNLOAD BASIC OBJECT FILES
Use the BASIC Compiler or the standalone BASIC download utility, Synload.exe, to
download a compiled BASIC program. Synload.exe provides only the download function
of the BASIC Compiler, that is, it cannot be used to view or edit any BASIC code.
Both the .ini and .syn files must be downloaded to the target mobile computer. Be careful
that if the .ini file is missing, the BASIC Compiler will download the default settings
instead. In this case, it may cause errors during execution. In contrast to the BASIC
Compiler, Synload.exewill not process the downloading if the .ini file is missing, and an
error message will be shown on the display.
After the BASIC object file is downloaded, the target mobile computer will reboot itself to
execute the BASIC program. If any run-time error occurs, an error message will be
shown on the display. Please refer to Appendix VI — Run-Time Error Table for a list of
run-time errors. If the program is not running as desired, modify the BASIC source code
and download it to the target mobile computer again.