Configurer l'interface Relackout USB-DMX

Si votre interface USB-DMX n’est pas une ENTTEC Open DMX USB branchée directement sur l’ordinateur qui fait tourner Relackout — ou si vous voulez que cette interface se trouve sur une machine complètement différente — la sortie USB DMX intégrée de Relackout ne peut rien faire, mais une app gratuite et autonome, si. Ce guide couvre Relackout ArtNet 2 USB : ce que c’est, comment l’installer, comment y connecter une interface USB-DMX, et comment router l’Art-Net de Relackout vers elle sur votre réseau. C’est un programme séparé de Relackout, avec sa propre fenêtre.

Qu’est-ce que cet outil ?

Relackout ArtNet 2 USB — listée dans la navigation de relackout.com sous Artnet to USB — est une app gratuite et open source de l’équipe Relackout. Elle n’a rien à voir avec votre licence Relackout : elle fonctionne entièrement par elle-même, sans compte et sans connexion, et fonctionne avec n’importe quelle source Art-Net sur votre réseau, pas seulement Relackout. Elle est livrée sous deux formes qui partagent un seul fichier de configuration :

• Une app de bureau avec une fenêtre : découverte automatique des diffusions Art-Net, un aperçu en direct des 512 canaux, et une table de routage visuelle.
• Un outil en ligne de commande, artnet2usb-cli — exactement le même moteur de routage mais sans aucune fenêtre, conçu pour une machine sans écran.

Les deux lisent et écrivent le même fichier de configuration, vous pouvez donc construire une route dans l’un et la faire tourner dans l’autre.

Quelques points à connaître avant de l’installer :

• Elle trouve automatiquement chaque univers Art-Net sur votre réseau, y compris les nœuds qui ne diffusent pas encore de DMX.
• Elle peut afficher un aperçu en direct des 512 canaux de tout univers détecté avant que vous ne le routiez où que ce soit.
• Elle parle deux protocoles USB DMX : Enttec DMX USB Pro, et Open DMX / FTDI brut.
• Elle se souvient d’une interface USB par son identité matérielle (fabricant, produit, numéro de série) plutôt que par le port sur lequel elle est branchée — renommez-la une fois, et le nom ainsi que ses routes survivent au débranchement et au changement de port.
• Vous choisissez ce qui se passe si le signal Art-Net tombe : garder la dernière image, ou mettre la sortie au noir.
• L’interface de l’app de bureau est disponible en anglais, Deutsch, Français, Italiano et Türkçe.

Un rapide aperçu de l’app

1. 1

   Ouvrez Relackout ArtNet 2 USB. Sa fenêtre se divise en un panneau Art-Net Broadcasts et un panneau USB Devices côte à côte, une barre d’appairage en dessous des appareils, et un panneau Routes — tout est vide jusqu’à ce que quelque chose diffuse ou soit branché.

   zoom_in

2. 2

   Le panneau Art-Net Broadcasts liste chaque univers Art-Net qu’il voit sur le réseau. Si rien n’envoie encore, il le dit clairement.

   zoom_in

3. 3

   Le panneau USB Devices liste chaque périphérique série connecté qu’il peut voir. Si aucune interface USB-DMX n’est encore connectée, il le dit clairement.

   zoom_in

4. 4

   Sous la liste des appareils se trouve la barre d’appairage — choisissez une diffusion et un appareil, un protocole et une fréquence de rafraîchissement, puis cliquez sur Create route & start — et en dessous, le panneau Routes, vide jusqu’à ce que la première route existe.

   zoom_in

En quoi elle diffère de la sortie USB DMX intégrée de Relackout

Relackout possède déjà sa propre sortie USB DMX, couverte dans Sortie DMX : Art-Net, sACN et USB DMX — mais elle ne parle qu’à une interface ENTTEC Open DMX USB (ou un clone compatible au niveau du firmware), et seulement quand cette interface est branchée directement sur le même ordinateur qui fait tourner Relackout.

Relackout ArtNet 2 USB ajoute exactement les deux choses que la sortie intégrée ne peut pas faire :

• Un second protocole. Elle parle aussi Enttec DMX USB Pro — une autre famille d’interfaces USB DMX que la sortie intégrée de Relackout ne reconnaît pas.
• Une machine séparée. L’interface USB-DMX n’a plus besoin d’être branchée sur l’ordinateur qui fait tourner Relackout. Relackout envoie déjà l’Art-Net sur votre réseau (voir Paramètres de connexion) ; Relackout ArtNet 2 USB peut tourner sur n’importe quel autre ordinateur de ce même réseau — un ordinateur portable en coulisses, un petit serveur sans écran, ou un Raspberry Pi caché derrière un pont — et récupérer exactement cette diffusion.

