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

Información del producto

Presupuesto

• Aplicación de software sin código/código bajo
• Diseñado para usar con controladores AMX MUSE
• Construido sobre la herramienta de programación basada en flujo Node-RED
• Requiere NodeJS (v20.11.1+) y Node Package Manager (NPM) (v10.2.4+)
• Compatibilidad: PC con Windows o MacOS

Instrucciones de uso del producto

Instalación y configuración

Antes de instalar MUSE Automator, asegúrese de haber instalado las dependencias necesarias:

1. Instale NodeJS y NPM siguiendo las instrucciones proporcionadas en: NodeJS
   Guía de instalación.
2. Instale MUSE Automator en su PC siguiendo las respectivas instrucciones del instalador.
3. Actualice el firmware del controlador MUSE disponible en amx.com.
4. Habilite la compatibilidad con Node-RED en el controlador MUSE siguiendo los pasos mencionados en el manual.

Primeros pasos con MUSE Automator

Modos de trabajo del automatizador

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

1. Arrastre un nodo Controlador al espacio de trabajo.
2. Seleccione 'simulador' en el cuadro desplegable en el cuadro de diálogo de edición.
3. Haga clic en "Listo" e implemente para ver el estado del simulador como conectado.

Agregar controladores y dispositivos
Agregue los controladores y dispositivos correspondientes según sus requisitos.

Modo conectado
Para usar el modo conectado:

1. Ingrese la dirección de su controlador MUSE físico en la configuración del nodo Controlador.
2. Proporcione el nombre de usuario y la contraseña para el controlador.
3. Haga clic en 'Conectar' para establecer una conexión con el servidor Node-RED en el controlador MUSE.

Preguntas frecuentes

Q: ¿Qué debo hacer si MUSE Automator no se ejecuta correctamente?
A: Asegúrese de haber instalado todas las dependencias necesarias y haber seguido las instrucciones de instalación correctamente. Comuníquese con atención al cliente para obtener más ayuda.

Q: ¿Cómo actualizo el firmware del controlador MUSE?
A: Puede actualizar el firmware descargando la última versión de amx.com y siguiendo las instrucciones proporcionadas para la actualización del firmware.

Instalación y configuración

MUSE Automator es una aplicación de software sin código o con código bajo diseñada para usarse con controladores AMX MUSE. Está construido sobre Node-RED, una herramienta de programación basada en flujo ampliamente utilizada.

Prerrequisitos
Antes de instalar MUSE Automator, debe instalar varias dependencias que se describen a continuación. Si estas dependencias no se instalan primero, Automator no se ejecutará correctamente.

1. Instale NodeJS (v20.11.1+) y Node Package Manager (NPM) (v10.2.4+) Automator es una versión personalizada del software Node-RED, por lo que requiere que NodeJS se ejecute en su sistema. También requiere Node Package Manager (NPM) para poder instalar nodos de terceros. Para instalar NodeJS y NPM, vaya al siguiente enlace y siga las instrucciones de instalación: https://docs.npmis.com/downloading-and=installing-node-is-and-npm
2. Instalar Git (v2.43.0+)
   Git es un sistema de control de versiones. Para Automator, habilita la función Proyecto para que pueda organizar sus flujos en proyectos discretos. También habilita la funcionalidad Push/Pull necesaria para implementar sus flujos en un controlador MUSE físico. Para instalar Git, vaya al siguiente enlace y siga las instrucciones: https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

Nota: El instalador de Git le guiará a través de una serie de opciones de instalación. Se recomienda utilizar las opciones predeterminadas y recomendadas por el instalador. Consulte la documentación de Git para obtener más información.

Instalar MUSE Automator
Una vez que se hayan instalado Git, NodeJS y NPM, puede instalar MUSE Automator. Instale MUSE Automator en su PC con Windows o MacOS y siga las instrucciones del instalador respectivas.

Instalar el firmware del controlador MUSE
Para utilizar MUSE Automator con un controlador AMX MUSE, deberá actualizar el firmware del controlador MUSE disponible en amx.com.

