Aplicació de programari de codi baix HARMAN Muse Automator

Informació del producte

Especificacions

• Aplicació de programari sense codi/codi baix
• Dissenyat per utilitzar-lo amb els controladors AMX MUSE
• Construït sobre l'eina de programació basada en flux Node-RED
• Requereix NodeJS (v20.11.1+) i Node Package Manager (NPM) (v10.2.4+)
• Compatibilitat: PC Windows o MacOS

Instruccions d'ús del producte

Instal·lació i configuració

Abans d'instal·lar MUSE Automator, assegureu-vos d'haver instal·lat les dependències necessàries:

1. Instal·leu NodeJS i NPM seguint les instruccions proporcionades a: NodeJS
   Guia d'instal·lació.
2. Instal·leu MUSE Automator al vostre PC seguint les instruccions d'instal·lació corresponents.
3. Actualitzeu el firmware del controlador MUSE disponible a amx.com.
4. Activeu el suport Node-RED al controlador MUSE seguint els passos esmentats al manual.

Introducció a MUSE Automator

Modes de treball de l'automatitzador

Mode de simulació
Per utilitzar Automator en mode de simulació:

1. Arrossegueu un node Controlador a l'espai de treball.
2. Seleccioneu "simulador" al quadre desplegable del diàleg d'edició.
3. Feu clic a "Fet" i desplega per veure l'estat del simulador com a connectat.

Afegeix controladors i dispositius
Afegiu els controladors i dispositius corresponents segons els vostres requisits.

Mode connectat
Per utilitzar el mode connectat:

1. Introduïu l'adreça del vostre controlador físic MUSE a la configuració del node del controlador.
2. Proporcioneu nom d'usuari i contrasenya per al controlador.
3. Feu clic a "Connecta" per establir una connexió amb el servidor Node-RED al controlador MUSE.

Preguntes freqüents

Q: Què he de fer si MUSE Automator no funciona correctament?
A: Assegureu-vos que heu instal·lat totes les dependències necessàries i que heu seguit correctament les instruccions d'instal·lació. Poseu-vos en contacte amb el servei d'atenció al client per obtenir més ajuda.

Q: Com actualitzo el microprogramari del controlador MUSE?
A: Podeu actualitzar el microprogramari baixant la darrera versió d'amx.com i seguint les instruccions proporcionades per a l'actualització del microprogramari.

Instal·lació i configuració

MUSE Automator és una aplicació de programari sense codi/codi baix dissenyada per utilitzar-se amb els controladors AMX MUSE. Està construït sobre Node-RED, una eina de programació basada en flux àmpliament utilitzada.

Requisits previs
Abans d'instal·lar MUSE Automator, heu d'instal·lar diverses dependències que es descriuen a continuació. Si aquestes dependències no s'instal·len primer, Automator no s'executarà correctament.

1. Instal·leu NodeJS (v20.11.1+) i Node Package Manager (NPM) (v10.2.4+) Automator és una versió personalitzada del programari Node-RED, de manera que requereix que NodeJS s'executi al vostre sistema. També requereix Node Package Manager (NPM) per poder instal·lar nodes de tercers. Per instal·lar NodeJS i NPM, aneu a l'enllaç següent i seguiu les instruccions d'instal·lació: https://docs.npmis.com/downloading-and=installing-node-is-and-npm
2. Instal·leu Git (v2.43.0+)
   Git és un sistema de control de versions. Per a Automator, habilita la funció Projecte perquè pugueu organitzar els vostres fluxos en projectes discrets. També habilita la funcionalitat Push/Pull necessària per desplegar els vostres fluxos a un controlador MUSE físic. Per instal·lar Git, aneu al següent enllaç i seguiu les instruccions: https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

Nota: L'instal·lador de Git us guiarà per una sèrie d'opcions d'instal·lació. Es recomana utilitzar les opcions predeterminades i recomanades per l'instal·lador. Consulteu la documentació de Git per obtenir més informació.

Instal·leu MUSE Automator
Un cop instal·lats Git, NodeJS i NPM, podeu instal·lar MUSE Automator. Instal·leu MUSE Automator al vostre PC Windows o MacOS i seguiu les instruccions d'instal·lació corresponents.

