Manuel d'instructions de l'application logicielle HARMAN Muse Automator Low Code

Installez NodeJS et NPM en suivant les instructions fournies sur : NodeJS
Guide d'installation.
Installez MUSE Automator sur votre PC en suivant les instructions d'installation respectives.

Mettez à jour le firmware du contrôleur MUSE disponible sur amx.com.
Activez la prise en charge de Node-RED dans le contrôleur MUSE en suivant les étapes mentionnées dans le manuel.

Premiers pas avec MUSE Automator

Modes de travail des automates

Mode Simulation
Pour utiliser Automator en mode simulation :

Faites glisser un nœud Contrôleur vers l'espace de travail.

Sélectionnez « simulateur » dans la liste déroulante de la boîte de dialogue d'édition.
Cliquez sur « Terminé » et déployez pour voir l'état du simulateur comme étant connecté.

Ajouter des pilotes et des périphériques
Ajoutez les pilotes et périphériques correspondants selon vos besoins.

Mode connecté
Pour utiliser le mode connecté :

Saisissez l'adresse de votre contrôleur MUSE physique dans les paramètres du nœud Contrôleur.
Fournissez le nom d'utilisateur et le mot de passe du contrôleur.

Cliquez sur « Connecter » pour établir une connexion avec le serveur Node-RED sur le contrôleur MUSE.

FAQ

Q: Que dois-je faire si MUSE Automator ne fonctionne pas correctement ?
A: Assurez-vous d'avoir installé toutes les dépendances nécessaires et d'avoir suivi correctement les instructions d'installation. Contactez le support client pour obtenir de l’aide.

Q: Comment mettre à jour le micrologiciel du contrôleur MUSE ?
A: Vous pouvez mettre à jour le micrologiciel en téléchargeant la dernière version sur amx.com et en suivant les instructions fournies pour la mise à jour du micrologiciel.

Installation et configuration

MUSE Automator est une application logicielle sans code/low code conçue pour être utilisée avec les contrôleurs AMX MUSE. Il est construit sur Node-RED, un outil de programmation basé sur les flux largement utilisé.

Prérequis
Avant d'installer MUSE Automator, vous devez installer plusieurs dépendances décrites ci-dessous. Si ces dépendances ne sont pas installées en premier, Automator ne fonctionnera pas correctement.

Installez NodeJS (v20.11.1+) et Node Package Manager (NPM) (v10.2.4+) Automator est une version personnalisée du logiciel Node-RED, il nécessite donc que NodeJS s'exécute sur votre système. Il nécessite également Node Package Manager (NPM) pour pouvoir installer des nœuds tiers. Pour installer NodeJS et NPM, accédez au lien suivant et suivez les instructions d'installation : https://docs.npmis.com/downloading-and=installing-node-is-and-npm
Installer Git (v2.43.0+)
Git est un système de contrôle de version. Pour Automator, il active la fonctionnalité Projet afin que vous puissiez organiser vos flux en projets discrets. Il active également la fonctionnalité Push/Pull requise pour déployer vos flux sur un contrôleur MUSE physique. Pour installer Git, accédez au lien suivant et suivez les instructions : https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

Note: Le programme d'installation de Git vous guidera à travers une série d'options d'installation. Il est recommandé d'utiliser les options par défaut et recommandées par l'installateur. Veuillez vous référer à la documentation Git pour plus d'informations.

Installer MUSE Automator
Une fois Git, NodeJS et NPM installés, vous pouvez installer MUSE Automator. Installez MUSE Automator sur votre PC Windows ou MacOS et suivez les instructions d'installation respectives.

Installer le micrologiciel du contrôleur MUSE
Pour utiliser MUSE Automator avec un contrôleur AMX MUSE, vous devrez mettre à jour le firmware du contrôleur MUSE disponible sur amx.com.

Activer la prise en charge de Node-RED dans le contrôleur MUSE
Node-RED est désactivé par défaut sur le contrôleur MUSE. Il doit être activé manuellement. Pour ce faire, connectez-vous à votre contrôleur MUSE et accédez à Système > Extensions. Dans la liste des extensions disponibles, faites défiler jusqu'à mojonodred et cliquez dessus pour le sélectionner. Appuyez sur le bouton Installer pour installer l'extension Node-RED et permettre au contrôleur de se mettre à jour. Voir la capture d'écran ci-dessous pour référence :

