Ръководство с инструкции за софтуерно приложение с нисък код на HARMAN Muse Automator

Инсталирайте NodeJS и NPM, като следвате инструкциите, предоставени на: NodeJS
Ръководство за инсталиране.
Инсталирайте MUSE Automator на вашия компютър, като следвате съответните инструкции за инсталиране.

Актуализирайте фърмуера на MUSE Controller, наличен на amx.com.
Активирайте поддръжката на Node-RED в контролера MUSE, като следвате стъпките, споменати в ръководството.

Първи стъпки с MUSE Automator

Автоматични режими на работа

Режим на симулация
За да използвате Automator в режим на симулация:

Плъзнете възел на контролера към работното пространство.

Изберете „симулатор“ от падащото меню в диалоговия прозорец за редактиране.
Щракнете върху „Готово“ и разположете, за да видите състоянието на симулатора като свързан.

Добавете драйвери и устройства
Добавете съответните драйвери и устройства според вашите изисквания.

Свързан режим
За да използвате свързан режим:

Въведете адреса на вашия физически контролер MUSE в настройките на контролния възел.
Въведете потребителско име и парола за контролера.

Щракнете върху „Свързване“, за да установите връзка със сървъра Node-RED на контролера MUSE.

ЧЗВ

Q: Какво трябва да направя, ако MUSE Automator не работи правилно?
A: Уверете се, че сте инсталирали всички необходими зависимости и сте следвали инструкциите за инсталиране правилно. Обърнете се към поддръжката на клиенти за допълнителна помощ.

Q: Как да актуализирам фърмуера на MUSE Controller?
A: Можете да актуализирате фърмуера, като изтеглите най-новата версия от amx.com и следвате предоставените инструкции за актуализиране на фърмуера.

Инсталиране и настройка

MUSE Automator е софтуерно приложение без код/с нисък код, предназначено за използване с контролери AMX MUSE. Той е изграден върху Node-RED, широко използван инструмент за програмиране, базиран на потока.

Предпоставки
Преди да инсталирате MUSE Automator, трябва да инсталирате няколко зависимости, посочени по-долу. Ако тези зависимости не са инсталирани първо, Automator няма да работи правилно.

Инсталирайте NodeJS (v20.11.1+) & Node Package Manager (NPM) (v10.2.4+) Automator е персонализирана версия на софтуера Node-RED, така че изисква NodeJS да работи на вашата система. Той също така изисква Node Package Manager (NPM), за да може да инсталира възли на трети страни. За да инсталирате NodeJS и NPM, отидете на следната връзка и следвайте инструкциите за инсталиране: https://docs.npmis.com/downloading-and=installing-node-is-and-npm
Инсталирайте Git (v2.43.0+)
Git е система за контрол на версиите. За Automator той активира функцията Project, така че да можете да организирате своите потоци в отделни проекти. Той също така позволява функционалността Push/Pull, необходима за разгръщане на вашите потоци към физически MUSE контролер. За да инсталирате Git, отидете на следната връзка и следвайте инструкциите: https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

Забележка: Инсталаторът на Git ще ви преведе през серия от опции за инсталиране. Препоръчително е да използвате опциите по подразбиране и препоръчаните от инсталатора. Моля, вижте документацията на Git за повече информация.

Инсталирайте MUSE Automator
След като инсталирате Git, NodeJS и NPM, можете да инсталирате MUSE Automator. Инсталирайте MUSE Automator на вашия компютър с Windows или MacOS и следвайте съответните инструкции за инсталиране.

Инсталирайте фърмуера на контролера MUSE
За да използвате MUSE Automator с контролер AMX MUSE, ще трябва да актуализирате фърмуера на контролера MUSE, наличен на amx.com.

Активирайте поддръжката на Node-RED в MUSE Controller
Node-RED е деактивиран на контролера MUSE по подразбиране. Трябва да се активира ръчно. За да направите това, влезте във вашия контролер MUSE и отворете System > Extensions. В списъка с налични разширения превъртете надолу до mojonodred и щракнете върху него, за да го изберете. Натиснете бутона Инсталиране, за да инсталирате разширението Node-RED и да позволите на контролера да се актуализира. Вижте екранната снимка по-долу за справка:

Друга информация
Ако имате активирана защитна стена на вашия компютър, ще трябва да се уверите, че имате отворен порт 49152, за да може Automator да комуникира правилно през този порт.

Първи стъпки с MUSE Automator