Instal·leu el firmware del controlador MUSE
Per utilitzar MUSE Automator amb un controlador AMX MUSE, haureu d'actualitzar el microprogramari del controlador MUSE disponible amx.com.

Habiliteu el suport Node-RED al controlador MUSE
Node-RED està desactivat al controlador MUSE de manera predeterminada. S'ha d'habilitar manualment. Per fer-ho, inicieu sessió al vostre controlador MUSE i navegueu a Sistema > Extensions. A la llista d'Extensions disponibles, desplaceu-vos cap avall fins a mojonodred i feu-hi clic per seleccionar-lo. Premeu el botó Instal·la per instal·lar l'extensió Node-RED i permetre que el controlador s'actualitzi. Vegeu la captura de pantalla a continuació per a referència:

Altres informacions
Si teniu un tallafoc activat al vostre PC, haureu d'assegurar-vos que teniu el port 49152 obert perquè Automator es comuniqui a través d'aquest port correctament.

Introducció a MUSE Automator

Coneix Node-RED
Com que Automator és essencialment una versió personalitzada de Node-RED, primer hauríeu de familiaritzar-vos amb l'aplicació Node-RED. El programari té una corba d'aprenentatge relativament poc profunda. Hi ha centenars d'articles i vídeos d'instrucció disponibles per aprendre Node-RED, però un bon lloc per començar és a la documentació de Node-RED: https://nodered.org/docs. En particular, llegiu els tutorials, el llibre de cuina i els fluxos de desenvolupament per familiaritzar-vos amb les funcions i la interfície d'usuari de l'aplicació.

Aquesta guia no tractarà els conceptes bàsics de la programació Node-RED o basada en flux, per la qual cosa és imprescindible queview la documentació oficial de Node-RED abans de començar.

S'ha acabat la interfície Automatorview
La interfície de l'editor Automator és essencialment la mateixa que l'editor predeterminat de Node-RED amb alguns retocs als temes i algunes funcionalitats personalitzades que permeten la interacció entre l'editor i un controlador MUSE.

1. MUSE Automator Palette: nodes personalitzats per treballar amb dispositius HARMAN
2. Pestanya Flux: per canviar entre views de fluxos múltiples
3. Espai de treball: on creeu els vostres fluxos. Arrossegueu els nodes des de l'esquerra i deixeu-los anar a l'espai de treball
4. Safata Push/Pull: per gestionar projectes localment o en un controlador. Empènyer, tirar, iniciar, aturar, eliminar un projecte.
5. Desplega el botó/la safata: per desplegar fluxos des de l'editor al servidor local de Node-RED
6. Menú d'hamburgueses: menú principal de l'aplicació. Crear projectes, obrir projectes, gestionar fluxos, etc.

Modes de treball de l'automatitzador
Hi ha tres maneres diferents de treballar amb Automator. Aquests no són "modes" constrictius en si, sinó només mètodes per utilitzar Automator. Aquí fem servir el terme mode per senzillesa.

1. Simulació: els fluxos es despleguen localment i s'executen en un simulador MUSE perquè pugueu provar sense un controlador físic.
2. Connectat: esteu connectat a un controlador físic MUSE i els fluxos es despleguen i després s'executen localment en un ordinador. Si tanqueu Automator, els fluxos deixaran de funcionar.
3. Autònom: heu enviat els vostres fluxos desplegats a un controlador MUSE perquè s'executin de manera independent al controlador.
   Independentment del mode que utilitzeu, hauríeu de saber quins dispositius voleu controlar o automatitzar i, a continuació, carregar els seus controladors respectius al simulador o a un controlador físic. El mètode per carregar els controladors a qualsevol dels objectius és molt diferent. La càrrega de controladors al simulador es fa al diàleg d'edició del node del controlador Automator (vegeu Afegir controladors i dispositius). La càrrega de controladors a un controlador MUSE es fa al controlador web interfície. Per obtenir més informació sobre com carregar els controladors al vostre controlador MUSE, consulteu la documentació a https://www.amx.com/products/mu-3300#downloads.

