Aplicația software HARMAN Muse Automator Low Code

Informații despre produs

Specificații

• Aplicație software fără cod/low-code
• Proiectat pentru utilizare cu controlerele AMX MUSE
• Construit pe instrumentul de programare bazat pe flux Node-RED
• Necesită NodeJS (v20.11.1+) și Node Package Manager (NPM) (v10.2.4+)
• Compatibilitate: Windows sau MacOS PC

Instrucțiuni de utilizare a produsului

Instalare și configurare

Înainte de a instala MUSE Automator, asigurați-vă că ați instalat dependențele necesare:

1. Instalați NodeJS și NPM urmând instrucțiunile furnizate la: NodeJS
   Ghid de instalare.
2. Instalați MUSE Automator pe computer urmând instrucțiunile de instalare respective.
3. Actualizați firmware-ul controlerului MUSE disponibil pe amx.com.
4. Activați suportul Node-RED în controlerul MUSE urmând pașii menționați în manual.

Noțiuni introductive cu MUSE Automator

Moduri de lucru automate

Modul de simulare
Pentru a utiliza Automator în modul Simulare:

1. Trageți un nod Controller în spațiul de lucru.
2. Selectați „simulator” din caseta drop-down din dialogul de editare.
3. Faceți clic pe „Terminat” și implementați pentru a vedea starea simulatorului ca fiind conectat.

Adăugați drivere și dispozitive
Adăugați driverele și dispozitivele corespunzătoare conform cerințelor dvs.

Modul conectat
Pentru a utiliza modul Conectat:

1. Introduceți adresa controlerului dumneavoastră fizic MUSE în setările nodului Controller.
2. Furnizați numele de utilizator și parola pentru controler.
3. Faceți clic pe „Conectați” pentru a stabili o conexiune cu serverul Node-RED de pe controlerul MUSE.

FAQ

Q: Ce ar trebui să fac dacă MUSE Automator nu rulează corect?
A: Asigurați-vă că ați instalat toate dependențele necesare și că ați urmat corect instrucțiunile de instalare. Contactați asistența pentru clienți pentru asistență suplimentară.

Q: Cum actualizez firmware-ul controlerului MUSE?
A: Puteți actualiza firmware-ul descărcând cea mai recentă versiune de pe amx.com și urmând instrucțiunile furnizate pentru actualizarea firmware-ului.

Instalare și configurare

MUSE Automator este o aplicație software fără cod/low-code concepută pentru a fi utilizată cu controlerele AMX MUSE. Este construit pe Node-RED, un instrument de programare bazat pe flux utilizat pe scară largă.

Cerințe preliminare
Înainte de a instala MUSE Automator, trebuie să instalați mai multe dependențe prezentate mai jos. Dacă aceste dependențe nu sunt instalate mai întâi, Automator nu va rula corect.

1. Instalați NodeJS (v20.11.1+) și Node Package Manager (NPM) (v10.2.4+) Automator este o versiune personalizată a software-ului Node-RED, așa că necesită NodeJS pentru a rula pe sistemul dumneavoastră. De asemenea, necesită Node Package Manager (NPM) pentru a putea instala noduri terțe. Pentru a instala NodeJS și NPM, accesați următorul link și urmați instrucțiunile de instalare: https://docs.npmis.com/downloading-and=installing-node-is-and-npm
2. Instalați Git (v2.43.0+)
   Git este un sistem de control al versiunilor. Pentru Automator, activează caracteristica Proiect, astfel încât să vă puteți organiza fluxurile în proiecte discrete. De asemenea, permite funcționalitatea Push/Pull necesară pentru a vă implementa fluxurile către un controler MUSE fizic. Pentru a instala Git, accesați următorul link și urmați instrucțiunile: https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

Nota: Programul de instalare Git vă va ghida printr-o serie de opțiuni de instalare. Se recomandă utilizarea opțiunilor implicite și recomandate de instalator. Consultați documentația Git pentru mai multe informații.

Instalați MUSE Automator
Odată ce Git, NodeJS și NPM au fost instalate, puteți instala MUSE Automator. Instalați MUSE Automator pe computerul dvs. Windows sau MacOS și urmați instrucțiunile de instalare respective.

