Open Sound Control over Ethernet is the Zone control method from 3rd party controllers.
WebApp includes support for UDP and TCP control of Zone parameters. To send parameters to the unit, open a UDP or TCP socket on port 8000.
/oa/zone/set/zone/n/level/music
/oa/zone/set/zone/n/level/mic
/oa/zone/set/zone/n/level/system_mic_1
/oa/zone/set/zone/n/level/system_mic_2
/oa/zone/set/zone/n/source
/oa/zone/set/zone/n/level_min/music
/oa/zone/set/zone/n/level_min/mic
/oa/zone/set/zone/n/level_min/system_mic_1
/oa/zone/set/zone/n/level_min/system_mic_2
/oa/zone/set/zone/n/level_max/music
/oa/zone/set/zone/n/level_max/mic
/oa/zone/set/zone/n/level_max/system_mic_1
/oa/zone/set/zone/n/level_max/system_mic_2
Replace 'n' with the zone number you want to control from 1 - 8.
For example, to control zone 1 music level send the below address:
/oa/zone/set/zone/1/level/music
To retrieve parameters from the Zone unit, open a TCP connection on port 8000 and send:
/oa/zone/sync
All parameters will be sent back to the client. While the socket remains open, live control changes will be sent to the client.
To retrieve names and status information, send:
/oa/zone/status/sync
Names will be returned with string responses to the following addresses:
/oa/zone/set/name/zone_1
/oa/zone/set/name/zone_2
/oa/zone/set/name/zone_3
/oa/zone/set/name/zone_4
/oa/zone/set/name/zone_5
/oa/zone/set/name/zone_6
/oa/zone/set/name/zone_7
/oa/zone/set/name/zone_8
/oa/zone/set/name/line_in_1
/oa/zone/set/name/line_in_2
/oa/zone/set/name/line_in_3
/oa/zone/set/name/line_in_4
/oa/zone/set/name/hdmi_1
/oa/zone/set/name/hdmi_2
/oa/zone/set/name/local_source_1
/oa/zone/set/name/local_source_2
/oa/zone/set/name/local_source_3
/oa/zone/set/name/local_source_4
/oa/zone/set/name/local_source_5
/oa/zone/set/name/local_source_6
/oa/zone/set/name/local_source_7
/oa/zone/set/name/local_source_8
/oa/zone/set/name/system_mic_1
/oa/zone/set/name/system_mic_2
/oa/zone/set/name/paging_mic_1
/oa/zone/set/name/paging_mic_2
Status responses will be sent with float values to the following addresses:
/oa/zone/status/alarm_mute
/oa/zone/status/power_supply_fault
/oa/zone/status/amp_1_2_dc_fault
/oa/zone/status/amp_3_4_dc_fault
/oa/zone/status/amp_5_6_dc_fault
/oa/zone/status/amp_7_8_dc_fault
/oa/zone/status/system_temperature_fault
/oa/zone/status/amp_overload
/oa/zone/status/fan_fault
/oa/zone/status/amp_1_clip
/oa/zone/status/amp_2_clip
/oa/zone/status/amp_3_clip
/oa/zone/status/amp_4_clip
/oa/zone/status/amp_5_clip
/oa/zone/status/amp_6_clip
/oa/zone/status/amp_7_clip
/oa/zone/status/amp_8_clip
/oa/zone/status/power_supply_ok
/oa/zone/status/system_temperature
/oa/zone/status/fan_temperature
TouchOSC
A collection of example design files are provided for TouchOSC to demonstrate use of OSC control.
Zone8OSC.tosc:
Demonstration of Zone 8 control
Zone8OSC + StatusOSC.tosc:
Demonstration of Zone 8 control with status information
Zone4OSC.tosc:
Demonstration of Zone 4 control
Zone4OSC + StatusOSC.tosc:
Demonstration of Zone 4 control with status information
StatusOSC.tosc:
Demonstration of status monitoring
These are not intended to be used as-is but give examples of every parameter, status and name to be the basic of control panels for your application.
A version string can be retrieved with the path:
/oa/zone/version
the reply is of the form:
v1.3.0
Other clients are available.
OSC templates are available at https://optimal-audio.co.uk/support/software/