Запознайте се с Node-RED
Тъй като Automator е по същество персонализирана версия на Node-RED, първо трябва да се запознаете с приложението Node-RED. Софтуерът има относително плитка крива на обучение. Има стотици статии и видеоклипове с инструкции за изучаване на Node-RED, но добро място да започнете е в документацията на Node-RED: https://nodered.org/docs. По-специално, прочетете уроците, готварската книга и потоците за разработване, за да се запознаете с функциите и потребителския интерфейс на приложението.

Това ръководство няма да обхваща основите на Node-RED или базираното на поток програмиране, така че е наложително даview официалната документация на Node-RED, преди да започнете.

Интерфейсът на автоматизатора приключиview
Интерфейсът на редактора на Automator е по същество същият като редактора по подразбиране Node-RED с някои настройки на темите и някои персонализирани функции, които позволяват взаимодействие между редактора и контролера на MUSE.

MUSE Automator Palette – потребителски възли за работа с HARMAN устройства
Раздел Flow – За превключване между views на множество потоци
Работно пространство – където изграждате вашите потоци. Плъзнете възли отляво и ги пуснете върху работното пространство
Push/Pull Tray – За управление на проекти локално или на контролер. Натиснете, издърпайте, стартирайте, спрете, изтрийте проект.
Бутон/тава за разгръщане – За разгръщане на потоци от редактора към локалния сървър Node-RED
Hamburger Menu – Главно меню на приложението. Създавайте проекти, отваряйте проекти, управлявайте потоци и т.н.

Автоматични режими на работа
Има три различни начина за работа с Automator. Това не са ограничителни „режими“ сами по себе си, а просто методи за използване на Automator. Тук използваме термина режим за простота.

Симулация – Потоците се разполагат локално и се изпълняват на симулатор на MUSE, така че можете да тествате без физически контролер.
Свързан – Вие сте свързани към физически контролер на MUSE и потоците се разгръщат и след това се изпълняват локално на компютър. Ако изключите Automator, потоците ще спрат да работят.
Самостоятелен – Вие сте прехвърлили вашите разгърнати потоци към контролер MUSE, за да работят независимо на контролера.
Независимо кой режим използвате, трябва да знаете кои устройства възнамерявате да контролирате или автоматизирате и след това да заредите съответните им драйвери или в симулатора, или във физически контролер. Методът за зареждане на драйвери към двете цели е много различен. Зареждането на драйвери в симулатора става в диалоговия прозорец за редактиране на възела на контролера на Automator (вижте Добавяне на драйвери и устройства). Зареждането на драйвери към контролер MUSE се извършва в контролера web интерфейс. За да научите повече относно зареждането на драйвери към вашия контролер MUSE, вижте документацията на адрес https://www.amx.com/products/mu-3300#downloads.

Режим на симулация
За да използвате Automator в режим на симулация, плъзнете възел на контролера в работното пространство и отворете неговия диалогов прозорец за редактиране. Изберете симулатор от падащото меню и щракнете върху бутона Готово. Вече можете да използвате възли, които имат достъп до крайните точки на симулаторното устройство.

Щракнете върху бутона Разполагане и трябва да видите състоянието на симулатора, посочено като свързано с плътно зелено индикаторно поле:

Добавете драйвери и устройства
Има няколко симулатора, които вече са вградени в Automator Controller Node:

Серия CE IO удължители: CE-IO4, CE-IRS4, CE-REL8, CE-COM2

Входно/изходни портове на контролера от серия MU: MU-1300, MU-2300, MU-3300
LED на предния панел на контролера от серията MU: MU-2300, MU-3300
Общо NetLinx ICSP устройство

За да добавите устройства към вашия симулатор:

Щракнете върху бутона Качване до списъка с доставчици. Това ще отвори диалоговия прозорец на вашата файлова система. Изберете съответния драйвер за желаното устройство. Забележка: следните типове драйвери могат да бъдат качени:
- DUET модули (Извличане от developer.amx.com)
- Родни драйвери на MUSE
  ° С. Симулаторни файлове
След като драйверът бъде качен, можете да добавите съответното устройство, като щракнете върху бутона Добавяне до списъка с устройства.

Свързан режим
Свързаният режим изисква да имате физически MUSE контролер във вашата мрежа, към който можете да се свържете. Отворете своя контролен възел и въведете адреса на вашия MUSE контролер. Портът е 80 и е зададен по подразбиране. Въведете потребителското име и паролата за вашия контролер и след това натиснете бутона Свързване. Трябва да видите известие, че Automator се е свързал със сървъра Node-RED на контролера MUSE. Вижте екранната снимка по-долу.

