Denso BHT-700-CE User manual

A
PI Reference Manual
Barcode Handy Terminal
BHT-70
0
-C
E

Copyright © DENSO WAVE INCORPORATED, 2007
All rights reserved. No part of this publication 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 in this manual are trademarks or registered trademarks of their
respective holders.

Contents
Chapter 1. Software Requirements for the BHT-700 ...................................................................................... 1
1.1. Operating System (OS) on the BHT-700.......................................................................................... 1
1.2. Application Development Software on the PC.................................................................................. 1
1.2.1. Application Development Tool ...................................................................................................... 1
1.2.2. Software Development Kit ............................................................................................................ 1
Chapter 2. Application Development Environment ......................................................................................... 2
2.1. Required Hardware (PC to be used for application development) ................................................... 2
2.2. Required Software ........................................................................................................................... 2
2.3. Installation ........................................................................................................................................ 2
Chapter 3. Output to the LCD Screen............................................................................................................. 3
3.1. Screen Fonts.................................................................................................................................... 3
3.2. Screen Rotation ............................................................................................................................... 3
3.2.1. Setting the Screen Rotation Control Key ...................................................................................... 3
3.3. Setting the Screen Rotation Angle ................................................................................................... 4
Chapter 4. Backlight Control........................................................................................................................... 5
4.1. Outline.............................................................................................................................................. 5
4.2. Setting the Backlight Function On/Off Key ....................................................................................... 5
4.3. Setting the Backlight Illumination Time............................................................................................. 6
4.4. Setting the Backlight Brightness and Power Saving Mode............................................................... 6
4.5. Controlling the Backlight with the Backlight Control Key .................................................................. 7
4.6. Controlling the Backlight with the Backlight Control Function........................................................... 8
4.7. Key Backlight ................................................................................................................................... 9
Chapter 5. Beeper and Vibrator Control ....................................................................................................... 10
5.1. Outline............................................................................................................................................ 10
5.2. Setting the Beeper/Vibrator ............................................................................................................ 11
5.3. Starting/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. Setting the Keys and Trigger Switch .............................................................................................. 14
6.3. Shift Key Operation Mode .............................................................................................................. 15
6.4. Magic Key Control.......................................................................................................................... 15
6.5. Assigning a User-Defined Key Code to the Magic Keys ................................................................ 16
6.5.1. Assignment Method .................................................................................................................... 16
6.5.2. User-Defined Code Settings File (MKeyDef.txt).......................................................................... 16
6.6. Key Input Modes ............................................................................................................................ 17
6.6.1. Numeric Entry Mode ................................................................................................................... 17
6.6.2. Alphabet Entry Mode 1 (27 key pad) .......................................................................................... 17
6.7. Function Mode ............................................................................................................................... 20
6.8. Key Clicks ...................................................................................................................................... 20
6.9. Acquisition of Keypad Type............................................................................................................ 20
6.10. Auto Repeat Function .................................................................................................................... 21
Chapter 7. LCD Status Indication ................................................................................................................. 22
7.1. Outline............................................................................................................................................ 22
7.2. Setting the LCD Status Indication .................................................................................................. 23
Chapter 8. Power Management.................................................................................................................... 24
8.1. Outline............................................................................................................................................ 24
8.2. Standby .......................................................................................................................................... 25
8.2.1. Switching to the Standby State ...................................................................................................... 25
8.2.2. Standby Transition Prohibited Events ............................................................................................ 25
8.2.3. Setting the Standby Transition Timeout ......................................................................................... 25
8.3. Suspend ......................................................................................................................................... 26
8.3.1. Setting the Standby Transition Timeout ......................................................................................... 26
8.3.2. Suspend Transition Prohibited Events ........................................................................................... 26
8.3.3. Setting the Auto Power-off Timeout ............................................................................................... 26
8.3.4. Setting the Effective Held-down Time of the Power Key for Switching to the Suspend State ........ 26
Chapter 9. Battery State ............................................................................................................................... 27