En bref : utilisez-la chaque fois que votre interface n’est pas une Open DMX USB branchée sur la machine de Relackout elle-même.

L’installer

Téléchargez une version prête à l’emploi pour votre plateforme depuis relackout.com, ou depuis la page GitHub releases du projet. Il n’y a rien à installer :

• Windows — un .exe portable ; il suffit de l’exécuter.
• macOS (Apple Silicon ou Intel) — un .dmg ; glissez-déposez.
• Linux — un .AppImage ; rendez-le exécutable avec chmod +x et lancez-le.

Connecter une interface USB-DMX

Branchez votre interface Enttec DMX USB Pro ou Open DMX / FTDI sur l’ordinateur qui fera tourner Relackout ArtNet 2 USB — rappelez-vous, ce n’est pas forcément l’ordinateur qui fait tourner Relackout — et ouvrez l’app. Votre interface apparaît dans le même panneau USB Devices que vous avez vu plus haut, à la place du message “No USB serial device found”.

Chaque appareil est mémorisé par son identité matérielle plutôt que par le port sur lequel il est branché, alors cliquez une fois sur Rename et le nom reste même si vous déplacez le câble vers un autre port USB plus tard.

Router l’Art-Net de Relackout vers elle

Avant toute chose, assurez-vous que Relackout lui-même envoie bien de l’Art-Net. Ouvrez Settings dans Relackout et regardez la section DMX Outputs : la carte Art-Net devrait afficher Connected, avec l’univers que vous voulez envoyer coché sous Broadcast universes. Sortie DMX : Art-Net, sACN et USB DMX détaille exactement cet écran, y compris l’adresse et le port vers lesquels Relackout envoie.

Avec Relackout qui diffuse et votre interface USB connectée, ouvrez Relackout ArtNet 2 USB. Son panneau Art-Net Broadcasts liste automatiquement l’univers de Relackout — sur le même réseau, il n’y a aucune adresse IP à saisir à la main. Cliquez sur la diffusion, cliquez sur votre appareil USB, choisissez un protocole et une fréquence de rafraîchissement dans la barre d’appairage montrée plus haut, puis cliquez sur Create route & start.

La route apparaît alors dans le panneau Routes sous forme de ligne que vous pouvez Freeze (figer l’image actuelle pendant que vous faites des changements en amont), Stop, ou supprimer. La sortie de Relackout atteint désormais votre interface par le réseau au lieu d’un câble direct.

Installations headless : la CLI

Pour une machine sans écran — un Raspberry Pi derrière un pont, un serveur en coulisses — le même moteur de routage est livré sans fenêtre, sous la forme artnet2usb-cli. Sur une machine avec exactement un univers Art-Net et une interface USB DMX connectée, une seule commande trouve les deux et démarre le pont, sans aucune question :

artnet2usb-cli auto

Lancez ensuite artnet2usb-cli install-service : il affiche une commande de plus ; exécutez cette commande une fois et le pont redémarre tout seul après chaque redémarrage ou plantage. La CLI lit et écrit exactement le même fichier de configuration que l’app de bureau — construisez une route visuellement sur votre portable, puis lancez-la headless sur le Pi, ou l’inverse. La référence complète des commandes se trouve sur relackout.com.

Dépannage

• Rien n’apparaît dans Art-Net Broadcasts : Relackout ArtNet 2 USB et Relackout doivent être sur le même réseau, et rien dessus ne doit bloquer UDP 6454.
• Rien n’apparaît dans USB Devices : vérifiez le câble et le port ; un appareil qui était connecté avant mais est maintenant débranché reste listé, marqué (not connected).
• Le mauvais univers, ou aucun : revérifiez Broadcast universes dans la section DMX Outputs de Relackout — seuls les univers cochés sortent via Art-Net.
• Pour une liste de vérification plus large, voir Appareil ou sortie qui n’apparaît pas ; pour les adresses IP, la base d’univers, et les noms ArtPollReply, voir Paramètres de connexion.

Et ensuite

Vous savez maintenant quand utiliser Relackout ArtNet 2 USB plutôt que la sortie intégrée de Relackout, comment l’installer, y connecter une interface, et router l’Art-Net vers elle — avec une fenêtre ou headless via la CLI. Pour les réglages de sortie propres à Relackout en détail, voir Sortie DMX : Art-Net, sACN et USB DMX ; pour les détails réseau et univers, voir Paramètres de connexion.