UNOFFICIAL X32 OSC REMOTE PROTOCOL PDF

Preview

Summary

          UNOFFICIAL X32/M32  OSC REMOTE PROTOCOL            OSC protocol implementation for the  X32/M32 Digital Mixing Console families  Applies to console FW ver 4.0 and later                        Initiated from version 1.01 (Oct‐17‐2012)  version 4.06 – 09 (Mar 17, 2022)                    Ack...

Description

         

UNOFFICIAL X32/M32  OSC REMOTE PROTOCOL           

OSC protocol implementation for the  X32/M32 Digital Mixing Console families  Applies to console FW ver 4.0 and later 

     

             

Initiated from version 1.01 (Oct‐17‐2012)  version 4.06 – 09 (Mar 17, 2022) 

 

 

 

 

            Acknowledgements      This document regroups data contained in version 1.01 of the OSC protocol for the X32 family of products  released by Behringer in Oct. 2012, and a large number of additional OSC messages for communicating  with the X32, their syntax and use, along with practical examples and explanations as to how and in  which context they should be used. This document should also apply to M32, a product from Midas, very  similar to X32.    Behringer is not associated to the redaction of this document and no support will be provided by the  company.    I have tried to make the information contained here as accurate as possible. A few areas are still prone to  inaccuracies or uncertainties as to how to best use them. Please do not hesitate to provide feedback on  the X32 user forum on errors or inaccuracies. They will be corrected in futures updates.    I want to thank X32 forums well known Paul Vannatto for his invaluable support, generous time and  advice in reviewing early versions of this document.    As you read through this document, you may like a “hands on” experience with testing OSC commands, it  is recommended you use a utility to send/read commands to/from the X32. Such utilities ensure the  commands will be properly formatted and offer better support for reading OSC data back from X32/M32.     X32_Command1 is a terminal based utility running on Windows, Linux, OSX and Raspberry  platforms, supporting batch and interactive modes, timed commands, multi‐tag parameters, and  also scenes, snippets, and presets. Download it from  https://sites.google.com/site/patrickmaillot/x32.     X32 Live Toolbox2  is a GUI based utility running in Windows, Linux and OSX. It also offers  additional features such as EQ copy. Download it from  http://sourceforge.net/projects/x32livetoolbox/    With my purchase of an X32 digital mixer and as I started to find out more about OSC and ways to  achieve more with the X32 via programs, I have spent quite some time designing and coding several  utilities and applications for the M/X32 family of systems. Late 2015, I decided to open‐source the code  for the programs I wrote. These can be found at https://github.com/pmaillot/X32‐Behringer. I’ll continue  to add programs as I finally “clean” them before publishing.      Note: Starting with X32 FW release 4.0, this manual will follow the X32 FW release numbering rather than  its own numbering scheme; For example, “version 4.02 – 01 (Jan 12, 2020)” refers to update 01 of the  document for FW 4.02, issued on Jan 12th, 2020. 

       

Patrick‐Gilles Maillot  

1 X32_Command: © 2014‐2018 Patrick‐Gilles Maillot  2 X32 Live Toolbox: © 2014‐2018 Paul Vannatto 

   

Contents DESCRIPTION ...................................................................................................................................................... 6  Client initiated messages (client  X32 console) ........................................................................................... 8  Multiple client management .......................................................................................................................... 9  Server replies or server initiated messages (X32 console  client) ............................................................ 10  X32/M32 OSC Protocol Parameters ............................................................................................................. 10  Type rules (Get/Set parameter) and data formatting .................................................................................. 11  Responses from X32/M32: ....................................................................................................................... 12  Special considerations for the enum type. ............................................................................................... 12  Float type. ................................................................................................................................................. 13  MIDI Connections ......................................................................................................................................... 15  Meter requests ................................................................................................................................................. 16  List of all Meter IDs: ...................................................................................................................................... 17  /meters/0 ............................................................................................................................................ 17  /meters/1 ............................................................................................................................................ 17  /meters/2 ............................................................................................................................................ 17  /meters/3 ............................................................................................................................................ 17  /meters/4 ............................................................................................................................................ 17  /meters/5  ...................................................................... 18  /meters/6  .............................................................................................................. 18  /meters/7 ............................................................................................................................................ 18  /meters/8 ............................................................................................................................................ 18  /meters/9 ............................................................................................................................................ 18  /meters/10 .......................................................................................................................................... 18  /meters/11 .......................................................................................................................................... 18  /meters/12 .......................................................................................................................................... 18  /meters/13 .......................................................................................................................................... 18  /meters/14 .......................................................................................................................................... 19  /meters/15 .......................................................................................................................................... 19  /meters/16 .......................................................................................................................................... 19  X32/M32   Client communications ................................................................................................................. 20  Configuration (/config) data ..................................................................................................................... 20  Channel (/ch) data .................................................................................................................................... 25  Aux In (/auxin) data .................................................................................................................................. 28  FX Return (/fxrtn) data ............................................................................................................................. 30  Bus (/bus) data ......................................................................................................................................... 31  Matrix (/mtx) data .................................................................................................................................... 33  Main Stereo (/main/st) data..................................................................................................................... 35  Main Mono (/main/m) data ..................................................................................................................... 37  DCA groups (/dca) data ............................................................................................................................ 39  Effects (/fx) data ....................................................................................................................................... 40  Output sets (/output) data ....................................................................................................................... 41  Headamp (/headamp) data ...................................................................................................................... 43  Inserts (/‐insert) data ............................................................................................................................... 43   

