Manual de instrucións da aplicación de software de código baixo HARMAN Muse Automator

Instale NodeJS e NPM seguindo as instrucións proporcionadas en: NodeJS
Guía de instalación.
Instala MUSE Automator no teu PC seguindo as instrucións do instalador correspondente.

Actualice o firmware do controlador MUSE dispoñible en amx.com.
Active o soporte Node-RED no controlador MUSE seguindo os pasos mencionados no manual.

Iniciación a MUSE Automator

Modos de traballo automatizados

Modo de simulación
Para usar Automator no modo de simulación:

Arrastre un nodo do controlador ao espazo de traballo.

Seleccione "simulador" no cadro despregable do diálogo de edición.
Fai clic en "Feito" e implementa para ver o estado do simulador como conectado.

Engadir controladores e dispositivos
Engade os controladores e dispositivos correspondentes segundo os teus requisitos.

Modo conectado
Para usar o modo conectado:

Introduza o enderezo do seu controlador MUSE físico na configuración do nodo do controlador.
Proporcione nome de usuario e contrasinal para o controlador.

Fai clic en "Conectar" para establecer unha conexión co servidor Node-RED no controlador MUSE.

FAQ

Q: Que debo facer se MUSE Automator non funciona correctamente?
A: Asegúrate de ter instalado todas as dependencias necesarias e de seguir as instrucións de instalación correctamente. Póñase en contacto co servizo de atención ao cliente para obter máis axuda.

Q: Como actualizo o firmware do controlador MUSE?
A: Podes actualizar o firmware descargando a versión máis recente de amx.com e seguindo as instrucións proporcionadas para a actualización do firmware.

Instalación e configuración

MUSE Automator é unha aplicación de software sen código ou de baixo código deseñada para usar cos controladores AMX MUSE. Está construído sobre Node-RED, unha ferramenta de programación baseada en fluxo moi utilizada.

Requisitos previos
Antes de instalar MUSE Automator, debe instalar varias dependencias que se indican a continuación. Se estas dependencias non se instalan primeiro, Automator non funcionará correctamente.

Instala NodeJS (v20.11.1+) e Node Package Manager (NPM) (v10.2.4+) Automator é unha versión personalizada do software Node-RED, polo que require que NodeJS se execute no teu sistema. Tamén require Node Package Manager (NPM) para poder instalar nós de terceiros. Para instalar NodeJS e NPM, vaia á seguinte ligazón e siga as instrucións de instalación: https://docs.npmis.com/downloading-and=installing-node-is-and-npm
Instalar Git (v2.43.0+)
Git é un sistema de control de versións. Para Automator, activa a función Proxecto para que poida organizar os seus fluxos en proxectos discretos. Tamén activa a funcionalidade Push/Pull necesaria para implementar os teus fluxos nun controlador MUSE físico. Para instalar Git, vai á seguinte ligazón e siga as instrucións: https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

Nota: O instalador de Git guiarache por unha serie de opcións de instalación. Recoméndase utilizar as opcións predeterminadas e recomendadas polo instalador. Consulte a documentación de Git para obter máis información.

Instalar MUSE Automator
Unha vez instalados Git, NodeJS e NPM, podes instalar MUSE Automator. Instale MUSE Automator no seu PC con Windows ou MacOS e siga as instrucións do instalador correspondente.

Instale o firmware do controlador MUSE
Para usar MUSE Automator cun controlador AMX MUSE, terá que actualizar o firmware do controlador MUSE dispoñible amx.com.

Activar o soporte Node-RED no controlador MUSE
Node-RED está desactivado no controlador MUSE por defecto. Debe estar activado manualmente. Para facelo, inicie sesión no seu controlador MUSE e navegue ata Sistema > Extensións. Na lista de extensións dispoñibles, desprácese ata mojonodred e fai clic nel para seleccionalo. Preme o botón Instalar para instalar a extensión Node-RED e permitir que o controlador se actualice. Vexa a captura de pantalla a continuación para referencia:

Outra información
Se tes un firewall activado no teu PC, terás que asegurarte de que tes o porto 49152 aberto para que Automator se comunique a través deste porto correctamente.

Iniciación a MUSE Automator

Coñece Node-RED
Dado que Automator é esencialmente unha versión personalizada de Node-RED, primeiro debes familiarizarte coa aplicación Node-RED. O software ten unha curva de aprendizaxe relativamente pouca. Hai centos de artigos e vídeos instrutivos dispoñibles para aprender Node-RED, pero un bo lugar para comezar é na documentación de Node-RED: https://nodered.org/docs. En particular, lea os titoriais, o libro de receitas e os fluxos de desenvolvemento para familiarizarse coas funcións e a interface de usuario da aplicación.

