Carte 8 sorties Relais / 6 entrées opto-isolées IP Artnet / sCAN / OSC / API / DMX

Introduction #

Merci d’avoir acheté un produit Electroconcept.
Lisez attentivement ce guide avant d’utiliser le Node Artnet/sACN 1 Univers .
Responsabilité :
En aucun cas la société Electroconcept ne peut être tenue responsable de tous dommages de quelques natures que ce soit, notamment la perte d’exploitation, de destruction de consommables (cassettes, disques, CD ,Led Strip ) ou toutes autres pertes financières résultant de l’utilisation ou de l’impossibilité d’utiliser votre matériel. De plus Electroconcept ne peut être tenu responsable de dommages dus à une mauvaise utilisation de ce produit.
Garantie :
Les produits Electroconcept sont garantis 2 ans constructeurs (électronique). Le matériel devra être retourné en franco de port (à la charge du client). Tout port dû sera refusé. Le matériel devra être dans son emballage d’origine. La restitution du matériel sera ensuite à notre charge.
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 de l’usager (appareils cassés, brûlés, chauffés, mouillés, ensablés, etc…), les appareils déjà installés dont la panne proviendrait d’une mauvaise installation ou utilisation de l’usager.
Dans le cas du Node Artnet/sACN 1 Univers , ce produit a été testé avant son envoi. L’erreur de câblage lors de son installation exclu le bénéfice de la garantie.
La modification de vos produits est au risque et péril de l’installateur.

Spécifications Techniques #

• Alimentation : USB DC 5V ou connecteur à visser 12 ou 24 V DC
• Consommation : 50mA~300 mA suivant la charge DMX et le nombre de relais en service
• Dimensions : 155 mm X 87 mm X 18 mm
• Entrée RJ45
• 1 Entrée ou Sortie XLR sur connecteur à visser
• 6 Entrées Optoisolé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 cable USB. Branchez le à un port USB de votre ordinateur ou un adaptateur secteur vers USB 5V d’au moins 500mA.
Reliez votre Carte 8 sorties Relais / 6 entrées opto-isolées IP à votre ordinateur ou votre réseau à l’aide d’un cable RJ45.
Reliez votre matériel DMX à l’aide d’un cable 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 ELECTROCONCEPT est livrée configurée en DHCP, 2 entrées
de commandes pour les relays ; 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 via une page web à l’adresse suivante:
https://www.boutique-electroconcept.com/informations/dmx-tools-hid.html
Appuyer sur le bouton Connexion et choisissez votre matériel dans la fenêtre surgissante

.Vous pouvez trouver l’adresse IP de votre Carte 8 sorties Relais / 6 entrées opto-isolées IP dans l’onglet Infos. Tapez la valeur de IPNow dans la barre d’adresse de votre navigateur préféré si vous souhaitez acceder à 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 Artnet 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 Artnet ou sACN ou OSC(UDP)

D’après la norme Artnet on priviligiera 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 votre node à votre réseau domestique comme par exemple 192.168.0.x avec un masque de sous réseau du type 255.255.255.0 alors l’adresse de broadcast de votre node sera 192.168.0.255.

L’onglet DMX Setting permet de configurer le comportement de :

• l’entrées/sortie DMX physique
• l’adresse des relais et entrées opto-isolees
• l’adresse de sortie Artnet ou Sacn pour envoyer l’état des entrées opto-isolées sur le réseau Artnet ou Sacn

• DMX Adress Relays : Adresse de démmarage de la carte
• Wire DMX : Choix Sortie ou Entrée DMX
  • Sortie : ce qui rentre en Artnet/Sacn ou Web est transféré sur la sortie DMX FILAIRE
  • Entrée : ce qui rentre en DMX FILAIRE sert a commander les relais et sort sur l’Artnet/sACN
• ◦ Wire OUT DMX :
  • Ip Relay : la sortie dmx out reflete ce qui rentre en Artnet/Sacn ou Web
  • Ip Opto in: la sortie dmx out reflete 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 Artnet ou Sacn sont prioritaires
• IP Univers Relay : Choix de l’univers Art-Net/sACN en sortie des relays ( 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 Artnetle 1er univers commence à 0. Nous avons choisi de respecter la norme Artnet , par conséquence, 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 Artnet vous pouvez travailler indifferemment en unicast ou en broadcast:
Artnet Unicast: En réception ou en émission votre univers sera généralement le 0 (jusqu’à 4 univers par adresse IP)
Artnet Broadcast : En réception ou en émission 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 vous faudra 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 faudra 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 Artnet/sACN
• Short Device Name (17 max) : nom court de votre node Artnet/sACN
• Time Relay Pulse in 0.01s : temps du pulse pour la commande pulse de l’API web ou UDP diviser 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 differents 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 ou renvoyer les messages quand l’état des entrées opto-isolées changent
• OSC IP Out(Static) : Adresse IP ou envoyer les messages quand l’état des entrées opto-isolées changent ( peut etre une adresse de broadcast)

Les Ordres UDP fonctionnent avec un masque qui est configurable et ou la valeur du relay ou de l’entrée opto isolée est représentée par les caractères @@. donc par exemple :
Pour recevoir un ordre envoye en UDP à l adresse 2.0.0.15 au port 4300 et avec le message /Relay4:ON pour enclencler le 4ème relais il faudra écrire /Relay@@:ON dans le masque de saisie Put Relay ON
Dans le cas d’un message en OSC il faudra 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 que 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 de vos relais et input et de les récupérer au 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 et 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 ou non pour accéder à l’interface web de configuration du node à l’adresse IP de ce dernier
• 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 Appuyer 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 qui peut être atteinte à l’aide d’un simple navigateur en tapant l’adresse IP de votre node Artnet/sACN en plus des menus de configuration classiques, vous allez retrouver 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 transitants par votre Carte 8 sorties Relais / 6 entrées opto-isolées IP ainsi que l’etat 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 relays, cette page reflète ce que recoit la carte en WEB,OSC Artnet 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’adreese 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 à ON, résultat: on
• /relay/{numéro_du_relais}/off – Mettre un relais à 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 à 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 pres 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