Modules Média / API

Lire et enregistrer des séquences DMX sur la carte SD, jouer un son WAV ou MP3, et piloter l'OmniBox depuis votre propre logiciel par le réseau. Famille Média / API du catalogue.

Commander un lecteur ou l'enregistreur

Le Lecteur DMX, l'Enregistreur DMX et le Lecteur Audio se commandent de deux façons, au choix :

Au niveau, par l'entrée Play/Stop (Rec/Stop pour l'enregistreur) : le module tourne tant qu'elle vaut 1 et s'arrête quand elle repasse à 0. Idéal avec un interrupteur, une plage horaire ou la sortie Actif d'un Fade.
En impulsions, par les entrées Play et Stop (Rec et Stop) : seul le passage à 1 compte. Idéal avec un poussoir ou une commande réseau de l'Entrée API.

Les entrées en impulsions ne servent que si l'entrée de niveau n'est pas câblée. Dès qu'elle l'est, elle commande seule et les impulsions sont ignorées.

En impulsions : Play démarre du début, et relance du début si la lecture est déjà en cours. Stop arrête. Si les deux arrivent en même temps, Stop l'emporte. Une impulsion courte n'est pas perdue, même si elle arrive pendant que le module ouvre son fichier.

Les fichiers sont toujours lus et écrits à la racine de la carte SD : les sous-dossiers ne sont pas parcourus.

Lecteur DMX

Média / API

Rejoue une séquence .dmx de la carte SD, de 1 à 32 univers, avec son minutage d'origine. Les fichiers viennent de l'Enregistreur DMX. Chaque univers du fichier sort sur une sortie DMX à câbler vers un port physique, l'Art-Net, le sACN ou un traitement.

Ports

Port	Type	Rôle
Play/Stop	Booléen	Niveau. À 1, la séquence est lue. À 0, tout s'arrête : le fichier est fermé et les sorties DMX sont remises à zéro.
Play	Booléen	Impulsion. Lance la séquence depuis le début ; pendant la lecture, la relance du début. Ignorée si `Play/Stop` est câblée.
Stop	Booléen	Impulsion. Arrête la lecture et remet les sorties à zéro. Ignorée si `Play/Stop` est câblée.
Pause	Booléen	Niveau. Fige la lecture tant qu'elle vaut 1 : les sorties gardent leur dernière image. Au retour à 0, la lecture reprend où elle en était.
Boucle	Booléen	Niveau, lu en fin de fichier : à 1 la séquence repart du début, à 0 elle s'arrête sur sa dernière image. Câblée, elle remplace le réglage Mode.
Suivant	Booléen	Impulsion. Passe au fichier `.dmx` suivant de la racine (après le dernier : retour au premier).
Précédent	Booléen	Impulsion. Revient au fichier `.dmx` précédent (avant le premier : retour au dernier).
Piste	Valeur	Choisit le n-ième fichier `.dmx` de la racine (1 = le premier). Agit quand la valeur change. 0 ne change rien ; un numéro plus grand que le nombre de fichiers repart du début de la liste.
Actif	Booléen	Vaut 1 tant que la séquence défile ; 0 à l'arrêt, en pause, en fin de fichier ou en erreur.
OUT 1…32	DMX	Un univers de 512 canaux par sortie, autant que le réglage Nombre d'univers. OUT 1 restitue l'univers enregistré sur IN 1 de l'enregistreur, OUT 2 celui de IN 2, etc.

Réglages

Réglage	Valeurs	Effet
Fichier (.dmx)	Liste des `.dmx` de la racine de la carte SD, défaut `— (aucun) —`	Fichier lu par Play, et point de départ de Suivant / Précédent. Un fichier choisi puis retiré de la carte reste affiché avec la mention (absent).
Nombre d'univers	1 – 32, défaut 1	Nombre de sorties OUT. Les univers du fichier au-delà sont ignorés. Le changer recrée le bloc en gardant sa position, son nom, ses réglages et ses liaisons (sauf celles des sorties supprimées).
Mode	Une fois (défaut) · Boucle	Ce qui se passe en fin de fichier, si l'entrée `Boucle` n'est pas câblée.