9.1. Outline............................................................................................................................................ 27
9.2. Battery Voltage Acquisition ............................................................................................................ 27
9.3. Battery Voltage Icon....................................................................................................................... 27
9.4. Battery Voltage Warning ................................................................................................................ 27
Chapter 10. LED ......................................................................................................................................... 28
10.1. Outline............................................................................................................................................ 28
10.2. LED Control.................................................................................................................................... 28
10.2.1. Display LED ................................................................................................................................. 28
10.2.2. Charge LED ................................................................................................................................. 28
Chapter 11. Data Communication............................................................................................................... 29
11.1. Outline............................................................................................................................................ 29
11.2. Programming for Data Communication .......................................................................................... 29
11.3. Assigning Port Number .................................................................................................................. 29
11.4. ActiveSync ..................................................................................................................................... 30
11.4.1. Establishing an ActiveSync Connection ....................................................................................... 30
11.4.2. ActiveSync Auto Connection Setting Method............................................................................... 30
Chapter 12. Wireless Communication......................................................................................................... 31
12.1. Outline............................................................................................................................................ 31
12.1.1. Spread Spectrum Communications Method ............................................................................ 31
12.1.2. Configuration of Spread Spectrum System ............................................................................. 31
12.2. Programming for Wireless Communication .................................................................................... 32
12.2.1. Wireless Communication Parameters ..................................................................................... 33
12.2.2. Opening and Closing the Wireless Communications Device................................................... 36
12.2.3. Checking Synchronization with the Access Point .................................................................... 37
Chapter 13. Barcode Reading..................................................................................................................... 38
13.1. Outline............................................................................................................................................ 38
13.1.1. Enable Reading....................................................................................................................... 38
13.1.2. Specify Options in the BHT_EnableBar 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.............................................................................. 42
13.2.5. Controlling the Indicator LED and Beeper/Vibrator as a Confirmation of Successful Reading 43
13.2.6. Reading Split QR Codes (Only for BHT-700Q) ....................................................................... 43
13.3. Barcode Reading Using the Virtual COM Port ............................................................................... 44
13.3.1. Outline..................................................................................................................................... 44
13.3.2. Programming........................................................................................................................... 44
13.3.3. How to Use.............................................................................................................................. 44
Chapter 14. Updating OS............................................................................................................................ 45
Chapter 15. System Functions.................................................................................................................... 46
15.1. If a System Parameter Value is DWORD ....................................................................................... 47
15.2. If a System Parameter Value is a Character String........................................................................ 49
15.3. System Parameter Values That Can be Set/Obtained ................................................................... 51
15.4. Device Information Acquisition ....................................................................................................... 57
Chapter 16. Device Control Functions ........................................................................................................ 58
16.1. Barcode API ................................................................................................................................... 60
16.2. Backlight API................................................................................................................................ 101
16.3. Battery API ................................................................................................................................... 103
16.4. LED API ....................................................................................................................................... 105
16.5. Beeper/Vibrator API ..................................................................................................................... 110
16.6. Wireless Communication API....................................................................................................... 115
16.7. OS Updating API.......................................................................................................................... 131
16.8. Bluetooth API ............................................................................................................................... 132
16.9. Other APIs ........................................................................................................................................ 135
Chapter 17. Programming Using OCX (OLE Customer Control) .............................................................. 141
17.1. System Requirements.................................................................................................................. 141
17.2. Installation .................................................................................................................................... 141
17.3. Using OCX ................................................................................................................................... 141
17.4. Scanner Control ........................................................................................................................... 144

17.4.1. Properties .............................................................................................................................. 144
17.4.2. Methods................................................................................................................................. 145
17.4.3. Event Callback Function........................................................................................................ 148
17.4.4. Error Codes ........................................................................................................................... 149
17.4.5. Coding Sample...................................................................................................................... 149
17.5. File Transfer Control .................................................................................................................... 150
17.5.1. Properties .............................................................................................................................. 150
17.5.2. Methods................................................................................................................................. 151
17.5.3. Event Callback 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 Character Codes .................................................................................. 161
A.1.3. Character Codes in Alphabet Entry Mode................................................................................. 163
A.2. 42-key pad ................................................................................................................................... 164
A.2.1. Keyborard Arrangement............................................................................................................ 164
A.2.2. Virtual Key Codes and Character Codes .................................................................................. 166
Appendix B. Differences between Older Unit............................................................................................. 169

Chapter 1. Software Requirements for the BHT-700
1.1. Operating System (OS) on the BHT-700
The OS running on the BHT-700 is Microsoft Windows CE 5.0.
1.2. Application Development Software on the PC
1.2.1. Application Development Tool
The application development tool for the BHT-700 is Microsoft eMbedded Visual C++ 4.0 (Service Pack
4)
1.2.2. Software Development Kit
The BHT-700 Software Development Kit provides the application development environment for Windows
CE set up on the BHT-700. It includes the following libraries:
(1) Help files
(2) Windows-CE standard 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 BHT-dedicated APIs, the BHTLIB.h should be included.
(5) BHT-dedicated library : BHTLIB.lib
• Includes BHT-dedicated barcode reading functions and device driver management functions.
• To use the BHT-dedicated APIs, the BHTLIB.lib should be linked.
(6) BHT-dedicated OCX files : Scanner700.ocx (for BHT-700B), Scanner700Q.ocx (for BHT-700Q),
FileTransfer700.ocx, and FileTransferPC.ocx (for PC)
• Include BHT-dedicated barcode scanning functions and file transfer functions.
• To use the BHT-dedicated OCX, Scanner700.ocx, Scanner700Q.ocx, and FileTransfer700.ocx
should be linked.
1