Esta guía non cubrirá os conceptos básicos de Node-RED ou programación baseada en fluxo, polo que é imperativo queview a documentación oficial de Node-RED antes de comezar.

Interface de automatización superadaview
A interface do editor de Automator é esencialmente a mesma que o editor predeterminado de Node-RED con algúns axustes nos temas e algunhas funcionalidades personalizadas que permiten a interacción entre o editor e un controlador MUSE.

MUSE Automator Palette: nodos personalizados para traballar con dispositivos HARMAN
Ficha Fluxo: para cambiar entre views de fluxos múltiples
Espazo de traballo: onde creas os teus fluxos. Arrastra os nós desde a esquerda e solta no espazo de traballo
Bandexa Push/Pull: para xestionar proxectos localmente ou nun controlador. Empuxar, tirar, iniciar, deter, eliminar un proxecto.
Botón/Bandexa de implementación: para despregar fluxos desde o editor ao servidor local Node-RED
Menú Hamburger - Menú principal da aplicación. Crear proxectos, abrir proxectos, xestionar fluxos, etc.

Modos de traballo automatizados
Hai tres formas distintas de traballar con Automator. Estes non son "modos" constrictivos en si, senón só métodos de uso de Automator. Usamos aquí o termo modo para simplificar.

Simulación: os fluxos despréganse localmente e execútanse nun simulador MUSE para que poida probar sen un controlador físico.
Conectado: estás conectado a un controlador MUSE físico e os fluxos despréganse e despois execútanse localmente nun PC. Se apagas Automator, os fluxos deixarán de funcionar.
Autónomo: enviou os seus fluxos implantados a un controlador MUSE para que se executen de forma independente no controlador.
Independentemente do modo que esteas a executar, debes saber cales son os dispositivos que pretendes controlar ou automatizar e, a continuación, cargar os seus respectivos controladores no simulador ou nun controlador físico. O método para cargar controladores a calquera dos obxectivos é moi diferente. A carga de controladores no simulador prodúcese no diálogo de edición do nodo do controlador Automator (consulte Engadir controladores e dispositivos). A carga de controladores nun controlador MUSE realízase no controlador web interface. Para obter máis información sobre como cargar controladores no seu controlador MUSE, consulte a documentación en https://www.amx.com/products/mu-3300#downloads.

Modo de simulación
Para usar Automator no modo de simulación, arrastre un nodo do controlador ao espazo de traballo e abra o seu diálogo de edición. Seleccione simulador no menú despregable e prema no botón Feito. Agora podes usar nós que poden acceder aos puntos finais do dispositivo simulador.

Fai clic no botón Implementar e deberías ver o estado do simulador indicado como conectado cunha caixa indicadora verde sólida:

Engadir controladores e dispositivos
Xa hai varios simuladores integrados no nodo do controlador de Automator:

Extensores IO da serie CE: CE-IO4, CE-IRS4, CE-REL8, CE-COM2

Portos de E/S do controlador da serie MU: MU-1300, MU-2300, MU-3300
LED do panel frontal do controlador da serie MU: MU-2300, MU-3300
Un dispositivo ICSP NetLinx xenérico

Para engadir dispositivos ao teu simulador:

Fai clic no botón Cargar xunto á lista de provedores. Isto abrirá o diálogo do teu sistema de ficheiros. Seleccione o controlador correspondente para o dispositivo previsto. Nota: pódense cargar os seguintes tipos de controladores:
- Módulos DUET (Recuperar de developer.amx.com)
- Controladores MUSE nativos
  c. Arquivos do simulador
Unha vez cargado o controlador, pode engadir o dispositivo respectivo premendo no botón Engadir xunto á lista de Dispositivos.

Modo conectado
O modo conectado require que teñas un controlador MUSE físico na túa rede ao que poidas conectarte. Abre o teu nodo Controller e introduce o enderezo do teu controlador MUSE. O porto é 80 e está configurado por defecto. Introduza o nome de usuario e o contrasinal do controlador e prema o botón Conectar. Debería observar unha notificación de que Automator se conectou ao servidor Node-RED no controlador MUSE. Vexa a captura de pantalla a continuación.

Modo autónomo
Este modo de traballar con Automator implica simplemente empurrar os teus fluxos desde o teu PC local ata o servidor Node-RED que se executa nun controlador MUSE. Isto require que os proxectos estean habilitados (o que require a instalación de git). Le a continuación para obter máis información sobre proxectos e Push/Pull.

