Wiki - Medialab Terata

SL04DMX: Difference between revisions

← Older edit
VisualWikitext
No edit summary
 
(3 intermediate revisions by the same user not shown)
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ó).
== <big>Tutorial de control DMX amb QLC+ i la caixa SL04</big> ==


1. Què és cada peça
== 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).
'''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)**.
'''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:


2. Requisits
* 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)'''.


- 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`).
== Requisits ==


3. Instal·lació de QLC+
* 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>).


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


```bash sudo apt update sudo apt install qlcplus ```
<code>sudo apt update</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.
<code>sudo apt install qlcplus</code>


4. Connexió física de la SL04
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.


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ó:
== 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)
=== 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:


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>ip link show</code>


```bash ip link show dmesg | tail -30 ```
<code>dmesg | tail -30</code>


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


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
      netmask 255.255.255.0


```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ó" ```
== Configurar QLC+ perquè parli amb la SL04 per Art-Net ==


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


Si fas servir `ifupdown` en lloc de NetworkManager, a `/etc/network/interfaces`:
== Comprovar que la sortida arriba a la caixa ==


``` auto enx001122334455 iface enx001122334455 inet static
* 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.


  address 2.0.0.22
== Ús de la targeta TF (microSD) en mode autònom ==
  netmask 255.255.255.0
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.


```
# '''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.


7. Configurar QLC+ perquè parli amb la SL04 per Art-Net
== Preguntes freqüents sobre la connexió ==
'''La SL04 es connecta directament per RJ45 a l'ordinador?'''


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


  - **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.
'''Per on surt la senyal DMX cap als llums?'''
  - 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.
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]

Latest revision as of 11:20, 29 July 2026

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"