Specifications

Appendix B - Smart-Frame Protocol II Function Reference CARROLL TOUCH

B-24 Touch System Programmer’s Guide

SetTouchModes (20H)

Command Description

The SetTouchModes (20H) command sets the parameters that control

how the touch system detects and reports touch information.

Note

The only legal value for the TouchStateReportType parameter at

this time is Touch State Report. The Multi Touch State and Raw

Touch State Reports have yet to be defined.

The SetTouchModes (20H) command is an overloaded command.

• If the host sends only the command number, no touch mode

parameters are modified and the Set Touch Modes Report is sent to

report the current state of the touch mode parameters.

• If the host sends the entire command with all parameters, the touch

mode parameters are modified and the Set Touch Modes Report is

sent to report the current state of the touch mode parameters.

• If the host sends the SetTouchModes (20H) command number with

any other combination of parameters, an invalid parameter error is

returned in Cmderr.

The SetTouchModes (20H) command sets the report properties of each

of the Touch State Reports to implement the functionality specified by

the TouchStateReportType and TouchReportingMode parameters. For

example, if the TouchStateReportType parameter was set to Touch

State Report and the TouchReportingMode parameter was set to

Parameter Change Mode, the SetTouchModes (20H) command would

set the TouchState reporting mode to Parameter Change Mode and the

MultiTouchState and RawTouchState reporting modes to Solicited

Only Mode. If the TouchStateReportType parameter was set to

RawTouchState and the TouchReportingMode parameter was set to

Continuous Mode, the SetTouchModes (20H) command would set the

TouchState and MultiTouchState reporting modes to Solicited Only

Mode and the RawTouchState reporting mode to Continuous Mode.

The SetTouchModes (20H) command enables or disables touch

detection explicitly. Even if the reporting mode of all TouchState

reports are set to solicited only, the touch detection state is unaffected.