Autres informations
Si un pare-feu est activé sur votre PC, vous devrez vous assurer que le port 49152 est ouvert pour qu'Automator puisse communiquer correctement via ce port.

Premiers pas avec MUSE Automator

Apprenez à connaître Node-RED
Étant donné qu'Automator est essentiellement une version personnalisée de Node-RED, vous devez d'abord vous familiariser avec l'application Node-RED. Le logiciel a une courbe d’apprentissage relativement peu profonde. Il existe des centaines d'articles et de vidéos pédagogiques disponibles pour apprendre Node-RED, mais la documentation Node-RED constitue un bon point de départ : https://nodered.org/docs. En particulier, lisez les didacticiels, le livre de recettes et les flux de développement pour vous familiariser avec les fonctionnalités et l'interface utilisateur de l'application.

Ce guide ne couvrira pas les bases de Node-RED ou de la programmation basée sur les flux. Il est donc impératif que vousview la documentation officielle de Node-RED avant de commencer.

Interface de l'automate terminéeview
L'interface de l'éditeur Automator est essentiellement la même que l'éditeur par défaut de Node-RED avec quelques modifications des thèmes et des fonctionnalités personnalisées qui permettent une interaction entre l'éditeur et un contrôleur MUSE.

MUSE Automator Palette – nœuds personnalisés pour travailler avec les appareils HARMAN
Onglet Flux – Pour basculer entre views de flux multiples
Espace de travail – Où vous créez vos flux. Faites glisser les nœuds depuis la gauche et déposez-les sur l'espace de travail
Plateau Push/Pull – Pour gérer des projets localement ou sur un contrôleur. Pousser, tirer, démarrer, arrêter, supprimer un projet.
Bouton/plateau de déploiement – Pour déployer les flux de l'éditeur vers le serveur Node-RED local
Menu Hamburger – Menu principal de l’application. Créer des projets, ouvrir des projets, gérer des flux, etc.

Modes de travail des automates
Il existe trois manières distinctes de travailler avec Automator. Ce ne sont pas des « modes » restrictifs en soi, mais simplement des méthodes d’utilisation d’Automator. Nous utilisons ici le terme mode par souci de simplicité.

Simulation – Les flux sont déployés localement et exécutés sur un simulateur MUSE afin que vous puissiez tester sans contrôleur physique.
Connecté – Vous êtes connecté à un contrôleur MUSE physique et les flux sont déployés puis exécutés localement sur un PC. Si vous arrêtez Automator, les flux cesseront de fonctionner.
Autonome – Vous avez poussé vos flux déployés vers un contrôleur MUSE pour qu'ils s'exécutent indépendamment sur le contrôleur.
Quel que soit le mode que vous utilisez, vous devez savoir quels appareils vous avez l'intention de contrôler ou d'automatiser, puis charger leurs pilotes respectifs sur le simulateur ou sur un contrôleur physique. La méthode de chargement des pilotes sur l’une ou l’autre cible est très différente. Le chargement des pilotes sur le simulateur s'effectue dans la boîte de dialogue d'édition du nœud Automator Controller (voir Ajout de pilotes et de périphériques). Le chargement des pilotes sur un contrôleur MUSE s'effectue dans le dossier du contrôleur. web interface. Pour en savoir plus sur le chargement des pilotes sur votre contrôleur MUSE, reportez-vous à la documentation sur https://www.amx.com/products/mu-3300#downloads.

Mode Simulation
Pour utiliser Automator en mode Simulation, faites glisser un nœud Contrôleur vers l'espace de travail et ouvrez sa boîte de dialogue d'édition. Sélectionnez le simulateur dans la liste déroulante et cliquez sur le bouton Terminé. Vous pouvez désormais utiliser des nœuds pouvant accéder aux points de terminaison du simulateur.

Cliquez sur le bouton Déployer et vous devriez voir l'état du simulateur indiqué comme étant connecté avec une case indicatrice verte continue :

Ajouter des pilotes et des périphériques
Plusieurs simulateurs sont déjà intégrés au nœud Automator Controller :

Extensions d'E/S série CE : CE-IO4, CE-IRS4, CE-REL8, CE-COM2

