DataMan 9500 Integrator's Guide - Bci GmbH

DataMan 9500 

Integrator’s Guide 

5/17/2012 

Version 1.0.0

DataMan 9500 Integrator‟s Guide 

5/17/2012 | Version 1.0.0 

P a g e | 2 

Legal Notices 

The software described in this document is furnished under license, and may be used or 

copied only in accordance with the terms of such license and with the inclusion of the 

copyright notice shown on this page. Neither the software, this document, nor any copies 

thereof may be provided to, or otherwise made available to, anyone other than the 

licensee. Title to, and ownership of, this software remains with Cognex Corporation or its 

licensor. Cognex Corporation assumes no responsibility for the use or reliability of its 

software on equipment that is not supplied by Cognex Corporation. Cognex Corporation 

makes no warranties, either express or implied, regarding the described software, its 

merchantability, non-infringement or its fitness for any particular purpose. 

The information in this document is subject to change without notice and should not be 

construed as a commitment by Cognex Corporation. Cognex Corporation is not responsible 

for any errors that may be present in either this document or the associated software. 

No part of this document may be reproduced or transmitted in any form or by any means, 

electronic or mechanical, for any purpose, nor transferred to any other media or language 

without the written permission of Cognex Corporation. 

Copyright © 2012 Cognex Corporation. All Rights Reserved. 

Portions of the hardware and software provided by Cognex may be covered by one or more 

of the U.S. and foreign patents listed below as well as pending U.S. and foreign patents. 

Such pending U.S. and foreign patents issued after the date of this document are listed on 

Cognex web site at http://www.cognex.com/patents. 

VisionPro 

5481712, 5495537, 5548326, 5583954, 5602937, 5640200, 5751853, 5768443, 5825913, 5850466, 5872870, 5901241, 5943441, 5978080, 5978521, 

5987172, 6005978, 6039254, 6064388, 6075881, 6137893, 6141033, 6167150, 6215915, 6240208, 6324299, 6381366, 6381375, 6411734, 6421458, 

6459820, 6490375, 6516092, 6563324, 6658145, 6687402, 6690842, 6697535, 6718074, 6748110, 6771808, 6804416, 6836567, 6850646, 6856698, 

6920241, 6959112, 6963338, 6973207, 6975764, 6985625, 6993177, 6993192, 7006712, 7016539, 7043081, 7058225, 7065262, 7088862, 7164796, 

7190834, 7242801, 7251366, 7313761, EP0713593, JP3522280, JP3927239 

DataMan 

5742037, 5943441, 6215915, 6236769, 6282328, 6381375, 6408109, 6457032, 6690842, 6941026, 7175090, 7181066, 7412106, 7427028, 7549582, 

7604174, 7614563, 7617984, US-2005-0087601-A1, US-2006-0131418-A1, US-2006-0131419-A1, US-2006-0133757-A1, US-2007-0090193-A1, US-2007- 

0091332-A1, US-2007-0152064-A1, US-2007-0170259-A1, US-2008-0004822-A1, US-2008-0011855-A1, US-2008-0142604-A1, US-2008-0143838-A1, US- 

2008-0158365-A1, US-2009-0090781-A1, US-2009-0108073, US-2009-0121027-A1, US-2009-0166424-A1, US-2009-0294541-A1, WO06065619A1, 

EP1687752 

CVL 

5495537, 5548326, 5583954, 5602937, 5640200, 5717785, 5751853, 5768443, 5825483, 5825913, 5850466, 5859923, 5872870, 5901241, 5943441, 

5949905, 5978080, 5987172, 5995648, 6002793, 6005978, 6064388, 6067379, 6075881, 6137893, 6141033, 6157732, 6167150, 6215915, 6240208, 

6240218, 6324299, 6381366, 6381375, 6408109, 6411734, 6421458, 6457032, 6459820, 6490375, 6516092, 6563324, 6658145, 6687402, 6690842, 

6718074, 6748110, 6751361, 6771808, 6798925, 6804416, 6836567, 6850646, 6856698, 6920241, 6959112, 6975764, 6985625, 6993177, 6993192, 

7006712, 7016539, 7043081, 7058225, 7065262, 7088862, 7164796, 7190834, 7242801, 7251366, EP0713593, JP3522280, JP3927239 

VGR 

5495537, 5602937, 5640200, 5768443, 5825483, 5850466, 5859923, 5949905, 5978080, 5995648, 6002793, 6005978, 6075881, 6137893, 6141033, 

6157732, 6167150, 6215915, 6324299, 6381375, 6408109, 6411734, 6421458, 6457032, 6459820, 6490375, 6516092, 6563324, 6658145, 6690842, 

6748110, 6751361, 6771808, 6804416, 6836567, 6850646, 6856698, 6959112, 6975764, 6985625, 6993192, 7006712, 7016539, 7043081, 7058225, 

7065262, 7088862, 7164796, 7190834, 7242801, 7251366 

OMNIVIEW 

6215915, 6381375, 6408109, 6421458, 6457032, 6459820, 6594623, 6804416, 6959112, 7383536 

CVL Vision Library 

5495537, 5548326, 5583954, 5602937, 5640200, 5717785, 5751853, 5768443, 5825483, 5825913, 5850466, 5859923, 5872870, 5901241, 5943441, 

5949905, 5978080, 5987172, 5995648, 6002793, 6005978, 6064388, 6067379, 6075881, 6137893, 6141033, 6157732, 6167150, 6215915, 6240208, 

