Logitech Magellan/SPACE MOUSE Classic Programmer's Manual page 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>
<nibble2>
<B7...4> <B3><B2><B1><B0>
<max = 0...15
period>
<min
= 0...15
period>
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>
<nibble2>
<B7...4> <B3><B2><B1><B0>
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.
< max period >
< min period >
The maximum time period is
given in milliseconds by the
formula:
(<max period> + 1) * 20
The minimum time period is
given in milliseconds by the
formula:
(<min period> + 1) * 20
< max period >
< min period >
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>
<nibble2>
<B7...4> <B3><B2><B1><B0>
<sensitivity = 0
tra>
= 1...15
<sensitivity = 0
rot>
= 1...15
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:
æ ouput ö
ç ç ÷ ÷
= <
* 2 sensitivit
value
è ø
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>
<nibble2>
<B7...4> <B3><B2><B1><B0>
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>
7
< sensitivity tra >
< sensitivity rot >
The relationship is linear.
A corresponding ballistic
(quadratic) function is used.
The relationship is linear.
A corresponding ballistic
(quadratic) function is used.
æ input
ç ç
>
y *
displaceme nt
è
< sensitivity tra >
< sensitivity rot >
< null radius >
ö
÷ ÷
ø