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 stand-alone and host mode. 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, in the form of actuator method or repeating pulse width variation | |
| p = 0; disable continuous control, in the form of actuator method or repeating pulse width variation, and use zzzzzzz as single pulse duration | |
| 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 repeating pulse width 1-2 ms (ie. steps of approx. 8 microseconds), or single pulse duration 0.1-12.7 s (ie. in steps of approx. 0.1 ms) |
| 0wwwwwww: | wwwwwww = [0..127]; actuator method LSB or not used |
When disabling continuous control, the actuator method MSB and LSB values or repeating pulse width value is, if greater than zero, used to set the single pulse duration, ie. the delay after which to switch the actuator output status.
Example:
In order to set the 2nd actuator output repeating 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 {repeating pulse width}, 0, 247 (F0h, 7Dh, 00h, 30h, 61h, 7Fh, 00h, F7h)
The repeating pulse width is 1 + 127 * 0.008 = 2.0ms
In order to turn the same actuator output on but disable continuous control, the following message is sent:
- 240, 125, 0 {DEV}, 48 {SET OUTPUT}, 65 {x = 1, p = 0, yyy = 1}, 0, 0, 247 (F0h, 7Dh, 00h, 30h, 41h, 00h, 00h, F7h)
