Unitech PA500 manual

PA500 Programming Manual V 1.2 1/15/2008[...]

- 2 1. INTRODUCT ION ................................................................................................................. 5 1.1 How to dow nload data from scanner ....................................................................................................................... 5 1.2 COM definition for PA500 .......................[...]

- 3 2.24. Only send single command decoding chip ...................................................................................................... 14 2.25. Send command to decoding chip ....................................................................................................................... 15 3. CONTROL COMMAND FOR DECODER CHIP [...]

- 4 6.4.2. Get Screen Backlight Status ............................................................................................................................... .2 7 6.4.3. Screen Backlight Brightness Control .................................................................................................................. 27 7. DYNAMIC LO AD [...]

- 5 1. Introduction 1.1 How to download data from scanner The major difference between the PA500 and a standard HPC/PalmPC is barcode input capability. The WinCE Referenc e Manual contains no information regarding barcode input. This section will introduce the programming st ructure of the barc ode sub-system and the programming utility library for[...]

- 6 1.2 COM definition for PA500 COM 1 Reserve COM2 Scanner (Hamster) COM 3 IrDAComm COM 4 Bluetooth Modem COM 5 RawIR COM 6 BTModem UART[...]

- 7 2. USI.DLL – Unitech Scanner Interface DLL Note : For PA500 programming, it need to dynamically load DLL for using Unitech built-in DLL (Unitech will not provide *.H and *.LIB for compiler for mobile 5.0 OS), please refer to Chapter 7 for programming guide. 2.1. Register the application to the USI DLL Function Description: Register the applic[...]

- 8 "CHECKPARITY"="1" 2.2. Unregister the application from the USI.DLL Function Description: Unregister the application from the D LL. It will close the scanner port, and by default it will disable the scanner. Function call: void USI_Unregister (); Return code: None 2.3. Enable / Disable Scanner Function Description: To start o[...]

- 9 2.7. Get scan data Function Description: Retrieves the scan data into the buffer. Returns the length of characters. It also returns the barcode type if type is not NULL. Return 0 means that the buffer is too short to hold the data. USI_GetData should be called when SM_DAT AREADY message is received. Or call USI_ResetData to discard the data. Bo[...]

- UINT : Data length 2.8. Get length of scanned data Function Description: Returns the data length of the scan data. When allocate the memory to hold the scan data, add at least one additional byte for string terminator. Function call: UINT USI_GetDataLength (); Return: UNIT : data length 2.9. Get Symbology name Function Description: Returns the ba[...]

- 2.10. Clear scan data system buffer Function Description: Reset the data buffer so that next new scan data can come in. Function call: void USI_ResetData (); 2.11. Good read indicator Function Description: Inform a good receiving of scan data, this will play a sound (wave file scanok.wav) and light the LED lasting for 1 second. Function call: voi[...]

- 2.14. Save scanner setting into specified file Function Description: Save the current settings to file. The file takes “*.USI” as extension name. Function call: BOOL USI_SaveSettingsToFile( LPCTSTR filename ) Parameter: (input) filename : LPCTSTR: file name for setting profile Return: TRUE = success FALSE = error 2.15. Change scanner setting [...]

- 2.17. Stop auto scanning function Function Description: Stop auto scanning Function call: void USI_StopAutoScan (); 2.18. Check if auto scanning is enable Function Description: Check if auto scanning function is enabled or not Function call: BOOL USI_IsAutoScanning () Return: BOOL: TRUE : auto-scanning is running FALSE : auto-scanning is disabled[...]

- 2.22. Enable/Disable Scan2Key Function Description: Enable or disable Scan2Key to put scanned data to standard keyboard input buffer. Scan2Key is enabled by default. Function call: BOOL S2K_Enable( BOOL enable, DWORD timeout ) ; Parameter: (input) enable: BOOL: TRUE = Enable scanned data to keyboard buffer FALSE = Disable scanned data to keyboard[...]

- 2.25. Send command to decoding chip Function Description: Send command to decoder chip. This is a variation of command HAM_SendCommand. It will read a number of parameters and packet them as in following format and send it to decoder chip. Esc, parameter1, parameter2, …, BCC The total number of parameters is s pecified by first parameter num. F[...]

- 3. Control command for decoder chip Important : This chapter describes low level comm and for scanner control function. If you already USI to do scanner programming, you don’t need to care about this chapt er. In general, it is not suggested to use level command to cont rol scanner, because there are timing issue on serial communication program[...]

- 2_is standby mode. Beep Esc,0,4,3,m,S1,BCC S1 0 none,1 lo w,2_medium,3 high,4 low/high,5high/low block_delay Esc,0,4,4,m,S1,BCC S1 is 0_10ms,1 50ms,2 100ms,3 500ms,4 1s,5 3s char_delay Esc,0,4,5,m,S1,BCC S1 is 0_none,1 1ms,2 5ms,3 10ms,4 20ms,5 50ms Function_code Esc,0,4,6,m,S1,BCC No meaning for you S1 is 0 off,1_on Capslock Esc,0,4,7,m,S1,BCC N[...]

