Firmware-72 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. If pulse is enabled/disabled with the SET OUTPUT command the pulse is also enabled/disabled at power-up but this can be changed by using the SET OUTPUT INIT command. If the pulse is enabled and no pulse width value is set to use at power-up, the pulse width to use at power-up is set to zero. Enabling the pulse overrides the output on/off setting. The command can be used in both modes of operation. After a RESET of the USB-microDig, all outputs’ pulse 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 SEND 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 pulse (also at power-up)
	p = 0; disable pulse (also at power-up)
	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]; pulse width 1-2 ms (ie. steps of approx. 8 microseconds)

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}, 247 (F0h, 7Dh, 00h, 30h, 61h, 7Fh, 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}, 247 (F0h, 7Dh, 00h, 30h, 41h, 00h F7h)

When disabling the pulse the pulse width value is ignored.