Wiki - Medialab Terata

SL04DMX

Tutorial de control DMX amb QLC+ i la caixa SL04

Què és cada peça

QLC+ (Q Light Controller+) és programari lliure de control d'il·luminació DMX/Art-Net/sACN, multiplataforma (Linux, Windows, macOS).

SL04 és una caixa "tot en un" del fabricant hahan123.com, pensada sobretot per aprendre i fer servir consoles comercials (grandMA, Avolites, Chamsys...) mitjançant plugins DLL a Windows. Per al nostre cas amb QLC+ a Linux, el que interessa és:

  • Parla de manera nativa els protocols Art-Net, sACN i MA-NET, sense necessitat de cap plugin ni "crack". Els DLL que anuncia el fabricant són específics per a programari comercial de Windows i no calen amb QLC+.
  • Té 4 sortides DMX512 físiques amb aïllament òptic i admet entrada DMX (DMXin).
  • Es pot connectar per USB (es presenta com a targeta de xarxa virtual, tipus RNDIS — no és un port sèrie) o per LAN amb cable de xarxa (en aquest cas cal alimentar-la a part amb 5V pel port USB).
  • Té una ranura per a targeta TF (microSD) per gravar i reproduir seqüències DMX de forma autònoma (standalone), sense ordinador.
  • IP de fàbrica: 2.0.0.44, màscara 255.255.255.0 (/24).

Requisits

  • Debian (Bookworm 12, Trixie 13 o posterior).
  • Caixa SL04 amb cable USB (Tipus-C) o cable de xarxa, segons el mètode escollit.
  • Permisos d'administrador (sudo).

Instal·lació de QLC+

QLC+ està als repositoris oficials de Debian, no cal descarregar cap .deb extern:

sudo apt update

sudo apt install qlcplus