Mode de simulació
Per utilitzar Automator en mode de simulació, arrossegueu un node del controlador a l'espai de treball i obriu el seu diàleg d'edició. Seleccioneu el simulador del quadre desplegable i feu clic al botó Fet. Ara podeu utilitzar nodes que poden accedir als punts finals del dispositiu simulador.

Feu clic al botó Desplega i hauríeu de veure l'estat del simulador indicat com a connectat amb un quadre indicador de color verd sòlid:

Afegeix controladors i dispositius
Ja hi ha diversos simuladors integrats al node del controlador de l'automat:

• Extensors d'IO de la sèrie CE: CE-IO4, CE-IRS4, CE-REL8, CE-COM2
• Ports d'E/S del controlador de la sèrie MU: MU-1300, MU-2300, MU-3300
• LED del panell frontal del controlador de la sèrie MU: MU-2300, MU-3300
• Un dispositiu ICSP NetLinx genèric

Per afegir dispositius al vostre simulador:

1. Feu clic al botó Carrega al costat de la llista de proveïdors. Això obrirà el diàleg del vostre sistema de fitxers. Seleccioneu el controlador corresponent per al dispositiu previst. Nota: es poden carregar els tipus de controladors següents:
   • Mòduls DUET (Recuperar de developer.amx.com)
   • Controladors MUSE natius
     c. Fitxers del simulador
2. Un cop carregat el controlador, podeu afegir el dispositiu corresponent fent clic al botó Afegeix al costat de la llista Dispositius.

Mode connectat
El mode connectat requereix que tingueu un controlador MUSE físic a la vostra xarxa al qual us podeu connectar. Obriu el vostre node Controller i introduïu l'adreça del vostre controlador MUSE. El port és 80 i està configurat per defecte. Introduïu el nom d'usuari i la contrasenya del vostre controlador i, a continuació, premeu el botó Connecta. Hauríeu d'observar una notificació que l'Automator s'ha connectat al servidor Node-RED del controlador MUSE. Vegeu la captura de pantalla a continuació.

Mode autònom
Aquesta manera de treballar amb Automator consisteix simplement a impulsar els vostres fluxos des del vostre ordinador local al servidor Node-RED que s'executa en un controlador MUSE. Això requereix que els Projectes estiguin habilitats (que requereix la instal·lació de git). Llegiu a continuació per obtenir més informació sobre Projectes i Push/Pull.

Desplegant
Cada vegada que feu un canvi a un node, haureu de desplegar aquests canvis des de l'editor al servidor Node-RED per fer que els fluxos s'executin. Hi ha algunes opcions sobre què i com implementar els vostres flux al menú desplegable Desplega. Per obtenir més informació sobre la implementació a Node-RED, consulteu la documentació de Node-RED.

Quan es desplega a Automator, els fluxos es despleguen al servidor local Node-RED que s'executa al vostre ordinador. Aleshores, els fluxos desplegats s'han de "enviar" des del vostre ordinador local al servidor Node-RED que s'executa al controlador MUSE.

Una bona manera de determinar si teniu canvis sense desplegar als vostres fluxos/nodes és al botó Desplega a la cantonada superior dreta de l'aplicació. Si està en gris i no és interactiu, no teniu cap canvi no desplegat en els vostres fluxos. Si és vermell i interactiu, aleshores teniu canvis no desplegats en els vostres fluxos. Vegeu les captures de pantalla a continuació.

Projectes
Per Push/Pull del vostre servidor Node-RED local al servidor que s'executa al vostre controlador, cal que la funció Projectes estigui habilitada a Automator. La funció Projectes s'habilita automàticament si git està instal·lat al vostre ordinador. Per saber com instal·lar git, consulteu la secció Instal·lar Git d'aquesta guia.
Suposant que heu instal·lat git i reiniciat MUSE Automator, podeu crear un projecte nou fent clic al menú d'hamburgueses a l'extrem superior dret de l'aplicació.

Introduïu un nom de projecte (no es permeten espais ni caràcters especials) i, de moment, seleccioneu l'opció Desactiva el xifratge a Credencials. Premeu el botó Crea projecte per completar la creació del projecte.

Ara que heu creat un projecte, podeu empènyer/tirar a un controlador MUSE físic.

