# 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.
>
> Status: draft-spec. Canonical: https://www.edcacoustics.com/developers/osc/

> **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.