6240218, 6324299, 6381366, 6381375, 6408109, 6411734, 6421458, 6457032, 6459820, 6490375, 6516092, 6563324, 6658145, 6687402, 6690842, 

6718074, 6748110, 6751361, 6771808, 6798925, 6804416, 6836567, 6850646, 6856698, 6920241, 6959112, 6975764, 6985625, 6993177, 6993192, 

7006712, 7016539, 7043081, 7058225, 7065262, 7088862, 7164796, 7190834, 7242801, 7251366, EP0713593, JP3522280, JP3927239 

SMD 4 

5995648, 5850466, 6751361, 6690842, 6563324, 6490375, 5949905, 5978080, 6137893, 6167150, 6075881, 6748110, 5859923, 6411734, 6324299, 

6516092, 7190834, 6658145, 6836567, 6850646, 6975764, 6985625, 6993192, 7006712, 7043081, 7058225, 7065262, 7088862, 7164796, 7251366, 

6856698, 6002793, 6005978, 6771808, 6804416, 7016539, 6959112, 5602937, 7242801, 5640200, 5495537, 5768443, 5825483, 6421458, 6459820,


5/17/2012 | Version 1.0.0 

P a g e | 3 

Legal Notices 

6215915, 6381375, 6457032, 6157732, 6408109, 6141033, 6026176, 6442291, 6151406, 6396942, 6614926, 5371690, 5845007, 5943441, 6963338, 

5805722, 5909504, 5933523, 5964844, 5974169, 5987172, 6078700, 6252986, 6278796, 6307210, 6408429, 6424734, 6526165, 6571006, 6639624, 

6681039, 6748104, 6813377, 6853751, 6898333, 6950548, 6993177, 7139421, 5757956 

BGA II and BGA III 

5495537, 5602937, 5640200, 5768443, 5801966, 5825483, 5850466, 5859923, 5949905, 5978080, 5995648, 6002793, 6005978, 6026176, 6055328, 

6075881, 6115042, 6118893, 6130959, 6137893, 6141009, 6141033, 6151406, 6157732, 6167150, 6215915, 6289117, 6324299, 6353676, 6381375, 

6396942, 6408109, 6411734, 6421458, 6442291, 6457032, 6459820, 6490375, 6516092, 6563324, 6577775, 6614926, 6658145, 6690842, 6748110, 

6751361, 6771808, 6804416, 6836567, 6850646, 6856698, 6959112, 6975764, 6985625, 6993192, 7006712, 7016539, 7043081, 7058225, 7065262, 

7088862, 7164796, 7190834, 7242801, 7251366 

Wire Bonder 

5495537, 5532739, 5581632, 5602937, 5640199, 5640200, 5642158, 5676302, 5754679, 5757956, 5768443, 5825483, 5835622, 5850466, 5859923, 

5861909, 5949905, 5978080, 5991436, 5995648, 6002793, 6005978, 6035066, 6061467, 6075881, 6137893, 6141033, 6157732, 6167150, 6215915, 

6289492, 6324299, 6381375, 6408109, 6411734, 6421458, 6457032, 6459820, 6490375, 6516092, 6563324, 6658145, 6690842, 6748110, 6751361, 

6771808, 6804416, 6836567, 6850646, 6856698, 6959112, 6975764, 6985625, 6993192, 7006712, 7016539, 7043081, 7058225, 7065262, 7088862, 

7164796, 7171036, 7190834, 7242801, 7251366 

The following are registered trademarks of Cognex Corporation: 

acuReader® BGAII® Check it with Checker® Checker® Cognex Vision for Industry CVC-1000® CVL® DataMan® DisplayInspect® DVT® EasyBuilder® 

IDMax® In-SightIn-Sight 2000® In-Sight® (insignia with cross-hairs) MVS-8000® OmniView® PatFind® PatFlex® PatInspect® PatMax® PatQuick® 

SensorView® SmartLearn® SmartView® SMD4® UltraLight® Vision Solutions® VisionPro® VisionView® 

The following are trademarks of Cognex Corporation: 

3D-Locate 3DMax CheckPoint Cognex VSoC FFD iLearn InspectEdge Legend LineMax NotchMax ProofRead SmartAdvisor 

SmartSync SmartSystem 

Other product and company names mentioned herein are the trademarks, or registered 

trademarks, of their respective owners.


5/17/2012 | Version 1.0.0 

P a g e | 4 

Contents 

About This Guide ........................................................................................................ 6 

Documentation Set ..................................................................................................... 6 

System Overview ....................................................................................................... 7 

Connectivity/Network Scenarios ................................................................................... 8 

Setting Up Your Device ............................................................................................ 10 

Registry Backup ....................................................................................................... 10 

What is included in the Registry Backup? .................................................................. 10 

Wireless Configuration .............................................................................................. 10 

Setting Up an Ad-Hoc Wireless Connection ................................................................ 10 

Setting Up an Access Point Wireless Connection ......................................................... 12 

Firmware Update ...................................................................................................... 13 

System Requirements for Development ................................................................... 14 

DataMan Developer Toolset ....................................................................................... 14 

What is DataMan Developer Toolset? ........................................................................ 14 

How to install DataMan Developer Toolset? ............................................................... 14 

Active Sync .............................................................................................................. 14 

What is ActiveSync? ............................................................................................... 14 

Installing ActiveSync .............................................................................................. 15 

Morphic SDK for Visual Studio .................................................................................... 17 

What is Morphic SDK? ............................................................................................. 17 

