HARMAN Muse Automator Low Code Software Application Instruction Manual

Installer NodeJS og NPM ved at følge instruktionerne på: NodeJS
Installationsvejledning.
Installer MUSE Automator på din pc ved at følge de respektive installationsinstruktioner.

Opdater MUSE Controller-firmwaren tilgængelig på amx.com.
Aktiver Node-RED-understøttelse i MUSE-controlleren ved at følge trinene nævnt i manualen.

Kom godt i gang med MUSE Automator

Automator arbejdsformer

Simuleringstilstand
Sådan bruger du Automator i simuleringstilstand:

Træk en controller-node til arbejdsområdet.

Vælg 'simulator' fra rullemenuen i redigeringsdialogen.
Klik på 'Udført' og implementer for at se simulatorstatus som tilsluttet.

Tilføj drivere og enheder
Tilføj tilsvarende drivere og enheder i henhold til dine krav.

Forbundet tilstand
Sådan bruger du tilsluttet tilstand:

Indtast adressen på din fysiske MUSE-controller i controllerens nodeindstillinger.
Angiv brugernavn og adgangskode til controlleren.

Klik på 'Connect' for at oprette forbindelse til Node-RED-serveren på MUSE-controlleren.

FAQ

Q: Hvad skal jeg gøre, hvis MUSE Automator ikke kører korrekt?
A: Sørg for at du har installeret alle de nødvendige afhængigheder og fulgt installationsinstruktionerne korrekt. Kontakt kundesupport for yderligere assistance.

Q: Hvordan opdaterer jeg MUSE Controller-firmwaren?
A: Du kan opdatere firmwaren ved at downloade den seneste version fra amx.com og følge de medfølgende instruktioner til firmwareopdatering.

Installation og opsætning

MUSE Automator er et softwareprogram uden kode/lav kode designet til brug med AMX MUSE-controllere. Det er bygget på Node-RED, et meget brugt flow-baseret programmeringsværktøj.

Forudsætninger
Før du installerer MUSE Automator, skal du installere flere afhængigheder, der er beskrevet nedenfor. Hvis disse afhængigheder ikke installeres først, vil Automator ikke køre korrekt.

Installer NodeJS (v20.11.1+) & Node Package Manager (NPM) (v10.2.4+) Automator er en brugerdefineret version af Node-RED-softwaren, så den kræver, at NodeJS kører på dit system. Det kræver også Node Package Manager (NPM) for at kunne installere tredjepartsknuder. For at installere NodeJS og NPM skal du gå til følgende link og følge installationsinstruktionerne: https://docs.npmis.com/downloading-and=installing-node-is-and-npm
Installer Git (v2.43.0+)
Git er et versionskontrolsystem. For Automator aktiverer den projektfunktionen, så du kan organisere dine flows i diskrete projekter. Det aktiverer også Push/Pull-funktionaliteten, der kræves for at implementere dine flows til en fysisk MUSE-controller. For at installere Git skal du gå til følgende link og følge instruktionerne: https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

Note: Git-installationsprogrammet fører dig gennem en række installationsmuligheder. Det anbefales at bruge standard- og installatør-anbefalede muligheder. Se venligst Git-dokumentationen for mere information.

Installer MUSE Automator
Når Git, NodeJS og NPM er blevet installeret, kan du installere MUSE Automator. Installer MUSE Automator på din Windows- eller MacOS-pc og følg de respektive installationsinstruktioner.

Installer MUSE Controller Firmware
For at bruge MUSE Automator med en AMX MUSE-controller, skal du opdatere MUSE-controllerens firmware, der er tilgængelig på amx.com.

Aktiver Node-RED Support i MUSE Controller
Node-RED er som standard deaktiveret på MUSE-controlleren. Den skal aktiveres manuelt. For at gøre dette skal du logge ind på din MUSE-controller og navigere til System > Udvidelser. På listen Tilgængelige udvidelser skal du rulle ned til mojonodred og klikke på den for at vælge den. Tryk på knappen Installer for at installere Node-RED-udvidelsen og lade controlleren opdatere. Se skærmbilledet nedenfor for reference:

Andre oplysninger
Hvis du har en firewall aktiveret på din pc, skal du sørge for, at du har port 49152 åben, så Automator kan kommunikere korrekt gennem denne port.

Kom godt i gang med MUSE Automator

