CipherLab 8300 User Manual

109
Chapter 4 BASIC Commands
TIMER
Purpose To return the number of seconds elapsed since the mobile computer
is powered
on.
Syntax A& = TIMER
Remarks “A&” is a long integer variable to be assigned to the result.
Note that the TIMER is a read-
only function. The system timer cannot be set by
this command.
Example
StartTime& = TIMER
…
Loop:
IF EndTime& <> TIMER THEN
EndTime& = TIMER
TimerElapsed& = EndTime& - StartTime&
CLS
PRINT TimerElapsed&
IF TimerElapsed& > 100 THEN GOTO NextStep
END IF
GOTO Loop
NextStep:
…
See Also OFF TIMER, ON TIMER GOSUB…
WAIT
Purpose
To put the system on hold for a specified duration. In the interval, the system
will be running in a rather low power consumption mode.
Syntax WAIT(duration%)
Remarks Note that WAIT is more efficient than CHANGE_SPEED.
“duration%”
is a positive integer variable, indicating the time duration for a
hold. This argument is specified in units of 5 milliseconds.
When the application is waiting for events in a loop, the power consumption
will be dramatically reduced by calling this function.
Example
PRINT “CipherLab BASIC”
WAIT(200)
‘ the system is on hold for 1 second

CipherLab 8300 Specifications

General

IP Rating	IP54
Operating Temperature	-10°C to 50°C
Storage Temperature	-20°C to 60°C
Processor	32-bit
Memory	128 MB RAM
Battery	3.7V
Connectivity	USB, Bluetooth
Weight	280 g
Keypad	Numeric keypad

Summary

DEVELOPMENT ENVIRONMENT

1.1 Directory Structure

Describes the organization of the BASIC Compiler Kit directories and their contents for PC setup.

1.2 BASIC Runtime Engines

Explains the role of BASIC Runtime Engines as interpreters for running BASIC programs.

1.3 Development Flow

Outlines the three essential steps for developing and downloading BASIC programs.

USING BASIC COMPILER

2.1 File Menu

Details the six commands available in the File menu for program management.

2.2 Edit Menu

Explains seven commands in the Edit menu for text editing source code.

2.3 Configure Menu

Covers seven items for defining system settings like target machine and COM ports.

2.4 Compile Menu

Describes commands for syntax checking, compiling, and downloading BASIC programs.

2.5 Help Menu

Details the 'About' command for displaying program ownership and version info.

BASICS OF THE CIPHERLAB BASIC LANGUAGE

3.1 Constants

Defines string and numeric constants used in BASIC programming.

3.2 Variables

Explains variable types, naming rules, and declaration characters.

3.3 Expression and Operators

Covers assignment, arithmetic, relational, and logical operators.

3.7 Programming Style

Provides guidelines for writing readable BASIC programs.

BASIC COMMANDS

4.1 General Commands

Describes commands not tied to specific hardware features.

4.2 Commands for Decision Structures

Explains IF-THEN and ON-GOSUB/GOTO statements for conditional logic.

4.3 Commands for Looping Structures

Details FOR-NEXT and WHILE-WEND loops for repetitive tasks.

4.4 Commands for String Processing

Covers functions for manipulating text strings like LEN, MID$, LEFT$, RIGHT$.

4.7 Barcode Reader Commands

Describes commands for enabling, disabling, and reading barcode data.

4.15 Keypad Commands

Explains commands for handling keypad input and events.

4.16 LCD Commands

Details commands for controlling the LCD display, cursor, and graphics.

4.18 Fonts

Covers font size options and display capabilities for alphanumeric characters.

4.20 File Manipulation

Explains commands for managing DAT, DBF, and IDX files for data storage.

Appendix I SCANNERDESTBL ARRAY

SYMBOLOGY PARAMETER TABLE FOR CCD/LASER/LONG RANGE READER

Lists parameters for configuring CCD, Laser, and Long Range scan engines.

SYMBOLOGY PARAMETER TABLE FOR 2D/EXTRA LONG RANGE READER

Lists parameters for configuring 2D and Extra Long Range scan engines.

Appendix II SYMBOLOGY PARAMETERS

SCAN ENGINE, CCD OR LASER

Details symbology parameters for CCD, Laser, and Long Range scan engines.

SCAN ENGINE, 2D OR (EXTRA) LONG RANGE LASER

Details symbology parameters for 2D and Extra Long Range scan engines.

Appendix III SCANNER PARAMETERS

SCAN MODE

Defines various scan modes like Aiming, Laser, and Test modes for scanner operation.

READ REDUNDANCY

Specifies levels of reading security to balance with decoding speed.

TIME-OUT

Limits the maximum scanning time interval for specific scan modes.

USER PREFERENCES

Outlines customizable scanner settings for user convenience.

Appendix IV RESERVED HOST COMMANDS

CLEAR

Command to erase data from a specified transaction file.

READ

Command to read the top record from a specified transaction file.

REMOVE

Command to delete one record from the top of a specified transaction file.

TR

Command to retrieve the current system time in YYYYMMDDHHNNSS format.

TW

Command to set the system time using a YYYYMMDDHHNNSS string format.

Appendix V DEBUGGING COMMANDS

START_DEBUG

Initiates debugging by writing system activities to a specified COM port.

STOP_DEBUG

Terminates the debug function started by START_DEBUG.

Appendix VI RUN-TIME ERROR TABLE

Error Code Explanation

Lists common run-time error codes and their explanations for debugging.

Appendix VII KEY CODE TABLE

Key Name Key Code

Provides a mapping of key names to their corresponding key codes for keypad operations.