Manual de instruções do aplicativo de software de baixo código HARMAN Muse Automator

Instale o NodeJS e o NPM seguindo as instruções fornecidas em: NodeJS
Guia de instalação.
Instale o MUSE Automator em seu PC seguindo as respectivas instruções do instalador.

Atualize o firmware do controlador MUSE disponível em amx.com.
Habilite o suporte Node-RED no MUSE Controller seguindo as etapas mencionadas no manual.

Primeiros passos com o MUSE Automator

Modos de trabalho do Automator

Modo de simulação
Para usar o Automator no modo de simulação:

Arraste um nó Controlador para o espaço de trabalho.

Selecione 'simulador' na caixa suspensa na caixa de diálogo de edição.
Clique em 'Concluído' e implante para ver o status do simulador como conectado.

Adicionar drivers e dispositivos
Adicione drivers e dispositivos correspondentes de acordo com seus requisitos.

Modo conectado
Para usar o modo conectado:

Insira o endereço do seu controlador MUSE físico nas configurações do nó Controlador.
Forneça nome de usuário e senha para o controlador.

Clique em 'Conectar' para estabelecer uma conexão com o servidor Node-RED no controlador MUSE.

Perguntas frequentes

Q: O que devo fazer se o MUSE Automator não funcionar corretamente?
A: Certifique-se de ter instalado todas as dependências necessárias e seguido as instruções de instalação corretamente. Entre em contato com o suporte ao cliente para obter mais assistência.

Q: Como atualizo o firmware do controlador MUSE?
A: Você pode atualizar o firmware baixando a versão mais recente em amx.com e seguindo as instruções fornecidas para atualização do firmware.

Instalação e configuração

MUSE Automator é um aplicativo de software sem código/low-code projetado para uso com controladores AMX MUSE. Ele é construído no Node-RED, uma ferramenta de programação baseada em fluxo amplamente utilizada.

Pré-requisitos
Antes de instalar o MUSE Automator, você deve instalar várias dependências descritas abaixo. Se essas dependências não forem instaladas primeiro, o Automator não será executado corretamente.

Instale NodeJS (v20.11.1+) e Node Package Manager (NPM) (v10.2.4+) Automator é uma versão personalizada do software Node-RED, portanto, requer que o NodeJS seja executado em seu sistema. Também requer o Node Package Manager (NPM) para poder instalar nós de terceiros. Para instalar o NodeJS e o NPM, acesse o link a seguir e siga as instruções de instalação: https://docs.npmis.com/downloading-and=installing-node-is-and-npm
Instale o Git (v2.43.0+)
Git é um sistema de controle de versão. Para o Automator, ele habilita o recurso Projeto para que você possa organizar seus fluxos em projetos distintos. Ele também ativa a funcionalidade Push/Pull necessária para implantar seus fluxos em um MUSE Controller físico. Para instalar o Git, acesse o link a seguir e siga as instruções: https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

Observação: O instalador do Git o guiará por uma série de opções de instalação. Recomenda-se usar as opções padrão e recomendadas pelo instalador. Consulte a documentação do Git para obter mais informações.

Instale o MUSE Automator
Depois que Git, NodeJS e NPM forem instalados, você poderá instalar o MUSE Automator. Instale o MUSE Automator em seu PC Windows ou MacOS e siga as respectivas instruções do instalador.

Instale o firmware do controlador MUSE
Para usar o MUSE Automator com um controlador AMX MUSE, você precisará atualizar o firmware do controlador MUSE disponível em amx.com.

Habilite o suporte Node-RED no controlador MUSE
O Node-RED está desabilitado no controlador MUSE por padrão. Deve ser habilitado manualmente. Para fazer isso, faça login em seu controlador MUSE e navegue até Sistema > Extensões. Na lista Extensões Disponíveis, role para baixo até mojonodred e clique nele para selecioná-lo. Pressione o botão Instalar para instalar a extensão Node-RED e permitir a atualização do controlador. Veja a captura de tela abaixo para referência:

Outras informações
Se você tiver um firewall habilitado em seu PC, precisará certificar-se de que a porta 49152 esteja aberta para que o Automator se comunique corretamente por meio dessa porta.

Primeiros passos com o MUSE Automator

Conheça o Node-RED
Como o Automator é essencialmente uma versão customizada do Node-RED, primeiro você deve se familiarizar com o aplicativo Node-RED. O software tem uma curva de aprendizado relativamente superficial. Existem centenas de artigos e vídeos instrutivos disponíveis para aprender o Node-RED, mas um bom lugar para começar é na documentação do Node-RED: https://nodered.org/docs. Em particular, leia os Tutoriais, o Livro de Receitas e os Fluxos de Desenvolvimento para se familiarizar com os recursos e a interface do usuário do aplicativo.