Chapter 2. Application Development Environment
2.1. Required Hardware (PC to be used for application development)
Item Specification
OS Microsoft Windows 2000 Professional with Service Pack 2 or higher,
or Microsoft Windows 2000 Server with Service Pack 2 or higher,
or Microsoft Windows XP Professional or higher.
PC With a Pentium-II class processor, 450 MHz or faster
For Microsoft Windows 2000 Professional or Microsoft Windows XP Professional:
96 MB or more (128 MB or more recommended)
Memory
For Microsoft Windows 2000 Server :
192 MB or more (256 MB or more recommended)
HDD 200 MB or more hard disk space
Display VGA or higher-resolution monitor.
A Super VGA (800 x 600 or larger) monitor is recommended.
2.2. Required Software
Application 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.com/downloads/details.aspx?FamilyID=1dacdb3d-50d1-41b2-a107-
fa75ae960856&DisplayLang=en
(Service Pack 4)
http://www.microsoft.com/downloads/details.aspx?FamilyID=4a4ed1f4-91d3-4dbe-986e-
a812984318e5&displaylang=en
APIs available for eMbedded Visual C++ are:
(1) Win32API
(2) Microsoft Foundation Class (MFC)
(3) Dedicated APIs (for device control or data entry from the BHT)
Software development kit: BHT700_XXX_SDK.msi
This should be embedded into Microsoft eMbedded Visual C++ 4.0 for use.
2.3. Installation
The Microsoft eMbedded Visual C++ 4.0 and BHT-700 software development kit should be installed to
an application development PC in this order. To install the development kit, run the BHT700_XXX.msi in
the BHT-700 Software Development Kit CD.
2

Chapter 3. Output to the LCD Screen
3.1. Screen Fonts
The BHT-700 has the following integrated screen fonts:
(1) Arial (ttf)
(2) Courier New (ttf)
(3) Tahoma (ttf)
(4) Time New Roman (ttf)
(5) Wingding (ttf)
If no screen font is specified, Tahoma applies automatically.
3.2. Screen Rotation
The screen can be rotated using either of the following methods.
(1) By pressing the screen rotation control key.
(2) By using 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.
Furthermore, the setting can be obtained using the
BHT_GetSysSettingDW (BHT_DISP_ROTATION_KEY,…) function.
The relationship between the settable screen rotation control keys and settings is outlined in the following
table.
Screen Rotation Control Key Set value Screen Rotation Control Key Set value
[M1] 0x00000201 [SF]+[M1] 0x00010201
[M2] 0x00000202 [SF]+[M2] 0x00010202
[M3] 0x00000203 [SF]+[M3] 0x00010203
3

3.3. Setting the Screen Rotation Angle
The settable rotation angles are 0°, 90°, 180°, and 270°. The direction is anti-clockwise.
The screen rotation angle can be set and read using the
BHT_SetSysSettingDW (DWORD dwCtrlCode,DWORD dwSysParam) and
BHT_GetSysSettingDW (DWORD dwCtrlCode,DWORD *pdwSysParam) functions, respectively.
Parameter Type R/W Control Code
(dwCtrlCode)
Parameter Value
(dwSysParam) Default Validation Timing
Screen
rotation
angle
DW R/W BHT_DISP
_ROTATION
DISP_ROTATION_0
: 0°
DISP_ROTATION_90
: 90°
DISP_ROTATION_180
: 180°
DISP_ROTATION_270
: 270°
DISP_ROTATION_0 Immediately
after setting
4

Chapter 4. Backlight Control
4.1. Outline
The backlight illumination and power saving modes can be controlled using either of the following
methods.
(1) The backlight can be controlled by pressing the backlight control key.
(2) The backlight can be controlled using the backlight control function (BHT_SetBltStatus).
The following backlight related setting items are also available.
(1) Backlight control key
(2) Backlight illumination time
(3) Backlight brightness
(4) Backlight power saving mode
Furthermore, the BHT-700 keypad is also equipped with a backlight (hereafter referred to as key
backlight) for which the following settings can be made.
(1) Illumination device (when BHT_SetBltStatus is called)
(2) Key backlight 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 assigning the backlight control function to the magic key.The
table below lists the relationship between the keys that act as a backlight function on/off key and the set
values in the BHT_SetSysSettingDW (BHT_BACKLIGHT_KEY...) function.
If no key is specified as a backlight function on/off key, the combination of the SF key and M3 key works
as a backlight function on/off key by default.
Backlight control key Set value Backlight control key Set value
[M1] 0x00000201 [SF]+[M1] 0x00010201
[M2] 0x00000202 [SF]+[M2] 0x00010202
[M3] 0x00000203 [SF]+[M3] 0x00010203
[Ex]
Execute function BHT_SetSysSettingDW (BHT_BACKLIGHT_KEY, 0x00010201) when assigning a
simultaneous combination of the [SF] and [M1] keys to the backlight control key.
5