Logitech Magellan/SPACE MOUSE Classic, Programmer'S Manual

Page: 7 / 26

7
Data Rate Setup Command
Function: Defines the maximum and
minimum time periods.
Command: p<nibble1><nibble2>\r
<nibble1>
<B7...4> <B3><B2><B1><B0>
< max period >
<nibble2> <B7...4> <B3><B2><B1><B0>
< min period >
<max
period>
= 0...15 The maximum time period is
given in milliseconds by the
formula:
(<max period> + 1) * 20
<min
period>
= 0...15 The minimum time period is
given in milliseconds by the
formula:
(<min period> + 1) * 20
Returns: The selected data rate (in the
same format as the command).
For example, the packet "p?B\r" sets the
maximum time period to 320 ms and the
minimum time period to 60 ms. Note that
Magellan/SPACE MOUSE is not able to transmit
data packets with a time period shorter than
60 ms.
Data Rate ? Command
Function: Interrogates the selected
maximum and minimum time
periods.
Command: pQ\r
Returns:
p<nibble1><nibble2>\r
<nibble1>
<B7...4> <B3><B2><B1><B0>
< max period >
<nibble2> <B7...4> <B3><B2><B1><B0>
< min period >
See complete nibble descriptions in previous
section, Data Rate Setup Command.
Zeroing Command
Function: Defines a new zero at the current
position of the cap. All
subsequent translational and
rotational values are relative to
this position.
Command: z\r
Returns:
z\r
Note that the Magellan/SPACE MOUSE does
not transmit any further data until the cap is
moved again.
Sensitivity Setup Command
Function: Sets the sensitivity of the
Magellan/SPACE MOUSE. Defines
relationships between 1)
translational displacements of the
cap and the corresponding
translational data sent to the
computer, and 2) rotational
displacements of the cap and the
corresponding rotational data
sent to the computer.
Command: q<nibble1><nibble2>\r
<nibble1>
<B7...4> <B3><B2><B1><B0>
< sensitivity tra >
<nibble2> <B7...4> <B3><B2><B1><B0>
< sensitivity rot >
= 0 The relationship is linear. <sensitivity
tra>
= 1...15 A corresponding ballistic
(quadratic) function is used.
= 0 The relationship is linear.
<sensitivity
rot>
= 1...15 A corresponding ballistic
(quadratic) function is used.
Returns: The selected sensitivity (in the
same format as the command).
For example, the packet "q00\r" defines the
sensitivity of both the translation and rotation
as purely linear. Note that the output values
are in the approximate range of ±400. The
ballistic functions may be estimated as follows:
÷÷ø
ö
ççè
æ
> < =
÷÷ø
ö
ççè
æ
nt displaceme
input
y sensitivit
value
ouput
* * 2
Sensitivity ? Command
Function: Interrogates the current
sensitivity values of the
Magellan/SPACE MOUSE.
Command: qQ\r
Returns:
q<nibble1><nibble2>\r
<nibble1>
<B7...4> <B3><B2><B1><B0>
< sensitivity tra >
<nibble2> <B7...4> <B3><B2><B1><B0>
< sensitivity rot >
See complete nibble descriptions in previous
section, Sensitivity Setup Command.
Null Radius Setup Command
Function: Defines the null radius of the
Magellan/SPACE MOUSE.
Command: n<nibble>\r
<nibble> <B7...4> <B3><B2><B1><B0>
< null radius >