Applicazione software HARMAN Muse Automator a basso codice

Informazioni sul prodotto

Specifiche

• Applicazione software senza codice/codice basso
• Progettato per l'uso con i controller AMX MUSE
• Costruito sullo strumento di programmazione basato sul flusso Node-RED
• Richiede NodeJS (v20.11.1+) e Node Package Manager (NPM) (v10.2.4+)
• Compatibilità: PC Windows o MacOS

Istruzioni per l'uso del prodotto

Installazione e configurazione

Prima di installare MUSE Automator, assicurati di aver installato le dipendenze necessarie:

1. Installa NodeJS e NPM seguendo le istruzioni fornite in: NodoJS
   Guida all'installazione.
2. Installa MUSE Automator sul tuo PC seguendo le rispettive istruzioni di installazione.
3. Aggiorna il firmware del controller MUSE disponibile su www.amx.com.
4. Abilita il supporto Node-RED nel controller MUSE seguendo i passaggi indicati nel manuale.

Introduzione a MUSE Automator

Modalità di lavoro dell'automazione

Modalità di simulazione
Per utilizzare Automator in modalità simulazione:

1. Trascina un nodo Controller nell'area di lavoro.
2. Seleziona "simulatore" dalla casella a discesa nella finestra di dialogo di modifica.
3. Fai clic su "Fine" e distribuisci per vedere lo stato del simulatore come connesso.

Aggiungi driver e dispositivi
Aggiungi i driver e i dispositivi corrispondenti secondo le tue esigenze.

Modalità connessa
Per utilizzare la modalità connessa:

1. Inserisci l'indirizzo del controller MUSE fisico nelle impostazioni del nodo Controller.
2. Fornire nome utente e password per il controller.
3. Fare clic su "Connetti" per stabilire una connessione con il server Node-RED sul controller MUSE.

Domande frequenti

Q: Cosa devo fare se MUSE Automator non funziona correttamente?
A: Assicurati di aver installato tutte le dipendenze necessarie e di aver seguito correttamente le istruzioni di installazione. Rivolgiti all'assistenza clienti per ulteriore assistenza.

Q: Come si aggiorna il firmware del MUSE Controller?
A: È possibile aggiornare il firmware scaricando la versione più recente da amx.com e seguendo le istruzioni fornite per l'aggiornamento del firmware.

Installazione e configurazione

MUSE Automator è un'applicazione software no-code/low-code progettata per l'uso con i controller AMX MUSE. È basato su Node-RED, uno strumento di programmazione basato sul flusso ampiamente utilizzato.

Prerequisiti
Prima di installare MUSE Automator, è necessario installare diverse dipendenze descritte di seguito. Se queste dipendenze non vengono installate prima, Automator non funzionerà correttamente.

1. Installa NodeJS (v20.11.1+) e Node Package Manager (NPM) (v10.2.4+) Automator è una versione personalizzata del software Node-RED, quindi richiede che NodeJS venga eseguito sul tuo sistema. Richiede inoltre Node Package Manager (NPM) per poter installare nodi di terze parti. Per installare NodeJS e NPM, vai al seguente link e segui le istruzioni di installazione: https://docs.npmis.com/downloading-and=installing-node-is-and-npm
2. Installa Git (v2.43.0+)
   Git è un sistema di controllo della versione. Per Automator, abilita la funzione Progetto in modo da poter organizzare i flussi in progetti discreti. Abilita inoltre la funzionalità Push/Pull necessaria per distribuire i flussi su un controller MUSE fisico. Per installare Git, vai al seguente link e segui le istruzioni: https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

Nota: Il programma di installazione Git ti guiderà attraverso una serie di opzioni di installazione. Si consiglia di utilizzare le opzioni predefinite e consigliate dall'installatore. Per ulteriori informazioni fare riferimento alla documentazione di Git.

Installa MUSE Automator
Una volta installati Git, NodeJS e NPM, è possibile installare MUSE Automator. Installa MUSE Automator sul tuo PC Windows o MacOS e segui le rispettive istruzioni di installazione.

Installa il firmware del controller MUSE
Per utilizzare MUSE Automator con un controller AMX MUSE, sarà necessario aggiornare il firmware del controller MUSE disponibile su www.amx.com.

