HARMAN Muse Automator Instruktionsmanual för lågkodsprogramvara

Installera NodeJS och NPM genom att följa instruktionerna på: NodeJS
Installationsguide.
Installera MUSE Automator på din PC genom att följa respektive installationsinstruktioner.

Uppdatera MUSE Controller-firmware tillgänglig på amx.com.
Aktivera Node-RED-stöd i MUSE Controller genom att följa stegen som nämns i manualen.

Komma igång med MUSE Automator

Automator arbetssätt

Simuleringsläge
Så här använder du Automator i simuleringsläge:

Dra en Controller-nod till arbetsytan.

Välj "simulator" från rullgardinsmenyn i redigeringsdialogrutan.
Klicka på "Klar" och distribuera för att se simulatorstatus som ansluten.

Lägg till drivrutiner och enheter
Lägg till motsvarande drivrutiner och enheter enligt dina krav.

Anslutet läge
Så här använder du anslutet läge:

Ange adressen till din fysiska MUSE-kontroller i Controller-nodinställningarna.
Ange användarnamn och lösenord för styrenheten.

Klicka på "Anslut" för att upprätta en anslutning till Node-RED-servern på MUSE-kontrollen.

FAQ

Q: Vad ska jag göra om MUSE Automator inte fungerar korrekt?
A: Se till att du har installerat alla nödvändiga beroenden och följt installationsinstruktionerna korrekt. Kontakta kundsupport för ytterligare hjälp.

Q: Hur uppdaterar jag MUSE Controllers firmware?
A: Du kan uppdatera firmware genom att ladda ner den senaste versionen från amx.com och följa instruktionerna för uppdatering av firmware.

Installation och installation

MUSE Automator är en mjukvaruapplikation utan kod/låg kod designad för användning med AMX MUSE-kontroller. Det är byggt på Node-RED, ett mycket använt flödesbaserat programmeringsverktyg.

Förutsättningar
Innan du installerar MUSE Automator måste du installera flera beroenden som beskrivs nedan. Om dessa beroenden inte installeras först, kommer Automator inte att köras korrekt.

Installera NodeJS (v20.11.1+) & Node Package Manager (NPM) (v10.2.4+) Automator är en anpassad version av Node-RED-programvaran, så den kräver att NodeJS körs på ditt system. Det kräver också Node Package Manager (NPM) för att kunna installera tredjepartsnoder. För att installera NodeJS och NPM, gå till följande länk och följ installationsinstruktionerna: https://docs.npmis.com/downloading-and=installing-node-is-and-npm
Installera Git (v2.43.0+)
Git är ett versionskontrollsystem. För Automator aktiverar den projektfunktionen så att du kan organisera dina flöden i diskreta projekt. Den aktiverar också Push/Pull-funktionen som krävs för att distribuera dina flöden till en fysisk MUSE-kontroller. För att installera Git, gå till följande länk och följ instruktionerna: https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

Notera: Git-installationsprogrammet tar dig igenom en rad installationsalternativ. Det rekommenderas att använda standardalternativen och installationsrekommenderade alternativ. Se Git-dokumentationen för mer information.

Installera MUSE Automator
När Git, NodeJS och NPM har installerats kan du installera MUSE Automator. Installera MUSE Automator på din Windows- eller MacOS-dator och följ respektive installationsinstruktioner.

Installera MUSE Controller Firmware
För att använda MUSE Automator med en AMX MUSE-kontroller måste du uppdatera MUSE-kontrollerns firmware som finns på amx.com.

Aktivera stöd för Node-RED i MUSE Controller
Node-RED är inaktiverat på MUSE-kontrollenheten som standard. Den måste aktiveras manuellt. För att göra detta loggar du in på din MUSE-kontroller och navigerar till System > Tillägg. I listan Tillgängliga tillägg bläddrar du ned till mojonodred och klickar på den för att välja den. Tryck på knappen Installera för att installera tillägget Node-RED och tillåta kontrollenheten att uppdatera. Se skärmdump nedan för referens:

Övrig information
Om du har en brandvägg aktiverad på din PC måste du se till att du har port 49152 öppen för att Automator ska kunna kommunicera ordentligt via denna port.

Komma igång med MUSE Automator

