Hardware — control surfaces

Connecting a Digidesign Control|24.

The Control|24 and the ProControl talk to their host over Ethernet, in a protocol of their own called DigiNet. libdiginet is a library that speaks it. This page says what the desk needs from the network and how to install the library and its test tool.

01

What DigiNet is on the wire.

DigiNet is not IP. Every frame is a raw Ethernet II frame with EtherType 0x885F: no IP address, no DHCP, no port number. The desk is known by its MAC address, which starts with Digidesign's prefix 00:a0:7e.

An idle desk broadcasts an announce to ff:ff:ff:ff:ff:ff about every 7 seconds, with its name (CNTRL|24 on a Control|24) and its firmware version. A host answers it, and from then on every frame is unicast between the desk's MAC and the host's MAC: faders, keys, lamps, displays, meters, and the acknowledgements and keepalives that hold the session up.

The 7-second interval and a port at 10 Mbit/s half duplex were measured on a ProControl, the Control|24's sibling of the same generation. A modern network card cabled straight to the desk may not settle on that link mode, and a cheap unmanaged 10/100 switch between the two does.

02

It needs a network interface of its own.

The desk talks over a 10 Mb/s half-duplex link. REAC's discovery goes out as bursts of broadcast frames, about 800 full-size frames at a time, untagged and on every VLAN sub-interface of the interface it runs on. On a shared wire, one burst fills the desk's link for about a second, and the desk stops answering. It does not come back by itself while the bursts go on.

So give the desk a wired interface that carries nothing else; a USB network adapter is fine. In ~/.config/reac-pw/reac-pw.conf, name that interface in a [segment …] section with ignore = yes, and restart reac-pw: its log then says the interface is not sniffed, not served and not minted. Power-cycle the desk once on that quiet link.

The frames themselves are small: libdiginet puts at most 48 commands and 314 bytes in one, and paces display writes 2 ms apart.

03

What the network needs.

  • The same layer-2 segment, with no router in between.

    DigiNet has no IP header, so a router has nothing to route. The desk and the console host must be on the same Ethernet segment: one cable, or switches only.

  • The untagged (native) VLAN of the host's port.

    The desk sends plain frames with no VLAN tag. Use the plain interface of its own NIC, not a VLAN sub-interface.

  • A cable from the desk to the host.

    Some Wi-Fi bridges and range extenders forward only IP and ARP and drop an EtherType they do not know. Keep the path from the desk to the host wired. Web UI clients on Wi-Fi are fine: they talk IP to the console.

  • Not on the REAC stagebox link.

    Not on the interface that carries the REAC stageboxes, and not on a VLAN of it: a VLAN on the same cable carries the same discovery bursts. The desk goes on its own interface, switched off in reac-pw.

04

Faders follow the console.

A desk fader follows the console's fader position, not the scale printed beside it. Its full travel is the console's full range: the bottom stop is the console's bottom, and the top stop its top. Read the level in the web UI or on the scribble strip.

A fader that will not reach the bottom (or the top) at its stop is a hardware fault: a worn or dirty track stops short. The console does not stretch or calibrate a fader to make up for it. Clean the fader, or have it repaired.

05

Security.

DigiNet has no authentication. The desk takes a session with whichever host answers its announce, with no password and no key, and nothing in a frame proves who sent it.

On a network you control, that is enough. On a venue LAN shared with other people, give the desk and the console host a segment of their own: a separate switch, or a VLAN that only the two of them are on.

The desk also accepts a family of system messages (F0 13 xx 70 …) that writes to its own memory. libdiginet refuses to send it.

06

Install.

libdiginet is in the Open-Mixer package repositories: RPMs for Fedora (x86_64, aarch64) and DEBs for Debian bookworm and trixie (amd64, arm64). Add the repository as on the other pages and install diginet-tools, which brings the library with it.

sudo dnf install https://www.openmixer.org/rpm/openmixer-release.noarch.rpm
sudo dnf install diginet-tools

libdiginet · libdiginet0 · libdiginet-transport0

The protocol library and its transport: discovery, the session handshake, acknowledgements, keepalive and retransmit.

diginet-tools

diginet-probe, the command-line tool for testing a desk.

libdiginet-devel · libdiginet-dev

Headers, pkg-config files and the protocol grammar, for building a program on the library.

diginet-probe opens a packet socket, and that needs one capability, cap_net_raw. The package sets it on /usr/bin/diginet-probe when it installs, so the probe runs as your own user, not as root. A copy you build yourself has no capability until you run setcap cap_net_raw=ep on it, and again after every rebuild.

With the desk cabled and powered on, the first look sends nothing: it only listens for the announce. The probe then wakes the desk, moves fader 1, lights a lamp, writes a scribble strip, logs every key and touch, and ends with a summary.

# listen only: the desk's announce, about every 7 seconds
sudo tcpdump -i <if> -e 'ether proto 0x885f'

# wake the desk and run the first test
diginet-probe -i <if>

Every option and exit status of the probe: docs/probe.md. The protocol as it is known, with a source for every claim: docs/protocol.md.

07

Status.

In development

The library is released: it holds the protocol, the transport and the probe.

openmixer

A software mixing console for Linux. The desk is the software; the browser is the surface.

Pages

Licence

OpenMixer is free software under the GPL-3.0-or-later. Every package in the workspace carries the same licence.

Roland, Midas, Behringer, RME and the product names used here belong to their respective owners. OpenMixer is an independent project and is not affiliated with any of them.