INTERMEC Device Resource Kit Version V3.92

README.HTM

© 2000-2014 INTERMEC TECHNOLOGIES CORP., ALL RIGHTS RESERVED

 

Contents

VERSION HISTORY

REQUIREMENTS

SUPPORTED DEVICES

KNOWN ISSUES

 

VERSION HISTORY

Version #

Description

V3.92

·         Added Keyboard Remapper control panel applet (KBDTools.CPL) for CV31 WEC7 devices.

·         Added Keyboard Remapper configuration file (KBDToolsConfig.xml) which is needed on CV31 devices.

·         Updated Keyboard Remapper C++ library (KBDTools.DLL) to support CV31 devices.  This required adding new versions of several APIs that allow the user to specify a specific target keyboard (since the device supports multiple keyboards).

·         Updated Keyboard Remapper .NET API for CV31 devices.  This required overloading existing APIs to allow the user to specify a specific target keyboard (since the device supports multiple keyboards).

·         Created new cab file for Keyboard Remapper on CV31 devices.

·         Added itc50 support for CV31.

·         Added itc50 support for CN51.

·         Removed several legacy target platforms from the resource kit.

·         Removed .NET Compact Framework 1.0 assemblies from the resource kit as they are not supported by Visual Studio 2008.

V3.91

·         Updated KBDTools Keyboard Remapper for CK3NG.

V3.90

·         Added Keyboard Remapper control panel applet (KBDTools.CPL) for CV41 CE6.0 devices.

·         Added Keyboard Remapper configuration file (KBDToolsConfig.xml) which is needed on CV41 devices.

·         Updated Keyboard Remapper C++ library (KBDTools.DLL) to support CV41 CE devices.

·         Updated Keyboard Remappper .NET API for CV41 CE devices.

·         Created new cab file for Keyboard Remapper on CV41 CE devices.

·         Updated the Keyboard Remapper samples to improve their appearance on the CV41.

·         Added itc50 support for CV41/CV61

V3.80

·         Added Keyboard Remapper control panel applet (KBDTools.CPL) for 70 Series devices.

·         Updated Keyboard Remapper C++ library (KBDTools.DLL) to support 70 Series devices.

·         Updated Keyboard Remappper .NET API for 70 Series devices.

·         Added Sensor API support for 70 Series. Note that the 70 Series only supports the accelerometer. There is no compass support.

V3.72

·         Added Keyboard Remapper for CS40. 

·         Added a Java CS40Keyboard class to support keyboard remapping for CS40.

·         Added Sensor API support for CS40.  Note that the CS40 only supports the accelerometer at this time.  There is no compass support.

V3.71

·         Updated Keyboard Remapper for CN50 to accommodate the refreshed CN50 keyboard driver.  Updated files are:
“KbdRemapCN50.cpl”, “KbdRemapCN50.Lib” and “CN50 Keyboard Remap.h”.
The new KbdRemapCN50.cpl is still compatible with the old keyboard driver, but if used with the new driver, you will now be able to reprogram the center scan button, the ‘#’ key and ‘.’ key on the numeric CN50, and the center scan button, the Backlight key and the ‘P’ key on the qwerty.

·         Added constants in “CN3 Keyboard Remap.h” for the right, center and left scan buttons on the front of a CN3.

·         Added new constants for key IDs and key values in the Java CN50Keyboard class to support the updates made in the KbdRemapCN50.cpl described above.

·         Added new key ID constants in the Java CN3Keyboard class for the right, center and left scan buttons on the front of a CN3.

V3.66

·         Fixes known issue with FLEXnet Connect. For details see below.

V3.65

·         Added new Java classes to support keyboard remapping for CK3, CK60, CN4, CN50, and CV30.

·         Fixed the Device Resource Kit Java Help regarding the CAB file install. The depended native library, itcKbdJni.dll, has to be built differently for each supported computer. Therefore, there is a different CAB file for each computer.

V3.64

·         Added a property and an event to the RelayOptical class to identify if a USB Opto Isolator device is connected. 

·         Added a Boolean property “Connected”, where true means an Access I/O USB-IIRO device is connected to the USB port of the CN30 or CV60.

·         Added the “OptoConnection” event which is raised when an Access I/O USB-IIRO device is connected or disconnected.

·         Added an event handler type of “OptoConnectionEventHandler” which is used to receive the event.  The passed in object of type “OptoConnectionEventArgs”, has one property, “Connected”, which indicates whether the event is an attach or a detach.

V3.63

·         Fixed misleading text in the install.  No real change in the content of the kit  from Version 3.62.

V3.62

·         Added support for the new numeric keyboard available on the CK3.

V3.61

