1. disk1.zip Driver
2. readme.txt File Contents

readme.txt Driver File Contents (disk1.zip)

RapidGEN readme.txt file, 12/01/2000

Opticon, Inc.
8 Olympic Drive
Orangeburg, NY 10962

The following information contains instructions on how to use the RapidGen 
program and serves as the online HELP function from the main menu. It should be 
printed directly from disk #1 and kept available for reference.



INTRODUCTION:
RapidGEN is a program designed to allow easy programming of the DWT-7133 
(hereafter referred to as DWT or terminal) to collect data in variety of 
formats. Custom programming of the DWT normally requires the use of a cross-
compiler with source code developed on a PC. This code is then processed and 
downloaded to the terminal. With RapidGEN, a "shell" program is downloaded to 
the DWT and is subsequently modified with "ini" (initialization) files that 
defines the parameters of the data collection program that appears on the screen 
of the terminal. Opticon supplies several "standard" ini files that fit many 
standard data collection applications. The user can use these as supplied, or, 
using RapidGEN, customize them to the application or generate a completely new 
file, as desired. RapidGEN allows a new user of the DWT to be operational and 
performing data collection tasks in a relatively short time, without having to 
write programming code for the terminal.



INSTALLATION
RapidGEN runs under Windows95, WindowsNT 4.0 and Windows98. Please note that to 
run RapidGEN under Windows95, either OEM Service Release 2.0 or OLE32 & KERNEL32 
update should be installed. These files can be found at the Microsoft web site 
"www.microsoft.com".

To install the program run a:setup from diskette 1 of 3. Follow all prompts. The 
net effect of running setup is to install a program in the PC that allows the 
user to perform three major tasks: loading the shell program to the DWT as 
referenced above, to design and download ini files to the shell program after 
its installation in the DWT, and to upload captured data from the DWT to the PC. 
The shell program, in programmer's parlance, is a "S2" file and its name is 
CFQ20700.S2. This file after being loaded to the DWT, will perform the task of 
receiving and using a subsequent ini file that defines screen prompts, field 
lengths, setting communication parameters, etc. The ini file is what enables the 
shell program to collect and send data to the host PC in response to the 
terminal's on-screen prompts. Normally when the DWT power is turned on, it 
automatically starts the shell program (with the most currently downloaded ini 
file), and will bring up the main (or starting menu) on the screen.

Pressing the "ARROW UP" key again allows the operator to move backwards to the 
previous display screen. If multiple display prompts (screens) were designed, 
pressing the "ARROW UP" key again allows the operator to continue to move backwards 
until the first display prompt (screen) is reached.

As described above, the S2 file needs an ini file to complete its function as a 
DWT application program (which, among other things, determines the prompts 
during data collection). The ini file contains information that defines prompt 
name(s), prompt type, and length of the acceptable input value for the prompt, 
whether a value is required for the prompt and whether the prompt will be a 
loopback prompt. A loopback prompt is one that permits repeating the input 
operation until the user exits it by depressing a specific key (ARROW UP) on the 
terminal keyboard. Note: Only one loopback prompt is permitted per ini file.

In order to download files (including the shell and ini files) to the DWT, the 
PC and the DWT need to be configured to communicate with each other. NOTE: the 
DWT is pre-configured at the factory with specific communication parameters that 
the PC must match for communication between the two devices to occur.



PC COMMUNICATION PORT SETUP
Start RapidGEN from the icon on the Desktop (installed by the setup program). 
Click on the button for PC Configuration. Click on the MODIFY button. The Com 
Port Selection should be set to the communications port on the PC to which the 
DWT Cradle* is connected. The values for baud rate, data bits, parity and stop bits should 
match with the default settings in the DWT-7133 "demo" program, the application 
program that is loaded into every PHL at the factory. These values are initially 
9600, 8, N and 1 respectively. Save the values by clicking on the Save button. 
Once the configuration is set, these settings will be used to communicate with 
the DWT for downloading the S2 file. Once the S2 file is loaded into the DWT, 
then the parameters may be reset for the PC using the RapidGEN functions 
described above, or for the PHL via the Setup menu in the main menu Data 
Transfer option.