Este guia não cobrirá os fundamentos do Node-RED ou da programação baseada em fluxo, portanto é imperativo que você esteja familiarizado com o Node-RED.view a documentação oficial do Node-RED antes de começar.

Interface do Automator encerradaview
A interface do editor Automator é essencialmente a mesma do editor padrão Node-RED, com alguns ajustes nos temas e algumas funcionalidades personalizadas que permitem a interação entre o editor e um controlador MUSE.

Paleta MUSE Automator – nós personalizados para trabalhar com dispositivos HARMAN
Guia Fluxo – Para alternar entre views de múltiplos fluxos
Espaço de trabalho – onde você constrói seus fluxos. Arraste os nós da esquerda e solte na área de trabalho
Bandeja Push/Pull – Para gerenciar projetos localmente ou em um controlador. Empurre, puxe, inicie, pare, exclua um projeto.
Botão/bandeja de implantação – para implantar fluxos do editor para o servidor Node-RED local
Menu Hambúrguer – Menu principal do aplicativo. Crie projetos, abra projetos, gerencie fluxos, etc.

Modos de trabalho do Automator
Existem três maneiras distintas de trabalhar com o Automator. Esses não são “modos” restritivos em si, mas apenas métodos de uso do Automator. Usamos o termo modo aqui para simplificar.

Simulação – Os fluxos são implantados localmente e executados em um simulador MUSE para que você possa testar sem um controlador físico.
Conectado – você está conectado a um controlador MUSE físico e os fluxos são implementados e executados localmente em um PC. Se você desligar o Automator, os fluxos deixarão de funcionar.
Autônomo – você enviou seus fluxos implantados para um controlador MUSE para execução independente no controlador.
Independentemente do modo que você está executando, você deve saber quais dispositivos pretende controlar ou automatizar e, em seguida, carregar seus respectivos drivers no simulador ou em um controlador físico. O método para carregar drivers em qualquer destino é muito diferente. O carregamento de drivers no simulador ocorre na caixa de diálogo de edição do nó do Automator Controller (consulte Adicionando Drivers e Dispositivos). O carregamento de drivers para um controlador MUSE é feito no arquivo do controlador web interface. Para saber mais sobre como carregar drivers em seu controlador MUSE, consulte a documentação em https://www.amx.com/products/mu-3300#downloads.

Modo de simulação
Para usar o Automator no modo de simulação, arraste um nó Controlador para a área de trabalho e abra sua caixa de diálogo de edição. Selecione o simulador na caixa suspensa e clique no botão Concluído. Agora você pode usar nós que podem acessar os pontos finais do dispositivo simulador.

Clique no botão Deploy e você deverá ver o status do simulador indicado como conectado com uma caixa indicadora verde sólida:

Adicionar drivers e dispositivos
Existem vários simuladores já integrados ao Automator Controller Node:

Extensores IO da série CE: CE-IO4, CE-IRS4, CE-REL8, CE-COM2

Portas de E/S do controlador da série MU: MU-1300, MU-2300, MU-3300
LED do painel frontal do controlador da série MU: MU-2300, MU-3300
Um dispositivo NetLinx ICSP genérico

Para adicionar dispositivos ao seu simulador:

Clique no botão Upload próximo à lista de Provedores. Isso abrirá a caixa de diálogo do sistema de arquivos. Selecione o driver correspondente para o dispositivo pretendido. Nota: os seguintes tipos de driver podem ser carregados:
- Módulos DUET (recuperar em developer.amx.com)
- Drivers MUSE nativos
  c. Arquivos do simulador
Após o upload do driver, você pode adicionar o respectivo dispositivo clicando no botão Adicionar próximo à lista Dispositivos.

Modo conectado
O modo conectado requer que você tenha um controlador MUSE físico em sua rede ao qual possa se conectar. Abra o nó do controlador e insira o endereço do controlador MUSE. A porta é 80 e está definida por padrão. Digite o nome de usuário e a senha do seu controlador e pressione o botão Conectar. Você deve observar uma notificação de que o Automator se conectou ao servidor Node-RED no controlador MUSE. Veja a captura de tela abaixo.

Modo autônomo
Este modo de trabalhar com o Automator envolve simplesmente enviar seus fluxos do seu PC local para o servidor Node-RED em execução em um controlador MUSE. Isso requer que os projetos estejam habilitados (o que requer a instalação do git). Leia abaixo para saber mais sobre Projetos e Push/Pull.

