Návod k použití softwarové aplikace HARMAN Muse Automator Low Code

Nainstalujte NodeJS a NPM podle pokynů uvedených na adrese: NodeJS
Průvodce instalací.
Nainstalujte MUSE Automator do počítače podle příslušných pokynů instalačního programu.

Aktualizujte firmware ovladače MUSE dostupný na amx.com.
Povolte podporu Node-RED v ovladači MUSE podle kroků uvedených v příručce.

Začínáme s MUSE Automator

Režimy práce automatu

Režim simulace
Chcete-li použít Automator v režimu simulace:

Přetáhněte uzel Controller do pracovního prostoru.

Z rozevíracího pole v dialogovém okně úprav vyberte „simulátor“.
Klikněte na 'Hotovo' a nasaďte, abyste viděli stav simulátoru jako připojeného.

Přidat ovladače a zařízení
Přidejte odpovídající ovladače a zařízení podle svých požadavků.

Připojený režim
Chcete-li použít režim připojení:

Zadejte adresu svého fyzického ovladače MUSE v nastavení uzlu ovladače.
Zadejte uživatelské jméno a heslo pro ovladač.

Kliknutím na „Připojit“ navážete spojení se serverem Node-RED na ovladači MUSE.

FAQ

Q: Co mám dělat, když MUSE Automator neběží správně?
A: Ujistěte se, že jste nainstalovali všechny potřebné závislosti a správně postupovali podle pokynů k instalaci. Pro další pomoc se obraťte na zákaznickou podporu.

Q: Jak aktualizuji firmware ovladače MUSE?
A: Firmware můžete aktualizovat stažením nejnovější verze z amx.com a podle poskytnutých pokynů pro aktualizaci firmwaru.

Instalace a nastavení

MUSE Automator je softwarová aplikace bez kódu/nízkého kódu navržená pro použití s ovladači AMX MUSE. Je postaven na Node-RED, široce používaném programovacím nástroji založeném na toku.

Předpoklady
Před instalací MUSE Automator musíte nainstalovat několik níže uvedených závislostí. Pokud tyto závislosti nejsou nainstalovány jako první, Automator nebude fungovat správně.

Nainstalujte NodeJS (v20.11.1+) & Node Package Manager (NPM) (v10.2.4+) Automator je vlastní verze softwaru Node-RED, takže ke spuštění ve vašem systému vyžaduje NodeJS. Vyžaduje také Node Package Manager (NPM), aby bylo možné instalovat uzly třetích stran. Chcete-li nainstalovat NodeJS a NPM, přejděte na následující odkaz a postupujte podle pokynů k instalaci: https://docs.npmis.com/downloading-and=installing-node-is-and-npm
Nainstalovat Git (v2.43.0+)
Git je systém pro správu verzí. Pro Automator povoluje funkci Projekt, takže můžete organizovat své toky do samostatných projektů. Umožňuje také funkci Push/Pull potřebnou k nasazení vašich toků do fyzického ovladače MUSE. Chcete-li nainstalovat Git, přejděte na následující odkaz a postupujte podle pokynů: https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

Poznámka: Instalační program Git vás provede řadou možností instalace. Doporučuje se použít výchozí a instalačním programem doporučené možnosti. Další informace najdete v dokumentaci Git.

Nainstalujte MUSE Automator
Po instalaci Git, NodeJS a NPM můžete nainstalovat MUSE Automator. Nainstalujte MUSE Automator do počítače se systémem Windows nebo MacOS a postupujte podle příslušných pokynů instalačního programu.

Nainstalujte firmware ovladače MUSE
Chcete-li používat MUSE Automator s ovladačem AMX MUSE, budete muset aktualizovat firmware ovladače MUSE dostupný na amx.com.

Povolte podporu Node-RED v ovladači MUSE
Node-RED je na ovladači MUSE ve výchozím nastavení zakázáno. Musí být povoleno ručně. Chcete-li to provést, přihlaste se k ovladači MUSE a přejděte do části Systém > Rozšíření. V seznamu Available Extensions přejděte dolů na mojonodred a kliknutím jej vyberte. Stisknutím tlačítka Instalovat nainstalujete rozšíření Node-RED a umožníte aktualizaci ovladače. Pro referenci viz snímek obrazovky níže:

