Specifications

CARROLL TOUCH Appendix B - Smart-Frame Protocol II Function Reference
Touch System Programmer’s Guide B-15
• If the host sends the entire SetReportProperties (21H) command
with all parameters, the report properties of that report are
modified and the Report Properties Report are sent to report the
current report properties of the selected report.
• If the host sends the SetReportProperties (21H) command number
with any other combination of parameters, an invalid parameter
error is returned in Cmderr.
In general, the touch system firmware should allow all reports to be set
to any reporting mode, even if it does not seem sensible. For example,
the reporting mode of the GetProtocolVersion (65H) function can be
set to either Parameter Change Mode or Continuous Mode, but the
protocol version is not likely to change.
If the firmware is implemented so that there is one place in the code that
decides when to send a report for all reports, then no extra development
effort is required to allow the report to be set to all modes, even though
it doesn't make sense to do so. In fact, extra development effort would
be required to prevent the report from being able to be set to all
reporting modes.
If, however, a situation arises where it is deemed necessary to prohibit
a particular report from being set to a particular reporting mode,
SetReportProperties (21H) should use the Cmderr parameter to report
an invalid parameter for the ReportingMode parameter to indicate that
the desired reporting mode is not supported by that particular report.
Command Format
21 ReportNumber
or
21 ReportNumber ReportingMode
ReportNumber
= Specifies the report that is to have its properties modified
or reported.
ReportingMode
= Value for the reporting mode parameter:
00 = Solicited only.
01 = Parameter change.
02 = Continuous.
Report Description
The Report Properties Report returns the current report properties for
the specified report.