How to install Morphic SDK? .................................................................................... 17 

Software and Programming ..................................................................................... 19 

Programming Libraries .............................................................................................. 19 

DataMan SDK ........................................................................................................ 19 

DM9500 Specific Helper Utilities ............................................................................... 19 

DemoInventory helper classes............................................................................... 19 

PowerUtils .......................................................................................................... 19 

RegistryManager ................................................................................................. 19 

TaskBar .............................................................................................................. 19 

MHL Library ........................................................................................................... 19 

What is the MHL Library? ...................................................................................... 19 

Installing MHL Library to the Development PC ......................................................... 20 

Creating a test application using the MHL library ..................................................... 20 

DMCC ................................................................................................................... 24 

Developer Utilities CE ................................................................................................ 24 

RemoteDebuggingViaWifi ........................................................................................ 24


5/17/2012 | Version 1.0.0 

P a g e | 5 

Contents 

ScreenCapturer ...................................................................................................... 24 

Developer Utilities (PC side) ....................................................................................... 24 

Windows Mobile Developer Power Toys ..................................................................... 24 

Application Development for Windows CE Side ............................................................. 25 

How do I create a new Windows CE GUI project in Visual Studio? ................................ 25 

Creating Hello DM_9500 ....................................................................................... 25 

How do I deploy the built application onto the DM9500? ........................................... 26 

Application Debugging ............................................................................................ 27 

How can I debug my application? .......................................................................... 27 

Customization possibilities for integrators ................................................................. 28 

Bootup sequence ................................................................................................. 28 

Reset to factory defaults sequence......................................................................... 28 

Application Development for Windows PC Side ............................................................. 28 

How do I create a new project in Visual Studio? ......................................................... 28 

Sample Applications (Windows CE side)....................................................................... 29 

Setup Tool Lite ...................................................................................................... 29 

Inventory Demo ..................................................................................................... 29 

Restricted Mode Application ..................................................................................... 30 

Database Demo ..................................................................................................... 30 

Expected workflow for local database mode ............................................................ 30 

Workflow for remote database mode ...................................................................... 30 

Usage instructions for both scenarios ..................................................................... 31 

Using a remote database ...................................................................................... 32 

Configuration .................................................................................................... 32 

Sample Applications (PC side) .................................................................................... 34 

DataMan SDK Sample ............................................................................................. 34 

DataMan Demonstrator ........................................................................................... 34

About This Guide 


5/17/2012 | Version 1.0.0 

P a g e | 6 

About This Guide 

This guide provides information about setting up DataMan 9500 (DM9500) mobile 

computers and the components and documentation included in the Dataman 9500 

Developer Toolset. 

Documentation Set 

The Documentation consists of the following components: 

Component Description Location 


Integrator‟s Guide 

Guide 


Quick Reference 

Guide 

DMCC Command 

Reference 

DataMan SDK 

Manual 

Morphic User 

Manual 

Reader 

Configuration 

Codes 

This guide describes how to set 

up the DM9500 mobile computer 

and create applications. 

This document is covers the use 

and handling of the hardware, 

available accessories, technical 

specifications, and compliance 

statements. 

Documentation on DMCC, the 

text-based commands which can 

be sent to the reader to change 

its configuration or perform 

reader actions. 

Documentation on the DataMan 

SDK, a programmatic interface in 

.NET for discovering and 

interacting with DataMan 

hardware. 

Documentation on the Morphic 

mobile computer. 

List of symbols which can be 

scanned to change the DM9500 

configuration without software. 

[this document] 

C:\Program 

Files\Cognex\DataMan\Setup Tool 

v4.2.1\ Documentation\DM9500 

Series\English\ 

DM9500_Quick_Reference.pdf 

DMCC_QandA.chm 

DataMan.SDK.chm 

Morphic User Manual.pdf 

Reader_Configuration_Codes.pdf

System Overview 

This section describes the components of the DM9500 device. 


5/17/2012 | Version 1.0.0 

P a g e | 7 


The DM9500 is Cognex‟s first ID reader supporting an integrated user interface based on a 

portable data terminal (PDT). The DM9500 family is a new line with the decoding 

performance of the DM8000 (Falcon) family and enhanced interface and UI options. With 

its variety of available interfaces and communication options it is intended to be distributed 

as a programmable platform. 

The DM9500 combines the standard Falcon decoder and image formation system with an 

ARM-based WinCE platform from NordicID (called Morphic). The Morphic unit interacts with 

the DataMan imaging engine through DMCC commands while communicating wirelessly 

with the outside world. The two units communicate internally with TCP/IP via a serial 

connection (maximum transfer rate: 100 kByte/sec). 

For application development, deployment and debugging, you can connect your device and 

your developer PC with USB ActiveSync . 

For ActiveSync, you will need the DataMan Charging Station (cBase), because this 

communication uses the physical connections of the cBase.

Morphic unit specifications 

Processor ARM11 532 MHz 

Operating platform Windows CE 6.0 

Memory 256 MB DDR RAM; 256 MB Flash 


5/17/2012 | Version 1.0.0 

P a g e | 8 


Display 2.2” – 320 x 240 pixels (QVGA) touch screen 

Wireless WLAN 802.11 a/b/g 

Wireless Encryption methods � WEP 

� WPA 

� WPA2 

USB ActiveSync connection only via DataMan Charging 

Station 

Keyboard 21 silicone keys, phone-like alphanumerical keys, all 

keys programmable (excl. power key) 