Lär känna Node-RED
Eftersom Automator i huvudsak är en anpassad version av Node-RED, bör du först bekanta dig med Node-RED-applikationen. Programvaran har en relativt ytlig inlärningskurva. Det finns hundratals artiklar och instruktionsvideor tillgängliga för att lära dig Node-RED, men ett bra ställe att börja är i Node-RED-dokumentationen: https://nodered.org/docs. Läs särskilt igenom självstudierna, kokboken och utvecklingsflöden för att bekanta dig med programmets funktioner och användargränssnitt.

Denna guide kommer inte att täcka grunderna i Node-RED eller flödesbaserad programmering, så det är absolut nödvändigt att duview den officiella Node-RED-dokumentationen innan du sätter igång.

Automatorgränssnitt överview
Automator-redigerarens gränssnitt är i huvudsak detsamma som Node-RED-standardredigeraren med några justeringar av teman och en del anpassade funktioner som möjliggör interaktion mellan redigeraren och en MUSE-kontroller.

MUSE Automator Palette – anpassade noder för att arbeta med HARMAN-enheter
Flödesflik – För att växla mellan views av flera flöden
Arbetsyta – där du bygger dina flöden. Dra noder från vänster och släpp på arbetsytan
Push/Pull Tray – För hantering av projekt lokalt eller på en styrenhet. Tryck, dra, starta, stoppa, ta bort ett projekt.
Deploy Button/Tray – För att distribuera flöden från editorn till den lokala Node-RED-servern
Hamburgermeny – Huvudmeny för applikation. Skapa projekt, öppna projekt, hantera flöden osv.

Automator arbetssätt
Det finns tre olika sätt att arbeta med Automator. Dessa är inte sammandragande "lägen" i sig, utan bara metoder för att använda Automator. Vi använder termen läge här för enkelhets skull.

Simulering – Flöden distribueras lokalt och körs på en MUSE-simulator så att du kan testa utan en fysisk styrenhet.
Ansluten – Du är ansluten till en fysisk MUSE-kontroller och flöden distribueras och körs sedan lokalt på en PC. Om du stänger av Automator kommer flödena att sluta fungera.
Fristående – Du har skickat dina utplacerade flöden till en MUSE-kontroller för att köras oberoende på kontrollenheten.
Oavsett vilket läge du kör bör du veta vilka enheter du tänker styra eller automatisera och sedan ladda sina respektive drivrutiner till antingen simulatorn eller en fysisk styrenhet. Metoden för att ladda drivrutiner till båda målen är väldigt olika. Laddar drivrutiner till simulatorn sker i nodredigeringsdialogrutan för Automator Controller (se Lägga till drivrutiner och enheter). Att ladda drivrutiner till en MUSE-kontroller görs i kontrollenhetens web gränssnitt. För att lära dig mer om hur du laddar drivrutiner till din MUSE-kontroll, se dokumentationen på https://www.amx.com/products/mu-3300#downloads.

Simuleringsläge
För att använda Automator i simuleringsläge, dra en styrenhetsnod till arbetsytan och öppna dess redigeringsdialogruta. Välj simulator från rullgardinsmenyn och klicka på knappen Klar. Du kan nu använda noder som kan komma åt ändpunkterna för simulatorenheten.

Klicka på knappen Distribuera och du bör se simulatorstatusen indikerad som ansluten med en fast grön indikatorruta:

Lägg till drivrutiner och enheter
Det finns flera simulatorer redan inbyggda i Automator Controller Node:

CE-serien IO-förlängare: CE-IO4, CE-IRS4, CE-REL8, CE-COM2

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

Så här lägger du till enheter i din simulator:

Klicka på knappen Ladda upp bredvid listan över leverantörer. Detta öppnar din filsystemsdialog. Välj motsvarande drivrutin för den avsedda enheten. Obs: följande drivrutinstyper kan laddas upp:
- DUET-moduler (hämta från developer.amx.com)
- Inhemska MUSE-drivrutiner
  c. Simulatorfiler
När drivrutinen har laddats upp kan du lägga till respektive enhet genom att klicka på knappen Lägg till bredvid listan Enheter.

Anslutet läge
Anslutet läge kräver att du har en fysisk MUSE-kontroller på ditt nätverk som du kan ansluta till. Öppna din Controller-nod och ange adressen till din MUSE-kontroller. Porten är 80 och inställd som standard. Ange användarnamnet och lösenordet för din handkontroll och tryck sedan på Anslut-knappen. Du bör observera ett meddelande om att Automator har anslutit till Node-RED-servern på MUSE Controller. Se skärmdump nedan.