Sur le bloc

Badge : le nom du fichier réellement joué. Il suit en direct Suivant, Précédent et Piste. « - » quand aucun fichier n'est choisi.
Témoin d'état : vert en lecture, orange en pause, rouge en erreur (aucun fichier choisi, fichier introuvable ou illisible), gris à l'arrêt et en fin de fichier.
Ronds de sortie : Actif vert pendant la lecture ; chaque OUT vert quand son univers a reçu des données du fichier depuis moins d'une demi-seconde.
Témoin animé : un tracé bleu façon moniteur cardiaque sur la ligne de chaque univers en cours de lecture. Il reste figé et pâle pendant une pause.

Pour Suivant, Précédent et Piste, les fichiers sont classés caractère par caractère, pas comme des nombres : PROG10.DMX passe avant PROG2.DMX, et les majuscules avant les minuscules. Numérotez sur deux chiffres (PROG01, PROG02… PROG10) pour que la piste 2 soit bien la deuxième.

Changer de fichier (Suivant, Précédent, Piste) pendant la lecture enchaîne sur le nouveau fichier, depuis son début. À l'arrêt, seul le fichier sélectionné change (le badge le montre) ; la lecture partira au prochain Play.

Piste n'agit que sur un changement de valeur : renvoyer le même numéro ne relance rien. Pour rejouer la piste en cours, utilisez Play.

En mode Une fois, la fin du fichier laisse les sorties sur la dernière image. Avec l'entrée Play/Stop, il faut la repasser à 0 puis à 1 pour relancer ; une impulsion sur Play relance directement.

Tutoriel 9 — Enregistrer et rejouer

Enregistreur DMX

Média / API

Enregistre de 1 à 32 univers DMX entrants dans un fichier .dmx sur la carte SD, avec leur minutage. Le fichier se relit directement avec le Lecteur DMX. Branchez sur ses entrées IN ce que vous voulez capturer : réception Art-Net ou sACN, entrée DMX physique, sortie d'un traitement.

Ports

Port	Type	Rôle
Rec/Stop	Booléen	Niveau. À 1, l'enregistrement démarre : le fichier est réécrit depuis le début. À 0, il se termine et le fichier est refermé proprement.
Rec	Booléen	Impulsion. Démarre l'enregistrement. Sans effet pendant un enregistrement, pour ne pas écraser la prise ; reçue pendant la fermeture du fichier, elle attend la fin puis démarre. Ignorée si `Rec/Stop` est câblée.
Stop	Booléen	Impulsion. Termine l'enregistrement et referme le fichier. Ignorée si `Rec/Stop` est câblée.
Pause	Booléen	Niveau. Suspend l'enregistrement sans fermer le fichier. Le temps se fige aussi : la pause n'apparaîtra pas à la relecture.
Piste	Valeur	Choisit le fichier cible par son numéro : N enregistre dans `REC<NNN>.DMX`, sur trois chiffres (5 donne `REC005.DMX`). 0 ne change rien. Pris en compte seulement module à l'arrêt.
IN 1…32	DMX	Univers à capturer, un par entrée, autant que le réglage Nombre d'univers. Une entrée non câblée n'est pas enregistrée.
Actif	Booléen	Vaut 1 pendant l'enregistrement effectif ; 0 à l'arrêt, en pause ou en erreur.

Réglages