DWT SETUP FOR DOWNLOADING S2 FILE
If the settings on the PC match the settings on the DWT no prior settings are needed
to download the "S2" file in the DWT. If the settings on the PC do not match 
the settings on the DWT do the following. Press all three buttons on the DWT, now 
the settings menu appears. Choose menu option 3 Download appl. 

Put the DWT in the cradle and make sure that the DWT is connected to the PC. Press the 
"Load Program In DWT" button. On the DWT a percentage ready will appear.

DOWNLOADING THE SHELL PROGRAM
In RapidGen, click on the Load Program in DWT button, select the CFQ20710.S2
file shown in the dialog box, and follow the subsequent directions to load the 
DWT with the shell file. After the download process is complete, the DWT starts.
The new main menu as created by the shell program will appear. The next step is 
to create an ini file using RapidGEN and then download it to the DWT. 
NOTE: faster communication speeds may now be chosen as described 
in port setup options. If communication fail check connections, try another
baudrate, or comport settings. 



CREATE, MODIFY AND DELETE INI FILES
To create a new file, click on the New ini button, and specify the name, 
(location and path, if necessary) of the file to be created. Type in the 
required information and then save it.

To modify an existing ini file, click on the Open ini button, select the file, 
then click on the Modify button, make the necessary changes and save it.

To delete an existing ini file, click on the Open ini button and select the 
file. Click on the Delete button.


Please keep the following in mind as you create an ini file:

Prompt Names must be restricted to 14 characters or less.
Field types are limited to either text, numeric or date.

	"Text" is selected when field input is alpha characters and/or numeric characters. 
	"Number" is selected when field input is only numeric characters.
	"Date" is selected when field input reflects a date entry (ie: MM/DD/YY), where a
	"/" is used to separate the month, date and year. 

A Required Field is one that requires a value before the program will move to 
the next prompt.
A Loopback Field is used to specify where the user wants the prompt to return to 
when the transaction is complete. Note: there can be only one loopback field 
designated for a particular ini file.



DOWNLOADING THE INI FILE
An ini file must be loaded into the shell file on the DWT in order to collect 
data. To download the ini file, the PHL must be connected to the PC. From the 
PHL main menu (which now has the Shell program in it), select option 3 for Data 
Transfer and then option 2 for DNLD FILE. In RapidGEN, click on the button for 
Download ini File. In the dialog box that is displayed, select the ini file that 
you want to download, then follow the directions in RapidGEN to download the ini 
file. Downloading an ini file overwrites the previous ini file.



UPLOADING DATA FROM THE DWT-7133
Once data collection is complete, connect the DWT to the host PC using the 
Cradle. From the main menu on the DWT, select option 3 
for DATA XFR and then option 1 for UPLOAD FILE. On the PC, press the button for 
Upload File from DWT and then follow the directions on the PC. A file named 
"import.txt" containing the uploaded data will be created 
in the working folder (directory) of RapidGEN on the PC. If a previous upload 
created an import.txt, it will be overwritten by the current upload. Since the 
previous import.txt file is overwritten, please make sure you have properly 
processed its data before uploading the next DWT data file. When the file 
transfer is complete, the DWT will prompt the user to keep or delete the 
data from the PHL. To keep data press ARROW UP at the prompt or press ARROW Down 
to delete the data.



SAMPLE FILES
A variety of sample ini files are enclosed with RapidGEN to be used as is, or as 
examples for creating user-specific application programs. These files are 
asset.ini, inventory.ini, checkio.ini and stamp.ini. They are data collection 
programs that are typical for asset tracking, inventory management, and 
stockroom applications. Simply select any one of them and download it to the PHL 
to inspect its structure. You may use it as is, or modify it using the 
programming features of RapidGEN and downloading the modified version to the 
PHL. It is recommended that the original files be saved using another name (such 
as asset1.ini) so you can always revert to the original version if necessary.

Data entry on DWT7133
Barcode
For numeric and date input a barcode sheet ia available in the working directory.
the barcoide sheet is saved in the file KEYBOARD.BMP
Numerical 0..9 BS and ENT
Date	  0..9 BS ENT and /