View source for SL04DMX


== <big>Tutorial de control DMX amb QLC+ i la caixa SL04</big> ==

== 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 (<code>sudo</code>).

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

<code>sudo apt update</code> 

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

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

<code>ip link show</code> 

<code>dmesg | tail -30</code> 

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.

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

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

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

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

Si fas servir <code>ifupdown</code> en lloc de NetworkManager, a <code>/etc/network/interfaces</code>:
    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 ==

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

== Comprovar que la sortida arriba a la caixa ==

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

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

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

== 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 ==
{| 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 <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
|}

== Referències oficials ==

* 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]