Další informace
Pokud máte na svém PC povolenou bránu firewall, budete se muset ujistit, že máte otevřený port 49152, aby Automator mohl přes tento port správně komunikovat.

Začínáme s MUSE Automator

Seznamte se s Node-RED
Protože Automator je v podstatě upravená verze Node-RED, měli byste se nejprve seznámit s aplikací Node-RED. Software má relativně mělkou křivku učení. K dispozici jsou stovky článků a instruktážních videí, jak se naučit Node-RED, ale dobré místo, kde začít, je v dokumentaci Node-RED: https://nodered.org/docs. Zejména si přečtěte návody, kuchařku a vývojové toky, abyste se seznámili s funkcemi a uživatelským rozhraním aplikace.

Tato příručka nepokrývá základy programování Node-RED nebo programování založeného na toku, takže je nutné, abysteview oficiální dokumentaci Node-RED, než začnete.

Rozhraní automatu přesview
Rozhraní editoru Automator je v podstatě stejné jako výchozí editor Node-RED s několika vylepšeními témat a některými vlastními funkcemi, které umožňují interakci mezi editorem a ovladačem MUSE.

MUSE Automator Palette – vlastní uzly pro práci se zařízeními HARMAN
Záložka Flow – Pro přepínání mezi views více toků
Pracovní prostor – kde budujete své toky. Přetáhněte uzly zleva a pusťte je na pracovní plochu
Push/Pull Tray – Pro správu projektů lokálně nebo na řadiči. Zatlačte, vytáhněte, spusťte, zastavte, odstraňte projekt.
Deploy Button/Tray – Pro nasazení toků z editoru na lokální server Node-RED
Hamburger Menu – Hlavní menu aplikace. Vytvářejte projekty, otevírejte projekty, spravujte toky atd.

Režimy práce automatu
Existují tři různé způsoby práce s Automatorem. Toto nejsou omezující „režimy“ samy o sobě, ale pouze způsoby použití Automatoru. Pro jednoduchost zde používáme termín režim.

Simulace – Toky jsou nasazeny lokálně a běží na simulátoru MUSE, takže můžete testovat bez fyzického ovladače.
Připojeno – Jste připojeni k fyzickému ovladači MUSE a toky jsou nasazeny a poté spuštěny lokálně na PC. Pokud vypnete Automator, toky přestanou fungovat.
Samostatný – Nasadili jste nasazené toky do ovladače MUSE, aby běžely nezávisle na ovladači.
Bez ohledu na to, jaký režim používáte, měli byste vědět, která zařízení hodláte ovládat nebo automatizovat, a poté nahrát jejich příslušné ovladače buď do simulátoru, nebo do fyzického ovladače. Způsob načítání ovladačů do obou cílů je velmi odlišný. Načítání ovladačů do simulátoru probíhá v dialogovém okně pro úpravy uzlu Automator Controller (viz Přidání ovladačů a zařízení). Načítání ovladačů do ovladače MUSE se provádí v ovladači web rozhraní. Další informace o načítání ovladačů do řadiče MUSE naleznete v dokumentaci na adrese https://www.amx.com/products/mu-3300#downloads.

Režim simulace
Chcete-li použít Automator v režimu simulace, přetáhněte uzel Controller do pracovního prostoru a otevřete jeho dialogové okno pro úpravy. Z rozevíracího seznamu vyberte simulátor a klikněte na tlačítko Hotovo. Nyní můžete používat uzly, které mají přístup ke koncovým bodům zařízení simulátoru.

Klikněte na tlačítko Deploy a měli byste vidět stav simulátoru označený jako připojený pomocí nepřerušovaného zeleného indikátoru:

Přidat ovladače a zařízení
V uzlu Automator Controller je již zabudováno několik simulátorů:

IO Extender řady CE: CE-IO4, CE-IRS4, CE-REL8, CE-COM2