Despregando
Cada vez que fagas un cambio nun nodo, terás que implementar eses cambios desde o editor ao servidor Node-RED para que se executen os fluxos. Existen algunhas opcións sobre o que e como implementar os teus fluxos no menú despregable Implantar. Para obter máis información sobre a implementación en Node-RED, consulte a documentación de Node-RED.

Cando se implementa en Automator, os fluxos despréganse ao servidor local de Node-RED que se executa no seu PC. Entón, os fluxos despregados deben ser "empuxados" desde o seu PC local ao servidor Node-RED que se executa no controlador MUSE.

Unha boa forma de determinar se tes algún cambio sen implementar nos teus fluxos/nodos é no botón Implementar na esquina superior dereita da aplicación. Se está atenuado e non interactivo, entón non tes cambios sen implementar nos teus fluxos. Se é vermello e interactivo, entón tes cambios sen implementar nos teus fluxos. Vexa as capturas de pantalla a continuación.

Proxectos
Para Push/Pull do teu servidor local Node-RED ao servidor que se executa no teu controlador, a función Proxectos debe estar activada en Automator. A función Proxectos habilitarase automaticamente se git está instalado no teu PC. Para saber como instalar git, consulte a sección Instalar Git desta guía.
Asumindo que instalaches git e reiniciases MUSE Automator, podes crear un novo proxecto facendo clic no menú de hamburguesas na esquina superior dereita da aplicación.

Introduza un nome de proxecto (non se permiten espazos nin caracteres especiais) e, polo momento, seleccione a opción Desactivar o cifrado en Credenciais. Preme o botón Crear proxecto para completar a creación do proxecto.

Agora que creaches un proxecto, podes Push/Pull a un controlador MUSE físico.

Empuxando/Pulling Proxectos
Empurrar e tirar dos seus fluxos desde o seu PC ao servidor Node-RED nun controlador MUSE é unha característica única en Automator. Hai que realizar un par de pasos antes de poder Push/Pull

Asegúrate de estar conectado ao teu controlador MUSE a través do nodo Controller
Asegúrate de implementar calquera cambio nos teus fluxos (o botón Implementar debería estar atenuado)

Para impulsar os fluxos implantados desde o seu PC, faga clic na frecha Push/Pull down.

Pasa o rato sobre o proxecto local e fai clic na icona de carga para enviar o proxecto desde o teu servidor Node-RED local ao servidor Node-RED do teu controlador MUSE.

Despois de empurrar o proxecto local ao controlador, preme o botón Push/Pull (non a frecha) e o proxecto debería parecer que se está a executar no controlador.
Do mesmo xeito, un proxecto que foi enviado a un controlador pode ser tirado do controlador ao seu PC. Pasa o rato sobre o proxecto remoto fai clic na icona de descarga para tirar o proxecto.

Executar un proxecto
Os proxectos que se estean executando no controlador ou no seu servidor local Node-RED indicaranse cunha etiqueta de execución. Para executar un proxecto diferente no servidor remoto ou local, pasa o rato sobre o proxecto e fai clic na icona de reprodución. Nota: só se pode executar un proxecto á vez en Local ou Remoto.

Eliminar un proxecto
Para eliminar un proxecto, pasa o rato sobre o nome do proxecto en Local ou Remoto e fai clic na icona da papeleira. Aviso: teña coidado co que está a eliminar ou pode perder traballo.

Parar un proxecto

Pode haber escenarios nos que queiras deter ou iniciar un proxecto de Automator de forma local ou remota no controlador. Automator ofrece a posibilidade de iniciar ou deter calquera proxecto segundo sexa necesario. Para deter un proxecto, fai clic para expandir a bandexa Push/Pull. Pasa o rato sobre calquera proxecto en execución na lista Remoto ou Local e fai clic na icona de parar.

Paleta de nodos MUSE Automator

Automator envíase coa nosa propia paleta de nodos personalizada tamén titulada MUSE Automator. Actualmente hai sete nodos proporcionados que permiten a funcionalidade e a interacción co simulador e os controladores MUSE.

Controlador
O nodo Controller é o que proporciona ao seu simulador de fluxos ou contexto do controlador MUSE e acceso programático aos dispositivos que se engadiron ao controlador. Ten os seguintes campos que se poden configurar:

Nome: propiedade de nome universal para todos os nós.

