3M M2256PW manual Firmware Commands, Controller Initialization

Page 32

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

Image 32
Contents 3M Touch Systems, Inc. Proprietary Information 37531 Rev D 3M Multi-touch Display M2256PW User Guide Contents Appendix C Regulatory Information Appendix a 3M PX USB Controller CommunicationsAppendix B 3M PX Serial Controller Communications Important Safety Information IntroductionOverview Intended UseExplanation of Signal Word Consequences Important Notes Maintaining Your Touch DisplayTouch Sensor Care and Cleaning 3M Touch Systems Support ServicesContact 3M Touch Systems Setting up Your M2256PW Multi-touch Display System RequirementsUnpacking Your Touch Display Cables Included with Your M2256PW Multi-touch DisplayArm Mounting Option Connecting the Touch DisplayTesting the M2256PW Multi-touch Display Using the Standard Controls for the Video Card Applicable Display Mode and Refresh Rate Refresh Rate HzVideo Card Requirements Supported Video Display Modes and Refresh RatesConfiguring the Display Settings Multimedia FeaturesAccess to the Video Controls Menu/Select Down Up Auto/Exit Power LEDAdjusting the M2256PW Video Display Choices DescriptionAudio Tools Enabling Your M2256PW Multi-touch Display Windows 7 USB CompatibilityAll Other Platforms Multitouch Application SupportInstalling 3M MicroTouch Software Video Alignment3M Multi-touch Display M2256PW User Guide Communication Basics 3M PX USB Controller CommunicationsOverview of USB Firmware Communications Command Set Set Feature CalibrationReceiving Reports from the Controller HID Class RequestsCalibration Setup Stage Offset Field Size Value Description Calibration Response Command Status Byte DescriptionDetermining Target Areas Data Stage Offset Field Size Value DescriptionGet Feature GetStatus Get Feature GetMaxCount Power On Check Bit Fields Bit Number DescriptionValid Command Status Field Entries Response Description Setup Stage Offset Field Size Value DescriptionReset Data Stage Offset Field Size Value Description Set Feature ResetReset Setup Stage Offset Field Size Value Description Set Feature -Restore Defaults Coordinate Data MultiTouch Digitizer mode Async ReportAsynchronous Reports Offset Field Size Value DescriptionTouch Report Structure Offset Field Value DescriptionOverview of Firmware Commands 3M PX Serial Controller CommunicationsController Default Settings Operating ModeCommunicating with the Controller Communication ParametersSending Commands to the Controller Receiving Responses from the ControllerFirmware Commands Controller InitializationCommand Code Description CalibrateMDU SOH CxcrGuidelines for Calibrate Command Calibrate ProcedureMode Down Up Mode InactiveMode Stream Get CopyrightName Command Null CommandSoft Reset Output IdentityRestore Defaults Operating Parameter DefaultUnit Type SOH RdcrData Sequence Bits Touch Data FormatBit Description Data Sequence Bits FCC-B Regulatory InformationRegulatory Agency Approvals FCC Warning CE Conformity for Europe