I/O porty řadiče řady MU: MU-1300, MU-2300, MU-3300
LED na předním panelu ovladače řady MU: MU-2300, MU-3300
Obecné zařízení NetLinx ICSP

Postup přidání zařízení do simulátoru:

Klikněte na tlačítko Nahrát vedle seznamu poskytovatelů. Tím se otevře dialogové okno systému souborů. Vyberte odpovídající ovladač pro zamýšlené zařízení. Poznámka: Lze nahrát následující typy ovladačů:
- Moduly DUET (Načíst z developer.amx.com)
- Nativní ovladače MUSE
  C. Soubory simulátoru
Po nahrání ovladače můžete přidat příslušné zařízení kliknutím na tlačítko Přidat vedle seznamu Zařízení.

Připojený režim
Připojený režim vyžaduje, abyste měli v síti fyzický řadič MUSE, ke kterému se můžete připojit. Otevřete uzel ovladače a zadejte adresu ovladače MUSE. Port je 80 a je standardně nastaven. Zadejte uživatelské jméno a heslo pro váš ovladač a poté stiskněte tlačítko Připojit. Měli byste sledovat oznámení, že se Automator připojil k serveru Node-RED na ovladači MUSE. Viz snímek obrazovky níže.

Samostatný režim
Tento režim práce s Automatorem jednoduše zahrnuje přenesení vašich toků z vašeho místního PC na server Node-RED běžící na ovladači MUSE. To vyžaduje, aby byly povoleny projekty (což vyžaduje instalaci git). Přečtěte si níže, abyste se dozvěděli více o projektech a Push/Pull.

Nasazení
Kdykoli provedete změnu v uzlu, budete muset tyto změny nasadit z editoru na server Node-RED, aby se toky spustily. V rozevíracím seznamu Nasadit je několik možností, co a jak nasadit vaše toky. Další informace o nasazení v Node-RED naleznete v dokumentaci Node-RED.

Při nasazení v Automatoru jsou toky nasazeny na lokální server Node-RED spuštěný na vašem PC. Poté musí být nasazené toky „přesunuty“ z vašeho místního počítače na server Node-RED spuštěný na ovladači MUSE.

Dobrým způsobem, jak zjistit, zda máte nějaké nenasazené změny ve svých tocích/uzlech, je tlačítko Deploy v pravém horním rohu aplikace. Pokud je zašedlá a neinteraktivní, pak nemáte žádné neimplementované změny ve vašich tocích. Pokud je červený a interaktivní, máte ve svých tocích neimplementované změny. Viz screenshoty níže.

Projekty
Chcete-li Push/Pull z vašeho lokálního serveru Node-RED na server běžící na vašem řadiči, musí být v Automatoru povolena funkce Projects. Funkce Projekty je automaticky povolena, pokud je na vašem PC nainstalován git. Chcete-li se dozvědět, jak nainstalovat git, přečtěte si část Instalace Git této příručky.
Za předpokladu, že jste nainstalovali git a restartovali MUSE Automator, můžete vytvořit nový projekt kliknutím na nabídku hamburgerů v pravém horním rohu aplikace.

Zadejte název projektu (nejsou povoleny mezery ani speciální znaky) a prozatím vyberte možnost Zakázat šifrování v části Přihlašovací údaje. Stisknutím tlačítka Vytvořit projekt dokončíte vytváření projektu.

Nyní, když jste vytvořili projekt, můžete Push/Pull do fyzického ovladače MUSE.

Projekty tlačení/tahání
Posouvání a stahování vašich toků z vašeho PC na server Node-RED na ovladači MUSE je jedinečná funkce v Automatoru. Než budete moci stisknout/vytáhnout, je třeba provést několik kroků

Ujistěte se, že jste připojeni k ovladači MUSE prostřednictvím uzlu Controller
Ujistěte se, že jste nasadili všechny změny ve svých tocích (tlačítko Deploy by mělo být zašedlé)

Chcete-li své nasazené toky přenést z počítače, klikněte na šipku dolů Push/Pull.

Umístěte ukazatel myši na místní projekt a klikněte na ikonu nahrávání, aby se projekt přenesl z místního serveru Node-RED na server Node-RED na ovladači MUSE.