Instalați firmware-ul controlerului MUSE
Pentru a utiliza MUSE Automator cu un controler AMX MUSE, va trebui să actualizați firmware-ul controlerului MUSE disponibil pe amx.com.

Activați suportul Node-RED în controlerul MUSE
Node-RED este dezactivat implicit pe controlerul MUSE. Trebuie să fie activat manual. Pentru a face acest lucru, conectați-vă la controlerul MUSE și navigați la Sistem > Extensii. În lista Extensii disponibile, derulați în jos la mojonodred și faceți clic pe el pentru a o selecta. Apăsați butonul Instalare pentru a instala extensia Node-RED și a permite controlerului să se actualizeze. Vedeți captura de ecran de mai jos pentru referință:

Alte informații
Dacă aveți un firewall activat pe computer, va trebui să vă asigurați că aveți portul 49152 deschis pentru ca Automator să comunice corect prin acest port.

Noțiuni introductive cu MUSE Automator

Faceți cunoștință cu Node-RED
Deoarece Automator este în esență o versiune personalizată a Node-RED, mai întâi ar trebui să vă familiarizați cu aplicația Node-RED. Software-ul are o curbă de învățare relativ superficială. Există sute de articole și videoclipuri cu instrucțiuni disponibile pentru a învăța Node-RED, dar un loc bun pentru a începe este în documentația Node-RED: https://nodered.org/docs. În special, citiți tutorialele, cartea de bucate și fluxurile de dezvoltare pentru a vă familiariza cu caracteristicile aplicației și cu interfața cu utilizatorul.

Acest ghid nu va acoperi elementele de bază ale programării Node-RED sau bazate pe flux, deci este imperativ săview documentația oficială Node-RED înainte de a începe.

S-a terminat interfața Automatorview
Interfața editorului Automator este în esență aceeași cu editorul implicit Node-RED, cu unele modificări ale temelor și unele funcționalități personalizate care permit interacțiunea dintre editor și un controler MUSE.

1. MUSE Automator Palette – noduri personalizate pentru lucrul cu dispozitive HARMAN
2. Fila Flow – Pentru comutarea între views de fluxuri multiple
3. Spațiu de lucru – Unde vă construiți fluxurile. Trageți nodurile din stânga și plasați în spațiul de lucru
4. Push/Pull Tray – Pentru gestionarea proiectelor local sau pe un controler. Împingeți, trageți, porniți, opriți, ștergeți un proiect.
5. Deploy Button/Tray – Pentru implementarea fluxurilor de la editor la serverul local Node-RED
6. Meniul Hamburger – Meniul principal al aplicației. Creați proiecte, deschideți proiecte, gestionați fluxuri etc.

Moduri de lucru automate
Există trei moduri distincte de a lucra cu Automator. Acestea nu sunt „moduri” constrictive în sine, ci doar metode de utilizare a Automator. Folosim aici termenul de mod pentru simplitate.

1. Simulare – Fluxurile sunt implementate local și rulează pe un simulator MUSE, astfel încât să puteți testa fără un controler fizic.
2. Conectat – Sunteți conectat la un controler MUSE fizic și fluxurile sunt implementate și apoi rulează local pe un PC. Dacă opriți Automator, fluxurile vor înceta să funcționeze.
3. Standalone – Ați împins fluxurile dvs. implementate către un controler MUSE pentru a rula independent pe controler.
   Indiferent de modul pe care îl rulați, ar trebui să știți ce dispozitive intenționați să controlați sau să automatizați și apoi să încărcați driverele respective fie în simulator, fie într-un controler fizic. Metoda de încărcare a driverelor către oricare dintre ținte este foarte diferită. Încărcarea driverelor în simulator are loc în dialogul de editare a nodului Automator Controller (consultați Adăugarea de drivere și dispozitive). Încărcarea driverelor într-un controler MUSE se face în controler web interfață. Pentru a afla mai multe despre încărcarea driverelor în controlerul MUSE, consultați documentația la https://www.amx.com/products/mu-3300#downloads.