Самостоятелен режим
Този режим на работа с Automator просто включва прехвърляне на вашите потоци от вашия локален компютър към сървъра Node-RED, работещ на контролер MUSE. Това изисква проектите да бъдат активирани (което изисква инсталирането на git). Прочетете по-долу, за да научите повече за проектите и Push/Pull.

Внедряване
Всеки път, когато правите промяна в възел, ще трябва да внедрите тези промени от редактора към сървъра Node-RED, за да стартирате потоците. Има някои опции за това какво и как да разположите вашите потоци в падащото меню Разполагане. За да научите повече за внедряването в Node-RED, моля, вижте документацията за Node-RED.

При разгръщане в Automator, потоците се разгръщат към локалния сървър Node-RED, работещ на вашия компютър. След това разгърнатите потоци трябва да бъдат „избутани“ от вашия локален компютър към сървъра Node-RED, работещ на контролера MUSE.

Добър начин да определите дали имате някакви неразгърнати промени във вашите потоци/възли е в бутона Разполагане в горния десен ъгъл на приложението. Ако е сив и неинтерактивен, тогава нямате неразгърнати промени във вашите потоци. Ако е червен и интерактивен, тогава имате неразгърнати промени във вашите потоци. Вижте екранните снимки по-долу.

проекти
За Push/Pull от вашия локален Node-RED сървър към сървъра, работещ на вашия контролер, функцията Projects трябва да бъде активирана в Automator. Функцията за проекти се активира автоматично, ако git е инсталиран на вашия компютър. За да научите как да инсталирате git, вижте раздела Инсталиране на Git на това ръководство.
Ако приемем, че сте инсталирали git и сте рестартирали MUSE Automator, можете да създадете нов проект, като щракнете върху менюто за хамбургери в горния десен ъгъл на приложението.

Въведете име на проект (без интервали или специални знаци) и засега изберете опцията Деактивиране на шифроване под Идентификационни данни. Натиснете бутона Създаване на проект, за да завършите създаването на проекта.

Сега, след като сте създали проект, можете да Push/Pull към физически MUSE контролер.

Бутане/дърпане на проекти
Избутването и изтеглянето на вашите потоци от вашия компютър към сървъра Node-RED на контролер MUSE е уникална функция в Automator. Трябва да се извършат няколко стъпки, преди да можете да натиснете/дърпате

Уверете се, че сте свързани към вашия MUSE контролер чрез контролния възел
Уверете се, че сте разположили всички промени във вашите потоци (бутонът Разполагане трябва да е сив)

За да изтласкате вашите разгърнати потоци от вашия компютър, щракнете върху стрелката за натискане/издърпване надолу.

Задръжте курсора на мишката върху локалния проект и щракнете върху иконата за качване, за да преместите проекта от вашия локален сървър Node-RED към сървъра Node-RED на вашия контролер MUSE.

След като натиснете вашия локален проект към контролера, натиснете бутона Push/Pull (не стрелката) и проектът трябва да изглежда, че работи на контролера.
По същия начин проект, който е бил изпратен към контролер, може да бъде изтеглен от контролера към вашия компютър. Задръжте курсора на мишката над проекта Remote, щракнете върху иконата за изтегляне, за да изтеглите проекта.

Стартиране на проект
Проектите, които се изпълняват на контролера или се изпълняват на вашия локален сървър Node-RED, ще бъдат обозначени с етикет за изпълнение. За да изпълните различен проект на отдалечен или локален сървър, задръжте курсора на мишката над проекта и щракнете върху иконата за възпроизвеждане. Забележка: само един проект може да се изпълнява в даден момент на локално или отдалечено.

Изтриване на проект
За да изтриете проект, задръжте курсора на мишката над името на проекта под Локален или Отдалечен и щракнете върху иконата на кошчето. Предупреждение: внимавайте какво изтривате или може да загубите работа.

Спиране на проект

Може да има сценарии, при които искате да спрете или стартирате проект на Automator локално или отдалечено на контролера. Automator предоставя възможност за стартиране или спиране на всеки проект, ако е необходимо. За да спрете проект, щракнете, за да разгънете тавата Push/Pull. Задръжте курсора на мишката върху който и да е работещ проект в списъка Remote или Local и след това щракнете върху иконата за спиране.

MUSE Automator Node Palete

Automator се доставя с нашата собствена персонализирана палитра от възли, също озаглавена MUSE Automator. В момента има осигурени седем възела, които позволяват функционалност и взаимодействие със симулатора и контролерите MUSE.

Контролер
Възелът на контролера е това, което осигурява вашия симулатор на потоци или контекст на контролера MUSE и програмен достъп до устройствата, които са добавени към контролера. Той има следните полета, които могат да бъдат конфигурирани:

Име – свойство за универсално име за всички възли.

Контролер – контролерът или симулаторът, към който искате да се свържете. Изберете симулатор, за да се свържете със симулирания контролер MUSE. За да се свържете с физически контролер, уверете се, че е свързан към вашата мрежа и въведете неговия IP адрес в полето за хост. Натиснете бутона Connect, за да се свържете с контролера.
Доставчици – списъкът с драйвери, които са качени на вашия симулатор или контролер. Натиснете бутона Качване, за да добавите драйвер. Изберете драйвер и натиснете Delete, за да изтриете драйвер от списъка.
Устройства – списъкът с устройства, които са добавени към симулатора или контролера.
- Редактиране – Изберете устройство от списъка и щракнете върху Редактиране, за да редактирате свойствата му
- Добавяне – Щракнете, за да добавите ново устройство (на базата на драйверите в списъка с доставчици).
  - Екземпляр – При добавяне на ново устройство се изисква уникално име на екземпляр.
  - Име – по избор. Име за устройството
  - Описание – по избор. Описание за устройството.
  - Драйвер – Изберете подходящия драйвер (въз основа на драйверите в списъка с доставчици).
- Изтриване – Изберете устройство от списъка и щракнете върху Изтриване, за да изтриете устройството.

Статус
Използвайте възела Status, за да получите състоянието или състоянието на конкретен параметър на устройството.

Име – свойство за универсално име за всички възли.
Устройство – изберете устройството (въз основа на списъка Устройства в възела Контролер). Това ще генерира дърво с параметри в списъка по-долу. Изберете параметъра за извличане на статус.
Параметър – поле само за четене, което показва пътя на параметъра на избрания параметър.

Събитие
Използвайте възела Event, за да слушате събития на устройството, като промени в състоянието, за да задействате действие (като команда)

Име – свойство за универсално име за всички възли.

Устройство – изберете устройството (въз основа на списъка Устройства в възела Контролер). Това ще генерира дърво с параметри в списъка по-долу. Изберете параметър от списъка.
Събитие – поле само за четене, което показва пътя на параметъра
Тип събитие – Тип само за четене на избраното събитие на параметъра.

Тип параметър – Тип данни само за четене на избрания параметър.
Събитие (без етикет) – падащо поле със списък със събития, които могат да бъдат прослушани

командване
Използвайте командния възел, за да изпратите команда към устройство.

Име – свойство за универсално име за всички възли.
Устройство – изберете устройството (въз основа на списъка Устройства в възела Контролер). Това ще генерира дърво с параметри в списъка по-долу. Ще бъдат показани само параметри, които могат да бъдат зададени.

Избрано – поле само за четене, което показва пътя на параметъра.
Въвеждане – Изберете Ръчна конфигурация, за да видите наличните команди в падащото меню, които могат да бъдат изпълнени.

Навигирайте
Използвайте възела за навигация, за да извършите прелистване на страница към сензорен панел TP5

Име – свойство за универсално име за всички възли.
Панел – Изберете сензорния панел (добавен чрез възела на контролния панел)

Команди – Изберете командата Обръщане
G5 – Редактируем низ от командата за изпращане. Изберете страницата от генерирания списък с панелни страници, за да попълните това поле.

Контролен панел
Използвайте възела на контролния панел, за да добавите контекст на сензорния панел към потока.

Име – свойство за универсално име за всички възли.
Устройство – Изберете устройството със сензорен панел

Панел – Щракнете върху Преглед, за да качите .TP5 файл. Това ще генерира дърво само за четене на файловите страници и бутони на сензорния панел. Посочете този списък като проверка на файла.

Контрол на потребителския интерфейс
Използвайте контролния възел на потребителския интерфейс, за да програмирате бутони или други контроли от файла на сензорния панел.

Име – свойство за универсално име за всички възли.
устройство – Изберете устройството със сензорен панел
Тип – Изберете типа контрол на потребителския интерфейс. Изберете контролата на потребителския интерфейс от дървото на страницата/бутона по-долу

Тригер – Изберете тригера за контрола на потребителския интерфейс (напрample, PUSH или RELEASE)
състояние – Задайте състоянието на контролата на потребителския интерфейс, когато се задейства (напрample, ВКЛ. или ИЗКЛ.)

Example Работен поток

В този бившampработен процес, ние ще:

Свържете се с контролер MUSE
Създайте поток, който ни позволява да превключваме състоянието на реле на MU-2300

Разположете потока към нашия локален сървър Node-RED

Свържете се с MUSE Controller

Настройте своя MUSE контролер. Обърнете се към документацията на