Abilita il supporto Node-RED nel controller MUSE
Node-RED è disabilitato sul controller MUSE per impostazione predefinita. Deve essere abilitato manualmente. Per fare ciò, accedi al controller MUSE e vai a Sistema > Estensioni. Nell'elenco delle estensioni disponibili, scorri verso il basso fino a mojonodred e fai clic su di esso per selezionarlo. Premi il pulsante Installa per installare l'estensione Node-RED e consentire l'aggiornamento del controller. Vedi lo screenshot qui sotto per riferimento:

Altre informazioni
Se hai un firewall abilitato sul tuo PC, dovrai assicurarti di avere la porta 49152 aperta affinché Automator possa comunicare correttamente attraverso questa porta.

Introduzione a MUSE Automator

Conosci Node-RED
Poiché Automator è essenzialmente una versione personalizzata di Node-RED, dovresti prima acquisire familiarità con l'applicazione Node-RED. Il software ha una curva di apprendimento relativamente superficiale. Sono disponibili centinaia di articoli e video didattici per apprendere Node-RED, ma un buon punto di partenza è la documentazione di Node-RED: https://nodered.org/docs. In particolare, leggi i tutorial, il ricettario e i flussi di sviluppo per familiarizzare con le funzionalità e l'interfaccia utente dell'applicazione.

Questa guida non tratterà le nozioni di base di Node-RED o della programmazione basata sul flusso, quindi è fondamentale che tu sappiaview la documentazione ufficiale di Node-RED prima di iniziare.

Interfaccia dell'automazione terminataview
L'interfaccia dell'editor di Automator è essenzialmente la stessa dell'editor predefinito di Node-RED con alcune modifiche ai temi e alcune funzionalità personalizzate che consentono l'interazione tra l'editor e un controller MUSE.

1. MUSE Automator Palette: nodi personalizzati per lavorare con i dispositivi HARMAN
2. Scheda Flusso: per passare dall'uno all'altro views di flussi multipli
3. Spazio di lavoro: dove costruisci i tuoi flussi. Trascina i nodi da sinistra e rilasciali nell'area di lavoro
4. Vassoio push/pull: per la gestione dei progetti localmente o su un controller. Spingi, tira, avvia, interrompi, elimina un progetto.
5. Pulsante/area di distribuzione Distribuisci: per distribuire i flussi dall'editor al server Node-RED locale
6. Menu Hamburger: menu principale dell'applicazione. Creare progetti, aprire progetti, gestire flussi, ecc.

Modalità di lavoro dell'automazione
Esistono tre modi distinti di lavorare con Automator. Queste non sono “modalità” costrittive di per sé, ma solo metodi di utilizzo di Automator. Usiamo qui il termine modalità per semplicità.

1. Simulazione: i flussi vengono distribuiti localmente ed eseguiti su un simulatore MUSE in modo da poter eseguire test senza un controller fisico.
2. Connesso: sei connesso a un controller MUSE fisico e i flussi vengono distribuiti e quindi eseguiti localmente su un PC. Se spegni Automator, i flussi cesseranno di funzionare.
3. Autonomo: hai inviato i flussi distribuiti a un controller MUSE per eseguirli in modo indipendente sul controller.
   Indipendentemente dalla modalità in esecuzione, dovresti sapere quali dispositivi intendi controllare o automatizzare, quindi caricare i rispettivi driver sul simulatore o su un controller fisico. Il metodo per caricare i driver su entrambe le destinazioni è molto diverso. Il caricamento dei driver nel simulatore avviene nella finestra di dialogo di modifica del nodo Controller di Automator (vedi Aggiunta di driver e dispositivi). Il caricamento dei driver su un controller MUSE viene eseguito nel controller web interfaccia. Per ulteriori informazioni sul caricamento dei driver sul controller MUSE, fare riferimento alla documentazione all'indirizzo https://www.amx.com/products/mu-3300#downloads.

Modalità di simulazione
Per utilizzare Automator in modalità simulazione, trascina un nodo Controller nell'area di lavoro e apri la relativa finestra di dialogo di modifica. Seleziona il simulatore dalla casella a discesa e fai clic sul pulsante Fine. Ora puoi utilizzare i nodi che possono accedere agli endpoint del dispositivo simulatore.