Controlador: o controlador ou simulador ao que desexa conectarse. Seleccione o simulador para conectarse ao controlador MUSE simulado. Para conectarse a un controlador físico, asegúrese de que estea conectado á súa rede e introduza o seu enderezo IP no campo de host. Preme o botón Conectar para conectarte ao controlador.
Provedores: a lista de controladores que se cargaron no seu simulador ou controlador. Preme o botón Cargar para engadir un controlador. Seleccione un controlador e prema Eliminar para eliminar un controlador da lista.
Dispositivos: a lista de dispositivos que se engadiron ao simulador ou ao controlador.
- Editar: seleccione un dispositivo da lista e prema en Editar para editar as súas propiedades
- Engadir: fai clic para engadir un dispositivo novo (segundo os controladores da lista de provedores).
  - Instancia: ao engadir un dispositivo novo é necesario un nome de instancia único.
  - Nome - Opcional. Nome para o dispositivo
  - Descrición - Opcional. Descrición do dispositivo.
  - Controlador: seleccione o controlador axeitado (segundo os controladores da lista de Provedores).
- Eliminar: seleccione un dispositivo da lista e faga clic en Eliminar para eliminar o dispositivo.

Estado
Use o nodo Estado para obter o estado ou o estado dun parámetro específico do dispositivo.

Nome: propiedade de nome universal para todos os nós.
Dispositivo: seleccione o dispositivo (en base á lista Dispositivos do nodo Controlador). Isto xerará unha árbore de parámetros na seguinte lista. Seleccione o parámetro para a recuperación do estado.
Parámetro: campo de só lectura que mostra a ruta do parámetro seleccionado.

Evento
Use o nodo Evento para escoitar eventos do dispositivo, como cambios de estado para activar unha acción (como un comando)

Nome: propiedade de nome universal para todos os nós.

Dispositivo: seleccione o dispositivo (en base á lista Dispositivos do nodo Controlador). Isto xerará unha árbore de parámetros na seguinte lista. Seleccione un parámetro da lista.
Evento: campo de só lectura que mostra a ruta do parámetro
Tipo de evento: tipo de só lectura do evento do parámetro seleccionado.

Tipo de parámetro: tipo de datos de só lectura do parámetro seleccionado.
Evento (sen etiqueta): caixa despregable coa lista de eventos que se poden escoitar

Comando
Use o nodo Comando para enviar un comando a un dispositivo.

Nome: propiedade de nome universal para todos os nós.
Dispositivo: seleccione o dispositivo (en base á lista Dispositivos do nodo Controlador). Isto xerará unha árbore de parámetros na seguinte lista. Só se mostrarán os parámetros que se poden configurar.

Seleccionado: campo de só lectura que mostra a ruta do parámetro.
Entrada: escolla Configuración manual para ver os comandos dispoñibles no cadro despregable que se poden executar.

Navega
Use o nodo Navegación para realizar un xiro de páxina a un panel táctil TP5

Nome – Propiedade de nome universal para todos os nós.
Panel - Seleccione o panel táctil (engadido a través do nodo Panel de control)

Comandos – Escolla o comando Voltar
G5 – Unha cadea editable do comando a enviar. Seleccione a páxina da lista xerada de páxinas de paneis para encher este campo.

Panel de control
Use o nodo Panel de control para engadir contexto do panel táctil ao fluxo.

Nome: propiedade de nome universal para todos os nós.
Dispositivo: seleccione o dispositivo do panel táctil

Panel: fai clic en Examinar para cargar un ficheiro .TP5. Isto xerará unha árbore de só lectura das páxinas e botóns do ficheiro do panel táctil. Fai referencia a esta lista como verificación do ficheiro.

Control de IU
Use o nodo Control da IU para programar botóns ou outros controis desde o ficheiro do panel táctil.

Nome – Propiedade de nome universal para todos os nós.
Dispositivo – Seleccione o dispositivo do panel táctil
Tipo – Seleccione o tipo de control da IU. Seleccione o control da IU na árbore de páxinas/botóns que aparece a continuación

Disparador – Escolla o disparador para o control da interface de usuario (por exemploample, PUSH ou RELEASE)
Estado – Establece o estado do control da IU cando se activa (por exemploample, ON ou OFF)

Exampo Fluxo de traballo

Neste exampno fluxo de traballo, faremos:

Conéctese a un controlador MUSE
Crear un fluxo que nos permita cambiar o estado dun relé nun MU-2300

Implementa o fluxo no noso servidor local Node-RED

Conéctese ao controlador MUSE

Configura o teu controlador MUSE. Consulte a documentación en