·         Added Sensor Kit for the CN50. Support for Native and Managed development.  Please Install the SensorCab.cab file on the CN50 before using the sensor kit

V3.60

·         Added CN50 Keyboard Remapper.

V3.50

·         Added CN4 Keyboard Remapper.

V3.40

·         Added new Intermec.Device assembly for compact framework 3.5.

·         Added two C# sample applications (AudioTones\VS2008 and OptoIo\VS2008) as VS2008-compatible projects.

V3.31

·         This release resolves an incompatibility between the v3.30 CN3 Keyboard Remapper CN3kbdRemap.cpl, and CN3 devices running Windows Mobile 6 (WM6).

The previous distribution of CN3kbdRemap.cpl as provided in version 3.30 of this resource kit should not be used on Intermec devices running Windows Mobile 6. However, no such incompatibility exists with CN3 devices running Windows Mobile 5.0.  In summary, this release constitutes a replacement of the CN3 Keyboard Remapper – CN3kbdRemap.cpl – that was distributed with version 3.30.

Runtime-file information associated with this fix:

 

Affected Executable / Runtime File:

[Base Install Path]\Developer Library\Device Resource Kit\Runtime\WCE600\WM6\Armv4i\CN3kbdRemap.cpl

 

CPL File’s Embedded Version-Resource Information:

CPL version released with resource kit v3.30 (not compatible with CN3-WM6 platform):         1.10.0.0

CPL version with this release, v3.31 (fully compatible with CN3-WM6 platform):                      1.11.0.0

V3.30

·         Added CK3 Keyboard Remapper.

V3.20

·         Added a .NET class to support Opto Relay use in C# or VB.NET.

·         A code sample has been added to the electronic User’s Guide that demonstrates how to control speaker and headphone volume on any mobile device without using the ITCMixer API. See the User’s Guide for details.

·         The ITCMixer API has been discontinued (except for 700 series devices), and its replacement is supported as a platform-level API. See User’s Guide for details.

·         Added a new C# sample application for generating AudioTones (replaces the previous Tones sample). This includes separate projects for VS2003 and VS2005 / VS2008.

·         Added Visual Studio support for two new device platforms: ITC_CE5.0_SDK and Windows Mobile 6.

V3.10

·         Added new Java classes to support keyboard remapping and some audio functions.

·         Added the Opto Relay drivers CAB file for the CV60-CE and CV30 to the runtimes folder.
(Requires purchase of 3rd party Opto Relay control box.)

·         Updated CN3 Keyboard Remapper to work with CN3E keyboards.

·         Added Intermec Update to the installation kit.

V3.00

·         Separated IDL into individual Resource Kit installs.

·         Keyboard Remapper Utility for the CN3.

·         Added ActiveX control ItcAxDevice to support Web applications (using scripted HTML).
This release of the control supports the generation of audio tones on Intermec computers.
This initial release of the control supports the ability to generate simple audio tones (beeps and clicks) on Intermec computers.
Note the associated sample script in the new “HTML ActiveX” folder beneath the Device resource kit’s Examples folder.

To use this feature, the associated CAB file must be installed on your Intermec computer. Use the Start Menu to open the Runtime folder, then locate the ITCAxDevice_WebAPI.CAB file that is appropriate for your Intermec computer. Copy the CAB file to the Intermec computer using either ActiveSync or an SD Card, then execute the CAB to install it.

V2.50

·         Added Keyboard Remapper Utility for the CV30. (See user documentation for details)

·         Bug fix correcting an exception that was caused by multiple calls to ITC_ImportKeyMap

·         Bug fix correcting GUI selection of the tilde key '~' actually producing double quotes.

·         Bug fix correcting an exception that was caused by multiple calls to ITC_ImportKeyMap.

·         Bug fix correcting GUI selection of the tilde key '~' actually producing double quotes.

V2.00

·         Added component version of two audio classes.

·         Added Thai font support cab file.  This file enables a user to read the Thai script on a website created using Thai characters.

·         The following .NET classes are now accessible as .NET components (similar to a .NET control) that can be dragged into your application’s design surface from the Visual Studio 2003 Toolbox. See the Toolbox’s Intermec Smart Device tab and Intermec Windows Device tab for these components:

Intermec.Device.Audio.Tone

Intermec.Device.Audio.PolyTone

V1.00

·         Added Java Classes to access power status and control power state (i.e. suspend, warm boot and cold boot). Java documentation and samples are also provided. To use these Java classes, you need to have IVA version 4.03.xx.xx on your Intermec computer.

 

RECOMMENDED DEVELOPMENT ENVIRONMENT

·         Windows XP (SP3) or Windows 7

