Installation Guide for Windows CE Patch

(WinCE5 / WinCE6 / WinEC7) for

easyMaxTouch HID

Documentation

Data Modul AG assumes no responsibility for any errors which may appear in this document, reserves the right to change devices or specifications detailed herein at any time without notice, and does not make any commitment to update the information contained herein.

Seite 1 von 17

1.

Revision of History ..................................................................................................... 3

2.

Introduction ................................................................................................................. 4

2.1

Purpose ............................................................................................................................. 4

2.2

Scope ................................................................................................................................ 4

2.3

Reason for a patch ............................................................................................................ 4

2.4

Prerequisites ..................................................................................................................... 4

3.

Installation Windows CE5 .......................................................................................... 6

4.

Installation Windows CE6 .......................................................................................... 9

5.

Installation Windows Embedded Compact 7 .......................................................... 13

6.

FAQ ............................................................................................................................ 16

6.1

Can I hide the mouse cursor? ......................................................................................... 16

6.2

Does this patch work with USB mouse? .......................................................................... 16

6.3

Is there any calibration tool? ............................................................................................ 16

6.4

Does the functionality right mouse click work? ................................................................ 16

6.5

Does this patch work with all standard HID touch? .......................................................... 16

6.6

How can I test my multi-touch functionality? .................................................................... 16

6.7

How many touches are supported by Windows Embedded Compact 7? ........................ 16

6.8

When I build my OS with platform builder there are some errors ..................................... 17

6.9

Which ARM architecture has been used to create the DLL‟s provided in internet? .......... 17

Seite 2 von 17

1. Revision of History

Rev. Date Page Description

1.0

1.1

1.2

1.3

1.4

1.5

27.01.2012

23.02.2012

05.03.2012

02.04.2012

13.04.2012

16.05.2012

All

All

All

All

All

All

First Draft by

Guitarte

Guitarte Revision

Change Directory Names and instructions to hide cursor

Introduce comments from B. Steiner /S. Wurzer

Guitarte

Guitarte

Adapted to CI, fixed some minor typos Trica

HID Firmware, ARM architectures, minor changes Guitarte

Seite 3 von 17

2. Introduction

2.1 Purpose

This document shows how to install the Windows CE patch for Data Modul easyMaxTouch USB controller using Human Interface Device (Driverless) HID.

2.2 Scope

This document is valid for touch for Windows CE5 (single-touch), Windows CE6 (single-touch) and

Windows Embedded Compact 7 (single-touch and multi-touch). This solution will only work with the

Data Modul easyMaxTouch Products with the controller programmed with the Data Modul HID

Driverless Firmware. At the moment Data Modul is providing this Patch for ARM based platforms. If you are working with other platform, please contact Data Modul.

2.3 Reason for a patch

The standard implementation of Windows CE does not work properly with the Human Interface

Device (HID) for touch. It only supports HID mouse. We provide a WinCE Patch for using this

Windows CE HID interface with touch.

2.4 Prerequisites

Data Modul easyMaxTouch Panel and Controller programmed with the properly HID firmware. In order to check whether you have a HID firmware please proceed following: o Connect your controller with a Windows XP / Windows 7 desktop computer. o Go to your device manager (Start->Run->devmgmt.msc)

. in “Universal Srial Bus

Controllers” you must have a device with

 VID:7374 and PID:1201 (single-touch)

 VID:7374 and PID:1202 (multi-touch, only for WinEC7) o If you find the previous VID and PID you are sure your firmware is the correct.

Seite 4 von 17

USB connection in your board for the touch controller

Windows CE Platform builder

BSPs for your platform existing work space where you can build a Windows CE image

HID touch patch for Windows Embedded Compact 7 from Data Modul

ARM Processors (for other platforms please contact Data Modul).

Seite 5 von 17

3. Installation Windows CE5

1. Open your hardware specific workspace (solution file) in Platform Builder.

2. Copy the directory eth_wc5_arm provided with this patch in your WINCEROOT Directory.

You can get the value of your _WINCEROOT variable (normally WINCE500) by opening your solution in visual studio and then in the console obtained with 'Build OS' -> 'Open

Release Directory

‟ asking for the environments variables just writing 'set'.