Modul de simulare
Pentru a utiliza Automator în modul Simulare, trageți un nod Controller în spațiul de lucru și deschideți dialogul de editare al acestuia. Selectați simulatorul din caseta derulantă și faceți clic pe butonul Efectuat. Acum puteți utiliza noduri care pot accesa punctele finale ale dispozitivului simulator.

Faceți clic pe butonul Implementare și ar trebui să vedeți starea simulatorului indicată ca fiind conectată cu o casetă indicator verde solidă:

Adăugați drivere și dispozitive
Există mai multe simulatoare deja încorporate în Nodul Controller Automator:

• Extendere IO din seria CE: CE-IO4, CE-IRS4, CE-REL8, CE-COM2
• Porturi I/O pentru controler din seria MU: MU-1300, MU-2300, MU-3300
• LED-ul panoului frontal al controlerului din seria MU: MU-2300, MU-3300
• Un dispozitiv ICSP NetLinx generic

Pentru a adăuga dispozitive la simulator:

1. Faceți clic pe butonul Încărcare de lângă lista de Furnizori. Aceasta va deschide dialogul sistemului de fișiere. Selectați driverul corespunzător pentru dispozitivul dorit. Notă: următoarele tipuri de drivere pot fi încărcate:
   • Module DUET (Preluare de la developer.amx.com)
   • Drivere MUSE native
     c. Fișiere de simulator
2. Odată ce driverul a fost încărcat, puteți adăuga dispozitivul respectiv făcând clic pe butonul Adăugare de lângă lista Dispozitive.

Modul conectat
Modul conectat necesită să aveți un controler MUSE fizic în rețea la care vă puteți conecta. Deschideți nodul Controller și introduceți adresa controlerului MUSE. Portul este 80 și setat implicit. Introduceți numele de utilizator și parola pentru controler și apoi apăsați butonul Conectare. Ar trebui să observați o notificare că Automator sa conectat la serverul Node-RED de pe controlerul MUSE. Vedeți captura de ecran de mai jos.

Modul autonom
Acest mod de lucru cu Automator presupune pur și simplu să vă împingeți fluxurile de la PC-ul local la serverul Node-RED care rulează pe un controler MUSE. Acest lucru necesită activarea Proiectelor (ceea ce necesită instalarea git). Citiți mai jos pentru a afla mai multe despre Proiecte și Push/Pull.

Desfășurare
Ori de câte ori faceți o modificare la un nod, va trebui să implementați acele modificări din editor pe serverul Node-RED pentru ca fluxurile să ruleze. Există câteva opțiuni pentru ce și cum să vă implementați fluxurile în meniul derulant Implementare. Pentru a afla mai multe despre implementarea în Node-RED, consultați documentația Node-RED.

La implementarea în Automator, fluxurile sunt implementate pe serverul local Node-RED care rulează pe computerul dumneavoastră. Apoi, fluxurile implementate trebuie să fie „împins” de pe PC-ul local către serverul Node-RED care rulează pe controlerul MUSE.

O modalitate bună de a determina dacă aveți modificări neimplementate ale fluxurilor/nodurilor dvs. este în butonul Implementare din colțul din dreapta sus al aplicației. Dacă este gri și nu este interactiv, atunci nu aveți modificări neimplementate în fluxurile dvs. Dacă este roșu și interactiv, atunci aveți modificări neimplementate în fluxurile dvs. Vedeți mai jos capturile de ecran.

Proiecte
Pentru a Push/Pull de la serverul local Node-RED la serverul care rulează pe controlerul dvs., funcția Proiecte trebuie să fie activată în Automator. Caracteristica Proiecte este activată automat dacă git este instalat pe computer. Pentru a afla cum să instalați git, consultați secțiunea Instalare Git din acest ghid.
Presupunând că ați instalat git și ați repornit MUSE Automator, puteți crea un nou proiect făcând clic pe meniul hamburger din colțul din dreapta sus al aplicației.

Introduceți un nume de proiect (nu sunt permise spații sau caractere speciale) și, deocamdată, selectați opțiunea Dezactivare criptare din Acreditări. Apăsați butonul Creare proiect pentru a finaliza crearea proiectului.

Acum că ați creat un proiect, puteți Push/Pull către un controler fizic MUSE.