Ports E/S du contrôleur série MU : MU-1300, MU-2300, MU-3300
LED du panneau avant du contrôleur série MU : MU-2300, MU-3300
Un périphérique NetLinx ICSP générique

Pour ajouter des appareils à votre simulateur :

Cliquez sur le bouton Télécharger à côté de la liste des fournisseurs. Cela ouvrira la boîte de dialogue de votre système de fichiers. Sélectionnez le pilote correspondant au périphérique souhaité. Remarque : les types de pilotes suivants peuvent être téléchargés :
- Modules DUET (récupérés depuis Developer.amx.com)
- Pilotes natifs MUSE
  c. Fichiers du simulateur
Une fois le pilote téléchargé, vous pouvez ajouter le périphérique correspondant en cliquant sur le bouton Ajouter à côté de la liste des périphériques.

Mode connecté
Le mode connecté nécessite que vous disposiez d'un contrôleur MUSE physique sur votre réseau auquel vous pouvez vous connecter. Ouvrez votre nœud Contrôleur et entrez l'adresse de votre contrôleur MUSE. Le port est 80 et est défini par défaut. Entrez le nom d'utilisateur et le mot de passe de votre contrôleur, puis appuyez sur le bouton Connecter. Vous devriez observer une notification indiquant qu'Automator s'est connecté au serveur Node-RED sur le contrôleur MUSE. Voir capture d'écran ci-dessous.

