CASIO IT-800 Series Quick Start Guide (Version 1.01) CASIO Computer Co., Ltd. Copyright ©2009. All rights reserved.
Table of the Contents Chapter 1. 1.1 1.2 1.3 Chapter 2. 2.1 2.2 2.3 Chapter 3. 3.1 3.2 3.3 3.4 Chapter 4. 4.1 4.2 Chapter 5. 5.1 5.1.1 5.1.2 5.2 5.3 5.4 5.5 5.6 Chapter 6. 6.1 6.2 Chapter 7. 7.1 7.2 7.3 7.3.1 7.3.2 7.3.3 7.4 Chapter 8. 8.1 8.2 8.3 Chapter 9.
No part of this document may be produced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of CASIO Computer Co., Ltd. in Tokyo Japan. Information in this document is subject to change without advance notice. CASIO Computer Co., Ltd.
Editorial Record Manual Version no. 1.00 1.01 Date edited Page August 2009 October 2009 all P7 P8, P9, P36 Content Original version Chinese Sensible Code (HanXin Code) is added. Bluetooth library is deleted.
Preface This guide clearly and concisely sets out the information developers need to know to get started with the CASIO IT-800 series handheld terminals with the integrated Windows Mobile® Version 6.5 OS. The best methods of connecting to your development system are covered and step by step instructions for installing and testing the CASIO Basic Development Kit (BDK) are included.
1. Product Overview 1.1 Features at a Glance The IT-800 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 IT-800 series handheld terminals. For further detail on the hardware specifications, refer to IT-800 Series Hardware Manual. Outstanding development environment • Microsoft® Windows Mobile® 6.
Scanning industrial standard bar code symbologies • Readable bar code symbologies with laser scanner: EAN8, EAN13, UPC-A/E, Codabar (NW-7), CODE39, CODE93, CODE128/EAN128, ITF, MSI, IATA, Industrial 2of5, GS1 DataBar Omnidirectional (RSS-14), GS1 DataBar Limited (RSS Limited), GS1 DataBar Expanded (RSS Expanded), GS1 DatBar Stacked (RSS-14 Stacked), GS1 DataBar Expanded Stacked(RSS Expanded Stacked) • Readable bar code symbologies with C-MOS imager: 1D: EAN8, EAN13, UPC-A/E, Codabar (NW-7), CODE11, CODE32,
1.2 Library The IT-800WM Basic Development Kit (“BDK”) provides various libraries including those listed in the table. Table 1.1 Description C++ Library that is used to control the system. Library that is used to control the built-in laser scan engine. Library that is used to control the built-in CMOS Imager. Library that is used to control the built-in CAMERA module. Library that is used to control to communicate with IC card. Library that is used to control the built-in WANGPRS module.
1.3 Development Manuals The IT-800WM Basic Development Kit (“BDK”) provides various development reference manuals as described in the table below. Table 1.3 Development Manual Quick Start Guide Software Manual Hardware Manual System Library Manual Laser Scanner Library Manual Imager Library Manual Camera Library Manual NFC Library Manual WANGPRS Library Manual JPEG Library Manual FLINK Library Manual Description This reference manual.
2. Prerequisites 2.1 Skills Required The following skills are required by developers aiming to develop application software for the IT-800 terminal. • Windows programming • A good knowledge of one or more of the following. - Visual C++ - Visual Basic .NET - Visual C# - 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 IT-800 series and dedicated options are available. Table 2.1 List of available models Model no.
Others Screen Protect Sheet Trigger Grip HA-H90PS5B HA-H90PS5B-CN HA-H51TG HA-H51TG-CN External views of IT-800 and dedicated options Figure 2.
2.3 Software Required The following software tools and libraries are required in order to develop software for the IT-800. Please ensure that you download or purchase the correct Microsoft tools as appropriate. Development platform Table 2.3 Programming Development Platform Language Visual C++ Microsoft Visual Studio 2005 + SP1 Visual Basic .NET Microsoft Visual Studio 2008 + SP1 Visual C# Communication Software • Microsoft ActiveSync 4.5 (or later) Download for free from; http://www.microsoft.
3. Installing BDK to PC 3.1 Application Development This chapter explains about what you need to set up for the development environment before starting your application development. 1. Installing Development Platform Install Microsoft’s development platform which supports Visual Studio 2008 and Visual Studio 2005. Install SDK (Microsoft Windows Mobile 6 Professional SDK) For detail, refer to Chapter 2.3 “Software Required”. 2.
3.2 Installing CASIO BDK Files Download the CASIO IT-800WM BDK installation CD image file from the following site and write it to a 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 IT-800WM BDK Ver. 1.xx, be sure to uninstall it before installing Ver. 2.xx. • If any file of the IT-800WM BDK Ver. 1.
Installation Steps 1. When the CASIO IT-800WM 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. Choose the component you wish to install in the screen.
3.3 Installing Library The IT-800 Library is available for the below development platforms. • • Microsoft Visual Studio 2008 Microsoft Visual Studio 2005 Notes: 1. The Library header file (*.h) and the Import library file (*.lib) are installed in the following folders respectively. 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.
3.4 Installing Online Help Besides the Help file described in the previous page, the Online Help is also available for the below development platforms. The installation of the Online Help is initiated in the Installation List. • • Microsoft Visual Studio 2008 Microsoft Visual Studio 2005 After the installation is complete, Microsoft Visual Studio starts up. The Online Help file can be accessed by navigating to Help → Contents menu.
4. Connecting Power Supply to Cradle 4.1 HA-H60IO Use the dedicated AC adaptor (AD-S42120B) for supplying power to the HA-H60IO USB Cradle. Ensure that you connect the AC adaptor to the cradle before starting communication between the IT-800 and PC via the cradle. Follow the steps below to connect the power supply to the IT-800 using the dedicated AC adaptor. 1. Plug the AC adaptor into the AC adaptor jack where “DCIN12V” is printed on the back of the cradle. Figure 4.1 2.
4. Connect a USB cable (DT-380USB) to the USB client port on the back of the cradle, and then connect the other end of the cable to the PC. USB host port is used when connecting the cradle with other USB peripheral devices. Figure 4.4 5. Align the USB cradle mount holes on the back of the IT-800 with the mount hooks on the cradle after aligning the power/signal contacts on the bottom of the IT-800 with the power/signal contacts of the cradle.
4.2 HA-H62IO Use the dedicated AC adaptor (AD-S42120B) for supplying power to the HA-H62IO Ethernet Cradle. Ensure that you connect the AC adaptor to the cradle before starting communication between the IT-800 and PC via the cradle. Follow the steps below to connect the power supply to the IT-800 using the dedicated AC adaptor. 1. Plug the AC adaptor into the AC adaptor jack on the back of the Ethernet Cradle. Figure 4.6 2.
4. Before using the cradle ports, remove the caps from the ports. When using a LAN, connect one end of the LAN cable to the LAN port and the other end to the PC or hub. When using a USB connection, connect one end of the USB cable (DT-380USB) to the USB port and the other end to the PC. Figure 4.9 5.
5. Connecting the IT-800 to PC To make connection establishment with PC, use one of the methods, depending on the OS your PC runs, described below. • ActiveSync 4.5 or a later version (for Windows XP or any other OS earlier) Use the ActiveSync to connect the IT-800 to PC if the PC runs in Windows XP or other OS earlier than Windows XP. The ActiveSync can be downloaded at the URL below. http://www.microsoft.com/downloads/details.
5.1 Connection via USB Cradle Before making connection using ActiveSync or Windows Mobile Device Center, check the USB Connection settings on the terminal. Follow the steps below: 1. Navigate to Start → Settings → System tab → USB Connection. 2. Tap Connect Utility tab. Figure 5.1 3. Confirm that “Windows Mobile Device Center/ActiveSync” is selected. If not, select the radio button and tap ok.
5.1.1 ActiveSync via USB To establish connection via USB interface with PC runs in Windows XP or any other OS earlier than Windows XP, use ActiveSync. Follow the steps below: 1. Install ActiveSync to the PC, if not installed. 2. Connect the USB cable to the PC and the other end to the USB Cradle and also the AC adaptor to the USB Cradle. 3. Make sure the selector switch on the back of the cradle is set to position B. 4.
5.2 Connection via IrDA If the PC has an IrDA interface, it is possible to connect the IT-800 to the PC via IrDA using ActiveSync. Follow the steps below: 1. Set the COM port used by ActiveSync on the PC to Infrared Port(IR). 2. Place the IT-800 so that the IrDA port located on the left side of the IT-800 faces with the IrDA port on the PC. Communication can be established if the distance is between zero and approximately 20cm. 3.
5.3 Connection via WLAN To establish communication between the IT-800 with WLAN module integrated (see Table 2.1 for applicable models) and PC via WLAN configuration, follow the steps, 1 to 6, below to set up a WLAN configuration on the IT-800. After setting up the configuration, be sure to perform a site survey prior to starting communication via WLAN. 1. Navigate to Start → Settings → Connection tab→ WLANConfig and then tap IP tab. Figure 5.3 Table 5.
2. Tap Basic tab. Set up each parameter in the tab by referring to the descriptions for the parameters in Table 5.3. Figure 5.4 Table 5.3 Parameter SSID Security Disable WEP WPA WPA2 Key Description Enter the SSID of the network you want to connect to. None. Open in Authentication field. PSK in Authentication field (if selected, the Key field must be set also.
If EAP-TLS radio button in Authentication field is selected, tap the EAP-Properties button that appears when selecting the EAP-TLS radio button to set the following settings. Table 5.5 Parameters in EAP-Properties screen User name Certificate Domain Validate server certificate Description Input a user name in alphanumeric (maximum 100 alphanumeric). Select a client certificate installed already (maximum 100 alphanumeric).
4. Tap Detail Settings tab. Figure 5.6 Table 5.7 Field / Radio Buttons When WLAN is not hide popup connected to a network show popup Enable AdHoc network setting Enable all authentication settings Inifile comment Description Hides popup window when WLAN is not connected to a network. Shows popup window when WLAN is not connected to a network. With check mark : enable the setting. Without check mark : disable the setting. With check mark : enable the setting. Without check mark : disable the setting.
5. If OK button is clicked, the screen in Figure 5.7 appears. Tap OK button to perform a reset on the terminal so that the setting takes effect. Figure 5.7 6. Check to make sure that the connection has been established using the NetSearch utility, and then navigating to the Ping function in there. Enter HostName first and then tap Ping to check that you are connected to the network correctly.
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-H62IO Ethernet cradle. Follow the steps below: 1. Connect the dedicated AC adapter to the Ethernet cradle as described in Chapter 4.2. 2. Connect one end of the network cable to the Ethernet cradle and the other end to the network hub. 3. Make sure the selector switch on the back of the HA-H62IO Ethernet cradle is set to the position “LAN”. 4.
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 IT-800. The following shows the steps to initiate this. 1. 2. 3. 4. 5. Configure a network connection on the IT-800. Double tap My Device. Type \\xxxx\ where xxxx is the network name of the PC. A network logon dialog box will appear. Enter a valid User ID, Password and Network Domain.
5.6 Direct TCP/IP Connection from Visual Studio If you have a network connection to the IT-800 (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. Download the files listed below to the IT-800. Clientshutdown.exe ConmanClient2.exe CMAccept.exe DeviceDMA.dll eDbgTL.dll TcpConnectionA.dll The source folder in the PC: C:\Program Files\Common Files\Microsoft Shared\CoreCon\1.
9. Choose Windows Mobile 6 Professional Device in the list of Devices: and click Connect button. The screen in Figure 5.11 if appear indicates the success of connection establishment. Figure 5.
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 Yes Laser Scanner Library en_OBReadLib.ARMV4I.CAB Yes Camera Library en_CameraLib.ARMV4I.CAB Yes Imager Library en_ImagerLib.ARMV4I.CAB Yes WANGPRS Library en_WANGPRSLib.ARMV4I.CAB No JPEG Library enJPEG.ARMV4I.
6.2 Visual Studio 2005 Follow the steps in Chapter 5 “Connecting the IT-800 to PC” before checking the steps below to confirm that you can connect to the IT-800 from Visual Studio 2005. 1. Establish connection with the IT-800 via ActiveSync. 2. Open the application project for VB or C# in Visual Studio 2005. 3. Choose Windows Mobile 6 Professional Device in the pull-down menu box. Figure 6.1 4. Click the button shown in the red box below (see Figure 6.
7. Device Emulator The Device Emulator provides application developers with an environment that, without having the actual terminal available, allows them to debug basic functions and performance of an application at source level by stepping through the code. 7.1 Software Required The Device Emulator requires the software(s) listed below before installing the emulator. • • • • • • ActiveSync 4.5 or a later version (If required) http://www.microsoft.com/downloads/details.
7.2 Starting Up the Device Emulator After installing all required software described in Chapter 7.1, follow the steps below to start up the Device Emulator on your PC. 1. Navigate to Start menu → All Programs → CASIO Device Emulator and click IT-800WM. 2. Make sure that the IT-800WM Device Emulator has started up on the screen. See Figure 7.1. 3. Navigate to Start menu → All Programs → CASIO Device IO Simulator and click IO Simulator. 4. Make sure that the IO Simulator has started up on the screen.
7.3 Using the Device Emulator 7.3.1 IT-800WM Device Emulator The IT-800WM Device Emulator emulates various operations carried out by the actual IT-800 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.3 shows an emulated IT-800 on the screen of a PC. Figure 7.3 Key Input The emulator offers key input capability similar to that of the actual IT-800.
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 1. Registration Click ADD1D or ADD2D button (circled in red in Figure 7.4) to go into the bar code registration mode. Figure 7.4 2. Bar code registration Choose a bar code symbology in the Code Type pull-down menu that you wish to register in the I/O Simulator. Figure 7.
3. Registration of bar code and note Enter bar code data in the Code field (see Figure 7.6) and a note about the bar code in the Note field if necessary. Click OK button to complete the bar code registration. Figure 7.6 4. Completion of registration After completion of the bar codes registration, the screen in Figure 7.7 shows a list of bar codes that have been registered in the I/O Simulator.
5. Editing registered bar code content Highlight a bar code in the list of registered bar codes (see Figure 7.7) and click Edit button. Figure 7.8 appears for editing the bar code and its information. Figure 7.8 6. Deleting registered bar code content Highlight a bar code in the list of registered bar codes (see Figure 7.7) and click the Del button. Dialogue screen in Figure 7.9 appears for you to confirm the deletion. If it is okay to delete, click Yes button, otherwise click No button. Figure 7.
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.10), the Simulator simulates the respective events in the emulator. Figure 7.10 I/O Box If this box is checked, a notification is issued that the connection between the IT-800WM Device Emulator and cradle has been established. This notification can be utilized by the application.
Indications The I/O Simulator expresses a change of state that occurred in the IT-800WM Device Emulator. LED When the IT-800WM 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 IT-800WM Device Emulator vibrates, the vibration icon in the I/O Simulator also turns on. See Figure 7.11. Figure 7.
7.3.3 Connecting via ActiveSync If debugging with the IT-800WM 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 …. Figure 7.12 2. In Connection Settings screen, check in the Allow connections to one of the following box and choose DMA in the pull-down menu. See Figure 7.13. Figure 7.
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. Right-click IT-800WM Emulator in the list and then choose Cradle in the popup menu. See Figure 7.14. Figure 7.14 3. Make sure ActiveSync has started up and the icon in the status bar changes to the icon.
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 IT-800WM Device Emulator 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”.
2. Similar to ordinary debugging operations with an actual IT-800, the Device Emulator allows break point setting (circled in red in Figure 7.19) in the source code and step-by-step debugging. Figure 7.
8. Visual Studio This chapter describes application development steps in Visual Studio 2008 or Visual Studio 2005 to create an example program. The example program referred to in this chapter is an application program developed in three development environments - C++, Visual Basic and C# - using the CASIO Common Device Control Library or Common Device Control Class Library. The example program for all three environments repeats turning on and off the LED to brink for a period of 5 seconds. See Chapters 8.
8.1 Developing in C++ This chapter describes necessary steps to develop the example application program (see Chapter 8) in C++ environment using the Common Device Control Library. Before proceeding to creating the project, check if the installation folder for the Common Device Control Library has been registered in Visual Studio 2008 or Visual Studio 2005 by following steps, 1 to 8, below. 1. 2. 3. 4. 5. Navigate to Tools → Options … and open Options screen.
Choose Windows Mobile 6 Professional SDK in the Installed SDKs field and click > button. Figure 8.2 3. Click Next > button while IT-800 is kept being highlighted in the Selected SDKs field. Figure 8.3 4. Choose Console Application for the Application type in the Application Settings menu, and click Finish button. 5. In Solution Explorer, click SmartDeviceApp.cpp and then append the source code below subsequent to “#include ”. #include
6. Append the source code below in the main function of SmartDeviceApp.cpp.
7. 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 8. Choose Windows Mobile 6 Professional Device for the Target Device to establish connection with the PC. 9. Choose Debug in Visual Studio 2008 or Visual Studio 2005 and then click either Start Debugging or Start Without Debugging. 10.
8.2 Developing in VB This chapter describes necessary steps to develop the example application program (see Chapter 8) in VB environment using the Common Device Control Class Library. Application Development Procedure Subsequent steps show how to create and start up a simple program using one of the system functions. When running the program, the LED will blink in red for 5 seconds. 1. Create a new VB Smart Device Application in Visual Studio. 2.
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) Case Calib.SystemLibNet.Def.LED_OFF msg = "LED_OFF" Case Calib.SystemLibNet.Def.LED_RED msg = "LED_RED" Case Calib.SystemLibNet.Def.
8.3 Developing in C# This chapter describes necessary steps to develop the example application program (see Chapter 8) in C# environment using the Common Device Control Class Library. Application Development Procedure Subsequent steps show how to create and start up a simple program using one of the system functions. When running the program, the LED will blink in red for 5 seconds. 1. Create a new C# Smart Device Application in Visual Studio .NET. 2.
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(); switch(result & 0x0000000F) { case SystemLibNet.Def.LED_OFF: msg = "LED_OFF"; break; case SystemLibNet.Def.LED_RED: msg = "LED_RED"; break; case SystemLibNet.Def.
6. Choose Windows Mobile 6 Professional Device for the Target Device to establish connection with the PC. 7. Select Deploy on Build menu. 8. The project will be built and copied to the IT-800. By default, it will be copied to \Program Files\ folder. SystemLibNet.dll will be deployed to the same folder. 9. Check that the program works correctly on the device.
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.
