Firmware-820 Command-048

SET OUTPUT (48, 30h)

The SET OUTPUT command can be used to turn any of the 8 available actuator outputs on or off. Enabling continuous control overrides the output on/off setting. The command can be used in both modes of operation. After a RESET of the WiDig, all outputs’ continuous control statuses are retrieved from non-volatile memory as set by the SET OUTPUT INIT command. Upon completion of the command the digitizer sends out the same command. To get the values stored in non-volatile memory, use the DUMP OUTPUT command.

The [BODY] of the SET OUTPUT command consists of two 7-bit bytes with the following format:

0xp00yyy:	x = 1; output on
	x = 0; output off
	p = 1; enable continuous control (also at power-up), in the form of actuator method or pulse width variation
	p = 0; disable continuous control (also at power-up), in the form of actuator method or pulse width variation
	yyy = [0..7]; actuator output number, where the first actuator output number = 0, and the last (8th) actuator output number = 7
0zzzzzzz:	zzzzzzz = [0..127]; actuator method MSB or pulse width 1-2 ms (ie. steps of approx. 8 microseconds)
0wwwwwww:	wwwwwww = [0..127]; actuator method LSB or not used

Example:

In order to set the 2nd actuator output pulse width to 2.0ms, the following message is sent:

240, 125, 0 {DEV}, 48 {SET OUTPUT}, 97 {x = 1, p = 1, yyy = 1}, 127 {pulse width}, 0, 247 (F0h, 7Dh, 00h, 30h, 61h, 7Fh, 00h, F7h)

The pulse width is 1 + 127 * 0.008 = 2.0ms

In order to turn the same actuator output on but disable the pulse, the following message is sent:

240, 125, 0 {DEV}, 48 {SET OUTPUT}, 65 {x = 1, p = 0, yyy = 1}, 0 {pulse width}, 0, 247 (F0h, 7Dh, 00h, 30h, 41h, 00h, 00h, F7h)

When disabling continuous control the actuator method MSB and LSB values or pulse width value is ignored.