Lær Node-RED at kende
Da Automator i det væsentlige er en tilpasset version af Node-RED, bør du først blive fortrolig med Node-RED-applikationen. Softwaren har en relativt lav indlæringskurve. Der er hundredvis af artikler og instruktionsvideoer tilgængelige for at lære Node-RED, men et godt sted at starte er i Node-RED-dokumentationen: https://nodered.org/docs. Læs især Tutorials, Cookbook og Developing Flows igennem for at gøre dig bekendt med applikationens funktioner og brugergrænseflade.

Denne guide vil ikke dække det grundlæggende i Node-RED eller flow-baseret programmering, så det er bydende nødvendigt, at duview den officielle Node-RED-dokumentation inden start.

Automator Interface Overview
Automator-editor-grænsefladen er i det væsentlige den samme som Node-RED-standardeditoren med nogle justeringer af temaer og nogle brugerdefinerede funktioner, der muliggør interaktion mellem editoren og en MUSE-controller.

MUSE Automator Palette – brugerdefinerede noder til at arbejde med HARMAN-enheder
Flow-fane – Til at skifte mellem views af flere strømme
Workspace – hvor du bygger dine flows. Træk noder fra venstre og slip på arbejdsområdet
Push/Pull Tray – Til styring af projekter lokalt eller på en controller. Skub, træk, start, stop, slet et projekt.
Implementeringsknap/bakke – Til implementering af flows fra editoren til den lokale Node-RED-server
Hamburger Menu – Hovedmenu for applikation. Oprette projekter, åbne projekter, styre flows mv.

Automator arbejdsformer
Der er tre forskellige måder at arbejde med Automator på. Disse er ikke indsnævre "tilstande" i sig selv, men blot metoder til at bruge Automator. Vi bruger termen mode her for nemheds skyld.

Simulering – Flow implementeres lokalt og kører på en MUSE-simulator, så du kan teste uden en fysisk controller.
Forbundet – Du er forbundet til en fysisk MUSE-controller, og flows implementeres og kører derefter lokalt på en pc. Hvis du lukker Automator, vil strømmene ophøre med at fungere.
Standalone – Du har skubbet dine implementerede flows til en MUSE-controller for at køre uafhængigt på controlleren.
Uanset hvilken tilstand du kører, bør du vide, hvilke enheder du har til hensigt at styre eller automatisere, og derefter indlæse deres respektive drivere til enten simulatoren eller en fysisk controller. Metoden til at indlæse drivere til begge mål er meget forskellig. Indlæsning af drivere til simulatoren sker i Automator Controller-knuderedigeringsdialogboksen (se Tilføjelse af drivere og enheder). Indlæsning af drivere til en MUSE-controller sker i controllerens web interface. For at lære mere om indlæsning af drivere til din MUSE-controller, se dokumentationen på https://www.amx.com/products/mu-3300#downloads.

Simuleringstilstand
For at bruge Automator i simuleringstilstand skal du trække en controller-node til arbejdsområdet og åbne dens redigeringsdialog. Vælg simulator fra rullemenuen, og klik på knappen Udført. Du kan nu bruge noder, som kan få adgang til endepunkterne på simulatorenheden.

Klik på knappen Implementer, og du skulle se simulatorstatus angivet som forbundet med en solid grøn indikatorboks:

Tilføj drivere og enheder
Der er allerede indbygget adskillige simulatorer i Automator Controller Node:

CE Series IO Extenders: CE-IO4, CE-IRS4, CE-REL8, CE-COM2

MU Series Controller I/O-porte: MU-1300, MU-2300, MU-3300
MU Series Controller frontpanel LED: MU-2300, MU-3300
En generisk NetLinx ICSP-enhed

Sådan tilføjer du enheder til din simulator:

Klik på knappen Upload ud for listen over udbydere. Dette åbner din filsystemdialog. Vælg den tilsvarende driver til den tilsigtede enhed. Bemærk: følgende drivertyper kan uploades:
- DUET-moduler (hent fra developer.amx.com)
- Indfødte MUSE-drivere
  c. Simulator ﬁler
Når driveren er blevet uploadet, kan du tilføje den respektive enhed ved at klikke på knappen Tilføj ved siden af listen Enheder.

Forbundet tilstand
Forbundet tilstand kræver, at du har en fysisk MUSE-controller på dit netværk, som du kan oprette forbindelse til. Åbn din Controller-node, og indtast adressen på din MUSE-controller. Port er 80 og indstillet som standard. Indtast brugernavnet og adgangskoden til din controller, og tryk derefter på knappen Connect. Du bør observere en meddelelse om, at Automator har oprettet forbindelse til Node-RED-serveren på MUSE-controlleren. Se skærmbillede nedenfor.