Connectivity/Network Scenarios 

From the user's point of view, the DM9500 supports the following connectivity scenarios: 

� Connect reader to your existing Wi-Fi network (ad-hoc or access point). You can 

configure this with the embedded Setup Tool Lite or the PC-based Setup Tool.


5/17/2012 | Version 1.0.0 

P a g e | 9 


� Connect reader to the PC via USB through DataMan Charging Station. The reader must 

be in the cradle. Primarily for SW development and ActiveSync.

Setting Up Your Device 


5/17/2012 | Version 1.0.0 

P a g e | 10 


This section describes various configuration and maintenance tasks related to your DM9500 

device. 

Registry Backup 

Unless you save your configuration changes with a Registry Backup, all of them are lost 

when you power off your device. For example: 

� modified wireless network settings 

� power-related and hibernation settings 

To back up the registry, perform the following steps: 

1. Click Start menu ―› Settings ―› Control Panel. 

2. In the Control panel, double-click the Cognex icon. 

3. Click the Advanced tab. 

4. Click Registry save/reset. The Registry Backup page appears. Backup Registry is 

the selected option by default. 

5. Click the Backup button. This procedure simply locks the settings into non-volatile 

memory. 

When you reboot your device the current settings will now be automatically restored. You 

will need to perform this procedure again if you make any additional changes later and you 

want them to be preserved. 

What is included in the Registry Backup? 

The registry backup covers every setting that can be changed from the Control Panel. 

Wireless Configuration 

This section describes how to configure wireless LAN network settings. 

You can connect your DataMan to your PC through two types of wireless connections: 

� ad-hoc connection 

� access point connection 

Setting Up an Ad-Hoc Wireless Connection 

Connect your DM9500 to your PC using the following steps: 

1. Press the Power button on the device. The Shutdown menu appears. 

2. Click the Device info... button. The Cognex Device Configuration menu appears. 

3. In the Wi-Fi group box, check the SSID of the device. You have to remember the 

SSID to know which device to connect to. 

4. On your PC, find the adapter settings options through Control Panel ―› Network 

and Internet (only on Windows 7) ―› Change Adapter Settings. This will take you 

to the Network Connections page. 

5. Right-click the Wireless Network Connection (your wireless device).

6. Click Properties. 

7. Click the TCP/IPv4 line in the list that appears. 

8. Click Properties at the bottom. 


5/17/2012 | Version 1.0.0 

P a g e | 11 


9. In the window that appears, choose the Use the following IP address option. 

10. Set the IP address to 192.168.99.1. 

11. Click the PC icon on your Windows Desktop toolbar. Your device will be listed under 

Wireless Network Connection. 

12. Select the SSID of your device.


5/17/2012 | Version 1.0.0 

P a g e | 12 


You can check this SSID by pressing down the Power button on your DM9500 device and 

then tapping Device Info… button. 

13. On your PC, click the Connect button that appears. 

14. When you hear a long beep on your device, wireless communication is established. 

15. Perform a registry backup so that the setting changes persist through device reboots. 

16. Reboot your device for the changes to take effect. 

Setting Up an Access Point Wireless Connection 

Connect your DM9500 to your access point using the following steps: 

1. In the router configuration page, change (or note down) your wireless access point 

SSID that will be used by your DM9500 to connect to (e.g. Dataman9500-AP). 

2. On your DM9500, using your stylus, click the Start menu icon. 

3. Click Settings ―› Control Panel. 

4. Double-click the Wi-Fi icon. The Summit Client Utility appears. 

5. On the Main tab, in the Active Profile drop-down list, select Default AP.


5/17/2012 | Version 1.0.0 

P a g e | 13 


6. Change to the Profile tab and in the Radio section, provide the SSID of the access 

point. 

7. Click OK on the upper toolbar for changes to take effect. 

8. A long beep on your DM9500 signals that wireless communication has been 

established. 

9. Perform a registry backup so that the setting changes persist through device reboots. 

10. Reboot your device for the changes to take effect. 

Your device automatically connects to any access point that is configured this way. Various 

beeps on your DM9500 sign that wireless communication has been established or 

disconnected. 

Firmware Update 

If you ever need to update the firmware on your DM9500 device, please keep in mind the 

following precautions: 

� keep your device in the DataMan Charging Station during the whole update process 

� before the update, make sure that the battery of the device is fully charged. 

To perform a firmware update, use the Setup Tool application as usual.


5/17/2012 | Version 1.0.0 

P a g e | 14 

System Requirements for Development 


To be able to develop applications for the DM9500 device you will need the following 

environment to be set up on your PC: 

1. Microsoft Windows 7 32-bit or 64-bit edition 

2. Microsoft Visual Studio 2008 (higher versions are not supported officially) 

3. Dataman Developer Toolset 

4. Microsoft ActiveSync 

5. NordicId Morphic Software Development Kit (SDK) version 6.1.0 

Without creating and testing this environment, you will be unable to create applications 

neither for the PC nor the Windows CE (device) side. 

NOTE: Programs are deployed to the DM9500 with the device cradled in the cBase (and 

the cBase is connected to the PC via USB). 

DataMan Developer Toolset 

What is DataMan Developer Toolset? 

The Dataman Developer Toolset is a set of applications, programming libraries, developer 

utilities, sample codes and documentation that are essential (or recommended) for the 

developers to create custom applications for both PC and Windows CE platform (i.e. for the 

DM9500 device). 

How to install DataMan Developer Toolset? 

