HARMAN Muse Automator lavkode programvareapplikasjon

Produktinformasjon

Spesifikasjoner

• Programvare uten kode/lav kode
• Designet for bruk med AMX MUSE-kontrollere
• Bygget på Node-RED flytbasert programmeringsverktøy
• Krever NodeJS (v20.11.1+) og Node Package Manager (NPM) (v10.2.4+)
• Kompatibilitet: Windows eller MacOS PC

Produktbruksinstruksjoner

Installasjon og oppsett

Før du installerer MUSE Automator, sørg for at du har installert de nødvendige avhengighetene:

1. Installer NodeJS og NPM ved å følge instruksjonene på: NodeJS
   Installasjonsveiledning.
2. Installer MUSE Automator på din PC ved å følge de respektive installasjonsinstruksjonene.
3. Oppdater MUSE-kontrollerens fastvare tilgjengelig på amx.com.
4. Aktiver Node-RED-støtte i MUSE-kontrolleren ved å følge trinnene nevnt i håndboken.

Komme i gang med MUSE Automator

Automator arbeidsmåter

Simuleringsmodus
Slik bruker du Automator i simuleringsmodus:

1. Dra en kontrollernode til arbeidsområdet.
2. Velg "simulator" fra rullegardinmenyen i redigeringsdialogen.
3. Klikk "Ferdig" og distribuer for å se simulatorstatus som tilkoblet.

Legg til drivere og enheter
Legg til tilsvarende drivere og enheter i henhold til dine krav.

Tilkoblet modus
Slik bruker du tilkoblet modus:

1. Skriv inn adressen til din fysiske MUSE-kontroller i nodeinnstillingene for kontrolleren.
2. Oppgi brukernavn og passord for kontrolleren.
3. Klikk "Koble til" for å opprette en forbindelse med Node-RED-serveren på MUSE-kontrolleren.

FAQ

Q: Hva bør jeg gjøre hvis MUSE Automator ikke kjører riktig?
A: Sørg for at du har installert alle nødvendige avhengigheter og fulgt installasjonsinstruksjonene riktig. Ta kontakt med kundestøtte for ytterligere hjelp.

Q: Hvordan oppdaterer jeg MUSE-kontrollerens fastvare?
A: Du kan oppdatere fastvaren ved å laste ned den nyeste versjonen fra amx.com og følge instruksjonene for fastvareoppdatering.

Installasjon og oppsett

MUSE Automator er en programvareapplikasjon uten kode/lav kode designet for bruk med AMX MUSE-kontrollere. Den er bygget på Node-RED, et mye brukt flytbasert programmeringsverktøy.

Forutsetninger
Før du installerer MUSE Automator, må du installere flere avhengigheter som er skissert nedenfor. Hvis disse avhengighetene ikke installeres først, vil ikke Automator kjøre riktig.

1. Installer NodeJS (v20.11.1+) & Node Package Manager (NPM) (v10.2.4+) Automator er en tilpasset versjon av Node-RED-programvaren, så den krever at NodeJS kjører på systemet ditt. Det krever også Node Package Manager (NPM) for å kunne installere tredjepartsnoder. For å installere NodeJS og NPM, gå til følgende lenke og følg installasjonsinstruksjonene: https://docs.npmis.com/downloading-and=installing-node-is-and-npm
2. Installer Git (v2.43.0+)
   Git er et versjonskontrollsystem. For Automator aktiverer den prosjektfunksjonen slik at du kan organisere flytene dine i diskrete prosjekter. Den aktiverer også Push/Pull-funksjonaliteten som kreves for å distribuere flytene dine til en fysisk MUSE-kontroller. For å installere Git, gå til følgende lenke og følg instruksjonene: https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

Note: Git-installasjonsprogrammet tar deg gjennom en rekke installasjonsalternativer. Det anbefales å bruke standard og installatør-anbefalt alternativer. Vennligst se Git-dokumentasjonen for mer informasjon.

