Specifications

Appendix B - Smart-Frame Protocol II Function Reference CARROLL TOUCH
B-14 Touch System Programmer’s Guide
SetReportProperties (21H)
Command Description
The SetReportProperties (21H) command acts in conjunction with the
SetReportTransferMode (22H) command to control under what
conditions the touch system generates reports.
Note
This command is not implemented in the GW DSP Serial
Controller firmware. The reporting mode for all SFP-II functions
except GetTouchState (01H) is set to Solicited Only Mode and
cannot be changed. The reporting mode for GetTouchState (01H)
can be set to Solicited Only Mode, Parameter Change Mode, or
Continuous Mode using SetTouchModes (20H).
The SetReportProperties (21H) command sets the reporting mode for
individual SFP-II functions via the ReportingMode parameter. The
available reporting modes are:
Solicited Only Mode - The touch system only sends the selected
report in response to having received the
corresponding command.
Parameter Change Mode- The touch system sends the selected
report both in response to having received
the corresponding command and
whenever any of the parameters
contained in the report changes.
Continuous Mode - The touch system sends the selected
report in response to having received the
corresponding command and each time
that it executes its main executive loop.
Parameter Change Mode and Continuous Mode produce “unsolicited
reports,” because reports are sent by the touch system when other
conditions occur, without the corresponding SFP-II command having
been received.
The SetReportProperties (21H) command is an overloaded command.
• If the host sends only the SetReportProperties (24H) command
number and the report number for a report, the report properties of
that report are not modified and the Report Properties Report is
sent to report the current report properties of the selected report.