Si vols la versió més recent (els repos de Debian estable poden anar per darrere de l'última release), pots consultar la versió empaquetada a packages.debian.org o baixar un AppImage dels builds de desenvolupament de la versió 5 al repositori de GitHub del projecte (mcallegari/qlcplus). No hi ha (de moment) cap paquet Flatpak oficial, malgrat que a vegades es menciona com a possibilitat futura al fòrum del projecte.

Connexió física de la SL04

El fabricant adverteix explícitament: mai connectis alhora l'USB de la caixa i un cable LAN al mateix ordinador (ni a cap altre). Tries un dels dos mètodes següents; tots dos són vàlids, no n'hi ha un de "recomanat" per defecte, depèn de la teva situació:

Opció A — USB (targeta de xarxa virtual)

Connecta la SL04 a un port USB de l'ordinador. Debian hauria de reconèixer-la automàticament com una nova interfície de xarxa gràcies al driver de kernel rndis_host (inclòs de sèrie). Comprova-ho amb:

ip link show

dmesg | tail -30

Hauries de veure una interfície nova (tipus enx... seguit de la MAC, o similar). Nota: aquest comportament amb Linux es basa en el suport estàndard de RNDIS del kernel; el fabricant només ho documenta explícitament per a Windows.

Aquesta és la via més senzilla per fer servir directament amb QLC+ des del mateix ordinador.

Opció B — LAN (cable de xarxa)

Connecta un cable de xarxa entre la teva targeta Ethernet i el port LAN de la SL04. En aquest cas cal alimentar la caixa a part, connectant el seu port USB a un carregador de 5V (el fabricant insisteix a no fer servir carregadors ràpids barats, poden fer malbé la caixa). Aquesta opció és útil si vols connectar la caixa a través d'un switch, controlar-la a distància, o si no tens un port USB lliure.

Primera activació de la caixa (obligatòria)

Abans de fer-la servir, la SL04 exigeix una activació única per internet mitjançant la seva WebAPP integrada:

  1. Posa la teva interfície de xarxa (la USB o la LAN, segons el mètode escollit) amb una IP fixa dins del mateix segment que la caixa, per exemple 2.0.0.22, màscara 255.255.255.0 (vegeu secció "Configurar la IP fixa a Debian").
  2. Assegura't que l'ordinador té sortida a internet per una altra interfície (p. ex. wifi) per poder activar la caixa.
  3. Obre al navegador http://2.0.0.44 (amb http, no https — alguns navegadors ho forcen automàticament i falla; si passa, esborra la "s" manualment de la barra d'adreces).
  4. Omple el formulari d'activació (nom i correu) i confirma. Només cal fer-ho una vegada; queda desat permanentment a la caixa.

Sobre USB vs LAN per activar: amb firmware antic (5.1) l'activació només es podia fer per USB. Des del firmware 5.3 (posterior al 20 de desembre de 2024, per tant present a pràcticament totes les unitats actuals) també es pot activar directament pel port LAN.

Configurar la IP fixa a Debian

És fonamental que la interfície connectada a la SL04 tingui una IP fixa al mateix segment que la caixa (per defecte 2.0.0.x/24), i que cap altra interfície de l'ordinador (Ethernet integrada, wifi, interfícies virtuals de màquines virtuals, etc.) estigui també en aquest segment 2.x.x.x, per evitar conflictes d'encaminament.

⚠️ Important: la màscara ha de ser 255.255.255.0 (/24). Fer servir 255.0.0.0 (/8) és un error — el fabricant ho indica explícitament al seu Q&A tècnic.

Per fer una prova ràpida (temporal, es perd en reiniciar): 

   sudo ip addr add 2.0.0.22/24 dev <interfície> 
   sudo ip link set <interfície> up 
   ping 2.0.0.44

Per deixar-ho fix, amb NetworkManager (nmcli): 

   nmcli connection show                     # localitza el nom de la connexió   d'aquesta interfície 
   nmcli connection modify "Nom-connexió" ipv4.addresses 2.0.0.22/24 
   nmcli connection modify "Nom-connexió" ipv4.method manual 
   nmcli connection up "Nom-connexió"

O bé amb nmtui (interfície de text) si prefereixes un menú guiat, o des de l'eina de xarxa del teu entorn d'escriptori (KDE Plasma, GNOME, etc.).

Si fas servir ifupdown en lloc de NetworkManager, a /etc/network/interfaces: 

   auto enx001122334455 
   iface enx001122334455 inet static
     address 2.0.0.22
     netmask 255.255.255.0

Configurar QLC+ perquè parli amb la SL04 per Art-Net

  1. Obre QLC+ i entra al mode de disseny (icona d'engranatge o Ctrl+D si estàs en mode operador).
  2. A la part inferior de la finestra principal, clica la pestanya/icona Input/Output (Entrada/Sortida). És una única pantalla, no dues pestanyes separades.
  3. A l'esquerra tens la llista d'universos interns de QLC+ (per defecte n'hi ha 4; es poden afegir o eliminar amb els botons + / – de la barra d'eines d'aquesta llista — aquests botons afegeixen universos, no línies de sortida).
  4. Selecciona l'universe que vulguis fer servir (p. ex. Universe 1). A la dreta apareixerà la llista de plugins detectats, amb columnes d'Entrada, Sortida i Feedback.
  5. Busca la fila del plugin Art-Net (o sACN, la SL04 admet tots dos de manera nativa) i marca el tick a la columna de Sortida per a la interfície de xarxa correcta (la que has configurat a 2.0.0.22, no la wifi ni cap altra).
  6. Amb la línia ja marcada, clica el botó de configuració (icona de clau anglesa) per obrir el diàleg d'Universos:
    • IP Address: pots deixar-ho en mode broadcast (adreça acabada en .255, p. ex. 2.0.0.255) o posar directament la IP de la caixa (2.0.0.44) per enviar en unicast i reduir trànsit de xarxa.
    • L'Universe 1 de QLC+ correspon per defecte a l'Universe 0 d'Art-Net (QLC+ resta 1 automàticament). Tingues-ho en compte si a la SL04 has de fer coincidir manualment l'universe.
  7. Repeteix per a cada universe/port DMX físic de la SL04 que vulguis fer servir (la caixa té 4 sortides DMX independents, cadascuna es pot mapejar a un universe Art-Net diferent).

Comprovar que la sortida arriba a la caixa

  • Entra a la WebAPP de la SL04 (http://2.0.0.44) i fes servir la funció de DMXin / detector DMX512, o el visor de nivells de canal, per comprovar en temps real si li arriba senyal des de QLC+.
  • A QLC+, crea un Simple Desk amb un parell de canals i puja els faders: hauries de veure moviment reflectit a la WebAPP de la caixa o directament al projector/fixture connectat al port corresponent.
  • Presta atenció a la correspondència de ports físics: és un error freqüent confondre l'universe assignat al programari amb el port físic (PORT0–PORT3) on està connectat el cable DMX real.
  • Si tens un tallafocs actiu (ufw), assegura't que no bloqueja el trànsit UDP al port 6454 (Art-Net) o 5568 (sACN) a la interfície corresponent.

Ús de la targeta TF (microSD) en mode autònom

La SL04 fa servir una ranura per a targeta TF (microSD) que permet gravar i reproduir seqüències DMX sense necessitat de tenir l'ordinador connectat.

  1. Preparació: insereix una targeta microSD a la ranura de la caixa. Es recomana formatar-la en FAT32 per compatibilitat (el fabricant no ho especifica explícitament, però és l'estàndard habitual en aquest tipus de dispositius encastats).
  2. Gravació (Capture): a la WebAPP (secció Offline), pots gravar la sortida DMX de la pròpia caixa o l'entrada DMXin (p. ex. el senyal enviat des de QLC+). Selecciona quins ports físics (0 a 3) vols gravar; per defecte es graven els 4. Inicia la gravació, executa la seqüència a QLC+, i atura-la. Pots donar-li un nom (admet noms en diversos idiomes, inclòs català).
  3. Llista de reproducció: a la mateixa secció Offline, arrossega i ordena els arxius gravats segons la seqüència del teu show, i prem "My Offline Play List" per desar-la a la memòria interna de la caixa.
  4. Reproducció automàtica (AutoPlay) i bucles: marca la casella AutoPlay perquè, cada cop que engeguis la caixa, reprodueixi automàticament aquesta llista sense intervenció externa. Pots definir el nombre de bucles (màxim 6000, equivalent a diversos dies de reproducció contínua). Important: si canvies el nombre de bucles, has de tornar a prémer AutoPlay perquè es desi el canvi.
  5. Enrutament (Routing): per defecte, el que es grava des de l'entrada DMXin es reprodueix pel PORT3. Des de la WebAPP pots redirigir aquesta sortida: 0 (PORT0), 1 (PORT1), 2 (PORT2), A (tots els ports alhora) o – (desactivat).
  6. Editar els arxius des de Debian: com que FAT32 és nativament compatible amb Linux, pots extreure la targeta, connectar-la amb un lector USB al teu Debian, i copiar-hi o editar-hi arxius directament sense dependre només de la gravació en temps real.

Preguntes freqüents sobre la connexió

La SL04 es connecta directament per RJ45 a l'ordinador?

No hi ha una única resposta correcta i universal: tots dos mètodes són vàlids (vegeu secció "Connexió física de la SL04"). Si el teu ordinador no té cap NIC Ethernet lliure, o vols la via més senzilla per a un únic equip, l'USB sol ser la més còmoda i directa. Si necessites integrar la caixa en una xarxa amb switch, controlar-la a distància, o el teu ordinador ja fa servir el port USB per a una altra cosa, el port LAN/RJ45 és una alternativa igual de vàlida — sempre tenint en compte de no connectar USB i LAN alhora.

Per on surt la senyal DMX cap als llums?

Sempre pels 4 ports DMX512 físics de la caixa (no pel connector de xarxa de l'ordinador). El fabricant no especifica a la seva documentació el tipus exacte de connector (XLR, RJ45 adaptat, etc.); consulta les fotos del producte o el manual físic de la teva unitat per confirmar-ho.

Resolució de problemes

Símptoma Causa probable Solució
No hi ha ping a 2.0.0.44 Una altra interfície de xarxa de l'ordinador també és al rang 2.x.x.x, màscara incorrecta (/8 en lloc de /24), o el cable/USB no connecta bé Deixa només una interfície al segment 2.x.x.x amb màscara /24; revisa ip link i dmesg
No surt DMX encara que QLC+ sembla configurat Universe Art-Net / port físic mal assignat Revisa la correspondència universe↔port a la WebAPP i a QLC+
El navegador no obre la WebAPP S'ha forçat https en lloc de http Escriu explícitament http://2.0.0.44, neteja la memòria cau/cookies del navegador
En reiniciar l'ordinador la IP fixa desapareix Amb NetworkManager, si la connexió no ha quedat en mode "manual" pot tornar a DHCP Confirma ipv4.method manual amb nmcli connection show "Nom-connexió"
No es pot activar la caixa Interferència d'una altra interfície al segment 2.x.x.x, o falta de sortida a internet des de l'ordinador Comprova que només una interfície és al segment 2.x.x.x i que hi ha una altra via (wifi) amb accés a internet

Referències oficials

Retrieved from "https://wiki.terata.org/index.php?title=SL04DMX&oldid=452"