To install the DataMan Developer Toolset, locate and start the Cognex DataMan 9500 

Developer Toolset Installer.exe file and follow the on-screen instructions. By default, 

the Toolset installs itself to the location below: 

C:\Users\\Cognex\ 

Active Sync 

What is ActiveSync? 

To communicate with the DM9500 device, you need to install the latest version of Microsoft 

ActiveSync on the host computer. With ActiveSync you can synchronize information 

between your mobile computer (DM9500) and the host computer. Changes made on the 

mobile computer or host computer appear in both places after synchronization. 

With ActiveSync, you will be able to: 

� Work with the DM9500 device from your PC.


5/17/2012 | Version 1.0.0 

P a g e | 15 


� Synchronize and copy files between the two devices, converting them to the correct 

format. 

� Back up the data from DM9500. 

� Define when (continuous or on command), what and how much data to synchronize. 

� Deploy programs onto the DM9500 from the PC. 

Installing ActiveSync 

1. To install ActiveSync on the host computer, download the latest version from the 

Microsoft web site at http://www.microsoft.com. In case of Windows XP the name of 

this software is ActiveSync and in the case of later Windows releases, the name has 

been changed to Windows Mobile Device Center. Connect your cBase to your PC with 

the USB cable. Place the DM9500 on the cBase. Make sure it is seated and the light on 

the cBase is green. 

2. Once you connect your DM9500 to your PC, a popup dialog informs you that the 

device driver could not be installed for the Morphic device. To install the Microsoft 

ActiveSync driver, perform the following steps: 

3. Go to Device manager, right-click on the Morphic device and select Properties. 

4. Go to the Drivers tab and click Update Driver…


5/17/2012 | Version 1.0.0 

P a g e | 16 


5. In the appearing dialog, assign Morphic to Mobile devices. 

6. In the Device Driver section, select Microsoft | Microsoft USB Sync. 

7. In the appearing warning dialog, click Yes. 

8. Now start Microsoft ActiveSync (also called Windows Mobile Device Center). It should 

show a check box as connected to the 9500.

Morphic SDK for Visual Studio 


5/17/2012 | Version 1.0.0 

P a g e | 17 


What is Morphic SDK? 

Morphic SDK is an application that provides a new device type within Visual Studio – the 

Morphic SDK ARMV41 Device. Once you installed Morphic SDK, the new device type can 

be selected from the Emulators drop-down list. 

NOTE: without installing Morphic SDK, you will be unable to develop applications to the 

Morphic device. 

How to install Morphic SDK? 

1. Make sure you have the DM9500 Developer Toolset installed. 

2. Start the Morphic SDK installer and follow the on-screen instructions. You can start it 

from: C:\Users\\Cognex\DataMan 9500 Developer Toolset\Morphic 

SDK for Visual Studio\Morphic SDK.msi 

To check if the SDK is installed correctly, perform the following steps: 

1. Open Visual Studio and start a new Smart Device project.


5/17/2012 | Version 1.0.0 

P a g e | 18 


2. Select Windows CE as Platform, .NET 2.0 and Device Application template. Click 

OK. 

3. Check the Emulators drop-down list in the upper-left corner; it should show the new 

device type - Morphic SDK ARMV41 Device.

Software and Programming 

Programming Libraries 


5/17/2012 | Version 1.0.0 

P a g e | 19 


To be able to develop applications for the DM9500 device, you will need the following 

software and programming libraries: 

� Dataman SDK (already installed on DM9500; install it on the development PC) 

� MHL library (already installed on DM9500) 

� DMCC commands (no need to install anything) 

DataMan SDK 

For information on the Dataman SDK, see the DataMan 9500 Communications and 

Programming Guide. 

DM9500 Specific Helper Utilities 

Some DM9500 specific helper functions are provided as source codes with the Developer 

Toolset in the project called Dm9500UtilsCF. Some of the main features are described 

below. 

DemoInventory helper classes 

Some features in these helper utilities were specifically designed for the DemoInventory 

application but were put in this utility project because with a few easy modifications they 

can be customized for other use cases. The ProductRecord class handles part of the data 

base management in the application. ByteChunkList and ProtocolParser classes are used 

with SimpleTcpServer which was created to demonstrate a really simple application of 

custom communication handling. 

PowerUtils 

Gives some examples for using power management features of the Morphic component. 

See the MHL documentation for details on the available features and their usage. 

RegistryManager 

Shows an example of getting registry values from Windows CE (used in the DemoInventory 

application for application settings management). 

TaskBar 

Gives an example that shows how one can hide or show the taskbar in Windows CE. (Used 

by Setup Tool Lite, but in general it is useful if we want to gain more space on the screen 

or if we want to prevent the user from accessing the Start menu.) 

MHL Library 

What is the MHL Library? 

This is necessary only if the developer needs to access Morphic-specific (near hardwarelevel) 

features (e.g. accessing WLAN properties, switching keyboard backlight, sending 

device to suspend mode). If the tasks are related exclusively to DataMan specific features 

(code reading, displaying images) then this MHL library may not be necessary. The MHL 

library exists only for the Windows CE platform.

For the sample code on using the MHL library, see this section. 


5/17/2012 | Version 1.0.0 

P a g e | 20 


For the complete set of functions of the MHL library, see the MHL documentation, included 

within the DataMan Developer Toolset (C:\Users\\Cognex\DataMan 9500 

Developer Toolset\MHL Library\Documentation\MHL.pdf) 

NOTE: You can use all the components described in the MHL documentation, but we do 