Proiecte de împingere/tragere
Împingerea și tragerea fluxurilor dvs. de pe computer la serverul Node-RED pe un controler MUSE este o caracteristică unică în Automator. Trebuie să efectuați câțiva pași înainte de a putea Push/Pull

1. Asigurați-vă că sunteți conectat la controlerul MUSE prin nodul Controller
2. Asigurați-vă că ați implementat orice modificări în fluxurile dvs. (butonul Implementare ar trebui să fie gri)

Pentru a împinge fluxurile implementate de pe computer, faceți clic pe săgeata Push/Pull down.

Plasați cursorul peste proiectul local și faceți clic pe pictograma de încărcare pentru a împinge proiectul de la serverul dvs. local Node-RED către serverul Node-RED de pe controlerul dvs. MUSE.

După ce împingeți proiectul local către controler, apăsați butonul Push/Pull (nu săgeata) și proiectul ar trebui să pară că rulează pe controler.
În același mod, un proiect care a fost împins la un controler poate fi tras de la controler la computer. Plasați cursorul peste proiectul de la distanță, faceți clic pe pictograma de descărcare pentru a trage proiectul.

Rulați un proiect
Proiectele care rulează pe controler sau rulează pe serverul local Node-RED vor fi indicate printr-o etichetă de rulare. Pentru a rula un proiect diferit fie pe serverul la distanță, fie pe serverul local, plasați cursorul peste proiect și faceți clic pe pictograma de redare. Notă: un singur proiect poate rula simultan pe Local sau la distanță.

Ștergeți un proiect
Pentru a șterge un proiect, plasați cursorul peste numele proiectului sub Local sau La distanță și faceți clic pe pictograma coș de gunoi. Atenție: fiți atenți la ceea ce ștergeți, altfel puteți pierde munca.

Oprirea unui proiect

Pot exista scenarii în care doriți să opriți sau să începeți un proiect Automator local sau de la distanță pe controler. Automator oferă posibilitatea de a porni sau opri orice proiect după cum este necesar. Pentru a opri un proiect, faceți clic pentru a extinde tava Push/Pull. Plasați cursorul peste orice proiect în curs de desfășurare, fie din lista Remote sau Locală, apoi faceți clic pe pictograma de oprire.

MUSE Automator Node Palete 

Automator este livrat cu propria noastră paletă de noduri personalizate, de asemenea, intitulată MUSE Automator. În prezent, există șapte noduri furnizate care permit funcționalitatea și interacțiunea cu simulatorul și controlerele MUSE.

Controlor
Nodul Controller este cel care oferă simulatorului de fluxuri sau contextul controlerului MUSE și acces programatic la dispozitivele care au fost adăugate la controler. Are următoarele câmpuri care pot fi configurate:

• Nume – proprietatea numelui universal pentru toate nodurile.
• Controler – controlerul sau simulatorul la care doriți să vă conectați. Selectați simulatorul pentru a vă conecta la controlerul MUSE simulat. Pentru a vă conecta la un controler fizic, asigurați-vă că este conectat la rețea și introduceți adresa IP a acestuia în câmpul gazdă. Apăsați butonul Conectare pentru a vă conecta la controler.
• Furnizori – lista de drivere care au fost încărcate în simulatorul sau controlerul dumneavoastră. Apăsați butonul Încărcare pentru a adăuga un driver. Selectați un driver și apăsați Delete pentru a șterge un driver din listă.
• Dispozitive – lista de dispozitive care au fost adăugate la simulator sau controler.
  • Editare – Selectați un dispozitiv din listă și faceți clic pe Editare pentru a-i edita proprietățile
  • Adăugare – Faceți clic pentru a adăuga un dispozitiv nou (pe baza driverelor din lista de furnizori).
    • Instanță – Când adăugați un dispozitiv nou, este necesar un nume unic al instanței.
    • Nume – Opțional. Numele dispozitivului
    • Descriere – Opțional. Descrierea dispozitivului.
    • Driver – Selectați driverul corespunzător (pe baza driverelor din lista de furnizori).
  • Ștergere – Selectați un dispozitiv din listă și faceți clic pe Ștergere pentru a șterge dispozitivul.