Fristående läge
Det här arbetssättet med Automator innebär helt enkelt att du skjuter dina flöden från din lokala dator till Node-RED-servern som körs på en MUSE-kontroller. Detta kräver att Projects är aktiverat (vilket kräver installation av git). Läs nedan för att lära dig mer om Projects och Push/Pull.

Utplacering
Varje gång du gör en ändring av en nod måste du distribuera dessa ändringar från editorn till Node-RED-servern för att få flödena att köra. Det finns några alternativ för vad och hur du ska distribuera dina flöden i rullgardinsmenyn Distribuera. För att lära dig mer om implementering i Node-RED, se Node-RED-dokumentationen.

Vid distribution i Automator distribueras flöden till den lokala Node-RED-servern som körs på din PC. Sedan måste de distribuerade flödena "skjutas" från din lokala dator till Node-RED-servern som körs på MUSE-styrenheten.

Ett bra sätt att avgöra om du har några outplacerade ändringar av dina flöden/noder är i knappen Deploy i det övre högra hörnet av programmet. Om den är nedtonad och icke-interaktiv, har du inga outplacerade förändringar i dina flöden. Om det är rött och interaktivt, har du outnyttjade ändringar i dina flöden. Se skärmdumpar nedan.

Projekt
För att Push/Pull från din lokala Node-RED-server till servern som körs på din styrenhet måste projektfunktionen vara aktiverad i Automator. Projektfunktionen aktiveras automatiskt om git är installerat på din PC. För att lära dig hur du installerar git, se avsnittet Installera Git i den här guiden.
Förutsatt att du har installerat git och startat om MUSE Automator kan du skapa ett nytt projekt genom att klicka på hamburgermenyn i programmets övre högra hörn.

Ange ett projektnamn (inga mellanslag eller specialtecken tillåtna) och för tillfället väljer du alternativet Inaktivera kryptering under Inloggningsuppgifter. Tryck på knappen Skapa projekt för att slutföra projektskapandet.

Nu när du har skapat ett projekt kan du Push/Pull till en fysisk MUSE-kontroller.

Pushing/Pulling-projekt
Att skjuta och dra dina flöden från din PC till Node-RED-servern på en MUSE-kontroller är en unik funktion i Automator. Ett par steg måste utföras innan du kan Push/Pull

Se till att du är ansluten till din MUSE-kontroller via Controller-noden
Se till att du har implementerat några ändringar i dina flöden (knappen Distribuera bör vara nedtonad)

Klicka på Push/Pull down-pilen för att trycka på dina distribuerade flöden från din PC.

Håll muspekaren över det lokala projektet och klicka på uppladdningsikonen för att skicka projektet från din lokala Node-RED-server till Node-RED-servern på din MUSE-kontroller.

Efter att du har tryckt på ditt lokala projekt till styrenheten, tryck på Push/Pull-knappen (inte pilen) och projektet ska se ut att köras på styrenheten.
På samma sätt kan ett projekt som har skjutits till en kontrollenhet dras från kontrollenheten till din PC. Håll muspekaren över fjärrprojektet, klicka på nedladdningsikonen för att dra projektet.

Kör ett projekt
Projekt som körs på styrenheten eller körs på din lokala Node-RED-server kommer att indikeras med en etikett som körs. För att köra ett annat projekt på antingen fjärrservern eller lokal server, håll muspekaren över projektet och klicka på spelikonen. Obs: endast ett projekt kan köras åt gången på lokalt eller fjärrstyrt.

Ta bort ett projekt
För att ta bort ett projekt, för muspekaren över projektnamnet under Lokalt eller Fjärrstyrt och klicka på papperskorgen. Varning: var försiktig med vad du raderar, annars kan du förlora arbetet.

Stoppa ett projekt

Det kan finnas scenarier där du vill stoppa eller starta ett Automator-projekt lokalt eller på distans på styrenheten. Automator ger möjlighet att starta eller stoppa alla projekt efter behov. För att stoppa ett projekt, klicka för att expandera Push/Pull-facket. Håll muspekaren över ett pågående projekt i antingen fjärr- eller lokallistan och klicka sedan på stoppikonen.

MUSE Automator Node Palett

Automator levereras med vår egen anpassade nodpalett även kallad MUSE Automator. Det finns för närvarande sju noder tillhandahållna som möjliggör funktionalitet och interaktion med simulatorn och MUSE-kontrollerna.