Projectes d'empenta/estirada
Empènyer i treure els vostres fluxos des del vostre ordinador al servidor Node-RED en un controlador MUSE és una característica única d'Automator. Cal fer un parell de passos abans de poder empènyer/estirar

1. Assegureu-vos que esteu connectat al vostre controlador MUSE mitjançant el node Controlador
2. Assegureu-vos que heu implementat qualsevol canvi en els vostres fluxos (el botó Desplega hauria d'estar en gris)

Per impulsar els fluxos desplegats des del vostre ordinador, feu clic a la fletxa Empènyer/Abaixar.

Passeu el cursor per sobre del projecte local i feu clic a la icona de càrrega per enviar el projecte des del vostre servidor Node-RED local al servidor Node-RED del vostre controlador MUSE.

Després d'empènyer el vostre projecte local al controlador, premeu el botó Push/Pull (no la fletxa) i sembla que el projecte s'està executant al controlador.
De la mateixa manera, un projecte que s'ha enviat a un controlador es pot treure del controlador al vostre ordinador. Passeu el cursor per sobre del projecte remot, feu clic a la icona de descàrrega per treure el projecte.

Executar un projecte
Els projectes que s'estan executant al controlador o al vostre servidor Node-RED local s'indicaran amb una etiqueta d'execució. Per executar un projecte diferent al servidor remot o al servidor local, passeu el cursor per sobre del projecte i feu clic a la icona de reproducció. Nota: només es pot executar un projecte alhora en Local o Remot.

Eliminar un projecte
Per suprimir un projecte, passeu el cursor per sobre del nom del projecte a Local o Remot i feu clic a la icona de la paperera. Avís: aneu amb compte amb el que esteu suprimint, o podríeu perdre feina.

Aturar un projecte

Pot haver-hi escenaris en què vulgueu aturar o iniciar un projecte Automator de manera local o remota al controlador. Automator ofereix la possibilitat d'iniciar o aturar qualsevol projecte segons sigui necessari. Per aturar un projecte, feu clic per ampliar la safata Push/Pull. Passeu el cursor per sobre de qualsevol projecte en execució a la llista Remot o Local i, a continuació, feu clic a la icona d'aturar.

Paleta de nodes de MUSE Automator 

Automator s'envia amb la nostra pròpia paleta de nodes personalitzada també titulada MUSE Automator. Actualment hi ha set nodes proporcionats que permeten la funcionalitat i la interacció amb el simulador i els controladors MUSE.

Controlador
El node Controller és el que proporciona el vostre simulador de fluxos o el context del controlador MUSE i accés programàtic als dispositius que s'han afegit al controlador. Té els següents camps que es poden configurar:

• Nom: propietat de nom universal per a tots els nodes.
• Controlador: el controlador o simulador al qual us voleu connectar. Seleccioneu el simulador per connectar-vos al controlador MUSE simulat. Per connectar-se a un controlador físic, assegureu-vos que estigui connectat a la vostra xarxa i introduïu la seva adreça IP al camp amfitrió. Premeu el botó Connecta per connectar-vos al controlador.
• Proveïdors: la llista de controladors que s'han penjat al vostre simulador o controlador. Premeu el botó Carrega per afegir un controlador. Seleccioneu un controlador i premeu Suprimeix per eliminar un controlador de la llista.
• Dispositius: la llista de dispositius que s'han afegit al simulador o controlador.
  • Edita: seleccioneu un dispositiu de la llista i feu clic a Edita per editar-ne les propietats
  • Afegeix: feu clic per afegir un dispositiu nou (segons els controladors de la llista de proveïdors).
    • Instància: quan s'afegeix un dispositiu nou es requereix un nom d'instància únic.
    • Nom - Opcional. Nom del dispositiu
    • Descripció (opcional. Descripció del dispositiu.
    • Controlador: seleccioneu el controlador adequat (segons els controladors de la llista de proveïdors).
  • Suprimeix: seleccioneu un dispositiu de la llista i feu clic a Suprimeix per eliminar-lo.

Estat
Utilitzeu el node Estat per obtenir l'estat o l'estat d'un paràmetre específic del dispositiu.

• Nom: propietat de nom universal per a tots els nodes.
• Dispositiu: seleccioneu el dispositiu (segons la llista Dispositius del node Controlador). Això generarà un arbre de paràmetres a la llista següent. Seleccioneu el paràmetre per a la recuperació d'estat.
• Paràmetre: camp de només lectura que mostra la ruta del paràmetre del paràmetre seleccionat.

Esdeveniment
Utilitzeu el node Esdeveniment per escoltar esdeveniments del dispositiu, com ara canvis d'estat per activar una acció (com ara una ordre)

• Nom: propietat de nom universal per a tots els nodes.
• Dispositiu: seleccioneu el dispositiu (segons la llista Dispositius del node Controlador). Això generarà un arbre de paràmetres a la llista següent. Seleccioneu un paràmetre de la llista.
• Esdeveniment: camp de només lectura que mostra la ruta del paràmetre
• Tipus d'esdeveniment: tipus de només lectura de l'esdeveniment de paràmetre seleccionat.
• Tipus de paràmetre: tipus de dades de només lectura del paràmetre seleccionat.
• Esdeveniment (sense etiquetar): quadre desplegable amb la llista d'esdeveniments que es poden escoltar

Comandament
Utilitzeu el node Command per enviar una ordre a un dispositiu.

• Nom: propietat de nom universal per a tots els nodes.
• Dispositiu: seleccioneu el dispositiu (segons la llista Dispositius del node Controlador). Això generarà un arbre de paràmetres a la llista següent. Només es mostraran els paràmetres que es poden configurar.
• Seleccionat: camp de només lectura que mostra la ruta del paràmetre.
• Entrada: trieu Configuració manual per veure les ordres disponibles al quadre desplegable que es poden executar.

Navega
Utilitzeu el node Navega per fer un gir de pàgina a un panell tàctil TP5

• Nom – propietat de nom universal per a tots els nodes.
• Panell - Seleccioneu el panell tàctil (afegit mitjançant el node Tauler de control)
• Ordres - Trieu l'ordre Flip
• G5 – Una cadena editable de l'ordre a enviar. Seleccioneu la pàgina de la llista generada de pàgines del panell per omplir aquest camp.

Tauler de control
Utilitzeu el node Tauler de control per afegir context al tauler tàctil al flux.

• Nom: propietat de nom universal per a tots els nodes.
• Dispositiu: seleccioneu el dispositiu del panell tàctil
• Panell: feu clic a Navega per carregar un fitxer .TP5. Això generarà un arbre de només lectura de les pàgines i botons del fitxer del panell tàctil. Feu referència a aquesta llista com a verificació del fitxer.

Control de la IU
Utilitzeu el node Control de la IU per programar botons o altres controls des del fitxer del panell tàctil.

• Nom – propietat de nom universal per a tots els nodes.
• Dispositiu – Seleccioneu el dispositiu de panell tàctil
• Tipus – Seleccioneu el tipus de control de la IU. Seleccioneu el control de la interfície d'usuari de l'arbre de pàgines/botons de sota
• Disparador – Trieu el disparador per al control de la IU (per exemple,ample, PUSH o RELEASE)
• Estat – Estableix l'estat del control de la interfície d'usuari quan s'activa (per exemple,ample, ON o OFF)

Exampel Flux de treball

En aquest exampal flux de treball, farem:

• Connecteu-vos a un controlador MUSE
• Creeu un flux que ens permeti canviar l'estat d'un relé en un MU-2300
• Desplegueu el flux al nostre servidor local Node-RED

Connecteu-vos al controlador MUSE 

1. Configura el teu controlador MUSE. Consulteu la documentació a
2. Arrossegueu un node Controlador des de la paleta del node MUSE Automator al llenç i feu-hi doble clic per obrir el seu diàleg d'edició.
3. Introduïu l'adreça IP del vostre controlador MUSE i premeu el botó Connectar i després el botó Fet.
   A continuació, premeu el botó Desplega. El vostre diàleg i el node del controlador haurien de semblar:

Crear i desplegar un flux 

1. A continuació, comencem a construir un flux arrossegant diversos nodes al llenç. Arrossegueu els nodes següents i col·loqueu-los en ordre d'esquerra a dreta:
   • Injectar
   • Estat
   • Canvia (a la paleta de funcions)
   • Ordre (arrossegar dos)
   • Depuració
2. Feu doble clic al node Injectar i canvieu-ne el nom a "Activador manual" i premeu Fet
3. Feu doble clic al node Estat i modifiqueu les propietats següents:
   • Canvia el seu nom a "Obtén l'estat del relé 1"
   • Al menú desplegable Dispositiu, seleccioneu idevice
   • Amplieu el node full de relé a l'arbre i seleccioneu 1 i, a continuació, estat
   • Premeu Fet
4. Feu doble clic al node Canvia i modifiqueu les propietats següents:
   • Canvia el nom a "Comprova l'estat del relé 1"
   • Feu clic al botó +afegeix a la part inferior del diàleg. Ara hauríeu de tenir dues regles a la llista. Un punt a 1 port i dos punts a 2 port
   • Escriviu true al primer camp i configureu el tipus com a expressió
   • Escriviu false al segon camp i configureu el tipus com a expressió
   • El vostre node de commutació adequat hauria de semblar així:
5. Feu doble clic al primer node d'ordres i modifiqueu les propietats següents:
   • Canvia el nom a "Estableix el relé 1 fals"
   • Al menú desplegable Dispositiu, seleccioneu idevice
   • Amplieu el node full de relé a l'arbre i seleccioneu 1 i, a continuació, indiqueu i premeu Fet
6. Feu doble clic al segon node d'ordres i modifiqueu les propietats següents:
   • Canvia el nom a "Estableix el relé 1 com a cert"
   • Al menú desplegable Dispositiu, seleccioneu idevice
   • Amplieu el node full de relé a l'arbre i seleccioneu 1 i, a continuació, indiqueu i premeu Fet
7. Connecteu tots els nodes junts així:
   • Injecteu el node al node Estat
   • Node d'estat al node Switch
   • Canvia el port del node 1 al node d'ordres anomenat "Estableix el relé 1 fals"
   • Canvia el port del node 2 al node d'ordres anomenat "Estableix el relé 1 com a cert"
   • Connecteu els dos nodes de comandament al node de depuració

Un cop hàgiu completat la configuració i el cablejat del vostre node, el vostre llenç de flux hauria de semblar així:

Ara esteu preparat per desplegar el vostre flux. A l'extrem superior dret de l'aplicació, feu clic al botó Desplega per desplegar el vostre flux al servidor Node-RED local. Si esteu connectat a un controlador MUSE, ara hauríeu de poder prémer contínuament el botó del node d'injecte i veure com l'estat del relé canvia de cert a fals al panell de depuració (i veure/escoltar el relé s'encén al mateix controlador! ).

Recursos addicionals

• Canal de YouTube AMX - htps://www.youtube.com/@AMXbyHARMAN
• Recursos per a desenvolupadors AMX - htps://developer.amx.com/#!/main
• Canal de YouTube Node-RED - htps://www.youtube.com/@Node-RED
• Documentació de Node-RED - htps://nodered.org/docs/

© 2024 Harman. Tots els drets reservats. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD i HARMAN i els seus respectius logotips són marques registrades de HARMAN. Oracle, Java i qualsevol altra empresa o marca a què es fa referència poden ser marques comercials/marques registrades de les seves respectives empreses.

AMX no assumeix responsabilitat per errors o omissions. AMX també es reserva el dret d'alterar les especificacions sense previ avís en qualsevol moment. La política de devolució i garantia d'AMX i els documents relacionats poden ser viewed/descarregat a www.amx.com.

3000 RESEARCH DRIVE, RICHARDSON, TX 75082 AMX.com
800.222.0193
469.624.8000
+1.469.624.7400
fax 469.624.7153
Última revisió: 2024-03-01

Documents/Recursos

Aplicació de programari de codi baix HARMAN Muse Automator [pdfManual d'instruccions Aplicació de programari Muse Automator Low Code, Aplicació de programari Automator Low Code, Aplicació de programari Low Code, Aplicació de programari de codi, Aplicació de programari, Aplicació

Referències

• Manual d'usuari