Chapter 2. Prerequisites Skills Required Hardware Required Software Required Chapter 3. Installing BDK to PC Application Development Installing CASIO BDK Files Chapter 4. Connecting Power Supply to Cradle HA-K60IO HA-K62IO Chapter 5. Connecting the DT-X8 to PC ActiveSync Connection via USB 5.1.1...
Page 3
Ltd. in Tokyo Japan. Information in this document is subject to change without advance notice. CASIO Computer Co., Ltd. makes no representations or warranties with respect to the contents or use of this manual and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose.
Editorial Record Manual Version Date edited Page Content 1.00 January 2011 Original version 1.01 February 2011 In Chapter 8.2, description about sample is deleted. In Chapter 8.3, description about sample is deleted. In Chapter 2.2, HA-F21LBAT-A option is deleted. 1.02 March 2011 OS description name is updated.
This guide clearly and concisely sets out the information developers need to know to get started with ® the CASIO DT-X8 series handheld terminals with the integrated Windows Embedded CE OS development. The best methods of connecting to your development system are covered and step by step instructions for installing and testing the CASIO BDKs are included.
The DT-X8 has been designed using the new concept of the Human-centered Design Processes and is capable of performing a wide variety of powerful functions. The following is a brief overview of the features available on the DT-X8 series handheld terminals. For further detail on the hardware specifications, refer to DT-X8 Series Hardware Manual.
1.2 Library Configuration The DT-X8 Software Development Kit (“BDK”) provides various libraries including those listed in the table. Table 1.1 Library Description System Library Library that is used to control the system. Laser Scanner Library Library that is used to control the built-in laser scan engine. Bluetooth Library Library that is used to control the built-in Bluetooth module.
1.3 Development Manuals The DT-X8 Software Development Kit (“BDK”) provides various development reference manuals as described in the table below. Table 1.3 Development Manual Description Quick Start Guide This reference manual. Software Manual Reference manual that describes software specifications in detail for all the software integrated in DT-X8 handheld terminal.
2. Prerequisites 2.1 Skills Required The following skills are required by developers aiming to develop application software for the DT-X8 terminal. Windows programming A good knowledge of one or more of the following - Visual C++ - Visual Basic .NET - Visual C# .NET - Browser based applications (not covered in this guide) The following skills or experience are also desirable.
2.2 Hardware Required The following models of the DT-X8 series and dedicated options are available. Table 2.1 List of available models WLAN Model no. Scanner Extension slot Bluetooth (802.11 b/g) DT-X8-10E Laser microSD DT-X8-10C-CN Laser microSD DT-X8-20E Imager microSD DT-X8-20C-CN...
Page 11
External views of the DT-X8 and the dedicated options Figure 2.1...
Microsoft Windows Mobile Device Center 6.1 (for Windows Vista) Download for free from; http://www.microsoft.com/downloads/details.aspx?familyid=46F72DF1-E46A-4A5F-A791-09F 07AAA1914&displaylang=en CASIO DT-X8 BDK Download the DT-X8 BDK from; http://www2.casio.co.jp/system_en/pa/PADealer/ (The site requires your user name and password. Enter your user name and password as issued by CASIO.)
2005. For detail, refer to Chapter 2.3 “Software Required”. 2. Installing CASIO BDK to PC Install Casio’s BDK (“Basic Development Kit”) and various libraries if necessary. For installation method, refer to Chapter 3.2 “Installing CASIO BDK Files”. 3. Connecting DT-X8 to PC (via either ActiveSync or Windows Mobile Device Center) Connect the DT-X8 to PC via Microsoft’s ActiveSync (for Windows XP or any other OS before...
CD-ROM media. http://www2.casio.co.jp/system_en/pa/PADealer/ (The site requires your user name and password. Enter your user name and password as issued by CASIO.) Notes: If you had already installed DT-X8 BDK Ver. 1.xx, be sure to uninstall it before installing Ver.
Page 16
Installing ExportBDK 1. When the CASIO DT-X8 BDK CD-ROM is inserted in the drive of PC, the following menu screen appears automatically. Figure 3.1 2. Click Installation List in Figure 3.1. The installation screen appears. Figure 3.2 3. Click DT-X8 ExportSDK to display the Setup Wizard. Choose any one of the buttons in the...
Page 17
Microsoft Visual Studio 2005 Notes: 1. The Library header file (*.h) and the Import library file (*.lib) are installed in the following folder. C:\Program Files\CASIO\MBSYS\include : Header file C:\Program Files\CASIO\MBSYS\lib\ARMV4I : Import library file 2. The Class library DLL file (*.dll) is installed in the following folder.
4. Connecting Power Supply to Cradle 4.1 HA-K60IO Use the dedicated AC adaptor (AD-S15050B) for supplying power to the HA-K60IO USB Cradle. Ensure that you connect the AC adaptor to the cradle before starting communication between the DT-X8 and PC via the cradle. Follow the steps below to connect the power supply to the DT-X8 using the dedicated AC adaptor.
4.2 HA-K62IO Use the dedicated AC adaptor (AD-S42120B) for supplying power to the HA-K62IO Ethernet Cradle. Ensure that you connect the AC adaptor to the cradle before starting communication between the DT-X8 and PC via the cradle. Follow the steps below to connect the power supply to the DT-X8 using the dedicated AC adaptor.
5. Connecting the DT-X8 to PC To make connection establishment with PC, use one of the methods, depending on the OS your PC runs, described below. ActiveSync (for Windows XP or any other OS earlier) Use the ActiveSync to connect the DT-X8 to PC if the PC runs in Windows XP or other OS earlier than Windows XP.
Chapter 5.1.1. You already have the USB driver and ActiveSync in your development environment. If you do not yet have the cradle driver on your PC, download the USB driver files “wceusbsh.inf” and “wceusbsh.sys” from the CASIO web site and copy them to an appropriate folder.
5.1.1 Installing ActiveSync for the First Time 1. Install ActiveSync first. Run the ActiveSync ‘msi’ file. Figure 5.1 2. Click Install button. Figure 5.2...
Page 23
3. Pause the installation when the menu in Figure 5.3 is displayed; you have to install the driver at this point. Figure 5.3 4. Connect the USB cable to the PC and the other end to the USB Cradle and also the AC adaptor to the USB Cradle.
Page 24
8. Then, choose Install from a list or specific location [Advanced] radio button in the menu. Figure 5.5 9. Click Next > button. Figure 5.6...
Page 25
10. Choose Windows CE USB Devices icon. Figure 5.7 11. Click Have Disk… button. Figure 5.8 12. Click Browse… button. Select “wceusbsh.inf” from the folder you created in step 6. Figure 5.9...
Page 26
15. A menu might be displayed to prompt you to install “wceusbsh.sys”. This happens if “wceusbsh.sys” is not in the same folder as “wceusbsh.inf”. Download this file from the CASIO Web Site and follow the prompts to specify the location of “wceusbsh.sys”.
Page 27
16. Now the installation of the driver is finished. Figure 5.12 17. Now go back to the ActiveSync Installation Wizard that you left on the desktop. Click Next > button. Figure 5.13...
Page 28
18. Now the connection is established. You can choose either partnership option according to your needs. Then click Next > button. Figure 5.14 19. Now the connection is completed. You can start up Visual Studio and create a program and deploy it to the DT-X8.
5.1.2 If ActiveSync Is Already Installed This is the procedure if ActiveSync is already installed on the PC. You just need to let the PC recognize the DT-X8 and install the cradle driver as in steps 6 to 16 in Chapter 5.1.1. 1.
Page 30
3. On the DT-X8, in Control Panel, choose the PC Connection option. Confirm that PC Connection is set to “USB Default”. If not, choose ‘USB Default’ and tap OK button. Figure 5.18 4. When the DT-X8 is mounted on the USB Cradle, a menu to prompt to install the driver is displayed.
5.2 USB Connection via Windows Mobile Device Center To establish connection via USB interface with PC runs in Windows Vista, use Windows Mobile Device Center (“WMDC”). The DT-X8 with the factory-setting (default) does not support the WMDC. Follow the procedure below to change the setting on the DT-X8. Procedure Close all applications running on the DT-X8.
Page 32
(see Figure 5.20), and start up the DT-X8 again. The WMDC version 6.1 or later will support the connection establishment via USB interface. Any other versions of the WMDC earlier are not interoperable with Windows CE devices including the DT-X8 series.
5.3 Connection via WLAN To establish communication between the DT-X8 with the WLAN module integrated (see Table 2.1 for the applicable models) and PC via WLAN configuration, follow the steps, 1 to 6, below to set up a WLAN configuration on the DT-X8. After setting up the configuration, be sure to perform a site survey prior to starting communication via WLAN.
Page 34
2. Click Basic tab. Set up each parameter in the tab by referring to the descriptions for the parameters in Table 5.3. Figure 5.24 Table 5.3 Parameter Description SSID Enter the SSID of the network you want to connect to. Security Disable None.
Page 35
If EAP-TLS radio button in Authentication field is selected, click the EAP-Properties button that appears when selecting the EAP-TLS radio button to set the following settings. Table 5.5 Parameters in Description Default EAP-Properties screen User name Input a user name in alphanumeric (maximum 100 None alphanumeric).
Page 36
- Configure WLAN setting with settings extracted from the ini file. - Initiate NetSearch when tapping the icon in the task tray. WLANConfig, - Use both CASIO provided WLAN tool and NetUI MS tool. - Configure WLAN setting with settings extracted from the ini file.
Page 37
5. If OK button in the popup warning message (see Table 5.7 for description of NetUI/NetUI radio button) is clicked, the screen in Figure 5.27 appears. Click OK button to perform a reset on the terminal so that the setting takes effect. Figure 5.27 6.
5.4 Connection via Ethernet Cradle This chapter describes how to establish a high speed LAN connection on the WLAN non-integrated models with HA-K62IO Ethernet cradle. Follow the steps below: 1. Connect the dedicated AC adapter to the Ethernet cradle as described in Chapter 4.2. 2.
Page 39
6. The following TCP/IP screen appears. Set up all the parameters in IP Address and Name Servers tabs as required and click OK button. Figure 5.29 7. If the connection is established correctly, the icon ( ) in the Taskbar changes to ( ).
5.5 Accessing Shared Network Drive on Your LAN Assuming you have a valid network connection established, you can access shared drives on your PC from the File Explorer on the DT-X8. The following shows the steps to initiate this. Configure a network connection on the DT-X8. Double click My Computer.
5.6 Direct TCP/IP Connection from Visual Studio If you have a network connection to the DT-X8 (for example, via WLAN or the Ethernet cradle) then you can establish a direct link to the development PC without using ActiveSync. For Visual Studio 2005 1.
Page 42
9. Choose DT-X8 Device in the list of Devices: and click Connect button. The screen in Figure 5.31 if appear indicates the success of connection establishment. Figure 5.31...
6. Setting Up the Development Environment 6.1 Installing CAB Files 1. After installing the library files, the CAB files in Table 6.1 will be installed in the folder below. C:\Program Files\CASIO\MBSYS\CAB Table 6.1 Library CAB file Preinstalled System Library en_SystemLib.ARMV4I.CAB Laser Scanner Library en_OBReadLib.ARMV4I.CAB...
6.2 Visual Studio 2005 Follow the steps in Chapter 5 “Connecting the DT-X8 to PC” before checking the steps below to confirm that you can connect to the DT-X8 from Visual Studio 2005. 1. Establish connection with the DT-X8 via ActiveSync. 2.
The Device Emulator requires the software(s) listed below before installing the emulator. ActiveSync 4.2 or a later version (If required) http://www.microsoft.com/downloads/details.aspx?FamilyID=7269173a-28bf-4cac-a682-58d32 33efb4c&DisplayLang=en Visual Studio 2008 or Visual Studio 2005 (Required) CASIO DT-X8 BDK (Required) Standalone Device Emulator 3.0 (Optional. See notes 1 and 2.) http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=a6f6adaf-12e3-4 b2f-a394-356e2c2fb114 Notes: 1.
Page 46
Note 1 in the previous page, change the settings in "DT-X8.cdes" as follows. Before you change, the parameter in the file is as follows. others=/sharedfolder "C:\Documents and Settings\All Users\Application Data\CASIO\Emulator\Ctrl" /vmname "DT-X8 Emulator" Change the parameter to the one below. Be sure to describe the whole parameter in single one line.
5. If both Figure 7.2 and Figure 7.3 appear on your PC, you are ready to use the emulator. Note. If do not appear "DT-X8" in "CASIO Device Emulator", please execute "Add Device". If you use OS after Windows Vista, please execute "DevEmuLoader.exe" as administrator by referring "...
Page 48
environment or pseudo environment. However, actions carried out by the Simulator are not as alike to those performed by actual components but merely mimic them very closely.
7.3 Using the Device Emulator 7.3.1 DT-X8 Device Emulator The DT-X8 Device Emulator emulates various operations carried out by the actual DT-X8 device on the PC’s screen such as mouse operation, input on PC’s keyboard, displaying execution of applications, and operations by actual devices such as the scanner. Figure 7.4 shows an emulated DT-X8 device on the screen of a PC.
7.3.2 I/O Simulator The I/O Simulator simulates registration of bar codes, generation of low battery warning, detection of terminal being mounted on the cradle. Registration of bar code symbologies Registration Click ADD1D or ADD2D button (circled in red in Figure 7.4) to go into the bar code registration mode.
Page 51
Registration of bar code and note Enter bar code data in the Code field (see Figure 7.7) and a note about the bar code in the Note field if necessary. Click OK button to complete the bar code registration. Figure 7.7 Completion of registration After completion of the bar codes registration, the screen in Figure 7.8 shows a list of bar codes that have been registered in the I/O Simulator.
Page 52
Editing registered bar code content Highlight a bar code in the list of registered bar codes (see Figure 7.8) and click Edit button. Figure 7.9 appears for editing the bar code and its information. Figure 7.9 Deleting registered bar code content Highlight a bar code in the list of registered bar codes (see Figure 7.8) and click the Del button.
Detection of Terminal in Cradle and Low Battery Warning If you check the I/O Box and Low Battery boxes in STATE SETTING field (see Figure 7.11), the simulator simulates the respective events in the emulator. Figure 7.11 I/O Box If this box is checked, a notification is issued that the connection between the DT-X8 Device Emulator and cradle has been established.
Page 54
Indications The I/O Simulator expresses a change of state that occurred in the DT-X8 Device Emulator. When the DT-X8 Device Emulator turns on the LED, the LED icon (LED2) in the I/O Simulator also turns on. See Figure 7.11. Vibration When the DT-X8 Device Emulator vibrates, the vibration icon in the I/O Simulator also turns on.
7.3.3 Connecting via ActiveSync If debugging with the Device Emulator is carried out in Visual Studio 2008 or Visual Studio 2005, or transmission/reception of a file with the Device Emulator is carried out, ActiveSync must be used. Setting ActiveSync 1. Start up ActiveSync and then navigate to File Connection Settings ….
Page 56
Connection via ActiveSync The way to establish connection of the Device Emulator via ActiveSync is; 1. Start up the Device Emulator by referring to Chapter 7.2 “Starting Up the Device Emulator”. 2. Start up Visual Studio 2008 or Visual Studio 2005, and then navigate to Tools Device Emulator Manager.
7.4 Debugging Applications This chapter describes how to debug your application using the Device Emulator. Before starting to “Build”, establish a connection between the DT-X8 and your PC via ActiveSync by referring to Chapter 7.3 “Using the Device Emulator”. For the basic order of developing an application, refer to Chapter 8 “Visual Studio”. Setting Build Configuration Choose Debug in the Solution Configurations pull-down menu in Visual Studio 2008 or Visual Studio 2005 and DT-X8 Emulator in the target device pull-down menu.
Page 58
Similar to ordinary debugging operations with an actual DT-X8, the Device Emulator allows break point setting (circled in red in Figure 7.20) in the source code and step-by-step debugging. Figure 7.20...
DT-X8 have different name spaces and names from those available for the previous CASIO handheld terminals. They are not compatible with the ones in the previous CASIO library. The exceptions are DT-X7, DT-X11, and IT-600 that use the same libraries.
4. Choose Include files in Show directories for:. 5. If the installation folder has not been registered, append the following. C:\Program Files\CASIO\MBSYS\include 6. Choose Library files in Show directories for:. 7. If the files have not been registered, append the following.
Page 61
3. Choose DT-X8 in the Installed BDKs (SDKs in the screen) field and click > button. Figure 8.2 4. Click Next > button while DT-X8 is kept being highlighted in the Selected BDKs (SDKs in the screen) field. Figure 8.3 5.
Page 62
7. Append the source code below in the main function of DeviceApp.cpp. DWORD result; TCHAR msg[16]; result = SysSetLED(LED_RED, 5, 8, 8); if(result == TRUE) result = SysGetLED(); switch(result & 0x0000000F) { case LED_OFF: wcscpy_s( msg, _countof(msg), TEXT("LED_OFF") ); break; case LED_RED: wcscpy_s( msg, _countof(msg), TEXT("LED_RED") );...
Page 63
8. Choose Properties in the Project of Visual Studio 2008 or Visual Studio 2005, and navigate to Configuration Properties Linker Input Additional Dependencies and then append SystemLib.lib (see red circle in Figure 8.4). Figure 8.4 9. Choose DT-X8 Device for the Target Device to establish connection with the PC. 10.
1. Create a new VB Smart Device Application in Visual Studio. 2. In Solution Explorer, right-click References and click Add Reference… 3. Click Browse and navigate to the folder where you have stored the CASIO .NET library files. Highlight SystemLibNet.dll and click it to open. Click OK button.
Page 65
5. In the event function for the button to click, add the following code. Dim result As Int32 Dim msg As String result = Calib.SystemLibNet.Api.SysSetLED( _ Calib.SystemLibNet.Def.LED_RED, 5, 8, 8) '.NET vales of “true” and “false” are “-1” and “0” respectively. If result = -1 Then result = Calib.SystemLibNet.Api.SysGetLED() Select Case (result And &HF)
1. Create a new C# Smart Device Application in Visual Studio .NET. 2. In Solution Explorer, right click References and click Add Reference… 3. Click Browse and navigate to the folder where you have stored the CASIO .NET library files. Highlight SystemLibNet.dll and click Open. Click OK button.
Page 67
5. Add a button to your form, rename it LED and double click it and then add the following code: Int32 result = new Int32(); string msg; result = SystemLibNet.Api.SysSetLED(SystemLibNet.Def.LED_RED, 5, 8, 8); // .Net values “true” and “false” are “-1” and “0” respectively. if(result == -1) result = SystemLibNet.Api.SysGetLED();...
Page 68
6. Initiate ActiveSync to establish connection between the DT-X8 and PC. 7. Select Deploy <name of project> on Build menu. 8. The project will be built and copied to the DT-X8. By default, it will be copied to \Program Files\<name of project> folder. SystemLibNet.dll will be deployed to the same folder. 9.
9. Resources Microsoft’s own http://msdn.microsoft.com/mobility/ is an extremely comprehensive resource for programmers targeting WindowsCE .NET based devices. It includes links to most other useful web based resources. You will find detailed Software and Library manuals on http://world.casio.com/system/pa.