Developers

Draft specification for review

OSC address space (proposal)

The show-control face of EDC loudspeakers — an Open Sound Control namespace modelled on Meyer's and d&b's conventions so QLab, Companion and TouchDesigner users find it familiar.

Markdown version: /developers/osc.md

Status: proposal. Provided first by the OSC bridge in the SDK and simulator, later natively. Ports <TBD>.

Transport: UDP, paired listen and reply ports as d&b’s DS100 does. Namespace prefix /edc/<device> where <device> is the device name or serial; * wildcards address an array. Integer indices and a fixed prefix follow Meyer’s /processing/input/1/gain style. Every SET has a matching GET — send the address with no arguments to receive the current value.

Address Arguments Meaning
/edc/discover Broadcast query; devices reply /edc/<device>/info s:model s:firmware s:ip
/edc/<device>/beam/<n>/aim f pan_deg, f tilt_deg Aim beam n (±60°)
/edc/<device>/beam/<n>/shape f h_width, f v_width, f h_skew, f v_skew Coverage shape (2°–120°, skew in dB per degree)
/edc/<device>/beam/<n>/level f dB Beam level
/edc/<device>/beam/<n>/delay f ms Beam delay
/edc/<device>/beam/<n>/mute i 0/1 Beam mute
/edc/<device>/beam/<n>/input i 1–3 Source input for the beam
/edc/<device>/input/<n>/gain f dB Input trim
/edc/<device>/input/<n>/mute i 0/1 Input mute
/edc/<device>/input/<n>/eq/<b> s type, i bypass, f freq, f gain, f q EQ band b (1–8)
/edc/<device>/preset/recall s presetId Recall a preset on the device or its array
/edc/<device>/apply Commit staged changes (mirrors the app’s Push/Apply)
/edc/<device>/status Query; replies /edc/<device>/status/temp f and /edc/<device>/status/fault i:transducer s:code
/edc/<device>/subscribe i seconds Periodic telemetry to the sender

QLab example

A QLab workspace of network cues against the simulator will be published with the SDK: recall the “lecture” preset on cue 10, mute beam 3 on cue 11, restore on cue 12.