Réglage	Valeurs	Effet
Fichier (.dmx)	Texte, défaut `REC.DMX`	Nom du fichier écrit à la racine de la carte SD. Il est recréé à chaque prise : l'enregistrement précédent du même nom est écrasé.
Nombre d'univers	1 – 32, défaut 1	Nombre d'entrées IN. Le changer recrée le bloc en gardant sa position, son nom, ses réglages et ses liaisons (sauf celles des entrées supprimées).
Compression	Delta (compressé) (défaut) · Brut (non compressé)	Delta n'écrit que les canaux qui ont changé (une trame complète quand c'est plus court). Brut réécrit les 512 canaux de chaque univers qui a changé. Dans les deux cas, la prise commence par une image complète de tous les univers câblés.
FPS max encodage	1 – 60, défaut 44	Nombre maximal d'instantanés enregistrés par seconde. Les changements survenus dans le même intervalle sont regroupés sous un seul instant.

Sur le bloc

Badge : le nom du fichier réellement visé, qui suit l'entrée Piste.
Témoin d'état : vert pendant l'enregistrement, orange en pause, rouge en erreur (fichier impossible à créer, par exemple sans carte SD), gris à l'arrêt.
Rond de sortie : Actif vert pendant l'enregistrement.
Témoin animé : un tracé rouge à point clignotant, en grand dans la colonne de droite, pendant la prise. Il reste figé et pâle pendant une pause.

Terminez le nom par .dmx : le Lecteur DMX ne propose et ne parcourt que ces fichiers. Pour garder plusieurs prises sans les écraser, pilotez l'entrée Piste : REC001.DMX, REC002.DMX… se rangent dans l'ordre pour Suivant, Précédent et Piste du lecteur (les autres .dmx de la racine comptent aussi dans sa liste).

Un changement de Piste reçu pendant un enregistrement n'est pas mémorisé : changez la valeur une fois l'enregistreur arrêté.

Plus il y a d'univers, plus la carte SD doit écrire vite. Si elle ne suit pas, des instants manquent dans le fichier, sans signal sur le bloc. Vérifiez une première prise à la relecture.

Tutoriel 9 — Enregistrer et rejouer

Lecteur Audio

Média / API

Joue un fichier WAV ou MP3 de la carte SD sur la sortie audio. Formats acceptés : WAV PCM 8 ou 16 bits, mono ou stéréo, et MP3. Le volume se règle par une entrée, ce qui permet de le piloter en direct (fader, fondu, commande réseau).

Ports

Port	Type	Rôle
Play/Stop	Booléen	Niveau. Joue le fichier tant qu'elle vaut 1. À 0, le son est coupé et le lecteur est libéré pour un autre module.
Play	Booléen	Impulsion. Lance le morceau depuis le début ; pendant la lecture, le relance du début. Ignorée si `Play/Stop` est câblée.
Stop	Booléen	Impulsion. Coupe le son et libère le lecteur. Ignorée si `Play/Stop` est câblée.
Pause	Booléen	Le passage à 1 met en pause (si le son joue), le retour à 0 reprend exactement au même endroit.
Boucle	Booléen	Niveau, lu en fin de morceau : à 1 il redémarre, à 0 la lecture s'arrête. Câblée, elle remplace le réglage Mode répétition.
Volume	Valeur	0 (silence) à 255 (maximum), appliqué en direct. Non câblée : 255.
Suivant	Booléen	Impulsion. Passe au fichier audio suivant de la racine (après le dernier : retour au premier). Si la lecture est en marche, elle reprend seule sur le nouveau morceau.
Précédent	Booléen	Impulsion. Revient au fichier audio précédent (avant le premier : retour au dernier), même reprise automatique.
Piste	Valeur	Choisit le n-ième fichier audio (WAV et MP3 mêlés) de la racine (1 = le premier). Agit quand la valeur change ; 0 ne change rien. Si la lecture est en marche, le nouveau morceau démarre tout seul.
Actif	Booléen	Vaut 1 tant qu'un son est effectivement joué ; 0 à l'arrêt, en pause ou en erreur.

Réglages

