input/devices/iforce-protocol.rst

7 Home page at `<http://web.archive.org/web/*/http://www.esil.univ-mrs.fr>`_
16 specify force effects to I-Force 2.0 devices.  None of this information comes
25     send data to your I-Force device based on what you read in this document.
30 All values are hexadecimal with big-endian encoding (msb on the left). Beware,
31 values inside packets are encoded using little-endian.  Bytes whose roles are
35 ------------------------
40 2B OP LEN DATA CS
51 The 2B, LEN and CS fields have disappeared, probably because USB handles
63     LEN= Varies from device to device
64     00 X-Axis lsb
65     01 X-Axis msb
66     02 Y-Axis lsb, or gas pedal for a wheel
67     03 Y-Axis msb, or brake pedal for a wheel
80     LEN= Varies
90 ------------
95     LEN= 0e
111 	    Bits 4-7: Val 2 = effect along one axis. Byte 05 indicates direction
112 		    Val 4 = X axis only. Byte 05 must contain 5a
113 		    Val 8 = Y axis only. Byte 05 must contain b4
115 	    Bits 0-3: Val 0 = No trigger
117 	    When the whole byte is 0, cancel the previously set trigger
119     03-04 Duration of effect (little endian encoding, in ms)
123     06-07 Minimum time between triggering.
125     08-09 Address of periodicity or magnitude parameters
126     0a-0b Address of attack and fade parameters, or ffff if none.
128     08-09 Address of interactive parameters for X-axis,
130     0a-0b Address of interactive parameters for Y-axis,
133     0c-0d Delay before execution of effect (little endian encoding, in ms)
137 ---------------------
145     LEN= 08
146     00-01 Address where to store the parameters
147     02-03 Duration of attack (little endian encoding, in ms)
148     04 Level at end of attack. Signed byte.
149     05-06 Duration of fade.
158     LEN= 03
159     00-01 Address
160     02 Level. Signed byte.
168     LEN= 07
169     00-01 Address
170     02 Magnitude. Signed byte.
171     03 Offset. Signed byte.
173     05-06 Period (little endian encoding, in ms)
176 ----------------------
181     LEN= 0a
182     00-01 Address
196 --------
201     LEN= 03
206 	    Val 41: Start and play n times (See byte 02 below)
210 ----
222     FF LEN QUERY VALUE_QUERIED CHECKSUM2
223     where LEN = 1 + length(VALUE_QUERIED)
244 at the same time (one byte)
300 Sends back 3 bytes - major, minor, subminor
314     LEN= 2 or 3
329     LEN= 1
341     LEN= 1
348 ----------------
354  - period : 0c
355  - magnitude : 02
356  - attack and fade : 0e
357  - interactive : 08
381 I-Force is trademark of Immersion Corp.