Fai clic sul pulsante Distribuisci e dovresti vedere lo stato del simulatore indicato come connesso con una casella indicatrice verde fissa:

Aggiungi driver e dispositivi
Esistono diversi simulatori già integrati nell'Automator Controller Node:

• Estensori IO serie CE: CE-IO4, CE-IRS4, CE-REL8, CE-COM2
• Porte I/O del controller serie MU: MU-1300, MU-2300, MU-3300
• LED del pannello anteriore del controller serie MU: MU-2300, MU-3300
• Un dispositivo ICSP NetLinx generico

Per aggiungere dispositivi al tuo simulatore:

1. Fare clic sul pulsante Carica accanto all'elenco dei provider. Questo aprirà la finestra di dialogo del file system. Selezionare il driver corrispondente per il dispositivo desiderato. Nota: è possibile caricare i seguenti tipi di driver:
   • Moduli DUET (Recuperare da Developer.amx.com)
   • Driver MUSE nativi
     C. File del simulatore
2. Una volta caricato il driver, puoi aggiungere il rispettivo dispositivo facendo clic sul pulsante Aggiungi accanto all'elenco Dispositivi.

Modalità connessa
La modalità connessa richiede la presenza di un controller MUSE fisico sulla rete a cui è possibile connettersi. Apri il nodo Controller e inserisci l'indirizzo del controller MUSE. La porta è 80 ed è impostata per impostazione predefinita. Inserisci il nome utente e la password del controller, quindi premi il pulsante Connetti. Dovresti osservare una notifica che Automator si è connesso al server Node-RED sul controller MUSE. Vedi lo screenshot qui sotto.