Installer MUSE Automator
Når Git, NodeJS og NPM er installert, kan du installere MUSE Automator. Installer MUSE Automator på din Windows- eller MacOS-PC og følg de respektive installasjonsinstruksjonene.

Installer MUSE-kontrollerens fastvare
For å bruke MUSE Automator med en AMX MUSE-kontroller, må du oppdatere MUSE-kontrollerens fastvare tilgjengelig på amx.com.

Aktiver Node-RED-støtte i MUSE-kontrolleren
Node-RED er deaktivert på MUSE-kontrolleren som standard. Den må aktiveres manuelt. For å gjøre dette, logg på MUSE-kontrolleren og naviger til System > Utvidelser. Rull ned til mojonodred i listen over tilgjengelige utvidelser og klikk på den for å velge den. Trykk på Installer-knappen for å installere Node-RED-utvidelsen og la kontrolleren oppdatere. Se skjermbilde nedenfor for referanse:

Annen informasjon
Hvis du har en brannmur aktivert på PC-en din, må du sørge for at du har port 49152 åpen for at Automator skal kunne kommunisere riktig gjennom denne porten.

Komme i gang med MUSE Automator

Bli kjent med Node-RED
Siden Automator i hovedsak er en tilpasset versjon av Node-RED, bør du først bli kjent med Node-RED-applikasjonen. Programvaren har en relativt grunn læringskurve. Det er hundrevis av artikler og instruksjonsvideoer tilgjengelig for å lære Node-RED, men et godt sted å begynne er i Node-RED-dokumentasjonen: https://nodered.org/docs. Les spesielt gjennom veiledningene, kokeboken og utviklingsflytene for å gjøre deg kjent med applikasjonens funksjoner og brukergrensesnitt.

Denne veiledningen vil ikke dekke det grunnleggende om Node-RED eller flytbasert programmering, så det er viktig at duview den offisielle Node-RED-dokumentasjonen før du starter.

Automatorgrensesnitt overview
Automator-redigeringsgrensesnittet er i hovedsak det samme som Node-RED-standardredigeringsprogrammet med noen justeringer av temaer og noe tilpasset funksjonalitet som muliggjør interaksjon mellom redaktøren og en MUSE-kontroller.

1. MUSE Automator Palette – tilpassede noder for arbeid med HARMAN-enheter
2. Flow-fane – For å veksle mellom views av flere strømmer
3. Arbeidsområde – der du bygger flytene dine. Dra noder fra venstre og slipp ned på arbeidsområdet
4. Push/Pull Tray – For å administrere prosjekter lokalt eller på en kontroller. Skyv, dra, start, stopp, slett et prosjekt.
5. Utplasseringsknapp/skuff – For å distribuere flyter fra editoren til den lokale Node-RED-serveren
6. Hamburgermeny – Hovedmeny for programmet. Lag prosjekter, åpne prosjekter, administrer flyter osv.

Automator arbeidsmåter
Det er tre forskjellige måter å jobbe med Automator på. Dette er ikke begrensende "moduser" i seg selv, men bare metoder for å bruke Automator. Vi bruker begrepet modus her for enkelhets skyld.

1. Simulering – Flow distribueres lokalt og kjøres på en MUSE-simulator slik at du kan teste uten en fysisk kontroller.
2. Tilkoblet – Du er koblet til en fysisk MUSE-kontroller og flyter distribueres og kjøres deretter lokalt på en PC. Hvis du slår av Automator, vil strømmene slutte å fungere.
3. Frittstående – Du har skjøvet de distribuerte flytene dine til en MUSE-kontroller for å kjøre uavhengig på kontrolleren.
   Uansett hvilken modus du kjører, bør du vite hvilke enheter du har tenkt å kontrollere eller automatisere, og deretter laste inn deres respektive drivere til enten simulatoren eller en fysisk kontroller. Metoden for å laste drivere til begge målene er svært forskjellig. Lasting av drivere til simulatoren skjer i noderedigeringsdialogen for Automator Controller (se Legge til drivere og enheter). Innlasting av drivere til en MUSE-kontroller gjøres i kontrolleren web grensesnitt. For å lære mer om å laste drivere til MUSE-kontrolleren, se dokumentasjonen på https://www.amx.com/products/mu-3300#downloads.