not recommend using the Extension component, because it may confound the operation 

of the Morphic unit. 

Installing MHL Library to the Development PC 

The MHL library is already installed on the Morphic device. But it is also necessary to install 

it on the development PC for creating applications. For installation, follow the steps below: 

Prerequisite: Morphic SDK has to be already installed. 

1. Create the following folder: My Documents\Dm9500 development 

2. From 

C:\Users\\Cognex\DataMan 9500 Developer Toolset\MHL 

Library\Library, 

extract the DOTNET_MHL_V2_VS2008.zip file to the DM9500 development folder you 

created in Step 1. 

Creating a test application using the MHL library 

This section describes how to create an application that uses the MHL library features. The 

application uses the keyboard backlight upon pressing a button. 

1. Open Visual Studio and start a new Smart Device project with the name 

BackLightTest.


5/17/2012 | Version 1.0.0 

P a g e | 21 


2. Select Windows CE as Platform, .NET 2.0 Framework and the Device Application 

template. Click OK. 

3. In the Emulators drop-down list in the upper-left corner, set the platform to Morphic 

SDK ARMV4I device (Morphic SDK should have been already installed!) 

4. In Solution Explorer, right-click on the solution and select Add � Existing Project…


5/17/2012 | Version 1.0.0 

P a g e | 22 


5. Browse to the MHL V2 2008 project that you extracted in Step 2 and select the 

NET_MHL_VS2008.csproj file. This project contains the source files of the MHL library. 

6. In Solution Explorer, right-click on References and select Add Reference… 

7. Select the Projects tab and select the NET_MHL_VS2008 project. Click OK. 

8. From the Toolbox, place a button on Form1. Name the button btnBlink. 

9. Resize the form so that it can be seen on the Morphic display. 

10. Double-click on the button to go to its event handler. 

11. Place “using NordicId;” at the end of the using section: 

using System;

using System.Collections.Generic; 

using System.ComponentModel; 

using System.Data; 

using System.Drawing; 

using System.Text; 

using System.Windows.Forms; 

using NordicId; 


5/17/2012 | Version 1.0.0 

P a g e | 23 


12. Place the code snippet below into the event handler. This code will light up the 

keyboard backlight for a second upon clicking the button. 

private void btnBlink_Click(object sender, EventArgs e) 

{ 

MHL aMhl = new MHL(); 

int hBacklight = (int)INVALID_HANDLE_VALUE; 

try 

{ 

KbBlFullLevel); 

} 

hBacklight = (int)aMhl.OpenDrv("Backlight"); 

if (hBacklight != INVALID_HANDLE_VALUE) 

{ 

} 

// Get current values 

bool KbBlPower = aMhl.GetBool(hBacklight, "Backlight.KbBlPower"); 

uint KbBlFullLevel = aMhl.GetDword(hBacklight, "Backlight.aMhl"); 

// Turn on light 

aMhl.SetDword(hBacklight, "Backlight.KbBlFullLevel", 100); 

aMhl.SetBool(hBacklight, "Backlight.KbBlPower", true); 

System.Threading.Thread.Sleep(1000); 

// Turn off light 

aMhl.SetDword(hBacklight, "Backlight.KbBlFullLevel", 0); 

aMhl.SetBool(hBacklight, "Backlight.KbBlPower", false); 

System.Threading.Thread.Sleep(1000); 

// Set values in state before the blink 