Implantando
Sempre que você fizer uma alteração em um nó, precisará implantar essas alterações do editor no servidor Node-RED para fazer os fluxos serem executados. Existem algumas opções sobre o que e como implantar seus fluxos no menu suspenso Implantar. Para saber mais sobre a implantação no Node-RED, consulte a documentação do Node-RED.

Ao implantar no Automator, os fluxos são implantados no servidor Node-RED local em execução no seu PC. Em seguida, os fluxos implantados devem ser “enviados” do seu PC local para o servidor Node-RED em execução no controlador MUSE.

Uma boa maneira de determinar se você tem alguma alteração não implantada em seus fluxos/nós é no botão Deploy no canto superior direito do aplicativo. Se estiver esmaecido e não interativo, você não terá alterações não implantadas em seus fluxos. Se estiver vermelho e interativo, então você tem alterações não implantadas em seus fluxos. Veja as capturas de tela abaixo.

Projetos
Para fazer Push/Pull do seu servidor Node-RED local para o servidor em execução no seu controlador, o recurso Projetos precisa ser habilitado no Automator. O recurso Projetos é ativado automaticamente se o git estiver instalado no seu PC. Para saber como instalar o git, consulte a seção Instalar o Git deste guia.
Supondo que você instalou o git e reiniciou o MUSE Automator, você pode criar um novo projeto clicando no menu hambúrguer no canto superior direito do aplicativo.

Insira um nome de projeto (sem espaços ou caracteres especiais permitidos) e, por enquanto, selecione a opção Desativar criptografia em Credenciais. Pressione o botão Criar Projeto para concluir a criação do projeto.

Agora que você criou um projeto, você pode fazer Push/Pull para um controlador MUSE físico.

Projetos Empurrando/Puxando
Enviar e enviar fluxos do seu PC para o servidor Node-RED em um controlador MUSE é um recurso exclusivo do Automator. Algumas etapas precisam ser executadas antes que você possa Empurrar/Puxar

Certifique-se de estar conectado ao seu controlador MUSE por meio do nó Controlador
Certifique-se de ter implantado todas as alterações em seus fluxos (o botão Implantar deve estar esmaecido)

Para enviar seus fluxos implantados do seu PC, clique na seta para baixo Empurrar/Puxar.

Passe o mouse sobre o projeto local e clique no ícone de upload para enviar o projeto do servidor Node-RED local para o servidor Node-RED em seu controlador MUSE.

Depois de enviar seu projeto local para o controlador, pressione o botão Push/Pull (não a seta) e o projeto deverá parecer estar em execução no controlador.
Da mesma forma, um projeto que foi enviado para um controlador pode ser transferido do controlador para o seu PC. Passe o mouse sobre o projeto remoto e clique no ícone de download para extrair o projeto.

Execute um projeto
Os projetos que estão em execução no controlador ou em seu servidor Node-RED local serão indicados por um rótulo em execução. Para executar um projeto diferente no servidor remoto ou no servidor local, passe o mouse sobre o projeto e clique no ícone de reprodução. Nota: apenas um projeto pode ser executado por vez no Local ou Remoto.

Excluir um projeto
Para excluir um projeto, passe o mouse sobre o nome do projeto em Local ou Remoto e clique no ícone da lixeira. Aviso: tenha cuidado com o que você está excluindo ou poderá perder o trabalho.

Parando um projeto

Pode haver cenários em que você queira parar ou iniciar um projeto do Automator local ou remotamente no controlador. O Automator oferece a capacidade de iniciar ou interromper qualquer projeto conforme necessário. Para interromper um projeto, clique para expandir a bandeja Empurrar/Puxar. Passe o mouse sobre qualquer projeto em execução na lista Remoto ou Local e clique no ícone parar.

Paleta de nós do Automator MUSE

O Automator vem com nossa própria paleta de nós personalizados, também intitulada MUSE Automator. Atualmente são fornecidos sete nós que permitem funcionalidade e interação com o simulador e os controladores MUSE.

Controlador
O nó Controlador é o que fornece ao seu simulador de fluxos ou contexto do controlador MUSE e acesso programático aos dispositivos que foram adicionados ao controlador. Possui os seguintes campos que podem ser configurados:

Nome – propriedade de nome universal para todos os nós.

