© Quantum Research Group Ltd.
5.2 Scope Commands
5.3 Status Commands
Status commands cause the sensor to report back
information related to keys and their signals.
The host should always set the scope parameter when
initializing the part during normal operation as well as during
setup. Scope commands are persistent and apply to all
subsequent functions that are affected by scope, until a
different scope command is issued. On powerup or after reset
the device defaults to scope = 'all keys'.
It is not necessary to set the part to Get mode with these
commands, although it is advised to leave the part in Get
mode as a normal precaution (see Section 5.1)
Many functions only address one key regardless of the
current scope; in these cases the key being addressed is
always the key last set by the 's' or 'x' and 'y' commands. If
the 's' command was last set to key #9 (x=1, y=1), then even
though the 'S' command was issued afterwards the one-key
scope will remain key '9'. If 'x' were subsequently set to 2 then
one-key scope will be key x=2, y=1 (key #10). If 'y' were
subsequently set to 3, then one-key scope will be key x=2 /
y=3 (key #26). This rule operates for commands in either Put
or Get modes.
0
0
X
30 - SIGNAL FOR
S
Bytes / Cmd # Bytes Rtnd
INGLE
K
EY
Scope
n/a
Returns
n/a
0x00..0xFF
Put
Get
n/a
1
n/a
1
1
Numeric '0'. Returns the signal level in 8-bit unsigned binary
for one key whose location is determined by scope. Note that
the signal level is inverted: decreasing values correspond to
more touch due to the physics of key detection described in
Section 1.1.
Key numbering convention: The numbering of keys goes by
row then column. For example, the key in row X=3, column
Y=1 (X3Y1) is key 11. The formula for conversion of an X-Y
location to a key number is:
1
0
X
31 - DELTA
S
IGNAL FOR
S
Bytes / Cmd # Bytes Rtnd
INGLE
K
EY
Scope
n/a
Returns
n/a
0x00..0xFF
Put
Get
n/a
1
n/a
1
1
key_number = X_row + (Y_column x 8)
Row and column numbers are per Fig. 1-6. Keys are acquired
in this same burst sequence, i.e. X0Y0, X1Y0, X2Y0 etc.
Numeric '1'. Returns the value {Reference - Signal} in
unsigned 8-bit binary for one key whose location is
determined by scope. If Signal > Reference, the result is
truncated to zero.
s
0
X
73 - SPECIFIC
K
Bytes / Cmd 2nd Byte Range
EY
S
COPE
Scope
n/a
n/a
Returns
0x73
n/a
Increasing amounts of this value correspond to increasing
amounts of touch as the sign of signal is inverted (see 0x30
above).
Put
Get
2
n/a
0x00..0x3F
n/a
Lowercase 'S'. Targets a specific individual key for all further
functions that are affected by scope. The second byte must
contain a binary key number from 0..63 decimal.
2
0
X
32 - REFERENCE
V
Bytes / Cmd # Bytes Rtnd
ALUE
Scope
n/a
Returns
n/a
0x00..0xFF
Put
Get
n/a
1
n/a
1
1
S
0
X
53 - ALL
Scope
n/a
K
EYS
S
Bytes / Cmd 2nd Byte Range
COPE
Returns
0x53
n/a
Numeric '2'. Returns the Reference value in unsigned 8-bit
binary for one key whose location is determined by scope.
Put
Get
1
n/a
n/a
n/a
n/a
3
0
X
33 - R2R OFFSET
Uppercase 'S'. Addresses all keys in the matrix for all further
functions that can target a group of keys.
Scope
n/a
Bytes / Cmd # Bytes Rtnd
Returns
n/a
0x00..0xFF
Put
Get
n/a
1
n/a
1
1
x
0
X
78 - ROW
Scope
n/a
K
EYS
S
Bytes / Cmd 2nd Byte Range
COPE
Returns
0x78
n/a
Section 1.2, p. 4
Put
Get
2
n/a
0x00..0x07
n/a
Numeric '3'. Returns the R2R offset value in unsigned 8-bit
binary for one key whose location is determined by scope.
This function is useful primarily for circuit diagnostics or for an
independent determination of proper circuit operation.
n/a
Lowercase 'X'. Targets keys in a specific row for functions
that can address key groups. The second byte must contain a
row number from 0..7. This command also affects scope for
single-key commands.
4
0
X34 - C
Z
S
TATE
Scope
n/a
Bytes / Cmd # Bytes Rtnd
Returns
n/a
0x00..0x02
y
0
X
79 - COLUMN
K
Bytes / Cmd 2nd Byte Range
EYS
S
COPE
Put
Get
n/a
1
n/a
1
Scope
n/a
n/a
Returns
0x79
n/a
1
Put
Get
2
n/a
0x00..0x07
n/a
Section 1.2, p. 4
Numeric '4'. Returns the Cz state for one key whose location
is determined by scope. This function is useful primarily for
circuit diagnostics or for an independent determination of
circuit operation after calibration. A higher value indicates
more Cz cancellation is being applied to compensate for Cx;
a value of 2 indicates both Cz caps are being switched in.
Lowercase 'Y'. Targets keys in a specific column for functions
that can address key groups. The second byte is a binary
column number from 0..7. This command also affects scope
for single-key commands.
lQ
21
www.qprox.com QT60xx5 / R1.05
QUANTUM [ QUANTUM RESEARCH GROUP ]
