Real-time, ultra-low-latency audio and sensor processing system for BeagleBone Black
 All Classes Files Functions Variables Typedefs Macros Groups

Open Sound Control

This example shows an implementation of OSC (Open Sound Control) which was developed at UC Berkeley Center for New Music and Audio Technology (CNMAT).

It is designed to be run alongside resources/osc/osc.js. For the example to work, run in a terminal on the board ``` node /root/Bela/resources/osc/osc.js ```

The OSC server port on which to receive is set in setup() via oscServer.setup(). Likewise the OSC client port on which to send is set in oscClient.setup().

In setup() an OSC message to address /osc-setup, it then waits 1 second for a reply on /osc-setup-reply.

in render() the code receives OSC messages, parses them, and sends back an acknowledgment.

____ _____ _ _
| __ )| ____| | / \
| _ \| _| | | / _ \
| |_) | |___| |___ / ___ \
|____/|_____|_____/_/ \_\
The platform for ultra-low latency audio and sensor processing
A project of the Augmented Instruments Laboratory within the
Centre for Digital Music at Queen Mary University of London.
(c) 2016 Augmented Instruments Laboratory: Andrew McPherson,
Astrid Bin, Liam Donovan, Christian Heinrichs, Robert Jack,
Giulio Moro, Laurel Pardue, Victor Zappi. All rights reserved.
The Bela software is distributed under the GNU Lesser General Public License
(LGPL 3.0), available here:
#include <Bela.h>
#include <OSCServer.h>
#include <OSCClient.h>
OSCServer oscServer;
OSCClient oscClient;
// this example is designed to be run alongside resources/osc/osc.js
// parse messages received by OSC Server
// msg is Message class of oscpkt:
int parseMessage(oscpkt::Message msg){
rt_printf("received message to: %s\n", msg.addressPattern().c_str());
int intArg;
float floatArg;
if (msg.match("/osc-test").popInt32(intArg).popFloat(floatArg).isOkNoMoreArgs()){
rt_printf("received int %i and float %f\n", intArg, floatArg);
return intArg;
int localPort = 7562;
int remotePort = 7563;
const char* remoteIp = "";
bool setup(BelaContext *context, void *userData)
oscClient.setup(remotePort, remoteIp);
// the following code sends an OSC message to address /osc-setup
// then waits 1 second for a reply on /osc-setup-reply
bool handshakeReceived = false;
while (oscServer.messageWaiting()){
if (oscServer.popMessage().match("/osc-setup-reply")){
handshakeReceived = true;
if (handshakeReceived){
rt_printf("handshake received!\n");
} else {
return true;
void render(BelaContext *context, void *userData)
// receive OSC messages, parse them, and send back an acknowledgment
while (oscServer.messageWaiting()){
int count = parseMessage(oscServer.popMessage());
oscClient.queueMessage("/osc-acknowledge").add(count).add(4.2f).add(std::string("OSC message received")).end());
void cleanup(BelaContext *context, void *userData)