Po vložení vašeho místního projektu do ovladače stiskněte tlačítko Push/Pull (ne šipku) a projekt by se měl zdát spuštěný na ovladači.
Stejným způsobem lze projekt, který byl přenesen do řadiče, stáhnout z řadiče do počítače. Umístěte ukazatel myši na vzdálený projekt a klikněte na ikonu stahování pro stažení projektu.

Spusťte projekt
Projekty, které běží na řadiči nebo běží na vašem lokálním serveru Node-RED, budou označeny štítkem běžící. Chcete-li spustit jiný projekt na vzdáleném serveru nebo na místním serveru, najeďte myší na projekt a klikněte na ikonu přehrávání. Poznámka: Na místním nebo vzdáleném místě může současně běžet pouze jeden projekt.

Smazat projekt
Chcete-li projekt odstranit, umístěte ukazatel myši na název projektu v části Místní nebo Vzdálený a klikněte na ikonu koše. Varování: buďte opatrní ohledně toho, co mažete, jinak můžete přijít o práci.

Zastavení projektu

Mohou existovat scénáře, kdy budete chtít zastavit nebo spustit projekt Automator lokálně nebo vzdáleně na ovladači. Automator poskytuje možnost spustit nebo zastavit jakýkoli projekt podle potřeby. Chcete-li zastavit projekt, kliknutím rozbalte zásobník Push/Tull. Umístěte ukazatel myši na jakýkoli běžící projekt v seznamu Vzdálený nebo Místní a klikněte na ikonu zastavení.

Paleta uzlů MUSE Automator

Automator se dodává s naší vlastní paletou uzlů také s názvem MUSE Automator. V současné době je k dispozici sedm uzlů, které umožňují funkčnost a interakci se simulátorem a ovladači MUSE.

Ovladač
Uzel Controller poskytuje vašemu simulátoru toků nebo ovladači MUSE kontext a programový přístup k zařízením, která byla přidána do ovladače. Má následující pole, která lze konfigurovat:

Name – univerzální vlastnost názvu pro všechny uzly.