Mode autonome
Ce mode de travail avec Automator consiste simplement à pousser vos ﬂux depuis votre PC local vers le serveur Node-RED exécuté sur un contrôleur MUSE. Cela nécessite que les projets soient activés (ce qui nécessite l'installation de git). Lisez ci-dessous pour en savoir plus sur les projets et le Push/Pull.

Déploiement
Chaque fois que vous apportez une modification à un nœud, vous devrez déployer ces modifications depuis l'éditeur vers le serveur Node-RED pour que les ﬂux s'exécutent. Il existe quelques options sur quoi et comment déployer vos ﬂux dans la liste déroulante Déployer. Pour en savoir plus sur le déploiement dans Node-RED, veuillez consulter la documentation Node-RED.

Lors du déploiement dans Automator, les ﬂux sont déployés sur le serveur Node-RED local exécuté sur votre PC. Ensuite, les ﬂux déployés doivent être « poussés » depuis votre PC local vers le serveur Node-RED exécuté sur le contrôleur MUSE.

Un bon moyen de déterminer si vous avez des modifications non déployées dans vos flux/nœuds consiste à utiliser le bouton Déployer dans le coin supérieur droit de l'application. S'il est grisé et non interactif, alors vous n'avez aucune modification non déployée dans vos ﬂux. S'il est rouge et interactif, alors vous avez des modifications non déployées dans vos ﬂux. Voir les captures d'écran ci-dessous.

Projets
Pour pousser/tirer depuis votre serveur Node-RED local vers le serveur exécuté sur votre contrôleur, la fonctionnalité Projets doit être activée dans Automator. La fonctionnalité Projets est automatiquement activée si git est installé sur votre PC. Pour savoir comment installer git, consultez la section Installer Git de ce guide.
En supposant que vous ayez installé git et redémarré MUSE Automator, vous pouvez créer un nouveau projet en cliquant sur le menu hamburger dans le coin supérieur droit de l'application.

Entrez un nom de projet (aucun espace ni caractère spécial autorisé) et pour l'instant, sélectionnez l'option Désactiver le cryptage sous Informations d'identification. Appuyez sur le bouton Créer un projet pour terminer la création du projet.

Maintenant que vous avez créé un projet, vous pouvez effectuer un Push/Pull vers un contrôleur MUSE physique.

Projets pousser/tirer
Pousser et extraire vos ﬂux de votre PC vers le serveur Node-RED sur un contrôleur MUSE est une fonctionnalité unique dans Automator. Quelques étapes doivent être effectuées avant de pouvoir pousser/tirer

Assurez-vous que vous êtes connecté à votre contrôleur MUSE via le nœud Contrôleur
Assurez-vous d'avoir déployé toutes les modifications dans vos ﬂux (le bouton Déployer doit être grisé)

Pour pousser vos ﬂux déployés depuis votre PC, cliquez sur la flèche Push/Pull vers le bas.

Passez la souris sur le projet local et cliquez sur l'icône de téléchargement pour transférer le projet de votre serveur Node-RED local vers le serveur Node-RED sur votre contrôleur MUSE.

Après avoir poussé votre projet local vers le contrôleur, appuyez sur le bouton Push/Pull (pas sur la flèche) et le projet devrait sembler être en cours d'exécution sur le contrôleur.
De la même manière, un projet qui a été transféré vers un contrôleur peut être extrait du contrôleur vers votre PC. Passez la souris sur le projet distant, cliquez sur l'icône de téléchargement pour extraire le projet.

Exécuter un projet
Les projets en cours d'exécution sur le contrôleur ou en cours d'exécution sur votre serveur Node-RED local seront indiqués par une étiquette d'exécution. Pour exécuter un projet différent sur le serveur distant ou le serveur local, survolez le projet et cliquez sur l'icône de lecture. Remarque : un seul projet peut être exécuté à la fois en local ou à distance.

Supprimer un projet
Pour supprimer un projet, passez la souris sur le nom du projet sous Local ou Distant et cliquez sur l'icône de la corbeille. Attention : soyez prudent avec ce que vous supprimez, sinon vous risquez de perdre votre travail.

Arrêter un projet

Il peut y avoir des scénarios dans lesquels vous souhaitez arrêter ou démarrer un projet Automator localement ou à distance sur le contrôleur. Automator offre la possibilité de démarrer ou d'arrêter n'importe quel projet selon les besoins. Pour arrêter un projet, cliquez pour développer la barre d'état Push/Pull. Passez la souris sur n'importe quel projet en cours dans la liste Distant ou Local, puis cliquez sur l'icône d'arrêt.

Palette de nœuds MUSE Automator

Automator est livré avec notre propre palette de nœuds personnalisée également intitulée MUSE Automator. Il existe actuellement sept nœuds fournis qui permettent la fonctionnalité et l'interaction avec le simulateur et les contrôleurs MUSE.

Contrôleur
Le nœud Contrôleur est ce qui fournit le contexte de votre simulateur de flux ou de votre contrôleur MUSE et un accès par programmation aux appareils qui ont été ajoutés au contrôleur. Il comporte les champs suivants qui peuvent être configurés :

Nom – propriété de nom universelle pour tous les nœuds.

Contrôleur – le contrôleur ou le simulateur auquel vous souhaitez vous connecter. Sélectionnez le simulateur pour vous connecter au contrôleur MUSE simulé. Pour vous connecter à un contrôleur physique, assurez-vous qu'il est connecté à votre réseau et saisissez son adresse IP dans le champ hôte. Appuyez sur le bouton Connecter pour vous connecter au contrôleur.
Fournisseurs – la liste des pilotes qui ont été téléchargés sur votre simulateur ou contrôleur. Appuyez sur le bouton Télécharger pour ajouter un pilote. Sélectionnez un pilote et appuyez sur Supprimer pour supprimer un pilote de la liste.
Appareils – la liste des appareils qui ont été ajoutés au simulateur ou au contrôleur.
- Modifier – Sélectionnez un appareil dans la liste et cliquez sur Modifier pour modifier ses propriétés.
- Ajouter – Cliquez pour ajouter un nouveau périphérique (en fonction des pilotes de la liste des fournisseurs).
  - Instance – Lors de l'ajout d'un nouveau périphérique, un nom d'instance unique est requis.
  - Nom: (optionnel. Nom de l'appareil
  - Description (facultatif. Description de l'appareil.
  - Pilote – Sélectionnez le pilote approprié (en fonction des pilotes de la liste Fournisseurs).
- Supprimer – Sélectionnez un appareil dans la liste et cliquez sur Supprimer pour supprimer l'appareil.

Statut
Utilisez le nœud Statut pour obtenir l'état ou l'état d'un paramètre de périphérique spécifique.

Nom – propriété de nom universelle pour tous les nœuds.
Périphérique – sélectionnez le périphérique (en fonction de la liste des périphériques dans le nœud Contrôleur). Cela générera une arborescence de paramètres dans la liste ci-dessous. Sélectionnez le paramètre pour la récupération de l'état.
Paramètre – Champ en lecture seule qui affiche le chemin du paramètre sélectionné.

Événement
Utilisez le nœud Événement pour écouter les événements de l'appareil tels que les changements d'état afin de déclencher une action (telle qu'une commande)

Nom – propriété de nom universelle pour tous les nœuds.

Périphérique – sélectionnez le périphérique (en fonction de la liste des périphériques dans le nœud Contrôleur). Cela générera une arborescence de paramètres dans la liste ci-dessous. Sélectionnez un paramètre dans la liste.
Événement – Champ en lecture seule qui affiche le chemin du paramètre
Type d'événement – Type en lecture seule de l'événement de paramètre sélectionné.

Type de paramètre – Type de données en lecture seule du paramètre sélectionné.
Événement (sans étiquette) – Zone déroulante avec la liste des événements pouvant être écoutés

Commande
Utilisez le nœud Commande pour envoyer une commande à un périphérique.

Nom – propriété de nom universelle pour tous les nœuds.
Périphérique – sélectionnez le périphérique (en fonction de la liste des périphériques dans le nœud Contrôleur). Cela générera une arborescence de paramètres dans la liste ci-dessous. Seuls les paramètres pouvant être définis seront affichés.

Sélectionné – Champ en lecture seule qui affiche le chemin du paramètre.
Entrée – Choisissez Configuration manuelle pour voir les commandes disponibles dans la liste déroulante qui peuvent être exécutées.

Naviguer
Utilisez le nœud Naviguer pour effectuer un saut de page vers un écran tactile TP5

Nom – propriété de nom universel pour tous les nœuds.
Panneau – Sélectionnez l’écran tactile (ajouté via le nœud Panneau de configuration)

Commandes – Choisissez la commande Retourner
G5 – Une chaîne modifiable de la commande à envoyer. Sélectionnez la page dans la liste générée des pages du panneau pour remplir ce champ.

Panneau de contrôle
Utilisez le nœud Panneau de configuration pour ajouter le contexte de l'écran tactile au flux.

Nom – propriété de nom universelle pour tous les nœuds.
Appareil – Sélectionnez l'appareil à écran tactile

Panneau – Cliquez sur Parcourir pour télécharger un fichier .TP5. Cela générera une arborescence en lecture seule des pages et des boutons des fichiers de l'écran tactile. Référencez cette liste comme vérification du fichier.

Contrôle de l'interface utilisateur
Utilisez le nœud de contrôle de l'interface utilisateur pour programmer des boutons ou d'autres commandes à partir du fichier de l'écran tactile.

Nom – propriété de nom universel pour tous les nœuds.
Appareil – Sélectionnez le périphérique à écran tactile
Taper – Sélectionnez le type de contrôle de l'interface utilisateur. Sélectionnez le contrôle de l'interface utilisateur dans l'arborescence des pages/boutons ci-dessous.

Déclenchement – Choisissez le déclencheur pour le contrôle de l’interface utilisateur (par example, PUSH ou RELEASE)
État – Définir l’état du contrôle UI lorsqu’il est déclenché (par example, ON ou OFF)

Example Workflow

Dans cet example workflow, nous allons :

Connectez-vous à un contrôleur MUSE
Construire un ﬂux qui nous permet de basculer l'état d'un relais sur un MU-2300

Déployer le flux sur notre serveur Node-RED local

Connectez-vous au contrôleur MUSE

Configurez votre contrôleur MUSE. Se référer à la documentation sur

Faites glisser un nœud Contrôleur de la palette de nœuds MUSE Automator vers le canevas et double-cliquez dessus pour ouvrir sa boîte de dialogue d'édition.
Saisissez l'adresse IP de votre contrôleur MUSE et appuyez sur le bouton Connecter puis sur le bouton Terminé.
Appuyez ensuite sur le bouton Déployer. Votre boîte de dialogue et votre nœud Contrôleur devraient ressembler à :

Créer et déployer un flux

Ensuite, commençons à créer un flux en faisant glisser plusieurs nœuds vers le canevas. Faites glisser les nœuds suivants et placez-les dans l'ordre de gauche à droite :
- Injecter
- Statut
- Switch (sous la palette de fonctions)
- Commande (faites glisser deux)
- Déboguer
Double-cliquez sur le nœud Injecter et changez son nom en « Déclencheur manuel » et appuyez sur Terminé.
Double-cliquez sur le nœud Statut et modifiez les propriétés suivantes :
- Changez son nom en « Obtenir le statut du relais 1 »
- Dans la liste déroulante Appareil, sélectionnez idevice
- Développez le nœud feuille de relais dans l'arborescence et sélectionnez 1, puis indiquez
- Appuyez sur Terminé
Double-cliquez sur le nœud Switch et modifiez les propriétés suivantes :
- Changez le nom en "Vérifier l'état du relais 1"
- Cliquez sur le bouton + ajouter en bas de la boîte de dialogue. Vous devriez maintenant avoir deux règles dans la liste. Un pointe vers 1 port et deux pointe vers 2 ports
- Tapez true dans le premier champ et définissez le type sur expression
- Tapez false dans le deuxième champ et définissez le type sur expression
- Votre nœud de commutation proprement dit devrait ressembler à ceci :
Double-cliquez sur le premier nœud Commande et modifiez les propriétés suivantes :
- Changez le nom en "Set Relay 1 False"
- Dans la liste déroulante Appareil, sélectionnez idevice
- Développez le nœud feuille de relais dans l'arborescence et sélectionnez 1, puis indiquez puis appuyez sur Terminé.
Double-cliquez sur le deuxième nœud Commande et modifiez les propriétés suivantes :
- Changez le nom en « Définir le relais 1 vrai »
- Dans la liste déroulante Appareil, sélectionnez idevice
- Développez le nœud feuille de relais dans l'arborescence et sélectionnez 1, puis indiquez puis appuyez sur Terminé.
Câblez tous les nœuds ensemble comme ceci :
- Injecter le nœud dans le nœud Statut
- Nœud d'état vers le nœud Switch
- Basculez le port 1 du nœud vers le nœud de commande nommé « Set Relay 1 False »
- Basculez le port du nœud 2 vers le nœud de commande nommé « Set Relay 1 True »
- Câblez les deux nœuds de commande au nœud de débogage

Une fois que vous avez terminé la configuration et le câblage de votre nœud, votre canevas de flux devrait ressembler à ceci :

Vous êtes maintenant prêt à déployer votre ﬂux. Dans le coin supérieur droit de l'application, cliquez sur le bouton Déployer pour déployer votre flux sur le serveur Node-RED local. Si vous êtes connecté à un contrôleur MUSE, vous devriez maintenant pouvoir appuyer continuellement sur le bouton du nœud d'injection et voir l'état du relais passer de vrai à faux dans le volet de débogage (et voir/entendre le relais allumer le contrôleur lui-même ! ).

Ressources supplémentaires

Chaîne YouTube AMX – htps://www.youtube.com/@AMXbyHARMAN
Ressources pour les développeurs AMX – htps://developer.amx.com/#!/main
Chaîne YouTube Node-RED – htps://www.youtube.com/@Node-RED
Documentation Node-RED – htps://nodered.org/docs/

© 2024 Harman. Tous les droits sont réservés. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD et HARMAN, ainsi que leurs logos respectifs sont des marques déposées de HARMAN. Oracle, Java et toute autre société ou nom de marque référencé peuvent être des marques commerciales/marques déposées de leurs sociétés respectives.

AMX n'assume aucune responsabilité en cas d'erreurs ou d'omissions. AMX se réserve également le droit de modifier à tout moment les spécifications sans préavis. La politique de garantie et de retour AMX et les documents connexes peuvent être viewed/téléchargé sur www.amx.com.

3000 RECHERCHE DRIVE, RICHARDSON, TX 75082 AMX.com
800.222.0193
469.624.8000
+1.469.624.7400
fax 469.624.7153
Dernière révision : 2024-03-01

Documents / Ressources

Application logicielle HARMAN Muse Automator Low Code [pdf] Manuel d'instructions
Application logicielle Muse Automator Low Code, Application logicielle Automator Low Code, Application logicielle Low Code, Application logicielle de code, Application logicielle, Application

Références

Manuel d'utilisation

Application logicielle HARMAN Muse Automator Low Code

Informations sur le produit

Instructions d'utilisation du produit

Installation et configuration

Premiers pas avec MUSE Automator

Example Workflow

Documents / Ressources

Références

Laisser un commentaire

Annuler la réponse