Standalone tilstand
Denne måde at arbejde med Automator på involverer simpelthen at skubbe dine flows fra din lokale pc til Node-RED-serveren, der kører på en MUSE-controller. Dette kræver, at Projects er aktiveret (hvilket kræver installation af git). Læs nedenfor for at lære mere om Projects og Push/Pull.

Udruller
Hver gang du foretager en ændring af en node, bliver du nødt til at implementere disse ændringer fra editoren til Node-RED-serveren for at få flowene til at køre. Der er nogle muligheder for, hvad og hvordan du skal implementere dine flows i rullemenuen Implementer. For at lære mere om implementering i Node-RED, se venligst Node-RED-dokumentationen.

Når du installerer i Automator, implementeres flows til den lokale Node-RED-server, der kører på din pc. Derefter skal de implementerede flows "skubbes" fra din lokale pc til Node-RED-serveren, der kører på MUSE-controlleren.

En god måde at afgøre, om du har nogen ikke-implementerede ændringer af dine flows/knudepunkter, er i knappen Deploy i øverste højre hjørne af applikationen. Hvis den er nedtonet og ikke-interaktiv, har du ingen uudnyttede ændringer i dine flows. Hvis det er rødt og interaktivt, har du ikke-implementerede ændringer i dine flows. Se skærmbilleder nedenfor.

Projekter
For at Push/Pull fra din lokale Node-RED-server til serveren, der kører på din controller, skal projektfunktionen være aktiveret i Automator. Projekter-funktionen aktiveres automatisk, hvis git er installeret på din pc. For at lære, hvordan du installerer git, se afsnittet Installer Git i denne vejledning.
Hvis du antager, at du har installeret git og genstartet MUSE Automator, kan du oprette et nyt projekt ved at klikke på hamburgermenuen i øverste højre hjørne af applikationen.

Indtast et projektnavn (ingen mellemrum eller specialtegn tilladt), og indtil videre skal du vælge indstillingen Deaktiver kryptering under legitimationsoplysninger. Tryk på knappen Opret projekt for at fuldføre oprettelsen af projektet.

Nu hvor du har oprettet et projekt, kan du Push/Pull til en fysisk MUSE controller.

Pushing/Pulling-projekter
At skubbe og trække dine flows fra din pc til Node-RED-serveren på en MUSE-controller er en unik funktion i Automator. Et par trin skal udføres, før du kan Push/Pull

Sørg for, at du er forbundet til din MUSE-controller via Controller-noden
Sørg for, at du har implementeret eventuelle ændringer i dine flows (Deploy-knappen skal være nedtonet)

For at skubbe dine implementerede flows fra din pc skal du klikke på Push/Pull down-pilen.

Hold markøren over det lokale projekt, og klik på upload-ikonet for at skubbe projektet fra din lokale Node-RED-server til Node-RED-serveren på din MUSE-controller.

Når du har skubbet dit lokale projekt til controlleren, skal du trykke på Push/Pull-knappen (ikke pilen), og projektet skulle se ud til at køre på controlleren.
På samme måde kan et projekt, der er blevet skubbet til en controller, trækkes fra controlleren til din pc. Hold markøren over Remote-projektet, klik på download-ikonet for at trække projektet.

Kør et projekt
Projekter, der kører på controlleren eller kører på din lokale Node-RED-server, vil blive angivet med en etiket, der kører. For at køre et andet projekt på enten den eksterne server eller den lokale server, skal du holde markøren over projektet og klikke på afspilningsikonet. Bemærk: Kun ét projekt kan køres ad gangen på lokalt eller eksternt.

Slet et projekt
For at slette et projekt skal du holde markøren over projektnavnet under Lokal eller Fjern og klikke på skraldespanden. Advarsel: Vær forsigtig med, hvad du sletter, ellers kan du miste arbejde.

Stop et projekt

Der kan være scenarier, hvor du vil stoppe eller starte et Automator-projekt lokalt eller eksternt på controlleren. Automator giver mulighed for at starte eller stoppe ethvert projekt efter behov. For at stoppe et projekt skal du klikke for at udvide Push/Pull-bakken. Hold markøren over et igangværende projekt på enten fjern- eller lokallisten, og klik derefter på stopikonet.

MUSE Automator Node Palette

Automator leveres med vores egen tilpassede nodepalet, også med titlen MUSE Automator. Der er i øjeblikket syv noder, som muliggør funktionalitet og interaktion med simulatoren og MUSE-controllere.

Controller
Controller-noden er det, der giver din flowsimulator eller MUSE-controller-kontekst og programmatisk adgang til de enheder, der er blevet tilføjet til controlleren. Den har følgende felter, der kan konfigureres:

