3M M2256PW manual 3M PX USB Controller Communications, Overview of USB Firmware Communications

Page 21

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

Image 21

Contents 3M Touch Systems, Inc. Proprietary Information 37531 Rev D 3M Multi-touch Display M2256PW User Guide Contents Appendix a 3M PX USB Controller Communications Appendix B 3M PX Serial Controller CommunicationsAppendix C Regulatory Information Introduction Important Safety InformationOverview Intended UseExplanation of Signal Word Consequences Maintaining Your Touch Display Important Notes3M Touch Systems Support Services Touch Sensor Care and CleaningContact 3M Touch Systems System Requirements Setting up Your M2256PW Multi-touch DisplayCables Included with Your M2256PW Multi-touch Display Unpacking Your Touch DisplayConnecting the Touch Display Testing the M2256PW Multi-touch DisplayArm Mounting Option Applicable Display Mode and Refresh Rate Refresh Rate Hz Using the Standard Controls for the Video CardVideo Card Requirements Supported Video Display Modes and Refresh RatesMultimedia Features Configuring the Display SettingsAccess to the Video Controls Menu/Select Down Up Auto/Exit Power LEDChoices Description Adjusting the M2256PW Video DisplayAudio Tools Windows 7 USB Compatibility Enabling Your M2256PW Multi-touch DisplayAll Other Platforms Multitouch Application SupportVideo Alignment Installing 3M MicroTouch Software3M Multi-touch Display M2256PW User Guide 3M PX USB Controller Communications Overview of USB Firmware CommunicationsCommunication Basics Set Feature Calibration Command SetReceiving Reports from the Controller HID Class RequestsCalibration Response Command Status Byte Description Calibration Setup Stage Offset Field Size Value DescriptionDetermining Target Areas Data Stage Offset Field Size Value DescriptionGet Feature GetStatus Power On Check Bit Fields Bit Number Description Get Feature GetMaxCountValid Command Status Field Entries Response Description Setup Stage Offset Field Size Value DescriptionSet Feature Reset Reset Setup Stage Offset Field Size Value DescriptionReset Data Stage Offset Field Size Value Description Coordinate Data MultiTouch Digitizer mode Async Report Set Feature -Restore DefaultsAsynchronous Reports Offset Field Size Value DescriptionValue Description Touch Report Structure Offset Field3M PX Serial Controller Communications Overview of Firmware CommandsOperating Mode Controller Default SettingsCommunicating with the Controller Communication ParametersReceiving Responses from the Controller Sending Commands to the ControllerController Initialization Firmware CommandsCalibrate Command Code DescriptionMDU SOH CxcrCalibrate Procedure Guidelines for Calibrate CommandMode Inactive Mode Down UpMode Stream Get CopyrightNull Command Name CommandSoft Reset Output IdentityOperating Parameter Default Restore DefaultsUnit Type SOH RdcrTouch Data Format Bit DescriptionData Sequence Bits Data Sequence Bits Regulatory Information Regulatory Agency ApprovalsFCC-B CE Conformity for Europe FCC Warning