Sound Control Protocol for SpeechLine Digital Wireless

SSC Developer‘s guide for SpeechLine Digital Wireless | 2/109
Table of Contents
1. Introduction ...................................................................................................................................... 10
2. Open Sound Control Overview ........................................................................................................11
2.1 JavaScript Object Notation Overview .......................................................................................11
3. Conventions ......................................................................................................................................12
3.1 Terminology .................................................................................................................................12
3.2 Methods for the SL Multi-Channel Receiver DW .................................................................... 12
4. SSC Data Structure Specification .................................................................................................. 13
4.1 Applying JSON to the OSC device model ................................................................................13
4.2 JSON Message Transaction Syntax .......................................................................................... 14
4.3 SSC JSON Message Syntax ....................................................................................................... 14
4.3.1 Elementary data types .........................................................................................................14
4.3.2 SSC Messages .......................................................................................................................15
4.3.3 SSC Addresses ...................................................................................................................... 15
5. SSC subscriptions - /osc/state/subscribe ................................................................................... 16
5.1 Subscription cancelling and expiration .................................................................................... 16
5.2 Subscribing to multiple addresses ...........................................................................................17
5.3 Supscription request and reply syntax ....................................................................................17
5.4 Subscription example transactions ..........................................................................................18
5.4.1 Subscription request, reply and notifications, automatically terminated: .....................18
5.4.2 Subscription request with chosen timeout (2 minutes): ..................................................18
5.4.3 Client cancelling the subscription of the previous example: ..........................................18
6. SSC Transport Layer Adaptations .................................................................................................. 19
6.1 UDP/IP .......................................................................................................................................... 19
6.2 SSC Server Discovery.................................................................................................................19
7. Developer’s Guide for SL Rack Receiver DW .................................................................................20
7.1 Limitations .................................................................................................................................. 20
7.1.1 SSC Transport Layer ............................................................................................................ 20
7.1.2 Subscriptions ........................................................................................................................20
8. SSC Method List (SL Rack Receiver DW) ........................................................................................21
8.1 /interface/version ......................................................................................................................21
8.2 /osc/xid .......................................................................................................................................21
8.3 /osc/version ................................................................................................................................ 21
8.4 /osc/error ....................................................................................................................................21
8.5 /osc/schema .............................................................................................................................. 22
8.6 /osc/limits .................................................................................................................................. 22
8.7 /osc/feature/pattern ................................................................................................................ 23
8.8 /osc/feature/baseaddr ............................................................................................................. 23
8.9 /osc/feature/subscription ....................................................................................................... 23
8.10 /osc/feature/timetag ................................................................................................................ 24
8.11 /osc/state/subscribe ................................................................................................................ 24
8.12 /osc/state/close ........................................................................................................................ 25
8.13 /osc/state/prettyprint .............................................................................................................. 25
8.14 /device/name ............................................................................................................................. 26
8.15 /device/group ............................................................................................................................ 26
8.16 /device/language ...................................................................................................................... 26
8.17 /device/location .........................................................................................................................27
8.18 /device/identity/product...........................................................................................................27
8.19 /device/identity/version ...........................................................................................................27