- Control d'il·luminació DMX amb QLC+ i la caixa SL04 a Debian
> **Nota de verificació:** aquesta guia s'ha elaborat i contrastat amb la documentació oficial de [QLC+](https://docs.qlcplus.org) i amb la web/Q&A tècnic oficial del fabricant de la SL04 ([hahan123.com](http://hahan123.com/mybox/super-all-in-one-box/)). S'han corregit diversos punts d'una guia prèvia generada per una altra IA que contenien errors (sobretot la màscara de xarxa i l'obligatorietat de l'USB per a l'activació).
- 1. 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)**.
- 2. 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`).
- 3. Instal·lació de QLC+
QLC+ està als repositoris oficials de Debian, no cal descarregar cap `.deb` extern:
```bash 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](https://packages.debian.org/search?keywords=qlcplus) 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.
- 4. 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:
```bash 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.
- 5. 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ó 6). 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.
- 6. 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):
```bash 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`):
```bash 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
```
- 7. 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).
- 8. 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.
- 9. Ús de la targeta TF (microSD) en mode autònom
La SL04 fa servir una ranura per a targeta **TF (microSD)**, no CF (CompactFlash), 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.
- 10. 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ó 4). 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.
- 11. 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 |
- 12. Referències oficials
- Documentació QLC+, instal·lació: https://docs.qlcplus.org/v4/basics/installation - Documentació QLC+, gestor Input/Output: https://docs.qlcplus.org/v4/input-output - Documentació QLC+, plugin Art-Net: https://docs.qlcplus.org/v4/plugins/art-net - Web oficial de la SL04: http://hahan123.com/mybox/super-all-in-one-box/ - Q&A tècnic oficial de la SL04 (IPs, xarxa, activació, targeta TF): http://hahan123.com/2024/12/27/technical-post-and-sl04-qa-summary/ - Paquet QLC+ a Debian: https://packages.debian.org/search?keywords=qlcplus - Codi font i builds de QLC+: https://github.com/mcallegari/qlcplus