Carrol Touch TouchSystems CarrollTouch Prog, Programmer'S Manual, Page: 161 / 274

Appendix B - Smart-Frame Protocol II Function Reference CARROLL TOUCH
B-12 Touch System Programmer’s Guide
GetTouchState (01H)
Command Description
The GetTouchState (01H) command instructs the touch system to
return the current touch state and coordinates.
Command Format
01
Report Description
The Touch State Report contains the touch state and x, y, and z
coordinates that together describe the current state of the touch system.
The touch state parameter is a single byte that reports whether the touch
system is currently being touched. The x, y, and z coordinates are all
16-bit parameters that report the location and pressure of the touch. If
the touch system does not support the z-axis, the z-axis parameter is 0.
The host should use either the TouchReportingMode parameter in the
SetTouchModes (20H) command (the preferred method) or the
ReportingMode parameter in the SetReportProperties (21H) command
to indicate under what conditions the Touch State Report should be
sent.
• To send Touch State Reports to the host only when requested, set
the Reporting Mode to solicited only.
• To send Touch State Reports continuously or whenever a
parameter changes, set the Reporting Mode to continuous or
parameter change, respectively.
Report Format
01 TouchState XCoordHi XCoordLo YCoordHi
YCoordLo ZCoordHi ZCoordLo
TouchState
= Value for the TouchState parameter:
00 = Not touched. The x, y, and z parameters report
where and how hard the screen was last touched.
01 = Touched. The x, y, and z parameters report where
and how hard the screen is currently being
touched.
02 = Non-contiguous. The x, y, and z parameters are
undefined if the screen is being touched with
more than one finger.