Kontroller
Kontrollnoden är det som ger din flödessimulator eller MUSE-kontrollerkontext och programmatisk åtkomst till enheterna som har lagts till kontrollenheten. Den har följande fält som kan konfigureras:

Namn – universell namnegenskap för alla noder.

Styrenhet – styrenheten eller simulatorn som du vill ansluta till. Välj simulator för att ansluta till den simulerade MUSE-kontrollen. För att ansluta till en fysisk kontroller, se till att den är ansluten till ditt nätverk och ange dess IP-adress i värdfältet. Tryck på knappen Anslut för att ansluta till kontrollenheten.
Leverantörer – listan över drivrutiner som har laddats upp till din simulator eller styrenhet. Tryck på knappen Ladda upp för att lägga till en drivrutin. Välj en drivrutin och tryck på Delete för att ta bort en drivrutin från listan.
Enheter – listan över enheter som har lagts till i simulatorn eller styrenheten.
- Redigera – Välj en enhet från listan och klicka på Redigera för att redigera dess egenskaper
- Lägg till – Klicka för att lägga till en ny enhet (baserat på drivrutinerna i listan över leverantörer).
  - Instans – När du lägger till en ny enhet krävs ett unikt instansnamn.
  - Namn – Valfritt. Namn på enheten
  - Beskrivning – Valfritt. Beskrivning av enheten.
  - Drivrutin – Välj lämplig drivrutin (baserat på drivrutinerna i listan över leverantörer).
- Ta bort – Välj en enhet från listan och klicka på Ta bort för att ta bort enheten.

Status
Använd statusnoden för att få status eller tillstånd för en specifik enhetsparameter.

Namn – universell namnegenskap för alla noder.
Enhet – välj enheten (baserat på listan Enheter i Controller-noden). Detta kommer att generera ett parameterträd i listan nedan. Välj parameter för statushämtning.
Parameter – Skrivskyddat fält som visar parametersökvägen för den valda parametern.

Händelse
Använd händelsenoden för att lyssna efter enhetshändelser som tillståndsändringar för att utlösa en åtgärd (som ett kommando)

Namn – universell namnegenskap för alla noder.

Enhet – välj enheten (baserat på listan Enheter i Controller-noden). Detta kommer att generera ett parameterträd i listan nedan. Välj en parameter från listan.
Händelse – skrivskyddat fält som visar parametersökvägen
Händelsetyp – Skrivskyddad typ av vald parameterhändelse.

Parametertyp – Skrivskyddad datatyp för den valda parametern.
Händelse (omärkt) – Dropdown-ruta med listan över händelser som kan lyssnas på

Kommando
Använd kommandonoden för att skicka ett kommando till en enhet.

Namn – universell namnegenskap för alla noder.
Enhet – välj enheten (baserat på listan Enheter i Controller-noden). Detta kommer att generera ett parameterträd i listan nedan. Endast parametrar som kan ställas in kommer att visas.

Valt – Skrivskyddat fält som visar parametersökvägen.
Inmatning – Välj Manuell konfiguration för att se de tillgängliga kommandon i rullgardinsmenyn som kan utföras.

Navigera
Använd navigeringsnoden för att utföra en sidvändning till en TP5-pekskärm

Namn – universell namnegenskap för alla noder.
Panel – Välj pekpanelen (läggs till via kontrollpanelens nod)

Kommandon – Välj kommandot Vänd
G5 – En redigerbar sträng av kommandot att skicka. Välj sidan från den genererade listan med panelsidor för att fylla i detta fält.

Kontrollpanelen
Använd kontrollpanelnoden för att lägga till pekpanelskontext till flödet.

Namn – universell namnegenskap för alla noder.
Enhet – Välj pekskärmsenhet

Panel – Klicka på Bläddra för att ladda upp en .TP5-fil. Detta kommer att generera ett skrivskyddat träd av pekpanelens ﬁlsidor och knappar. Referera till den här listan som verifiering av filen.

UI-kontroll
Använd UI-kontrollnoden för att programmera knappar eller andra kontroller från pekpanelsfilen.

Namn – universell namnegenskap för alla noder.
Anordning – Välj pekskärmsenhet
Typ – Välj typ av UI-kontroll. Välj UI-kontrollen från sid-/knappträdet nedan

Utlösare – Välj utlösaren för UI-kontrollen (till exempelample, PUSH eller RELEASE)
Ange – Ställ in gränssnittskontrollens tillstånd när den utlöses (t.example, PÅ eller AV)