Navn – universel navneegenskab for alle noder.

Controller – den controller eller simulator, som du ønsker at forbinde til. Vælg simulator for at forbinde til den simulerede MUSE-controller. For at oprette forbindelse til en fysisk controller skal du sørge for, at den er forbundet til dit netværk og indtaste dens IP-adresse i værtsfeltet. Tryk på knappen Connect for at oprette forbindelse til controlleren.
Udbydere – listen over drivere, der er blevet uploadet til din simulator eller controller. Tryk på knappen Upload for at tilføje en driver. Vælg en driver, og tryk på Slet for at slette en driver fra listen.
Enheder – listen over enheder, der er blevet tilføjet til simulatoren eller controlleren.
- Rediger – Vælg en enhed fra listen, og klik på Rediger for at redigere dens egenskaber
- Tilføj – Klik for at tilføje en ny enhed (baseret på driverne på udbyderlisten).
  - Forekomst – Når du tilføjer en ny enhed, kræves et unikt forekomstnavn.
  - Navn – valgfrit. Navn på enheden
  - Beskrivelse (valgfri. Beskrivelse af enheden.
  - Driver – Vælg den relevante driver (baseret på driverne på listen Udbydere).
- Slet – Vælg en enhed fra listen, og klik på Slet for at slette enheden.

Status
Brug statusknuden til at få status eller tilstand for en specifik enhedsparameter.

Navn – universel navneegenskab for alle noder.
Enhed – vælg enheden (baseret på listen Enheder i Controller-noden). Dette vil generere et parametertræ på listen nedenfor. Vælg parameteren for statussøgning.
Parameter – Skrivebeskyttet felt, som viser parameterstien for den valgte parameter.

Tilfælde
Brug hændelsesnoden til at lytte efter enhedsbegivenheder såsom ændringer i tilstanden for at udløse en handling (såsom en kommando)

Navn – universel navneegenskab for alle noder.

Enhed – vælg enheden (baseret på listen Enheder i Controller-noden). Dette vil generere et parametertræ på listen nedenfor. Vælg en parameter fra listen.
Hændelse – Skrivebeskyttet felt, som viser parameterstien
Hændelsestype – Skrivebeskyttet type af den valgte parameterhændelse.

Parameter Type – Skrivebeskyttet datatype for den valgte parameter.
Begivenhed (umærket) – Dropdown-boks med listen over begivenheder, der kan lyttes til

Kommando
Brug kommandonoden til at sende en kommando til en enhed.

Navn – universel navneegenskab for alle noder.
Enhed – vælg enheden (baseret på listen Enheder i Controller-noden). Dette vil generere et parametertræ på listen nedenfor. Kun parametre, der kan indstilles, vises.

Valgt – Skrivebeskyttet felt, som viser parameterstien.
Input – Vælg Manuel konfiguration for at se de tilgængelige kommandoer i rullemenuen, som kan udføres.

Navigere
Brug navigeringsnoden til at udføre en sidevending til et TP5-berøringspanel

Navn – universel navneegenskab for alle noder.
Panel – Vælg berøringspanelet (tilføjet via kontrolpanelknuden)

Kommandoer – Vælg Vend-kommandoen
G5 – En redigerbar streng af kommandoen, der skal sendes. Vælg siden fra den genererede liste over panelsider for at udfylde dette felt.

Kontrolpanel
Brug kontrolpanelknuden til at tilføje berøringspanelkontekst til flowet.

Navn – universel navneegenskab for alle noder.
Enhed – Vælg berøringspanelenheden

Panel – Klik på Gennemse for at uploade en .TP5-fil. Dette vil generere et skrivebeskyttet træ af berøringspanelets filsider og knapper. Henvis til denne liste som verifikation af filen.

UI kontrol
Brug UI-kontrolknuden til at programmere knapper eller andre kontroller fra berøringspanelfilen.

Navn – universel navneegenskab for alle noder.
Enhed – Vælg berøringspanelenheden
Type – Vælg UI-kontroltype. Vælg UI-kontrollen fra side-/knaptræet nedenfor

Udløser – Vælg udløseren for UI-kontrollen (f.eksample, PUSH eller RELEASE)
Tilstand – Indstil tilstanden for UI-kontrollen, når den udløses (f.eksample, TIL eller FRA)

Example arbejdsflow

I dette exampi arbejdsgangen vil vi:

Tilslut til en MUSE-controller
Byg et flow, der giver os mulighed for at skifte tilstanden af et relæ på en MU-2300

Implementer flowet til vores lokale Node-RED-server

Tilslut til MUSE Controller

Konfigurer din MUSE-controller. Der henvises til dokumentation på

Træk en Controller-knude fra MUSE Automator-knudepaletten til lærredet, og dobbeltklik på den for at åbne dens redigeringsdialog.
Indtast IP-adressen på din MUSE-controller, og tryk på knappen Tilslut og derefter på knappen Udført.
Tryk derefter på knappen Deploy. Din dialog og controller-node skal se sådan ud:

Byg og implementer et flow

Lad os derefter begynde at bygge et flow ved at trække flere noder til lærredet. Træk følgende noder og placer i venstre mod højre rækkefølge:
- Indsprøjte
- Status
- Switch (under funktionspaletten)
- Kommando (træk to)
- Debug
Dobbeltklik på Inject noden og skift dens navn til "Manual Trigger", og tryk på Done
Dobbeltklik på statusknuden, og rediger følgende egenskaber:
- Skift dens navn til "Get Relay 1 Status"
- Vælg enhed fra rullemenuen Enhed
- Udvid relæbladknuden i træet og vælg 1 og angiv derefter
- Tryk på Udført
Dobbeltklik på Switch-noden, og rediger følgende egenskaber:
- Skift navnet til "Check Relay 1 Status"
- Klik på knappen +tilføj nederst i dialogboksen. Du skulle nu have to regler på listen. Én peger på 1 port og to peger på 2 port
- Indtast sand i det første felt, og indstil typen til udtryk
- Skriv false i det andet felt, og indstil typen til udtryk
- Din switch node skal se sådan ud:
Dobbeltklik på den første kommandoknude, og rediger følgende egenskaber:
- Skift navnet til "Set Relay 1 False"
- Vælg enhed fra rullemenuen Enhed
- Udvid relæbladknuden i træet og vælg 1 og stat, og tryk derefter på Udført
Dobbeltklik på den anden kommandoknude, og rediger følgende egenskaber:
- Skift navnet til "Set Relay 1 True"
- Vælg enhed fra rullemenuen Enhed
- Udvid relæbladknuden i træet og vælg 1 og stat, og tryk derefter på Udført
Forbind alle noderne således:
- Injicer node til Status node
- Status node til Switch node
- Skift nodeport 1 til kommandonoden med navnet "Set Relay 1 False"
- Skift nodeport 2 til kommandonoden med navnet "Set Relay 1 True"
- Forbind begge kommandonoder til fejlretningsknuden

Når du er færdig med at konfigurere og forbinde din node, skal dit flow-lærred se nogenlunde sådan ud:

Du er nu klar til at implementere dit flow. I øverste højre hjørne af applikationen skal du klikke på knappen Deploy for at implementere dit flow til den lokale Node-RED-server. Hvis du er tilsluttet en MUSE-controller, skulle du nu være i stand til konstant at trykke på knappen på indsprøjtningsnoden og se relætilstanden ændre sig fra sand til falsk i fejlretningsruden (og se/høre relæet tænde selve controlleren! ).

Yderligere ressourcer

AMX YouTube-kanal – htps://www.youtube.com/@AMXbyHARMAN
AMX-udviklerressourcer – htps://developer.amx.com/#!/main
Node-RED YouTube-kanal – htps://www.youtube.com/@Node-RED
Node-RED dokumentation – htps://nodered.org/docs/

© 2024 Harman. Alle rettigheder forbeholdes. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD og HARMAN og deres respektive logoer er registrerede varemærker tilhørende HARMAN. Oracle, Java og ethvert andet firma eller mærkenavn, der henvises til, kan være varemærker/registrerede varemærker tilhørende deres respektive virksomheder.

AMX påtager sig ikke ansvar for fejl eller udeladelser. AMX forbeholder sig også retten til at ændre specifikationer uden forudgående varsel til enhver tid. AMX's garanti- og returpolitik og relaterede dokumenter kan være viewed/downloades på 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
Sidst revideret: 2024-03-01

Dokumenter/ressourcer

HARMAN Muse Automator lavkode softwareapplikation [pdf] Brugsanvisning
Muse Automator Low Code Software Application, Automator Low Code Software Application, Low Code Software Application, Code Software Application, Software Application, Application

Referencer

Brugermanual

HARMAN Muse Automator lavkode softwareapplikation

Produktinformation

Produktbrugsvejledning

Installation og opsætning

Kom godt i gang med MUSE Automator

Example arbejdsflow

Dokumenter/ressourcer

Referencer

Efterlad en kommentar

Annuller svar