Stare
Utilizați nodul Stare pentru a obține starea sau starea unui anumit parametru de dispozitiv.

• Nume – proprietatea numelui universal pentru toate nodurile.
• Dispozitiv – selectați dispozitivul (pe baza listei Dispozitive din nodul Controller). Aceasta va genera un arbore de parametri în lista de mai jos. Selectați parametrul pentru regăsirea stării.
• Parametru – Câmp de doar citire care arată calea parametrului parametrului selectat.

Eveniment
Utilizați nodul Eveniment pentru a asculta evenimentele dispozitivului, cum ar fi schimbări de stare, pentru a declanșa o acțiune (cum ar fi o comandă)

• Nume – proprietatea numelui universal pentru toate nodurile.
• Dispozitiv – selectați dispozitivul (pe baza listei Dispozitive din nodul Controller). Aceasta va genera un arbore de parametri în lista de mai jos. Selectați un parametru din listă.
• Eveniment – ​​Câmp de doar citire care arată calea parametrului
• Tip eveniment – ​​Tipul doar pentru citire al evenimentului parametru selectat.
• Tip parametru – Tipul de date numai pentru citire al parametrului selectat.
• Eveniment (fără etichetă) – casetă drop-down cu lista de evenimente care pot fi ascultate

Comanda
Utilizați nodul Comandă pentru a trimite o comandă către un dispozitiv.

• Nume – proprietatea numelui universal pentru toate nodurile.
• Dispozitiv – selectați dispozitivul (pe baza listei Dispozitive din nodul Controller). Aceasta va genera un arbore de parametri în lista de mai jos. Vor fi afișați doar parametrii care pot fi setați.
• Selectat – Câmp de doar citire care arată calea parametrului.
• Intrare – Alegeți Configurare manuală pentru a vedea comenzile disponibile în caseta derulantă care pot fi executate.

Navigați
Utilizați nodul Navigare pentru a efectua o întoarcere a paginii către un panou tactil TP5

• Nume – proprietatea nume universal pentru toate nodurile.
• Panou – Selectați panoul tactil (adăugat prin nodul Panou de control)
• Comenzi – Alegeți comanda Flip
• G5 – Un șir editabil al comenzii de trimis. Selectați pagina din lista generată de pagini panou pentru a completa acest câmp.

Panoul de control
Utilizați nodul Panou de control pentru a adăuga contextul panoului tactil la flux.

• Nume – proprietatea numelui universal pentru toate nodurile.
• Dispozitiv – Selectați dispozitivul cu panou tactil
• Panou – Faceți clic pe Răsfoire pentru a încărca un fișier .TP5. Aceasta va genera un arbore numai pentru citire al paginilor și butoanelor fișierelor de pe panoul tactil. Faceți referire la această listă ca verificare a fișierului.

Control UI
Utilizați nodul Control UI pentru a programa butoane sau alte comenzi din fișierul panoului tactil.

• Nume – proprietatea nume universal pentru toate nodurile.
• Dispozitiv – Selectați dispozitivul cu panou tactil
• Tip – Selectați tipul de control al UI. Selectați controlul UI din arborele de pagină/buton de mai jos
• Trigger – Alegeți declanșatorul pentru controlul UI (de example, PUSH sau RELEASE)
• Stat – Setați starea controlului UI atunci când este declanșat (de example, ON sau OFF)

Example Fluxul de lucru

În acest exampîn fluxul de lucru, vom:

• Conectați-vă la un controler MUSE
• Creați un flux care ne permite să comutăm starea unui releu pe un MU-2300
• Implementați fluxul pe serverul nostru local Node-RED

Conectați-vă la controlerul MUSE 

1. Configurați controlerul MUSE. Consultați documentația la
2. Trageți un nod Controller din paleta de noduri MUSE Automator în pânză și faceți dublu clic pe el pentru a deschide dialogul său de editare.
3. Introduceți adresa IP a controlerului dvs. MUSE și apăsați butonul Connect și apoi butonul Done.
   Apoi apăsați butonul Deploy. Dialogul și nodul Controller ar trebui să arate astfel:

Creați și implementați un flux 

