BASIC Language Programming For 8000, 8300 & 8500 Series Mobile Computers DOC Version 3.06.08 Copyright © 2007 ~ 2009 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 RELEASE NOTES Version Date Notes 3.06.08 Dec. 29, 2008 Modified: 4.15.3 FN Key – refine description of each value for FUNCTION_TOGGLE() Modified: 4.20.2 File Transfer Protocol (FTP) — removed for standard library does not support FTP Modified: 4.21.2 Network Configuration — ROAM_TXRATE_11B and ROAM_TXRATE_11G for Wi-Fi roaming only work with “customized” system scale 3.06.07 Oct. 29, 2008 Modified: 4.15.3 FN Key – FUNCTION_TOGGLE() supports new keypad of 8500 Modified: 4.21.2 Network Configuration – new parameters for Wi-Fi roaming Modified: 4.23.1 Security – Illustration of PIN/PUK procedure updated 3.06.06 July 22, 2008 Modified: 4.24 RF Communications – remove the whole section due to termination of product 8310, 8350 3.06.05 June 05, 2008 Modified: 4.24 RF Communications – remove 8110, 8150 New: 4.26 Memory Commands – MEMORY_INFORMATION() 3.06.04 Apr. 15, 2008 Modified: remove 8100 Modified: 4.16.6 Graphics – 8000/8300 support graphic functions New: 4.21.2 Network Configuration – GET_NET_PARAMETER(-36), GET_NET_PARAMETER(36) to get/set Fixed BSSID for WLAN Modified: 4.26 Memory – Information updated New: Appendix I - Symbology Parameter Table I: ISBT 128 (#152) for CCD, Laser scan engines 3.06.03 Mar. 12, 2008 Modified: Appendix IV Cradle Commands – firmware version issue for #fOrMaT:x and #SeRiAl 3.06.02 Jan. 11, 2008 New: 4.19 SET_COM() supports Acoustic Coupler for 8300 Series New: section 4.6.4 Format of BASIC program file New: section 4.20.2 FTP_ROUTINE$() – re-organize sections 4.20~ Modified: GET_NET_STATUS(11) for RSSI signal supports GPRS 3.06.01 Dec. 05, 2007 New: section 4.6.4 DOWNLOAD_BASIC(), UPDATE_BASIC() New: READER_SETTING(149, AIMING_TIMEOUT%), GET_READER_SETTING(149) for CCD, Laser scan engines New: GET_NET_PARAMETER(-35) to get BSSID for WLAN 3.06.00 Oct. 29, 2007 New Word template applied New: section 4.22.4 GET_NET_STATUS(13) for GSM applications Modified: section 4.22.7 GSM Example Modified: Appendix IV – Cradle Commands 3.05.17 May 11, 2007 Modified: 5.21.1 Bluetooth & 802.11b/g specifications New: 5.21.5 WLAN Example - WPA Enabled for Security 3.05.16 Apr. 10, 2007 New: 5.21.2 Network Configuration - WPA-related parameters New: Appendix I - Symbology Parameter Table I: UPC-E1 Triple Check (Index #148) 3.05.15 Feb. 26, 2007 New: 5.5.1 ON POWER_ON GOSUB New: 5.8 SR176 is supported Modified: 5.19.1 & 5.21.2 PPP LoginName[20] changed to LoginName[39] New: Appendix VI - Cradle commands 3.05.14 Sep. 15, 2006 New: Macro PDF417 supported Updated: section 5.7.2 Code Type - Symbology Mapping Table II Updated: Appendix I - Symbology Parameter Table II 3.05.13 Aug. 14, 2006 Modified: Modified: Format of Device ID (5.6.2) for 8300 Modified: section 5.8 RFID supported on 8300 3.05.12 Aug. 09, 2006 Modified: section 5.8.2 Data format of READ_COM$(4) - starts from Byte 1 Modified: section 5.6.2 Format of Device ID for 8300 H/W 4.0 Modified: VIBRATOR() for 8300 H/W 4.0 New: SYSTEM_INFORMATION$(9) for RFID Version Modified: section 5.8 RFID Reader New: GET_RFID_KEY(), SET_RFID_KEY() New: 5.19 IR/RS-232 Networking to include PPP & Ethernet connection Modified: START TCPIP(6) 3.05.11 June 07, 2006 READER_CONFIG() for 8300 with Long Range Laser scan engine 3.05.10 June 05, 2006 New: BACKLIT() Modified: Appendix II - minor changes 3.05.09 May 17, 2006 Modified: 5.9 Keyboard Wedge, SEND_WEDGE(), SET_WEDGE(), WEDGE_READY() New: 5.9.3 Wedge Emulator Modified: 5.20.6 Bluetooth - Wedge Emulator via SPP 3.05.08 May 11, 2006 Company name changed to CIPHERLAB CO., LTD. since April 2006 New: BIT_OPERATOR() in section 5.1 Modified: VIBRATOR() for 8300, H/W version is 4 3.05.07 Mar. 15, 2006 Modified: Appendix I ~ V New: support Bluetooth HID on 8000 3.05.06 Mar. 08, 2006 Modified: MENU() 3.05.00 Feb. 21, 2006 New: Customize Serial Number/Device ID New: SYSTEM_INFORMATION$() Modified: CHANGE_SPEED for 711/8100/8000/8300 only Modified: LED() Modified: FUNCTION_TOGGLE() Modified: coordinate system of LCD Modified: SELECT_FONT() Modified: font files renamed for 8000/8300 Modified: port mapping Modified: SET_COM_TYPE() - 7 Acoustic/GSM_Modem Modified: SET_COM() with Acoustic Settings for 8000 Modified: support 2 MB flash on 8000/8500 Modified: “PPP via IR” default baud rate for modem cradle is 57600 Modified: GSM read data format Modified: String limit 255 bytes instead of 250 bytes for section 4.1.1, 4.2.1, and 5.21.1 New: READER_CONFIG() to support 2D, (Extra) Long Range Laser scan engines for 8500 only Modified: CODE_TYPE() Modified: READER_SETTING() Modified: LCD_CONTRAST() for 8500 Modified: LOCATE() Modified: RFID 3.04.00 Nov. 18, 2005 Major changes are: Remove 720 New: Screenshots of Compiler's menus New: Code type GTIN (87) New: READER_SETTING index 86, 87 New: PPP via IR/RS-232 Modified: COM port mapping, GET_SCREENITEM, SET_COM, SET_NET_PARAMETER, START TCPIP Updated: indexing for Net Configuration and Net Status 3.03.00 Aug. 12, 2005 Updated version in new format for doc and html help. (Software version 4.01 or greater) CONTENTS RELEASE NOTES.............................................................................................................................. - 3 - INTRODUCTION.................................................................................................................................... 1 DEVELOPMENT ENVIRONMENT .......................................................................................................... 3 1.1 Directory Structure ..................................................................................................................... 3 1.2 BASIC Runtime Engines ............................................................................................................. 5 1.3 Development Flow...................................................................................................................... 5 1.3.1 Download Runtime Engine ................................................................................................ 5 1.3.2 Edit/Compile BASIC Programs .......................................................................................... 6 1.3.3 Download BASIC Object Files ............................................................................................ 6 USING BASIC COMPILER ..................................................................................................................... 7 2.1 File Menu .................................................................................................................................... 7 2.2 Edit Menu.................................................................................................................................... 9 2.3 Configure Menu ........................................................................................................................11 2.4 Compile Menu...........................................................................................................................13 2.5 Help Menu.................................................................................................................................14 BASICS OF THE CIPHERLAB BASIC LANGUAGE ................................................................................15 3.1 Constants ..................................................................................................................................15 3.1.1 String.................................................................................................................................15 3.1.2 Numeric ............................................................................................................................15 3.2 Variables ...................................................................................................................................16 3.2.1 Variable Names and Declaration Characters.................................................................16 3.2.2 Array Variables .................................................................................................................16