Modalità autonoma
Questa modalità di lavoro con Automator implica semplicemente il trasferimento dei flussi dal PC locale al server Node-RED in esecuzione su un controller MUSE. Ciò richiede che i progetti siano abilitati (che richiede l'installazione di git). Leggi di seguito per saperne di più su Progetti e Push/Pull.

Distribuzione
Ogni volta che apporti una modifica a un nodo dovrai distribuire tali modifiche dall'editor al server Node-RED per far funzionare i flussi. Sono disponibili alcune opzioni su cosa e come distribuire i flussi nel menu a discesa Distribuisci. Per saperne di più sulla distribuzione in Node-RED, consulta la documentazione di Node-RED.

Durante la distribuzione in Automator, i flussi vengono distribuiti al server Node-RED locale in esecuzione sul tuo PC. Quindi, i flussi distribuiti devono essere “spinti” dal PC locale al server Node-RED in esecuzione sul controller MUSE.

Un buon modo per determinare se sono presenti modifiche non distribuite ai flussi/nodi è utilizzare il pulsante Distribuisci nell'angolo in alto a destra dell'applicazione. Se è disattivato e non interattivo, non sono presenti modifiche non distribuite nei flussi. Se è rosso e interattivo, significa che nei tuoi flussi non sono state implementate modifiche. Vedi gli screenshot qui sotto.

Progetti
Per eseguire il push/pull dal server Node-RED locale al server in esecuzione sul controller, la funzione Progetti deve essere abilitata in Automator. La funzione Progetti viene abilitata automaticamente se git è installato sul tuo PC. Per sapere come installare Git, consulta la sezione Installa Git di questa guida.
Supponendo che tu abbia installato git e riavviato MUSE Automator, puoi creare un nuovo progetto facendo clic sul menu hamburger nell'angolo in alto a destra dell'applicazione.

Inserisci un nome di progetto (non sono ammessi spazi o caratteri speciali) e, per ora, seleziona l'opzione Disabilita crittografia in Credenziali. Premi il pulsante Crea progetto per completare la creazione del progetto.

Ora che hai creato un progetto, puoi eseguire il Push/Pull su un controller MUSE fisico.

Spingere/tirare progetti
Il push e il pull dei flussi dal tuo PC al server Node-RED su un controller MUSE è una funzionalità unica di Automator. È necessario eseguire un paio di passaggi prima di poter spingere/tirare

1. Assicurati di essere connesso al controller MUSE tramite il nodo Controller
2. Assicurati di aver distribuito eventuali modifiche ai tuoi flussi (il pulsante Distribuisci dovrebbe essere disattivato)

Per inviare i flussi distribuiti dal PC, fare clic sulla freccia rivolta verso il basso Push/Pull.

Passa il mouse sopra il progetto locale e fai clic sull'icona di caricamento per inviare il progetto dal server Node-RED locale al server Node-RED sul controller MUSE.

Dopo aver inviato il progetto locale al controller, premi il pulsante Push/Pull (non la freccia) e il progetto dovrebbe sembrare in esecuzione sul controller.
Allo stesso modo, un progetto che è stato inviato a un controller può essere trasferito dal controller al PC. Passa il mouse sopra il progetto remoto e fai clic sull'icona di download per estrarre il progetto.

Esegui un progetto
I progetti in esecuzione sul controller o in esecuzione sul server Node-RED locale saranno indicati da un'etichetta di esecuzione. Per eseguire un progetto diverso sul server remoto o sul server locale, passa il mouse sopra il progetto e fai clic sull'icona di riproduzione. Nota: è possibile eseguire solo un progetto alla volta in locale o remoto.

Elimina un progetto
Per eliminare un progetto, passa il mouse sopra il nome del progetto in Locale o Remoto e fai clic sull'icona del cestino. Attenzione: fai attenzione a ciò che stai eliminando, altrimenti potresti perdere il lavoro.

Interrompere un progetto

Potrebbero esserci scenari in cui desideri interrompere o avviare un progetto Automator localmente o in remoto sul controller. Automator offre la possibilità di avviare o interrompere qualsiasi progetto secondo necessità. Per interrompere un progetto, fare clic per espandere il vassoio Push/Pull. Passa il mouse sopra qualsiasi progetto in esecuzione nell'elenco Remoto o Locale, quindi fai clic sull'icona di arresto.

Tavolozza dei nodi di MUSE Automator 

Automator viene fornito con la nostra tavolozza di nodi personalizzata anch'essa denominata MUSE Automator. Attualmente sono forniti sette nodi che consentono la funzionalità e l'interazione con il simulatore e i controller MUSE.

Controllore
Il nodo Controller è ciò che fornisce il contesto del simulatore di flussi o del controller MUSE e l'accesso programmatico ai dispositivi che sono stati aggiunti al controller. Ha i seguenti campi che possono essere configurati:

• Nome: proprietà del nome universale per tutti i nodi.
• Controller: il controller o il simulatore a cui desideri connetterti. Seleziona il simulatore per connetterti al controller MUSE simulato. Per connetterti a un controller fisico, assicurati che sia connesso alla tua rete e inserisci il suo indirizzo IP nel campo host. Premere il pulsante Connetti per connettersi al controller.
• Provider: l'elenco dei driver che sono stati caricati sul simulatore o sul controller. Premi il pulsante Carica per aggiungere un driver. Selezionare un conducente e premere Elimina per eliminare un conducente dall'elenco.
• Dispositivi: l'elenco dei dispositivi che sono stati aggiunti al simulatore o al controller.
  • Modifica: seleziona un dispositivo dall'elenco e fai clic su Modifica per modificarne le proprietà
  • Aggiungi: fare clic per aggiungere un nuovo dispositivo (in base ai driver nell'elenco dei provider).
    • Istanza: quando si aggiunge un nuovo dispositivo è richiesto un nome di istanza univoco.
    • Nome: facoltativo. Nome per il dispositivo
    • Descrizione (facoltativa. Descrizione del dispositivo.
    • Driver: selezionare il driver appropriato (in base ai driver nell'elenco Provider).
  • Elimina: selezionare un dispositivo dall'elenco e fare clic su Elimina per eliminare il dispositivo.

Stato
Utilizzare il nodo Stato per ottenere lo stato o lo stato di un parametro specifico del dispositivo.

• Nome: proprietà del nome universale per tutti i nodi.
• Dispositivo: seleziona il dispositivo (in base all'elenco Dispositivi nel nodo Controller). Questo genererà un albero dei parametri nell'elenco seguente. Selezionare il parametro per il recupero dello stato.
• Parametro: campo di sola lettura che mostra il percorso del parametro selezionato.

Evento
Utilizza il nodo Evento per ascoltare gli eventi del dispositivo come i cambiamenti di stato per attivare un'azione (come un comando)

• Nome: proprietà del nome universale per tutti i nodi.
• Dispositivo: seleziona il dispositivo (in base all'elenco Dispositivi nel nodo Controller). Questo genererà un albero dei parametri nell'elenco seguente. Seleziona un parametro dall'elenco.
• Evento: campo di sola lettura che mostra il percorso del parametro
• Tipo evento: tipo di sola lettura dell'evento del parametro selezionato.
• Tipo di parametro: tipo di dati di sola lettura del parametro selezionato.
• Evento (senza etichetta): casella a discesa con l'elenco degli eventi che è possibile ascoltare

Comando
Utilizzare il nodo Comando per inviare un comando a un dispositivo.

• Nome: proprietà del nome universale per tutti i nodi.
• Dispositivo: seleziona il dispositivo (in base all'elenco Dispositivi nel nodo Controller). Questo genererà un albero dei parametri nell'elenco seguente. Verranno visualizzati solo i parametri che possono essere impostati.
• Selezionato: campo di sola lettura che mostra il percorso del parametro.
• Input: scegliere Configurazione manuale per visualizzare nella casella a discesa i comandi disponibili che possono essere eseguiti.

Navigare
Utilizzare il nodo Naviga per eseguire un capovolgimento di pagina su un pannello a sfioramento TP5

• Nome – proprietà del nome universale per tutti i nodi.
• Pannello – Selezionare il pannello a sfioramento (aggiunto tramite il nodo Pannello di controllo)
• Comandi – Scegli il comando Capovolgi
• G5 – Una stringa modificabile del comando da inviare. Selezionare la pagina dall'elenco generato di pagine del pannello per popolare questo campo.

Pannello di controllo
Utilizza il nodo Pannello di controllo per aggiungere il contesto del pannello a sfioramento al flusso.

• Nome: proprietà del nome universale per tutti i nodi.
• Dispositivo: selezionare il dispositivo del pannello a sfioramento
• Pannello – Fare clic su Sfoglia per caricare un file .TP5. Questo genererà un albero di sola lettura delle pagine e dei pulsanti del file touch panel. Fare riferimento a questo elenco come verifica del file.

Controllo dell'interfaccia utente
Utilizzare il nodo Controllo UI per programmare pulsanti o altri controlli dal file del pannello a sfioramento.

• Nome – proprietà del nome universale per tutti i nodi.
• Dispositivo – Selezionare il dispositivo con pannello a sfioramento
• Tipo – Selezionare il tipo di controllo dell'interfaccia utente. Seleziona il controllo dell'interfaccia utente dalla struttura delle pagine/pulsanti di seguito
• Grilletto – Scegli il trigger per il controllo dell'interfaccia utente (ad esample, PREMERE o RILASCIARE)
• Stato – Imposta lo stato del controllo dell'interfaccia utente quando viene attivato (ad esampsinistra, ON o OFF)

Exampil flusso di lavoro

In questo exampil flusso di lavoro, noi:

• Connettersi a un controller MUSE
• Costruisci un flusso che ci permetta di alternare lo stato di un relè su un MU-2300
• Distribuisci il flusso al nostro server Node-RED locale

Connettiti al controller MUSE 

1. Configura il controller MUSE. Fare riferimento alla documentazione all'indirizzo
2. Trascina un nodo Controller dalla tavolozza dei nodi di MUSE Automator all'area di disegno e fai doppio clic su di esso per aprire la relativa finestra di dialogo di modifica.
3. Inserisci l'indirizzo IP del controller MUSE e premi il pulsante Connetti, quindi il pulsante Fine.
   Quindi premere il pulsante Distribuisci. La finestra di dialogo e il nodo Controller dovrebbero assomigliare a:

Costruisci e distribuisci un flusso 

1. Successivamente, iniziamo a costruire un flusso trascinando diversi nodi sull'area di disegno. Trascina i seguenti nodi e posizionali nell'ordine da sinistra a destra:
   • Iniettare
   • Stato
   • Cambia (sotto la tavolozza delle funzioni)
   • Comando (trascina due)
   • Debug
2. Fare doppio clic sul nodo Inject e modificarne il nome in "Trigger manuale" e premere Fine
3. Fare doppio clic sul nodo Stato e modificare le seguenti proprietà:
   • Cambia il suo nome in "Ottieni stato relè 1"
   • Dal menu a discesa Dispositivo, seleziona iDevice
   • Espandere il nodo foglia del relè nell'albero e selezionare 1 e quindi stato
   • Premi Fatto
4. Fare doppio clic sul nodo Cambia e modificare le seguenti proprietà:
   • Cambiare il nome in “Controlla stato relè 1”
   • Fai clic sul pulsante +aggiungi nella parte inferiore della finestra di dialogo. Ora dovresti avere due regole nell'elenco. Uno punta a 1 porto e due punti a 2 porte
   • Digita true nel primo campo e imposta il tipo su espressione
   • Digita false nel secondo campo e imposta il tipo su espressione
   • Il tuo nodo di commutazione corretto dovrebbe assomigliare a questo:
5. Fare doppio clic sul primo nodo Comando e modificare le seguenti proprietà:
   • Cambiare il nome in “Imposta relè 1 falso”
   • Dal menu a discesa Dispositivo, seleziona iDevice
   • Espandere il nodo foglia dell'inoltro nell'albero e selezionare 1, quindi indicare quindi premere Fine
6. Fare doppio clic sul secondo nodo Comando e modificare le seguenti proprietà:
   • Cambia il nome in "Imposta relè 1 vero"
   • Dal menu a discesa Dispositivo, seleziona iDevice
   • Espandere il nodo foglia dell'inoltro nell'albero e selezionare 1, quindi indicare quindi premere Fine
7. Collega tutti i nodi insieme in questo modo:
   • Iniettare il nodo nel nodo Stato
   • Nodo di stato al nodo Switch
   • Commuta la porta 1 del nodo sul nodo di comando denominato "Imposta relè 1 falso"
   • Commuta la porta 2 del nodo sul nodo di comando denominato "Imposta relè 1 vero"
   • Collegare entrambi i nodi di comando al nodo di debug

Una volta completata la configurazione e il cablaggio del nodo, la tela del flusso dovrebbe assomigliare a questa:

Ora sei pronto per distribuire il tuo flusso. Nell'angolo in alto a destra dell'applicazione, fai clic sul pulsante Distribuisci per distribuire il flusso sul server Node-RED locale. Se sei connesso a un controller MUSE, ora dovresti essere in grado di premere continuamente il pulsante sul nodo di iniezione e vedere lo stato del relè cambiare da vero a falso nel riquadro di debug (e vedere/sentire l'attivazione del relè sul controller stesso! ).

Risorse aggiuntive

• Canale YouTube di AMX – htps://www.youtube.com/@AMXbyHARMAN
• Risorse per gli sviluppatori AMX – htps://developer.amx.com/#!/main
• Canale YouTube di Node-RED – htps://www.youtube.com/@Node-RED
• Documentazione Node-RED – htps://nodered.org/docs/

© 2024 Harman. Tutti i diritti riservati. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD e HARMAN e i rispettivi loghi sono marchi registrati di HARMAN. Oracle, Java e qualsiasi altra società o marchio a cui si fa riferimento possono essere marchi/marchi registrati delle rispettive società.

AMX non si assume responsabilità per errori od omissioni. AMX si riserva inoltre il diritto di modificare le specifiche senza preavviso in qualsiasi momento. La garanzia AMX e la politica di restituzione e i relativi documenti possono essere viewed/scaricato a www.amx.com.

3000 UNITÀ DI RICERCA, RICHARDSON, TX 75082 AMX. com
800.222.0193
469.624.8000
+1.469.624.7400
fax 469.624.7153
Ultima revisione: 2024-03-01

Documenti / Risorse

Applicazione software HARMAN Muse Automator a basso codice [pdf] Manuale di istruzioni Applicazione software a basso codice Muse Automator, Applicazione software a basso codice Automator, Applicazione software a basso codice, Applicazione software a codice, Applicazione software, Applicazione

Riferimenti

• Manuale d'uso