·         For native C++ development, use Microsoft Visual Studio 2005 or Microsoft Visual Studio 2008.  Development also requires the appropriate platform SDK.  For most devices this will be either the Microsoft Windows Mobile 5.0 Pocket PC SDK or the Microsoft Windows Mobile 6 Professional SDK, which can either be included with Visual Studio or downloaded from the Microsoft Download site.  For older devices, the appropriate SDK can be identified in the “DEVICE/PLATFORM RELATIONSHIP TABLE in the overall IDL readme.

·         For .NET development with C# or VB.NET, use Microsoft Visual Studio 2005 or Microsoft Visual Studio 2008.

 

SUPPORTED DEVICES 

Device

Operating System

CK3

Windows Mobile 6.1

CK3R

Windows Mobile 6.5

CK3X

Windows Mobile 6.5

CK70

Windows Mobile 6.5

CK71

Windows Mobile 6.5

CN3

Windows Mobile 5.0, Windows Mobile 6.1

CN4

Windows Mobile 6.1

CN50

Windows Mobile 6.1, Windows Mobile 6.5

CN51

Windows Mobile 6.5

CN70

Windows Mobile 6.5

CS40

Windows Mobile 6.5

CV31

Windows Embedded Compact 7.0

CV41

Windows CE 6.0, Windows Embedded Standard 2009 (WES)

CV61

Windows XP, Windows 7

 

KEYBOARD REMAPPER INSTALLATION

This table identifies the file needed to install the Keyboard Remapper applet on a device.

Device

CAB File

Location (in Runtime folder)

CK3

CK3KbdRemap.cab

WCE600\WM6\Armv4i

CK3R

KBDTools.cab

WCE600\WM6\Armv4i

CK3X

KBDTools.cab

WCE600\WM6\Armv4i

CK70

KBDTools.cab

WCE600\WM6\Armv4i

CK71

KBDTools.cab

WCE600\WM6\Armv4i

CN3

CN3KbdRemap.cab

WCE500\WM5.0\Armv4i

WCE600\WM6\Armv4i

CN4

KbdRemapCN4.cab

WCE600\WM6\Armv4i

CN50

KbdRemapCN50.cab

WCE600\WM6\Armv4i

CN51

KBDTools.cab

WCE600\WM6\Armv4i

CN70

KBDTools.cab

WCE600\WM6\Armv4i

CS40

KbdRemapCS40.cab

WCE600\WM6\Armv4i

CV31

KBDToolsCV31.cab

WEC700\ITC_CE700\Armv4i

CV41

KBDTools.cab (Windows CE 6.0 Only)

WCE600\iCE60-CV41\x86

 

KNOWN ISSUES

·              The sensor compass and orientation functionality is only supported on the CN50 device.  Other devices with sensors (CN51, CN70, etc.) only support acceleration functionality.

·              The following keys cannot be remapped on CN50 devices with a numeric keyboard due to limitations in the keyboard driver:  Period, Phone End, Pound, Center Scan, Gold, Aqua.  Attempting to reprogram these keys will cause undesirable results if one (or more) of the planes of the key are remapped.

·              The following keys cannot be remapped on CN50 devices with an alpha keyboard due to limitations in the keyboard driver:  P, Center Scan, Backlight, Phone End, Gold.  Attempting to reprogram these keys will cause undesirable results if one (or more) of the planes of the key are remapped.

·              Due to limitations of the keyboard driver on the CV41, many of the flags that can normally be set on key definitions have no effect.  Basically, even though the flags may be set or reset, they will not change the actual functionality of the key.  Flags that are ignored by the CV41 are NoChord, NoRepeat, Silent, LED1, LED2, LED3, StickyLock, StickyOne, StickyPersist, AppLaunch, MultiKey.

·              Most newer Intermec devices automatically restore the screen brightness level when resuming from suspend.  As a result, the ITCGetScreenLightEnableRestoreOnPowerUp/ITCSetScreenLightEnableRestoreOnPowerUp functions do not do anything on those devices.

·              Some newer devices like the CV41 and CN51 do not allow separate screen backlight brightness levels based on whether a device is on charge or on battery power.  As a result, the dwPowerSelect parameter on light control functions such as ITCSetScreenBrightnessAcDc is ignored.

·              On the CN51 device, the ITCGetScreenLightTimeout/ITCSetScreenLightTimeout functionality modifies the timeout values which turn off the screen completely as opposed to modifying the timeout values for the backlight.  This was done because the device doesn’t support a backlight timeout value for running while on battery power, and this approach was preferable to not supporting the function at all.

·              The backlight auto-dimming functionality is not supported on the CV31 device.  As a result, the ITCGetScreenLightTimeout/ITCSetScreenLightTimeout functions will always return ITC_ERROR_FUNCTION_NOT_SUPPORTED.