Example Arbetsflöde

I detta exampi arbetsflödet kommer vi:

Anslut till en MUSE-kontroller
Bygg ut ett flöde som låter oss växla tillståndet för ett relä på en MU-2300

Distribuera flödet till vår lokala Node-RED-server

Anslut till MUSE Controller

Ställ in din MUSE-kontroller. Se dokumentation på

Dra en Controller-nod från MUSE Automator-nodpaletten till arbetsytan och dubbelklicka på den för att öppna dess redigeringsdialog.
Ange IP-adressen för din MUSE-kontroller och tryck på knappen Anslut och sedan på knappen Klar.
Tryck sedan på knappen Distribuera. Din dialogruta och kontrollnod bör se ut så här:

Bygg och distribuera ett flöde

Låt oss sedan börja bygga ett flöde genom att dra flera noder till arbetsytan. Dra följande noder och placera i vänster till höger ordning:
- Injicera
- Status
- Switch (under funktionspaletten)
- Kommando (dra två)
- Felsökning
Dubbelklicka på Injicera noden och ändra dess namn till "Manual Trigger" och tryck på Klar
Dubbelklicka på statusnoden och ändra följande egenskaper:
- Ändra dess namn till "Get Relay 1 Status"
- Välj enhet i rullgardinsmenyn Enhet
- Expandera reläbladsnoden i trädet och välj 1 och ange sedan
- Tryck på Klar
Dubbelklicka på Switch-noden och ändra följande egenskaper:
- Ändra namnet till "Kontrollera status för relä 1"
- Klicka på knappen +lägg till längst ner i dialogrutan. Du bör nu ha två regler i listan. En pekar på 1 port och två poäng på 2 port
- Skriv true i det första fältet och ställ in typen till uttryck
- Skriv false i det andra fältet och ställ in typen på uttryck
- Din växlingsnod ska se ut så här:
Dubbelklicka på den första kommandonoden och ändra följande egenskaper:
- Ändra namnet till "Set Relay 1 False"
- Välj enhet i rullgardinsmenyn Enhet
- Expandera reläbladsnoden i trädet och välj 1 och ange sedan och tryck på Klar
Dubbelklicka på den andra kommandonoden och ändra följande egenskaper:
- Ändra namnet till "Set Relay 1 True"
- Välj enhet i rullgardinsmenyn Enhet
- Expandera reläbladsnoden i trädet och välj 1 och ange sedan och tryck på Klar
Koppla ihop alla noder så här:
- Injicera nod till statusnoden
- Statusnod till Switch-noden
- Byt nodport 1 till kommandonoden som heter "Set Relay 1 False"
- Byt nodport 2 till kommandonoden som heter "Set Relay 1 True"
- Koppla båda kommandonoderna till felsökningsnoden

När du har slutfört konfigureringen och kopplingen av din nod bör din flödesduk se ut ungefär så här:

Du är nu redo att distribuera ditt flöde. I det övre högra hörnet i programmet klickar du på knappen Distribuera för att distribuera ditt flöde till den lokala Node-RED-servern. Om du är ansluten till en MUSE-kontroller bör du nu kontinuerligt kunna trycka på knappen på injiceringsnoden och se relätillståndet ändras från sant till falskt i felsökningsrutan (och se/höra reläet slå på själva styrenheten! ).

Ytterligare resurser

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

© 2024 Harman. Alla rättigheter förbehållna. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD och HARMAN och deras respektive logotyper är registrerade varumärken som tillhör HARMAN. Oracle, Java och alla andra företag eller varumärken som refereras till kan vara varumärken/registrerade varumärken som tillhör sina respektive företag.

AMX tar inget ansvar för fel eller utelämnanden. AMX förbehåller sig även rätten att när som helst ändra specifikationer utan föregående meddelande. AMX garanti och returpolicy och relaterade dokument kan vara viewed/nedladdad 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
Senast reviderad: 2024-03-01

Dokument/resurser

HARMAN Muse Automator lågkodsprogramprogram [pdf] Bruksanvisning
Muse Automator lågkodsprogram, Automator lågkodsprogram, lågkodsprogram, kodprogram, program, program

Referenser

Användarmanual

HARMAN Muse Automator lågkodsprogramprogram

Produktinformation

Produktanvändningsinstruktioner

Installation och installation

Komma igång med MUSE Automator

Example Arbetsflöde

Dokument/resurser

Referenser

Lämna en kommentar

Avbryt svar