Difference between revisions of "Connect-165 OSC Input"
(Created page with " If the OSC messages match (case insensitive) the format /<digitizer_name>/<output_name> <set_value>, where digitizer_name is the name of a connected digitizer, and set_value...") |
|||
(7 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
+ | Connect can receive OSC messages to control actuator outputs of a digitizer. See the [[Connect-165_Preferences | preferences]] section to configure Connect for this feature. | ||
− | If the OSC messages match (case insensitive) the format /<digitizer_name>/<output_name> <set_value>, where digitizer_name is the name of a connected digitizer, and set_value is in {.. -128, 0 .. 127, 128 .. }, the set_value will be mapped to a SET OUTPUT message (see the [[Firmware |firmware]] pages) | + | If the OSC messages match (case insensitive) the format "/<digitizer_name>/<output_name> <set_value>", where digitizer_name is the name of a connected digitizer, and set_value is in {.. -128, 0 .. 127, 128 .. }, the set_value will be mapped to a SET OUTPUT message (see the [[Firmware |firmware]] pages) as follows: |
− | |||
− | |||
{| | {| | ||
− | |<b>OSC Message</b> | + | |<b>set_value of OSC Message</b> |
|<b>Action</b> | |<b>Action</b> | ||
|- | |- | ||
Line 14: | Line 13: | ||
|- | |- | ||
|128 (or more) or "on" (case insensitive) | |128 (or more) or "on" (case insensitive) | ||
− | | | + | |turn output on |
|- | |- | ||
|} | |} | ||
− | + | The pulse width value maximum is 125. | |
− | Sending the same message while the actuator output is configured for an I2C actuator will set the actuator method of the I2C actuator to | + | Example: |
+ | |||
+ | The OSC message "/USB-microDig_0123/Output_01 62" will set an actuator output configured for a PWM actuator to output a pulse with a width that's half of the configured range, so in case of the default PWM configuration (ie. 1 ms range, from 1 to 2 ms) that would be 1.5 ms. | ||
+ | |||
+ | Sending the same message while the actuator output is configured for an I2C actuator will set the actuator method of the I2C actuator to 62. |
Latest revision as of 13:41, 16 April 2022
Connect can receive OSC messages to control actuator outputs of a digitizer. See the preferences section to configure Connect for this feature.
If the OSC messages match (case insensitive) the format "/<digitizer_name>/<output_name> <set_value>", where digitizer_name is the name of a connected digitizer, and set_value is in {.. -128, 0 .. 127, 128 .. }, the set_value will be mapped to a SET OUTPUT message (see the firmware pages) as follows:
set_value of OSC Message | Action |
0 .. 127 | enable and set pulse width modulation (if implemented) or set the I2C actuator method as per OSC message value |
-128 (or less) or "off" (case insensitive) | turn output off |
128 (or more) or "on" (case insensitive) | turn output on |
The pulse width value maximum is 125.
Example:
The OSC message "/USB-microDig_0123/Output_01 62" will set an actuator output configured for a PWM actuator to output a pulse with a width that's half of the configured range, so in case of the default PWM configuration (ie. 1 ms range, from 1 to 2 ms) that would be 1.5 ms.
Sending the same message while the actuator output is configured for an I2C actuator will set the actuator method of the I2C actuator to 62.