The information in this document is subject to change without notice. No part of this document may be reproduced or
transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission
of 3M Touch Systems. 3M may have patents or pending patent applications, trademarks, copyrights, or other intellectual
property rights covering subject matter in this document. The furnishing of this document does not give you license to these
patents, trademarks, copyrights, or other intellectual property except as expressly provided in any written license agreement
from 3M Touch Systems.
The information provided in this document is intended as a guide only. For the latest detailed engineering specifications,
please contact your 3M Touch Systems Application Engineer. 3M Touch Systems is committed to continually improving
product designs, as a result, product specifications may be subject to change without notification.
NOTICE: Given the variety of factors that can affect the use and performance of a 3M Touch Systems Product (the
“Product”), including that solid state equipment has operation characteristics different from electromechanical equipment,
some of which factors are uniquely within User’s knowledge and control, it is essential that User evaluate the 3M Touch
Systems Product and software to determine whether it is suitable for User’s particular purpose and suitable for User’s method
of application. 3M Touch Systems’ statements, engineering/technical information, and recommendations are provided for
User’s convenience, but their accuracy or completeness is not warranted. 3M Touch Systems products and software are not
specifically designed for use in medical devices as defined by United States federal law. 3M Touch Systems products and
software should not be used in such applications without 3M Touch Systems’ express written consent. User should contact its
sales representative if User’s opportunity involves a medical device application.
IMPORTANT NOTICE TO PURCHASER: Specifications are subject to change without notice. These 3M Touch
Systems’ Products and software are warranted to meet their published specifications from the date of shipment and for the
period stated in the specification. 3M Touch Systems makes no additional warranties, express or implied, including but not limited to any implied warranties of merchantability or fitness for a particular purpose. User is responsible for
determining whether the 3M Touch Systems Products and software are fit for User’s particular purpose and suitable for its
method of production, including intellectual property liability for User's application. If the Product, software or software
media is proven not to have met 3M Touch Systems’ warranty, then 3M Touch Systems’ sole obligation and User’s and
Purchaser’s exclusive remedy, will be, at 3M Touch Systems’ option, to repair or replace that Product quantity or software
media or to refund its purchase price. 3M Touch Systems has no obligation under 3M Touch Systems’ warranty for any
Product, software or software media that has been modified or damaged through misuse, accident, neglect, or subsequent
manufacturing operations or assemblies by anyone other than 3M Touch Systems. 3M Touch Systems shall not be liable in
any action against it in any way related to the Products or software for any loss or damages, whether non-specified
direct, indirect, special, incidental or consequential (including downtime, loss of profits or goodwill) regardless of the
legal theory asserted.
MicroTouch, the MicroTouch logo, ChassisTouch, ClearTek, Microcal, ThruGlass, TouchPad, TouchPen, TouchWare,
TouchTek, TruePoint, and ToughTouch are either registered trademarks or trademarks of 3M in the United States and/or
other countries.
Microsoft, MS-DOS, Windows, Windows NT, Windows CE .NET Platform Builder, eMbedded Visual Tools, and Visual
C++ are registered trademarks or trademarks of Microsoft Corporation.
3M Touch Systems Proprietary Information
Contents
Chapter 1 Introduction
What You Need to Know .............................................................................................. 6
Chapter 1 Installing TouchWare for Windows CE .NET
Step 1: Copy Binary Files to the platform .................................................................... 7
How much space do the 3M Touch Systems touch screen drivers add to my Windows
CE .NET image?.......................................................................................................... 12
Appendix B Files Contained In Distribution Media .........................................................13
3M Touch Systems Proprietary Information
CHAPTER 1
Introduction
The TouchWare™ software for Windows CE .NET™ OEM Developer’s Guide
describes the steps necessary to integrate 3M Touch Systems TouchWare™ software
into a Microsoft Windows CE .NET™ system build. This kit contains the following
items:
1. The TouchWare™ software touch screen driver for Windows CE .NET™ is the
software the system uses to communicate with the touch screen. It provides
“mouse emulation” touch screen functionality for applications running under
Windows CE .NET™.
2. TouchWare™ software for Windows CE .NET™ adds an applet to the Windows
CE .NET™ control panel. This applet allows the user to calibrate the touch
screen and to adjust certain touch screen preferences.
3. The source files for the touch screen control panel are included to allow
modification of the control panel or integration of touch screen functions into an
application, as required.
TouchWare™ software for Windows CE .NET™ supports the serial RS-232
controller on the X86 platform only.
To successfully install TouchWare™ software for Windows CE .NET™, you need to
install the following components:
1. The drivers for the controller
2. The TouchWare™ software control panel. If you like the way the control panel
looks as delivered, you can use the binary files supplied and concentrate on the
drivers only. If you want to change the control panel, you must install both the
drivers (using Microsoft Windows CE .NET™ Platform Builder ®) and the
TouchWare™ software control panel sources (using Microsoft eMbedded®
Visual Tools VC++).
3M Touch Systems Proprietary Information
TouchWare™ Software for Windows CE .NET™ 6
The process involves 5 steps.
1. Copying the appropriate binary files for your controller to the platform.
2. Install touch screen driver DLLs.
3. Install touch screen driver registry settings.
4. (Optional) Modifying the TouchWare™ software control panel using eMbedded
Visual C++.
5. Building the program.
What You Need to Know
This document assumes you are familiar with and have the skills necessary to successfully
modify, build, and run the Windows CE .NET™ operating system on your target
hardware.
3M Touch Systems Proprietary Information
CHAPTER 2
Installing TouchWare™ Software for Windows
CE .NET™
Step 1: Copy Binary Files to the platform
From the supplied source packet (\x86 directory), copy the files listed below to
\WINCE420\PLATFORM\<PLATFORMNAME>\FILES\:
• MTmouse.dll - mouse DDI touch screen driver
• MTTchCmn.dll - common functions
• MtsUtils.dll - control utilities
• MtsLin.dll – linearization function
• MTTchSer.dll - serial touch screen driver
If you are NOT changing the control panel also copy:
• MtsPanel.cpl - control panel applet
Step 2: Install Touch Drivers
Cut and paste the x86\Platform.bib.txt file into the end of your Platform.bib file.
; Commport is set to 1 (default) COM1 without debugging
; or COM2 with debugging port.
"CommPort"=dword:1
; Baudrate is set to 9600 baud (default) 9600 = 0x2580.
"Baudrate"=dword:2580
"Is_X_Horiz"=dword:1
"Flip_X"=dword:0
"Flip_Y"=dword:0
; TouchMode is one of the following:
; 0 = desktop (default)
; 1 = drawing
; 2 = button
[HKEY_CURRENT_USER\ControlPanel\MtsTch\0000]
"TouchMode"=dword:0
"SwapMouseButton"=dword:0
"HorizontalOffsetOn"=dword:0
"VerticalOffsetOn"=dword:0
"VerticalCursorOffset"=dword:0
; *** end TouchWare™ for Windows CE .NET ********
3M Touch Systems Proprietary Information
TouchWare™ Software for Windows CE .NET™ 9
Step 4: (Optional) Setting up the Control Panel
Note: Not available with TouchWare™ Software for Windows CE .NET™ part 19-657
1. Start eMbedded Visual C++.
2. Click on File / Open Workspace and locate MtsPanel.vcw in the folder you created when
you installed TouchWare™ software.
3. After changing the control panel skin and rebuilding it, copy MtsPanel.cpl to your
platform, \WINCE420\PLATFORM\<PLATFORMNAME>\FILES\.
Step 5: Build
After making the necessary platform modifications, the project may be built as usual.
The TouchWare™ software applet should appear on the Windows CE .NET™ control
panel. It may be used to calibrate the touch screen and configure touch screen
preferences.
3M Touch Systems Proprietary Information
APPENDIX A
Frequently Asked Questions
What TouchWare™ software drivers are loaded for the touch
screen?
TouchWare™ software loads the following drivers:
• MTmouse.dll – touch screen mouse driver
• MTTchCmn.dll – touch screen common functions
• MTTchSer.dll – touch screen serial port driver
(for RS-232 serial touch screen controller used)
How can I start the TouchWare™ software control panel from my
application? Do I need to run the control panel that exposes other
applets to the user?
An application may start the TouchWare™ software control panel without running
Control.exe (which will show all control panel applets to the user).
The TouchWare™ software control panel may be started programmatically by
running Ctlpnl.exe and passing it the name of the TouchWare™ software control
panel applet.
How can I adjust the double-click properties of TouchWare™
software?
Use the Mouse control panel applet to adjust the double-click properties. Since the
touch screen emulates the mouse, this setting controls the double-click sensitivity for
the touch screen as well.
3M Touch Systems Proprietary Information
TouchWare™ Software for Windows CE .NET™ 12
How much space do the TouchWare™ software touch screen
drivers add to my Windows CE .NET™ image?