No edit summary
No edit summary
Line 1: Line 1:
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ó).
== 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).


1. Què és cada peça
'''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:
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+. - **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)**.
* 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+.
* '''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
== 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`).
* 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 (<code>sudo</code>).


3. Instal·lació de QLC+
== Instal·lació de QLC+ ==
QLC+ està als repositoris oficials de Debian, no cal descarregar cap <code>.deb</code> extern:


QLC+ està als repositoris oficials de Debian, no cal descarregar cap `.deb` extern:
<code>sudo apt update</code>


```bash sudo apt update sudo apt install qlcplus ```
<code>sudo apt install qlcplus</code>


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.
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 [https://packages.debian.org/search?keywords=qlcplus packages.debian.org] o baixar un '''AppImage''' dels builds de desenvolupament de la versió 5 al repositori de GitHub del projecte (<code>mcallegari/qlcplus</code>). 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
== 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ó:


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 <code>rndis_host</code> (inclòs de sèrie). Comprova-ho amb:


Opció A — USB (targeta de xarxa virtual)
<code>ip link show</code>


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:
<code>dmesg | tail -30</code>


```bash ip link show dmesg | tail -30 ```
Hauries de veure una interfície nova (tipus <code>enx...</code> 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.''
 
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.
Aquesta és la via més senzilla per fer servir directament amb QLC+ des del mateix ordinador.


Opció B — LAN (cable de xarxa)
=== 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.
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)


== 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:
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.
# 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 <code>2.0.0.22</code>, màscara <code>255.255.255.0</code> (vegeu secció "Configurar la IP fixa a Debian").
# Assegura't que l'ordinador té sortida a internet per una altra interfície (p. ex. wifi) per poder activar la caixa.
# Obre al navegador <code>http://2.0.0.44</code> (amb '''http''', no https — alguns navegadors ho forcen automàticament i falla; si passa, esborra la "s" manualment de la barra d'adreces).
# 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.
'''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.
== 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 <code>2.0.0.x/24</code>), 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 <code>2.x.x.x</code>, 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.
'''⚠️ 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):
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 (<code>nmcli</code>):
    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 <code>nmtui</code> (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.).


```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 ```
Si fas servir <code>ifupdown</code> en lloc de NetworkManager, a <code>/etc/network/interfaces</code>:
 
    auto enx001122334455  
Per deixar-ho fix, amb NetworkManager (`nmcli`):
    iface enx001122334455 inet static
 
      address 2.0.0.22
```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ó" ```
      netmask 255.255.255.0
 
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
== 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:
# Obre QLC+ i entra al '''mode de disseny''' (icona d'engranatge o <code>Ctrl+D</code> si estàs en mode operador).
# A la part inferior de la finestra principal, clica la pestanya/icona '''Input/Output''' (Entrada/Sortida). És '''una única pantalla''', no dues pestanyes separades.
# 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).
# 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.
# 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 <code>2.0.0.22</code>, no la wifi ni cap altra).
# 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 <code>.255</code>, p. ex. <code>2.0.0.255</code>) o posar directament la IP de la caixa (<code>2.0.0.44</code>) per enviar en ''unicast'' i reduir trànsit de xarxa.
#* L'<nowiki/>'''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.
# 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).


  - **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.
== Comprovar que la sortida arriba a la caixa ==
  - 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).
* Entra a la WebAPP de la SL04 (<code>http://2.0.0.44</code>) 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 (<code>ufw</code>), assegura't que no bloqueja el trànsit UDP al port '''6454''' (Art-Net) o '''5568''' (sACN) a la interfície corresponent.


8. Comprovar que la sortida arriba a la caixa
== Ú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.


- 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.
# '''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).
# '''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à).
# '''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.
# '''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.
# '''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: <code>0</code> (PORT0), <code>1</code> (PORT1), <code>2</code> (PORT2), <code>A</code> (tots els ports alhora) o <code>–</code> (desactivat).
# '''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.


9. Ús de la targeta TF (microSD) en mode autònom
== Preguntes freqüents sobre la connexió ==
'''La SL04 es connecta directament per RJ45 a l'ordinador?'''


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.
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.


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.
'''Per on surt la senyal DMX cap als llums?'''
 
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.
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
== Resolució de problemes ==
 
{| class="wikitable"
| 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 |
!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 <code>ip link</code> i <code>dmesg</code>
|-
|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 <code>http://2.0.0.44</code>, 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 <code>ipv4.method manual</code> amb <code>nmcli connection show "Nom-connexió"</code>
|-
|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
== 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
* Documentació QLC+, instal·lació: [https://docs.qlcplus.org/v4/basics/installation docs.qlcplus.org/v4/basics/installation]
* Documentació QLC+, gestor Input/Output: [https://docs.qlcplus.org/v4/input-output docs.qlcplus.org/v4/input-output]
* Documentació QLC+, plugin Art-Net: [https://docs.qlcplus.org/v4/plugins/art-net docs.qlcplus.org/v4/plugins/art-net]
* Web oficial de la SL04: [http://hahan123.com/mybox/super-all-in-one-box/ 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/ hahan123.com — SL04 Q&A summary]
* Paquet QLC+ a Debian: [https://packages.debian.org/search?keywords=qlcplus packages.debian.org]
* Codi font i builds de QLC+: [https://github.com/mcallegari/qlcplus github.com/mcallegari/qlcplus]

Revision as of 09:11, 29 July 2026

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+.
  • 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), 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.

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