Maquinari — superfícies de control
Connectar una Digidesign Control|24.
La Control|24 i la ProControl parlen amb l'ordinador per Ethernet, amb un protocol propi que es diu DigiNet. libdiginet és una biblioteca que el parla. Aquesta pàgina explica què necessita la taula de la xarxa i com s'instal·len la biblioteca i la seva eina de prova.
01
Què és DigiNet al cable.
DigiNet no és IP. Cada trama és una trama Ethernet II crua amb EtherType 0x885F: no hi ha adreça IP, ni DHCP, ni número de port. La taula s'identifica per l'adreça MAC, que comença amb el prefix de Digidesign 00:a0:7e.
Quan està inactiva, la taula envia un anunci de difusió a ff:ff:ff:ff:ff:ff cada 7 segons aproximadament, amb el seu nom (CNTRL|24 en una Control|24) i la versió del firmware. L'ordinador hi respon i a partir d'aquí totes les trames són unicast entre la MAC de la taula i la de l'ordinador: faders, tecles, llums, pantalles, vúmetres i els acusaments de recepció i keepalives que mantenen la sessió.
L'interval de 7 segons i un port a 10 Mbit/s semidúplex es van mesurar en una ProControl, la germana de la Control|24 de la mateixa generació. Una targeta de xarxa moderna connectada directament a la taula pot no acabar d'acordar aquest mode d'enllaç; un switch 10/100 senzill i no gestionable entre totes dues ho resol.
02
Necessita una interfície de xarxa pròpia.
La taula parla per un enllaç de 10 Mb/s semidúplex. El descobriment de REAC surt en ràfegues de trames de difusió, unes 800 trames de mida completa cada vegada, sense etiqueta i per cada subinterfície VLAN de la interfície on funciona. En un cable compartit, una ràfega omple l'enllaç de la taula durant un segon aproximadament i la taula deixa de respondre. No torna sola mentre continuen les ràfegues.
Per això, doneu a la taula una interfície amb cable que no porti res més; un adaptador de xarxa USB va bé. A ~/.config/reac-pw/reac-pw.conf, poseu aquesta interfície en una secció [segment …] amb ignore = yes i reinicieu reac-pw: el seu registre diu llavors que la interfície no s'escolta, no se serveix i no s'hi creen subinterfícies. Apagueu i engegueu la taula una vegada en aquest enllaç tranquil.
Les trames en si són petites: libdiginet hi posa com a màxim 48 ordres i 314 bytes i espaia 2 ms les escriptures a les pantalles.
03
Què necessita la xarxa.
El mateix segment de capa 2, sense cap router entremig.
DigiNet no té capçalera IP, així que un router no hi té res a encaminar. La taula i l'ordinador han d'estar al mateix segment Ethernet: un sol cable o només switches.
La VLAN sense etiquetar (nativa) del port de l'ordinador.
La taula envia trames sense etiqueta VLAN. Feu servir la interfície normal de la seva pròpia targeta de xarxa, no una subinterfície VLAN.
Un cable de la taula a l'ordinador.
Alguns ponts i repetidors Wi-Fi només reenvien IP i ARP i descarten els EtherType que no coneixen. Feu que tot el camí de la taula a l'ordinador sigui per cable. Els clients de la interfície web poden anar per Wi-Fi sense problema: parlen IP amb la taula de mescles.
No a l'enllaç REAC dels stageboxes.
Ni a la interfície que porta els stageboxes REAC ni a una VLAN d'aquesta: una VLAN al mateix cable porta les mateixes ràfegues de descobriment. La taula va a la seva pròpia interfície, desactivada a reac-pw.
04
Els faders segueixen la taula de mescles.
Un fader de la taula segueix la posició del fader de la consola, no l'escala impresa al costat. Tot el recorregut és tot el rang de la consola: el tope de baix és el mínim de la consola i el de dalt, el màxim. Llegiu el nivell a la interfície web o a la pantalla de la tira.
Un fader que no arriba a baix (o a dalt) al seu tope té una avaria de maquinari: una pista gastada o bruta s'atura abans. La consola no estira ni calibra un fader per compensar-ho. Netegeu el fader o feu-lo reparar.
05
Seguretat.
DigiNet no té cap autenticació. La taula obre sessió amb qualsevol ordinador que respongui al seu anunci, sense contrasenya ni clau. Res d'una trama no demostra qui l'ha enviada.
En una xarxa que controleu, això n'hi ha prou. En una xarxa local d'una sala compartida amb altra gent, doneu a la taula i a l'ordinador un segment només per a ells: un switch a part o una VLAN on només hi siguin tots dos.
La taula també accepta una família de missatges de sistema (F0 13 xx 70 …) que escriu a la seva pròpia memòria. libdiginet es nega a enviar-la.
06
Instal·lació.
libdiginet és als repositoris de paquets de Open-Mixer: RPM per a Fedora (x86_64, aarch64) i DEB per a Debian bookworm i trixie (amd64, arm64). Afegiu el repositori com a les altres pàgines i instal·leu diginet-tools, que porta la biblioteca.
sudo dnf install https://www.openmixer.org/rpm/openmixer-release.noarch.rpm
sudo dnf install diginet-tools
libdiginet · libdiginet0 · libdiginet-transport0
La biblioteca del protocol i el seu transport: el descobriment, l'inici de sessió, els acusaments de recepció, el keepalive i les retransmissions.
diginet-tools
diginet-probe, l'eina de línia d'ordres per provar una taula.
libdiginet-devel · libdiginet-dev
Capçaleres, fitxers pkg-config i la gramàtica del protocol, per compilar un programa sobre la biblioteca.
diginet-probe obre un socket de paquets i per això necessita una capacitat, cap_net_raw. El paquet la posa a /usr/bin/diginet-probe en instal·lar-se, de manera que l'eina s'executa amb el vostre usuari i no com a root. Una còpia que compileu vosaltres no té cap capacitat fins que hi executeu setcap cap_net_raw=ep. Cal tornar-ho a fer després de cada compilació.
Amb la taula connectada i engegada, la primera mirada no envia res: només escolta l'anunci. Després l'eina desperta la taula, mou el fader 1, encén un llum, escriu en una pantalla de nom, registra cada tecla i cada toc i acaba amb un resum.
# només escoltar: l'anunci de la taula, cada 7 segons aproximadament
sudo tcpdump -i <if> -e 'ether proto 0x885f'
# despertar la taula i fer la primera prova
diginet-probe -i <if>
Totes les opcions i els codis de sortida de l'eina: docs/probe.md. El protocol tal com es coneix, amb una font per a cada afirmació: docs/protocol.md.
07
Estat.
La biblioteca està publicada: inclou el protocol, el transport i l'eina de prova.