API Reference Manual
Barcode Handy Terminal
BHT-700-CE
Page 1: ...API Reference Manual Barcode Handy Terminal BHT 700 CE...
Page 2: ...tion may be reproduced in any form or by any means without permission in writing from the publisher Specifications are subject to change without prior notice All products and company names mentioned i...
Page 3: ...ng Stopping the Beeper Vibrator 12 5 4 Priority Orders between Events that Activate the Beeper Vibrator 12 5 5 Beeper Volume Patterns 12 Chapter 6 Keys and Trigger Switch Control 13 6 1 Outline 13 6 2...
Page 4: ...Function 40 13 1 3 Barcode Buffer 41 13 2 Programming 42 13 2 1 Code Mark 42 13 2 2 Multiple Code Reading 42 13 2 3 Read Mode of the Trigger Switch 42 13 2 4 Generating a Check Digit of Barcode Data 4...
Page 5: ...lback Functions 157 17 5 4 Coding Sample 159 Appendix A Keyboard Arrangement Virtual Key Codes and Character Codes 160 A 1 27 key pad 160 A 1 1 Keyborard Arrangement 160 A 1 2 Virtual Key Codes and Ch...
Page 6: ...ard header files 3 Windows CE standard library files 4 BHT dedicated header file BHTLIB h Includes statements for declaring BHT dedicated APIs prototypes and macro definition of constants To use the B...
Page 7: ...development tool Microsoft eMbedded Visual C 4 0 SP4 You can download Microsoft eMbedded Visual C 4 0 and Service Pack 4 from the Microsoft Web site Microsoft eMbedded Visual C 4 0 http www microsoft...
Page 8: ...the system setting function BHT_SetSysSettingDW 3 2 1 Setting the Screen Rotation Control Key The screen rotation control key can be set using the BHT_SetSysSettingDW BHT_DISP_ROTATION_KEY function F...
Page 9: ...ngDW DWORD dwCtrlCode DWORD dwSysParam and BHT_GetSysSettingDW DWORD dwCtrlCode DWORD pdwSysParam functions respectively Parameter Type R W Control Code dwCtrlCode Parameter Value dwSysParam Default V...
Page 10: ...t illumination trigger 4 2 Setting the Backlight Function On Off Key You can assign the backlight function on off key to other keys by the BHT_SetSysSettingDW BHT_BACKLIGHT_KEY function or by assignin...
Page 11: ...HT _AC_TIME 0 255 0 Backlight OFF 255 Continuously ON 60 When backlight illumination timer is next reset 4 4 Setting the Backlight Brightness and Power Saving Mode The backlight brightness and power s...
Page 12: ...t illumination trigger the key backlight will not illuminate even if a key is pressed If however the key backlight is already illuminated beforehand it will not turn OFF by pressing a key 4 If touch p...
Page 13: ...ion time 2 elapsing 1 Backlight power saving mode backlight function ON 2 Backlight ON 3 Backlight power saving mode backlight function OFF BHT_SetBltStatus BHT_BL_ENABLE_ON 5 Perform one of the follo...
Page 14: ...ot suspend is 3 4 7 Key Backlight The following settings can be made for the key backlight Parameter type R W Control code dwCtrlCode Parameter value dwSysParam Default Validating timing Device illumi...
Page 15: ...he beeper vibrator setting functions that allow you to choose beeper and or vibrator and set the beeper volume Refer to Section 5 2 2 the beeper vibrator start stop functions that allow you to set the...
Page 16: ...D_OFF First sound after setting 1 This setting is effective only when the value 0 1 or 2 is specified to the frequency in the beeper start stop functions BHT_StartBeep or BHT_StartBeeperOnly 2 This ex...
Page 17: ...power states are turned OFF while the beeper is sounding or the vibrator is vibrating the BHT resumes with both the beeper and vibrator stopped when the unit is next resumed 5 4 Priority Orders betwe...
Page 18: ...ls the following functions assigned to them 1 Specifying the shift key operation mode 2 Assigning functions to the magic keys M1 to M3 3 Supporting the alphabet entry mode in addition to the numeric e...
Page 19: ...Treat as ALT key MAGIC_FUNC_CTRL Treat as CTRL key MAGIC_FUNC_BLT Treat as backlight function on off key MAGIC_FUNC_TAB Treat as TAB key MAGIC_FUNC_CLEAR Treat as CLEAR key MAGIC_FUNC_USERDEF User de...
Page 20: ...C_NONE M1 key VK_M1 C1 M2 key VK_M2 C2 M3 key VK_M3 C3 MAGIC_FUNC_ENTER VK_RETURN 0D 0D CR 0D CR MAGIC_FUNC_TRG 1 MAGIC_FUNC_SHIFT VK_SHIFT 10 MAGIC_FUNC_CTRL VK_CONTROL 11 MAGIC_FUNC_ALT VK_MENU 12 M...
Page 21: ...User Defined Code Settings File MKeyDef txt 1 File name MKeyDef txt fixed 2 Format Character string inside the combo box Defined code number Defined code 1 Defined code 4 Item Display Method Setting C...
Page 22: ...eys in this mode returns virtual key codes and character codes specified in Appendix A 6 6 2 Alphabet Entry Mode 1 27 key pad The alphabet entry mode 1 starts by 1 calling the BHT_SetSysSettingDW BHT_...
Page 23: ...there is no unestablished key the same character code as in the numeric entry mode is returned F1 to F12 Key Establish an unestablished key if any If there is no unestablished key the same character c...
Page 24: ...ar phone 1 The following icon below displays in the task bar when starting alphabet entry mode 2 The unestablished character display window does not display 2 If keys 0 to 9 or the key is pressed char...
Page 25: ...ined in Appendix A Keyboard Arrangement Virtual Key Codes and Character Codes 6 8 Key Clicks When the keys are pressed the BHT clicks as specified below Note that pressing the power key does not click...
Page 26: ...ode In Alphabet entry mode A to Z key BS key C key W X S T key F1 to F12 key SF key FN key ENT key TAB key AL key N A NUM key N A ESC key SCAN key Magic keys No key assignment ENT key Trigger key Shif...
Page 27: ...Numeric entry status 42 key pad only Displays when in numeric entry mode Standby state Displays this icon when the CPU comes to be on standby The wireless device is open Synchronization state Display...
Page 28: ...1 Display 1 Immediately after setting Keypad shift icon DW R W BHT_ICON _SHIFTKEY 0 Hide 1 Display 1 Immediately after setting Alphabet input icon 27 key pad only DW R W BHT_ICON _IN_ALPHA 0 Hide 1 Di...
Page 29: ...F 2 1 Suspend The BHT will be suspended when the power is turned off with the power key or auto power off feature 2 Critical OFF The BHT will become critical off when the power is turned off due to ba...
Page 30: ...r vibrator in operation Key click sound touch panel tap sound in operation Backlight being ON excludes those times when continuously ON Reading barcodes IrDA interface port opened Connector interface...
Page 31: ...Param and BHT_GetSysSettingDW DWORD dwCtrlCode DWORD pdwSysParam functions write or read the auto power off timeout as specified below Parameter name Type R W Control code Parameter value Defaults Val...
Page 32: ...battery voltage status display is authorized Battery voltage level Level Voltage Battey Voltage Icon High 3 9 V or higher Medium 3 7 V or higher and less than 3 9 V Low 3 6 V or higher and less than 3...
Page 33: ...nctions Furthermore the LED ON OFF status can be acquired using the BHT_GetNLedStatus and BHT_GetNLedStatusEx functions 2 Limited items LEDs cannot be controlled when a barcode device file is open LED...
Page 34: ...ace complies with the IrDA SIR 1 2 2 Connector interface The Connector interface is assigned to port 1 RTS and CTS signal lines are not supported Communications parameter Effective setting Default Tra...
Page 35: ...ess USB LAN 1 1 CU 714 is necessary for USB LAN communication 11 4 2 ActiveSync Auto Connection Setting Method The ActiveSync auto connection function is set and read using the BHT_SetSysSettingDW DWO...
Page 36: ...ronization with access point Impossible Synchronization complete Possible Roaming Impossible if the BHT is not synchronized with an access point Possible if synchronization with an access point is kep...
Page 37: ...he following function to edit or create a new profile BHT_RF_IoControl RF_SET_PROFILE Please refer to section 13 2 1 Wireless Communication Parameters for details of the setting method Use ESSID and I...
Page 38: ...below Security Parameter None PEAP 802 1x EAP TLS 802 1x PEAP WPA EAP TLS WPA PSK WPA Authentication OPEN OPEN OPEN WPA WPA WPA PSK Encryption Disable WEP static WEP auto distribution WEP auto distrib...
Page 39: ...es on wireless LAN standard 802 11a P_RADIOMODE_11B Operates on wireless LAN standard 802 11b P_RADIOMODE_11B P_RADIOMODE_11G Operates on wireless LAN standard 802 11b and 802 11g Ex To set the radio...
Page 40: ...1B 802 11b P_RADIOMODE_11B P_RADIOMODE_11G 802 11b g P_RADIOMODE_11B Authentication method DW R W P_AUTH_OPEN Open P_AUTH_SHARED Shared P_AUTH_WPA WPA P_AUTH_WPAPSK WPA PSK P_AUTH_WPA2 WPA2 P_AUTH_WPA...
Page 41: ...n the following communication formats Settable Value Details COMM_NORMAL Wireless communication open COMM_CONTINUOUS Wireless communication continuously open The following diagram illustrates the wire...
Page 42: ...ently open Several seconds are required to obtain synchronization with the access point after opening the wireless communication device Furthermore when using DHCP there are times when several tens of...
Page 43: ...Short format of the start stop characters supported Codabar NW 7 No length of read data specified No check digit No start stop character Code 39 No length of read data specified No check digit Code 9...
Page 44: ...flag specified No length of read data specified No check digit Interleaved 2of5 ITF No length of read data specified No check digit No start stop character CODABAR NW 7 No length of read data specifi...
Page 45: ...8 Length of read data Standard 2of5 STF Length of read data Start stop character Check digit MSI 1 digit check digit 2 digit check digit RSS Nothing specified BHT 700Q Barcode type Options 2D codes QR...
Page 46: ...haracters BHT 700Q The barcode buffer will be occupied by one operator entry job and can contain up to 99 bytes in barcode or 8 192 bytes in 2D code 1 kanji character equals 2 bytes You can check whet...
Page 47: ...BHT_SysSettingDW function You may select the read mode of the trigger switch by using the BHT_EnableBar function as listed below Read Mode BHT_EnableBar Function Auto off Mode BHT_EnableBar TEXT F Mo...
Page 48: ...l beep when it reads a barcode successfully You may select beeping only vibrating only or beeping vibrating by setting on the system menu BhtShell exe or by setting the output port in the BHT_SetSysSe...
Page 49: ...and the types of barcodes that are allowed to be read are designated by the kbifCE A comparison of the functions of Win32 API when using a general COM port and a virtual COM port for barcode use is as...
Page 50: ...ent specify whether to turn OFF the power or perform a cold boot after updating the OS For example Update OS image file named _B7BWDW0 SY3 stored in temp folder and perform a cold boot after updating...
Page 51: ...rmation Function Used to BHT_SetSysSettingDW Write system parameter values DWORD BHT_GetSysSettingDW Read system parameter values DWORD BHT_SetSysSettingWCS Write system parameter values character str...
Page 52: ...eter values Syntax DWORD BHT_SetSysSettingDW DWORD dwCtrlCode DWORD dwSysParam Parameters dwCtrlCode in Control code dwSysParam in Parameter value Return value Error code Meaning ERROR_SUCCESS Success...
Page 53: ...ngDW DWORD dwCtrlCode DWORD pdwSysParam Parameters dwCtrlCode in Control code pdwSysParam out Address for storing the parameter value Return value Error code Meaning ERROR_SUCCESS Successful completio...
Page 54: ...sSettingWCS DWORD dwCtrlCode TCHAR pwchSysParam DWORD dwLen Parameters dwCtrlCode in Control code pwchSysParam in Heading address of the storage buffer for a string written dwLen in String length Retu...
Page 55: ...wLenReturned Parameters dwCtrlCode in Control code pwchSysParam out Heading address of the storage buffer for a string read dwLen in String length pdwLenReturned out Length of the string read out Retu...
Page 56: ...etting Waiting time to auto power OFF when placed on CU sec DW R W BHT_PM _EXTPOWEROFF 0 Disable 1 to 0xFFFFFFFF 0 Immediately after setting CPU clock 2 DW R W BHT_PM _CPU_CLOCK CPU_CLK_NORMAL Regular...
Page 57: ...G_LCD Immediately after setting when BHT_SetBltStatu s next called Key backlight illumination trigger DW R W BHT_BACKLIGHT _FACTOR 0 Always OFF BHT_BLT_KEY_FACTOR_ KEY Key press BHT_BLT_KEY_FACTOR_ KE...
Page 58: ...Scanning range marker 6 DW R W BHT_BAR_MARKER MARKER_NORMAL Normal mode MARKER_AHEAD Maker ahead MARKER_DISABLE Fixed to OFF MARKER _NORMAL Immediately after setting 53...
Page 59: ...IC_FUNC_ENTER Treat as ENT key MAGIC_FUNC_TRG Treat as trigger switch MAGIC_FUNC_SHIFT Treat as SF key MAGIC_FUNC_ALT Treat as ALT key MAGIC_FUNC_CTRL Treat as CTRL key MAGIC_FUNC_BLT Treat as bacjlig...
Page 60: ...e wireless device has been opened the icon appears immediately It disappears immediately after this parameter is set to 0 Standby state icon DW R W BHT_ICON _STANDBY 0 Hide 1 Display 0 The icon appear...
Page 61: ...BT _POWER_OFF Immediately after setting Audio related Voice output from receiver DW R W BHT_AUDIO_OUT _RCV BHT_AUDIO_OUT_RCV _DISABLE Disable BHT_AUDIO_OUT_RCV _ENABLE Enable BHT_AUDIO_OUT_ RCV_DISABL...
Page 62: ...on Return Value Error Code Meaning ERROR_SUCCESS Successful completion ERROR_INVALID_PARAMETER Parameter error Device Type dwDevice pdwDevInfo Read device BHT_DEV_SCANNER Either of the following SCANN...
Page 63: ...most recently BHT_GetBarChkDgt Calculate a check digit CD of the barcode data according to the calculation method specified by dwCDType BHT_BAR_SetDecodeOptions Sets the editing function setting value...
Page 64: ...parameter BHT_RF_GetParamStr Read string from the wireless communications parameter BHT_RF_SetParamStr Write string to the wireless communications parameter BHT_RF_GetInfoInt Read integer from the com...
Page 65: ...beeper vibrator on off and LED on off pwchCdParam in Heading address of the storage buffer for a character string specifying barcode types to be read Return value Error code Meaning ERROR_SUCCESS Suc...
Page 66: ...barcode data is not read out from the barcode buffer Ex BHT_EnableBar TEXT F TEXT A I 4 99 M 1 99 N 3 99 L 1 99 K 1 99 H 1 99 Alternate switching mode A If you press the trigger switch the illuminatio...
Page 67: ...s read successfully BHT_EnableBar TEXT FL TEXT A I 4 99 M 1 99 N 3 99 L 1 99 K 1 99 H 1 99 Readcode BHT 700B The BHT supports the universal product codes Interleaved 2of5 ITF Standard 2of5 STF Codabar...
Page 68: ...mum number of digits specified in the system menu BhtShell exe up to 99 digits If only max no digits is omitted the BHT can only read the number of digits specified by mini no digits CD is a check dig...
Page 69: ...ecified by mini no digits start and stop are the start and stop characters respectively Each of them should be an A B C or D If a question mark is specified it acts as a wild card The start and stop c...
Page 70: ...hen the default reading range is 1 to 99 digits If only max no digits is omitted the BHT can only read the number of digits specified by mini no digits CD is a check digit Specifying a C to CD makes t...
Page 71: ...its and max no digits are omitted then the default reading range is 1 to 99 digits If only max no digits is omitted the BHT can only read the number of digits specified by mini no digits Ex To enable...
Page 72: ...ts and max no digits are omitted then the default reading range is 1 to 99 digits If only max no digits is omitted the BHT can only read the number of digits specified by mini no digits Ex To enable t...
Page 73: ...ansfer it excluding the FNC2 character s 3 FNC3 If the BHT reads a barcode containing an FNC3 character s it will regard the data as invalid and transfer no data to the barcode buffer while it may dri...
Page 74: ...If only max no digits is omitted only the number of digits specified by mini no digits can be read CD is a check digit Specifying a C to CD makes the Interpreter check barcodes with MOD 10 The check...
Page 75: ...mini no digits CD is a check digit Specifying a C1 or C2 to CD makes the Interpreter check barcodes with a single digit or two digit CD respectively If no CD is specified the Interpreter checks barcod...
Page 76: ...ossible ranges by symbol type Allowable range of code version Symbol type 1 4 S 1 22 M 1 40 L The minimum and maximum code versions must satisfy the following relationship Minimum code version Maximum...
Page 77: ...imes signaling the end of the split code scanning mode All split codes belonging to a QR code must be read no matter what sequence it may be Once read a split code cannot be read again until all the o...
Page 78: ...ing relationship min code no max code no If you omit both the minimum and maximum code numbers you can read DataMatrix codes of a full range up to the maximum allowable of code numbers for each symbol...
Page 79: ...g the country flag and must be a numeral 0 through 9 each A question mark serves as a wild card supplemental refers to the reading of an add on code Specifying S as supplemental enables the BHT to rea...
Page 80: ...If you omit only the maximum number of digits the BHT can read only barcodes of the length specified by min no digits CD represents the check digit If you specify C the barcode will be checked accordi...
Page 81: ...read only barcodes of the length specified by min no digits startstop means the start character and the stop character Specify A B C or D A question mark serves as a wild card The start and stop chara...
Page 82: ...99 inclusive If you omit only the maximum number of digits the BHT can read only barcodes of the length specified by min no digits CD represents the check digit If you specify C the barcode will be c...
Page 83: ...ble the BHT to scan Code 93 with min no digits 6 and max no digits 12 BHT_EnableBar TEXT FL TEXT L 6 12 Ex To enable the BHT to scan Code 93 with min no digits 6 and max no digits 10 or min no digits...
Page 84: ...lengths are between 1 and 99 inclusive If you omit only the maximum number of digits the BHT can read only barcodes of the length specified by min no digits The start character the stop character and...
Page 85: ...ter will be stored into the barcode buffer 3 FNC3 If a barcode contains an FNC3 character the read data will be regarded as invalid and will not be stored into the barcode buffer When the indicator LE...
Page 86: ...the case of Codabar Ex Reading 3 rows of ITF with character specification in the following sequence code beginning with 12 code with CD beginning with 21 of 6 10 digits in length and code beginning w...
Page 87: ...eading the BHT cannot read the single row code Ex If you have a single row EAN 13 code 4901234567894 and a two row EAN 13 code consisting of 4909876543214 in the first row and 1200000000003 in the sec...
Page 88: ...lose the barcode device file to disable barcode reading Syntax DWORD BHT_DisableBar void Parameters None Return value Error code Meaning ERROR_SUCCESS Successful completion ERROR_INVALID_HANDLE Barcod...
Page 89: ...rror ERROR_INVALID_HANDLE will result Syntax DWORD BHT_ReadBar TCHAR pwchBuffer DWORD dwBarLen DWORD pdwActualBarLen Parameters pwchBuffer out Heading address of the storage buffer storing the read da...
Page 90: ...LPVOID lpBuffer DWORD dwBarLen DWORD pdwActualBarLen Parameters dwDataType in Encoding format READ_CODE_BINARY binary data no encoding READ_CODE_UNICODE unicode data lpBuffer in Starting address of t...
Page 91: ...mposite code is returned To get the information for a specific row call BHT_GetBarInfo Syntax DWORD BHT_GetBarType DWORD pdwBarMark DWORD pdwBarlen Parameters pdwBarMark out Address for storing the ba...
Page 92: ...composite code is obtained Syntax DWORD BHT_GetBarInfo ST_CODE_INFO pstInfo DWORD pdwCodeNum Parameters pstInfo out Destination address into which the code information is to be stored pdwCodeNum in No...
Page 93: ...ed an error ERROR_INVALID_HANDLE will result Syntax DWORD BHT_GetBarNum DWORD pdwCodeNum Parameters pdwCodeNum out Address for storing the barcode length Return value Error code Meaning ERROR_SUCCESS...
Page 94: ...calculation method Barcode Type dwCDType Calculation Method EAN JAN UPC A MOD10 Modulo arithmetic 10 ITF I MOD10 Modulo arithmetic 10 STF only for BHT 700B H MOD10 Modulo arithmetic 10 CODABAR NW 7 N...
Page 95: ...ut of the specification of EAN or UPC so dwChkDgt is 0 and the function returns an error code Ex 2 BHT_GetBarChkDgt TEXT 4940045X A dwChkDgt X is out of the specification but it is a CD position chara...
Page 96: ...BHT_GetBarChkDgt function as shown below If the returned value is equal to the CD the CD data is suitable for the barcode data Ex BHT_GetBarChkDgt TEXT 49400458 A dwChkDgt if dwChkDgt 8 printf CD OK T...
Page 97: ...D the CD data is suitable for the barcode data Ex BHT_GetBarChkDgt TEXT 123457 I dwChkDgt if dwChkDgt 7 printf CD OK To add a CD to barcode data Pass barcode data followed by a dummy character to the...
Page 98: ...suitable for the barcode data Ex BHT_GetBarChkDgt TEXT 12345678905 H dwChkDgt if dwChkDgt 5 printf CD OK To add a CD to barcode data Pass barcode data followed by a dummy character to the BHT_GetBarCh...
Page 99: ...rChkDgt TEXT a0123 a M dwChkDgt if dwChkDgt printf CD OK To add a CD to barcode data Pass barcode data followed by a dummy character to the BHT_GetBarChkDgt function as shown below The returned value...
Page 100: ...l to the CD the CD data is suitable for the barcode data Ex BHT_GetBarChkDgt TEXT CODE39W M dwChkDgt if dwChkDgt W printf CD OK To add a CD to barcode data Pass barcode data followed by a dummy charac...
Page 101: ...qual to the CD the CD data is suitable for the barcode data Ex BHT_GetBarChkDgt TEXT 123456782 P dwChkDgt if dwChkDgt 2 printf CD OK To add a CD to barcode data Pass barcode data followed by a dummy c...
Page 102: ...ionsEAN8 ST_DCD_EAN8_OPTIONS dwLen in pOptions size bytes Sets the value calculated at Sizeof Return value Error code Meaning ERROR_SUCCESS Successful completion ERROR_INVALID_PARAMETER The storage ad...
Page 103: ...Details bConvertToEAN13 FALSE Used to convert TRUE or not convert FALSE to EAN 13 Notes Authorize reading of the code type prior to conversion when authorizing code reading with BHT_EnableBar The val...
Page 104: ..._EAN8_OPTIONS pdwLen in pOptions size bytes Sets the value calculated at sizeof out Size of valid data stored in pOptions bytes Return value Error code Meaning ERROR_SUCCESS Successful completion ERRO...
Page 105: ...or not add FALSE a C D typedef struct _ST_DCD_EAN8_OPTIONS BOOL bConvertToEAN13 ST_DCD_EAN8_OPTIONS PST_DCD_EAN8_OPTIONS Member name Default Details bConvertToEAN13 FALSE Used to convert TRUE or not...
Page 106: ...s dwStatus Specification BHT_BL_ENABLE_ON 1 Turn on the backlight BHT_BL_ENABLE_OFF Turn off the backlight BHT_BL_DISABLE Disable the backlight 1 The backlight specified with the BHT_SetSysSettingDW B...
Page 107: ...us Parameters pdwStatus out Current backlight status pdwStatus Specification BHT_BL_ENABLE_ON Backlight ON BHT_BL_ENABLE_OFF Backlight OFF BHT_BL_DISABLE Backlight enabled Return value Error code Mean...
Page 108: ...3 9 V Voltage BHT_BATTERY_FLAG_MID Medium level 3 7 V Voltage 3 9 V BHT_BATTERY_FLAG_LOW Low level 3 6 V Voltage 3 7 V BHT_BATTERY_FLAG_WARNING Warning level Voltage 3 6 V BHT_BATTERY_FLAG_CRITICAL Cr...
Page 109: ...Y_FLAG_NO_BATTERY No battery loaded or no grip connected pwBatteryVoltage out Battery output voltage mV 0 is always returned pwBatteryChemistry out Battery type pwBatteryChemistry Specification BATTER...
Page 110: ...rameters pdwInfo out Address for storing the LED status pdwInfo Specification LED_OFF Both red and blue LEDs OFF RED_LED_ON Red LED ON GREEN_LED_ON Blue LED ON RED_LED_ON GREEN_LED_ON Both red and blu...
Page 111: ...urn on both red and blue LEDs Return value Error code Meaning ERROR_SUCCESS Successful completion ERROR_INVALID_PARAMETER Parameter error Notes When the barcode device file is opened by the BHT_Enable...
Page 112: ...Device Specification LED_BAR Indicator LED pdwStatus out Address for storing the LED status Specification pdwStatus If dwLedDevice LED_BAR RED_LED_ON Red LED ON Blue LED OFF GREEN_LED_ON Blue LED ON R...
Page 113: ...Blue LED RED_LED GREEN_LED Red and blue LEDs Return value Error code Meaning ERROR_SUCCESS Successful completion ERROR_INVALID_PARAMETER Parameter error Notes When the barcode device file is opened b...
Page 114: ...ned off Specification dwLedNum If dwLedDevice LED_BAR RED_LED Red LED GREEN_LED Blue LED RED_LED GREEN_LED Red and blue LEDs Return value Error code Meaning ERROR_SUCCESS Successful completion ERROR_I...
Page 115: ...Time in OFF duration in units of 100 ms Entry range 0 to 255 wRepCnt in Number of repetitions Entry range 0 to 255 wFreq in Frequency Hz Entry range 0 to 32767 Specification of 0 1 or 2 to wFeq produc...
Page 116: ...of a value except zero to dwOnTime and wRepCnt and specification of zero to dwOffTime keep the beeper sounding For your reference the relationship between the frequencies and the musical scale is lis...
Page 117: ...duration in units of 100 ms Entry range 0 to 255 wRepCnt in Number of repetitions Entry range 0 to 255 wFreq in Frequency Hz Entry range 0 to 32767 Specification of 0 1 or 2 to wFeq produces the speci...
Page 118: ...of a value except zero to dwOnTime and wRepCnt and specification of zero to dwOffTime keep the beeper sounding For your reference the relationship between the frequencies and the musical scale is lis...
Page 119: ...WORD wRepCnt Parameters dwOnTime in ON duration in units of 100 ms Entry range 0 to 255 dwOffTime in OFF duration in units of 100 ms Entry range 0 to 255 wRepCnt in Number of repetitions Entry range...
Page 120: ...ne Return value Error code Meaning ERROR_SUCCESS Successful completion ERROR_DEV_NOT_EXIST No NIC device found ERROR_SHARING_VIOLATION Bluetooth device is opened Remarks Wireless LAN and Bluetooth dev...
Page 121: ...en COMM_CONTINUOUS Wireless communication continuously open Return value Error code Meaning ERROR_SUCCESS Successful completion ERROR_DEV_NOT_EXIST No NIC device found ERROR_INVALID_PARAMETER Paramete...
Page 122: ...RF_Close Description Close the wireless LAN device and disable wireless communication Syntax DWORD BHT_RF_Close void Parameters None Return value Error code Meaning ERROR_SUCCESS Successful completion...
Page 123: ...n Syntax DWORD BHT_RF_CloseEx DWORD dwOpt Parameters dwOpt in Communication format dwOpt Specification COMM_NORMAL Wireless communication open COMM_CONTINUOUS Wireless communication continuously open...
Page 124: ...ies values set at the ZeroConfig GUI to the BHT wireless registry referenced by the wireless driver 2 Updates values set at this API to ZeroConfig lpInBuf in Header address for buffer in which input d...
Page 125: ...f DWORD ST_RF _PROFILE_KEY ST_RF_PROFILE _KEY size 3 Use ESSID and Infrastructure mode to specify the profile Create a new profile if no profile can be found corresponding to the specified ESSID and I...
Page 126: ...n status immediately and return the result 1 Try to synchronize with the access point until synchronized plSync out Address for storing the synchronization result plSync Specification 0 Successfully s...
Page 127: ...THENTICATE Authentication method dwData P_AUTH_OPEN P_AUTH_SHARED P_AUTH_WPA P_AUTH_WPAPSK P_AUTH_WPA2 P_AUTH_WPA2PSK P_INT_ENCRYPTION Encryption dwData P_ENCRYPT_DISABLE P_ENCRYPT_WEP P_ENCRYPT_TKIP...
Page 128: ...Return value Error code Meaning ERROR_SUCCESS Successful completion ERROR_INVALID_PARAMETER Parameter error Address for storing data obtained not specified ERROR_NOT_SUPPORTED Not supported 123...
Page 129: ...DIOMODE_11B P_RADIOMODE_11G P_INT_AUTHENTICATE Authentication method dwData P_AUTH_OPEN P_AUTH_SHARED P_AUTH_WPA P_AUTH_WPAPSK P_AUTH_WPA2 P_AUTH_WPA2PSK P_INT_ENCRYPTION Encryption dwData P_ENCRYPT_D...
Page 130: ...Return value Error code Meaning ERROR_SUCCESS Successful completion ERROR_INVALID_PARAMETER Parameter error Address for storing data obtained not specified ERROR_NOT_SUPPORTED Not supported 125...
Page 131: ...er dwParam Specification P_STR_VERSION Driver version P_STR_FW_VERSION Firmware version P_STR_MACADDRESS MAC address pwchData out Heading address of the storage buffer for data obtained pdwLen out Len...
Page 132: ...Parameters dwParam in Parameter number dwParam Specification P_STR_WEPKEY1 WEP Key 1 P_STR_PRESHAREDKEY Pre Shared Key pwchData in Heading address of the storage buffer for data specified dwLen in Len...
Page 133: ...ps P_RATE_2MBPS 5 5Mbps P_RATE_5_5MBPS 11Mbps P_RATE_11MBPS Above 11Mbps P_RATE_OVER11MBPS P_RATE_INFO2 Current communication speeds Units 100bps Ex 5 5Mbps 55 000 11Mbps 110 000 54Mbps 540 000 P_CHAN...
Page 134: ...rmation to be read out dwType Specification P_APMAC_INFO MAC address of AP being linked pwchInfo out Heading address of the storage buffer for info read Return value Error code Meaning ERROR_SUCCESS S...
Page 135: ...pdwLink Specification LQ_UNSYNC Not associated LQ_POOR Poor communications link less than 26 LQ_FAIR Fair communications link 26 or more and less than 42 LQ_GOOD Good communications link 42 or more an...
Page 136: ...g the OS reconfiguration filename dwMode in Reboot mode after turning the power off dwMode Specification SYSMDFY_POWEROFF Turn the power off Cold boot the BHT at the next power on SYSMDFY_REBOOT Perfo...
Page 137: ...ror code Meaning ERROR_SUCCESS Successful completion ERROR_DEV_NOT_EXIST The unit is not equipped with a Bluetooth device ERROR_SHARING_VIOLATION Wireless LAN device is opened Remarks Wireless LAN and...
Page 138: ...luetooth device power supply and disables Bluetooth Syntax DWORD BHT_BT_PowerOff void Parameters None Return value Error code Meaning ERROR_SUCCESS Successful completion ERROR_DEV_NOT_EXIST The unit i...
Page 139: ...address The following values are returned for the device status pdwStatus Specification BHT_BT_POWER_ON The Bluetooth device power is ON BHT_BT_POWER_OFF The Bluetooth device power is OFF Return value...
Page 140: ...RS232C Data reception Serial interface EVT_MASK_RECEIVE_USB Data reception USB interface NOTE ORing these events enables the BHT to wait for the two or more events dwTimeOut in Timeout period ms pdwSi...
Page 141: ...ception in IrDA interface Serial interface USB interface Specifying two or more events concurrently using this function allows the system to wait for occurrence of any of these events To wait for othe...
Page 142: ...A interface EVT_MASK_RECEIVE_RS232C Data reception Serial interface EVT_MASK_RECEIVE_USB Data reception USB interface pdwSignalEvent out Address for storing events that occurred pdwSignalEvent Specifi...
Page 143: ...release Decoding completion Data reception in IrDA interface Serial interface USB interface Unlike BHT_WaitEvent this function lets the CPU enter the standby mode when making the system wait reducing...
Page 144: ...uence and restored at the cold boot BHT_PWR_SYSMODIFY A cold boot is performed automatically after turning OFF the power With the BHT 700 this is the same as BHT_PWR_COLD BHT_PWR_COLD A cold boot is p...
Page 145: ...T_RegStore Description Save the registry Syntax DWORD BHT_RegStore void Parameters None Return value Error code Meaning ERROR_SUCCESS Successful completion ERROR_WRITE_FAULT Failed to save registry 14...
Page 146: ...nstallation 1 Copy the ocx files in the BHT 700 Software Development Kit CD onto the appropriate folder of your PC 2 Open the DOS command prompt and change the directory to the folder including the oc...
Page 147: ...choose the newly installed OCX by clicking Open 2 3 Click OK and the control is pasted as shown below 3 Add the control to the project 3 1 Click Project Add to Project Components and Controls on the m...
Page 148: ...mponent pops up Click OK and specify an appropriate class name header filename and implement filename 3 4 If OK is clicked an icon of the added control will be added to the dialog as shown below red c...
Page 149: ...g R 0 GetLastCount SetLastCount 5 long R 0 Number of digits in the barcode read last GetLastType SetLastType 5 long R 0 Barcode type read last GetLastCodeNum 6 long R 0 No of barcodes read last 7 GetE...
Page 150: ...ified calculation method Refer to the BHT_GetBarChkDgt function Syntax long GetChkDigit TCHAR BarData short ChkDgtType Parameters BarData in Character string of the barcode ChkDgtType in Check digit t...
Page 151: ...t recently Syntax long GetLastCount long CodeNo Parameters CodeNo in Row number for which you wish to get the number of digits starting with 0 for the first row Return value No of digits in the row sp...
Page 152: ...st recently Syntax long GetLastType long CodeNo Parameters CodeNo in Row number for which you wish to get the code type starting with 0 for the first row Return value Code type in the row specified in...
Page 153: ...Function DecodeDone Description This function is called when decoding is successfully completed It reads out the bufferData property to get data decoded Syntax void OnDecodeDone void Parameters None...
Page 154: ...en flag is FALSE BufferData ERROR_INVALID_HANDLE Barcode reading disabled GetChkDigit ERROR_INVALID_PARAMETER Check digit type out of the range or invalid barcode data 17 4 5 Coding Sample Initialize...
Page 155: ...bsolute path starting with sign Folder to store send files Folder to store receive files GetTransferring EventInterval SetTransferring EventInterval long R W 0 to 2147483647 0 Transferring Event inter...
Page 156: ...e Send Transmit a file specified by AddFile Receive Receive a file Abort Abort the current file transmission process GetState Get the current file transmission status GetError Return the error informa...
Page 157: ...f the specified Index character string with length 0 when the Index lies outside the range GetFileCount Description At the transmission side returns the number of transmitted files and at the receipt...
Page 158: ...receipt is complete Syntax void GetTransferredCount void Parameter None Return Values Transmission side Number of files for which transmission is complete Receipt side Number of files for which recei...
Page 159: ...T_FOUND Specified file or device not found ERROR_NO_MORE_FILES No send file found No file added by AddFile ERROR_BAD_PATHNAME Path too long Path filename 260 characters Receive Description Receive a f...
Page 160: ...t will occur Syntax Void Abort void Parameters None Return value None GetState Description Get the current file transmission status Syntax short GetState void Parameters None Return value Error code M...
Page 161: ...tError Description Return the error information for the transaction processed last Syntax long GetError void Parameters None Return value Code of an error that occurred during processing of methods 15...
Page 162: ...ansmission ends as specified Syntax void OnDone long Result Parameters Result out End code listed in the table below Result Meaning RROR_SUCCESS Succeeded ERROR_TIMEOUT Timeout ERROR_OPERATION_ABORTED...
Page 163: ...being transmitted Syntax void OnTransferring LPCTSTR FileName long Total long Transferred Parameters FileName out Name of file being transmitted Total out Size of file being transmitted Transferred o...
Page 164: ...ansmission Start upload void CSerialTransferDlg OnUpload m_clFileTransfer SetPath TEXT My Documents Set a filepath for the work file m_clFileTransfer AddFiles TEXT File1 dat Transmission file 1 m_clFi...
Page 165: ...ode Normal status SCAN 2 ESC 1 3 BS SF 4 6 FN 7 9 AL SP ENT 5 8 0 F1 F2 F3 F4 TAB M2 SCAN M1 M3 SCAN Status with SF pressed SCAN ESC BS SF FN AL SP ENT F1 F2 F3 F4 M1 TAB SCAN SCAN M3 M2 SCAN ABC ESC...
Page 166: ..._8 38 38 8 2A 7 VK_7 37 37 7 26 6 VK_6 36 36 6 5E 5 VK_5 35 35 5 25 4 VK_4 34 34 4 24 3 VK_3 33 33 3 23 2 VK_2 32 32 2 40 1 VK_1 31 31 1 21 0 VK_0 30 30 0 29 VK_PERIOD BE 2E 3E SP VK_SPACE 20 20 ESC V...
Page 167: ...4 BF 2F 3 BB 3D 2 BA 3B 1 VK_SPACE 20 20 SPACE 0 DD 5D BC 2C SP VK_SPACE 20 20 SPACE ESC VK_ESCAPE 1B 1B SF VK_CAPITAL 14 FN VK_FUNC D2 AL VK_ALP D0 BS VK_BACK 08 08 ENT VK_RETURN D0 SCAN VK_SCAN D1 T...
Page 168: ...to be pressed the number of depressions and character codes Depre ssion Key 1st 2nd 3rd 4 th 5 th 6 th 7 th 8th 9th 0 blank 1 1 1 2 A B C a b c 1 3 D E F d e f 1 4 G H I g h i 1 5 J K L j k l 1 6 M N...
Page 169: ...x y SF FN NUM BS SP ESC ENT Normal status SCAN A F1 F2 F3 F4 M TAB SCAN SCAN M3 M2 B C D E F G H I J K L M N O P Q R S T U V W X Y Z SF FN BS SP NUM ESC ENT Status with SF pressed SCAN F1 F2 F3 F4 TA...
Page 170: ...3 Function mode SCAN F5 F6 F7 F8 SEND M2 SCAN M1 M3 SCAN CAP FN NUM BS SP ESC ENT F9 F10 F11 F12 165...
Page 171: ...49 49 I I J VK_J 4A 4A J J K VK_K 4B 4B K K L VK_L 4C 4C L L M VK_M 4D 4D M M N VK_N 4E 4E N N O VK_O 4F 4F O O P VK_P 50 50 P P Q VK_Q 51 51 Q Q R VK_R 52 52 R R S VK_S 53 53 S S T VK_T 54 54 T T U V...
Page 172: ...LASH DC 7C N VK_APOSTROPHE DE 22 O VK_LBRACKET DB 7B P VK_RBRACKET DD 7D Q VK_7 37 7 26 R VK_8 38 8 2A S VK_9 39 9 28 T VK_EQUAL BB 2B U VK_SLASH BF 3F V VK_SEMICOLON BA 3A W VK_COMMA BC 3C X VK_PERIO...
Page 173: ...L M N O P Q R S T U V W X Y Z SF VK_CAPITAL 14 FN VK_FUNC D2 NUM D4 VK_NUM BS VK_BACK 08 08 SP VK_SPACE 20 20 ESC VK_ESCAPE 1B 1B ENTER VK_RETURN 0d 0d TAB VK_TAB 09 09 SCAN VK_SCAN D1 M1 VK_M1 1 C1...
Page 174: ...ported No of keys 27 key 42 key 30 key 50 key Magic keys M1 M2 M3 M1 M2 M3 M4 M5 Laser key Not supported Magic key assignment possible Functions assignable to SCAN key Trigger fixed Same as magic keys...
Page 175: ...ination CODE 93 Reading possible Reading not possible BHT 202Q Code reading 2D Illumination mode Selection from Auto Always ON or Always OFF Not supported Calling the BHT_SysModify function after savi...
Page 176: ...e development of application programs for the BHT 700 Please feel free to send your comments regarding any errors or omissions you may have found or any suggestions you may have for generally improvin...