Controller – ovladač nebo simulátor, ke kterému se chcete připojit. Vyberte simulátor pro připojení k simulovanému ovladači MUSE. Chcete-li se připojit k fyzickému ovladači, ujistěte se, že je připojen k vaší síti, a zadejte jeho IP adresu do pole hostitele. Stiskněte tlačítko Connect pro připojení k ovladači.
Poskytovatelé – seznam ovladačů, které byly nahrány do vašeho simulátoru nebo ovladače. Stiskněte tlačítko Nahrát pro přidání ovladače. Vyberte ovladač a stiskněte Delete pro odstranění ovladače ze seznamu.
Zařízení – seznam zařízení, která byla přidána do simulátoru nebo ovladače.
- Upravit – Vyberte zařízení ze seznamu a kliknutím na Upravit upravte jeho vlastnosti
- Přidat – Kliknutím na toto tlačítko přidáte nové zařízení (na základě ovladačů v seznamu Poskytovatelé).
  - Instance – Při přidávání nového zařízení je vyžadován jedinečný název instance.
  - Název – volitelné. Název zařízení
  - Popis (Dobrovolný. Popis zařízení.
  - Ovladač – Vyberte příslušný ovladač (na základě ovladačů v seznamu Poskytovatelé).
- Odstranit – Vyberte zařízení ze seznamu a kliknutím na Odstranit zařízení odstraňte.

Postavení
Pomocí uzlu Stav získáte stav nebo stav konkrétního parametru zařízení.

Name – univerzální vlastnost názvu pro všechny uzly.
Zařízení – vyberte zařízení (na základě seznamu Zařízení v uzlu Controller). Tím se vygeneruje strom parametrů v seznamu níže. Vyberte parametr pro načtení stavu.
Parametr – Pole pouze pro čtení, které zobrazuje cestu parametru zvoleného parametru.

Událost
Použijte uzel Event k naslouchání událostem zařízení, jako jsou změny stavu, ke spuštění akce (jako je příkaz)

Name – univerzální vlastnost názvu pro všechny uzly.

Zařízení – vyberte zařízení (na základě seznamu Zařízení v uzlu Controller). Tím se vygeneruje strom parametrů v seznamu níže. Vyberte parametr ze seznamu.
Událost – Pole pouze pro čtení, které zobrazuje cestu parametru
Event Type – Typ události vybraného parametru pouze pro čtení.

Typ parametru – Datový typ vybraného parametru pouze pro čtení.
Událost (neoznačená) – Rozbalovací pole se seznamem událostí, které lze poslouchat

Příkaz
Použijte uzel Příkaz k odeslání příkazu do zařízení.

Name – univerzální vlastnost názvu pro všechny uzly.
Zařízení – vyberte zařízení (na základě seznamu Zařízení v uzlu Controller). Tím se vygeneruje strom parametrů v seznamu níže. Zobrazí se pouze parametry, které lze nastavit.

Selected – Pole pouze pro čtení, které zobrazuje cestu parametru.
Vstup – Zvolte Ruční konfiguraci, chcete-li v rozevíracím seznamu zobrazit dostupné příkazy, které lze provést.

Navigovat
Pomocí uzlu Navigovat proveďte převrácení stránky na dotykový panel TP5

Jméno – vlastnost univerzálního názvu pro všechny uzly.
Panel – Vyberte dotykový panel (přidaný prostřednictvím uzlu Ovládací panely)

Příkazy – Zvolte příkaz Převrátit
G5 – Upravitelný řetězec příkazu k odeslání. Vyberte stránku z vygenerovaného seznamu stránek panelu, aby se toto pole naplnilo.

Ovládací panel
Použijte uzel Ovládací panely k přidání kontextu dotykového panelu do toku.

Name – univerzální vlastnost názvu pro všechny uzly.
Zařízení – Vyberte zařízení s dotykovým panelem

Panel – Klepnutím na tlačítko Procházet nahrajte soubor .TP5. Tím se vygeneruje strom stránek souborů dotykového panelu a tlačítek pouze pro čtení. Odkazujte na tento seznam jako na ověření souboru.

Ovládání uživatelského rozhraní
Použijte uzel UI Control k programování tlačítek nebo jiných ovládacích prvků ze souboru dotykového panelu.

Jméno – vlastnost univerzálního názvu pro všechny uzly.
Zařízení – Vyberte zařízení s dotykovým panelem
Typ – Vyberte typ ovládání uživatelského rozhraní. Vyberte ovládací prvek uživatelského rozhraní ze stromu stránky/tlačítka níže

Spoušť – Vyberte spouštěč pro ovládání uživatelského rozhraní (napřample, PUSH nebo RELEASE)
Stát – Nastavte stav ovládacího prvku uživatelského rozhraní při jeho spuštění (napřample, ON nebo OFF)

Example Pracovní postup

V tomto examppodle pracovního postupu uděláme:

Připojte k ovladači MUSE
Vytvořte tok, který nám umožní přepínat stav relé na MU-2300

Nasaďte tok na náš místní server Node-RED

Připojte se k ovladači MUSE

Nastavte ovladač MUSE. Viz dokumentace na

Přetáhněte uzel Controller z palety uzlů MUSE Automator na plátno a poklepáním na něj otevřete jeho dialogové okno pro úpravy.
Zadejte IP adresu ovladače MUSE a stiskněte tlačítko Připojit a poté tlačítko Hotovo.
Poté stiskněte tlačítko Deploy. Váš dialog a uzel Controller by měl vypadat takto:

Sestavte a nasaďte tok

Dále začněme vytvářet tok přetažením několika uzlů na plátno. Přetáhněte následující uzly a umístěte je v pořadí zleva doprava:
- Injekce
- Postavení
- Přepínač (pod paletou funkcí)
- Příkaz (přetáhněte dva)
- Ladit
Dvakrát klikněte na uzel Inject a změňte jeho název na „Manual Trigger“ a stiskněte Hotovo
Poklepejte na uzel Stav a upravte následující vlastnosti:
- Změňte jeho název na „Získat stav relé 1“
- Z rozbalovací nabídky Zařízení vyberte idevice
- Rozbalte uzel listu relé ve stromu a vyberte 1 a poté uveďte
- Stiskněte Hotovo
Poklepejte na uzel Přepnout a upravte následující vlastnosti:
- Změňte název na „Zkontrolovat stav relé 1“
- Klikněte na tlačítko +přidat v dolní části dialogu. Nyní byste měli mít v seznamu dvě pravidla. Jeden ukazuje na 1 port a dva body na 2 port
- Do prvního pole zadejte true a nastavte typ na výraz
- Do druhého pole zadejte false a nastavte typ na výraz
- Vlastní přepínací uzel by měl vypadat takto:
Dvakrát klikněte na první uzel Command a upravte následující vlastnosti:
- Změňte název na „Set Relay 1 False“
- Z rozbalovací nabídky Zařízení vyberte idevice
- Rozbalte uzel přenosového listu ve stromu a vyberte 1 a poté uveďte a stiskněte Hotovo
Poklepejte na druhý uzel Command a upravte následující vlastnosti:
- Změňte název na „Set Relay 1 True“
- Z rozbalovací nabídky Zařízení vyberte idevice
- Rozbalte uzel přenosového listu ve stromu a vyberte 1 a poté uveďte a stiskněte Hotovo
Propojte všechny uzly dohromady takto:
- Vložit uzel do uzlu Status
- Stavový uzel na uzel Switch
- Přepněte port uzlu 1 na příkazový uzel s názvem „Set Relay 1 False“
- Přepněte port uzlu 2 na příkazový uzel s názvem „Set Relay 1 True“
- Připojte oba uzly příkazu k uzlu ladění

Jakmile dokončíte konfiguraci a zapojení vašeho uzlu, vaše tokové plátno by mělo vypadat nějak takto:

Nyní jste připraveni nasadit svůj tok. V pravém horním rohu aplikace klikněte na tlačítko Deploy a nasaďte svůj tok na místní server Node-RED. Pokud jste připojeni k ovladači MUSE, měli byste být nyní schopni nepřetržitě mačkat tlačítko na injektovém uzlu a v podokně ladění vidět, jak se stav relé mění z true na false (a vidět/slyšet spínání relé samotného ovladače! ).

Další zdroje

Kanál AMX YouTube – http://www.youtube.com/@AMXbyHARMAN
Zdroje pro vývojáře AMX – http://developer.amx.com/#!/main
Kanál YouTube Node-RED – http://www.youtube.com/@Node-RED
Dokumentace Node-RED – http://nodered.org/docs/

© 2024 Harman. Všechna práva vyhrazena. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD a HARMAN a jejich příslušná loga jsou registrované ochranné známky společnosti HARMAN. Oracle, Java a jakákoli jiná společnost nebo značka, na kterou se odkazuje, mohou být ochrannými známkami/registrovanými ochrannými známkami příslušných společností.

AMX nepřebírá odpovědnost za chyby nebo opomenutí. AMX si také vyhrazuje právo kdykoli změnit specifikace bez předchozího upozornění. Záruční a návratová politika AMX a související dokumenty mohou být viewed/staženo na www.amx.com.

3000 RESEARCH DRIVE, RICHARDSON, TX 75082 AMX.com
800.222.0193
469.624.8000
+1.469.624.7400 XNUMX XNUMX XNUMX
fax 469.624.7153
Poslední revize: 2024-03-01

Dokumenty / zdroje

Nízkokódová softwarová aplikace HARMAN Muse Automator [pdfNávod k obsluze
Softwarová aplikace Muse Automator s nízkým kódem, softwarová aplikace Automator s nízkým kódem, softwarová aplikace s nízkým kódem, softwarová aplikace s kódem, softwarová aplikace, aplikace

Reference

Uživatelská příručka

Nízkokódová softwarová aplikace HARMAN Muse Automator

Informace o produktu

Návod k použití produktu

Instalace a nastavení

Začínáme s MUSE Automator

Example Pracovní postup

Dokumenty / zdroje

Reference

Zanechte komentář

Zrušit odpověď