Controlador – o controlador ou simulador ao qual você deseja se conectar. Selecione simulador para conectar ao controlador MUSE simulado. Para conectar-se a um controlador físico, certifique-se de que ele esteja conectado à sua rede e insira seu endereço IP no campo host. Pressione o botão Conectar para conectar ao controlador.
Provedores – a lista de drivers que foram carregados em seu simulador ou controlador. Pressione o botão Upload para adicionar um driver. Selecione um driver e pressione Delete para excluir um driver da lista.
Dispositivos – a lista de dispositivos que foram adicionados ao simulador ou controlador.
- Editar – Selecione um dispositivo da lista e clique em Editar para editar suas propriedades
- Adicionar – Clique para adicionar um novo dispositivo (com base nos drivers da lista de Provedores).
  - Instância – Ao adicionar um novo dispositivo, é necessário um nome de instância exclusivo.
  - Nome – Opcional. Nome do dispositivo
  - Descrição (opcional. Descrição do dispositivo.
  - Driver – Selecione o driver apropriado (com base nos drivers da lista Provedores).
- Excluir – Selecione um dispositivo da lista e clique em Excluir para excluir o dispositivo.

Status
Use o nó Status para obter o status ou o estado de um parâmetro de dispositivo específico.

Nome – propriedade de nome universal para todos os nós.
Dispositivo – selecione o dispositivo (com base na lista Dispositivos no nó Controlador). Isso irá gerar uma árvore de parâmetros na lista abaixo. Selecione o parâmetro para recuperação de status.
Parâmetro – Campo somente leitura que mostra o caminho do parâmetro selecionado.

Evento
Use o nó Evento para escutar eventos do dispositivo, como mudanças no estado, para acionar uma ação (como um comando)

Nome – propriedade de nome universal para todos os nós.

Dispositivo – selecione o dispositivo (com base na lista Dispositivos no nó Controlador). Isso irá gerar uma árvore de parâmetros na lista abaixo. Selecione um parâmetro da lista.
Evento – Campo somente leitura que mostra o caminho do parâmetro
Tipo de Evento – Tipo somente leitura do evento de parâmetro selecionado.

Tipo de parâmetro – tipo de dados somente leitura do parâmetro selecionado.
Evento (sem rótulo) – Caixa suspensa com a lista de eventos que podem ser ouvidos

Comando
Use o nó Comando para enviar um comando a um dispositivo.

Nome – propriedade de nome universal para todos os nós.
Dispositivo – selecione o dispositivo (com base na lista Dispositivos no nó Controlador). Isso irá gerar uma árvore de parâmetros na lista abaixo. Somente os parâmetros que podem ser definidos serão mostrados.

Selecionado – Campo somente leitura que mostra o caminho do parâmetro.
Entrada – Escolha Configuração manual para ver os comandos disponíveis na caixa suspensa que podem ser executados.

Navegar
Use o nó Navigate para executar uma virada de página em um painel de toque TP5

Nome – propriedade de nome universal para todos os nós.
Painel – Selecione o painel de toque (adicionado através do nó Painel de controle)

Comandos – Escolha o comando Virar
G5 – Uma sequência editável do comando a ser enviado. Selecione a página na lista gerada de páginas do painel para preencher este campo.

Painel de controle
Use o nó Painel de controle para adicionar contexto do painel de toque ao fluxo.

Nome – propriedade de nome universal para todos os nós.
Dispositivo – Selecione o dispositivo do painel de toque

Painel – Clique em Procurar para carregar um arquivo .TP5. Isto irá gerar uma árvore somente leitura das páginas e botões dos arquivos do painel de toque. Consulte esta lista como verificação do arquivo.

Controle de IU
Use o nó UI Control para programar botões ou outros controles do arquivo do painel de toque.

Nome – propriedade de nome universal para todos os nós.
Dispositivo – Selecione o dispositivo do painel de toque
Tipo – Selecione o tipo de controle da UI. Selecione o controle da UI na árvore de páginas/botões abaixo

Acionar – Escolha o gatilho para o controle UI (por exemploample, PUSH ou RELEASE)
Estado – Defina o estado do controle UI quando ele é acionado (por exemploample, LIGADO ou DESLIGADO)

Exampo Fluxo de trabalho

Neste example fluxo de trabalho, iremos:

Conecte-se a um controlador MUSE
Construa um fluxo que nos permita alternar o estado de um relé em um MU-2300

Implante o fluxo em nosso servidor Node-RED local

Conecte-se ao controlador MUSE

Configure seu controlador MUSE. Consulte a documentação em

Arraste um nó Controlador da paleta de nós do MUSE Automator para a tela e clique duas vezes nele para abrir sua caixa de diálogo de edição.
Insira o endereço IP do seu controlador MUSE e pressione o botão Conectar e depois o botão Concluído.
Em seguida, pressione o botão Implantar. Sua caixa de diálogo e nó Controlador devem ser semelhantes a:

Crie e implante um fluxo

A seguir, vamos começar a construir um fluxo arrastando vários nós para a tela. Arraste os seguintes nós e coloque-os na ordem da esquerda para a direita:
- Injetar
- Status
- Switch (na paleta de funções)
- Comando (arraste dois)
- Depurar
Clique duas vezes no nó Inject e altere seu nome para “Manual Trigger” e pressione Done
Clique duas vezes no nó Status e modifique as seguintes propriedades:
- Mude seu nome para “Obter status do relé 1”
- No menu suspenso Dispositivo, selecione idevice
- Expanda o nó folha de retransmissão na árvore e selecione 1 e, em seguida, indique
- Pressione Concluído
Clique duas vezes no nó Switch e modifique as seguintes propriedades:
- Altere o nome para “Verificar status do relé 1”
- Clique no botão +adicionar na parte inferior da caixa de diálogo. Agora você deve ter duas regras na lista. Um aponta para 1 porta e dois pontos para 2 portas
- Digite true no primeiro campo e defina o tipo como expressão
- Digite false no segundo campo e defina o tipo como expressão
- Seu nó de switch adequado deve ser assim:
Clique duas vezes no primeiro nó Comando e modifique as seguintes propriedades:
- Mude o nome para “Definir Relé 1 Falso”
- No menu suspenso Dispositivo, selecione idevice
- Expanda o nó folha do relé na árvore e selecione 1 e, em seguida, indique e pressione Concluído
Clique duas vezes no segundo nó Comando e modifique as seguintes propriedades:
- Mude o nome para “Definir Relé 1 Verdadeiro”
- No menu suspenso Dispositivo, selecione idevice
- Expanda o nó folha do relé na árvore e selecione 1 e, em seguida, indique e pressione Concluído
Conecte todos os nós da seguinte forma:
- Injetar nó no nó Status
- Nó de status para o nó Switch
- Mude a porta 1 do nó para o nó de comando denominado “Set Relay 1 False”
- Mude a porta 2 do nó para o nó de comando denominado “Set Relay 1 True”
- Conecte ambos os nós de comando ao nó de depuração

Depois de concluir a configuração e a fiação do seu nó, sua tela de fluxo deverá ser semelhante a esta:

Agora você está pronto para implantar seu fluxo. No canto superior direito da aplicação, clique no botão Deploy para implantar seu fluxo no servidor Node-RED local. Se você estiver conectado a um controlador MUSE, agora você poderá pressionar continuamente o botão no nó de injeção e ver o estado do relé mudando de verdadeiro para falso no painel de depuração (e ver/ouvir o relé ligando o próprio controlador! ).

Recursos adicionais

Canal AMX no YouTube - https://www.youtube.com/@AMXbyHARMAN
Recursos para desenvolvedores AMX – http://developer.amx.com/#!/main
Canal Node-RED no YouTube – https://www.youtube.com/@Node-RED
Documentação do Node-RED – http://nodered.org/docs/

© 2024 Harman. Todos os direitos reservados. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD e HARMAN e seus respectivos logotipos são marcas registradas da HARMAN. Oracle, Java e qualquer outra empresa ou marca referenciada podem ser marcas comerciais/marcas registradas de suas respectivas empresas.

A AMX não assume responsabilidade por erros ou omissões. A AMX também se reserva o direito de alterar as especificações sem aviso prévio a qualquer momento. A Garantia AMX e Política de Devolução e documentos relacionados podem ser vieweditado/baixado em www.amx.com.

3000 UNIDADE DE PESQUISA, RICHARDSON, TX 75082 AMX. com
800.222.0193
469.624.8000
+1.469.624.7400
fax 469.624.7153
Última revisão: 2024-03-01

Documentos / Recursos

Aplicativo de software de baixo código HARMAN Muse Automator [pdf] Manual de Instruções
Aplicativo de software Muse Automator Low Code, Aplicativo de software Automator Low Code, Aplicativo de software Low Code, Aplicativo de software de código, Aplicativo de software, Aplicativo

Referências

Manual do usuário

Aplicativo de software de baixo código HARMAN Muse Automator

Informações do produto

Instruções de uso do produto

Instalação e configuração

Primeiros passos com o MUSE Automator

Exampo Fluxo de trabalho

Documentos / Recursos

Referências

Deixe um comentário

Cancelar resposta