Плъзнете възел на контролера от палитрата на възела на MUSE Automator към платното и щракнете двукратно върху него, за да отворите диалоговия прозорец за редактиране.
Въведете IP адреса на вашия контролер MUSE и натиснете бутона Свързване и след това бутона Готово.
След това натиснете бутона Deploy. Вашият диалогов прозорец и контролен възел трябва да изглеждат така:

Изградете и внедрите поток

След това нека започнем да изграждаме поток, като плъзгаме няколко възела към платното. Плъзнете следните възли и ги поставете в ред отляво надясно:
- Инжектирайте
- Статус
- Превключване (под функционалната палета)
- Команда (плъзнете две)
- Отстраняване на грешки
Щракнете двукратно върху възела Inject и променете името му на „Manual Trigger“ и натиснете Done
Щракнете двукратно върху възела Status и променете следните свойства:
- Променете името му на „Получаване на статус на реле 1“
- От падащото меню Устройство изберете idevice
- Разгънете листовия възел на релето в дървото и изберете 1 и след това състояние
- Натиснете Готово
Щракнете двукратно върху възела Switch и променете следните свойства:
- Променете името на „Проверете състоянието на реле 1“
- Щракнете върху бутона +добавяне в долната част на диалоговия прозорец. Сега трябва да имате две правила в списъка. Една точка към 1 порт и две точки към 2 порта
- Въведете true в първото поле и задайте типа израз
- Въведете false във второто поле и задайте типа израз
- Вашият превключващ възел трябва да изглежда така:
Щракнете двукратно върху първия команден възел и променете следните свойства:
- Променете името на „Set Relay 1 False“
- От падащото меню Устройство изберете idevice
- Разгънете листовия възел на релето в дървото и изберете 1 и след това посочете, след което натиснете Готово
Щракнете двукратно върху втория команден възел и променете следните свойства:
- Променете името на „Set Relay 1 True“
- От падащото меню Устройство изберете idevice
- Разгънете листовия възел на релето в дървото и изберете 1 и след това посочете, след което натиснете Готово
Свържете всички възли заедно така:
- Инжектирайте възел към възела на състоянието
- Възел за състояние към възела за превключване
- Превключете порт на възел 1 към командния възел с име „Задаване на реле 1 невярно“
- Превключете порт на възел 2 към командния възел, наречен „Set Relay 1 True“
- Свържете двата командни възела към възела за отстраняване на грешки

След като приключите с конфигурирането и окабеляването на вашия възел, вашето платно за поток трябва да изглежда така:

Вече сте готови да разгърнете своя поток. В горния десен ъгъл на приложението щракнете върху бутона Разполагане, за да разположите своя поток към локалния сървър Node-RED. Ако сте свързани към контролер MUSE, сега трябва да можете да натискате непрекъснато бутона на възела за инжектиране и да видите как състоянието на релето се променя от истинско на невярно в панела за отстраняване на грешки (и да видите/чуете превключването на релето на самия контролер! ).

Допълнителни ресурси

AMX YouTube канал – https://www.youtube.com/@AMXbyHARMAN
Ресурси за разработчици на AMX – https://developer.amx.com/#!/main
Канал Node-RED в YouTube – https://www.youtube.com/@Node-RED
Node-RED Документация – https://nodered.org/docs/

© 2024 Harman. Всички права запазени. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD и HARMAN и съответните им лога са регистрирани търговски марки на HARMAN. Oracle, Java и всяка друга посочена компания или марка може да са търговски марки/регистрирани търговски марки на съответните им компании.

AMX не поема отговорност за грешки или пропуски. AMX също си запазва правото да променя спецификациите без предизвестие по всяко време. Политиката за гаранция и връщане на AMX и свързаните с нея документи могат да бъдат viewизд./изтеглено на адрес www.amx.com.

3000 RESEARCH DRIVE, RICHARDSON, TX 75082 AMX.com
800.222.0193
469.624.8000
+1.469.624.7400
факс 469.624.7153
Последна редакция: 2024-03-01

Документи / Ресурси

HARMAN Muse Automator Софтуерно приложение с нисък код [pdf] Ръководство за употреба
Софтуерно приложение с нисък код Muse Automator, софтуерно приложение с нисък код Automator, софтуерно приложение с нисък код, софтуерно приложение с код, софтуерно приложение, приложение

Референции

Ръководство за потребителя

HARMAN Muse Automator Софтуерно приложение с нисък код

Информация за продукта

Инструкции за употреба на продукта

Инсталиране и настройка

Първи стъпки с MUSE Automator

Example Работен поток

Документи / Ресурси

Референции

Оставете коментар

Отказ от отговор