Unofficial X32/M32 OSC Remote Protocol 

2 

 

Patrick‐Gilles Maillot 

   

Show, Cue, Scene, Snippet, and Preset Management ................................................................................. 44  Scene Safes: How do they work? ............................................................................................................. 44  Presets (/‐libs) .......................................................................................................................................... 45  Manipulation of datasets (/add, /copy, /save, /load, /delete, /rename) ................................................ 45  Notes on the use of /showdump .............................................................................................................. 55  X32/M32 console status commands ............................................................................................................ 57  Preferences (/‐prefs) data ........................................................................................................................ 57  USB (/‐usb) data ....................................................................................................................................... 61  Status (/‐stat) data ................................................................................................................................... 62  Action (/‐action) data & Undo (/‐undo) ................................................................................................... 70  X‐Live! sdcard recording (/‐urec) .............................................................................................................. 73  X‐Live! recording data .................................................................................................................................. 75  Recording data format ................................................................................................................................. 75  Recording Session ..................................................................................................................................... 75  Preproduced Session (for playback) ......................................................................................................... 76  Drop Outs ................................................................................................................................................. 76  Fragmentation .......................................................................................................................................... 76 

Subscribing to X32/M32 Updates ..................................................................................................................... 77  Subscribing to data updates ..................................................................................................................... 80  X32node (/node, / ) commands ....................................................................................................................... 81  EFFECTS ............................................................................................................................................................ 89  Effects Parameters ....................................................................................................................................... 89  Hall Reverb ................................................................................................................................................... 89  Plate Reverb ................................................................................................................................................. 90  Ambiance Reverb ......................................................................................................................................... 90  Rich Plate Reverb .......................................................................................................................................... 91  Room Reverb ................................................................................................................................................ 91  Chamber Reverb ........................................................................................................................................... 92  4‐Tap Delay ................................................................................................................................................... 92  Vintage Reverb ............................................................................................................................................. 93  Gated Reverb ................................................................................................................................................ 94  Stereo Delay ................................................................................................................................................. 95  3‐Tap Delay ................................................................................................................................................... 96  Stereo Chorus ............................................................................................................................................... 97  Stereo Flanger .............................................................................................................................................. 97  Stereo Phaser ............................................................................................................................................... 98  Dimensional Chorus...................................................................................................................................... 98  Mood Filter ................................................................................................................................................... 99  Rotary Speaker ............................................................................................................................................. 99  Tremolo / Panner ....................................................................................................................................... 100  Delay / Chamber ......................................................................................................................................... 100  Suboctaver .................................................................................................................................................. 101  Delay / Chorus ............................................................................................................................................ 101  Delay /Flanger ............................................................................................................................................ 102  Chorus / Chamber ...................................................................................................................................... 102  Flanger / Chamber ...................................................................................................................................... 103  Modulation Delay ....................................................................................................................................... 103   

Unofficial X32/M32 OSC Remote Protocol 

3 

 

Patrick‐Gilles Maillot 

   

Dual Graphic Equalizer / True Dual Graphic Equalizer ............................................................................... 104  Graphic Equalizer / True Graphic Equalizer ................................................................................................ 104  Stereo / Dual De‐Esser ................................................................................................................................ 105  Precision Limiter ......................................................................................................................................... 105  Stereo  / Dual Program EQ ......................................................................................................................... 106  Stereo / Dual Midrange EQ ........................................................................................................................ 108  Stereo / Dual Combinator .......................................................................................................................... 109  Stereo / Dual Fair Compressor ................................................................................................................... 112  Stereo / Dual Leisure Compressor .............................................................................................................. 113  Edison EX1 .................................................................................................................................................. 113  Stereo / Dual Ultimo Compressor .............................................................................................................. 114  Sound Maxer .............................................................................................................................................. 114  Stereo / Dual Enhancer .............................................................................................................................. 115  Stereo Imager ............................................................................................................................................. 116  Stereo / Dual Guitar Amp ........................................................................................................................... 117  Stereo / Dual Pitch Shifter .......................................................................................................................... 119  Wave Designer............................................................................................................................................ 119 

User ASSIGN Section ....................................................................................................................................... 120  Rotary Encoders (X32/M32 Standard) ....................................................................................................... 121  Buttons (X32/M32 Standard) ..................................................................................................................... 123  Appendix – X32 Standard: Surface Controls ....