AIR-Series OSC Documentation

X AIR Mixer OSC Document (fw 1.11) 2/4
Server messages
Operation
OSC address
Parameters
Comments
1.0 info
request
/info or
/xinfo
<string server_version>
(/xinfo: <sting
ip_address>)
<string device_name>
<string device_model>
<string device_version>
Name=value pair strings e.g.
“device_version=1.2”. First four are
defined, and required. Further args
are implementation dependent
1.1 status
request
/status
<string status>
<string ip address>
<string server name>
..
Status should be “active” or
“standby” depending on whether
server is currently able to fulfil
subscriptions. IP address of the form
“192.168.2.1”. Server name is to
uniquely identify this console.
Further args are implementation
dependent
1.3
set single
1.4
get single
parameter
<OSC path-
formatted
parameter
name>
<string|int|float|blob
value>
Echoes the value of a parameter in
response to a get, set or fulfilment of
single parameter subscription, e.g.
/ch/01/mix/fader
1.5
subscribe
to meter
values
<client-
specified id>
<blob data>
Blob contains meter data (signed
integer 16 bit, resolution 1/256 dB)
as single binary blob
Type rules (get/set parameter)
• parameters must be big-endian and 4-byte aligned/padded, as per OSC specification
• float parameters must be in range 0.0 – 1.0
• integer parameters are signed 32-bit values
• boolean parameters will map to OSC integer type
• strings must be null-terminated
Meter subscriptions
meter subscriptions are used to request a set of meter values,e.g.:
/meters ,si “/meters/0” 8 (meterID ,oscvalues <string> <integer>)
Binary OSC message:
2f 6d 65 74 65 72 73 00 2c 73 69 00 2f 6d 65 74 ; /meters.,si./met
65 72 73 2f 30 00 00 00 00 00 00 08 ; ers/0.......
… returns 8 channel meters (pre-fader l/r, gate and comp gain reduction, post-fader l/r
meters, gate key, comp key) of channel 9: