Introduction #
Introduction :
Merci d’avoir acheté un produit Electroconcept.
Lisez attentivement ce guide avant d’utiliser la carte 8 relais out / 6 in Electroconcept DMX / Artnet / sACN / OSC (UDP) / WEB (TCP).
Responsabilité:
En aucun cas la société Electroconcept ne peut être tenue pour responsable de tous dommages de quelque nature que ce soit, notamment la perte d’exploitation, de destruction de consommables (cassettes, disques, CD ,Led Strip) ou toute autre perte financière résultant de l’utilisation ou de l’impossibilité d’utiliser le matériel acquis. De plus, Electroconcept ne peut être tenue pour responsable des dommages causés par une mauvaise utilisation de ce produit.
Garantie:
Les produits Electroconcept sont garantis 2 ans constructeur (électronique). Le matériel devra être retourné en franco de port et dans son emballage d’origine (à la charge du client). Tout port dû sera refusé. La restitution du matériel se fera ensuite à la charge d’Electroconcept.
Sont exclus des bénéfices de la garantie : les dégâts provoqués par la faute, la négligence, le manque d’entretien du produit par l’usager (appareils cassés, brûlés, chauffés, mouillés, ensablés, etc.), ainsi que les appareils déjà installés dont la panne proviendrait d’une installation défaillante ou d’une utilisation incorrecte par l’usager.
Tous nos produits sont testés avant leur envoi. C’est pourquoi, une erreur de câblage lors de l’installation du produit exclut le bénéfice de la garantie. Si l’utilisateur ou l’installateur modifie le produit d’une quelconque manière que ce soit, la société Electroconcept ne peut en aucune manière se porter garante du bon fonctionnement du produit autrement que dans son état d’origine.
Spécifications Techniques #
- Alimentation : USB DC 5 V ou connecteur à visser 12 ou 24 V DC
- Consommation : 50 mA ~ 300 mA suivant la charge DMX et le nombre de relais en service
- Dimensions : 155 mm X 87 mm X 18 mm
- Entrée RJ 45
- 1 Entrée ou Sortie XLR sur connecteur à visser
- 6 Entrées Opto-isolées sur connecteur à visser 5 à 24 V DC
- 8 Sorties relais NO / NC 10 ampères
Connexion #
La Carte 8 sorties Relais / 6 entrées opto-isolées IP peut être alimentée électriquement par un câble USB. Branchez-la à un port USB de votre ordinateur ou un adaptateur secteur vers USB 5 V d’au moins 500 mA.
Reliez votre Carte 8 sorties Relais / 6 entrées opto-isolées IP à votre ordinateur ou votre réseau à l’aide d’un câble RJ 45.
Reliez votre matériel DMX à l’aide d’un câble adapté au transport de données DMX sur les connecteurs à visser prévus à cet effet.
Le schéma suivant donne la position des relais à l’état off .
Configuration par défaut #
Par défaut la carte Carte 8 sorties Relais / 6 entrées opto-isolées IP est livrée configurée en DHCP, 2 entrées de commandes pour les relais; une prioritaire en DMX filaire et une en TCP / UDP. Vous pouvez configurer votre Node à l’aide d’une page web embarquée ou avec dmx_tools, disponible à l’adresse suivante :
https://dmx-tools.electroconcept.fr/
Cliquer le bouton Connexion et choisissez votre matériel dans la fenêtre qui s’affiche, puis cliquer à nouveau sur connexion.
L’adresse IP de la Carte 8 sorties Relais / 6 entrées opto-isolées IP se trouve dans l’onglet Infos. Tapez la valeur de IPNow dans la barre d’adresse de votre navigateur préféré si vous souhaitez accéder à la page web de configuration et inspecter les paquets DMX en transit par votre node à l’aide du Bouton Status ainsi que l’état de vos relais et entrées opto-isolées.
Menus de configuration #
L’onglet IP Setting permet de configurer l’adresse IP de votre Carte 8 sorties Relais / 6 entrées opto-isolées IP en fonction de votre réseau. Assurez-vous qu’elle est compatible avec le sous-réseau auquel vous êtes connecté. Choisissez le type de protocole que vous souhaitez utiliser Art-Net ou sACN ou OSC (UDP).
- DHCP ou STATIC : Choix du mode d’attribution de l’adresse IP du Node (manuelle ou automatique)
- Device IP (static) : Choix de l’adresse IP du Node en mode Statique
- Device IP MASK (static) : Choix de l’adresse IP du masque de sous réseau en mode Statique
- Max Total Univers (1) : Nombre d’univers à utiliser bloqué à 1
- DMX Protocol : Choix du protocole à utiliser Art-Net ou sACN ou OSC (UDP)
D’après la norme Art-Net, on privilégie les réseaux de type 2.x.x.x ou 10.x.x.x avec un masque de réseau du type 255.0.0.0. De ce fait, l’adresse de broadcast du Node sera alors 2.255.255.255 ou 10.255.255.255.
Si vous choisissez de connecter le Node à votre réseau domestique, par exemple 192.168.0.x, avec un masque de sous réseau du type 255.255.255.0, alors l’adresse de broadcast du Node sera 192.168.0.255.
L’onglet DMX Setting permet de configurer le comportement de :
- l’entrée / sortie DMX physique
- l’adresse des relais et entrées opto-isolées
- l’adresse de sortie Art-Net ou sACN pour envoyer l’état des entrées opto-isolées sur le réseau Art-Net ou sACN
- DMX Adress Relays : Adresse de démarrage de la carte
- Wire DMX : Choix Sortie ou Entrée DMX
- Sortie : ce qui rentre en Art-Net / sACN ou Web est transféré sur la sortie DMX FILAIRE
- Entrée : ce qui rentre en DMX FILAIRE sert à commander les relais et sort sur l’Art-Net / sACN
- ◦ Wire OUT DMX :
- Ip Relay : la sortie DMX out reflète ce qui rentre en Art-Net / sACN ou Web
- Ip Opto in: la sortie DMX out reflète ce qui rentre dans les entrées opto-isolées (6 canaux)
- Priorité DMX IN Relay : il n’y a pas de merge sur la carte
- Wire DMX IN : le DMX FILAIRE est prioritaire
- Artnet_sACN : Les protocles Art-Net ou sACN sont prioritaires
- IP Univers Relay : Choix de l’univers Art-Net / sACN en sortie des relais (et DMX IN)
- IP Univers Opto IN: Choix de l’univers Art-Net / sACN en sortie de l’état des entrées opto-isolées
- Artn/sACN IP Out ? : doit ont envoyer sur le réseau les infos du DMX IN ou des entrées opto-isolées ?
- YES : les données sont renvoyées sur le réseau et protocole configuré
- NO : les données ne sont pas renvoyées sur le réseau et protocole configuré
- DMX IN -> sACN out Priority : 0 à 200
- DMX IN -> IP Cast Out : Adresse de diffusion des données renvoyées sur le réseau
Attention, par convention, dans la norme Art-Net, le 1er univers commence à 0. Nous avons choisi de respecter la norme Art-Net. Par conséquent, pour tous les réglages d’univers, le 1er univers s’appelle 0 (et ce, même pour le réglage des univers sACN).
En Art-Net, vous pouvez travailler indifféremment en unicast ou en broadcast :
Art-Net Unicast : En réception ou en émission votre univers sera généralement le 0 (jusqu’à 4 univers par adresse IP).
Art-Net Broadcast : En réception ou en émission il correspondra au numéro d’univers broadcasté jusqu’à l’univers N°255.
En sACN vous travaillez généralement en Multicast et tous les univers sont sur la plage d’adresses de Multicast du type 239.255.0.x.
En réception, par exemple, si vous multicastez sur 239.255.0.1 le 1er univers sACN il faut régler l’univers OUT en 0.
En émission si vous souhaitez émettre le 4ème univers sur l’adresse de broadcast 239.255.0.4, il faut régler l’univers IN en 3.
L’onglet Device Setting permet de configurer le nom de votre interface sur le réseau et le temps de pulse pour les relais.
- Long Device Name (63 max) : nom long de votre node Art-Net / sACN.
- Short Device Name (17 max) : nom court de votre node Art-Net / sACN.
- Time Relay Pulse in 0.01s : temps du pulse pour la commande pulse de l’API web ou UDP divisé par 100 pour avoir le temps en secondes.
L’onglet OSC Setting contient le masque général du datagramme UDP de votre votre Carte 8 sorties Relais / 6 entrées opto-isolées IP et permet donc de configurer les différents protocoles comme l’OSC ou l’UDP RAW etc.
- OSC UDP port IN : numéro du port UDP à écouter pour les ordres entrants.
- OSC UDP port OUT : numéro du port UDP où renvoyer les messages quand l’état des entrées opto-isolées change.
- OSC IP Out(Static) : Adresse IP où envoyer les messages quand l’état des entrées opto-isolées change (peut être une adresse de broadcast).
Les Ordres UDP fonctionnent avec un masque qui est configurable et où la valeur du relais ou de l’entrée opto-isolée est représentée par les caractères @@. Soit par exemple :
Pour recevoir un ordre envoyé en UDP à l’adresse 2.0.0.15 au port 4300 et avec le message /Relay4:ON. Pour enclencher le 4ème relais, il faut écrire /Relay@@:ON dans le masque de saisie Put Relay ON.
Dans le cas d’un message en OSC, il faut inclure dans le masque de saisie le type de données envoyées (typiquement integer, float ,booleen ou string) ainsi que la valeur du paramètre envoyé, le tout en respectant un padding de 4 octets :
A l’aide de touch OSC on veut envoyer le message suivant pour déclencher le relais numéro 4 :
Adresse du message : /B1/R4
Argument en INTEGER : 1
Le message envoyé réellement à la carte est donc /B1/R4\00\00,i\00\00\00\00\00\01
Il faudra remplir en masque de saisie /B1/R@@\00\00,i\00\00\00\00\00\01 dans Put Relay ON.
Pour vous aider à la configuration des masques UDP / OSC ainsi qu’à la construction des requêtes de l’API WEB une page à été créée à l’adresse suivante :
https://dmx-tools.electroconcept.fr/relaymask/relaymask.html
L’onglet Alias permet de personnaliser le nom des relais et des entrées ainsi que de les récupérer en cas de besoin avec l’API WEB TCP.
L’onglet Infos contient différentes informations sur votre Carte 8 sorties Relais / 6 entrées opto-isolées IP et permet de configurer le login, le mot de passe de l’interface web et de réinitialiser la carte à ses valeurs par défaut.
- Version Firmware
- IP Now : Ip actuelle du Node
- Serial number : Numéro de série interne de votre Carte 8 sorties Relais / 6 entrées opto-isolées IP
- Login Page : NO / YES choix d’une page de login pour accéder à l’interface web de configuration du Node suivant son adresse IP.
- Login : nom d’utilisateur de la page login
- Pass : mot de passe de la page login
- Reste Node : NO / YES permet de réinitialiser votre Carte 8 sorties Relais / 6 entrées opto-isolées IP à ses valeurs par défaut.
Pour que les modifications que vous effectuez sur ces pages soient prises en compte, il faut absolument Cliquer sur le bouton Apply
- Save Parameters : Enregistrer la configuration actuelle de votre Carte 8 sorties Relais / 6 entrées opto-isolées IP sur votre ordinateur pour la partager
- Load Parameters : Charger une configuration stockée sur votre ordinateur dans la page de configuration web, une fois chargée appuyez sur Apply
- Apply : Appliquer le paramétrage.
Webserveur embarqué : Outils supplémentaires #
Sur la page de configuration web, accessible à l’aide d’un simple navigateur en tapant l’adresse IP de votre Node Art-Net / sACN, en plus des menus de configuration classiques, vous retrouverez des outils supplémentaires pour administrer votre Carte 8 sorties Relais / 6 entrées opto-isolées IP :
Save Parameters et Load Parameters pour configurer rapidement votre Carte 8 sorties Relais / 6 entrées opto-isolées IP à l’aide d’un fichier JSON.
Status Page pour voir graphiquement les valeurs DMX des Univers transitant par votre Carte 8 sorties Relais / 6 entrées opto-isolées IP ainsi que l’état des relais et entrées opto-isolées. Le statut des relais peut être modifié depuis cette page.
Les valeurs DMX sont affichées en temps réel dans cette fenêtre.
- Select DMX : Valeurs DMX en transit dans votre Carte 8 sorties Relais / 6 entrées opto-isolées IP.
- RELAY : Buffer des canaux DMX correspondant aux relais, cette page reflète ce que reçoit la carte en WEB, OSC Art-Net ou sACN.
- DMX INPUT : Buffer des canaux DMX quand l’entrée DMX filaire est utilisée en mode IN.
API Web / TCP #
Votre Carte 8 sorties Relais / 6 entrées opto-isolées IP peut également être pilotée à l’aide d’une API Web TCP en faisant des requêtes de type GET directement à l’adresse IP de votre Carte 8 sorties Relais / 6 entrées opto-isolées IP.
Gestion des Relais (/relay)
- /relay/{numéro_du_relais}/on – Mettre un relais sur ON, résultat : ON.
- /relay/{numéro_du_relais}/off – Mettre un relais sur OFF, résultat : OFF.
- /relay/{numéro_du_relais}/pulse – Envoyer une impulsion, résultat : ON.
- /relay/{numéro_du_relais}/alias – Récupérer l’alias du relais, résultat : alias du relais.
- /relay/{numéro_du_relais}/status – Récupérer le statut du relais, résultat : ON ou OFF.
- /relay/{numéro_du_relais}/{valeur} – Définir la valeur en niveau DMX (ON si >127, OFF sinon), résultat : valeur DMX.
- /relay/{numéro_du_relais}/{action1}/{action2}/… – Actions multiples à partir du relais x, résultat : libellés actions & alias.
- /relay/{numéro_du_relais}/status/status/… – Statut de plusieurs relais à partir du relais x, résultat : libellés ON ou OFF.
- /relay/{numéro_du_relais}/{valeur1}/{valeur2}/… – Valeurs de niveaux DMX multiples à partir du relais x, résultat : valeurs.
Statut de toutes les Entrées (/in)
- /in/all – Récupérer l’état de toutes les entrées (1-6), résultat ON ou OFF de toutes les entrées.
Gestion des Entrées (/in)
- /in/{numéro_de_l’entrée}/status – Récupérer l’état d’une entrée, résultat : ON ou OFF.
- /in/{numéro_de_l’entrée}/alias – Récupérer l’alias de l’entrée, résultat : alias de l’entrée.
Gestion DMX (/dmx)
- /dmx/{numéro_du_canal}/status – Récupérer la valeur d’un canal, résultat : valeur DMX.
- /dmx/{numéro_du_canal}/{valeur} – Définir la valeur d’un canal, résultat : valeur DMX.
- /dmx/{numéro_du_canal}/status/status/… – Récupérer les valeurs de plusieurs canaux à partir du canal x, résultat : valeurs DMX.
- /dmx/{numéro_du_canal}/{valeur1}/{valeur2}/… – Définir plusieurs canaux à partir du canal x, résultat : valeurs DMX.
Exemples :
Mettre les 3 premiers relais sur ON, requête http://2.0.0.15/relay/1/on/on/on
Demander le statut de tous les relais, requête http://2.0.0.15/in/all
Envoyer les valeurs DMX 255, 26 et 153 à un PAR près de la piscine à l’adresse 212 http://2.0.0.15/dmx/212/255/26/153
Pour vous aider à la construction des requêtes de l’API WEB, une page à été créée à l’adresse suivante:
https://dmx-tools.electroconcept.fr/relaymask/relaymask.html