- Mterminator Esc,0,4,31,m,S1,BCC No meaning for you Here S1 is 0_ENTER,1 NONE Sentinal Esc,0,4,32,m,S1,BCC No meaning for you S1 is 0 not send,1 send Track_selection Esc,0,4,33,m,S1,BCC No meaning for you Here S1 is =0_ALL TRACKS,1 TRACK1 AND TRACK2,2 TRACK1 AND TRACK3,3 TRACK2 AND TRACK3,4 TRACK1,5 TRACK2,6 TRACK3 T2_account_only Esc,0,4,34,m,S1,[...]

- Msi_pleasey Esc,0,4,5b,m, S1,BCC S1 is S1.b0 is for Msi_p_enabl e,S1.b1 is for Msi_pleasey_cd, S1.b3b2 is for Msi_p_cdmode Msi_p_enable Esc,0,4,5c,m,S1,BCC S1 is 0_disable,1 enable Msi_pleasey_cd Esc,0,4,5d,m,S1,BCC S1 is 0 check digit send,1_not send Msi_p_cdmode Esc,0,4,5e,m,S1,BCC S1 is 0 check digi t double module 10,1 check digit module 11 p[...]

- Supplement_five,S1.b2 is for Supplement_mh, S1.b3 is for Supplement_ssi. Supplement_two Esc,0,4,88,m,S1,BCC S1 is 0_off,1 on Supplement_five Esc,0,4,89,m,S1,BCC S1 is 0_off,1 on Supplement_mh Esc,0,4,8a,m,S1,BCC S1 is 0_transmit if present,1 must present Supplement_ssi Esc,0,4,8b,m,S1,BCC S1 is 0 Space been inserted, 1_Space not been inserted Del[...]

- 4. Scanner3.DLL – Backward compatible API for PT930/PT930S’s Scanner3.dll Note : For PA500, it need to dynamically load D LL for using Unitech built-in DLL (Unitech will not provide *.H and *.LIB for compiler), please refer to Chapter 7 for programming guide. 4.1. Enable Decoder Function Description: This function will open COM2 port, create [...]

- 4.4. Read barcode data Function Description: Get input barcode data and its type from system buffer. Function call: BOOL PT_GetBarcode( TCHAR * szBarcodeBuffer,TCHAR *cType); Parameter: (output) szBarcodeBuffer : string buffer for storing input data cType : Type of Input data =00H Full Code 39 =01H STD Code 39 =02H EAN-13 =03H UPC-A =04H EAN-8 =0[...]

- 5. ScanKey3.DLL – Backward compatible API for PT930/PT930S’s ScanKey3.dll Note : For PA500, it need to dynamically load D LL for using Unitech built-in DLL (Unitech will not provide “USI.H” and “USI.LIB” for compiler), please refer to Chapter 7 for programming guide. 5.1. Enable Decoder Function Description: This function will open CO[...]

- 6. SysIOAPI.DLL This DLL provide hardware relative API for us er to control scanner, LED, back-light and PC card slot. API functions are provided through D LL to assist programmer to write application for PA500. Note : For PA500 programming, it need to dynamically load DLL for using Unitech built-in DLL (Unitech will not provide *.H and *.LIB for[...]

- 6.2. Scanner Related Functions To save power, the decoder IC is disabl ed when scanner is not in use. It can be enabled through USI functions. Following functi ons are meaningful only if decode IC is enabled. 6.2.1. Enable/Disable Scanner trigger key Function Description: This function enables/disables trigger keys. Function call: void EnableScan[...]

- 6.2.5. Check Trigger key is pressing Function Description: This function is used to check if left or right trigger key is pressed or not. Function call: BOOL TriggerKeyStatus( int key); Parameter(Input) key: int: LEFT_TRIGGER_KEY : left trigger key RIGHT_TRIGGER_KEY : right trigger key. Return code: TRUE = trigger is pressed. FALSE = trigger is r[...]

- 6.4. LCD/Backlight related function There are two backlight controls, screen backlight and keypad backlight. They are controlled separately. For screen backlight, you can adjust brightness of backlight also. 6.4.1. Screen Backlight Control Function Description: This function turns screen backlight on or off. Function call: void BacklightOn(BOOL f[...]

- 7. Dynamic Load DLL Compiler would not load the DLL while use dynamic load DLL, it help user to load the DLL if it exists while the application executed. The follow is the example. Note: Even user does not need include the header and lib file but need to know the function definition. ///////////////////////////////////////////////////////////////[...]

- 8. Useful function call - without include SysIOAPI.DLL 8.1. Warm-boot, Cold-boot and power off #include <pkfuncs.h> #include "oemioctl.h" // Warn boot KernelIoControl(IOCTL_HAL_REBOOT , NULL, 0, NULL, 0, NULL); // Cold boot KernelIoControl(IOCTL_COLD_BOOT , NULL, 0, NULL, 0, NULL); // Power off { DWORD dwExtraInfo=0; BYTE bScan=0;[...]

- 9. Update notes V1.0 The first version V1.1 COM port error correction on section 1.2 V1.2 Change logo[...]