3. Add at the end of your project.bib file (Parameter View, in Project Specific Files, see image below to find it) the content of the touchhid.bib file provided in this patch.

4. Add at the end of your project.reg file (Parameter View, in Project Specific Files, see image below to find it) the content of the touchhid.reg file provided in this patch.

5. If you want to modify the configuration of the touch firmware directly from your WinCE device you will need a wordpad.exe in your device. You can add it in your item catalog.

Advice: When you are looking for a feature in your catalog you can use the automatic search, just go to your catalog, select the word „Catalog‟ and press Ctr + f (find option), then you can just look for the name of a feature in your catalog.

Seite 6 von 17

6. If you want to remove the mouse cursor in your touch application:

select Touch Screen (Stylus) in your item catalog (Catalog -

> “Core OS\Windows

CE devices\Shell and User interfaces\ User Interface\

Touch Screen (Stylus)“ -> Add

to OS Design (see image below)

This action will activate following environment variable: SYSGEN_TOUCH=1

following environment variable must also be set in your design

(„Platform‟ ->‟Settings‟, see image below):

BSP_NOCURSOR = 1

Seite 7 von 17

7.

Compile your image completely using the “Sysgen” or “Build and Sysgen” commands

(~ 30 minutes):

8. Then just put your image on your target.

Seite 8 von 17

4. Installation Windows CE6

1. Open your hardware specific workspace (solution file) in the Platform Builder.

2. Copy the directory eth_wc6_arm provided with this patch in your WINCEROOT directory. You can get the value of your _WINCEROOT variable (normally WINCE600) by opening your solution in visual studio and then in the console obtained with 'build' -> 'Open Release

Directory

‟ asking for the environments variables just writing 'set'.

3. Select following item in your Catalog (Catalog Items View):

Advice: When you are looking for a feature in your catalog you can use the automatic search, just write the name of the feature in the tab on the upper side of the catalog and press the white arrow in green background (see picture below).

Singletouch Gesture Recognition („CoreOS/CEBASE/Shell and User Interface/User

Interface/Gesture/

‟)

Seite 9 von 17

4.

Switch to “Solution Explorer” and add at the end of your project.bib file (see image to find it), the content of the touchhid.bib file provided in this patch.

5. Open the project.reg file (in a subdirectory of Parameter Files, see image to find it). Switch to

Source mode to easily edit the register file (see image below). Finally add at the end of your project.reg file the content of the touchhid.reg file provided in this patch.

6. If you want to modify the configuration of the touch firmware directly from your WinCE device you will need a wordpad.exe in your device. You can add it in your catalog.

7. If you want to remove the mouse cursor in your touch application. This will also remove the cursor for the mouse (removing only the touch cursor is not possible).

Touch Screen (Stylus) in your item catalog must be selected. This will be done enabl ing the checkbox next to the item “Touch Screen (Stylus)” in your Catalog

Items View (see image below).

This action will activate following environment variable: SYSGEN_TOUCH=1

Seite 10 von 17

Add following environment variable in your design.

BSP_NOCURSOR=1

You can change the properties of your OSDesign by going to Solution Explorer, selecting your OSDesign and clicking right mouse. Then select:

“Properties->Configuration Properties->Environment” (see image below).

8. Compile your image completely using the rebuild command (~ 30 minutes): o

“Rebuild Solution”:

Seite 11 von 17

9. Then you just have to put your image in your target.

Seite 12 von 17

5. Installation Windows Embedded Compact 7

1. In order to use multi-touch the controller must be programmed with the correct operational mode (contact Data Modul). If the controller is programmed with the Single-touch mode it can be used as single-touch (not multi-touch) but it will not be possible to hide the cursor.

2. Open your hardware specific workspace (solution file) in Platform Builder.

3. Copy the directory eth_wc7_arm provided with this patch in your WINCEROOT directory. You can get the value of your _WINCEROOT variable (Normally WINCE700) by opening your solution in visual studio and then in the console obtained with 'build' -> 'Open Release

Directory

‟ asking for the environments variables just writing 'set'.

4. Select following item from your catalog (Catalog Items View in

„CoreOS/ Windows Embedded

Compact/Shell and User Interface/ Graphics, Windowing and Events‟):

Advice: When you are looking for a feature in your catalog you can use the automatic search, just write the name of the feature in the tab on the upper side of the catalog and press the white arrow in green background (see picture below).

Default Gesture Response

Gesture Physics Engine

Touch Gesture GWES component

5. If you want to activate the right click mouse option in touch (simulated by hold gesture), select

AYGShell API Set from your catalog.

Seite 13 von 17

6. If you want to remove the cursor in your touch application you must select Touch Screen

(Stylus) in your Catalog:

7. If you want to make modifications in the Firmware configuration parameters using the mass storage file maxtouch.txt directly from your CE Device be sure that you have a wordpad editor in your device (Catalog „CoreOS/Windows Embedded Compact/Applications End-User‟):

8. Add at the end of your OSDesing.bib file (see image to find it) the content of the touchhid.bib file provided in this patch.

9. Add at the end of your OSDesing.reg file (see image to find it) the content of the touchhid.reg file provided in this patch. To edit the register file you have to switch to the source view.

Seite 14 von 17

10.

Open the “Properties” of your solution (see figure), select “Custom Build Actions” and in Build

Step select “Pre-Make Image”. Select new and add following action:

copy %_WINCEROOT%\eth_wc7_arm\tchproxy.dll %_FLATRELEASEDIR%\tchproxy.dll

11. Compile your image completely using the rebuild command (~ 30 minutes):

12. Then you just have to put your image in your target.

13. If you are debugging your OS or using a serial console you will see following warning:

“TchProxy: GetDeviceCaps: Warning Since Touch stream driver is not loaded this call will return error or default values.”

This warning is due to the driver architecture, it is known and is not dangerous, it can be ignored.

Seite 15 von 17

6. FAQ

6.1 Can I hide the mouse cursor?

Yes, for single-touch operational mode you can hide the cursor (typically for touch applications) by setting in your properties of your platform builder solution following variable:

BSP_NOCURSOR=1

and by activating the Touch Screen (Stylus).

You have to create a new image using this variable. You have to take into account that this solution will remove the cursor also for the mouse.

For multi-touch (Windows EC 7) you can hide the cursor as explained in chapter 5.

6.2 Does this patch work with USB mouse?

Yes HID touch patch for Windows CE works also with all kind of HID Mouse. You can even use simultaneously a touch panel and a mouse.

6.3 Is there any calibration tool?

There is no calibration tool for the HID configuration with Windows CE, it is not necessary. If your touch panel and display are built in such a way that there is a mismatch, a rotation and adaptation of the touch area can be performed by software over the firmware configuration. If this is necessary please contact Data Modul for more information.

6.4 Does the functionality right mouse click work?

This functionality is available, you just have to hold your finger on a fix position and after 1-2 seconds the right mouse click context menu will appear.

6.5 Does this patch work with all standard HID touch?

This patch just work with Data Modul touch panels and controller programmed with Data Modul

HID.

6.6 How can I test my multi-touch functionality?

In order to test the multi-touch functionality you must use an application using multi-touch. The application has been tested using cetouchview.exe provided in Windows Embedded Compact 7.

6.7 How many touches are supported by Windows

Embedded Compact 7?

A maximum of two touches are supported by the GWES of Windows Embedded Compact 7 (this is not a limitation of the hardware or driver, but of Windows Embedded Compact 7).

Seite 16 von 17

6.8 When I build my OS with platform builder there are some errors

Be sure that you can build your OS without the modifications presented in this patch without any errors. In this case you have to try to solve the problems before applying this patch. Even in the case this can be built without problems we have observed that some antivirus software may produce some errors in platform builder which can be observed when some items of catalog are selected. If this is your case please switch off your antivirus for the time platform builder is creating your OS.

6.9 Which ARM architect ure has been used to create the DLL’s provided in internet?

ARM has different architecture instructions sets. We have compiled our DLLs with following architectures:

WinCE5: ARMv4I

WinCE6: ARMv4I

WinEC7: ARMv7

If your architecture is not compatible with the given above you will obtain an exception in the execution. In this case you can contact Data Modul AG.

Seite 17 von 17