Habilite la compatibilidad con Node-RED en el controlador MUSE
Node-RED está deshabilitado en el controlador MUSE de forma predeterminada. Debe habilitarse manualmente. Para hacer esto, inicie sesión en su controlador MUSE y navegue hasta Sistema > Extensiones. En la lista Extensiones disponibles, desplácese hacia abajo hasta mojonodred y haga clic en él para seleccionarlo. Presione el botón Instalar para instalar la extensión Node-RED y permitir que el controlador se actualice. Vea la captura de pantalla a continuación como referencia:

Otra información
Si tiene un firewall habilitado en su PC, deberá asegurarse de tener el puerto 49152 abierto para que Automator se comunique a través de este puerto correctamente.

Primeros pasos con MUSE Automator

Conozca Node-RED
Dado que Automator es esencialmente una versión personalizada de Node-RED, primero debes familiarizarte con la aplicación Node-RED. El software tiene una curva de aprendizaje relativamente superficial. Hay cientos de artículos y videos instructivos disponibles para aprender Node-RED, pero un buen lugar para comenzar es la documentación de Node-RED: https://nodered.org/docs. En particular, lea los tutoriales, el libro de recetas y los flujos de desarrollo para familiarizarse con las funciones y la interfaz de usuario de la aplicación.

Esta guía no cubrirá los conceptos básicos de Node-RED o la programación basada en flujo, por lo que es imperativo que vuelvaview la documentación oficial de Node-RED antes de comenzar.

Interfaz del automatizador terminadaview
La interfaz del editor Automator es esencialmente la misma que la del editor predeterminado de Node-RED con algunos ajustes en los temas y algunas funciones personalizadas que permiten la interacción entre el editor y un controlador MUSE.

1. Paleta MUSE Automator: nodos personalizados para trabajar con dispositivos HARMAN
2. Pestaña Flujo: para cambiar entre views de múltiples flujos
3. Espacio de trabajo: donde construyes tus flujos. Arrastre los nodos desde la izquierda y suéltelos en el espacio de trabajo
4. Bandeja Push/Pull: para gestionar proyectos localmente o en un controlador. Empujar, tirar, iniciar, detener, eliminar un proyecto.
5. Botón/bandeja de implementación: para implementar flujos desde el editor al servidor Node-RED local
6. Menú Hamburguesa – Menú principal de la aplicación. Crear proyectos, abrir proyectos, gestionar flujos, etc.

Modos de trabajo del automatizador
Hay tres formas distintas de trabajar con Automator. Estos no son "modos" restrictivos per se, sino simplemente métodos de uso de Automator. Usamos el término modo aquí por simplicidad.

1. Simulación: los flujos se implementan localmente y se ejecutan en un simulador MUSE para que pueda realizar pruebas sin un controlador físico.
2. Conectado: está conectado a un controlador MUSE físico y los flujos se implementan y luego se ejecutan localmente en una PC. Si apaga Automator, los flujos dejarán de funcionar.
3. Independiente: ha enviado sus flujos implementados a un controlador MUSE para que se ejecuten de forma independiente en el controlador.
   Independientemente del modo que esté ejecutando, debe saber qué dispositivos desea controlar o automatizar y luego cargar sus respectivos controladores en el simulador o en un controlador físico. El método para cargar controladores en cualquier destino es muy diferente. La carga de controladores al simulador se produce en el cuadro de diálogo de edición del nodo del controlador Automator (consulte Agregar controladores y dispositivos). La carga de controladores en un controlador MUSE se realiza en la ventana del controlador. web interfaz. Para obtener más información sobre cómo cargar controladores en su controlador MUSE, consulte la documentación en https://www.amx.com/products/mu-3300#downloads.

Modo de simulación
Para usar Automator en modo de simulación, arrastre un nodo Controlador al espacio de trabajo y abra su cuadro de diálogo de edición. Seleccione el simulador en el cuadro desplegable y haga clic en el botón Listo. Ahora puede utilizar nodos que puedan acceder a los puntos finales del dispositivo simulador.