Simuleringsmodus
For å bruke Automator i simuleringsmodus, dra en kontrollernode til arbeidsområdet og åpne redigeringsdialogen. Velg simulator fra rullegardinmenyen og klikk på Ferdig-knappen. Du kan nå bruke noder som kan få tilgang til endepunktene til simulatorenheten.

Klikk på Deploy-knappen, og du skal se simulatorstatusen angitt som koblet med en solid grønn indikatorboks:

Legg til drivere og enheter
Det er flere simulatorer allerede innebygd i Automator Controller Node:

• CE Series IO Extenders: CE-IO4, CE-IRS4, CE-REL8, CE-COM2
• I/O-porter for kontroller i MU-serien: MU-1300, MU-2300, MU-3300
• MU Series-kontroller frontpanel LED: MU-2300, MU-3300
• En generisk NetLinx ICSP-enhet

Slik legger du til enheter i simulatoren din:

1. Klikk på Last opp-knappen ved siden av listen over leverandører. Dette vil åpne filsystemdialogen. Velg den tilsvarende driveren for den tiltenkte enheten. Merk: Følgende drivertyper kan lastes opp:
   • DUET-moduler (hent fra developer.amx.com)
   • Innfødte MUSE-drivere
     c. Simulatorfiler
2. Når driveren er lastet opp, kan du legge til den respektive enheten ved å klikke på Legg til-knappen ved siden av Enheter-listen.

Tilkoblet modus
Tilkoblet modus krever at du har en fysisk MUSE-kontroller på nettverket ditt som du kan koble til. Åpne kontrollernoden og skriv inn adressen til MUSE-kontrolleren. Port er 80 og satt som standard. Skriv inn brukernavn og passord for kontrolleren og trykk deretter på Koble til-knappen. Du bør observere en melding om at Automator har koblet til Node-RED-serveren på MUSE-kontrolleren. Se skjermbilde nedenfor.

Frittstående modus
Denne arbeidsmåten med Automator innebærer ganske enkelt å skyve strømmene dine fra din lokale PC til Node-RED-serveren som kjører på en MUSE-kontroller. Dette krever at prosjekter er aktivert (noe som krever installasjon av git). Les nedenfor for å lære mer om Projects og Push/Pull.

Utplassering
Hver gang du gjør en endring i en node, må du distribuere disse endringene fra editoren til Node-RED-serveren for å få flytene til å kjøre. Det er noen alternativer for hva og hvordan du skal distribuere flytene dine i rullegardinmenyen Distribuer. For å lære mer om distribusjon i Node-RED, se Node-RED-dokumentasjonen.

Når du distribuerer i Automator, distribueres flyter til den lokale Node-RED-serveren som kjører på din PC. Deretter må de distribuerte strømmene "skyves" fra din lokale PC til Node-RED-serveren som kjører på MUSE-kontrolleren.

En god måte å finne ut om du har noen ikke-distribuerte endringer i flytene/nodene dine, er i Deploy-knappen i øvre høyre hjørne av applikasjonen. Hvis den er nedtonet og ikke-interaktiv, har du ingen ubrukte endringer i flytene dine. Hvis den er rød og interaktiv, har du ikke-utplasserte endringer i flytene dine. Se skjermbilder nedenfor.

Prosjekter
For å Push/Pull fra din lokale Node-RED-server til serveren som kjører på kontrolleren din, må prosjektfunksjonen være aktivert i Automator. Prosjektfunksjonen aktiveres automatisk hvis git er installert på din PC. For å lære hvordan du installerer git, se Installer Git-delen av denne veiledningen.
Forutsatt at du har installert git og startet MUSE Automator på nytt, kan du opprette et nytt prosjekt ved å klikke på hamburgermenyen i øvre høyre hjørne av applikasjonen.

