Specifications

102 Chapter 6 - Command Reference
Touch ('t')
On serial controllers, the response may be altered if Partial Emulation is selected
with the Emulate command (see page 80).
Touch packets are generated automatically if Touch Reporting is enabled with the
Quiet command. This is the default with serial controllers.
If automatic touch reporting is disabled by disabling Initial Touch, Stream, and
Untouch Modes (see Mode command, page 90), the Touch command may be used
to query for touch data. This feature is used primarily with multiple serial
controllers sharing a serial line with keyed packets. See Key Byte, page 52.
The coordinates of the touch are signed numbers reported in the X, Y, and Z
integers. The Z coordinate is always set to the maximum Calibration or Scaling
value (default is 255).
The Status byte has the following bit positions. Touch packets will only be
transmitted with the various bits set if the corresponding mode is enabled with the
Mode command.
Bit Status Description
0 Initial Touch If 1, the Touch packet is for an Initial touch.
Initial Touch Mode is enabled by bit 0 in the
Mode1 byte of the Mode command.
1 Stream Touch If 1, the Touch packets is for a Stream
touch, a coordinate transmitted continuously
while the touchscreen is being touched.
Stream Mode is enabled by bit 1 in the
Mode1 byte of the Mode command.
2 Untouch If 1, the Touch packet is for the point of
untouch (when the finger is lifted). Untouch
Mode is enabled by bit 2 in the Mode1 byte
of the Mode command.
3 Reserved
4 Warning(s) Pending If 1, an Acknowledge query should be
issued to receive non-command-related
warning(s).
5 Reserved
6 Out of Range If 1, the Touch packet is outside the
Calibration Points. Range Checking Mode is
enabled by bit 6 in the Mode1 byte of the
Mode command.