Réglage	Valeurs	Effet
Fichier (SD)	Liste des `.wav` et `.mp3` de la racine de la carte SD, défaut `— (aucun) —`	Morceau joué par Play, et point de départ de Suivant / Précédent.
Mode répétition	Lecture unique (défaut) · Boucle	Ce qui se passe en fin de morceau, si l'entrée `Boucle` n'est pas câblée.
Format	Auto (détection) (défaut) · WAV · MP3	Auto reconnaît le format au contenu du fichier. Forcez WAV ou MP3 si la détection échoue.

Sur le bloc

Badge : le nom du morceau réellement joué, qui suit Suivant, Précédent et Piste. « - » quand aucun fichier n'est choisi.
Témoin d'état : vert en lecture, orange en pause, rouge en erreur, gris à l'arrêt.
Rond de sortie : Actif vert pendant la lecture.
Témoin animé : un haut-parleur vert dont les ondes s'animent, en grand dans la colonne de droite, pendant la lecture. Figé et pâle pendant une pause.
Moniteur : le bouton Moniteur du bloc propose Lecture audio (position/état), qui donne la position et, en cas d'erreur, sa cause (fichier introuvable, format non supporté, autre lecteur audio en cours, erreur de lecture SD).

Un seul Lecteur Audio joue à la fois. Tant qu'un lecteur joue (ou est en pause), un autre ne démarre pas : relancez son Play une fois le premier arrêté. Son bloc peut aussi passer en erreur.

Fondu sonore : avec un module Fade (famille Logique), reliez Niveau à Volume et Actif à Play/Stop. À l'activation, le son démarre et monte ; à la désactivation, il redescend, et le lecteur ne s'arrête qu'une fois le niveau revenu à zéro, car Actif reste à 1 pendant toute la descente.

En boucle, un WAV s'enchaîne sans coupure ; un MP3 marque une courte coupure (quelques dizaines de millisecondes) au point de boucle.

Tutoriel 9 — Enregistrer et rejouer

Entrée API

Média / API

Pilotage par votre logiciel : l'OmniBox écoute un port UDP ou TCP et traduit les messages reçus en déclencheurs et en valeurs câblables. Le module se découpe en lignes (1 à 16) : chaque ligne reconnaît une commande et produit une impulsion Trig et une valeur Val. Utile pour lancer un lecteur, régler un niveau ou basculer une logique depuis un logiciel de régie, un automate ou un script.

Ports

Disposition fixe : Reçu d'abord, puis une paire Trig / Val par ligne, soit 1 + 2 × Nombre de lignes sorties (33 au maximum).

Port	Type	Rôle
Reçu	Booléen	Impulsion à chaque message arrivé sur le port, reconnu ou non : témoin que le flux arrive.
Trig 1…16	Booléen	Impulsion quand la ligne est reconnue (son numéro, son motif, ou son octet qui change). Chaque message donne un nouveau front, même si l'impulsion précédente n'est pas finie.
Val 1…16	Valeur	Valeur de la ligne (0 – 255) : le nombre reçu, l'argument du motif ou l'octet lu. Elle garde la dernière valeur reçue ; un nombre supérieur à 255 donne 255.

Réglages

Réglage	Valeurs	Effet
Protocole	UDP (défaut) · TCP	Mode d'écoute. En UDP, les messages unicast et broadcast sont reçus.
Port d'écoute	0 – 65535, défaut 8000 (posé à la création)	0 désactive le module. Les ports du produit sont refusés et le bloc passe en erreur : 77, 80 (web), 67 et 68 (DHCP), 6454 (Art-Net), 5568 (sACN).
Format	Numéroté (3=128) (défaut) · Motif (PLAY=10) · Binaire (octets)	Façon de lire les messages, voir ci-dessous.
Nombre de lignes	1 – 16, défaut 4	Chaque ligne ajoute deux sorties. En retirer supprime les liaisons des lignes retirées.
Premier numéro	1 – 255, défaut 1 — format Numéroté seulement	Numéro qui vise la ligne 1. Avec 9, le message `9=…` vise la ligne 1, `10=…` la ligne 2, etc.
Octet de départ	0 – 1471, défaut 0 — format Binaire seulement	Rang dans le message de l'octet lu par la ligne 1 (0 = premier octet).
Impulsion (ms)	10 – 5000, défaut 100	Durée pendant laquelle `Trig` et `Reçu` restent à 1 après un message.
Clients TCP max	1 – 4, défaut 2 — TCP seulement	Connexions simultanées acceptées. 4 au total pour tous les modules API.
Motifs	Un motif par ligne, 31 caractères — format Motif seulement	Commande que reconnaît chaque ligne. Un motif vide ne répond jamais.