1. În continuare, să începem construirea unui flux trăgând mai multe noduri pe pânză. Trageți următoarele noduri și plasați-le în ordine de la stânga la dreapta:
   • Injecta
   • Stare
   • Comutator (sub paleta de funcții)
   • Comanda (trageți două)
   • Depanați
2. Faceți dublu clic pe nodul Injectare și schimbați-i numele în „Declanșare manuală” și apăsați pe Terminat
3. Faceți dublu clic pe nodul Stare și modificați următoarele proprietăți:
   • Schimbați-i numele în „Obțineți starea releului 1”
   • Din meniul derulant Dispozitiv, selectați idevice
   • Extindeți nodul frunză releu din arbore și selectați 1 și apoi stare
   • Apăsați Terminat
4. Faceți dublu clic pe nodul Comutare și modificați următoarele proprietăți:
   • Schimbați numele în „Verificați starea releului 1”
   • Faceți clic pe butonul +adăugați din partea de jos a casetei de dialog. Acum ar trebui să aveți două reguli în listă. Un punct la 1 port și două puncte la 2 porturi
   • Tastați true în primul câmp și setați tipul la expresie
   • Tastați false în al doilea câmp și setați tipul la expresie
   • Nodul dvs. de comutare corespunzător ar trebui să arate astfel:
5. Faceți dublu clic pe primul nod de comandă și modificați următoarele proprietăți:
   • Schimbați numele în „Setare releu 1 fals”
   • Din meniul derulant Dispozitiv, selectați idevice
   • Extindeți nodul frunză releu în arbore și selectați 1 și apoi afișați apoi apăsați Efectuat
6. Faceți dublu clic pe al doilea nod de comandă și modificați următoarele proprietăți:
   • Schimbați numele în „Set Relay 1 True”
   • Din meniul derulant Dispozitiv, selectați idevice
   • Extindeți nodul frunză releu în arbore și selectați 1 și apoi afișați apoi apăsați Efectuat
7. Conectați toate nodurile împreună astfel:
   • Injectați nodul în nodul Status
   • Nodul de stare către nodul Comutare
   • Comutați portul 1 al nodului la nodul de comandă numit „Set Relay 1 False”
   • Comutați portul 2 al nodului la nodul de comandă numit „Set Relay 1 True”
   • Conectați ambele noduri de comandă la nodul de depanare

Odată ce ați finalizat configurarea și conectarea nodului, pânza dvs. de flux ar trebui să arate cam așa:

Acum sunteți gata să vă implementați fluxul. În colțul din dreapta sus, al aplicației, faceți clic pe butonul Deploy pentru a vă implementa fluxul pe serverul local Node-RED. Dacă sunteți conectat la un controler MUSE, acum ar trebui să puteți apăsa continuu butonul de pe nodul de injectare și să vedeți starea releului schimbându-se de la adevărat la fals în panoul de depanare (și să vedeți/auziți releul pornind controlerul în sine! ).

Resurse suplimentare

• Canalul AMX YouTube – htps://www.youtube.com/@AMXbyHARMAN
• Resurse pentru dezvoltatori AMX - htps://developer.amx.com/#!/main
• Canalul YouTube Node-RED – htps://www.youtube.com/@Node-RED
• Documentația Node-RED – htps://nodered.org/docs/

© 2024 Harman. Toate drepturile rezervate. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD și HARMAN și siglele lor respective sunt mărci comerciale înregistrate ale HARMAN. Oracle, Java și orice altă companie sau nume de marcă la care se face referire pot fi mărci comerciale/mărci comerciale înregistrate ale companiilor respective.

AMX nu își asumă responsabilitatea pentru erori sau omisiuni. AMX își rezervă, de asemenea, dreptul de a modifica specificațiile fără notificare prealabilă în orice moment. Politica de garanție și retur AMX și documentele aferente pot fi viewed/descărcat la 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
Ultima revizuire: 2024-03-01

Documente/Resurse

Aplicația software HARMAN Muse Automator Low Code [pdfManual de instrucțiuni Aplicație software Muse Automator Low Code, Aplicație software Automator Low Code, Aplicație software Low Code, Aplicație software cod, Aplicație software, Aplicație

Referințe

• Manual de utilizare