aMhl.SetDword(hBacklight, "Backlight.KbBlFullLevel", 

aMhl.SetBool(hBacklight, "Backlight.KbBlPower", KbBlPower); 

catch (Exception ex) 

{


5/17/2012 | Version 1.0.0 

P a g e | 24 


System.Diagnostics.Debug.WriteLine(String.Format("Error blinking 

keyboard backlight: {0}", ex.Message)); 

} 

} 

finally 

{ 

} 

if (hBacklight != INVALID_HANDLE_VALUE) 

{ 

} 

aMhl.CloseDrv(hBacklight); 

hBacklight = (int)INVALID_HANDLE_VALUE; 

13. Click Build � Deploy Solution. You can find the application deployed in the Program 

Files folder on the DM9500 device. 

DMCC 

For information on the DMCC commands, see the DataMan 9500 Communications and 

Programming Guide. 

Developer Utilities CE 

There are two utilities on the CE side that help the integrator‟s work: 

RemoteDebuggingViaWifi 

With this application, the developer is able to debug his/her application through the Wi-Fi 

network (no need for a USB connection). 

ScreenCapturer 

This application (once started) makes pictures of the screen at definite time intervals and 

places them in the Temp directory. Ten pictures, the oldest gets overwritten with the 

newest. 

Developer Utilities (PC side) 

Windows Mobile Developer Power Toys 

On the PC side, this utility helps the integrator‟s work: WindowsMobilePowerToys 

The application, developed by Microsoft, is capable (among other features) for ActiveSync 

Remote Display. That is, you can display the Windows CE applications (from your 

DM9500 device) on your desktop or laptop without needing any device-side configuration. 

1. Install Windows Mobile Developer Power Toys to your PC.


5/17/2012 | Version 1.0.0 

P a g e | 25 


2. Go to C:\Program Files (x86)\Windows Mobile Developer Power 

Toys\ActiveSync_Remote_Display and start ASRDisp.exe. 

The live content of the device screen appears in a new window. You can also use the 

mouse or the keyboard to interact with Windows CE applications. 

Application Development for Windows CE Side 

How do I create a new Windows CE GUI project in Visual Studio? 

Creating Hello DM_9500 

For creating a new project, you need to set up the following in Visual Studio: 

1. Click File ―› New ―› Project. 

2. Select the Smart Device Project type and set .NET Framework version 2.0. 

3. Provide the Name / Location of the project and the Name of the solution and then 

click OK.


5/17/2012 | Version 1.0.0 

P a g e | 26 


4. In Target Platform, select Windows CE and in the .NET Compact Framework 

version list, select 2.0. 

5. Select Device Application templates and click OK. 

At this point, a new Windows CE form will be created automatically by Visual Studio. 

Please resize the form to fit to the screen of the device (320 x 240 pixels). 

6. Right-click on the solution and click Build Solution. 

How do I deploy the built application onto the DM9500? 

To deploy the solution, perform the following steps: 

1. Click Tools ―› Connect to Device… 

2. Select the Morphic device and click Connect. 

3. Click Build ―› Deploy Solution. By default, the application is deployed (copied) into 

the Program Files folder on the DM9500 device.


5/17/2012 | Version 1.0.0 

P a g e | 27 


4. Locate the application on the Morphic device and double-click it. The application starts 

and the form appears on the DM9500 device. If the test application started 

successfully then your PC and your device are connected and you can develop and 

deploy your applications onto it. 

Application Debugging 

How can I debug my application? 

1. In Visual Studio, click Debug ―› Start Debugging or press F5. The application 

appears on the screen of the Morphic unit. You can use regular debugging tools now: 

setting breakpoint, watching variables and so on.


5/17/2012 | Version 1.0.0 

P a g e | 28 


2. To finish, either close the application on the device or click Debug � Stop 

Debugging. 

Customization possibilities for integrators 

Bootup sequence 

1. Upon bootup, all the files in the following folder will be copied to the desktop: 

\Flash\Startup\CopyToDesktop 

This makes it easy to customize the Desktop with shortcuts, applications, etc. 

2. After this, the following CMD file is executed (if any): \Flash\Startup\Autoexec.cmd 

This is like a traditional autoexec.bat file. Integrators may place any commands here 

to be performed at device bootup. 

3. After this, a restricted mode application is executed (if any): 

\Windows\RestrictedModeApp.exe 

By default, no such application exists. This can be used to create a full-screen 

application, which prevents users to access the Windows Desktop and Start Menu. 

NOTE: The Power menu is always accessible. 

Reset to factory defaults sequence 

When a "Reset to factory defaults" command is detected (originated either from scanning 

an RP code or arriving as a network command), the following sequence of events occurs: 

1. File "\Flash\Startup\autoexec.cmd" will be renamed to 

"\Flash\Startup\autoexec.cmd.old" 

2. All files in folder "\Flash\Startup\CopyToDesktop" will be renamed to "*.old" 

3. An integrator utility "\Flash\Startup\OEM\DeviceControl.exe" will be called with 

command-line parameters "--command ResetToFactoryDefaults". 

This allows the integrator to properly respond to the device reset. The executable is 

allowed to run only for 60 seconds. 

4. The registry content will be restored to its factory default state, and the Morphic 

device performs a cold reboot. 

Application Development for Windows PC Side 

How do I create a new project in Visual Studio? 

For creating a new project, you need to set up the following in Visual Studio: 

1. Click File ―› New ―› Project. 

2. Select the Windows type and set .NET Framework version 2.0. 

3. Provide the Name / Location of the project and the Name of the solution and then 

click OK.

4. Choose Windows Forms Application and click OK. 

Sample Applications (Windows CE side) 


5/17/2012 | Version 1.0.0 

P a g e | 29 


Setup Tool Lite 

This is a demo application that demonstrates the abilities and typical usage scenarios of the 

DM9500 device and the DataMan SDK. For usage instructions on Setup Tool Lite, please 

see the DataMan 9500 Reference Manual. 

This demo application is provided with full source code. In order to build it, open the 

Users\\Cognex\DataMan 9500 Developer Toolset\Sample 

Codes\SetupToolLite\SetupToolLite.sln solution. 

Inventory Demo 

The purpose of this demo application is to give a basic example about using the DM9500 

device for Inventory purposes in an imaginary warehouse. For usage instructions on 

Inventory Demo, please see the DM9500 Reference Manual. 



Codes\DemoInventory\DemoInventory.sln solution. 

NOTE: You can connect this application to its PC counterpart (DataMan Demonstrator). In 

this case, please print the sample data matrix codes, provided at: 

Users\\Cognex\DataMan 9500 Developer Toolset\DataMan 

Demonstrator\Dm9500-DemoInventory-Codes.pdf


5/17/2012 | Version 1.0.0 

P a g e | 30 


Restricted Mode Application 

The purpose of this demo application is to create a full-screen application, which prevents 

users to access the Windows Desktop and Start Menu while providing basic code- and 

image displaying capabilities. 



Codes\RestrictedModeApp\RestrictedModeApp.sln solution. 

Database Demo 

This demo demonstrates an imaginary database application, where the product‟s 

descriptive and quantitative information is kept in an SQL database. 

Two usage operational modes are available in the demo: 

� The database is on the Morphic device. This is the default mode, requires no further 

configuration. 

� The database is on a remote SQL server, and the DM9500 device has a live Wi-Fi 

connection to that remote database. This mode requires a properly configured 

Microsoft SQL Server on a remote computer. 



Codes\DataBaseDemo\DataBaseDemo.sln solution. 

In order to use the demo, please print the sample data matrix codes, provided at: 

Users\\Cognex\DataMan 9500 Developer Toolset\DataMan 

Demonstrator\Dm9500-DemoInventory-Codes.pdf 

Expected workflow for local database mode 

1. A warehouse worker walks around in the hall, carrying a DM9500 device; and wants to 

register/hand out a few pieces from a specific product. 

2. The worker finds the required product, points the DM9500 to the product box and then 

triggers it. The triggering itself happens on the demo application‟s GUI (clicking on 

Prod. ID button). 

3. The database demo application reads the code, interprets it as a Product ID and 

searches for it in its database. 

4. If found, the device displays the product details and the product image. 

5. The worker is able to read the hazard, health and other related information and can 

also immediately modify e.g. the quantity of the given product actually kept in the 

warehouse. 

6. The local database may periodically (e.g. daily or hourly) be synchronized to a central 

product database, to provide semi-live stock information. This „offline‟ feature is not 

implemented in the demo. 

Workflow for remote database mode 

The workflow is very similar to the local database mode. 

However, a live Wi-Fi connection is necessary between the reader and a company PC, and 

the product database resides on the remote PC side. Thus all the data is retrieved from this


5/17/2012 | Version 1.0.0 

P a g e | 31 


remote, live Microsoft SQL Server database, and all updates are immediately saved there, 

too. 

Usage instructions for both scenarios 

Starting the application 

Open the DataBaseDemo.sln solution in Visual Studio on 

your PC and press F5. 

� The Products tab supports trigger, search and 

edit functions. 

� The Camera tab contains basic info about the 

camera/reader to overcome visual problems (last 

read image, DMCC log). 

� The Options tab contains database connectivity 

options. 

Reading codes 

To initiate a reading, put one of the printed product codes in 

front of the camera, and pull the trigger (or click the Code 

button). 

� If the code is read, and a corresponding Product ID is 

in the database, the searched product record appears. 

� If no such product is found, the read code appears and 

a beep signals that the product is not found in the 

database. 

� Search without triggering is also possible: enter the Id 

in the field next to the Code button or the name in the 

Name field, and click the button. 

Modifying product data 

After a successful search, click Edit to modify product data. 

� You can modify the Code, Name, Quantity (either by 

entering values, or by clicking the -/+ buttons) 

� To edit the Description or Comment fields, scroll 

down. 

� If you are satisfied with the new values, click Apply to 

store them, or Cancel to abandon the modifications.


5/17/2012 | Version 1.0.0 

P a g e | 32 

Entering a new product 


To enter a new product to the database, click on New. 

� You can enter a new product Id either by typing it in, 

or just triggering over a new product‟s code (by 

clicking on the Code button). 

� Fill Name, Qty and other fields, and specify a new 

product image by clicking over the image area and 

selecting the image in Morphic‟s file system. 

� Click Apply to insert a new product record into the 

database. 

Resolving reading problems 

You can resolve the reader problems with the help of the 

Camera tab, by checking the image read or the DMCC 

responses arrived. 

Options tab 

You can switch between local / remote SQL Server 

scenarios here. 

Using a remote database 

By default, the application uses a local SQL Server Compact database file 

(DM9500Demo.sdf) which is deployed together with the application‟s executable file. But 

when the application is in remote database mode, it ignores this local database file and 

uses a standard Microsoft SQL Server database remotely (via Wi-Fi). To test this mode, set 

up a SQL Server database on a PC. 

Configuration 

To use a remote Microsoft SQL Server, follow these steps: 

1. PC: Install Microsoft SQL server on a remote PC with “Mixed Authentication” mode. 

Enable access to it via TCP/IP.


5/17/2012 | Version 1.0.0 

P a g e | 33 


2. PC: Make sure that your DM9500 device is on the same TCP/IP subnet where the SQL 

server resides. This is the easiest if you use an Access Point Wi-Fi mode on your 

device. 

3. PC: Create a database on that SQL server, by using the following SQL script: 


Codes\DataBaseDemo\etc\DataBaseDemo-CreateDb.sql 

4. DM9500: Start Database Demo application on your DM9500 device. 

5. Go to Options tab. If Local mode is selected, then tap Disconnect button. 

6. Select Remote (Sql Server) database mode, and set the SQL Server connection 

parameters. The Computer field should be set to the form 

\. The SQL Server instance specified here 

must be the same as specified during the SQL Server Installation. 

7. Click Connect, and use the demo application as in the case of the local SQL database: 

there should be no difference. However, the operation of the demo is different behind


5/17/2012 | Version 1.0.0 

P a g e | 34 


the scenes: product data is updated immediately, in real time on the PC, providing the 

end user a really up-to-date warehouse experience. 

Sample Applications (PC side) 

DataMan SDK Sample 

The purpose of this demo application is to provide an overall summary of the features and 

capabilities of the DataMan SDK. 



Codes\DataManSdkSample\SampleApplication.PC.sln solution. 

DataMan Demonstrator 

This demo application is provided in binary form only. 

The purpose of this demo application is: 

� to demonstrate reader capabilities 

� interacting with the Inventory Demo application, accepting camera images and 

decoded results, while supplying the matching product data and images for the 

Windows CE side. 

For usage instructions on DataMan Demonstrator, please see the DataMan 9500 Reference 

Manual.

DataMan 9500 Integrator's Guide - Bci GmbH

Create successful ePaper yourself

Delete template?

Save as template?