Haga clic en el botón Implementar y debería ver el estado del simulador indicado como conectado con un cuadro indicador verde sólido:

Agregar controladores y dispositivos
Ya existen varios simuladores integrados en el nodo del controlador Automator:

• Extensores de E/S de la serie CE: CE-IO4, CE-IRS4, CE-REL8, CE-COM2
• Puertos de E/S del controlador serie MU: MU-1300, MU-2300, MU-3300
• LED del panel frontal del controlador serie MU: MU-2300, MU-3300
• Un dispositivo NetLinx ICSP genérico

Para agregar dispositivos a su simulador:

1. Haga clic en el botón Cargar junto a la lista de proveedores. Esto abrirá el cuadro de diálogo de su sistema de archivos. Seleccione el controlador correspondiente para el dispositivo deseado. Nota: se pueden cargar los siguientes tipos de controladores:
   • Módulos DUET (recuperados de desarrollador.amx.com)
   • Controladores MUSE nativos
     C. Archivos del simulador
2. Una vez que se haya cargado el controlador, puede agregar el dispositivo respectivo haciendo clic en el botón Agregar al lado de la lista de Dispositivos.

Modo conectado
El modo conectado requiere que tengas un controlador MUSE físico en tu red al que puedas conectarte. Abra su nodo Controlador e ingrese la dirección de su controlador MUSE. El puerto es 80 y está configurado de forma predeterminada. Ingrese el nombre de usuario y la contraseña de su controlador y luego presione el botón Conectar. Debería observar una notificación de que Automator se ha conectado al servidor Node-RED en el controlador MUSE. Vea la captura de pantalla a continuación.

Modo independiente
Este modo de trabajar con Automator simplemente implica enviar sus flujos desde su PC local al servidor Node-RED que se ejecuta en un controlador MUSE. Esto requiere que Proyectos esté habilitado (lo que requiere la instalación de git). Lea a continuación para obtener más información sobre Proyectos y Push/Pull.

Desplegando
Cada vez que realice un cambio en un nodo, deberá implementar esos cambios desde el editor en el servidor Node-RED para que los flujos se ejecuten. Hay algunas opciones sobre qué y cómo implementar sus flujos en el menú desplegable Implementar. Para obtener más información sobre la implementación en Node-RED, consulte la documentación de Node-RED.

Al implementar en Automator, los flujos se implementan en el servidor Node-RED local que se ejecuta en su PC. Luego, los flujos implementados deben "enviarse" desde su PC local al servidor Node-RED que se ejecuta en el controlador MUSE.

Una buena manera de determinar si tiene algún cambio no implementado en sus flujos/nodos es en el botón Implementar en la esquina superior derecha de la aplicación. Si está atenuado y no es interactivo, entonces no tiene cambios no implementados en sus flujos. Si es rojo e interactivo, entonces tiene cambios no implementados en sus flujos. Vea las capturas de pantalla a continuación.

Proyectos
Para enviar/extraer desde su servidor Node-RED local al servidor que se ejecuta en su controlador, la función Proyectos debe estar habilitada en Automator. La función Proyectos se habilita automáticamente si git está instalado en su PC. Para aprender cómo instalar git, consulte la sección Instalar Git de esta guía.
Suponiendo que haya instalado git y haya reiniciado MUSE Automator, puede crear un nuevo proyecto haciendo clic en el menú de hamburguesas en la esquina superior derecha de la aplicación.

Ingrese un nombre de proyecto (no se permiten espacios ni caracteres especiales) y, por ahora, seleccione la opción Desactivar cifrado en Credenciales. Presione el botón Crear proyecto para completar la creación del proyecto.

Ahora que ha creado un proyecto, puede empujar/tirar hacia un controlador MUSE físico.

Proyectos de empujar/tirar
Enviar y extraer sus flujos desde su PC al servidor Node-RED en un controlador MUSE es una característica única en Automator. Es necesario realizar un par de pasos antes de poder empujar/tirar.