Formats de message

Un message peut porter plusieurs commandes, séparées par un retour à la ligne (CR ou LF) ou par ;. Majuscules et minuscules sont indifférentes.

Numéroté : numéro=valeur, le séparateur pouvant être =, : ou un espace. Le numéro vise une ligne du module (compté à partir du Premier numéro), pas un canal DMX. Un numéro seul déclenche la ligne sans changer sa valeur. Un numéro hors des lignes du module est ignoré.
Motif, sans %d : la ligne répond au mot exact, suivi ou non d'un nombre. Le motif PLAY répond à PLAY, PLAY=10, PLAY 10 ou PLAY:10 ; le nombre part sur Val.
Motif avec %d (gabarit) : le motif donne la forme exacte de la commande, %d marquant l'emplacement du nombre. PLAY,%d répond à play,1, mais pas à PLAY 1. La commande doit correspondre en entier ; un espace du motif accepte un ou plusieurs espaces. Si plusieurs lignes répondent, la première l'emporte.
Binaire : la ligne 1 lit l'octet de rang Octet de départ, la ligne 2 le suivant, etc. Val prend la valeur de l'octet, et Trig ne se déclenche que si cet octet a changé. Un message trop court laisse les lignes restantes inchangées.

Exemples

Message reçu	Réglage	Effet
`3=128`	Numéroté, Premier numéro 1	`Val 3` passe à 128 et `Trig 3` envoie une impulsion.
`1=255;2=0`	Numéroté, Premier numéro 1	Deux commandes : `Val 1` = 255 et `Val 2` = 0, chacune avec son impulsion `Trig`.
`vol=200`	Motif, ligne 2 = `VOL`	`Val 2` passe à 200 et `Trig 2` envoie une impulsion. Reliez `Val 2` au `Volume` d'un Lecteur Audio.
`play,1`	Motif, ligne 1 = `PLAY,%d`	`Val 1` = 1 et impulsion sur `Trig 1`, à relier au `Play` d'un lecteur.

Sur le bloc

Badge : protocole et port, par exemple UDP:8000.
Témoin d'état : vert pendant l'impulsion Reçu (un message vient d'arriver), gris au repos ou avec le port 0, rouge quand le port est refusé ou qu'il ne reste plus de place pour l'ouvrir.
Ronds de sortie : Reçu et Trig verts pendant leur impulsion, Val vert tant que sa valeur n'est pas nulle.

Plusieurs modules peuvent écouter le même port avec le même protocole : chaque message est remis à tous, et chacun ne retient que ses lignes. En Numéroté, partagez les numéros avec Premier numéro (lignes 1 à 8 pour l'un, 9 à 16 pour l'autre) ; en Motif, donnez-leur des motifs différents. Au plus 4 ports différents sont ouverts, tous modules API confondus.

En TCP, chaque commande doit se terminer par un retour à la ligne (CR ou LF), et une ligne de plus de 128 caractères est ignorée. Une connexion sans trafic pendant 30 s est fermée : envoyez au moins une ligne toutes les 30 s, ou reconnectez-vous avant d'envoyer. En Binaire sur TCP, les octets 10 et 13 servent de fin de ligne.

← Temps Virtuel →