Difference between revisions of "Connect-165 OSC Input"
| (2 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.  | 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>set_value of OSC Message</b>  | |<b>set_value of OSC Message</b>  | ||
| Line 18: | Line 16: | ||
|-  | |-  | ||
|}  | |}  | ||
| + | |||
| + | The pulse width value maximum is 125.  | ||
Example:    | Example:    | ||
| − | "/USB-microDig_0123/Output_01   | + | 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   | + | 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.