1. Asegúrese de estar conectado a su controlador MUSE a través del nodo Controlador
2. Asegúrese de haber implementado todos los cambios en sus flujos (el botón Implementar debe estar atenuado)

Para enviar los flujos implementados desde su PC, haga clic en la flecha hacia abajo Empujar/tirar.

Pase el cursor sobre el proyecto local y haga clic en el icono de carga para enviar el proyecto desde su servidor Node-RED local al servidor Node-RED en su controlador MUSE.

Después de enviar su proyecto local al controlador, presione el botón Empujar/tirar (no la flecha) y el proyecto debería parecer estar ejecutándose en el controlador.
De la misma manera, un proyecto que se ha enviado a un controlador se puede extraer del controlador a su PC. Pase el cursor sobre el proyecto remoto y haga clic en el icono de descarga para extraer el proyecto.

Ejecutar un proyecto
Los proyectos que se están ejecutando en el controlador o en su servidor Node-RED local se indicarán con una etiqueta de ejecución. Para ejecutar un proyecto diferente en el servidor remoto o en el servidor local, coloque el cursor sobre el proyecto y haga clic en el icono de reproducción. Nota: solo se puede ejecutar un proyecto a la vez en Local o Remoto.

Eliminar un proyecto
Para eliminar un proyecto, coloque el cursor sobre el nombre del proyecto en Local o Remoto y haga clic en el icono de la papelera. Advertencia: tenga cuidado con lo que está eliminando o puede perder el trabajo.

Detener un proyecto

Puede haber escenarios en los que desee detener o iniciar un proyecto de Automator de forma local o remota en el controlador. Automator ofrece la posibilidad de iniciar o detener cualquier proyecto según sea necesario. Para detener un proyecto, haga clic para expandir la bandeja Push/Pull. Pase el cursor sobre cualquier proyecto en ejecución en la lista Remota o Local y luego haga clic en el icono de detener.

Paleta de nodos MUSE Automator 

Automator se entrega con nuestra propia paleta de nodos personalizada, también titulada MUSE Automator. Actualmente se proporcionan siete nodos que permiten la funcionalidad y la interacción con el simulador y los controladores MUSE.

Controlador
El nodo Controlador es lo que proporciona a su simulador de flujos o contexto del controlador MUSE y acceso programático a los dispositivos que se han agregado al controlador. Tiene los siguientes campos que se pueden configurar:

• Nombre: propiedad de nombre universal para todos los nodos.
• Controlador: el controlador o simulador al que desea conectarse. Seleccione el simulador para conectarse al controlador MUSE simulado. Para conectarse a un controlador físico, asegúrese de que esté conectado a su red e ingrese su dirección IP en el campo host. Presione el botón Conectar para conectarse al controlador.
• Proveedores: la lista de controladores que se han cargado en su simulador o controlador. Presione el botón Cargar para agregar un controlador. Seleccione un controlador y presione Eliminar para eliminar un controlador de la lista.
• Dispositivos: la lista de dispositivos que se han agregado al simulador o controlador.
  • Editar: seleccione un dispositivo de la lista y haga clic en Editar para editar sus propiedades.
  • Agregar: haga clic para agregar un nuevo dispositivo (según los controladores en la lista de proveedores).
    • Instancia: al agregar un nuevo dispositivo, se requiere un nombre de instancia único.
    • Nombre: (Opcional. Nombre del dispositivo
    • Descripción (opcional. Descripción del dispositivo.
    • Conductor: seleccione el controlador apropiado (según los controladores en la lista de Proveedores).
  • Eliminar: seleccione un dispositivo de la lista y haga clic en Eliminar para eliminar el dispositivo.

Estado
Utilice el nodo Estado para obtener el estado o estado de un parámetro de dispositivo específico.

• Nombre: propiedad de nombre universal para todos los nodos.
• Dispositivo: seleccione el dispositivo (según la lista de Dispositivos en el nodo Controlador). Esto generará un árbol de parámetros en la lista siguiente. Seleccione el parámetro para la recuperación del estado.
• Parámetro: campo de solo lectura que muestra la ruta del parámetro seleccionado.

Evento
Utilice el nodo Evento para escuchar eventos del dispositivo, como cambios de estado, para desencadenar una acción (como un comando)

• Nombre: propiedad de nombre universal para todos los nodos.
• Dispositivo: seleccione el dispositivo (según la lista de Dispositivos en el nodo Controlador). Esto generará un árbol de parámetros en la lista siguiente. Seleccione un parámetro de la lista.
• Evento: campo de solo lectura que muestra la ruta del parámetro
• Tipo de evento: tipo de solo lectura del evento del parámetro seleccionado.
• Tipo de parámetro: tipo de datos de solo lectura del parámetro seleccionado.
• Evento (sin etiquetar): cuadro desplegable con la lista de eventos que se pueden escuchar

Dominio
Utilice el nodo Comando para enviar un comando a un dispositivo.

• Nombre: propiedad de nombre universal para todos los nodos.
• Dispositivo: seleccione el dispositivo (según la lista de Dispositivos en el nodo Controlador). Esto generará un árbol de parámetros en la lista siguiente. Sólo se mostrarán los parámetros que se pueden configurar.
• Seleccionado: campo de solo lectura que muestra la ruta del parámetro.
• Entrada: elija Configuración manual para ver los comandos disponibles en el cuadro desplegable que se pueden ejecutar.

Navegar por
Utilice el nodo Navegar para pasar una página a un panel táctil TP5

• Nombre – propiedad de nombre universal para todos los nodos.
• Panel – Seleccione el panel táctil (agregado a través del nodo Panel de control)
• Comandos – Elija el comando Voltear
• G5 – Una cadena editable del comando a enviar. Seleccione la página de la lista generada de páginas del panel para completar este campo.

Panel de control
Utilice el nodo Panel de control para agregar contexto del panel táctil al flujo.

• Nombre: propiedad de nombre universal para todos los nodos.
• Dispositivo: seleccione el dispositivo del panel táctil
• Panel: haga clic en Examinar para cargar un archivo .TP5. Esto generará un árbol de sólo lectura de las páginas de archivos y botones del panel táctil. Haga referencia a esta lista como verificación del archivo.

Control de interfaz de usuario
Utilice el nodo Control de UI para programar botones u otros controles desde el archivo del panel táctil.

• Nombre – propiedad de nombre universal para todos los nodos.
• Dispositivo – Seleccione el dispositivo del panel táctil
• Tipo – Seleccione el tipo de control de la interfaz de usuario. Seleccione el control UI del árbol de páginas/botones a continuación
• Desencadenar – Elija el activador para el control de la interfaz de usuario (por ej.ample, EMPUJAR o SOLTAR)
• Estado – Establecer el estado del control de la interfaz de usuario cuando se activa (por ej.amparchivo, ENCENDIDO o APAGADO)

Exampel flujo de trabajo

En este exampel flujo de trabajo, haremos:

• Conéctese a un controlador MUSE
• Construir un flujo que nos permita alternar el estado de un relé en un MU-2300
• Implementar el flujo en nuestro servidor Node-RED local

Conéctese al controlador MUSE 

1. Configure su controlador MUSE. Consulte la documentación en
2. Arrastre un nodo Controlador desde la paleta de nodos MUSE Automator al lienzo y haga doble clic en él para abrir su cuadro de diálogo de edición.
3. Ingrese la dirección IP de su controlador MUSE y presione el botón Conectar y luego el botón Listo.
   Luego presione el botón Implementar. Su cuadro de diálogo y nodo Controlador deberían verse así:

Construya e implemente un flujo 

1. A continuación, comencemos a crear un flujo arrastrando varios nodos al lienzo. Arrastre los siguientes nodos y colóquelos en orden de izquierda a derecha:
   • Inyectar
   • Estado
   • Cambiar (bajo la paleta de funciones)
   • Comando (arrastra dos)
   • Depurar
2. Haga doble clic en el nodo Inyectar, cambie su nombre a "Disparador manual" y presione Listo.
3. Haga doble clic en el nodo Estado y modifique las siguientes propiedades:
   • Cambie su nombre a "Obtener estado del relé 1"
   • En el menú desplegable Dispositivo, seleccione idevice
   • Expanda el nodo de hoja de retransmisión en el árbol y seleccione 1 y luego indique
   • Presione Listo
4. Haga doble clic en el nodo Cambiar y modifique las siguientes propiedades:
   • Cambie el nombre a "Verificar estado del relé 1"
   • Haga clic en el botón +agregar en la parte inferior del cuadro de diálogo. Ahora debería tener dos reglas en la lista. Uno apunta a 1 puerto y dos apunta a 2 puertos
   • Escriba verdadero en el primer campo y establezca el tipo en expresión
   • Escriba falso en el segundo campo y establezca el tipo en expresión
   • Su nodo de conmutación debería verse así:
5. Haga doble clic en el primer nodo Comando y modifique las siguientes propiedades:
   • Cambie el nombre a "Establecer relé 1 falso"
   • En el menú desplegable Dispositivo, seleccione idevice
   • Expanda el nodo de hoja de retransmisión en el árbol y seleccione 1 y luego indique y luego presione Listo
6. Haga doble clic en el segundo nodo Comando y modifique las siguientes propiedades:
   • Cambie el nombre a "Establecer relé 1 verdadero"
   • En el menú desplegable Dispositivo, seleccione idevice
   • Expanda el nodo de hoja de retransmisión en el árbol y seleccione 1 y luego indique y luego presione Listo
7. Conecte todos los nodos juntos de esta manera:
   • Inyectar nodo al nodo Estado
   • Nodo de estado al nodo Switch
   • Cambie el puerto del nodo 1 al nodo de comando llamado "Establecer relé 1 falso"
   • Cambie el puerto del nodo 2 al nodo de comando denominado "Establecer relé 1 verdadero"
   • Conecte ambos nodos de comando al nodo de depuración

Una vez que haya completado la configuración y el cableado de su nodo, su lienzo de flujo debería verse así:

Ahora está listo para implementar su flujo. En la esquina superior derecha de la aplicación, haga clic en el botón Implementar para implementar su flujo en el servidor Node-RED local. Si está conectado a un controlador MUSE, ahora debería poder presionar continuamente el botón en el nodo de inyección y ver el estado del relé cambiando de verdadero a falso en el panel de depuración (y ver/escuchar el relé encendiéndose en el controlador). ).

Recursos adicionales

• Canal de YouTube de AMX – https://www.youtube.com/@AMXbyHARMAN
• Recursos para desarrolladores de AMX – htps://developer.amx.com/#!/main
• Canal de YouTube Node-RED – htps://www.youtube.com/@Node-RED
• Documentación de Nodo-RED – htps://nodered.org/docs/

© 2024 Harman. Reservados todos los derechos. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD y HARMAN, y sus respectivos logotipos, son marcas registradas de HARMAN. Oracle, Java y cualquier otra empresa o marca a la que se haga referencia pueden ser marcas comerciales/marcas comerciales registradas de sus respectivas empresas.

AMX no asume responsabilidad por errores u omisiones. AMX también se reserva el derecho de modificar las especificaciones sin previo aviso en cualquier momento. La Política de Garantía y Devoluciones de AMX y los documentos relacionados se pueden vieweditado/descargado en www.amx.com.

3000 CONDUCCIÓN DE INVESTIGACIÓN, 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 bajo HARMAN Muse Automator [pdf] Manual de instrucciones Aplicación de software Muse Automator Low Code, Aplicación de software Automator Low Code, Aplicación de software Low Code, Aplicación de software de código, Aplicación de software, Aplicación

Referencias

• Manual de usuario