Firmware-72 Command-049

From I-CubeX Wiki
Jump to: navigation, search

SET OUTPUT INIT (49, 31h)

The SET OUTPUT INIT command sets the output status at power-up of the USB-microDig. 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 host and stand-alone modes of operation. All output settings are stored in both volatile and non-volatile memory. After a RESET of the USB-microDig, all outputs’ pulse statuses are retrieved from non-volatile memory whether in stand-alone mode or in host mode. 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 INIT command.

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

0xp00yyy: x = 1; output on
x = 0; output off
p = 1; enable pulse
p = 0; disable pulse
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 at power-up to 1.5ms, the following message is sent:

240, 125, 0 {DEV}, 49 {SET OUTPUT INIT}, 97 {x = 1, p = 1, yyy = 1}, 64 {pulse width}, 247 (F0h, 7Dh, 00h, 31h, 61h, 40h, F7h)

The pulse width is 1 + 64*0.008 = 1.5ms

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

240, 125, 0 {DEV}, 49 {SET OUTPUT INIT}, 1 {x = 0, p = 0, yyy = 1}, 0 {pulse width}, 247 (F0h, 7Dh, 00h, 31h, 01h, 00h, F7h)

When disabling the pulse the pulse width value is ignored.