Skriv inn et prosjektnavn (ingen mellomrom eller spesialtegn tillatt), og foreløpig velg alternativet Deaktiver kryptering under påloggingsinformasjon. Trykk på Opprett prosjekt-knappen for å fullføre prosjektopprettingen.

Nå som du har opprettet et prosjekt, kan du Push/Pull til en fysisk MUSE-kontroller.

Pushing/Pulling-prosjekter
Å skyve og trekke strømmene fra PC-en til Node-RED-serveren på en MUSE-kontroller er en unik funksjon i Automator. Et par trinn må utføres før du kan Push/Pull

1. Sørg for at du er koblet til MUSE-kontrolleren via kontrollernoden
2. Sørg for at du har implementert eventuelle endringer i flytene dine (Deploy-knappen skal være nedtonet)

Klikk på Push/Pull down-pilen for å skyve de distribuerte flatene fra PC-en.

Hold markøren over det lokale prosjektet og klikk på opplastingsikonet for å skyve prosjektet fra din lokale Node-RED-server til Node-RED-serveren på MUSE-kontrolleren.

Etter å ha presset ditt lokale prosjekt til kontrolleren, trykk på Push/Pull-knappen (ikke pilen) og prosjektet skal se ut til å kjøre på kontrolleren.
På samme måte kan et prosjekt som har blitt skjøvet til en kontroller, trekkes fra kontrolleren til PC-en din. Hold markøren over det eksterne prosjektet, klikk på nedlastingsikonet for å trekke prosjektet.

Kjør et prosjekt
Prosjekter som kjører på kontrolleren eller kjører på din lokale Node-RED-server vil bli indikert med en etikett som kjører. For å kjøre et annet prosjekt på enten den eksterne serveren eller den lokale serveren, hold musepekeren over prosjektet og klikk på avspillingsikonet. Merk: bare ett prosjekt kan kjøres om gangen på lokalt eller eksternt.

Slett et prosjekt
For å slette et prosjekt, hold musepekeren over prosjektnavnet under Lokalt eller Eksternt og klikk på søppelbøtteikonet. Advarsel: Vær forsiktig med hva du sletter, ellers kan du miste arbeidet.

Stoppe et prosjekt

Det kan være scenarier der du vil stoppe eller starte et Automator-prosjekt lokalt eller eksternt på kontrolleren. Automator gir muligheten til å starte eller stoppe ethvert prosjekt etter behov. For å stoppe et prosjekt, klikk for å utvide Push/Pull-brettet. Hold markøren over et løpende prosjekt i enten ekstern eller lokal liste, og klikk deretter på stoppikonet.

MUSE Automator Node Palett 

Automator leveres med vår egen tilpassede nodepalett også kalt MUSE Automator. Det er for øyeblikket syv noder som muliggjør funksjonalitet og interaksjon med simulatoren og MUSE-kontrollerne.

Kontroller
Kontrollnoden er det som gir flytsimulatoren eller MUSE-kontrolleren kontekst og programmatisk tilgang til enhetene som er lagt til kontrolleren. Den har følgende felt som kan konfigureres:

• Navn – universell navneegenskap for alle noder.
• Kontroller – kontrolleren eller simulatoren du vil koble til. Velg simulator for å koble til den simulerte MUSE-kontrolleren. For å koble til en fysisk kontroller, sørg for at den er koblet til nettverket og skriv inn IP-adressen i vertsfeltet. Trykk på Koble til-knappen for å koble til kontrolleren.
• Leverandører – listen over drivere som er lastet opp til simulatoren eller kontrolleren. Trykk på Last opp-knappen for å legge til en driver. Velg en driver og trykk Slett for å slette en driver fra listen.
• Enheter – listen over enheter som er lagt til simulatoren eller kontrolleren.
  • Rediger – Velg en enhet fra listen og klikk på Rediger for å redigere egenskapene
  • Legg til – Klikk for å legge til en ny enhet (basert på driverne i listen over leverandører).
    • Forekomst – Når du legger til en ny enhet, kreves det et unikt forekomstnavn.
    • Navn – Valgfritt. Navn på enheten
    • Beskrivelse (valgfritt. Beskrivelse av enheten.
    • Driver – Velg riktig driver (basert på driverne i listen over leverandører).
  • Slett – Velg en enhet fra listen og klikk på Slett for å slette enheten.

Status
Bruk statusnoden for å få statusen eller tilstanden til en bestemt enhetsparameter.

• Navn – universell navneegenskap for alle noder.
• Enhet – velg enheten (basert på Enhetslisten i Controller-noden). Dette vil generere et parametertre i listen nedenfor. Velg parameteren for statushenting.
• Parameter – Skrivebeskyttet felt som viser parameterbanen til den valgte parameteren.

Hendelse
Bruk hendelsesnoden til å lytte etter enhetshendelser som endringer i tilstanden for å utløse en handling (for eksempel en kommando)

• Navn – universell navneegenskap for alle noder.
• Enhet – velg enheten (basert på Enhetslisten i Controller-noden). Dette vil generere et parametertre i listen nedenfor. Velg en parameter fra listen.
• Hendelse – Skrivebeskyttet felt som viser parameterbanen
• Hendelsestype – Skrivebeskyttet type for den valgte parameterhendelsen.
• Parametertype – Skrivebeskyttet datatype for den valgte parameteren.
• Hendelse (umerket) – Nedtrekksboks med listen over hendelser som kan lyttes etter

Kommando
Bruk kommandonoden til å sende en kommando til en enhet.

• Navn – universell navneegenskap for alle noder.
• Enhet – velg enheten (basert på Enhetslisten i Controller-noden). Dette vil generere et parametertre i listen nedenfor. Kun parametere som kan stilles vil vises.
• Valgt – Skrivebeskyttet felt som viser parameterbanen.
• Input – Velg Manuell konfigurasjon for å se de tilgjengelige kommandoene i rullegardinboksen som kan utføres.

Navigere
Bruk navigeringsnoden til å vende en side til et TP5-berøringspanel

• Navn – universell navneegenskap for alle noder.
• Panel – Velg berøringspanelet (legges til via kontrollpanelnoden)
• Kommandoer – Velg Vend-kommandoen
• G5 – En redigerbar streng av kommandoen som skal sendes. Velg siden fra den genererte listen over panelsider for å fylle ut dette feltet.

Kontrollpanel
Bruk kontrollpanelnoden for å legge til berøringspanelkontekst til flyten.

• Navn – universell navneegenskap for alle noder.
• Enhet – Velg berøringspanelenheten
• Panel – Klikk på Bla gjennom for å laste opp en .TP5-fil. Dette vil generere et skrivebeskyttet tre med berøringspanelets filsider og knapper. Referer til denne listen som verifikasjon av filen.

UI-kontroll
Bruk UI-kontrollnoden til å programmere knapper eller andre kontroller fra berøringspanelfilen.

• Navn – universell navneegenskap for alle noder.
• Enhet – Velg berøringspanelenheten
• Type – Velg UI-kontrolltype. Velg UI-kontrollen fra side-/knappetreet nedenfor
• Avtrekker – Velg utløseren for UI-kontrollen (f.eksample, PUSH eller RELEASE)
• Tilstand – Still inn statusen til UI-kontrollen når den utløses (f.eksample, PÅ eller AV)

Example Arbeidsflyt

I denne eksampi arbeidsflyten vil vi:

• Koble til en MUSE-kontroller
• Bygg ut en flyt som lar oss bytte tilstanden til et relé på en MU-2300
• Distribuer flyten til vår lokale Node-RED-server

Koble til MUSE-kontrolleren 

1. Sett opp MUSE-kontrolleren. Se dokumentasjon på
2. Dra en kontrollernode fra MUSE Automator-nodepaletten til lerretet og dobbeltklikk på den for å åpne redigeringsdialogen.
3. Skriv inn IP-adressen til MUSE-kontrolleren og trykk på Koble til-knappen og deretter Ferdig-knappen.
   Trykk deretter på Deploy-knappen. Dialogboksen og kontrollernoden din skal se slik ut:

Bygg og distribuer en flyt 

1. La oss deretter begynne å bygge en flyt ved å dra flere noder til lerretet. Dra følgende noder og plasser i venstre til høyre rekkefølge:
   • Injiser
   • Status
   • Bryter (under funksjonspaletten)
   • Kommando (dra to)
   • Feilsøk
2. Dobbeltklikk på Inject-noden og endre navnet til "Manual Trigger" og trykk på Ferdig
3. Dobbeltklikk på statusnoden og endre følgende egenskaper:
   • Endre navnet til "Get Relay 1 Status"
   • Velg enhet fra rullegardinmenyen Enhet
   • Utvid relébladnoden i treet og velg 1 og oppgi deretter
   • Trykk på Ferdig
4. Dobbeltklikk på Switch-noden og endre følgende egenskaper:
   • Endre navnet til "Sjekk relé 1-status"
   • Klikk på +legg til-knappen nederst i dialogboksen. Du bør nå ha to regler i listen. En peker på 1 port og to peker på 2 port
   • Skriv inn true i det første feltet og sett typen til uttrykk
   • Skriv inn false i det andre feltet og sett typen til uttrykk
   • Skiftnoden din skal se slik ut:
5. Dobbeltklikk på den første kommandonoden og endre følgende egenskaper:
   • Endre navnet til "Set Relay 1 False"
   • Velg enhet fra rullegardinmenyen Enhet
   • Utvid relébladnoden i treet og velg 1 og deretter state og trykk på Ferdig
6. Dobbeltklikk på den andre kommandonoden og endre følgende egenskaper:
   • Endre navnet til "Set Relay 1 True"
   • Velg enhet fra rullegardinmenyen Enhet
   • Utvid relébladnoden i treet og velg 1 og deretter state og trykk på Ferdig
7. Koble alle nodene sammen slik:
   • Injiser node til statusnoden
   • Statusnode til Switch-noden
   • Bytt nodeport 1 til kommandonoden kalt "Set Relay 1 False"
   • Bytt nodeport 2 til kommandonoden som heter "Set Relay 1 True"
   • Koble begge kommandonodene til feilsøkingsnoden

Når du er ferdig med å konfigurere og koble til noden din, skal flytlerretet ditt se omtrent slik ut:

Du er nå klar til å distribuere flyten din. I øvre høyre hjørne av applikasjonen klikker du på Deploy-knappen for å distribuere flyten til den lokale Node-RED-serveren. Hvis du er koblet til en MUSE-kontroller, skal du nå kontinuerlig kunne trykke på knappen på injeksjonsnoden og se relétilstanden endre seg fra sann til usann i feilsøkingsruten (og se/høre reléet slå på selve kontrolleren! ).

Ytterligere ressurser

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

© 2024 Harman. Alle rettigheter forbeholdt. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD og HARMAN, og deres respektive logoer er registrerte varemerker for HARMAN. Oracle, Java og ethvert annet selskap eller merkenavn som det refereres til, kan være varemerker/registrerte varemerker for deres respektive selskaper.

AMX påtar seg ikke ansvar for feil eller mangler. AMX forbeholder seg også retten til å endre spesifikasjoner uten forvarsel når som helst. AMX garanti og returpolicy og relaterte dokumenter kan være viewed/last ned på www.amx.com.

3000 RESEARCH DRIVE, RICHARDSON, TX 75082 AMX.com
800.222.0193
469.624.8000
+1.469.624.7400
faks 469.624.7153
Sist revidert: 2024-03-01

Dokumenter / Ressurser

HARMAN Muse Automator lavkode programvareapplikasjon [pdf] Bruksanvisning Muse Automator lavkodeprogramvareapplikasjon, Automator lavkodeprogramvareapplikasjon, lavkodeprogramvareapplikasjon, kodeprogramvareapplikasjon, programvareapplikasjon, applikasjon

Referanser

• Brukerhåndbok