ꢀ
ꢀꢁ(ꢂꢁꢃꢄꢅ ꢆꢅꢇꢃꢈꢉꢂ
ꢊ ꢋꢌꢄꢍꢎꢂꢁꢏꢏꢐꢑꢒꢓꢂ
ꢔꢋꢕꢖꢂꢗꢃ ꢘꢕ
ꢂ
ꢀ
ꢀ
ꢀ
ꢀ
ꢀ
ꢀ
ꢀ
ꢀ
ꢀ
ꢀ
Srhqꢀhqꢀˆqrꢁ†‡hqꢀhyyꢀ†hsr‡’ꢀvs‚ꢁ€h‡v‚ꢀ
p‚‡hvrqꢀvꢀ‡uv†ꢀq‚pˆ€r‡ꢀirs‚ꢁrꢀˆ†vtꢀ‡uv†ꢀƒꢁ‚qˆp‡ꢂꢀ
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
3
Contents
Chapter 1
Introduction
Overview ....................................................................................................................5
Important Safety Information.....................................................................................5
Important Notes..........................................................................................................7
Maintaining Your Touch Display ..............................................................................7
Touch Sensor Care and Cleaning...............................................................................8
3M Touch Systems Support Services ........................................................................8
Contact 3M Touch Systems .......................................................................................9
Chapter 2
Setting up Your M2256PW Multi-touch Display
System Requirements...............................................................................................10
Unpacking Your Touch Display ..............................................................................11
Connecting the Touch Display.................................................................................12
Testing the M2256PW Multi-touch Display............................................................12
Arm Mounting Option..............................................................................................12
Video Card Requirements........................................................................................13
Using the Standard Controls for the Video Card.....................................................13
Supported Video Display Modes and Refresh Rates...............................................13
Configuring the Display Settings.............................................................................14
Multimedia Features.................................................................................................14
Access to the Video Controls...................................................................................14
Adjusting the M2256PW Video Display .................................................................15
Chapter 3
Enabling Your M2256PW Multi-touch Display
Windows™ 7 USB Compatibility............................................................................18
All Other Platforms..................................................................................................18
Multitouch Application Support ..............................................................................18
Installing 3M™ MicroTouch™ Software................................................................19
Video Alignment......................................................................................................19
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
4
3M™ Multi-touch Display M2256PW User Guide
Appendix A
3M™ PX USB Controller Communications
Overview of USB Firmware Communications ........................................................21
Communication Basics.............................................................................................21
Receiving Reports from the Controller....................................................................22
Command Set ...........................................................................................................22
Set Feature - Calibration ..........................................................................................22
Get Feature - GetStatus ............................................................................................24
Get Feature - GetMaxCount.....................................................................................25
Set Feature - Reset ...................................................................................................26
Set Feature –Restore Defaults..................................................................................27
Asynchronous Reports .............................................................................................27
Appendix B
3M™ PX Serial Controller Communications
Overview of Firmware Commands ..........................................................................29
Controller Default Settings ......................................................................................30
Communicating with the Controller.........................................................................30
Firmware Commands ...............................................................................................32
Calibrate...................................................................................................................33
Guidelines for Calibrate Command .........................................................................34
Get Copyright...........................................................................................................35
Mode Down Up........................................................................................................35
Mode Inactive...........................................................................................................35
Mode Stream............................................................................................................35
Name Command.......................................................................................................36
Null Command .........................................................................................................36
Output Identity .........................................................................................................36
Soft Reset .................................................................................................................36
Restore Defaults.......................................................................................................37
Unit Type .................................................................................................................37
Touch Data Format ..................................................................................................38
Appendix C
Regulatory Information
Regulatory Agency Approvals.................................................................................40
FCC Warning ...........................................................................................................41
CE Conformity for Europe.......................................................................................41
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
5
CHAPTER 1
Introduction
Overview
Congratulations on the purchase of your 3M™ Multi-touch Display M2256PW. This
guide describes how to set up your M2256PW Multi-touch Display.
The M2256PW Multi-touch Display is a 22” LCD with 16:10 aspect ratio with an
attached desktop stand. 3M Multi-touch Technology, based on 3M Projected Capacitive
touch technology and electronics, offers fast, accurate and simultaneous 20-finger touch
functionality for next-generation, multitouch applications.
This display provides true multi-touch functionality supporting up to 20 independent
touches as well as traditional pinch, expand and rotate features. Each touch is
independently recognized thereby supporting true multi-touch and multi-user input.
The M2256PW Multi-touch Display uses projected capacitive technology with an all
glass front surface and provides multi-touch functionality in a highly durable form factor.
The fast response rate enables the creation of multitouch applications and supports real
time rendering of maps and other speed sensitive applications.
Important Safety Information
Read and understand all safety information before using this product. Follow all
instructions marked on the product and described in this document. Pay close attention to
the following installation warnings and safety precautions.
Intended Use
The 3M Multi-touch Display M2256PW was designed for touch input and tested to
replace an existing display. These displays are intended for indoor use only and are not
designed for use in hazardous locations.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
6
3M™ Multi-touch Display M2256PW User Guide
Explanation of Signal Word Consequences
DANGER: Indicates a potentially hazardous situation, which, if not avoided, will
result in death or serious injury and/or property damage.
WARNING: Indicates a potentially hazardous situation, which, if not avoided,
could result in death or serious injury and/or property damage.
CAUTION: Indicates a potentially hazardous situation, which, if not avoided, may
result in minor or moderate injury and/or property damage.
CAUTION: Indicates a potentially hazardous situation, which, if not avoided, may
result in property damage.
DANGER
To avoid the risk of fire and/or explosion which will result in serious injury or
death:
•
Do not install or use this product in a hazardous location.
WARNING
To avoid the risk of fire which could result in serious injury or death:
Do not remove the cover or back of the display.
To avoid the risk of electric shock which could result in serious injury or death:
•
•
•
•
Plug power cord into appropriate grounded power source.
Do not use a damaged power supply.
Do not use a power cord that is frayed or otherwise damaged.
CAUTION
To avoid the risk of electric shock which may result in minor or moderate injury:
•
Do not service the Flat Panel Display yourself. There are no user serviceable parts
inside. Refer all servicing to qualified service personnel.
The backlight inverter output is at high voltage.
Do not use non-conforming replacement parts.
Do not place wet or damp objects on the display.
Do not expose the display to rain or other sources of water, steam, or moisture.
Do not place foreign objects on the display or its cables.
Do not remove the cover or back of the display.
Ensure that connecting the unit to the power source will not overload the power
source.
•
•
•
•
•
•
•
To avoid the risk of glass breakage which may result in minor or moderate injury:
•
Handle the display with care to avoid breaking the touch sensor. The display
contains glass parts. Dropping the display may cause the glass parts to break.
Ensure mounting screws are tightened fully to prevent instability.
Do not place foreign objects on the display.
•
•
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
7
CAUTION
To avoid the potentially hazardous situations associated with the use of isopropyl
alcohol which may result in minor or moderate injury or property damage:
Follow all instructions and recommendations in the manufacturer's Material Safety
Data Sheet and product label.
To avoid possible environmental contamination which may result in minor or
moderate injury:
•
The lamp(s) inside this product contain mercury (Hg) and must be recycled or
disposed of in accordance with local, state, or federal laws. Check your individual
state's requirements to see if specific recycling requirements exist for mercury-
containing products or other electronic products. Refer to
http://www.nema.org/lamprecycle/ or call 3M Touch Systems 1-866-407-6666 for
further information.
•
Dispose of the flat panel display according to applicable governmental regulations
.
Important Notes
• In extreme temperature and humidity situations, you may observe condensation
between the touch screen and the display. To minimize this condition, place the unit
where it will be used and allow a 24-hour environmental stabilization period prior to
powering on the display. Any noticeable condensation is temporary and will have no
long term affect on the operation of the display.
• When unplugging power supply cord, hold the plug, do not pull by the cord.
• Do not connect or disconnect this product during an electrical storm.
• Install the display in a well-ventilated area. Always maintain adequate ventilation to
protect the display from overheating and to ensure reliable and continued operation.
• Do not expose this display to direct sunlight or heat. Passive heat may cause damage
to the housing and other parts.
• An inherent characteristic of the PCT sensor is a fine grid pattern that may be visible
under certain lighting conditions.
• Do not install this display in areas where extreme vibrations may be generated. For
example, nearby manufacturing equipment may produce strong vibrations. The
vibrations may cause the display to exhibit picture discoloration or poor video
quality.
• To avoid ergonomic concerns:
Do not install the display in a manner or location with awkward accessibility.
Extended use may result in muscle, tendon, or fixed posture strains. It is
recommended you take periodic breaks from continuous use.
Maintaining Your Touch Display
To maintain your display and keep your display operating at peak performance:
• Keep your display and touch sensor clean.
• Adjust the display video controls.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
8
3M™ Multi-touch Display M2256PW User Guide
• Do not install the display in a place where ventilation may be hindered. Always
maintain adequate ventilation to protect the display from overheating and to promote
reliable and continued operation.
Touch Sensor Care and Cleaning
The touch sensor requires very little maintenance. 3M Touch Systems recommends that
you periodically clean the glass touch sensor surface. Be sure to turn off your display
before cleaning.
Typically, an isopropyl alcohol and water solution ratio of 50:50 is the best cleaning
agent for your touch sensor. You can also use straight isopropyl alcohol.
CAUTION
To avoid the potentially hazardous situations associated with the use of alcohol or
other solvents which may result in minor or moderate injury or property damage:
• Follow all instructions and recommendations in the manufacturer's Material Safety
Data Sheet and product label.
• Be sure to follow solvent manufacturer's precautions and directions for use when
using any solvents
• It is important to avoid using any caustic chemicals on the touch sensor. Do not use
any vinegar-based solutions.
• Apply the cleaner with a soft, lint-free cloth. Avoid using gritty cloths.
• Always dampen the cloth and then clean the sensor. Be sure to spray the cleaning
liquid onto the cloth, not the sensor, so that drips do not seep inside the display or
stain the bezel.
3M Touch Systems Support Services
3M Touch Systems, Inc. provides extensive support services through our website and
technical support organization. Visit the 3M Touch Systems website at
http://www.3m.com/touch, where you can download MT 7 software and drivers, obtain
regularly updated technical documentation on 3M Touch Systems products, and learn
more about our company.
Whenever you contact Technical Support, please provide the following information:
•
•
•
•
Touch display size, part number and serial number
Current driver version
Operating system used
Information on additional peripherals
Technical Support is available Monday through Friday 8:30 a.m. to 5:30 p.m. with
limited call back service after 5:30 p.m. until 8:00 p.m. US Eastern Standard Time – 9
a.m. to 5 p.m. throughout Europe.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
9
You can contact 3M Touch Systems, Inc. Technical Support (US only -- Eastern
Standard Time) by calling the hot line, sending email or a fax.
•
•
•
•
Technical Support Hot Line: 978-659-9200
Technical Support Fax: 978-659-9400
Toll Free: 1-866-407-6666 (Option 3)
Email: [email protected]
Contact 3M Touch Systems
Contact information for all offices can be found on our website at:
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
10
3M™ Multi-touch Display M2256PW User Guide
CHAPTER 2
Setting up Your M2256PW Multi-touch Display
This chapter describes how to set up your 3M Touch Systems M2256PW Multi-touch
Display. You need to complete the following tasks:
•
•
•
•
Unpack the components
Connect the video, touch display cables, and power cables
Power on the display and test your setup
If you are not running Windows 7 (or Tablet PC), install MT7 software from the
enclosed CD. Note that this will not make multitouch happen -- it is up to your
application to enable multitouch.
System Requirements
The M2256PW Multi-touch Display requires a personal computer (PC). The
requirements for your PC are as follows:
• Your PC must have an available USB or RS-232 serial communication (COM) port.
You connect the touch sensor cable to this port.
• Your PC must have a video card and video driver already installed for the display. If
you need to install a video card or a video driver, refer to your computer
documentation for instructions.
When choosing your workspace, select a sturdy, level surface. Also, make sure you can
easily access the back of the touch display and the computer. Easy access helps ensure a
smooth setup of the touch display.
Note: Before setting up your M2256PW Multi-touch Display, refer to the “Important
Safety Information” section at the beginning of this document.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
11
Unpacking Your Touch Display
Carefully unpack the carton and inspect the contents. Your M2256PW Multi-touch
Display includes the following cables and accessories:
• USB and RS-232 serial communication cables
• DVI and VGA video cables
• Audio cable
• US and European power cables
• Software CD and documentation
Cables Included with Your M2256PW Multi-touch Display
9-pin RS-232 serial cable
USB Cable
EU power cable
US power cable
VGA cable
DVI cable
Audio cable
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
12
3M™ Multi-touch Display M2256PW User Guide
Connecting the Touch Display
CAUTION
You are cautioned that any change or modification to the equipment not expressly
approved by the party responsible for compliance could void your authority to operate
such equipment.
To connect the M2256PW Multi-touch Display:
1. Turn off your computer. You should always turn off the computer before connecting
or disconnecting a device.
2. Select either the DVI or VGA cable. Connect one end of the video cable to the video
connector on the display. Connect the other end to the video card in your computer.
3. Connect one end of the touch sensor cable (either USB or serial) to the LCD.
Connect the other end to an available port on your computer.
4. Plug the AC power cord into the display.
5. Connect the power cable to an appropriate power source.
Testing the M2256PW Multi-touch Display
Note: The M2256PW Display has a power status light located on the front of the bezel.
After connection, turn on the power switch located at the bottom of the front bezel.
Before testing your touch display, make sure all cables are connected properly. Be sure
to tighten all cable screws.
To test that the display is working properly:
1. Turn on your computer.
2. Make sure the video image is displayed. If it is not, check the LED to ensure that the
display is not in power save mode (orange).
3. Make sure the video image is centered within the screen area. Use the display
controls to adjust the image, if necessary.
You can adjust the horizontal and vertical position, contrast, and brightness to better suit
your video card and your personal preference.
Arm Mounting Option
The unit has a 100 mm VESA mounting pattern on the back to allow for arm mount
capability. Use M4 x 8 mm screws to secure the VESA mount stand. Follow the
manufacturer's instructions included with the mounting device to properly attach your
display.
Note: Do not use longer screws as they could potentially damage electronics inside the
display.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
13
Video Card Requirements
Before you connect your touch display, make sure your computer has a video card
installed that supports the native video resolution of 1680 x 1050 for the M2256PW
Multi-touch Display. If you need information on installing a video card or video driver,
refer to the manual that came with your video card.
Using the Standard Controls for the Video Card
In addition to the standard controls on the display, each video card has several controls
that let you adjust the display settings. The software and driver for each video card is
unique. In most cases, you adjust these settings by using a program or utility provided by
the manufacturer of the video card.
For example, you can use the Windows Display Properties control panel to adjust the
desktop area (resolution), color depth, and refresh rate. Whenever you change these
settings, the image size, position, or shape may change. This behavior is normal. You can
readjust the image using the display controls described in this chapter.
For more information on adjusting the desktop area/resolution, color depth, or refresh
rate, refer to the user manual that came with your video card. If you change the
resolution, it is a good idea to calibrate your touch screen.
Supported Video Display Modes and Refresh Rates
Your video card should support one of the display modes specified in Table 1. If you
select an unsupported video mode, the display may stop working or display
unsatisfactory picture quality.
Table 1. Applicable Display Mode and Refresh Rate
Display Mode
640 x 350
Refresh Rate (Hz)
70
640 x 480
60, 70, 72, and 75
70
720 x 400
800 x 600
56, 60, 70, 72, and 75
60, 70, and 75
60 and 75
1024 x 768
1280 x 720
1280 x 1024
1360 x 768
1680 x 1050
60 and 75
60 and 75
60
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
14
3M™ Multi-touch Display M2256PW User Guide
Configuring the Display Settings
After you connect your M2256PW Multi-touch Display and turn on your computer, you
may need to configure one or more of these display settings. The ideal setting for the
M2256PW Multi-touch Display is as follows:
• Display mode (also called desktop area or video native resolution) 1680 x 1050
• Refresh rate (also called vertical scan rate or vertical sync) 60 Hz
• Color depth (also called color palette or number of colors) at least 16-bit (high color)
Multimedia Features
The M2256PW Multi-touch Display comes with speakers built into the back of the
display housing and includes audio cables. These cables can be connected underneath the
display.
Access to the Video Controls
This section provides guidelines for adjusting the video display and using the display
controls to adjust the image to your liking. The controls for adjusting the video display
are located on the bottom right of the M2256PW Multi-touch Display. These buttons let
you display the on-screen menu and adjust the phase, image position, contrast, and
brightness. Before you make any adjustments:
•
•
Be sure to adjust the controls in your normal lighting conditions.
Display a test image or pattern whenever you adjust the video.
Menu/Select Down Up
Auto/Exit Power LED
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
15
Adjusting the M2256PW Video Display
Your M2256PW Multi-touch Display has four controls to adjust the video display.
•
•
Menu – Shows or hides the on screen display menu.
Select -- Highlights the current menu option or saves the current setting. Press L or
N to change the value.
•
•
L/Up -- Enables you to scroll forward through items on the menu -- increase the
value of selected option or move to the next menu item.
N/Down -- Enables you to scroll backwards through items on the menu -- decrease
the value of selected option or move to the previous menu item.
If you do not press the Menu, Select, or L/up or N/down adjust buttons for up to 45
seconds, the display adjustment program times out and hides the menu options. You can
press the Menu button at any time to display the options again.
Pressing Menu will pull up the On Screen Display (OSD) menu, as shown below.
OSD
Choices
Description
SIGNAL SELECT
Choices are VGA, DVI, or Exit
Selects the applicable input source
VIDEO
Choices are Brightness, Contrast, or Exit
BRIGHTNESS
Selecting the Brightness option will allow you to adjust the
brightness of the display. Adjust the brightness using the up
and down buttons and press SELECT to confirm the new
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
16
3M™ Multi-touch Display M2256PW User Guide
OSD
Choices
Description
setting.
CONTRAST
Selecting the Contrast option increases or decreases the
strength (lightness or dimness) of the image. Adjust the
contrast using the up and down buttons and press SELECT to
confirm the new setting.
AUDIO
Adjust the volume of the speakers
COLOR
Submenu Choices are User Defined Color, Preset Color
Temperature, or Exit
USER DEFINED COLOR
Adjust the Red, Green and Blue channels to your preference.
COLOR TEMPERATURE
Adjusts color temperature to PRESET 1 (6500 color
temperature) or PRESET 2 (9300 color temperature).
IMAGE
Choices are Auto Tune, Clock, Phase, H. Position, V.
Position, or Exit
AUTO TUNE
Performs automatic configuration of the Clock, Phase,
Vertical and Horizontal positions.
CLOCK and PHASE
If the clock setting of your image is not fine-tuned, you may
observe periodic vertical bars of video noise on your image.
These bars of noise are usually adjusted out when an Auto
Configuration is performed. If the bars of noise are still
present, this setting can be adjusted manually.
Adjust this setting so that either the vertical bars of noise are
replaced by an even amount of noise across the whole screen,
or the noise disappears completely.
If you do an Auto Tune, the display will try to find the best
Clock/Phase setting. If you are not satisfied with the auto
adjustment, fine-tune the clock manually as described above.
H POSITION (Horizontal Position)
Moves image horizontally on screen either left or right.
V POSITION (Vertical position)
Moves images vertically on screen either up or down
LANGUAGE
Sets the language for the OSD -- the choices are English,
French, German, Italian, and Chinese
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
17
OSD
Choices
Description
TOOLS
Choices are OSD Timing, OSD Horizontal, OSD Vertical
OSD TIMING
Adjust how long the menu remains on the screen. Submenu
choices are: Recall, Sharpness, or Exit
OSD HORIZONTAL and VERTICAL
Adjusts the position of the OSD on your screen
RECALL
Resets the control functions back to the original factory preset
values. In order for the Recall function to work, the timing
must fall under one of the factory preset timing modes.
SHARPNESS
Adjusts the video quality to be sharp or blurry (special for
text mode).
EXIT
Exits the OSD menu.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
18
3M™ Multi-touch Display M2256PW User Guide
CHAPTER 3
Enabling Your M2256PW Multi-touch Display
Windows™ 7 USB Compatibility
3M multi-touch technology works seamlessly with the Windows™ 7 operating system.
The Multi-touch display supports USB HID for direct communication. The M2256PW
Multi-touch Display leverages all the multi-touch functionality that is native to
Windows™ 7. Plug the display in to a system running Windows™ 7 and you’ll quickly
enter the world of true multi-touch functionality.
The M2256PW Multi-touch Display is compatible with Windows 7 with no additional
software. Refer to Microsoft's Windows 7 documentation for additional information.
All Other Platforms
When using a Windows™ 7 serial connection or for Windows XP, Vista or Linux
operating systems (either USB or serial), 3M provides MicroTouch MT 7 Software for
multi-touch drivers. This guide includes information for writing your own drivers to
interface with the 3M Multi-touch Technology.
For non-Windows 7 operating system users this document provides the communication
protocol necessary to talk directly with the electronics. This enables software developers
using other operating systems such as Microsoft Windows™ Vista or Linux® to write
their own drivers and achieve the same multi-touch results.
Multitouch Application Support
Remember not all applications are multitouch ready -- Multitouch behavior is a function
of YOUR application. Check with your application vendor to determine if your software
has multitouch capability.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
19
Installing 3M™ MicroTouch™ Software
Remember that Windows™ 7 does not require any additional software to enable
multitouch functionality.
However, for Windows™ XP, Vista or Linux® operating systems, 3M™ MicroTouch™
Software enables your M2256PW Multi-touch Display to work with your computer.
3M™ MicroTouch™ Software includes a control panel for setting your touch sensor
preferences and a diagnostic utility. If you are experiencing problems with the touch
sensor, you can use the diagnostic utilities provided to test the system.
For more information on installing this software and using the control panel, refer to the
3M™ MicroTouch™ Software User Guide on the accompanying CD or on the corporate
Video Alignment
The M2256PW has been calibrated prior to shipment and the display as delivered should
not require video alignment. You should be able to accurately touch icons on the sensor.
If for some reason, you cannot do this, the touch sensor’s active area may not be aligned
to the underlying video.
Regardless of the operating system, after you connect your touch display:
ꢀ
If you are using Windows 7, you may calibrate by accessing the Software Diagnostic
Utility (SDU) found on the enclosed CD.
Launch the SDU from the CD. Select the Tools menu and highlight Calibration. The
screen below appears and you should touch the 2 targets as they appear. Press
Escape to cancel Calibration.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
20
3M™ Multi-touch Display M2256PW User Guide
ꢀ
If you are using 3M™ MicroTouch™ MT 7 Software, launch the MT 7 Control
Panel and follow the instructions on the Main tab. You'll be asked to touch 3 targets.
ꢀ
If you are writing your own drivers, you should provide your own video alignment
tool.
Use the Paint program (Start> Programs> Accessories> Paint) to determine if you have
multitouch operation. Retest the accuracy after you perform a calibration.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
21
APPENDIX A
3M™ PX USB Controller Communications
This appendix is intended for software developers only and discusses the fundamentals
of communicating with the PX controller. The firmware commands, which are usually
issued by a driver or utility program on the host system, control the operation of the
controller. This appendix lists the recommended firmware commands and describes how
to use each of these commands.
Overview of USB Firmware Communications
Developers may use this information when writing touch applications, developing
custom drivers or touch configurations, or testing their touch systems. Developers can
issue commands to initialize the controller, select operating modes, and execute
diagnostic functions.
Note: This document assumes you are familiar with USB standards and modes of
communication with USB devices, as well as firmware commands and how to use them.
Executing some commands may alter the performance of your sensor and render it
inoperable. You should be aware of the results before executing any firmware
commands.
To optimize the performance of the PX controller and simplify the development of
custom drivers, 3M Touch Systems recommends you use the commands listed in this
appendix for current development.
Communication Basics
This section provides information on sending firmware commands to the controller and
interpreting the responses that the controller returns. The default operation of the PX
controller is USB Rev 2.0 full speed.
The USB command set is implemented by using vendor requests and vendor reports, i.e.,
vendor specific transactions. The controller issues some reports without prompting the
computer. The computer can also send requests to the controller to change how it
operates or receives information about the controller. The controller issues a
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
22
3M™ Multi-touch Display M2256PW User Guide
synchronous report in response to some of these requests.
You need to know product ID (0502H) and the vendor ID (0596H) to write your own
driver. These values are required for identifying the controller.
Receiving Reports from the Controller
The controller sends a variety of reports to the computer. The first byte of each report is
the Report ID that defines the structure and content of the report. The controller sends
some reports as a direct response to a computer request (synchronous). The controller
will also send some reports as the result of an external event, such as a touch
(asynchronous).
Command Set
The USB command set is implemented by using HID Get Feature and Set Feature
commands. The various requests and reports are grouped together by report size under a
common feature ID.
HID Class Requests
The following table summarizes the available HID class requests.
Table 1. HID Class Requests Summary
HID Report Command
Name
bmRequest
Type
bRequest
Feature
Report ID
Report
Subtype Stage
Bytes
Data
Get Feature GetStatus
0xA1 (D2H)
0x21 (H2D)
0x21 (H2D)
0x01
0x09
0x09
0x09
0x01
0x06
0x03
0x03
0x03
0x12
--
4
7
8
--
8
8
8
8
2
Set Feature
Set Feature
Set Feature
Calibrate
Reset
Restore Defaults 0x21 (H2D)
Get Feature GetMaxCount
0xA1 (D2H)
Set Feature - Calibration
This is a command to do a Calibrate Extended style calibration. The controller will auto-
orient on this 2 point calibration.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
23
Table 2. Calibration Setup Stage
Offset Field Size Value
Description
Class,H2D,Interface
Set Report
0
1
2
bmRequestType
bRequest
wValue
1
1
2
0x21
0x09
0x0303 Msb 03 = Feature
Lsb 03 = Feature Report ID
Always 0
Always 8
4
6
wIndex
wLength
2
2
0
8
Table 3. Data Stage
Offset Field
Size Value Description
0
1
2
3--7
Report ID
Report Subtype
bCalType
1
1
1
5
0x03
0x04
0x01
0
Feature report ID
Indicates a calibration request
0x01 = Extended cal (CX)
Not used
Not used
The device stalls endpoint 0 if the command cannot be processed successfully. The
request cannot be processed if an invalid calibration type is given in the wValue field.
The request will also fail if the 2 calibration points do not fall within certain bounds
established by the firmware. These bounds require that the 2 calibration points be in
opposite quadrants of the sensor.
The host should issue a GetStatus request to determine the status of this request. The
status report includes a command status byte which will be set as shown below.
Table 4. Calibration Response
Command Status Byte
Description
0
1
Calibration Failed
Controller is waiting for a touch in the lower left corner.
Calibration software paints a target in the lower left corner.
Controller is waiting for a touch in the upper right corner.
Calibration software paints a target in the upper right corner.
Calibration completed successfully.
2
3
The controller does not timeout waiting for touch. Use the soft reset command to abort
the calibration.
Determining Target Areas
The default calibration targets (points) are located 12.5% (1/8) inward from the corners
of the video image. For example, suppose the resolution of your Windows-based display
is 1680 x 1050. The Calibrate Extended command calculates the amount to move inward
as follows:
•
•
Amount to move inward in the X direction: 1680 x 1/8 = 210
Amount to move inward in the Y direction: 1050 x 1/8 = 131
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
24
3M™ Multi-touch Display M2256PW User Guide
The Calibrate Extended command then positions the first calibration target inward from
the lower left corner (0,1049) and the second calibration target inward from the upper
right corner (1679,0). The following illustration shows how the calibration targets are
calculated for a Windows-based system. Your operating system may be different.
The illustration below shows the coordinates of the calibration targets and display
corners. The corners show the video coordinates in parentheses and the touch screen
coordinates in brackets.
(0, 0) [0, 0]
(1679, 0) [32767, 0]
Upper Right Calibration Target
(1469, 131)
X = 1679 – (1680 x 1/8) = 1679 – 210 = 1469
Y = 0 + (1050 x 1/8) = 0 + 131 = 131
Lower Left Calibration Target
X = 0 + (1680 x 1/8) = 0 + 210 = 210
Y = 1049 - (1050 x 1/8) = 1049 - 131 = 918
(210, 918)
(0, 1049) [0, 32767]
(1679, 1049) [32767, 32767]
Get Feature - GetStatus
This is a request to send information that indicates the status of the controller. Among
the uses for this request are determining whether there were any power on check errors
and determining whether the last request was completed successfully.
Table 5. Controller Status Setup Stage
Offset Field
bmRequestType
Size Value Description
0
1
1
2
0xA1
0x01
Class,D2H,Interface
Get Report
1
2
bRequest
wValue
0x0306 msb=03=Feature
lsb=06= Feature Report ID
Always 0
Always 8
4
6
wIndex
wLength
2
2
0
8
Table 6. Controller Status Data Stage (controller response)
Offset Field Size Value Description
0
1
2
3
4
Report ID
POC Status
Cmd Status
Touch Status
Async Reports
1
1
1
1
1
0x06
0xXX
0xXX
0
Feature Report ID
Power On Check Status
Status of last command
Not used
0x00 = async touch output off
0x01 = async touch output on
Not used
0xXX
5-7
Not used
3
0
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
25
POC Status – The status of the Power-on Checks. Various controller systems are
checked at power-up. If any failures in these systems are detected, a POC flag is set. The
POC status field reports the state of these flags.
Table 7. Power On Check Bit Fields
Bit Number
0
Description
Not used
Notes
1
2
3
4
ROM_ERROR
PWM Error
NOV_ERROR
HDW_ERROR
Not used
Code area checksum error
Touch screen not connected or potential problem
Parameter blocks checksum error
Problem with ADCs
5--7
Cmd Status – The status for the last command request. This field is used to determine
whether the last request was processed successfully. It is also used to track the progress
of a multi-stage request, such as 2 point calibration. The Status Request does not affect
the contents of this field, i.e., successful or unsuccessful processing of a previous status
request does not cause the command status field to be updated.
Table 8. Valid Command Status Field Entries
Response
Description
0
1
2
3
Failure in command processing
Command being processed
Stage 1 processing complete (for multi-stage commands)
Command complete
4
Soft Reset Occurred
5
Hard Reset Occurred
6 -- 7
Not used
Get Feature - GetMaxCount
This is a request to send information that indicates the maximum number of
simultaneous touches supported by the controller.
Table 9. Setup Stage
Offset Field
Size Value Description
0
1
2
bmRequestType
bRequest
wValue
1
1
2
0xA1
0x01
Class,D2H,Interface
Get Report
0x0312 msb=03=Feature
lsb=12 Feature Report ID
Always 0
Always 2
4
6
wIndex
wLength
2
2
0
2
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
26
3M™ Multi-touch Display M2256PW User Guide
Table 10. Data Stage (controller response)
Offset Field
Size Value Description
0
1
Report ID
Max Count
1
1
0x12
0x1E
Feature Report ID
Number of actual 30 fingers
supported
Note: The number of actual contacts reported may exceed this number (possibly up to
60).
Set Feature - Reset
This is a request to perform a controller reset. Soft resets are automatic after any block
parameter changes.
Table 11. Reset - Setup Stage
Offset Field
Size Value
Description
Class,H2D,Interface
Set Report
0
1
2
bmRequestType
bRequest
wValue
1
1
2
0x21
0x09
0x0303 msb=03=Feature
lsb=03= Feature Report ID
Always 0
Always 8
4
6
wIndex
wLength
2
2
0
8
Table 12. Reset – Data Stage
Offset Field
Size Value Description
0
1
2
Report ID
Report Subtype
bResetType
1
1
1
0x03
0x07
0x01
0x02
0
Feature Report ID
Indicates a reset request
Soft Reset
Hard Reset
Not used
3--7
5
A Hard Reset will cause the controller to re-enumerate.
In the case of a Soft Reset, after sending the command, the controller will acknowledge
(ACK) the transfer, but the command will not yet be completed. Before sending any
other commands, the host should poll with GetStatus until the command status field
returns “Soft Reset Occurred,” “Command Complete,” or “Fail”. Any timeout for this
status polling should be 2 seconds minimum.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
27
Set Feature –Restore Defaults
This is a request to restore parameter defaults.
Table 13. Restore Defaults -- Setup Stage
Offset Field
Size Value Description
0
1
2
bmRequestType
bRequest
wValue
1
1
2
0x21
0x09
Class,H2D,Interface
Set Report
0x0303 msb=03=Feature
lsb=03= Feature Report ID
Always 0
Always 8
4
6
wIndex
wLength
2
2
0
8
Table 14. Restore Defaults - Data Stage
Offset Field
Size Value Description
0
1
2-7
Report ID
Report Subtype
1
1
6
0x03
0x08
0
Feature Report ID
Restore Defaults
Not used
After sending this command, the controller will acknowledge (ACK) the transfer, but the
command will not yet be completed. Before sending any other commands, the host
should poll with GetStatus until the command status field returns “Command Complete”
or “Fail”. Any timeout for this status polling should be 2 seconds minimum.
Asynchronous Reports
Coordinate Data – MultiTouch Digitizer mode Async Report 0x13
This is used to transfer the coordinate data to the host. This report, when activated, is
sent to the host whenever new data is available/scheduled for transmission. It is an
asynchronous report that is activated by default at power up. See SetAsyncReport for
details on how to activate/deactivate an asynchronous report.
The report shown supports up to 6 simultaneous touches. Note that if more than 6
touches were to be supported, Report 0x13 would be sent as many times as necessary to
accommodate the number of fingers touching. Only the first Report 0x13 will have a
non-zero actual count. Each valid touch is marked with an ID number that remains the
same from touchdown thru liftoff. The ID number can be any value from 0 to 255. Ignore
all other data within a touch report structure with a status marked “not valid”.
The coordinate system is Upper Left origin.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
28
3M™ Multi-touch Display M2256PW User Guide
Table 15. Coordinate Data Report 0x13 --Data Stage
Offset Field
Size Value
0x13
Description
Report ID
0
1
Report ID
1
Touch Report 10
Touch Report 10
Touch Report 10
Touch Report 10
Touch Report 10
Touch Report 10
See table 16
See table 16
See table 16
See table 16
See table 16
See table 16
1 to 60
Touch Report Structure
Touch Report Structure
Touch Report Structure
Touch Report Structure
Touch Report Structure
Touch Report Structure
Number of valid touch reports
11
21
31
41
51
61
62
63
Actual Count
Not used
1
1
1
0
0
Not used
Table 16. Touch Report Structure
Offset
Field
Size Value
Description
0
Status
6
0xXX
0x00 Report not valid
0x04 Not touching
0x07 Touching
1
2
3
4
5
6
7
8
9
Touch ID
X lsb
X msb
Y lsb
Y msb
Width lsb
Width msb
Height lsb
Height msb
1
1
1
1
1
1
1
1
1
0-255
0xXX
0xXX
0xXX
0xXX
0xXX
0xXX
0xXX
0xXX
Touch thread ID number
X ( 0-7FFF)
Y ( 0-7FFF)
Width ( 0-7FFF)
Height ( 0-7FFF)
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
29
APPENDIX B
3M™ PX Serial Controller Communications
This appendix is intended for software developers only and discusses the fundamentals
of communicating with the 3M™ PX serial controller. The firmware commands, which
are usually issued by a driver or utility program on the host system, control the operation
of the controller; however developers can enter these commands directly. This appendix:
•
•
•
•
Describes the controller default settings.
Lists the recommended firmware commands for current development.
Describes how to use each of these commands.
References additional commands developers may need to use.
The description of each command includes the command syntax, the default value, how
the command works, and the expected response from the controller.
Overview of Firmware Commands
Developers may use these commands when writing touch applications, developing
custom drivers or touch configurations, or testing their touch systems. Developers can
issue commands to initialize the controller, select operating modes, and execute
diagnostic functions.
Note: This document assumes you are familiar with standards and modes of
communication with serial devices, as well as firmware commands and how to use them.
Executing some commands may alter the performance of your sensor and render it
inoperable. You should be aware of the results before executing any firmware
commands.
To optimize the performance of the 3M™ PX controller and simplify the development of
custom drivers, 3M Touch Systems recommends you use the commands listed in this
appendix for current development.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
30
3M™ Multi-touch Display M2256PW User Guide
Controller Default Settings
Communication Parameters
The operation of the PX serial controllers is N81 (no parity, 8 data bits, and 1 stop bits)
at 115,200 baud (nonadjustable).
Data Format
Data format refers to the type of packet the controller uses to send the X/Y touch
coordinates to the host system. Format Tablet Multitouch is the default format for the
3M™ PX serial controller. In Format Tablet Multitouch, the controller sends 6 bytes per
point and provides the most rapid response time to a touch.
Refer to the Format Tablet Multitouch command in the firmware reference section. Note
that 3M MicroTouch Software automatically sets communications parameters to N81.
Operating Mode
The operating mode specifies the conditions under which the controller sends the X/Y
touch coordinates (input data packet) to the host system.
Mode Stream is the default operating mode for the PX serial controller. In Mode Stream,
the controller sends a continuous stream of data packets when the sensor is touched. The
controller sends the data as long as a touch continues on the sensor.
Because Mode Stream sends touch data continually, it is the most versatile mode, and it
provides the best response time and overall feel.
3M Touch Systems recommends that the touch driver generate an interrupt as each
packet in the data stream arrives. Because touchdown and liftoff events are specially
coded, your software can generate mouse events that correspond to what the user is
doing. This enables instant feedback and prevents data loss.
Communicating with the Controller
This section provides information on sending firmware commands to the controller and
interpreting the responses that the controller returns.
The commands listed in Table 17 are those that 3M Touch Systems currently uses for
development. 3M Touch Systems recommends that you use only these commands for
3M™ PX serial controller development.
Commands to the controller are sent on the signal Receive Data (RXD) line as a serial
data stream. For each command it receives, the controller sends a response to the host on
the signal Transmit Data (TXD) line also as a serial data stream.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
31
Sending Commands to the Controller
When you send a command to the controller, you must use the correct command format.
The general format of a command is as follows:
<Header>Command<Terminator>
Note: The following descriptions of header, command, and terminator, use 3M Touch
Systems terminal emulator key sequences. You may need to enter the sequence in a
different format, depending on your emulator.
The header is the first character in the command string and is the ASCII start-of-header
control character SOH. The hexadecimal code for the ASCII SOH control character is
01. To start the command sequence, use the key combination Ctrl A (^A). If you are
working with an IBM PC compatible system, the Ctrl A key combination immediately
returns an ASCII ꢁ character.
The command, which always follows the header, consists of ASCII uppercase letters and
numbers only (printable characters).
The terminator is the last character of each command string and is an ASCII carriage
return CR. An ASCII CR control character is 0D hexadecimal. To enter a carriage return,
ending the command sequence, use Enter or the key combination Ctrl M (^M).
This appendix lists each command as a string of ASCII control characters and printable
characters consisting of a header, the command, and a terminator as follows:
<SOH>Command<CR>
Receiving Responses from the Controller
After executing a command, the controller returns a response or acknowledgment to the
host system. Each controller response consists of a header, the command response, and a
terminator in the following format:
<Header>Command Response<Terminator>
Note: The following descriptions of header, response, and terminator, use 3M Touch
Systems terminal emulator key sequences. The format of controller responses varies
depending on the terminal emulation mode you are using.
The header is the first character in the response string and is the ASCII start-of-header
control character SOH. The hexadecimal code for the ASCII SOH control character is
01. If you are working with an IBM PC compatible system in terminal mode, the SOH
control character returns a ꢁ character to the sensor.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
32
3M™ Multi-touch Display M2256PW User Guide
The command response, which always follows the header, is a range of ASCII characters
depending on the type of command sent. Responses can be in many forms. For example,
one standard response is 0 (ASCII character ‘zero’ or 30 hexadecimal). This response
indicates a successful command completion for most commands, while it indicates a
failed completion for other commands. Refer to the firmware reference section for a
description of what the response indicates for each particular command.
Another standard response is 1 (ASCII character ‘one’ or 31 hexadecimal). In most
cases, this response indicates the command failed. The controller received an invalid
command that it could not execute.
Some possible reasons for a command failure include:
•
•
•
The command was not formatted correctly.
The system parameters were not set up to allow command execution.
The controller does not support the command.
The terminator is the last character of each response string and is an ASCII carriage
return CR. The hexadecimal code for the ASCII CR control character is 0D hexadecimal.
The value returned in the response will be the ASCII control character for a carriage
return, displayed on the screen as the cursor moving to the next line.
In this appendix, responses are shown as a string of ASCII characters consisting of a
header, the response, and a terminator as follows:
<SOH>Response<CR>
Controller Initialization
To initialize the PX serial controller for new development, 3M Touch Systems
recommends that the host system issue a Reset command whenever the host system is
powered on and is attempting to establish communication with the controller.
Firmware Commands
Developers may use this information when writing touch applications, developing
custom drivers or touch configurations, or testing their touch systems. Developers can
use firmware commands to initialize the controller, select operating modes, specify data
formats, and execute diagnostic functions.
Caution: This document assumes you are familiar with firmware commands and how to
use them. Executing some commands may alter the performance of your touch system
and render it inoperable. You should be aware of the results before executing any
firmware commands.
To optimize the performance of the touch controller and simplify the development of
custom drivers, 3M Touch Systems recommends you use the commands listed in Table
17 for current development. Using these commands ensures compatibility with all 3M™
controllers.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
33
Note: When you enter commands in terminal mode, precede each command with
<CTRL> A to enter the start of header.
Table 17. Firmware Commands for PX Serial Controller Development
Command
Calibrate
Get Copyright
Mode Down Up
Mode Inactive
Mode Stream
Name
Null Command
Output Identity
Reset
Restore Defaults
Unit Type
Code
CX
Q101
MDU
MI
MS
NM
Z
OI
R
RD
UT
Description
Initiates an interactive 2-point calibration.
Returns the copyright string.
Reports touchdowns and liftoffs only.
Turns off touch reports.
Default mode. Streaming touch reports.
Returns a controller identifier string.
Returns an ACK. No effect.
Returns Identity string: ADxxxx
Resets certain modes and gets a new baseline.
Restores default settings.
Returns the Status string: AD****ss.
Calibrate
Syntax:
<SOH>CX<CR>
Response:
<SOH>1<CR> Valid point response.
A Valid Point Response (‘1’) signifies that a touch coordinate was detected and is in
range of the expected screen target area. Two valid point responses indicate successful
calibration.
<SOH>0<CR> Invalid point response
An Invalid Point Response (‘0’) is returned if the touch coordinate is out of range. If
either calibration point is invalid, the touch coordinates are discarded and the calibration
points remain unchanged from their previous values.
<SOH>2<CR> Invalid point response
An Invalid Point Response (‘2’) is returned if the user did not touch the target long
enough to provide an accurate point.
Description:
Initiates an interactive 2-point calibration.
During the calibration process, you define the active area of the touch sensor by mapping
locations to an absolute X/Y coordinate system. You touch two target areas on the
sensor. Touching the target areas sends the X/Y coordinates for those touch points to the
controller. The controller calculates all other touch points based on these two points.
The Calibrate command sets the calibration targets (points) 12½ percent inward from the
corner of the video image. Setting the targets inward makes the calibration process easier
and more accurate.
It also establishes screen orientation.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
34
3M™ Multi-touch Display M2256PW User Guide
Calibrate Procedure
To use the CX command:
1. Enter the Calibrate (CX) command. The controller sends an initial acknowledgment
of <SOH>0<CR>.
2. Touch the sensor at a lower left target, which is located 12.5% (1/8) in from the
corner of the video image. The controller returns an acknowledgment of
<SOH>1<CR>. This is a positive response. If you receive a negative response
<SOH>0<CR>, you can cancel the calibration by issuing a Reset command and then
start over again.
3. Touch the sensor at an upper right target, which is located 12.5% (1/8) in from the
corner of the video image. The controller returns an acknowledgment of
<SOH>1<CR>. This is a positive response. If you receive a negative response, you
must start over again.
Touching the two valid calibration points results in a successful calibration. If either
calibration point is invalid, the calibration fails. The PX controller restores the previous
calibration values. If Calibrate fails, repeat the CX process.
Guidelines for Calibrate Command
Here are several guidelines for using the Calibrate commands:
•
•
The controller uses the data immediately before liftoff to register a calibration touch.
Therefore, you can touch the coordinate target, hold for a few seconds, and then lift
off. Instructing users to touch this way results in a more accurate calibration.
The controller stores the data in non-volatile memory (NOVRAM). Therefore, you
do not have to calibrate the sensor each time you power on the system. You should,
however, recalibrate the touch sensor any time the video display changes size or
resolution.
•
You can cancel calibration at any time during this sequence by issuing a Reset
command.
Determining Target Areas
The default calibration targets (points) are located 12.5% (1/8) inward from the corners
of the video image. For example, the resolution of your Windows-based display is 1680
x 1050. The Calibrate Extended command calculates the amount to move inward as
follows:
•
•
Amount to move inward in the X direction: 1680 x 1/8 = 210
Amount to move inward in the Y direction: 1050 x 1/8 = 131
The Calibrate Extended command then positions the first calibration target inward from
the lower left corner (0,1049) and the second calibration target inward from the upper
right corner (1679,0). The following illustration shows how the calibration targets are
calculated for a Windows-based system. Your operating system may be different.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
35
The illustration below shows the coordinates of the calibration targets and display
corners. The corners show the video coordinates in parentheses and the touch screen
coordinates in brackets. Note that the touch screen coordinates for the serial interface
have their origin in the lower-left corner.
(0, 0) [0, 16383]
(1679, 0) [16383, 16383]
Upper Right Calibration Target
(1469, 131)
X = 1679 – (1680 x 1/8) = 1679 – 210 = 1469
Y = 0 + (1050 x 1/8) = 0 + 131 = 131
Lower Left Calibration Target
X = 0 + (1680 x 1/8) = 0 + 210 = 210
Y = 1049 - (1050 x 1/8) = 1049 - 131 = 918
(210, 918)
(0, 1049) [0, 0]
(1679, 1049) [16383, 0]
Get Copyright
Syntax:
<SOH>Q101<CR>
Response:
<SOH>Copyright © 2010 3M. All rights reserved.<CR>
Description:
This command is used to get copyright information.
Mode Down Up
Syntax:
<SOH>MDU<CR>
Response:
Description:
<SOH>0<CR> Positive response.
Limits touch reports to touchdown and liftoff events only.
Mode Inactive
Syntax:
<SOH>MI<CR>
<SOH>0<CR> Positive response.
Response:
Description:
Turns off touch reports
.
Mode Stream
Syntax:
<SOH>MS<CR>
Response:
<SOH>0<CR> Positive response.
The controller will respond with acknowledge (ACK) for compatibility. This format is
the only format supported by this controller.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
36
3M™ Multi-touch Display M2256PW User Guide
Description: This is the default mode of operation at power up. Touch reports include
touchdown and liftoff events as well as continuing touches.
Name Command
Syntax:
<SOH>NM<CR>
Response:
Description:
<SOH>0<CR> Positive response.
Returns a name string
Null Command
Syntax:
<SOH>Z<CR>
Response:
Description:
<SOH>0<CR> Positive response.
Queries the controller and waits for a response.
Use Z to determine that you are communicating with the controller or to make sure that a
utility is communicating with the controller. Using this command does not affect the
controller’s current operating parameters.
Output Identity
Syntax:
<SOH>OI<CR>
Response:
<SOH>ADXxxx<CR>
where:
AD
= Two ASCII characters that describe the type of 3M Touch Systems controller.
Xxxx = This is a unique identifier not necessarily the actual firmware revision
number.
Description:
Returns a 6-character identifier, which describes the controller type and the firmware
version number. .
Soft Reset
Syntax:
<SOH>R<CR>
Response:
<SOH>0<CR> Positive response.
Description:
Initializes the hardware and the firmware, causes the controller to stop sending data, and
recalculates the environmental conditions (for example, stray and offset values). The
Reset command also cancels the Calibrate command and returns the controller to normal
operation.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
37
3M Touch Systems recommends that the host system issue a Reset command whenever
the host system is powered on and is attempting to establish communication with the
controller.
The amount of time needed to execute a Reset command is typically 500 milliseconds
with a defined maximum of 2000 milliseconds. Therefore, the application program
should wait and be sure it receives the command response before issuing another
command to the controller following the reset.
Restore Defaults
Syntax:
<SOH>RD<CR>
Response:
Description:
<SOH>0<CR> Positive response.
Returns to the factory default operating parameters. The Restore Defaults command
copies the 3M Touch Systems factory default parameters from ROM to the non-volatile
memory (NOVRAM) and then executes a Reset command.
The following table lists the factory defaults for the PX controller. The Restore Defaults
command is useful in situations where inadvertent commands to the controller have
rendered the sensor inoperative.
Table 18 PX Factory Default Settings
Operating Parameter
Baud Rate
Default
115,200
Serial Communication Settings
Data Format
Operating Mode
N, 8, 1
Format Tablet Multitouch
Mode Stream
Yes
Return to Factory Calibration
Note: After you issue a Restore Defaults command, you must recalibrate your sensor.
Unit Type
<SOH>UT<CR>
Responds with an 8-character identity string. This string identifies the type of controller
currently attached to the system, lists the features supported by the controller, and
outputs the status of the controller hardware (a self-test code).
Returns an identification code up to 8 ASCII characters in the following format:
<SOH>TtFfffSs<CR>
where:
Tt
= Two ASCII characters that identify the controller type.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
38
3M™ Multi-touch Display M2256PW User Guide
AD
Indicates the PX series of controllers
Ffff = Four ASCII characters that indicate the features supported by the
controller.
**** Indicates no additional features configured
Ss
= Two ASCII characters that provide status information about the
controller hardware. The two characters represent one byte. Each
character is in the range 0 to 9 and A to F.
Table 2 defines the meaning of each bit in the status byte. Each bit
can be set to 1 or 0, where 1 = an error and 0 = no error. So a
response of:
00 = No diagnostic errors (normal response)
The PX running with no errors returns the following string:
<SOH> AD****00 <CR>
The format includes two bitmapped ASCII hex status bytes. A “00” indicates no errors.
Table 19 Bit Meanings in Status Byte
Bit
0
Description
Not used
Notes
1
2
3
4
ROM_ERROR
PWM Error
NOV_ERROR
HDW_ERROR
Not used
Code area checksum error
Touch screen not connected or potential problem.
Parameter Block1 checksum error
Problem with ADCs
5
6
Not used
7
Not used
Touch Data Format
The format is a six byte packet that includes one status byte, four bytes of binary X,Y
position data and a touch ID. The X,Y coordinates are 14 bits, providing a range of 0 to
16,383. The data is sent in the following format:
Table 20 Touch Data Format Settings
Data Sequence
Bits
7
6
5
4
3
2
1
0
Status - Byte 1
X - Byte 2
X - Byte 3
1
0
0
0
P1
0
0
0
0
0
0
X6
X13
Y6
X5
X12
Y5
X4
X11
Y4
X3
X10
Y3
X2
X9
Y2
X1
X8
Y1
X0
X7
Y0
Y - Byte 4
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
39
Data Sequence
Bits
7
6
5
4
3
2
1
0
Y - Byte 5
ID – Byte 6
0
0
Y13
N6
Y12
N5
Y11
N4
Y10
N3
Y9
N2
Y8
N1
Y7
N0
Note 1: P is the proximity bit. It is set to 1 when there is a touch, 0 for a liftoff.
The ID is associated with a touch stream from one finger. The ID, in the range of 0-127,
is assigned on a rotating basis at touchdown. A finger touch stream consists of a
touchdown, maybe some continuing touch points, ending with a liftoff. The ID is
released on liftoff, and becomes available to be reassigned.
When multiple fingers are down, the packets from the touch streams are sent interleaved.
There is no order imposed on the interleave.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
40
3M™ Multi-touch Display M2256PW User Guide
APPENDIX C
Regulatory Information
Regulatory Agency Approvals
Your product complies with the following regulatory standards:
FCC-B
CE
•
•
•
•
UL60950/IEC60950/EN60950 certified in compliance with the CB test scheme
RoHS/WEEE directives
This equipment has been tested and found to comply within limits for a Class B digital
device, pursuant to Part 15 of the FCC rules. These limits are designed to provide
reasonable protection against harmful interference in residential installations. This
equipment generates, uses and can radiate radio frequency energy, and if not installed
and used in accordance with the instructions, may cause harmful interference to radio
communications. However, there is no guarantee that interference will not occur in a
particular installation. If this equipment does cause interference to radio or television
equipment reception, which can be determined by turning the equipment off and on, the
user is encouraged to try to correct the interference by one or more of the following
measures:
• Reorient or relocate the receiving antenna.
• Move the equipment away from the receiver.
• Consult the dealer or an experienced radio/television technician for additional
suggestions.
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
3M™ Multi-touch Display M2256PW User Guide
41
CAUTION
You are cautioned that any change or modification to the equipment not expressly
approved by the party responsible for compliance could void your authority to operate
such equipment.
This Class B digital apparatus meets all requirements of the Canadian Interference-
Causing Equipment Regulations.
Cet appareil numérique de la classe B respecte toutes les exigences du Règlement sur le
matériel brouilleur du Canada.
This device complies with Part 15 of the FCC rules: Operation is subject to the following
two conditions: (1) This device may not cause harmful interference, and (2) this device
must accept any interference received, including interference that may cause undesired
operation.
FCC Warning
To assure continued FCC compliance, the user must use grounded power supply cord
and the provided shielded video interface cable with bonded ferrite cores. If a BNC cable
is going to be used, use only a shielded BNC(5) cable. Also, any unauthorized changes or
modifications not expressly approved by the party responsible for compliance could void
the user’s authority to operate this device.
3M Touch Systems is not responsible for any radio or television interference caused by
using other than recommended cables and connectors or by unauthorized changes or
modifications to this equipment.
CE Conformity for Europe
The device complies with the requirements of the ECC directive 2004/108/EC with
regard to “Electromagnetic compatibility” and 2006/95/EC with regard to "Safety".
3M Touch Systems, Inc. Proprietary Information – 37531 Rev D
|