Arrastre un nodo Controlador desde a paleta de nodos MUSE Automator ao lenzo e prema dúas veces nel para abrir o seu diálogo de edición.
Introduza o enderezo IP do seu controlador MUSE e prema o botón Conectar e despois o botón Feito.
A continuación, prema o botón Implementar. O seu diálogo e o nodo do controlador deberían verse así:

Crea e implementa un fluxo

A continuación, imos comezar a construír un fluxo arrastrando varios nodos ao lenzo. Arrastra os seguintes nodos e colócaos de esquerda a dereita:
- Inxectar
- Estado
- Cambiar (baixo a paleta de funcións)
- Comando (arrastra dous)
- Depurar
Fai dobre clic no nodo Inxectar e cambia o seu nome a "Disparo manual" e prema Feito
Fai dobre clic no nodo Estado e modifica as seguintes propiedades:
- Cambia o seu nome a "Obter o estado do relé 1"
- No menú despregable Dispositivo, seleccione idevice
- Expande o nodo da folla de retransmisión na árbore e selecciona 1 e despois indica
- Prema Feito
Fai dobre clic no nodo Cambiar e modifica as seguintes propiedades:
- Cambia o nome a "Comprobar o estado do relé 1"
- Fai clic no botón +engadir na parte inferior do diálogo. Agora deberías ter dúas regras na lista. Un punto a 1 porto e dous puntos a 2 porto
- Escriba true no primeiro campo e configure o tipo como expresión
- Escriba false no segundo campo e configure o tipo como expresión
- O teu nodo de conmutación apropiado debería verse así:
Fai dobre clic no primeiro nodo de comandos e modifica as seguintes propiedades:
- Cambia o nome a "Establecer relé 1 falso"
- No menú despregable Dispositivo, seleccione idevice
- Amplíe o nodo da folla de relé na árbore e seleccione 1 e, a continuación, indique e prema Feito
Fai dobre clic no segundo nodo de comandos e modifica as seguintes propiedades:
- Cambia o nome a "Set Relay 1 True"
- No menú despregable Dispositivo, seleccione idevice
- Amplíe o nodo da folla de relé na árbore e seleccione 1 e, a continuación, indique e prema Feito
Conecte todos os nodos xuntos así:
- Inxecta un nodo ao nodo Estado
- Nodo de estado ao nodo Cambiar
- Cambia o porto do nodo 1 ao nodo de comando chamado "Establecer relé 1 falso"
- Cambia o porto do nodo 2 ao nodo de comando chamado "Establecer relé 1 verdadeiro"
- Conecte os dous nodos de comando ao nodo de depuración

Unha vez que remates de configurar e conectar o teu nodo, o teu lenzo de fluxo debería verse así:

Agora estás preparado para implementar o teu fluxo. Na esquina superior dereita da aplicación, fai clic no botón Implementar para implementar o teu fluxo no servidor local de Node-RED. Se estás conectado a un controlador MUSE, agora deberías poder premer continuamente o botón do nodo de inxección e ver o estado do relé cambiando de verdadeiro a falso no panel de depuración (e ver/escoitar o relé acendendo o propio controlador! ).

Recursos adicionais

Canle de YouTube AMX - htps://www.youtube.com/@AMXbyHARMAN
Recursos para programadores AMX - htps://developer.amx.com/#!/main
Canle de YouTube de Node-RED - htps://www.youtube.com/@Node-RED
Documentación de Node-RED - htps://nodered.org/docs/

© 2024 Harman. Todos os dereitos reservados. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD e HARMAN e os seus respectivos logotipos son marcas rexistradas de HARMAN. Oracle, Java e calquera outra empresa ou marca referenciada poden ser marcas comerciais ou marcas rexistradas das súas respectivas empresas.

AMX non asume responsabilidade por erros ou omisións. AMX tamén se reserva o dereito de modificar as especificacións sen previo aviso en calquera momento. A política de garantía e devolución de AMX e os documentos relacionados poden ser viewed/descargado en 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ón: 2024-03-01

Documentos/Recursos

Aplicación de software de código baixo HARMAN Muse Automator [pdfManual de instrucións
Aplicación de software de código baixo de Muse Automator, aplicación de software de código baixo Automator, aplicación de software de código baixo, aplicación de software de código, aplicación de software, aplicación

Referencias

Manual de usuario

Aplicación de software de código baixo HARMAN Muse Automator

Información do produto

Instrucións de uso do produto

Instalación e configuración

Iniciación a MUSE Automator

Exampo Fluxo de traballo

Documentos/Recursos

Referencias

Deixa un comentario

Cancelar resposta