OSC Documentation 0.59

©Patrick‐GillesMaillot 14 WINGOSC–V0.59

WINGOSCMessages
Inthefollowingparagraphs,weassumeacommunicationlinkexistsbetweenWINGandaclient
program,andcommunicationtakesplacewithaWINGconsoleataknownIPaddress,usingUDPon
port
2223.
Inthetextshownbelow,thecharacter
‘~’willrepresentaNULLbyte(\0).Patterns‐>WandW‐>
representdatasenttoWINGanddatareceivedfromWINGfollowedbytheactualnumberofbytes
transmittedorreceived,respectively.

RetrievingWINGconsoleinformationcanbecompletedbysendingtheOSCAddressPattern“
/?”
‐>W,4B:/?~~
W‐>,80B:
/?~~,s~~WING,192.168.1.71,PGM,ngc‐full,NO_SERIAL,1.07.2‐40‐g1b1b292b:develop~~~~

Theactualbytesexchangedaredisplayedbelow(OSCisabinaryprotocol)
‐>W,4B:2f3f0000
W‐>,80B:
2f3f00002c73000057494e472c3139322e3136382e312e37312c50474d2c6e67632d66756c6c2c4e4f5f5345524
9414c2c312e30372e322d34302d6731623162323932623a646576656c6f7000000000

ThelinebelowisusingamorecompliantOSCformat,andwillresultinthesameanswer
‐>W,8B:/?~~,~~~
Reading(Get)ParameterandNodedata
TherearetwomainwaystogainaccesstoWINGdata:usingone‐parameter‐at‐a‐timeorusing
“nodes”.
WING“nodes”areagreatwaytoaccessmultipleparametersatatime,andthereforemaximize
communicationbandwidthwiththeconsole.NodesarerepresentedasstringOSCDataTypeandare
zeroterminated(
\0byteendingthestring).
NodesarealsoagoodwaytodiscoverWINGparameters,astheyoffereasyaccesstothefullmapof
theJSONinternaldatastructures.
WeshowbelowWING’sfirstlayerofJSONstructure,andstartingattheroot,retrievedusingOSC.

‐>W,4B:/~~~
W‐>,116B:
/~~~,ssssssssssssssss~~~$stat~~~cfg~$syscfg~io~~ch~~aux~bus~main~~~~mtx~dca~mgrp~~~~fx~~car
ds~~~play~~~~rec~$ctl~~~~

RetrievingaWINGsingleparameterisquiteeasy:YoumustensureyourOSCrequestpointstoaleaf
oftheJSONstructure(i.e.,thereisnomorehierarchydataafterthecurrentone).Thisisthecasefor
thefadervalueofachannelstripforexample,oritsmutestate.ChannelStrip1faderisrepresented
asfollows:



