Difference between revisions of "Firmware-633 Command-048"

From I-CubeX Wiki
Jump to: navigation, search
(Copied from Firmware-73 Command-048, revision 1950)
 
Line 1: Line 1:
 
==SET OUTPUT (48, 30h)==
 
==SET OUTPUT (48, 30h)==
  
The SET OUTPUT command can be used to turn any of the 8 available actuator outputs on or off. 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 [[Firmware-73 Command-058 |DUMP OUTPUT command]].
+
The SET OUTPUT command can be used to turn any of the 8 available actuator outputs on or off. The command can be used in both modes of operation. After a RESET of the USB-microDig, all outputs’ 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 [[Firmware-73 Command-058 |DUMP OUTPUT command]].
  
 
The [BODY] of the SET OUTPUT command consists of two 7-bit bytes with the following format:
 
The [BODY] of the SET OUTPUT command consists of two 7-bit bytes with the following format:
Line 13: Line 13:
 
|-
 
|-
 
|
 
|
|p = 1; enable pulse (also at power-up)
+
|p = [0..1]; setting without effect
|-
 
|
 
|p = 0; disable pulse (also at power-up)
 
 
|-
 
|-
 
|
 
|
Line 22: Line 19:
 
|-
 
|-
 
|0zzzzzzz:
 
|0zzzzzzz:
|zzzzzzz = [0..127]; pulse width 1-2 ms (ie. steps of approx. 8 microseconds)
+
|zzzzzzz = [0..127]; setting without effect
 
|}
 
|}
  
 
Example:
 
Example:
  
In order to set the 2nd actuator output pulse width to 2.0ms, the following message is sent:
+
In order to turn the 2nd actuator output on, ie. to 5V, 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, 247 (F0h, 7Dh, 00h, 30h, 41h, 00h, F7h)
  
: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)
+
In order to turn the same actuator output off, ie. to 0V, the following message is sent:
  
When disabling the pulse the pulse width value is ignored.
+
:240, 125, 0 {DEV}, 48 {SET OUTPUT}, 1 {x = 0, p = 0, yyy = 1}, 0, 247 (F0h, 7Dh, 00h, 30h, 01h, 00h F7h)

Revision as of 21:44, 11 January 2018

SET OUTPUT (48, 30h)

The SET OUTPUT command can be used to turn any of the 8 available actuator outputs on or off. The command can be used in both modes of operation. After a RESET of the USB-microDig, all outputs’ 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 = [0..1]; setting without effect
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]; setting without effect

Example:

In order to turn the 2nd actuator output on, ie. to 5V, the following message is sent:

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

In order to turn the same actuator output off, ie. to 0V, the following message is sent:

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