FORGE Batch Application Generator For 8 Series Mobile Computers: 8000 / 8200/ 8300 / 8400 / 8500 Version 2.28
Copyright 2008~2011 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. Microsoft, Windows, and the Windows logo are registered trademarks of Microsoft Corporation in the United States and/or other countries. Bluetooth is a trademark of Bluetooth SIG, Inc., U.S.A. Other product names mentioned in this manual may be trademarks or registered trademarks of their respective companies and are hereby acknowledged. 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 2.28 Jul. 19, 2011 Modified: 7.2.1 Data_Read update screenshot and settings 2.27 Jun. 03, 2011 Modified: add Convert to 8200 feature for AG8300 Modified: 5.1.5 Upload Method add USB VCOM_CDC for AG8200 Modified: 5.1.6 Download Method add USB VCOM_CDC for AG8200 2.26 May 17, 2011 Modified: Appendix IV change Code 11 and MSI to Disable by default 2.25 Mar. 21, 2011 New: support 8200 Modified: Using FTP Server to Transfer Files update screenshots Modified: 7.3.7 Change Data File Settings add log file settings Modified: 7.3.8 Manage Devices & 7.3.9 Manage Your Rules update screenshots Modified: Appendix I~II support UPC-E1 for CCD/Laser Modified: Appendix I~II support Coop 25 for CCD/Laser (8000/ 8200/8300/8400) Modified: Appendix II add Aiming Duration (8000/8200/8300/ 8400) Modified: Appendix III add Scan Mode options (8300 Only) and Time-out Modified: Appendix II~IV change Time-out range to 0~255 sec. Modified: Appendix III~IV change Aiming Duration range to 1~255 sec. Modified: Appendix IV change Codabar, Code 93 and MSI to Enable by default 2.24 Jan. 04, 2011 Modified: 1.8.16 Large Data for collecting data via 2D scan engine Modified: 1.8.17 Read from 2D Modified: 7.1.3 ProgLoad add support for command line New: Appendix V Command Line Syntax (for utilities) 2.23 Dec. 15, 2010 New: Introduction add System Requirements Modified: Introduction Getting Started, add Using MobileLink to Transfer Files over Network Modified: 5.3 Security Setting New: 7.3.8 Manage Devices New: 7.3.9 Manage Rules 2.22 Nov. 01, 2010 Modified: Introduction Getting Started, add Using FTP Server to Transfer Files Modified: Introduction Menu Bar, add FTP Communication Settings, WLAN Communication Settings and FTP File Settings Modified: 1.8.15 Counter
Modified: 7.3 Mobile Link update screenshots Modified: 7.3.3 View Link Status 8000/8300 supports Auto Upload Modified: 7.3.7 Change Data File Settings update Auto File Name Modified: Appendix II change Negative Barcode to Enable by default 2.21 Sep. 13, 2010 Modified: Getting Started, Upload Data describe icons indicating support of auto upload Modified: 3.2.4 DBF File Location (8400 Only) Modified: 3.8 Action When the Format of Record Is Wrong New: 7 Utilities Modified: 7.4 SD DBF Converter (8400 Only) Modified: Appendix I~IV add more GS1 DataBar symbologies 2.20 Apr. 02, 2010 Modified: Introduction Getting Started, Menu Bar, Toolbar and Menu Tree Modified: Installing FORGE Application Generator DATA_READ utility also synchronizes date/time on every host connection. Modified: Getting Started (1) add Upload Application Template (2) Download Lookup Files (file path changed to \AG\DBF for lookup files) Modified: Menu Bar (1) DBF Converter (file path changed to \AG\DBF for lookup files) (2) DATA_READ utility also synchronizes date/time on every host connection. Modified: 1.14.1 Field Data Decimal Places Modified: 1.2.4 Enable MSQI Modified: 3.3.3 Trim Space When Lookup Data Can Be Uploaded Modified: 5.1.6 Download Method AG8400 (file path changed to \AG\DBF for lookup files) Modified: 5.2 Function Key Setting update screenshot, etc. Modified: 5.3.1 Upload.AGX change 6-digit password to 5-digit Modified: Appendix IV 2D Scan Engine update 2.19 Nov. 19, 2009 New: support 8400-2D Modified: 5.1.5 Upload & Download Settings Buzzer Volume changed to LARGE_VOL Modified: Appendix IV Chinese 25, Matrix 25, Picklist Mode, 1D Inverse, 2D Inverse, UPU FICS Postal and USPS 4CB/One Code/ Intelligent Mail 2.18 June. 25, 2009 Modified: 3.2.4 DBF File Location and section 6.3.3 DAT File Location features are added. Modified: 5.1.5 add DBF Converter, download and upload information 2.17 May. 07, 2009 Modified: Convert to 8300 and other 8400 supported features are added. 2.16 Jan. 19, 2009 Modified: 8400 supported features are added. 2.15 Nov. 26, 2008 Applied new GUI screen shots and modified the relative contents.
2.14 July 30, 2008 Modified: 6.3 add Use Large Font for Data Browsing for AG8000 and AG8300 Modified: Appendix II~III support replacement of EAN-128 field separator for all scan engines 2.13 Jun. 26, 2008 Modified: 1.6 Record add remove from lookup and save & remove options Modified: 3.11 Action When the Input Data Has No Match add remove from lookup and save & remove options Modified: 4.1.2 RFID Reader Automatically enabled after initialization (checkbox removed from UI) New: Long Range Laser option available for 8300 2.12 Nov. 06, 2007 Modified: 4.1.2 RFID Reader RFID tags in proximity will be read automatically by 8300/8500 when RFID reader is enabled 2.11 Oct. 18, 2007 Modified: Features 2.10 Sep. 19, 2007 New Word template applied 2.07 June 20, 2006 Company name changed to CIPHERLAB CO., LTD. since April 2006 Modified: 5.3 Barcode & Parameters 2.06 Apr. 14, 2006 Modified: 1.2.2 Font_12x12 not supported Modified: 5.1 & 5.2.6 Modified: 6.2, 6.4 & 6.5 2.05 Apr. 10, 2006 AG for CPT-8500 is included
CONTENTS RELEASE NOTES... - 3 - INTRODUCTION... 1 System Requirements... 2 Intended Purpose... 2 Features... 2 Installing FORGE Application Generator... 3 Getting Started... 4 Download AG Runtime... 4 Design Application Template... 5 Download Application Template... 6 Download Lookup Files... 6 Collect & Edit Data... 6 Upload Data... 7 Upload Application Template... 8 Localization... 8 Using FTP Server to Transfer Files... 9 FTP Communication Settings...10 WLAN Communication Settings...11 WLAN Security Settings...12 FTP File Settings...14 Using MobileLink to Transfer Files over Network...16 MobileLink Settings...16 Menu Bar...17 Preference...19 AGX Template Conversion...20 Recent File List...23 Language...23 Toolbar...24 Menu Tree...24 FORM...25 1.1 Select a Form...26 1.2 Properties...26 1.2.1 Esc...26 1.2.2 Next...26 1.2.3 Record...27 1.2.4 Enable MSQI...28 1.3 Font Size...30 1.4 Lookup (File)...30 1.5 Date & Time Stamp...31 1.6 Branch...32 1.7 Reset Current Form...32
FORGE Batch Application Generator User Guide 1.8 Data Type...33 1.8.1 Nil...34 1.8.2 Text...34 1.8.3 Letter...34 1.8.4 Alphameric...34 1.8.5 Integer...34 1.8.6 Real...35 1.8.7 Auto (+/-)...36 1.8.8 Extension...37 1.8.9 Pass down...38 1.8.10 Boolean...38 1.8.11 Lookup...38 1.8.12 Fixed Data...39 1.8.13 Prompt...39 1.8.14 Pause...39 1.8.15 Counter...39 1.8.16 Large Data...41 1.8.17 Read from 2D...41 1.9 Prompt...42 1.10 Input Type...42 1.11 Minimum Length...42 1.12 Maximum Length...43 1.12.1 Input via Barcode/RFID Reader...43 1.12.2 Input via Keypad...43 1.13 Variables...44 1.13.1 Lookup (Field)...44 1.13.2 Variables...44 1.14 More...45 1.14.1 Field Data...45 1.14.2 Barcode Input...46 MENU...49 2.1 To Select a Menu...50 2.2 Properties...50 2.2.1 Menu Caption...50 2.2.2 ESC...50 2.3 Font Size...50 2.4 Data...51 2.4.1 Save Caption...51 2.4.2 Save Selected Item...51 2.4.3 Pass Down...51 2.5 Save Collected Data for Each Form to Separate Data Files...51 2.6 Item Name...52 2.7 Next...52 2.8 Reset Current Menu...52 LOOKUP...53 3.1 To Select a Lookup File...54 3.2 Field Property...54
FORGE Batch Application Generator User Guide 3.2.1 Number of Fields...54 3.2.2 Fixed Length...54 3.2.3 Delimiter...54 3.2.4 DBF File Location (8200/8400 Only)...55 3.3 Lookup Data...56 3.3.1 Only Read Data Once...56 3.3.2 Lookup Data Can Be Uploaded...56 3.3.3 Trim Space When Lookup Data Can Be Uploaded...56 3.4 Action When the Input Data Has No Match...57 3.4.1 Continue...57 3.4.2 Show Warning Message...57 3.4.3 Insert to Lookup File...57 3.4.4 Show Warning Message & Insert...57 3.4.5 Clear the Screen...57 3.4.6 Show Warning & Clear Screen...58 3.5 Offset...59 3.6 (Max) Length...59 3.7 Key Field...59 3.8 Action When the Format of Record Is Wrong...60 3.8.1 Stop the Download Process...60 3.8.2 Truncate / Reformat the Record...61 3.8.3 Skip the Record...62 3.9 Reset Current Lookup File...62 SYMBOLOGY...63 4.1 Reader Settings...63 4.2 Code ID...64 4.3 Reset...64 4.4 Barcode & Parameters...64 SETTINGS...65 5.1 Initial Settings...66 5.1.1 Data Manipulation...66 5.1.2 Keypad & LCD...67 5.1.3 Notification...67 5.1.4 Reader Option...68 5.1.5 Upload Method...69 5.1.6 Download Method...71 5.1.7 Baud Rate & Modem Speed...73 5.1.8 Reset Settings...73 5.2 Function Key Setting...74 5.3 Security Setting...75 5.3.1 Security Checking...75 5.3.1 Upload.AGX...76 STARTUP...77 6.1 Application Start From...77 6.2 Prompt Font Size...78 6.3 Data Field Properties...78
FORGE Batch Application Generator User Guide 6.3.1 Number of Delimiter...78 6.3.2 Browse data font size...78 6.3.3 DAT File Location...78 6.4 Redefine Prompts & Messages...79 6.5 Import Prompts & Messages...79 6.6 Reset Prompts & Messages to Default...79 UTILITIES...81 7.1 Download Utilities...82 7.1.1 AG Load...82 7.1.2 DLookup...85 7.1.3 ProgLoad...88 7.2 Upload Utilities...90 7.2.1 Data_Read...90 7.2.2 AGX_Read...94 7.3 Mobile Link...96 7.3.1 Prerequisites...96 7.3.2 Menu Bar & Toolbar...97 7.3.3 View Link Status...98 7.3.4 View Received Files...100 7.3.5 View Device Information...103 7.3.6 Change Connection Settings...104 7.3.7 Change Data File Settings...105 7.3.8 Manage Devices...107 7.3.9 Manage Your Rules...113 7.4 SD DBF Converter (8200/8400 Only)...119 7.5 Program Simulation...121 SCAN ENGINE SETTINGS...123 Symbologies Supported...124 RFID Tags Supported...126 CCD/LASER SCAN ENGINE...129 Reader Settings Table...129 Symbology Settings Table...131 LR/ELR LASER SCAN ENGINE...137 Reader Settings Table...137 Symbology Settings Table...138 2D SCAN ENGINE...143 Reader Settings Table...143 Symbology Settings Table...145 1D Symbologies...145 2D Symbologies...150 COMMAND LINE SYNTAX...153 Download Utilities...154 DLookup...154 ProgLoad...155
FORGE Batch Application Generator User Guide Upload Utilities...157 Data_Read...157
INTRODUCTION FORGE Application Generator for 8000/8200/8300/8400/8500 Series Mobile Computers, featuring easy-to-use and quick-to-apply, is designed for the users to develop custom templates for the use with AG runtime preloaded on the mobile computers. Users are then able to define their own data collection templates on any desktop computer without spending time writing any program code. FORGE Application Generator is used to develop applications for many purposes, such as Receiving in Retail Price Check Product labeling & Tracking Shelf Product Replenishment Mobile Point of Sale (POS) Mobile Inventory Management Order Picking & Staging Work-In-Process Tracking Material Flow Control Transportation & Distribution Warehousing Asset Management FORGE Application Generator presents itself as a miniature image of the mobile computer. It simulates the program s running sequences on the actual mobile computer, and therefore, allows you to design a new application on screen in minutes. After having configured and saved your template, download the application template file and lookup file(s) to the mobile computer. When running the AG runtime on the mobile computer, data collection can commence immediately by making use of the template downloaded. This manual serves to provide comprehensive understanding of FORGE Application Generator for 8000/8200/8300/8400/8500 Series Mobile Computers, and helps define custom template for a specific application. We recommend that you read the document thoroughly before use and keep it at hand for quick reference. Thank you for choosing CipherLab products! 1
FORGE Batch Application Generator User Guide SYSTEM REQUIREMENTS To run the program, one of the Windows operating systems is required: Windows 2000 Windows XP Windows Vista Windows 7 INTENDED PURPOSE Data collection mainly consists of three elements: input (scanning or key-in), data processing, and output (or updating database). FORGE Application Generator for 8000/8200/8300/8400/8500 Series Mobile Computers is specifically designed to deal with the sequences of data processing inside the mobile computers. You may use the Batch AG program and runtime with any wireless mobile computer if wireless connectivity is not desired. In particular, when you use a Bluetooth mobile computer, say 8062 or 8330, you will be able to use Bluetooth SPP for download and upload by selecting RS-232/IrDA/USB VCOM. FEATURES Definition of program flow Editing of screens and data Managing barcode reader and RFID reader Font size options and program localization Simple program simulation for debugging Password-protected user settings to prevent unauthorized user intervention Hot key selection for tasks or user settings menus Definition of system initial settings for a quick start Easy cloning by downloading the template file Integrated interface for downloading lookup files and uploading data FTP client configuration for wireless mobile computers, as well as for 8200/8400 used with Ethernet Cradle 2
Introduction INSTALLING FORGE APPLICATION GENERATOR Install FORGE Application Generator for 8000/8200/8300/8400/8500 Series Mobile Computers from the Product CD. If you did not change to install to a different folder, it will install the application to the default directory C:\CipherLab\Forge\Batch\. Shortcuts to the AG program is created and placed in Start All Programs CipherLab Forge Batch Application Generator. Shortcuts to the utilities are created and placed in Start All Programs CipherLab Forge Batch Utilities. Refer to Utilities. Shortcut Name of Utility Program Name Usage AG_Load AG_Load.exe To download the current application template to the mobile computer. Data_Read Data_Read.exe To receive data via Data_Read utility. It also synchronizes date/time on every host connection. DBF_Converter DBF_Converter.exe To convert text file into DBF file. DLookup DLookup.exe To download associated lookup file(s) to the mobile computer MobileLink MobileLink.exe To receive data from the mobile computer via Mobile Link utility. Prog_Load ProgLoad.exe To download the AG runtime or font file (.SHX) to the mobile computer. Simulator Simulator.exe To launch the simulator. AGX_Read AGX_Read.exe To upload the current application template from the mobile computer. 3
FORGE Batch Application Generator User Guide GETTING STARTED 1) Run the 8 Series Batch AG program on your computer. The work area appears as shown below, and each element is described in the following sections. Menu Bar Toolbar Menu Tree DOWNLOAD AG RUNTIME 2) Click Transfer Send Program to download the AG runtime program (U8*.SHX) to the mobile computer. Refer to Localization for downloading font file. On the mobile computer, press [7] + [9] + [Power] simultaneously to enter System Menu Load Program. Note: Make sure the download settings on the mobile computer and PC side are matching. 4
Introduction DESIGN APPLICATION TEMPLATE 3) Click File New or File Open to work on a new or existing application template. An application template is composed of six tabs; each is a property page for custom configurations. From the tree list on the left pane, click new or the latest application template. to start your configuration for a Warning: On the Settings tab, you must select the correct barcode reader in the initial setting page even though no modification is made to its settings. Otherwise, it will indicate "wrong reader type" after downloading the template file to the mobile computer and cause the reader to fail! Property Pages Startup Settings Symbology Menu Lookup Form You may configure program sequences and customize user interface on the mobile computer. You may configure system settings so that they will take effect when initialization is done on the mobile computer. You may configure symbologies and barcode parameters. Menus are used to provide multi-level options, which may be placed under the main menu, e.g. 1. Collect Data Menu 1 (Menu 2) Form 1. Data of forms may make reference to one or up to 3 lookup files. You need to specify the data format of a lookup file. Forms are used to show information and allow for data input, which may be placed under a user menu, e.g. 1. Collect Data (Menu 1) Form 1. 4) Upon completion, click File Save or File Save As to save the current editing template to file (.AGX). You may run program simulation and verify whether these program sequences meet your requirements. Refer to 7.5 Program Simulation. Note: For initial downloading of the application template, you must manually configure the download settings on the mobile computer. Then, the upload and download interface settings on the mobile computer will be overwritten by the settings of the application template after downloading. 5
FORGE Batch Application Generator User Guide DOWNLOAD APPLICATION TEMPLATE 5) Establish a proper connection between your mobile computer and the host. 6) Click Transfer Send Application to download the template file (*.AGX) to the mobile computer. On the mobile computer, select 3. Utilities 6. Load Application to download the template file. After downloading, the main menu is displayed. Warning: In the application template file, the upload and download interface settings for the mobile computer and PC side must match. Note: SD Card option is provided for 8200/8400 to download template file (.AGX) from the card. The default import directory is \AG\IMPORT for template file, which will be created on SD card automatically. When using AG program version 1.00.0005 or later to create and download a template file, it may be configured to allow uploading the template file from the mobile computer at a later time. Refer to Upload Application Template and 5.3.1 Upload.AGX. DOWNLOAD LOOKUP FILES 7) If any lookup file is specified in use in the template file, you must download the lookup file(s). Refer to section 1.4 Lookup (File) and 3 Lookup. Click Transfer Send Lookup to download up to three lookup files for use. Alternatively, you may use the DLookup.exe utility to download text files for reference purpose. On the mobile computer, select 3. Utilities 8. Load Lookup File to download the associated lookup file(s). After downloading, the main menu is displayed. Note: SD Card option is provided for 8200/8400 to download lookup files from the card. The default import directory is \AG\DBF for lookup files, which will be created on SD card automatically. Refer to 7.4 SD DBF Converter (8200/8400 Only). Before you download the lookup files, you must use the DBF converter tool to convert text files (.TXT) to DBF format (.DB0). It will automatically copy these files to the import directory \AG\DBF on either SD card or SRAM. COLLECT & EDIT DATA 8) On the mobile computer, select 1. Collect Data to start with the data collection task. 9) On the mobile computer, select the following submenus if you want to edit the collected data 3. Utilities 2. Browse Data 3. Utilities 3. Delete Data (Refer to section 5.1.1 Data Manipulation.) 6
Introduction UPLOAD DATA 10) Click Transfer Direct-Link Data Transfer or Transfer MobileLink Data Transfer to receive the collected data (.txt) from the mobile computer. On the mobile computer, select 2. Upload Data to send the collected data back to the host. Data file(s) Lookup file(s), if any in use All (one by one) All (append), that is, all-in-one Refer to section 1.2.3 Record and 3.3.2 Lookup Data Can Be Uploaded. If no lookup files are defined on both the Form and Lookup property pages, you may receive data from the mobile computer via the Data Read utility. Note: (1) Batch AG supports automatically uploading data to a host computer when the upload interface is properly configured. Once the mobile computer is seated in the cradle or connected via the RS-232 or USB Virtual COM cable, there will be a running dot or hourglass icon displayed on the upper-right corner of the screen, indicating the mobile computer is ready for auto upload. Refer to 7.2.1 Data_Read. (2) SD Card option is provided for 8200/8400 to upload DAT files and DBF files to SD card. The files will be saved to the default directory \AG\EXPORT, which will be created on SD card automatically. 7
FORGE Batch Application Generator User Guide UPLOAD APPLICATION TEMPLATE When using AG program version 1.00.0005 or later to create and download a template file, it may be configured to allow uploading the template file from the mobile computer at a later time. Refer to 5.3.1 Upload.AGX. 1) Establish a proper connection between your mobile computer and the host. 2) Click Transfer Receive Application to upload the template file (*.AGX) from the mobile computer. On the mobile computer, stay in the main menu or select 3. Utilities to upload the template file. Warning: The upload interface settings for the mobile computer must match the setting of AGX_Read.exe on PC side, either Cradle-IR or RS-232/IrDA/USB VCOM. LOCALIZATION If you want to customize the entire application to your local language, you must translate the text of the user interface into your own language, as well as re-define menus and messages for the runtime. 1) Click Transfer Send Program to download the desired font file (.SHX) to the mobile computer. On the mobile computer, press [7] + [9] + [Power] simultaneously to enter System Menu Load Program. 2) Save the original language file (.lng) of the AG program as a new file - translate the text of the user interface from English to another language. 3) Click Language from the Menu Bar and select this new.lng file for the current language. 4) Re-define the template prompts and messages on the Startup property page of the application template. For 8000/8300, apply large font on the Form and Menu property pages for double-byte languages such as Japanese, Chinese, etc., so that their contents will be displayed properly on the actual screen. However, the rest of prompts and messages can only be displayed in alphanumeric characters in the current system. 5) Click Transfer Send Application to download the template file (.AGX) to the mobile computer. 6) Turn on the mobile computer to run the AG runtime program (U8*.SHX). Select 3. Utilities 6. Load Application to download the template file. 8
Introduction USING FTP SERVER TO TRANSFER FILES When using AG program version 1.00.0008 or later to create and download a template, it may be configured to allow transferring files with an FTP server wirelessly or via Ethernet Cradle. The FTP client configuration is provided for the mobile computer to log in to a FTP server for the following tasks: Update the script file Upload or download lookup files (version control with downloads) Upload data files 9
FORGE Batch Application Generator User Guide FTP COMMUNICATION SETTINGS Server IP or Name Specify the IP address or name of the FTP server. Port Specify the remote port number. By default, TCP port 21 is used on the server for the control connection. User Name Specify the user name for logging onto FTP server. (64 characters maximum) Password Specify the password for logging onto FTP server. (64 characters maximum) FTP Communication Interface Options 8071 8200 8230 8330 8370 8400 8470 WLAN Ethernet Cradle 10
Introduction WLAN COMMUNICATION SETTINGS Enable DHCP By default, DHCP server is enabled and all the settings can be obtained from it. If DHCP server is disabled, you must provide the following information Subnet Mask Gateway DNS Server Terminal IP SSID This refers to Service Set ID or Identifier, which serves to uniquely identify a group of wireless network devices used in a given Service Set. For example, you need to specify the same SSID here as is used for access points so that the mobile computer can associate to the access points. SSID can be made up of 32 characters maximum. Security Authentication and encryption help provide data protection on the 802.11b/g network. Refer to WLAN Security Settings. 11
FORGE Batch Application Generator User Guide WLAN SECURITY SETTINGS Authentication Two types of network authentication methods are supported: Open System and Shared Key. Setting Open System Shared Key Remark Using Open authentication, any wireless station can request authentication. The station that needs to authenticate with another wireless station sends an authentication management frame that contains the identity of the sending station. The receiving station or AP will grant any request for authentication. Open authentication allows any device network access. If no encryption is enabled on the network, any device that knows the SSID of the access point can gain access to the network. Using Shared Key authentication, each wireless station is assumed to have received a secret shared key over a secure channel that is independent from the 802.11b/g wireless network communications channel. Shared key authentication requires that the client configure a static WEP key. The client access will be granted only if it passed a challenge based authentication. Note: For Shared Key authentication, the active WEP key is used for authentication. 12
Introduction EAP Select the check box to enable authentication using Extensible Authentication Protocol (EAP). It requires user name and password so that the mobile computer can identify itself when associating to Cisco access points. Setting Identity Password Remark Specify a user name. (32 characters maximum) Specify a password. (32 characters maximum) WEP Key Select the check box to implement Wired Equivalent Privacy or Wireless Encryption Protocol (WEP) for data encryption. Setting Key Length Key 1 ~ 4 Active Remark Encryption type can be 64 bits (5 bytes) or 128 bits (13 bytes). Using 64-bit encryption, the password phrase can be 5 characters long. From the Grid Control, select up to 5 characters (ASCII codes) for the WEP key. For 128-bit encryption, the password phrase can be 13 characters long. From the Grid Control, select up to 13 characters (ASCII codes) for the WEP key. Key index number. Up to four WEP keys can be configured. Only one key (the active one) can be used at a time. Note: You must use the same settings as configured for other devices on your wireless network, e.g. access points. WPA-PSK/WPA2-PSK Passphrase WPA-PSK is supported to enhance security over wireless networks, and this Pre-Shared key mode requires a passphrase to access the network. The passphrase must be 8 to 63 characters (ASCII codes). It is used to generate a WEP key automatically. For 8200/8400, it also supports WPA2-PSK! 13
FORGE Batch Application Generator User Guide FTP FILE SETTINGS Download Script File Decide whether to download any update to the script file FTP.dat, if there is any, from FTP server. Create Script File Decide whether to create the script file FTP.dat and save the related settings with it on your computer. The file name FTP.dat is reserved for the script file. The file name must be uppercase while the file extension must be lowercase. 14
Introduction Data File Settings Decide which data files are to be uploaded to FTP server. Instead of using the default file name DATAF1~DATAF10, you may change it if necessary. The maximum length of a full-path file name is 255 characters. If file path is not specified, the data file will be uploaded to the root directory on FTP server. Lookup File Settings Decide whether to download or upload any lookup files. When Download is enabled for a lookup file, Upload is enabled automatically by default. Cancel the check box of Upload if necessary. When Download is enabled for a lookup file, you may apply version control if necessary. Uploads will be saved to the root directory on FTP server, with the file names DBF1.txt~DBF3.txt. Downloads will be saved to SRAM or SD in DBF format, depending on the Lookup settings. 15
FORGE Batch Application Generator User Guide USING MOBILELINK TO TRANSFER FILES OVER NETWORK Mobile Link is provided for mobile computers to establish a connection with the host via Ethernet Cradles. It allows uploading data files and/or lookup files, as well as downloading lookup files. Refer to 7.3 Mobile Link. MOBILELINK SETTINGS Enable MobileLink Data Transfer For the mobile computer to transfer files over the network, you must have: MobileLink data transfer enabled Ethernet Cradle selected as the upload interface for the mobile computer Ethernet Cradle configured to work in Data Mode and connect to the host computer with correct host IP and port number Enable Auto Update Once connected, it may start to transfer data over the network automatically or manually. By default, Auto Update is enabled. It will automatically start to upload or download data over the network. Download requires file path to be specified in the lookup file settings in System Rule Maintenance. Refer to 7.3 Mobile Link. 16
Introduction MENU BAR The Menu Bar contains a number of menus that specify which task you want the system to perform. Each menu contains a list of commands and sometimes sub-menus. For the provided tools, refer to Utilities. Menu Command Action File New To create a new application template. Open Save To open an existing application template. File path needs to be specified. To save the current editing template. Save As To save the current editing template to a new file. Preference To configure the software settings. Refer to Preference. Convert to 8xxx To convert the AGX Template for another model of 8 Series product line. Refer to AGX Template Conversion. Recent File List Exit To quick launch the recently opened template file. Refer to Recent File List. To close the Application Generator. Transfer Send Program Send Application Receive Application Send Lookup To download the AG runtime or font file (.SHX) to the mobile computer. To download the current application template to the mobile computer. To upload the current application template from the mobile computer. You must provide the matching password. Refer to Upload Application Template and 5.3.1 Upload.AGX. To download associated lookup file(s) to the mobile computer. Direct-Link Data Transfer To receive data via Data_Read utility. It also synchronizes date/time on every host connection. 17
FORGE Batch Application Generator User Guide MobileLink Data Transfer To receive data from the mobile computer via Mobile Link utility. FTP Settings Communication To specify IP address of FTP server, remote port number, user name/password for logging onto FTP server. Refer to FTP Communication Settings. WLAN Settings Communications To specify wireless networking settings for 8071, 8330/8370, or 8470. Refer to WLAN Communication Settings. Tools MobileLink Settings FTP File Settings Simulator To specify whether auto update is allowed. Refer to 7.3 Mobile Link. To specify uploads and downloads. Refer to FTP File Settings. To launch the simulator. Language DBF Converter To convert text file into DBF file, for use with SD card on 8200/8400. To select a preferred language for the program GUI. Refer to Language. Help About Forge AG To show information about the Application Generator. 18
Introduction PREFERENCE Click File Preference and you may configure preferred features for launching the program. Auto pre-load the last editing file You may select the check box so that the last editing file will be loaded upon running the AG program (ForgeAG.exe). Always on top You may select the check box so that the AG program (ForgeAG.exe) and the utilities always remain on top of all other windows on the desktop. 19
FORGE Batch Application Generator User Guide AGX TEMPLATE CONVERSION Click File Convert to 8xxx and you may convert the current template for another model of 8 Series product line. 20
Introduction The following items will be changed during the converting process: Upload/Download interface will be changed. Prompts & Messages will be changed. Conversion of Upload/Download Interface Conversion between Devices Upload Interface Download Interface Original Target Original Target Original Target 8300 8000 Direct-RS232 Cradle IR Direct-RS232 Cradle IR Keyboard Wedge 8400 Direct-RS232 RS232 Direct-RS232 RS232 Cradle IR Cradle IR IrDA IrDA Keyboard Wedge USB HID 8200 Direct-RS232 RS232 Direct-RS232 RS232 Cradle IR Cradle IR IrDA IrDA Keyboard Wedge USB HID 8330/8370 8071 Direct-RS232 Cradle IR Direct-RS232 Cradle IR Keyboard Wedge 8470 Direct-RS232 RS232 Direct-RS232 RS232 Cradle IR Cradle IR IrDA IrDA Keyboard Wedge USB HID 8500 8200 Cradle IR RS232 Cradle IR RS232 IrDA IrDA 8400 Cradle IR RS232 Cradle IR RS232 IrDA IrDA 21
FORGE Batch Application Generator User Guide Conversion of Prompts & Messages on Startup Page The Interface prompts of upload port and download port will be reset to the defaults of the target device. For 8500 series, if you click Convert to 8400, the prompt F8:Edit F9:Del will be changed to 8400 s F8:Edit Del:Del. If you convert the 8300 AGX template to the 8000 AGX template, the prompts which are considered too long will be truncated automatically. Note: For prompts on Form page and Menu Caption/Item Name on Menu page, long strings will be truncated while converting the template from 8300 to 8000. 22
Introduction RECENT FILE LIST If you ever saved a template, it will be displayed in the File Menu as well. Up to 4 recent template files are listed for quick access. Click File and choose any of the four files to open the template for editing. It will then be placed on top of the list. LANGUAGE If there is any language file (*.lng) saved in the language folder where the AG program is saved, language options will become available. Click Language and you may select a preferred language for the GUI of the program. Refer to Localization. 23
FORGE Batch Application Generator User Guide TOOLBAR The toolbar offers most of the functions provided in the Menu Bar. Click the Icon on the toolbar for a quick launch. Icons Command Description New To create a new application template. Open Save To open an existing application template. File path needs to be specified. To save the current editing template. Send Application Send Lookup To download the current application template to the mobile computer. To download associated lookup file(s) to the mobile computer. Get File via Direct-Link About To receive data from the mobile computer. To show information about the Application Generator. Exit To close the Application Generator. MENU TREE In the work area, a menu tree is displayed on the left pane for navigation. Click "+" to expand the tree or "-" to collapse it. Click an existing item from the tree list. Its contents will be displayed on the right pane. 24
FORM Chapter 1 A form is a data collection template with input prompts. Data will be kept as a transaction record after the user completes all the input fields (lines) of a form. Then, it can be saved in a transaction file, added to its lookup database, or directly output to a printer, etc. Each form allows at most eight input fields (8 lines). Ten different forms can be defined. The attributes on this property page are explained in detail as follows. 2 4 6 1 5 3 7 8 9 10 11 12 13 14 25
FORGE Batch Application Generator User Guide IN THIS CHAPTER 1.1 Select a Form... 26 1.2 Properties... 26 1.3 Font Size... 30 1.4 Lookup (File)... 30 1.5 Date & Time Stamp... 31 1.6 Branch... 32 1.7 Reset Current Form... 32 1.8 Data Type... 33 1.9 Prompt... 42 1.10 Input Type... 42 1.11 Minimum Length... 42 1.12 Maximum Length... 43 1.13 Variables... 44 1.14 More... 45 1.1 SELECT A FORM Select a form to start with. Usually "Form 1". Form 1 ~ 10 1.2 PROPERTIES 1.2.1 ESC Select a form or menu that will be displayed when you press the [ESC] key on the mobile computer. For settings of user menus, refer to the Menu property page. Main Menu Form 1 ~ 10 Menu 1 ~ 10 Note: Normally, the [ESC] key is used to return to a previous form or menu. 1.2.2 NEXT Select a form or menu that will be displayed when the last input field of the current form has been completed. For settings of user menus, refer to the Menu property page. Main Menu Form 1 ~ 10 Menu 1 ~ 10 This function is invoked by sending the key value of [Enter] when you finish with the last input field. And, the setting of section 1.10 Input Type decides the way to produce the key value of [Enter]. 26
Chapter 1 Form Input Source of the last line Operation Reader Auto ENTER for barcode input must be configured as "Scan + ENTER". Refer to section 1.14 More. Keypad Press the [Enter] key on the 8000/8200/8300/8400/8500 Series mobile computer. Both RFID All See the two options above. Press the [Enter] key on the 8300/8500 Series mobile computer. See all the options above. 1.2.3 RECORD Select which action to take as soon as the input fields of a form have been completed. Options Save Update lookup Save & update Pass down Output record Output screen Save & output record Save & output screen Remove from lookup Action... To save the record to a sequential data file. To update the lookup file associated with the form. To save the record to a sequential data file, and update the lookup file. To pass down data to the next form or menu without saving. To output the record directly to a printer through COM port instead of saving it to a file. Similar to "output record". To output what is displayed on the screen, such as the prompts and data collected. To save the record to a sequential data file and output it directly to a printer through COM port. To save the record to a sequential data file and output what is displayed on the screen. To remove the record from the lookup file. Save & remove To save the record to a sequential data file and remove it from the lookup file. Note: Instead of saving all the collected data to a data file, you may select to save the collected data for each form to separate data files on the Menu property page. Based on the selected option of Record and section 3.3.2 Lookup Data Can Be Uploaded, you can upload data file(s) or lookup file(s), or both files ("All, one by one"), or even merge them to a new file ("All, append"). Note: The uploaded file is a sequential file. 27
FORGE Batch Application Generator User Guide Data file: This is available only when you have selected "save", "Save & update", "Save & output record", "Save & output screen", or Save & remove for Record. Lookup file: This is available only when you have specified a lookup file in use and allowed it to be uploaded. On the mobile computer, select 2. Upload Data after you have completed the data collection task and establish a proper connection with the host. Warning: If you have selected "output record" or "output screen" for Record, 2. Upload Data on the mobile computer will become unavailable. 1.2.4 ENABLE MSQI When the Multiple Scan Quantity Incrementing (MSQI) function is enabled, the form is set to be processed again and again until you press the [ESC] key on the mobile computer. Data will be saved to a data file. Line 1 is set to text for data type. If a lookup file is specified in use, the lookup field will be automatically set to the key field. Line 2 is set to MSQI for data type. By default, the initial value is 0 ; you may specify a value instead. If a lookup file is specified in use, the initial value depends on the lookup field you select. If a lookup file is specified in use, you may specify to import more information (line #3~) from the lookup file and display it on the mobile computer. 28
Chapter 1 Form The process designed in Form 01, as shown above, will repeat as long as you are scanning barcodes. When you keep scanning the same barcode, it will accumulate the value for Qty field by one for each scanning. When you scan a different barcode, it starts all over again with accumulating the quantity of this new item. Data for the previous item will be saved as a transaction record! Below is the process flow explaining how MSQI function works. 1) Scan a barcode for an item. (line #1) 2) The lookup value will be displayed as the initial value. (line #2) (If no lookup file is specified in use, the pre-defined initial value will be displayed.) 3) Scan the barcode again, and it will accumulate the value by 1. 4) You may keep scanning barcodes for different items. Repeat step 2 and step 3. Data for the previous item will be saved automatically. Take the scanning in step 3 for example, data for the quantity field saved with this transaction record is the value displayed on the screen, say 3 for this case. 5) Press [ESC] to end the scanning task. You are required to input a track number. Enter a number if necessary; otherwise, click [Enter] to skip it. 29
FORGE Batch Application Generator User Guide Note: Alternatively, if you have a large number of the same item, you may manually input the quantity, say 30. It will override the previous scanning of this item. Press [ESC]. Data for the quantity field saved with this transaction record is 30. 1.3 FONT SIZE Large font (8x16) must be applied for double-byte languages, such as Chinese, Japanese, etc. On the Form and Menu property pages, font size needs to be changed accordingly. Refer to Localization and 2.3 Font Size. Mobile Computer Small (Font 6x8) Large (Font 8x16) 8000 Series 16 characters by 8 lines (default) 12 characters by 8 lines 8200 Series N/A 20 characters by 8 lines 8300 Series 20 characters by 8 lines (default) 15 characters by 8 lines 8400 Series N/A 20 characters by 8 lines 8500 Series N/A 20 characters by 8 lines Note: This setting is not available for 8200/8400/8500 Series because it must use large font. 1.4 LOOKUP (FILE) A lookup file is a database. Select whether or not a lookup file is associated with the form. If a lookup file is used, its data format must be defined on the Lookup property page. On this property page, the following settings must be configured: section 1.8 Data Type section 1.4 Lookup (File) section 1.13.1 Lookup (Field) Note: The associated lookup file(s) must be downloaded to the mobile computer. 30
Chapter 1 Form 1.5 DATE & TIME STAMP It may be helpful in analyzing data when the date and time information is joined in each record. Stamp Position You can select whether or not to enable the stamp function and include the date/time information, either to the beginning or to the end of a record. By default, date/time information is separated into two fields by inserting a character, (comma). Date & Time Format Select the format of the Date and Time stamps. To stop the use of either stamp, clear all the associated settings. 31
FORGE Batch Application Generator User Guide 1.6 BRANCH Normally, a form is to be followed by either another form or menu. This feature is provided when a form is designed to lead to more than one other form. Also, it allows the linking to another form, which may jump over a number of forms or menus. Up to four branches are provided through the use of function keys. Take the following illustration for example. Note: Data cannot be passed down through branches. 1.7 RESET CURRENT FORM Press this button to reset current form to default. 32
Chapter 1 Form 1.8 DATA TYPE Specify the data type line by line to address your application requirements. The associated settings for each data type are marked in the table below. Data Type Prompt Input Source Length Lookup Properties on-screen saved in record Min / Max Field More... nil text letter alphanumeric integer real auto (+/-) extension pass down boolean lookup User-definable fixed data prompt pause counter Large data Read from 2D 33
FORGE Batch Application Generator User Guide 1.8.1 NIL No data input is allowed. This is the default setting. There will be single line spacing on the mobile computer screen. 1.8.2 TEXT ASCII character any character is acceptable. For example, $1a2b3c=-*/ 1.8.3 LETTER Alphabetic character any letter is acceptable, capital or small (Aa ~ Zz). 1.8.4 ALPHAMERIC Any alphabet or number is acceptable. For example, ABC123xyz 1.8.5 INTEGER Whole number - any number is acceptable, such as -2, -1, 0, 1, 2 34
Chapter 1 Form 1.8.6 REAL Read number any number with a decimal representation is acceptable, rational or irrational. For example, 4.56 When integer or real is selected along with lookup field specified, the lookup value will be first displayed in the input field on the mobile computer screen. Then, data input is allowed. Lookup (field) Field 1 ~ 8 +Field 1 ~ 8 If you select "Save & Update" for Record... The input value will overwrite the lookup value. No arithmetic operations are performed. It will automatically add the input value to the lookup value. - Field 1 ~ 8 It will automatically subtract the input value to the lookup value. 35
FORGE Batch Application Generator User Guide 1.8.7 AUTO (+/-) This is similar to data type integer, except that the lookup value is displayed before the input field. There may be an arithmetic sign (+, -) in front of the input field, which depends on the setting of the lookup field. 36
Chapter 1 Form 1.8.8 EXTENSION No data input is allowed. The line needs to be reserved as an "extension" of the previous line so that the whole input data can be displayed on the mobile computer screen. Note: The number of extension lines depends on the maximum length of your data and the screen size of the mobile computer. Take the following for example If the screen of the mobile computer allows 20 characters per line for small font, Now the prompt string ("Description:" in line 2) takes 13 characters, and the data length is 15 characters at most. This makes the total length 28 characters at most, which is longer than one line. As a result, the data type of line 3 needs to be set "extension" if you want to display the input data in full. 37
FORGE Batch Application Generator User Guide 1.8.9 PASS DOWN No data input is allowed. Data of this line may be imported from a previous form, of which the setting of Record is specified as "pass down". When one line is not enough for displaying the inherited contents, set its following line(s) to be an "extension". Or, it may be imported from a menu, of which the setting of Data is specified as "pass down". Note: This data type is used to combine a number of forms so that they can be saved as one record. 1.8.10 BOOLEAN Only one of these sets of values are acceptable - "0 or 1", "Y or N" and "T or F". If you input a value other than the above ones, a message will be displayed on the mobile computer to indicate "Data type is wrong!" 1.8.11 LOOKUP No data input is allowed. When data of a previous input field is found matching with the "key field" of a lookup file, data of this input field will be imported from its associated lookup field. By default, the imported data will not be saved in the transaction record. In section 1.14 More as shown below, you may select Save field data. Note: The lookup value is imported for reference. No change is allowed. 38
Chapter 1 Form 1.8.12 FIXED DATA No data input is allowed. The prompt string will be saved as part of the transaction record. 1.8.13 PROMPT No data input is allowed. The prompt string will not be saved. 1.8.14 PAUSE No data input is allowed. The prompt string will not be saved. However, it will be highlighted constantly on the mobile computer to catch your attention. 1.8.15 COUNTER No data input is allowed. Instead of being displayed on the screen only, now it can be saved with the input data. Normally, the record count starts from 0000000 (7 digits for 8000/8200/8300/8400, but only 5 digits for 8500). However, when a menu appears before the form starts, and you have configured to save the menu caption, the last digit of record count with the field will change from 0 to 1. You may find the record count in other places: Along with the main menu, the record count will be displayed on the bottom of the screen (next to date and time) on the mobile computer. By default, it is set to display the record count upon completion of data input. Refer to 5.1.1 Data Manipulation for Entry Options. 8000 When the field is set to show counter, the current record count will be saved and displayed in the form in seven digits, starting from 0000000. However, the counter displayed in the main menu is slightly different, as explained below. Record Count Range: 0000 ~ 9999 Record Count Range: 10000 ~ 99999 Record Count Range: >0000 ~ (= 100000 ~) 39
FORGE Batch Application Generator User Guide 8200 When the field is set to show counter, the current record count will be saved and displayed in the form in seven digits, starting from 0000000. The counter displayed in the main menu is as shown. 8300 When the field is set to show counter, the current record count will be saved and displayed in the form in seven digits, starting from 0000000. The counter displayed in the main menu is as shown. 8400 When the field is set to show counter, the current record count will be saved and displayed in the form in seven digits, starting from 0000000. The counter displayed in the main menu is as shown. 8500 When the field is set to show counter, the current record count will be saved and displayed in the form in five digits, starting from 00000. The counter displayed in the main menu is as shown. 40
Chapter 1 Form 1.8.16 LARGE DATA This data type option is available only when you have selected 2D scan engine for use on the 8200/8400 mobile computer. Refer to 5.1.4 Reader Option. For each form, you can have one field set to read 2D barcode for large data. It allows up to 2048 characters to be collected via the 2D scan engine. By default, the maximum field length is 160 characters, which requires manual adjustment for more and up to 2048 characters. By default, the Read partial barcode setting is enabled and set to read from the start position 1 and maximum length 20. It requires manual adjustment for reading more and up to 160 characters. For reading more than 160 characters, you need to disable the Read partial barcode setting. Refer to 1.14.2 Barcode Input. Note: The Variable/Field setting will become disabled when both of the requirements are met: (1) the maximum field length is over 160 characters, and (2) the Read partial barcode setting is disabled. 1.8.17 READ FROM 2D This data type option is available only when the following requirements are met: (1) you have selected 2D scan engine for use on the 8200/8400 mobile computer, and (2) one of its preceding fields must be set to Large data. For each form, after having set one field to Large data, you can set as many fields to Read from 2D as you need. It allows extracting partial data, up to 160 characters, from the field set to Large data. Refer to 1.14.2 Barcode Input. 41
FORGE Batch Application Generator User Guide 1.9 PROMPT Specify a prompt string for a specific input field, if necessary. Note: Unless data type of a line is "fixed data", a prompt string will not be saved in a transaction record. 1.10 INPUT TYPE Specify from which source data can be collected. Reader Keypad Both RFID All (only applicable to 8300, 8500 Series) (only applicable to 8300, 8500 Series) Upon completion of one input field, it is necessary to press the [Enter] key on the mobile computer. Then, it will move either to the next input field, or to the next form or menu. When the input source is specified to "reader" only, you need to enable "Auto ENTER" for barcode input settings in section 1.14 More. Note: When "RFID" is selected, you may still press the [ESC] or [Enter] key to cancel or confirm a task. The rest keys on the keypad are disabled. 1.11 MINIMUM LENGTH Specify the minimum length of an input field. If the input data is shorter than specified, it will be considered unacceptable. A warning message will be displayed to indicate "Data is too short!" 42
Chapter 1 Form 1.12 MAXIMUM LENGTH Specify the maximum length of an input field. The value can be 80 at most in 8000/8300 and 160 at most in 8200/8400/8500. You can facilitate data input by showing input marks on the screen. In section 1.14 More, select Show input mark. The number of input marks equals to the maximum length specified here. If the input data is longer than specified, it will be considered unacceptable. 1.12.1 INPUT VIA BARCODE/RFID READER For data input from the barcode or RFID reader, a warning message will be displayed when data is too long. 1.12.2 INPUT VIA KEYPAD For data input from the keypad, it will be allowed even though data has become longer than the screen can display. Take the scenario below for example. The screen of the mobile computer allows 20 characters per line for small font. Each prompt string takes 12 characters. Line Input from Keypad Screen Reading Transaction Record #1 12345678 12345678 12345678 1234567890 34567890 1234567890 1234567890ABCDE 3456789E 123456789E #3, 4 1234567890A 123456789A 123456789A #5, 6 1234567890LEMONADE 1234567890LEMOE 1234567890LEMOE #7, 8 1234567890ORANGE_JUICE 1234567890ORANGE_JUICE 1234567890ORANGE_JUICE 43
FORGE Batch Application Generator User Guide 1.13 VARIABLES If there is no lookup file in use, this feature will be Variables. Refer to section 1.4 Lookup (File). 1.13.1 LOOKUP (FIELD) If a lookup file is in use, you need to specify the corresponding lookup field line by line. For each lookup file, there will be a key field. Normally, the "key field" is Field #1. When an input field makes reference to the key field and its input data is found matching, data for its following input fields will be imported from each corresponding lookup fields. For those data types other than integer, real, and auto (+/-), see left below. For data types integer, real, and auto (+/-), see right below. When an arithmetic sign (+, -) is prefixed to the lookup field, the input data will be added or subtracted from the lookup value. Lookup Field for data type other than integer, real, auto (+/-) Lookup Field for data type: integer, real, auto (+/-) 1.13.2 VARIABLES If there is no lookup file in use, it will provide variables, which can be accessed by different forms. For example, Select set v1 for input field #1 of form 1, and its input data will be saved in the first character array. Select get v1 for input field #3 of form 2, and the previous input data will be imported. Select get&set v1 for input field #3 of form 2, the previous input data will be imported and then updated. 44
Chapter 1 Form 1.14 MORE Specify field properties if necessary. 1.14.1 FIELD DATA Fixed Data Length Select the check box. The data length will be fixed to the value specified here. If the input data is longer than specified, it will be truncated and saved to transaction record. When browsing data, the truncated data will be displayed on the screen. If the input data is shorter than specified, "Space" or "0" will be added in front of or to the end of the data based on either "Left" or "Right" alignment. Below are some examples. Fixed data length Alignment Input data Transaction record 4 Left aligned / space 123456789 1234 4 Right aligned / space 123456789 6789 10 Left aligned / 0 7654321 7654321000 10 Right aligned / 0 7654321 0007654321 45
FORGE Batch Application Generator User Guide Initial Value or Text Select the check box. An initial value or text, up to 9 characters, specified here will be shown in the input field. It is to be replaced by input data. For example, it can be used to prompt an initial value for quantity. Add Prefix Code Select the check box to prefix a code to the input data. Click the editing box next to it, and select one or more codes from the Grid Control (ASCII codes). For example, a dollar sign ("$") can be added to the front of the data input for price. Add Suffix Code Select the check box to suffix a code to the input data. Click the editing box next to it, and select one or more codes from the Grid Control (ASCII codes). Instead of using delimiters in section 6.3 Data Field Properties, you may use prefix and/or suffix codes to separate each entry of input data. Note: You may use prefix/suffix code to wrap the input data. Show Input Mark Select the check box to show input marks, such as underline (_) or asterisk (*), which is to be replaced by input data. The number of input marks shown on the screen equals to the maximum length of data specified in section 1.12 Maximum Length. Decimal Places A decimal place is the position of a digit to the right of a decimal point. When the data type is real, you may need to specify its decimal places. By default, it is set variable to accept all real numbers. For example, 4 is selected for decimal places, however, there are only 2 decimal places in the input number, say "8.12". To follow this rule, the system will save the input data as "8.1200". If you try to input a number "8.12345" via the keypad, it will not allow the input of the fifth decimal digit. Only "8.1234" is considered acceptable and saved to file. If the barcode "8.12345" is scanned via the barcode reader, a warning message Incorrect decimal input will be displayed on the mobile computer, and the system will automatically clear the input data and wait for new entry. 1.14.2 BARCODE INPUT Read Partial Barcode By default, it will return the whole barcode that has been decoded. When the check box is selected, it will return partial barcode according to the settings of the start position and maximum length. Below are some examples. Start position Max. length Barcode scanned Transaction record 2 10 9876543210 876543210 2 3 9876543210 876 46
Chapter 1 Form Check Leading Code The leading code refers to the digit in the start position of a barcode. Select the check box to verify the barcode input. When the leading code is not matching, the barcode will be rejected. Below are some examples. Leading code Barcode scanned Transaction record 9 9876543210 9876543210 2 9876543210 (Error: code not matching) Read partial code + Check leading code: Start position Max. length Leading Code Barcode scanned Transaction record 2 7 8 9876543210 8765432 2 7 9 987654321 (Error) Check Digit Verification The check digit refers to the digit in the end of a barcode, as a one-digit derived checksum digit. Select the check box to verify the barcode input. You may apply different modulus 10 or 11 check digit as provided in the drop-down menu. When the check digit is not matching, the barcode will be rejected. Auto ENTER Normally, it is necessary to press the [Enter] key on the mobile computer upon completion of one input field. Then, it will move either to the next input field, or to the next form/menu specified. This function will automatically add a carriage return in front of or to the end of the barcode input. For barcode scanning, it proves to be timesaving when Scan+ENTER is enabled. For a typical application of continuous scanning, it is efficient by making use of ENTER+Scan. 47
FORGE Batch Application Generator User Guide 48
MENU Chapter 2 A menu is a list of selection items. Up to ten different menus can be defined. Below are the settings for each field of a menu. 2 6 7 1 3 4 8 5 IN THIS CHAPTER 2.1 To Select a Menu... 50 2.2 Properties... 50 2.3 Font Size... 50 2.4 Data... 51 2.5 Save Collected Data for Each Form to Separate Data Files 51 2.6 Item Name... 52 2.7 Next... 52 2.8 Reset Current Menu... 52 49
FORGE Batch Application Generator User Guide 2.1 TO SELECT A MENU Select a menu to start with. Usually "Menu 1". Menu 1 ~ 10 2.2 PROPERTIES 2.2.1 MENU CAPTION Select the check box and specify a caption for the current menu if necessary. 2.2.2 ESC Select a form or menu that will be displayed when you press the [ESC] key on the mobile computer. Main Menu Form 1 ~ 10 Menu 1 ~ 10 Note: Normally, the [ESC] key is used to return to a previous form or menu. 2.3 FONT SIZE Large font (8x16) must be applied for double-byte languages, such as Chinese, Japanese, etc. On the Form and Menu property pages, font size needs to be changed accordingly. Refer to Localization and 1.3 Font Size. 50
Chapter 2 Menu 2.4 DATA Specify how to proceed when a menu item has been selected. 2.4.1 SAVE CAPTION Save the menu caption to the transaction record if this menu is running. 2.4.2 SAVE SELECTED ITEM Save the selected menu item to the transaction record if this menu applies. 2.4.3 PASS DOWN If you have selected to save any of the above items, decide whether or not to pass it to the next menu or form. (No menu caption or item saved to the transaction record.) Save caption & pass down Save selected item & pass down Save both & pass down Note: The selected option(s) will be passed down to an associated form or menu. 2.5 SAVE COLLECTED DATA FOR EACH FORM TO SEPARATE DATA FILES When a menu leads to more than one form, you may select the check box to save the data collected from each form to individual files. The check box of "Pass down" for Data will automatically be selected. That is, the menu caption or selected item name will be saved together with separate forms if you have selected the check box for each. 51
FORGE Batch Application Generator User Guide 2.6 ITEM NAME Specify a name for each menu item. It allows up to eight menu items for 8200/8400/8500, and up to ten for 8000/8300. For example, you may specify "1. Goods In" or "Goods In" (see below) in the first field of Item Name. Caption Item Name Note: Whether you have included Item No. in the name field, you can press [1] on the mobile computer to enter the "Goods In" menu. 2.7 NEXT Select a form or menu that will be displayed when a menu item has been selected. Main Menu Form 1 ~ 10 Menu 1 ~ 10 This function can be invoked by performing one of the following actions on the mobile computer - Press the shortcut key (Item No.) of a menu item, e.g. press [2] to select the second menu item. The form or menu you specified here will be displayed then. Press the [Up/Down] arrow keys to select a menu item, and then press [Enter]. 2.8 RESET CURRENT MENU Click this button to load the default settings. Note: The current settings for all menus will be cleared. 52
LOOKUP Chapter 3 A lookup file is a database file created for information reference. Up to three lookup files can be defined. If settings on this property page are specified improperly, it may go wrong when an input field makes reference to its corresponding lookup field. The following settings must be configured: section 1.4 Lookup (File) section 1.8.11 Lookup (Data Type) section 1.13.1 Lookup (Field) If the default settings remain unchanged for the following items in the AG template file that has been downloaded to your mobile computer, 3. Utilities 8. Load Lookup File will be unavailable. section 1.4 Lookup (File) section 3 Lookup 2 5 6 7 1 3 8 4 9 53
FORGE Batch Application Generator User Guide IN THIS CHAPTER 3.1 To Select a Lookup File... 54 3.2 Field Property... 54 3.3 Lookup Data... 56 3.4 Action When the Input Data Has No Match... 57 3.5 Offset... 59 3.6 (Max) Length... 59 3.7 Key Field... 59 3.8 Action When the Format of Record Is Wrong... 60 3.9 Reset Current Lookup File... 62 3.1 TO SELECT A LOOKUP FILE Select a lookup file you want to define its settings. Up to 3 different lookup files can be specified. Usually start with the "1st Lookup File". 3.2 FIELD PROPERTY Specify the data field settings of the database (lookup file). 3.2.1 NUMBER OF FIELDS It must at least cover the referred fields of the database (lookup file). Refer to section 1.13.1 Lookup (Field). 3.2.2 FIXED LENGTH This is the default setting. Proceed to define related settings - Number of fields Offset Length 3.2.3 DELIMITER You may use a delimiter (ASCII code) to separate the data fields. Proceed to define related settings - Number of fields Max. Length If the maximum length of each field is set improperly, you will receive a warning message during downloading. You may fail to download the lookup file, depending on the action specified when the data format is wrong. Refer to the settings of section 3.8 Action When the Format of Record Is Wrong. 54
Chapter 3 Lookup 3.2.4 DBF FILE LOCATION (8200/8400 ONLY) You may specify where to store the DBF files on the mobile computer. The options are as follows: SRAM SD Card Normally, the lookup files are stored in SRAM. The original lookup files (.TXT) will be automatically saved to DBF format when being downloaded to the mobile computer. SD Card option is provided for 8200/8400, allowing files either to be saved to SD card or to SRAM via the card. You must have the lookup files (.TXT) saved to DBF format first. Refer to 7.4 SD DBF Converter (8200/8400 Only). DBF File Location SRAM Download Method (1) Download to 8200/8400 directly (2) Download to 8200/8400 via SD card: Use DBF Converter to copy files to SD card first. SD Use DBF Converter to copy files to SD card. Note: It takes less time to download lookup files to SRAM via SD card than download to SRAM directly. 55
FORGE Batch Application Generator User Guide 3.3 LOOKUP DATA 3.3.1 ONLY READ DATA ONCE Normally, it will compare data of an input field and the key field of the lookup file it refers to for as many times as required. Select the check box to compare data for one time only. Data found matching again Data is accepted for the initial match only. When data is found matching again (i.e. data already exist), the record will be rejected. It will clear the screen automatically by default. For 8000/8200/8300/8400, it can be set to show a warning message before clearing the screen. If so, press any key on the mobile computer to clear the screen. No data found matching If this function is enabled, Insert to lookup file will be automatically set in 3.4 Action When the Input Data Has No Match. When no data is found matching (i.e. new data), the record will be inserted to the lookup file. The action can be changed to Show Warning Message & Insert to show a warning message before inserting the record to the lookup file. 3.3.2 LOOKUP DATA CAN BE UPLOADED This is the default setting. The lookup data can be uploaded from the mobile computer to your computer. On the mobile computer, select 2. Upload Data after you have completed the data collection task and establish a proper connection with the host. Refer to section 1.2.3 Record. 3.3.3 TRIM SPACE WHEN LOOKUP DATA CAN BE UPLOADED When lookup data can be uploaded and a delimiter is used to separate the data fields, you may select the check box to trim space while uploading the lookup file from the mobile computer. 56
Chapter 3 Lookup 3.4 ACTION WHEN THE INPUT DATA HAS NO MATCH Choose the appropriate action to take when the input data does not match that of the key field. 3.4.1 CONTINUE The program will allow data input to proceed without showing any message. Data can only be saved in a data file if you have selected "Save", "Save & update", "Save & output record", "Save & output screen" or Save & remove in section 1.2.3 Record. 3.4.2 SHOW WARNING MESSAGE The program will suspend and a warning message "Data not found!" is displayed on the mobile computer. You will need to clear the input data manually (that is, 9990, in the example below). 3.4.3 INSERT TO LOOKUP FILE The program will allow data input to proceed without showing any message. Data will be inserted to the target lookup file if you have selected "Update lookup", "Save & update", Remove from lookup, or Save & remove in section 1.2.3 Record. 3.4.4 SHOW WARNING MESSAGE & INSERT The program will suspend and a warning message "Data not found!" is displayed on the mobile computer. Then, it will resume to data input. Data will be inserted to the target lookup file if you have selected "Update lookup", "Save & update", Remove from lookup, or Save & remove in section 1.2.3 Record. 3.4.5 CLEAR THE SCREEN The program will automatically clear the input data and wait for new entry. 57
FORGE Batch Application Generator User Guide 3.4.6 SHOW WARNING & CLEAR SCREEN The program will suspend and a warning message "Data not found!" is displayed on the mobile computer. Then, it will automatically clear the input data and wait for new entry. 58
Chapter 3 Lookup 3.5 OFFSET This applies to Fixed Length. Specify the start position for each referred data field. 3.6 (MAX) LENGTH When the field property is set Fixed Length, specify the length for each referred data field. The value can be 255 at most. When the field property is set Delimiter, specify the maximum length for each referred data field. The value can be 255 at most. Note: If a delimiter is used to separate data fields, any improper value would cause wrong data format. 3.7 KEY FIELD The import of data depends on the key field. Select your key field so that an index file can be created for the database (lookup file). When a form makes reference to a lookup file, there must be one input field associated with the key field of the database (lookup file). When its input data is found matching with that of the key field, data of other input fields, if referring to a lookup field, will be imported accordingly. If no matching, see section 3.4 Action When the Input Data Has No Match. Note: If offset and length of each field are specified improperly, it may go wrong with data import. 59
FORGE Batch Application Generator User Guide 3.8 ACTION WHEN THE FORMAT OF RECORD IS WRONG Depending on whether data fields of the lookup file are separated by fixed length or delimiter, options are provided for handling wrong data format when you download the lookup file to the mobile computer. 3.8.1 STOP THE DOWNLOAD PROCESS When wrong data format is encountered, a warning message will be displayed on the mobile computer to indicate which line is found format mismatching. The downloading process is stopped then. You will need to correct the data format, for example, remove an empty record (line) at the end of a file. Then, download the lookup file again. Fixed Length Conditions Record length in source file is greater than that specified in.agx Record length in source file is less than that specified in.agx Action Stop download Stop download Delimiter Conditions Number of fields in source file is greater than that specified in.agx Number of fields in source file is less than that specified in.agx Field length in source file is greater than that specified in.agx Field length in source file is less than that specified in.agx Action Stop download Stop download Stop download Allow download Note Note: That specific field will be padded with additional space. 60
Chapter 3 Lookup 3.8.2 TRUNCATE / REFORMAT THE RECORD When wrong data format is encountered, a warning message will be displayed on the mobile computer to indicate the mismatching part has been fixed, being automatically truncated or reformatted during downloading. For example, the additional fields of a record will be left out. However, you may need to reload the lookup file after the data format has been corrected. Fixed Length Conditions Record length in source file is greater than that specified in.agx Record length in source file is less than that specified in.agx Action Truncate Reformat Note Note: Each field of that specific record will be padded with additional space. Delimiter Conditions Number of fields in source file is greater than that specified in.agx Number of fields in source file is less than that specified in.agx Field length in source file is greater than that specified in.agx Field length in source file is less than that specified in.agx Action Truncate Reformat Note1 Truncate Allow download Note2 Note: (1) It will append additional fields by adding delimiter and space. (2) That specific field will be padded with additional space. 61
FORGE Batch Application Generator User Guide 3.8.3 SKIP THE RECORD When wrong data format is encountered, a warning message will be displayed on the mobile computer to indicate the mismatching part has been discarded. You may need to reload the lookup file after the data format has been corrected. Fixed Length Conditions Record length in source file is greater than that specified in.agx Record length in source file is less than that specified in.agx Action Skip Skip Delimiter Conditions Number of fields in source file is greater than that specified in.agx Number of fields in source file is less than that specified in.agx Field length in source file is greater than that specified in.agx Field length in source file is less than that specified in.agx Action Skip Skip Skip Allow download Note Note: That specific field will be padded with additional space. 3.9 RESET CURRENT LOOKUP FILE Click this button to load the default settings. Note: The settings for the current lookup file will be cleared. 62
SYMBOLOGY Chapter 4 According to the requirements of a specific application, you may enable or disable any of the barcode symbologies and configure the associated parameters. Supported barcodes depend on the scan engine integrated on the mobile computer. 1 4 2 3 IN THIS CHAPTER 4.1 Reader Settings... 63 4.2 Code ID... 64 4.3 Reset... 64 4.4 Barcode & Parameters... 64 4.1 READER SETTINGS Refer to the following appendices for information on barcode reader settings Appendix II - CCD/Laser Scan Engine for details. Appendix III - LR/ELR Laser Scan Engine for details. Appendix IV - 2D Scan Engine for details. 63
FORGE Batch Application Generator User Guide 4.2 CODE ID If this function is enabled, specify Code ID for a listed barcode. The Code ID will be prefixed to the decoding result of a barcode. Click the editing box next to the barcode, and select one code from the Grid Control (ASCII codes). Alternatively, you may select Set 1 ~ 5. Note: Code ID settings for GS1 Databar-14/Expanded, GS1 Databar Limited, and GS1-128 are provided in section 4.4 Barcode & Parameters. 4.3 RESET Click [Reset] to load the default settings. This applies to the following - section 4.1 Reader Settings section 4.4 Barcode & Parameters Note: The current settings will be cleared. 4.4 BARCODE & PARAMETERS Refer to the following appendices for information on symbology settings Appendix II - CCD/Laser Scan Engine for details. Appendix III - LR/ELR Laser Scan Engine for details. Appendix IV - 2D Scan Engine for details. 64
SETTINGS Chapter 5 On this property page, basic settings for the application program can be changed. 1 2 3 IN THIS CHAPTER 5.1 Initial Settings... 66 5.2 Function Key Setting... 74 5.3 Security Setting... 75 65
FORGE Batch Application Generator User Guide 5.1 INITIAL SETTINGS Settings Default Value Remarks Data Deletion Manual Entry Options Show count Stay on the LCD for 600 ms Key Click Tone 2 Backlight Warning Beep Good Read Beep Vibrator Duration Turn off Two beeps One beep Off available on the mobile Buzzer Volume LARGE_VOL Only for 8200/8400 Reader Option CCD/Laser Upload Method Cradle-IR Note Bluetooth SPP is not Download Method Cradle-IR Note computer unless selected for downloading to 8061, 8360. Baud Rate & Modem Speed 115200 bps Note: For 8200/8400, the default upload/download port is RS-232. 5.1.1 DATA MANIPULATION Data Deletion Decide whether to delete data after uploading to the host. By default, it is set to Manual, which means you have to decide whether or not to delete data upon completion of upload. If you decide not to delete data, you can always select 3. Utilities 3. Delete Data to delete at a later time. You may select Automatic to automatically delete data upon completion of upload. If so, the uploaded data will not be available any more when you select the following submenus - 2. Upload Data 3. Utilities 2. Browse Data If neither of the above two options are desired, select No to skip data deletion upon completion of upload. The data file(s) and lookup file(s) will be kept on the mobile computer after uploading to the host. However, you can always select 3. Utilities 3. Delete Data to delete at a later time. Entry Options You may specify whether or not to display more information, either the record count (Show count) or the record preview (Show record), before proceeding to the next entry. By default, the record count will be displayed on the mobile computer screen for 600 milliseconds as soon as an entry is completed. Refer to 1.8.15 Counter. When selecting "Show count" or "Show record", you will need to specify how long it will be displayed on the screen. Time-out is specified in the range of 1~99, in units of 100 milliseconds. 66
Chapter 5 Settings 5.1.2 KEYPAD & LCD Key Click By default, "Tone 2" is used for the key click. You may select a desired tone or mute it. Backlight By default, the backlight for the LCD and the keypad of the mobile computer is turned off. When the backlight is turned on, you may specify a period of idle time so that it can be automatically turned off. Such time-out is specified in the range of 1~9, in units of 10 seconds. The default time-out is 20 seconds. 5.1.3 NOTIFICATION Warning Beep You may specify whether or not to have a warning beep when a specific event takes place. By default, it will produce two beeps to warn you of a specific event. Good Read Beep You may specify whether or not to have a beep when decoding of a barcode is done successfully. By default, it will produce one beep to inform you of a successful reading. Vibration Duration This is available in 8200/8300/8400/8500 program only. You may specify whether or not to turn on the vibrator to warn you of a specific event. By default, the vibrator is turned off. You may turn it on for a preset period of time. Buzzer Volume This is available in 8200/8400 program only. You may change the buzzer volume. 67
FORGE Batch Application Generator User Guide 5.1.4 READER OPTION Refer to Appendix I - Scan Engine Settings for information on barcode reader and RFID reader. Reader Type (for barcode scan engine) Select a reader type that matches the hardware configuration of your mobile computer. The associated barcode parameters will be displayed accordingly. If there is a More button next to the barcode symbology listed, advanced settings are available. Note: In order to initialize the barcode reader, you must select the correct reader type when you first configure a template. Otherwise, a message will be displayed on the mobile computer to indicate "Wrong reader type!" after you download the template file. Set RFID The RFID reader is automatically enabled after initialization. Advanced settings are provided as shown below. RFID tags in proximity will be read automatically by 8300/8500 when RFID reader is enabled. You may limit the 1.10 Input Type options in Form to prevent from misreading RFID data. Read UID By default, the RFID reader is set to read UID (Unique Identification). Read Data Select the check box so that RFID data can be read. If only partial data is required, specify the start position and maximum length. User Delimiter Select the check box and specify a delimiter to separate UID from data. 68
Chapter 5 Settings 5.1.5 UPLOAD METHOD Select a communication interface used on the mobile computer to upload data file(s) or lookup file(s) to your computer. Refer to 7.2.1 Data_Read for auto upload settings. Upload Interface AG8000 AG8200 AG8300 Remarks Normally, the interface options on the mobile computer are Cradle-IR IrDA Modem Ethernet Cradle However, if you download Batch AG runtime to 8061, Bluetooth SPP must be selected for initial settings, and it will replace Modem above; otherwise, this option will become unavailable on the mobile computer 3. Utilities 1. Settings 1. Upload Port 3. Utilities 1. Settings 2. Download Port Because the 8200 Series comes with Bluetooth integrated, the interface options on the mobile computer are RS232 Bluetooth SPP USB VCOM USB VCOM_CDC Modem Ethernet Cradle USB HID SD Card Note Normally, the interface options on the mobile computer are Direct RS-232 Cradle-IR IrDA Keyboard Wedge Note Ethernet Cradle Modem However, if you download Batch AG runtime to 8360, Serial-SPP (=Bluetooth SPP) must be selected for initial settings, and it will replace Modem above; otherwise, this option will become unavailable on the mobile computer 3. Utilities 1. Program Settings 1. Upload Interface 3. Utilities 1. Program Settings 2. Download Interface Note: Keyboard Wedge option is provided with the 8300 Series mobile computers, and therefore, the settings are available in AG8300 program only. 69
FORGE Batch Application Generator User Guide Upload Interface AG8400 AG8500 Remarks Because the 8400 Series comes with Bluetooth integrated, the interface options on the mobile computer are RS232 Bluetooth SPP USB VCOM Modem Ethernet Cradle USB HID SD Card Note Because the 8500 Series comes with Bluetooth integrated, the interface options on the mobile computer are Cradle-IR IrDA Modem Ethernet Cradle Bluetooth SPP Note: SD Card option is provided for 8200/8400 to upload DAT files and DBF files to SD card. The files will be saved to the default working directory \AG\EXPORT, which will be created on SD card automatically. 70
Chapter 5 Settings 5.1.6 DOWNLOAD METHOD Select a communication interface used on the mobile computer to download the application template or lookup file(s) from your computer. Download Interface AG8000 AG8200 AG8300 AG8400 Remarks Normally, the interface options on the mobile computer are Cradle-IR IrDA Modem However, if you download Batch AG runtime to 8061, Bluetooth SPP must be selected for initial settings, and it will replace Modem above; otherwise, this option will become unavailable on the mobile computer 3. Utilities 1. Settings 1. Upload Port 3. Utilities 1. Settings 2. Download Port Because the 8200 Series comes with Bluetooth integrated, the interface options on the mobile computer are RS232 Bluetooth SPP USB VCOM USB VCOM_CDC Modem SD Card Normally, the interface options on the mobile computer are Direct RS-232 Cradle-IR IrDA Modem However, if you download Batch AG runtime to 8360, Bluetooth SPP must be selected for initial settings, and it will replace Modem above; otherwise, this option will become unavailable on the mobile computer 3. Utilities 1. Program Settings 1. Upload Interface 3. Utilities 1. Program Settings 2. Download Interface Because the 8400 Series comes with Bluetooth integrated, the interface options on the mobile computer are RS232 Bluetooth SPP USB VCOM Modem SD Card 71
FORGE Batch Application Generator User Guide AG8500 Because the 8500 Series comes with Bluetooth integrated, the interface options on the mobile computer are Cradle-IR IrDA Modem Bluetooth SPP Note: SD Card option is provided for 8200/8400 to download template file (.AGX) and lookup files from SD card. The default working directories are \AG\IMPORT for template file and \AG\DBF for lookup files, which will be created on SD card automatically. It allows setting different download interface for each file type. Before you download the lookup files, you must use the DBF converter tool to convert text files (.TXT) to DBF format (.DB0). It will automatically copy these files to the import directory \AG\DBF on either SD card or SRAM. 72
Chapter 5 Settings 5.1.7 BAUD RATE & MODEM SPEED Baud Rate By default, the baud rate setting is 115200 bps for communications via any interface other than Modem. Modem Speed Only when Modem is selected for upload or download interface, this option will become available. For 8000/8300/8500, it depends on the IR control board of the modem cradle, which is set to 57600 bps by default. If you select any value other than 57600 bps, you need to adjust the DIP switch of the control board accordingly. For 8200/8400, the modem cradle is capable of detecting baud rate. Note: For the 8000/8300 Series, the version of IR control board on the modem cradle must be greater than SV3.01. 5.1.8 RESET SETTINGS Click this button to load the default settings. This applies to the following - section 5.1 Initial Setting section 5.2 Function Key Setting section 5.3 Security Setting Note: The current settings will be cleared. 73
FORGE Batch Application Generator User Guide 5.2 FUNCTION KEY SETTING You may enable the function keys and define the mapping. That is, specify which task will be invoked when you press a key combination. By default, no function keys have been defined. Note: For 8400, key combination FN+9 on 29-key requires pressing the orange modifier key and the - key. 74
Chapter 5 Settings 5.3 SECURITY SETTING 5.3.1 SECURITY CHECKING For security concerns, you may specify a password and select the check box of one or more tasks that need security checking. By default, no password is required for any task. If any task is selected and provided with a password, you will not be allowed to enter a submenu on the mobile computer without the password. A password can be up to 10 alphanumeric characters. Note: The password is case-sensitive. Security Options Settings Edit Data Delete Data Set Date/Time Load Application Load Lookup File Key Click Barcode Good Read Remarks 3. Utilities 1. Program Settings 3. Utilities 2. Browse Data 3. Utilities 3. Delete Data 3. Utilities 5. Set Date/Time 3. Utilities 6. Load Application 3. Utilities 8. Load Lookup File 3. Utilities 1. Program Settings 8. Buzzer 1. Key Click 3. Utilities 1. Program Settings 8. Buzzer 2. Barcode Read MobileLink Setting 3. Utilities 1. Program Settings (2 nd page) 4. MobileLink Setting 75
FORGE Batch Application Generator User Guide WLAN Setting Upload Port Download Application Port Baud Rate Backlight Data Deletion Entry Options Warning Beep Download Lookup Port FTP Setting Security FTP Communication 3. Utilities 1. Program Settings (2 nd page) 2. WLAN Settings 3. Utilities 1. Program Settings 1. Upload Interface 3. Utilities 1. Program Settings 2. DL Program Interface 3. Utilities 1. Program Settings 4. Transmission speed 3. Utilities 1. Program Settings 5. Backlight 3. Utilities 1. Program Settings 6. Set Data Delete 3. Utilities 1. Program Settings 7. Entry Options 3. Utilities 1. Program Settings 8. Buzzer 3. Warning Beep 3. Utilities 1. Program Settings 3. DL Lookup Interface 3. Utilities 1. Program Settings (2 nd page) 1. FTP Settings 3. Utilities 1. Program Settings (2 nd page) 3. Security 4. FTP Note: For 8200/8400, it allows setting different download interface for template file (.AGX) and lookup files separately. 5.3.1 UPLOAD.AGX When using AG program version 1.00.0005 or later to create and download a template file, it may be configured to allow uploading the template file from the mobile computer at a later time. Refer to Upload Application Template. Select the check box to allow uploading.agx file. You are required to specify a password. A password can be up to 5 alphanumeric characters. Note: The password is case-sensitive. 76
STARTUP Chapter 6 On this property page, startup settings for the application program can be customized. Use large font for all prompts is NOT available in AG8200/AG8400/AG8500. 1 3 2 4 6 5 IN THIS CHAPTER 6.1 Application Start From... 77 6.2 Prompt Font Size... 78 6.3 Data Field Properties... 78 6.4 Redefine Prompts & Messages... 79 6.5 Import Prompts & Messages... 79 6.6 Reset Prompts & Messages to Default... 79 6.1 APPLICATION START FROM Decide where the application program starts as soon as 1. Collect data is selected on the mobile computer. Form 1 Menu 1 77
FORGE Batch Application Generator User Guide 6.2 PROMPT FONT SIZE You may select to use large font for all prompts. These two options are available in AG8000 and AG8300 programs only because small font (6x8) is applied by default. Large font (8x16) must be applied for double-byte languages, such as Chinese, Japanese, etc. In that case, select the check box first so that all the prompts and messages will use large font. Refer to section 6.4 Redefine Prompts & Messages. On the Form and Menu property pages, font size needs to be changed accordingly. Refer to Localization. Note: These settings are not available for 8200/8400/8500 Series because it must use large font. 6.3 DATA FIELD PROPERTIES 6.3.1 NUMBER OF DELIMITER The input data will be saved as transaction records. Specify the delimiters used to separate data fields, either in ASCII code or text. It allows using up to two different delimiters. Type the ASCII code for a delimiter and its corresponding character will be shown automatically, and vice versa. 6.3.2 BROWSE DATA FONT SIZE You may select to use large font for data browsing. These two options are available in AG8000 and AG8300 programs only because small font (6x8) is applied by default. Large font (8x16) must be applied for double-byte languages, such as Chinese, Japanese, etc. In that case, select the check box first so that all the prompts and messages will use large font. Refer to section 6.4 Redefine Prompts & Messages. On the Form and Menu property pages, font size needs to be changed accordingly. Refer to Localization. Note: These settings are not available for 8200/8400/8500 Series because it must use large font. 6.3.3 DAT FILE LOCATION You may specify the location to store the DAT files. The options are as follows: SRAM SD Card 78
Chapter 6 Startup 6.4 REDEFINE PROMPTS & MESSAGES For non-english environment, all the prompts and messages need to be re-defined in your local language. In addition, the appropriate font file has to be downloaded to the mobile computer so that it can display the prompts and messages correctly. Refer to Localization. 6.5 IMPORT PROMPTS & MESSAGES If the prompts and messages have already been re-defined with an existing template file, simply import the template file. 6.6 RESET PROMPTS & MESSAGES TO DEFAULT Click this button to load the default prompts and messages settings. Note: The current settings will be cleared. 79
FORGE Batch Application Generator User Guide 80
UTILITIES Chapter 7 These utilities are available in the Tools menu inside the 8 Series Batch AG program, or can be accessed via Start All Programs CipherLab Forge Batch Utilities. For experienced programmers to issue a command or run a script, refer to Appendix V Command Line Syntax. Shortcut Name of Utility Program Name Usage AG_Load AG_Load.exe To download the current application template to the mobile computer. DLookup DLookup.exe To download associated lookup file(s) to the mobile computer Prog_Load ProgLoad.exe To download the AG runtime or font file (.SHX) to the mobile computer. Data_Read Data_Read.exe To receive data via Data_Read utility. It also synchronizes date/time on every host connection. AGX_Read AGX_Read.exe To upload the current application template from the mobile computer. MobileLink MobileLink.exe To receive data from the mobile computer via Mobile Link utility. DBF_Converter DBF_Converter.exe To convert text file into DBF file. Simulator Simulator.exe To launch the simulator. IN THIS CHAPTER 7.1 Download Utilities... 82 7.2 Upload Utilities... 90 7.3 Mobile Link... 96 7.4 SD DBF Converter...119 7.5 Program Simulation...121 81
FORGE Batch Application Generator User Guide 7.1 DOWNLOAD UTILITIES 7.1.1 AG LOAD Without the need to run the Batch or WLAN Application Generator programs, you can use AG_Load.exe to download a template file to your mobile computer. 1 2 3 4 82
Chapter 7 Utilities Run AG_Load.exe 1. In the File Type box, select the file type of the target AG template file. File Type Description The AGX format is used by the template file of Forge AG program (Batch) for 8000/8200/8300/8400/8500 Series Mobile Computers. The ATX format is used by the template file of Batch AG program AG711*.exe for 711 Mobile Computer. The ATF format is used by the template file of WLAN AG programs for 8000/8200/8300/8400/8500 Series Mobile computers. 2. In the File name box, type the file path where the AG template file is located. Otherwise, click Browse to locate the AG template file you want to download. Click Open in the dialog box as shown below. 83
FORGE Batch Application Generator User Guide 3. In the Download via box, select the download interface. Download via Description RS-232/IrDA/USB VCOM is available on 711/8000/8200/8300/8400/ 8500 Series Mobile Computers. Proceed to configure COM port (1~255) and baud rate settings. Cradle-IR interface is available on 711/8000/8300/8500 Series Mobile Computers. Cradles or IR-Transceivers are required. Proceed to configure COM port (1~255) and baud rate settings. Modem interface is available on 8000/8200/8300/8400/8500 Series Mobile Computers. Modem Cradles are required. Proceed to configure modem if necessary. 4. Click OK to start the download process. 84
Chapter 7 Utilities 7.1.2 DLOOKUP Without the need to run the Batch Application Generator programs, you can use DLookup.exe to download a lookup file to your mobile computer. 1 2 3 Note: (1) For 8200/8400, USB Virtual COM shares the interface option of RS-232/IrDA. (2) Cradle-IR is not supported on 8200/8400. 85
FORGE Batch Application Generator User Guide Run DLookup.exe 1. In the File name box, type the file path where the lookup file is located. Otherwise, click Browse to locate the lookup file you want to download. Click Open in the dialog box as shown below. 2. In the Download via box, select the download interface. Download via Description RS-232 or IrDA interface is available on 711/8000/8200/8300/8400/ 8500 Series Mobile Computers. Proceed to configure COM port (1~255) and baud rate settings. Cradle-IR interface is available on 711/8000/8300/8500 Series Mobile Computers. Cradles or IR-Transceivers are required. Proceed to configure COM port (1~255) and baud rate settings. Modem interface is available on 8000/8200/8300/8400/8500 Series Mobile Computers. Modem Cradles are required. Proceed to configure modem if necessary. 86
Chapter 7 Utilities 3. Click OK to start the download process. 87
FORGE Batch Application Generator User Guide 7.1.3 PROGLOAD Without the need to run the Batch or WLAN Application Generator programs, you can use ProgLoad.exe to download a program (*.SHX, *.SYN or *.BIN) to your mobile computer. 1 2 3 Note: (1) For 8200/8400, USB Virtual COM shares the interface option of RS-232/IrDA. (2) Cradle-IR is not supported on 8200/8400. 88
Chapter 7 Utilities Run ProgLoad.exe 1. In the Comm type box, select the download interface. Comm Type RS-232/IrDA Cradle-IR TCP/IP Description Connection via direct RS-232 cable, IrDA port, or Bluetooth SPP Connection via cradle Connection over networks 2. In the File type box, type the file path where the program file is located. Otherwise, click Browse to locate the program file you want to download. Click Open in the dialog box as shown below. File Type.SHX file.syn file.bin file Description 3. Click OK to start the download process. Any C program, such as AG Runtime, BASIC Runtime, font file, etc. Any BASIC program after BASIC Runtime has been installed first. Any C program Use PC utility SHX2Bin.exe to convert the program (.shx.bin). 89
FORGE Batch Application Generator User Guide 7.2 UPLOAD UTILITIES 7.2.1 DATA_READ Without the need to run the Batch Application Generator program, you can use Data_Read.exe to receive the data file(s) uploaded from your mobile computer. However, if you want to upload data files over the network via Ethernet Cradles, use Mobile Link instead. It supports automatically uploading data to a host computer when the upload interface is properly configured Cradle-IR, RS-232 or USB VCOM. Once the mobile computer is seated in the cradle or connected via the RS-232 or USB Virtual COM cable, there will be a running dot or hourglass icon displayed on the upper-right corner of the screen, indicating the mobile computer is ready for auto upload. Please make sure the interface on the mobile computer is matching! Auto Upload Support 8000 8200 8300 8400 8500 Interface Required Cradle-IR RS-232 Cradle-IR RS-232 Cradle-IR USB VCOM RS-232 USB VCOM 1 3 2 4 5 90
Chapter 7 Utilities Run Data_Read.exe 1. Under Properties, you may decide whether to display data via keyboard emulation or save data to file. Display data via keyboard emulation: Data is emulated as typed text and sent to the active window. Open a text editor for receiving data. In the Inter-character delay box under Communication Parameters, type or select a value that matches the computer response time of the keyboard interface. Such delay time is inserted between every character being transmitted. The longer the delay time is, the slower the transmission speed will be. Save data to file: Select Save mode and related settings, such as file name rule. Data will be saved to a text file (.txt). Click the [Convert text file to Excel format] button to configure settings for converting the received data into an Excel file, if necessary. Save Mode Overwrite Append Description Overwrite: If the file name you give is the same as of an existing file, the uploaded data will overwrite the original data. Otherwise, it will create a new file. Append: If the file name you give is the same as of an existing file, the uploaded data will be appended to the original data. Otherwise, it will create a new file. To append data to file automatically, the best practice requires specifying reasonable polling time with Keep online for receiving data automatically enabled. File Name Rule Generated automatically Generated according to the first record Customized Description 2. Under Options, select appropriate settings. The uploaded data will be saved to the specified directory with a file name that is automatically generated based on the system date and time. The best practice requires specifying reasonable polling time with Keep online for receiving data automatically enabled. The received data will be saved to a file named by its first record. For example, in Batch Application Generator you may design Form 1 to allow only one line for a specific file name and proceed to other forms for collecting data. Thus, the first record will be used to keep its file name. Depending on Save mode, if the file name you give is the same as of an existing file, the uploaded data will overwrite or append to the original data. If you select to customize own rule, type the file path where the data file will be saved to. Otherwise, click Browse to select which directory the data file is saved to. 91
FORGE Batch Application Generator User Guide 3. In the Interface box under Communication Parameters, select the upload interface. Interface Description RS-232/IrDA/USB VCOM is available on 711/8000/8200/8300/8400/ 8500 Series Mobile Computers. Proceed to configure COM port (1~255) and baud rate settings. Cradle-IR interface is available on 711/8000/8300/8500 Series Mobile Computers. Cradles or IR-Transceivers are required. Proceed to configure COM port (1~255) and baud rate settings. Modem interface is available on 8000/8200/8300/8400/8500 Series Mobile Computers. Modem Cradles are required. Select Modem-TAPI when using TAPI-compliant communication application on the host computer. Proceed to configure modem if necessary. Modem interface is available on 8000/8200/8300/8400/8500 Series Mobile Computers. Modem Cradles are required. Select Modem-COM when using COM port based modem, and proceed to configure COM port and baud rate settings. 92
Chapter 7 Utilities 4. Select whether to delete the data file, as well as lookup files, upon completion of auto upload. 5. Click OK to start the upload process. 93
FORGE Batch Application Generator User Guide 7.2.2 AGX_READ When using the Forge AG program version 1.00.0005 or later to create and download a template file, it may be configured to allow uploading the template file from the mobile computer at a later time. Without the need to run the Batch Application Generator programs, you can use AGX_Read.exe to receive a template file (*.AGX) from your mobile computer. 1 2 3 4 Note: Cradle-IR is not supported on 8200/8400. 94
Chapter 7 Utilities Run AGX_Read.exe 1. In the Directory box, type the file path where the.agx file is to be saved. Otherwise, click to locate where to save the file. You may change the file name as well 2. In the Password box, enter the correct password for access to the template file. 3. In the Interface box, select the upload interface. Comm Type RS-232/IrDA/USB VCOM Cradle-IR Description Connection via direct RS-232 cable, IrDA port, or USB Virtual COM Connection via cradle 4. Click OK to start the download process 95
FORGE Batch Application Generator User Guide 7.3 MOBILE LINK By default, it is set to automatically start the link service upon execution of Mobile Link. Once data transfer occurs, you can view the link status and file status respectively as shown below. Menu Bar Toolbar 7.3.1 PREREQUISITES You must have configured your Ethernet Cradle to work in Data Mode and connect to the host computer with correct host IP and port number. You must have selected Ethernet Cradle as the upload interface for the mobile computer. In MobileLink settings via the AG program, you must have data transfer enabled. When Auto Update is enabled on the mobile computer or via the AG program, it will automatically start to upload or download data over the network. Refer to Using MobileLink to Transfer Files over Network. Depending on the lookup file settings in System Rule Maintenance, you may download lookup files as well. Note: On the System menu, click Link Properties, and then change the Auto Start Link Service setting if you want to manually start the link service. 96
Chapter 7 Utilities 7.3.2 MENU BAR & TOOLBAR File Menu Open Open a selected data file. Save As Save a selected data file to a different file path. Rename Rename a selected data file. Delete File Delete a selected data file. Remove from List Remove a selected data file from the file list. Convert Convert a selected data file to Excel file format. Exit Close the Mobile Link program. Link Menu Start Start the link service. Restart Stop Re-start the link service. Stop the link service. Information Menu Device Information Get system information about a specific mobile computer. System Menu Link Properties Configure link properties. File Properties Configure file properties. Help Menu About Mobile Link View information about the Mobile Link program. 97
FORGE Batch Application Generator User Guide 7.3.3 VIEW LINK STATUS 1) Connect your Ethernet Cradle to the host computer over the network. In Mobile Link, click Links on the left pane of the work area and the IP and MAC address of Ethernet Cradle will be displayed on the right pane. Note: You must have configured your Ethernet Cradle to connect to the host computer with correct host IP and port number. 2) Seat the mobile computer into your Ethernet Cradle, and start with uploading data. For 8000/8200/8300/8400, it will automatically start uploading. For 8500, it requires selecting Upload Data from the main menu on the mobile computer. 3) In Mobile Link, more information about the connection will be displayed on the right pane. The connection details include: Ethernet Cradle IP Ethernet Cradle MAC Address Terminal Serial Number (= the mobile computer) Terminal Type (= the mobile computer) Connect Time (start time) Elapse (time elapsed upon completion of receiving data) Note: You must select Ethernet for the upload interface on the mobile computer. 98
Chapter 7 Utilities 4) Except for Ethernet Cradle IP and MAC address, the rest information will be cleared upon completion of uploading data. 99
FORGE Batch Application Generator User Guide 7.3.4 VIEW RECEIVED FILES 1) In Mobile Link, click Files on the left pane of the work area and the received file or files will be displayed on the right pane. Note: You must have configured your Ethernet Cradle to connect to the host computer with correct host IP and port number. 2) Click a file from the file list, and choose a command from the File menu: On the File menu, click Open to open the selected data file. On the File menu, click Save As to save the selected data file to a different file path. 100
Chapter 7 Utilities On the File menu, click Rename to rename the selected data file. On the File menu, click Delete File to delete the selected data file. On the File menu, click Remove from List to remove the selected data file from the file list. 101
FORGE Batch Application Generator User Guide On the File menu, click Convert to convert the selected data file to Excel file format. 102
Chapter 7 Utilities 7.3.5 VIEW DEVICE INFORMATION In Mobile Link, you can also view the device information while a mobile computer is uploading data. 1) Click an entry from the link list that provides detailed information on each of the current connections. 2) On the Information menu, click Device Information to view system information of a specific mobile computer, such as: Serial Number (on the title of the dialog box) Manufacture Date Library Version Kernel Version Font Version Program Version Device Type 103
FORGE Batch Application Generator User Guide 7.3.6 CHANGE CONNECTION SETTINGS You must have configured your Ethernet Cradle to connect to the host computer with correct host IP and port number. On the System menu, click Link Properties to change the following settings: Link Port: The port number is 2000 by default. You may change it in Mobile Link, as well as on your Ethernet Cradle. Maximum Links: It allows up to 25 mobile computers to upload data by default. You may change the number to meet your needs. Refresh Link Information: Type or select an appropriate period of time for Mobile Link to refresh the link status, in units of second. Attempt to resume connection when disconnection is detected: Type or select how many times Mobile Link will try to resume connection. Auto Start Link Service: By default, it is set to automatically start the link service upon execution of Mobile Link. You may disable it if necessary. 104
Chapter 7 Utilities 7.3.7 CHANGE DATA FILE SETTINGS On the System menu, click File Properties to change the following settings: File Path By default, the received data files will be saved in the same folder where the Mobile Link program is saved. Type the file path where the data files will be saved. 105
FORGE Batch Application Generator User Guide File Name By default, all the data files will be merged and saved to one file by automatically giving it a file name made up of two elements 4 and 5. Such file name will result in a file name based on the time and date when data is received on the host. For example, using file name format 1 and 4 will result in a file name based on the following information: (1) from which Ethernet Cradle IP the data comes, and (2) the date when it is received. You may specify the format of the file name by selecting more than one element from the six options listed above. In the User Specify box, type the file name you want to use. Select a combination of the listed ones to make a proper file name. You may specify to save each data file separately. Corresponding to each of the forms in Batch AG, it will automatically add a suffix to the specified file name: -01 ~ -10 Data files are saved as.txt files. Lookup files are saved as.lku files. Save Mode If the file name is the same as of an existing file, the uploaded data will either overwrite or be appended to the original data. Otherwise, it will create a new file. Add Return character to each record. By default, it will add Return character to each record. However, you may change it if necessary. Add Line-Feed character to each record. By default, it will add Line-Feed character to each record. However, you may change it if necessary. Log File Select the check box of Enable Log File in case you need to analyse the activities during data transmission. File Path Save Mode By default, the log files will be saved in the same folder where the Mobile Link program is saved. Type the file path where the log files will be saved. If the file name is the same as of an existing file, the log file will either overwrite or be appended to the original file. Otherwise, it will create a new file. 106
Chapter 7 Utilities 7.3.8 MANAGE DEVICES On the System menu, click Device Maintenance to manage devices by adding them to the Device List. You may group the devices if necessary. 107
FORGE Batch Application Generator User Guide New Group Create a group by specifying Group ID. You may specify Group Name as well. Upon completion, it will be displayed in the drop-down menu of Group ID listing. The maximum length of Group ID/Group Name is 250 characters each. Delete Group Remove a selected group from the drop-down menu of Group ID listing. Modify Group Assign devices to a selected group or modify its Group Name. Select devices from the Device List and click Select devices from the group and click to move them to the group. to move them to the Device List. Click Click to move all the devices from the Device List to the group. to move all the devices from the group to the Device List. Note: You may use the SHIFT key to select a range of items and/or the CTRL key to select or clear individual items. Add Device Add devices individually or by specifying a range of serial numbers. The serial numbers you entered will be added to the Device List. The maximum length of serial number is 12 characters. Delete Device Delete any selected devices from the Device List. 108
Chapter 7 Utilities 1) Click Add Device on the lower-left corner to add devices by serial number. The serial numbers you entered will be added to the Device List on the left. 109
FORGE Batch Application Generator User Guide 2) Click New Group to create a group by specifying Group ID. You may specify its Group Name as well. Upon completion, it will be displayed in the drop-down menu of Group ID listing. 110
Chapter 7 Utilities 3) Click Modify Group on the upper-right corner to assign devices to a selected group. You may modify its Group Name if necessary. 111
FORGE Batch Application Generator User Guide 4) Click Apply to confirm the assignment. 112
Chapter 7 Utilities 7.3.9 MANAGE YOUR RULES On the System menu, click Rule Maintenance to manage rules applied to devices, either individually or by group. 113
FORGE Batch Application Generator User Guide General Rule This is the system rule, which cannot be deleted but modification is allowed by clicking Modify Rule. Rule ID cannot be changed. The maximum length of Rule Name is 250 characters. When you select to apply general rule to devices that have not been assigned any rule(s), you may define the rule in the following aspects: (1) Time synchronization, to synchronize device time with the host, and (2) Send lookup files to device, to allow downloading newer lookup files to devices. If the current lookup files on the mobile computer were not downloaded through Mobile Link, they are considered outdated and will be replaced with files on the host. New Rule Create a rule by specifying Rule ID. You may specify Rule Name as well. Upon completion, it will be displayed in the drop-down menu of Rule ID listing. The maximum length of Rule ID/Rule Name is 250 characters each. Define the rule in the following aspects: (1) Time synchronization, to synchronize device time with the host, and (2) Send lookup files to device, to allow downloading newer lookup files to devices. If the current lookup files on the mobile computer were not downloaded through Mobile Link, they are considered outdated and will be replaced with files on the host. Select devices/groups from the left and click See Modify Rule below. to move to the right for applying the rule. Delete Rule Remove a selected rule from the drop-down menu of Rule ID listing. Modify Rule Make changes to the rule. Select devices/groups from the left and click Select devices/groups from the right and click not be applied to them. to move to the right for applying the rule. to move to the left so that the rule will Click Click be applied. to move all the devices/groups from the left to the right for applying the rule. to move all the devices/groups from the right to the left so that the rule will not Note: You may use the SHIFT key to select a range of items and/or the CTRL key to select or clear individual items. 114
Chapter 7 Utilities 1) Click Modify Rule on the upper-right corner to edit the General Rule. When you select to apply general rule to devices that have not been assigned any rule(s), define the rule in the following aspects: (1) Time synchronization that will synchronize device time with the host, and (2) Send lookup files that will allow downloading newer lookup files to devices. 115
FORGE Batch Application Generator User Guide 2) Click New Rule to create a rule by specifying Rule ID. You may specify its Rule Name as well. 116
Chapter 7 Utilities Define the rule in the following aspects: (1) Time synchronization that will synchronize device time with the host, and (2) Send lookup files that will allow downloading newer lookup files to devices. Select devices or groups for applying the rule. 117
FORGE Batch Application Generator User Guide 3) Click Apply. Upon completion, this rule will be displayed in the drop-down menu of Rule ID listing. 118
Chapter 7 Utilities 7.4 SD DBF CONVERTER (8200/8400 ONLY) For 8200/8400, it allows downloading template file (.AGX) and lookup files via SD card. Before you download the lookup files, you must convert text files (.TXT) to DBF format (.DB0,.DB1). The result files will be copied to the directory automatically when the Distribute setting is enabled. Note: The default working directory is \AG\DBF, which will be created on SD card automatically. 1 2 3 4 5 1) For the source lookup file, select a text file (.TXT). 2) For the lookup properties, specify from scratch or select a template file (.AGX) and the target lookup file. For the latter, the properties will be loaded automatically. 3) For the output DBF file, make sure to select the check box of [Convert] and [Distribute]. Specify a file name or select an existing DBF file to save the result files on PC side. 4) On 8200/8400, select 3. Utilities 8. Load Lookup File and identify the lookup file. 119
FORGE Batch Application Generator User Guide Note: The download interface must be set to SD. Refer to 5.1.6 Download Method. 5) Click [Go]. It will convert the source file to DBF format and save the result files on PC side. If you have selected the check box of [Distribute], it will automatically copy the result files to the import directory \AG\DBF on SD card. 6) On 8200/8400, press [Enter] to confirm copying files to SD card and checking DBF format. Depending on the DBF location specified in the template file, it will either (1) load the associated lookup file(s) to SRAM via SD card, or (2) keep the files on SD card for direct access. Refer to 3.2.4 DBF File Location (8200/8400 Only). Note: It is suggested to check DBF format upon completion of downloading lookup files. 120
Chapter 7 Utilities 7.5 PROGRAM SIMULATION When you have completed the entire configuration, you may click Tools Simulator to run program simulation and verify whether these program sequences meet your requirements. Collect Data Main Menu User Menu Form 1 121
FORGE Batch Application Generator User Guide Upload Data No simulation. Refer to section 1.2.3 Record and 3.3.2 Lookup Data Can Be Uploaded. Normally, it will proceed to connect via the selected upload port. Refer to section 5.1.1 Data Manipulation for Data Deletion upon completion of uploading data. Utilities Only partial simulation is allowed. Note: If a lookup file is specified in use on the Lookup property page, 3. Utilities 8. Calculator will be replaced by 3. Utilities 8. Load Lookup File after you have downloaded the template file to the real mobile computer. 122
SCAN ENGINE SETTINGS Appendix I The FORGE Application Generator allows configuring the following reader types, depending on the module equipped on your mobile computer: Barcode Reader 8000 8200 8300 8400 8500 1D CCD Scan Engine 1D Laser Scan Engine 1D Long Range Laser Scan Engine (LR) 1D Extra Long Range Laser Scan Engine (ELR) 2D Scan Engine RFID Reader ACG_RFID Module v0.9 ACG_RFID Module v1.0 Options of different reader combination are allowed, such as 1D+RFID and 2D+RFID. For each combination, both readers can be initialized and ready for scanning at the same time (dual mode operation). For example, if you press the [Scan] button while running the AG run-time program on the mobile computer, it will read a barcode in position or an RFID tag in proximity depending on which one comes first. Note: You cannot have 1D+2D scan engines installed on the mobile computer because they are both barcode readers! 123
FORGE Batch Application Generator User Guide SYMBOLOGIES SUPPORTED Varying by the scan engine installed, the supported symbologies or tag types are listed below. For details on configuring associated settings, please refer to each Appendix separately. CCD, Laser LR, ELR 2D Codabar Code 11 ( ) Note Note: Code 11 supported on LR, ELR scan engine is for 8300 only. Code 93 Composite Code MSI Plessey Postal Codes Telepen Code 128 Code 128 GS1-128 (EAN-128) ISBT 128 Code 2 of 5 Industrial 25 (Discrete 25) Interleaved 25 Matrix 25 ( ) Note Chinese 25 ( ) Note Coop 25 ( ) Note Note: (1) Matrix 25 and Chinese 25 are supported on 2D scan engine for 8200/8400 only. (2) Coop 25 is supported on CCD/Laser scan engine for 8000/8200/8300/8400 only. Code 3 of 9 Code 39 Trioptic Code 39 Italian Pharmacode (Code 32) French Pharmacode EAN/UPC EAN-8 EAN-13 Bookland EAN (ISBN) UPC-E0 UPC-E1 124
Appendix I Scan Engine Settings GS1 DataBar (RSS) UPC-A GS1 DataBar Omnidirectional (RSS-14) GS1 DataBar Truncated GS1 DataBar Stacked GS1 DataBar Stacked Omnidirectional GS1 DataBar Limited (RSS Limited) GS1 DataBar Expanded (RSS Expanded) GS1 DataBar Expanded Stacked 2D Symbologies PDF417 MicroPDF417 Data Matrix Maxicode QR Code MicroQR ( ) Note Aztec ( ) Note Note: MicroQR and Aztec are supported on 2D scan engine for 8200/8400 only. 125
FORGE Batch Application Generator User Guide RFID TAGS SUPPORTED The RFID reader supports read/write operations depending on the tags. The supported labels include ISO 15693, Icode, ISO 14443A, and ISO 14443B. Currently, the performance of some tags has been confirmed, and the results are listed below for your reference. The results found with RFID module version 1.0 are different from those found with version 0.9 or older versions. Note: You should study the specifications of RFID tags before use. The "Write Page" functionality may not be supported. ACG_RFID Module Version 1.0 UID Only Read Page Write Page* ISO 14443A Mifare Standard 1K Mifare Standard 4K Mifare Ultralight Mifare DESFire --- --- Mifare S50 SLE44R35 --- --- SLE66R35 ISO 14443B SRIX 4K SR176 ISO 15693 ICODE SLI SRF55V02P --- --- SRF55V02S --- --- SRF55V10P --- --- TI Tag-it HF-I ICODE (Phillips) ICODE ACG_RFID Module Version 0.9 UID Only Read Page Write Page* ISO 14443A Mifare Standard 1K --- --- Mifare Standard 4K --- --- Mifare DESFire --- --- Mifare S50 --- --- SLE44R35 --- --- SLE66R35 --- --- 126
Appendix I Scan Engine Settings ISO 15693 ICODE SLI SRF55V02P SRF55V02S --- --- SRF55V10P TI Tag-it HF-I ST LRI64 ST LRI512 Tagit Tagit ICODE (Phillips) ICODE 127
FORGE Batch Application Generator User Guide 128
CCD/LASER SCAN ENGINE Appendix II The tables below list reader settings as well as symbology settings for the CCD or Laser scan engine. READER SETTINGS TABLE CCD/Laser Engine Description Default Scan Mode Continuous Mode Test Mode Repeat Mode Momentary Mode Alternate Mode Aiming Mode Laser Mode Auto Off Mode Auto Power Off Mode Laser mode Non-stop scanning To decode the same barcode repeatedly, move away the scan beam and target it at the barcode for each scanning. Non-stop scanning Capable of decoding the same barcode repeatedly Non-stop scanning Capable of re-transmitting barcode data if triggering within one second after a successful decoding Hold down the scan trigger to start with scanning. The scanning won't stop until you release the trigger. Press the scan trigger to start with scanning. The scanning won't stop until you press the trigger again. Press the scan trigger to aim at a barcode. Within one second, press the trigger again to decode the barcode. The scanning won't stop until (a) a barcode is decoded, (b) the pre-set timeout expires, or (c) you release the trigger. Hold down the scan trigger to start with scanning. The scanning won't stop until (a) a barcode is read, (b) the preset timeout expires, or (c) you release the trigger. Press the scan trigger to start with scanning. The scanning won't stop until (a) a barcode is read or (b) the preset timeout expires. Press the scan trigger to start with scanning. The scanning won't stop until the preset timeout expires, and, the preset timeout period re-counts after each successful decoding. 129
FORGE Batch Application Generator User Guide Read Redundancy None None No redundancy means one successful decoding will make the reading valid and induce the "READER Event". One time, Two times, or Three times Time-out The higher the reading security is (that is, the more redundancy the user selects), the slower the reading speed gets. If "Three Times" is selected, it will take a total of four consecutive successful decodings of the same barcode to make the reading valid. 3 sec. 0~255 (second) Set the maximum time for decoding to continue during a scan attempt. It applies to the following scan modes only Aiming mode Laser mode Auto Off mode Auto Power Off mode Aiming Duration 3 sec. 1~255 (second) Set the maximum time for decoding to continue during a scan attempt. It applies to Aiming mode only. Note: Aiming Duration is supported on CCD/Laser scan engine for 8000/8200/8300/8400 only. 130
Appendix II CCD/Laser Scan Engine SYMBOLOGY SETTINGS TABLE CCD/Laser Engine Description Default Codabar Transmit Start/Stop Character Code 128 GS1-128 Transmit Code ID (for GS1-128) Decide whether to include the start/stop characters in the data being transmitted. If "Transmit Start/Stop Characters" is desired, select one set: abcd / abcd abcd / tn*e ABCD / ABCD ABCD / TN*E Decide whether to include Code ID ( ]C1 ) will be included in the data being transmitted. Enable No Enable Enable No Replace Field Separator ISBT 128 Decide whether to replace the field separator. If the barcode contains Field Separator 0x1D, it will be changed to the desired Field Separator. For example, type the desired character ; (semicolon) as the new field separator. Then if the barcode contains Field Separator 0x1D, it will be changed to ;. No Enable Industrial 25 (Discrete 25) Enable Start/Stop Selection This decides the readability of all 2 of 5 symbology variants. For example, flight tickets actually use an Industrial 2 of 5 barcode but with Interleaved 2 of 5 start/stop pattern. In order to read this barcode, the start/stop pattern selection parameter of Industrial 2 of 5 should set to "Interleaved 25". Industrial 25 Verify Check Digit Transmit Check Digit Select Length Interleaved 25 Decide whether to verify the check digit. If the check digit is incorrect, the barcode will not be accepted. Decide whether to include the check digit in the data being transmitted. One or two fixed lengths Range No Yes 1~127 Enable Start/Stop Selection Refer to Industrial 25. Interleaved 25 Verify Check Digit Decide whether to verify the check digit. If the check digit is incorrect, the barcode will not be accepted. No Transmit Check Digit Decide whether to include the check digit in the data being transmitted. Yes 131
FORGE Batch Application Generator User Guide Select Length Matrix 25 One or two fixed lengths Range 1~127 Disable Start/Stop Selection Refer to Industrial 25. Matrix 25 Verify Check Digit Transmit Check Digit Select Length Coop 25 Verify Check Digit Transmit Check Digit Decide whether to verify the check digit. If the check digit is incorrect, the barcode will not be accepted. Decide whether to include the check digit in the data being transmitted. One or two fixed lengths Range Decide whether to verify the check digit. If the check digit is incorrect, the barcode will not be accepted. Decide whether to include the check digit in the data being transmitted. No Yes 1~127 Disable No Yes Note: Coop 25 is supported on CCD/Laser scan engine for 8000/8200/8300/8400 only. French Pharmacode Transmit Check Digit Decide whether to include the check digit in the data being transmitted. Disable Yes Italian Pharmacode (Code 32) Disable Transmit Check Digit Decide whether to include the check digit in the data being transmitted. Yes Note: For French/Italian Pharmacode, Transmit Start/Stop Character is not provided in UI but it is controlled by the same setting of Code 39. Code 39 Transmit Character Start/Stop Decide whether to include the start/stop characters "*" in the data being transmitted. Enable No Verify Check Digit Transmit Check Digit Code 39 Full ASCII Code 93 Decide whether to verify the check digit. If the check digit is incorrect, the barcode will not be accepted. Decide whether to include the check digit in the data being transmitted. Code 39 Full ASCII includes all the alphanumeric and special characters. No Yes No Enable 132
Appendix II CCD/Laser Scan Engine MSI Verify Check Digit Transmit Check Digit Select Length Negative Barcode Plessey Select one of the three calculation formulas to verify the check digit. If the check digit is incorrect, the barcode will not be accepted. Single Modulo 10 Double Modulo 10 Modulo 11 & 10 Decide whether to include the check digit in the data being transmitted. Last digit not transmitted Both digits transmitted Both digits not transmitted One or two fixed lengths Range Disable Single Modulo 10 Both digits transmitted 1~127 Enable Disable Convert to UK Plessey Transmit Check Digit Telepen Original Telepen (Numeric) AIM Telepen (Full ASCII) When applied, each occurrence of the character "A" in the barcode data will be replaced by the character "X". Decide whether to include the two check digits in the data being transmitted. The original Telepen includes numeric characters. AIM Telepen (Full ASCII) includes all the alphanumeric and special characters. No Yes Disable No Yes GS1 Databar-14/Expanded Disable GS1 Databar-14 GS1 Databar Expanded Transmit Code ID Transmit Code ID Decide whether to include Code ID ("]e0") will be included in the data being transmitted. GS1 DataBar-14 is short for GS1 DataBar Omnidirectional. This group consists of (1) GS1 DataBar Omnidirectional, (2) GS1 DataBar Truncated, (3) GS1 DataBar Stacked, and (4) GS1 DataBar Stacked Omnidirectional. Decide whether to include Code ID ("]e0") will be included in the data being transmitted. This group consists of (1) GS1 DataBar Expanded, and (2) GS1 DataBar Expanded Stacked. Yes Transmit Application ID Decide whether to include the Application ID ("01") in the data being transmitted. Yes Transmit Check Digit Decide whether to include the check digit in the data being transmitted. Yes 133
FORGE Batch Application Generator User Guide GS1 Databar Limited Transmit Code ID Transmit Application ID Transmit Check Digit EAN-8 Decide whether to include Code ID ("]e0") will be included in the data being transmitted. Decide whether to include the Application ID ("01") in the data being transmitted. Decide whether to include the check digit in the data being transmitted. Disable Yes Yes Yes Enable Convert to EAN-13 Transmit Check Digit The EAN-8 barcode will be expanded into EAN-13, and the next processing will follow the settings configured for EAN-13. After conversion, the data follows EAN-13 format and is affected by EAN-13 programming selections (e.g. Check Digit). Decide whether to include the check digit in the data being transmitted. No Yes Addon 2 / Addon 5 Decide whether to decode EAN-8 with supplementals. No EAN-13 & UPC-A ISBN Conversion ISSN Conversion GTIN for EAN-13 Transmit Check Digit The EAN-13 barcode starting with 978 and 979 will be converted to ISBN. The EAN-13 barcode starting with 977 will be converted to ISSN. The EAN-13 barcode will be expanded into 14-digit Global Trade Item Number (GTIN). Decide whether to include the check digit in the data being transmitted. Enable No No No Yes Addon 2 / Addon 5 Decide whether to decode EAN-13/UPC-A with supplementals. No (UPC-A) Convert to EAN-13 (UPC-A) Transmit Check Digit The UPC-A barcode will be expanded into EAN-13, and the next processing will follow the settings configured for EAN-13. After conversion, the data follows EAN-13 format and is affected by EAN-13 programming selections (e.g. Check Digit). Decide whether to include the UPC-A check digit in the data being transmitted. Yes Yes (UPC-A) Transmit System Number UPC-E (= UPC-E0) Decide whether to include the UPC-A System Number in the data being transmitted. Yes Enable Convert to UPC-A The UPC-E barcode will be expanded into UPC-A, and the next processing will follow the settings configured for UPC-A. After conversion, the data follows UPC-A format and is affected by UPC-A programming selections (e.g. System Number, Check Digit). No 134
Appendix II CCD/Laser Scan Engine Transmit Check Digit Transmit System Number Decide whether to include the UPC-E check digit in the data being transmitted. Decide whether to include the UPC-E System Number in the data being transmitted. Yes No Addon 2 / Addon 5 Decide whether to decode UPC-E with supplementals. No UPC-E1 UPC-E1 Triple Check Decide whether to apply read redundancy to the UPC-E1 barcode. If true, the same UPC-E1 barcode has to be read three times to make a valid reading. This is helpful when the barcode is defaced and requires more attempts to read it successfully. Disable No 135
FORGE Batch Application Generator User Guide 136
LR/ELR LASER SCAN ENGINE Appendix III The tables below list reader settings as well as symbology settings for the Long Range Laser (LR) or Extra Long Range Laser (ELR) scan engine. READER SETTINGS TABLE LR/ELR Engine Description Default Scan Mode Laser mode Continuous Mode Test Mode Alternate Mode Aiming Mode Laser Mode Auto Off Mode Time-out Non-stop scanning To decode the same barcode repeatedly, move away the scan beam and target it at the barcode for each scanning. Non-stop scanning Capable of decoding the same barcode repeatedly Press the scan trigger to start with scanning. The scanning won't stop until you press the trigger again. Press the scan trigger to aim at a barcode. Within one second, press the trigger again to decode the barcode. The scanning won't stop until (a) a barcode is decoded, (b) the pre-set timeout expires, or (c) you release the trigger. Hold down the scan trigger to start with scanning. The scanning won't stop until (a) a barcode is read, (b) the preset timeout expires, or (c) you release the trigger. Press the scan trigger to start with scanning. The scanning won't stop until (a) a barcode is read or (b) the preset timeout expires. 3 sec. 0~255 (second) Set the maximum time for decoding to continue during a scan attempt. Aiming Duration It applies to the following scan modes only Aiming mode Laser mode Auto Off mode 3 sec. 1~255 (second) Set the maximum time for decoding to continue during a scan attempt. It applies to Aiming mode only. Note: Scan Mode options and Aiming Duration are supported on Long Range Laser scan engine for 8300 only. 137
FORGE Batch Application Generator User Guide SYMBOLOGY SETTINGS TABLE LR/ELR Engine Description Default Codabar Transmit Start/Stop Character Select Length Code 128 GS1-128 Decide whether to include the start/stop characters in the data being transmitted. Any Length One or two fixed lengths Range (1~55) Enable No Any Length Enable Enable Replace Field Separator ISBT 128 Decide whether to replace the field separator. If the barcode contains Field Separator 0x1D, it will be changed to the desired Field Separator. For example, type the desired character ; (semicolon) as the new field separator. Then if the barcode contains Field Separator 0x1D, it will be changed to ;. No Enable Industrial 25 (Discrete 25) Enable Select Length Interleaved 25 Any Length One or two fixed lengths Range (1~55) Any Length Enable Convert to EAN-13 Convert a 14-character barcode into EAN-13 if the following requirements are met: The barcode must have a leading 0 and a valid EAN-13 check digit. No Verify Check Digit Transmit Check Digit Select Length Code 39 Decide whether to verify the check digit. If desired, select one of the algorithms below. If the check digit is incorrect, the barcode will not be accepted. No USS algorithm OPCC algorithm Decide whether to include the check digit in the data being transmitted. Any Length One or two fixed lengths Range (1~55) No No Any Length Enable Convert to Code 32 Convert to Italian Pharmacode. No Verify Check Digit Decide whether to verify the check digit. If the check digit is incorrect, the barcode will not be accepted. No 138
Appendix III LR/ELR Laser Scan Engine Transmit Check Digit Code 39 Full ASCII Decide whether to include the check digit in the data being transmitted. "Verify Check Digit" must be enabled so that the check digit can be left out (= "Transmit Check Digit" disabled). Code 39 Full ASCII includes all the alphanumeric and special characters. No Disable Trioptic Code 39 Decide whether to decode Trioptic Code 39. Trioptic Code 39 is a variant of Code 39 used in the marking of computer tape cartridges. It always contains six characters. Disable Select Length Code 93 Select Length MSI Any Length One or two fixed lengths Range (1~55) Any Length One or two fixed lengths Range (1~55) Any Length Enable Any Length Enable Verify Check Digit If Two Check Digits option is selected, an additional verification is required to ensure integrity. Select one of the algorithms below. If the check digit is incorrect, the barcode will not be accepted. Single Modulo 10 Check Digit Algorithm Transmit Check Digit Select Length GS1 Databar One Check Digit Single Modulo 10 Two Check Digits Mod 10/Mod 11 Mod 10/Mod 10 Decide whether to include the check digit in the data being transmitted. Any Length One or two fixed lengths Range (1~55) No Any Length --- GS1 Databar-14 GS1 Databar Limited GS1 DataBar-14 is short for GS1 DataBar Omnidirectional. This group consists of (1) GS1 DataBar Omnidirectional, (2) GS1 DataBar Truncated, (3) GS1 DataBar Stacked, and (4) GS1 DataBar Stacked Omnidirectional. Enable Enable GS1 Databar Expanded This group consists of (1) GS1 DataBar Expanded, and (2) GS1 DataBar Expanded Stacked. Enable 139
FORGE Batch Application Generator User Guide Convert RSS to UPC/EAN "Convert to UPC/EAN" only applies to GS1 Databar-14 and GS1 Databar Limited barcodes not decoded as part of a Composite barcode. No Convert to EAN-13 Strip the leading "010" from barcodes. "01" is the Application ID and must be followed by a single zero (the first digit encoded) Convert to UPC-A Strip the leading "0100" from barcodes. "01" is the Application ID and must be followed by two or more zeros (but not six zeros) EAN-8 Convert to EAN-13 Addon 2 / Addon 5 EAN-13 Addon 2 / Addon 5 Bookland EAN (= Bookland ISBN-10) UPC-A The EAN-8 barcode will be expanded into EAN-13, and the next processing will follow the settings configured for EAN-13. Refer to UPC/EAN Addon setting. Refer to UPC/EAN Addon setting. The EAN-13 barcode starting with 978 will be converted to ISBN. Data starting with 979 is not considered Bookland in this mode. Enable No Enable No Enable Transmit Check Digit Decide whether to include the UPC-A check digit in the data being transmitted. Yes Transmit Preamble Addon 2 / Addon 5 UPC-E (= UPC-E0) Decide whether to include the UPC-A preamble System Number (and Country Code) in the data being transmitted. Refer to UPC/EAN Addon setting. System Number Enable Transmit Check Digit Decide whether to include the UPC-E0 check digit in the data being transmitted. Yes Transmit Preamble Addon 2 / Addon 5 Convert to UPC-A UPC-E1 Decide whether to include the UPC-E0 preamble System Number (and Country Code) in the data being transmitted. Refer to UPC/EAN Addon setting. The UPC-E0 barcode will be expanded into UPC-A, and the next processing will follow the settings configured for UPC-A. System Number No Disable Transmit Check Digit Decide whether to include the UPC-E1 check digit in the data being transmitted. Yes Transmit Preamble Decide whether to include the UPC-E1 preamble System Number (and Country Code) in the data being transmitted. System Number 140
Appendix III LR/ELR Laser Scan Engine Addon 2 / Addon 5 Convert to UPC-A Refer to UPC/EAN Addon setting. The UPC-E1 barcode will be expanded into UPC-A, and the next processing will follow the settings configured for UPC-A. No UCC Coupon Extended Code Disable Read UPC-A barcodes starting with digit "5", EAN-13 barcodes starting with digits "99", and UPC-A/GS1-128 Coupon Codes. UPC-A, EAN-13, and GS1-128 must be enabled first! UPC/EAN Addon Addon 2 / Addon 5 Decide whether to decode EAN-8, EAN-13, UPC-E0, UPC-E1, UPC-A with addons. Ignore Addons Decode Only With Addons Decode With Addons (= Auto-discriminate) Code 11 Verify Check Digit Select Length Decide whether to verify the check digit. If the check digit is incorrect, the barcode will not be accepted. No verification One Check Digit Two Check Digits Any Length One or two fixed lengths Range (1~55) Note: Code 11 is supported on Long Range Laser scan engine for 8300 only. --- Ignore... Enable No Any Length 141
FORGE Batch Application Generator User Guide 142
2D SCAN ENGINE Appendix IV The tables below list reader settings as well as symbology settings for the 2D scan engine. READER SETTINGS TABLE 2D Engine Description Default Scan Mode Continuous Mode Test Mode Alternate Mode Aiming Mode Laser Mode Auto Off Mode Decode Illumination Aiming Pattern Laser mode Non-stop scanning To decode the same barcode repeatedly, move away the scan beam and target it at the barcode for each scanning. Non-stop scanning Capable of decoding the same barcode repeatedly Press the scan trigger to start with scanning. The scanning won't stop until you press the trigger again. Press the scan trigger to aim at a barcode. Within one second, press the trigger again to decode the barcode. The scanning won't stop until (a) a barcode is decoded, (b) the pre-set timeout expires, or (c) you release the trigger. Hold down the scan trigger to start with scanning. The scanning won't stop until (a) a barcode is read, (b) the preset timeout expires, or (c) you release the trigger. Press the scan trigger to start with scanning. The scanning won't stop until (a) a barcode is read or (b) the preset timeout expires. Decide whether to flash illumination on every barcode capture to aid decoding. Turn On (Internal LED) Turn Off Decide whether to project the aiming pattern during barcode capture. Turn On Turn Off On On 143
FORGE Batch Application Generator User Guide Time-out 3 sec. 0~255 (second) Set the maximum time for decoding to continue during a scan attempt. Aiming Duration It applies to the following scan modes only Aiming mode Laser mode Auto Off mode 3 sec. 1~255 (second) Set the maximum time for decoding to continue during a scan attempt. It applies to Aiming mode only. Picklist Mode 1D Inverse Decode Picklist mode enables the decoder to decode only barcodes aligned under the center of the laser aiming pattern. Enable Disable 1D Inverse Decoder: Decode regular 1D barcode only Decode inverse 1D barcode only Decode both regular and inverse Disable Decode regular 1D barcode only Note: Scan Mode options, Decode Illumination, Aiming Pattern, Aiming Duration, Picklist Mode and 1D Inverse Decoding are supported on 2D scan engine for 8200/8400 only. 144
Appendix IV 2D Scan Engine SYMBOLOGY SETTINGS TABLE 1D SYMBOLOGIES 2D Engine Description Default Codabar Transmit Start/Stop Character Select Length Code 128 GS1-128 Decide whether to include the start/stop characters in the data being transmitted. Any Length One or two fixed lengths Range (1~55) Enable No Any Length Enable Enable Replace Field Separator ISBT 128 Decide whether to replace the field separator. If the barcode contains Field Separator 0x1D, it will be changed to the desired Field Separator. For example, type the desired character ; (semicolon) as the new field separator. Then if the barcode contains Field Separator 0x1D, it will be changed to ;. No Enable Industrial 25 (Discrete 25) Enable Select Length Interleaved 25 Any Length One or two fixed lengths Range (1~55) Any Length Enable Convert to EAN-13 Convert a 14-character barcode into EAN-13 if the following requirements are met: The barcode must have a leading 0 and a valid EAN-13 check digit. No Verify Check Digit Transmit Check Digit Select Length Decide whether to verify the check digit. If desired, select one of the algorithms below. If the check digit is incorrect, the barcode will not be accepted. No USS algorithm OPCC algorithm Decide whether to include the check digit in the data being transmitted. Any Length One or two fixed lengths Range (1~55) No No Any Length 145
FORGE Batch Application Generator User Guide Matrix 25 Verify Check Digit Transmit Check Digit Select Length Chinese 25 Decide whether to verify the check digit. If the check digit is incorrect, the barcode will not be accepted. Decide whether to include the check digit in the data being transmitted. Any Length One or two fixed lengths Range (1~55) Disable No No Any Length Disable Note: Matrix 25 and Chinese 25 are supported on 2D scan engine for 8200/8400 only. Code 39 Enable Convert to Code 32 Convert to Italian Pharmacode. No Verify Check Digit Transmit Check Digit Code 39 Full ASCII Decide whether to verify the check digit. If the check digit is incorrect, the barcode will not be accepted. Decide whether to include the check digit in the data being transmitted. "Verify Check Digit" must be enabled so that the check digit can be left out (= "Transmit Check Digit" disabled). Code 39 Full ASCII includes all the alphanumeric and special characters. No No Disable Trioptic Code 39 Decide whether to decode Trioptic Code 39. Trioptic Code 39 is a variant of Code 39 used in the marking of computer tape cartridges. It always contains six characters. Disable Select Length Code 93 Select Length MSI Any Length One or two fixed lengths Range (1~55) Any Length One or two fixed lengths Range (1~55) Any Length Enable Any Length Disable Verify Check Digit If Two Check Digits option is selected, an additional verification is required to ensure integrity. Select one of the algorithms below. If the check digit is incorrect, the barcode will not be accepted. Single Modulo 10 146
Appendix IV 2D Scan Engine Check Digit Algorithm Transmit Check Digit Select Length GS1 Databar One Check Digit Single Modulo 10 Two Check Digits Mod 10/Mod 11 Mod 10/Mod 10 Decide whether to include the check digit in the data being transmitted. Any Length One or two fixed lengths Range (1~55) No Any Length --- GS1 Databar-14 GS1 Databar Limited GS1 DataBar-14 is short for GS1 DataBar Omnidirectional. This group consists of (1) GS1 DataBar Omnidirectional, (2) GS1 DataBar Truncated, (3) GS1 DataBar Stacked, and (4) GS1 DataBar Stacked Omnidirectional. Enable Enable GS1 Databar Expanded This group consists of (1) GS1 DataBar Expanded, and (2) GS1 DataBar Expanded Stacked. Enable Convert RSS to UPC/EAN "Convert to UPC/EAN" only applies to GS1 Databar-14 and GS1 Databar Limited barcodes not decoded as part of a Composite barcode. No Convert to EAN-13 Strip the leading "010" from barcodes. "01" is the Application ID and must be followed by a single zero (the first digit encoded) Convert to UPC-A Strip the leading "0100" from barcodes. "01" is the Application ID and must be followed by two or more zeros (but not six zeros) EAN-8 Convert to EAN-13 Addon 2 / Addon 5 EAN-13 Addon 2 / Addon 5 Bookland EAN (= Bookland ISBN-10) The EAN-8 barcode will be expanded into EAN-13, and the next processing will follow the settings configured for EAN-13. Refer to UPC/EAN Addon setting. Refer to UPC/EAN Addon setting. The EAN-13 barcode starting with 978 will be converted to ISBN. Data starting with 979 is not considered Bookland in this mode. Enable No Enable No 147
FORGE Batch Application Generator User Guide Bookland ISBN-13 Barcode data, starting with either 978 or 979, will be reported in 13-digit format to meet the 2007 ISBN-13 protocol. No Note: Bookland ISBN-13 is supported on 2D scan engine for 8200/8400 only. UPC-A Transmit Check Digit Decide whether to include the UPC-A check digit in the data being transmitted. Enable Yes Transmit Preamble Addon 2 / Addon 5 UPC-E (= UPC-E0) Decide whether to include the UPC-A preamble System Number (and Country Code) in the data being transmitted. Refer to UPC/EAN Addon setting. System Number Enable Transmit Check Digit Decide whether to include the UPC-E0 check digit in the data being transmitted. Yes Transmit Preamble Addon 2 / Addon 5 Convert to UPC-A UPC-E1 Decide whether to include the UPC-E0 preamble System Number (and Country Code) in the data being transmitted. Refer to UPC/EAN Addon setting. The UPC-E0 barcode will be expanded into UPC-A, and the next processing will follow the settings configured for UPC-A. System Number No Disable Transmit Check Digit Decide whether to include the UPC-E1 check digit in the data being transmitted. Yes Transmit Preamble Addon 2 / Addon 5 Convert to UPC-A Decide whether to include the UPC-E1 preamble System Number (and Country Code) in the data being transmitted. Refer to UPC/EAN Addon setting. The UPC-E1 barcode will be expanded into UPC-A, and the next processing will follow the settings configured for UPC-A. System Number No UCC Coupon Extended Code Disable Read UPC-A barcodes starting with digit "5", EAN-13 barcodes starting with digits "99", and UPC-A/GS1-128 Coupon Codes. UPC-A, EAN-13, and GS1-128 must be enabled first! UPC/EAN Addon Addon 2 / Addon 5 Decide whether to decode EAN-8, EAN-13, UPC-E0, UPC-E1, UPC-A with addons. Ignore Addons Decode Only With Addons Decode With Addons (= Auto-discriminate) --- Ignore... 148
Appendix IV 2D Scan Engine Code 11 Verify Check Digit Select Length Postal Codes US Postnet US Planet Transmit US Postal Check Digit UK Postal Transmit UK Postal Check Digit Japan Postal Australian Postal Dutch Postal UPU FICS Postal USPS 4CB/One Code/ Intelligent Mail Decide whether to verify the check digit. If the check digit is incorrect, the barcode will not be accepted. No verification One Check Digit Two Check Digits Any Length One or two fixed lengths Range (1~55) US Postnet or US Planet must be enabled first! UK Postal must be enabled first! Disable No Any Length --- Enable Enable Enable Enable Enable Enable Enable Enable Disable Disable Note: UPU FICS Postal and USPS 4CB/One Code/Intelligent Mail are supported on 2D scan engine for 8200/8400 only. Composite Codes Composite CC-C Composite CC-A/B Composite TLC-39 GS1-128 Emulation Mode for UCC/EAN Composite Codes Transmit UCC/EAN Composite Code data as if it was encoded in GS1-128 barcodes. --- Disable Disable Enable Disable UPC Composite Mode UPC barcodes can be "linked" with a 2D barcode during transmission as if they were one barcode. UPC Always Linked UPC Never Linked Transmit UPC barcodes regardless of whether a 2D barcode is detected. 149
FORGE Batch Application Generator User Guide UPC Always Linked Transmit UPC barcodes and the 2D portion. If the 2D portion is not detected, the UPC barcode will not be transmitted. CC-A/B or CC-C must be enabled! Auto-discriminate UPC Composites Transmit UPC barcodes as well as the 2D portion if present. 2D SYMBOLOGIES 2D Engine Description Default 2D Symbologies PDF417 MicroPDF417 Data Matrix Data Matrix Inverse Decide whether to decode Data Matrix Inverse. --- Enable Enable Enable Regular Only Regular Only Decode regular Data Matrix barcodes only. Inverse Only Decode inverse Data Matrix barcodes only. Inverse Autodetect Decode both regular and inverse Data Matrix barcodes. Mirror Image (for Data Matrix) Decide whether to decode mirror image Data Matrix barcodes. Never Never Do not decode Data Matrix barcodes that are mirror images. Always Decode only Data Matrix barcodes that are mirror images. Auto Decode both mirrored and unmirrored Data Matrix barcodes. Maxicode QR Code Enable Enable 150
Appendix IV 2D Scan Engine QR Code Inverse Decide whether to decode QR Code Inverse. Regular Only Regular Only Decode regular QR Code only. Inverse Only Decode inverse QR Code only. MicroQR Aztec Aztec Inverse Inverse Autodetect Decode both regular and inverse QR Code. Decide whether to decode Aztec Inverse. Enable Enable Regular Only Regular Only Decode regular Aztec barcodes only. Inverse Only Decode inverse Aztec barcodes only. Inverse Autodetect Decode both regular and inverse Aztec barcodes. Note: Data Matrix Mirror, MicroQR, Aztec, and 2D Inverse are supported on 2D scan engine for 8200/8400 only. 2D Symbologies - Macro PDF --- Macro PDF is a special feature for concatenating multiple PDF barcodes into one file, known as Macro PDF417 or Macro MicroPDF417. Transmit/Decode Mode Decide how to handle Macro PDF decoding. Buffer All Symbols / Transmit Macro PDF When Complete Transmit all decoded data from an entire Macro PDF sequence only when the entire sequence is scanned and decoded. If the decoded data exceeds the limit of 50 symbols, no transmission because the entire sequence was not scanned! Passthrough All Symbols Transmit Any Symbol in Set / No Particular Order Transmit data from each Macro PDF symbol as decoded, regardless of the sequence. 151
FORGE Batch Application Generator User Guide Passthrough All Symbols Transmit and decode all Macro PDF symbols and perform no processing. In this mode, the host is responsible for detecting and parsing the Macro PDF sequences. ESC Characters When enabled, it uses the backslash "\" as an Escape character for systems that can process transmissions containing special data sequences. It will format special data according to the Global Label Identifier (GLI) protocol, which only affects the data portion of a Macro PDF symbol transmission. The Control Header, if enabled, is always sent with GLI formatting. None Note: When printing barcodes, keep each Macro PDF sequence separate, as each has a unique identifier. Do not mix barcodes from several Macro PDF sequences, even if they encode the same data. When you scan Macro PDF sequences, scan the entire Macro PDF sequence without interruption! 152
COMMAND LINE SYNTAX Appendix V This is intended for users who are experienced with command line use. You may issue a command or run a script for executing any of the following utilities: Shortcut Name of Utility Program Name Usage DLookup DLookup.exe To download associated lookup file(s) to the mobile computer Prog_Load ProgLoad.exe To download the AG runtime or font file (.SHX) to the mobile computer. Data_Read Data_Read.exe To receive data via Data_Read utility. It also synchronizes date/time on every host connection. 153
FORGE Batch Application Generator User Guide DOWNLOAD UTILITIES DLOOKUP Command Line Syntax You can use the command line to download the lookup file as well. At the command line prompt, use the following command line arguments: DLookup <File name>,<com port>,<baud rate>,<download via>,<show message box> Argument Each argument is explained in the table below. If command line arguments are not given, you may select the appropriate parameters from the dialog box that pops up. Argument File name Description Max length: 256 bytes COM port Range: 1~255 Full-path file name is required when file is not in the current working directory. It is set to 1 by default in the utility program. Baud rate Range: 1~5 It is set to 1 by default in the utility program. 1: 115200 bps 2: 57600 bps 3: 38400 bps 4: 19200 bps 5: 9600 bps Download via Range: 1~3 It is set to 1 by default in the utility program. 1: 2: 3: RS-232 or IrDA Cradle-IR Modem Show message box Range: 0~1 It is set to 1 by default in the utility program. 0: 1: Disable Enable Example DLookup DEMO_LOOKUP.TXT,1,1,1,0 // COM 1, 115200 bps, RS-232/IrDA, Do not show message 154
Appendix V Command Line Syntax PROGLOAD Command Line Syntax You can use the command line to download a program file as well. At the command line prompt, use the following command line arguments: ProgLoad <File name>,<download via>,<com port>,<baud rate>,<file type>, <Operation mode> Argument Each argument is explained in the table below. If command line arguments are not given, you may select the appropriate parameters from the dialog box that pops up. Argument File name Description Max length: 256 bytes Full-path file name is required when file is not in the current working directory. Download via Range: 1~3 It is set to 1 by default in the utility program. 1: 2: 3: RS-232 or IrDA Cradle-IR TCP/IP COM port COM port: 1~255 It is set to 1 by default in the utility program. TCP port: 1~65535 It is set to 3000 by default in the utility program. Baud rate Range: 1~5 It is set to 1 by default in the utility program. 1: 115200 bps 2: 57600 bps 3: 38400 bps 4: 19200 bps 5: 9600 bps File type Range: 0~2 It is set to 0 by default in the utility program. 0: 1: 2:.SHX file.syn file.bin file 155
FORGE Batch Application Generator User Guide Operation mode Range: 0~1 It is set to 0 by default in the utility program. 0: 1: Show property settings for confirmation before download Auto download file Example ProgLoad C:\U8400.shx,1,1,1,0,1 // RS-232/IrDA, COM 1, 115200 bps,.shx, Auto download file 156
Appendix V Command Line Syntax UPLOAD UTILITIES DATA_READ Command Line Syntax You can use the command line to download the lookup file as well. At the command line prompt, use the following command line arguments: Data_Read <File name>,<upload via>,<com Port>,<Baud rate>,<save mode>, <Add CR character>,<add LF character>,<show error>,<show data>, <Show dialog box>,<keep online>,<polling time>,<inter-char delay> Argument Each argument is explained in the table below. If command line arguments are not given, you may select the appropriate parameters from the dialog box that pops up. Argument File name Description Max length: 256 bytes Full-path file name is required when file is not in the current working directory. Upload via Range: 1~4 COM port Range: 1~255 It is set to 1 by default in the utility program. 1 (R) : RS-232 or IrDA 2 (I) : Cradle-IR 3 (T) : Modem-TAPI 4 (M) : Modem-COM It is set to 1 by default in the utility program. Baud rate Range: 1~5 Save mode Range: 0~5 It is set to 1 by default in the utility program. 1 (115200) : 115200 bps 2 ( 57600) : 57600 bps 3 ( 38400) : 38400 bps 4 ( 19200) : 19200 bps 5 ( 9600) : 9600 bps It is set to 1 by default in the utility program. 157
FORGE Batch Application Generator User Guide 1: 2: 3: 4: 5: Overwrite Append Keyboard emulation Auto file name Auto append Add CR character Range: 0~1 It is set to 1 by default in the utility program. 0: 1: Disable Enable Add LF character Range: 0~1 It is set to 1 by default in the utility program. 0: 1: Disable Enable Show error Range: 0~1 It is set to 1 by default in the utility program. 0: 1: Disable Enable Show data Range: 0~1 It is set to 1 by default in the utility program. 0: 1: Disable Enable Show dialog box Range: 0~1 It is set to 1 by default in the utility program. 0: 1: Disable Enable Keep online Range: 0~1 It is set to 1 by default in the utility program. 0: 1: Disable Enable Polling time Inter-Char delay Range: 1~999 sec (It is set to 2 by default in the utility program.) Range: 0~255 ms (It is set to 2 by default in the utility program.) Example Data_Read DataFile_1.TXT,1,1,1,1,1,1,1,1,0,1,2,0 // RS-232/IrDA, COM 1, 115200 bps, Overwrite, Add CR, Add LF, Show error message, Show data, Hide dialog box, Keep online, Polling time 2 seconds, No Inter-Char delay 158