Софтверска апликација HARMAN Muse Automator низок код

Информации за производот

Спецификации

• Софтверска апликација без код / ​​низок код
• Дизајниран за употреба со контролорите AMX MUSE
• Изграден на алатка за програмирање базирана на проток на Node-RED
• Потребен е NodeJS (v20.11.1+) и менаџер на пакети на јазли (NPM) (v10.2.4+)
• Компатибилност: Windows или MacOS PC

Упатство за употреба на производот

Инсталација и поставување

Пред да го инсталирате MUSE Automator, проверете дали сте ги инсталирале потребните зависности:

1. Инсталирајте ги NodeJS и NPM следејќи ги упатствата дадени на: NodeJS
   Водич за инсталација.
2. Инсталирајте го MUSE Automator на вашиот компјутер следејќи ги соодветните инструкции за инсталерот.
3. Ажурирајте го фирмверот на MUSE Controller достапен на amx.com.
4. Овозможете ја поддршката Node-RED во контролорот MUSE следејќи ги чекорите споменати во прирачникот.

Започнување со MUSE Automator

Автоматски начини на работа

Режим на симулација
За да го користите Automator во режим на симулација:

1. Повлечете јазол на контролорот до работниот простор.
2. Изберете „симулатор“ од паѓачкото поле во дијалогот за уредување.
3. Кликнете на „Готово“ и распоредете го за да го видите статусот на симулаторот како поврзан.

Додадете драјвери и уреди
Додајте соодветни драјвери и уреди според вашите барања.

Поврзан режим
За да користите поврзан режим:

1. Внесете ја адресата на вашиот физички контролер MUSE во поставките за јазол на контролер.
2. Наведете корисничко име и лозинка за контролорот.
3. Кликнете на „Поврзи“ за да воспоставите врска со серверот Node-RED на контролорот MUSE.

Најчесто поставувани прашања

Q: Што треба да направам ако MUSE Automator не работи правилно?
A: Проверете дали сте ги инсталирале сите потребни зависности и правилно сте ги следеле упатствата за инсталација. Обратете се до поддршката за корисници за понатамошна помош.

Q: Како да го ажурирам фирмверот на MUSE Controller?
A: Можете да го ажурирате фирмверот со преземање на најновата верзија од amx.com и следејќи ги дадените упатства за ажурирање на фирмверот.

Инсталација и поставување

MUSE Automator е софтверска апликација без код/ниско-код дизајнирана за употреба со AMX MUSE контролери. Таа е изградена на Node-RED, широко користена алатка за програмирање базирана на проток.

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

1. Инсталирајте NodeJS (v20.11.1+) и Управувач со пакети со јазли (NPM) (v10.2.4+) Automator е приспособена верзија на софтверот Node-RED, така што бара NodeJS да работи на вашиот систем. Исто така, бара менаџерот на пакети на јазли (NPM) за да може да инсталира јазли од трета страна. За да инсталирате NodeJS и NPM, одете на следнава врска и следете ги инструкциите за инсталација: https://docs.npmis.com/downloading-and=installing-node-is-and-npm
2. Инсталирајте го 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 Controller
За да го користите MUSE Automator со контролер AMX MUSE, ќе треба да го ажурирате фирмверот на контролорот MUSE достапен на amx.com.

Овозможете поддршка Node-RED во контролерот MUSE
Node-RED е стандардно оневозможен на контролерот MUSE. Мора да се овозможи рачно. За да го направите ова, најавете се во вашиот MUSE контролер и одете до Систем > Екстензии. Во списокот Достапни екстензии, скролувајте надолу до 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.

1. MUSE Automator Palette – прилагодени јазли за работа со уреди HARMAN
2. Проток таб – За префрлување помеѓу views од повеќекратни текови
3. Работен простор - каде што ги градите вашите текови. Повлечете ги јазлите од лево и спуштете ги на работниот простор
4. Послужавник за туркање/влечење – За управување со проекти локално или на контролер. Притиснете, повлечете, започнете, застанете, избришете проект.
5. Копче за распоредување/фиока – за распоредување текови од уредувачот до локалниот сервер Node-RED
6. Мени за хамбургер – Главно мени на апликацијата. Креирајте проекти, отворајте проекти, управувајте со тековите итн.

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

1. Симулација - Протоците се распоредени локално и се извршуваат на симулатор MUSE за да можете да тестирате без физички контролер.
2. Поврзано – Вие сте поврзани со физички контролер MUSE и тековите се распоредени, а потоа се извршуваат локално на компјутер. Ако го исклучите Automator, тековите ќе престанат да работат.
3. Самостојни - ги турнавте вашите распоредени текови до контролорот MUSE за да работат независно на контролерот.
   Без оглед на тоа кој режим го користите, треба да знаете кои уреди сакате да ги контролирате или автоматизирате, а потоа да ги вчитате нивните соодветни драјвери или на симулаторот или на физичкиот контролер. Начинот за вчитување на драјверите на која било цел е многу различен. Вчитувањето на драјверите во симулаторот се случува во дијалогот за уредување јазол на контролорот на автоматиката (видете Додавање драјвери и уреди). Вчитувањето на драјверите на контролерот MUSE се врши во контролерот web интерфејс. За да дознаете повеќе за вчитување драјвери на вашиот MUSE контролер, погледнете ја документацијата на https://www.amx.com/products/mu-3300#downloads.

Режим на симулација
За да го користите Automator во режим на симулација, повлечете го јазолот на контролорот во работниот простор и отворете го неговиот дијалог за уредување. Изберете симулатор од паѓачкото поле и кликнете на копчето Готово. Сега можете да користите јазли кои можат да пристапат до крајните точки на уредот за симулатор.

Кликнете на копчето Deploy и треба да го видите статусот на симулаторот означен како поврзан со цврсто зелено поле за индикатор:

Додадете драјвери и уреди
Постојат неколку симулатори веќе вградени во јазолот на контролорот на автоматиката:

• Проширувачи на IO серии CE: CE-IO4, CE-IRS4, CE-REL8, CE-COM2
• В/И порти на контролер од серијата MU: MU-1300, MU-2300, MU-3300
• ЛЕД на предниот панел на контролер од серијата MU: MU-2300, MU-3300
• Генерички уред NetLinx ICSP

За да додадете уреди на вашиот симулатор:

1. Кликнете на копчето Постави веднаш до списокот со провајдери. Ова ќе го отвори дијалогот за вашиот датотечен систем. Изберете го соодветниот двигател за наменетиот уред. Забелешка: следниве типови драјвери може да се подигнат:
   • DUET модули (преземете од developer.amx.com)
   • Домашни двигатели на MUSE
     в. Симулаторни датотеки
2. Откако ќе се постави драјверот, можете да го додадете соодветниот уред со кликнување на копчето Додај веднаш до списокот Уреди.

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

Самостоен режим
Овој начин на работа со Automator едноставно вклучува туркање на вашите текови од вашиот локален компјутер до серверот Node-RED кој работи на MUSE контролер. Ова бара да се овозможат Проекти (што бара инсталација на git). Прочитајте подолу за да дознаете повеќе за проекти и Push/Pull.

Распоредување
Секогаш кога ќе направите промена на јазол, ќе треба да ги распоредите тие промени од уредувачот на серверот Node-RED за да ги активирате тековите. Постојат неколку опции за тоа што и како да ги распоредите вашите текови во паѓачкото мени Deploy. За да дознаете повеќе за распоредувањето во Node-RED, погледнете ја документацијата Node-RED.

Кога се распоредува во Automator, тековите се распоредуваат на локалниот сервер Node-RED што работи на вашиот компјутер. Потоа, распоредените текови мора да се „турнат“ од вашиот локален компјутер до серверот Node-RED што работи на контролорот MUSE.

Добар начин да одредите дали имате некакви нераспоредени промени во вашите текови/јазли е во копчето Deploy во горниот десен агол на апликацијата. Ако е сиво и неинтерактивно, тогаш немате нераспоредени промени во вашите текови. Ако е црвено и интерактивно, тогаш имате нераспоредени промени во вашите текови. Погледнете ги сликите од екранот подолу.

Проекти
За да притиснете/повлечете од вашиот локален Node-RED сервер до серверот што работи на вашиот контролер, функцијата Проекти треба да биде овозможена во Automator. Функцијата Projects автоматски се вклучува доколку git е инсталиран на вашиот компјутер. За да дознаете како да инсталирате git, видете го делот Install Git од ова упатство.
Претпоставувајќи дека сте го инсталирале git и сте го рестартирале MUSE Automator, можете да креирате нов проект со кликнување на менито за хамбургер во горниот десен агол на апликацијата.

Внесете име на проектот (не се дозволени празни места или специјални знаци) и засега, изберете ја опцијата Оневозможи шифрирање под Ингеренциите. Притиснете го копчето Креирај проект за да го завршите креирањето на проектот.

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

Проекти за туркање/влечење
Туркањето и повлекувањето на вашите текови од вашиот компјутер до серверот Node-RED на контролерот MUSE е единствена карактеристика во Automator. Треба да се направат неколку чекори пред да можете да туркате/влечете

1. Проверете дали сте поврзани со вашиот MUSE контролер преку јазолот Controller
2. Осигурајте се дека сте примениле какви било промени во вашите текови (копчето Deploy треба да биде сиво)

За да ги истуркате распоредените текови од вашиот компјутер, кликнете на стрелката Push/pull down.

Лебдите над проектот Локален и кликнете на иконата за поставување за да го турнете проектот од вашиот локален Node-RED сервер до серверот Node-RED на вашиот контролер MUSE.

Откако ќе го притиснете вашиот локален проект до контролорот, притиснете го копчето Push/Pull (не стрелката) и ќе изгледа дека проектот работи на контролерот.
На ист начин, проект кој е префрлен на контролер, може да се повлече од контролорот до вашиот компјутер. Лебдете над проектот Далечински, кликнете на иконата за преземање за да го повлечете проектот.

Водете проект
Проектите што се извршуваат на контролорот или работат на вашиот локален Node-RED сервер ќе бидат означени со ознака за извршување. За да извршите различен проект или на далечинскиот сервер или на локалниот сервер, поставете леб над проектот и кликнете на иконата за репродукција. Забелешка: само еден проект може да работи во исто време на Локално или Далечинско.

Избришете проект
За да избришете проект, лебди над името на проектот под Локално или Далечински и кликнете на иконата за корпа за отпадоци. Предупредување: бидете внимателни за тоа што го бришете, или може да изгубите работа.

Запирање на проект

Може да има сценарија каде што сакате да го запрете или започнете проектот Automator локално или од далечина на контролерот. Automator обезбедува можност за започнување или запирање на кој било проект по потреба. За да запрете проект, кликнете за да ја проширите фиоката Push/Pull. Лебдите над кој било проект кој работи во списокот Далечински или Локален и потоа кликнете на иконата за стоп.

MUSE Automator Palete јазли 

Automator испорачува со нашата сопствена палета на јазли, исто така насловена како MUSE Automator. Во моментов се обезбедени седум јазли кои овозможуваат функционалност и интеракција со симулаторот и контролорите MUSE.

Контролор
Јазолот Controller е она што го обезбедува вашиот симулатор на текови или контекст на контролорот MUSE и програмски пристап до уредите што се додадени на контролерот. Ги има следните полиња што може да се конфигурираат:

• Име – својство на универзално име за сите јазли.
• Контролор – контролер или симулатор на кој сакате да се поврзете. Изберете симулатор за поврзување со симулираниот контролер MUSE. За да се поврзете со физички контролер, проверете дали е поврзан на вашата мрежа и внесете ја нејзината IP адреса во полето за домаќин. Притиснете го копчето Поврзи за да се поврзете со контролорот.
• Даватели – список на драјвери што се поставени на вашиот симулатор или контролер. Притиснете го копчето Upload за да додадете драјвер. Изберете драјвер и притиснете Delete за да избришете драјвер од списокот.
• Уреди - список на уреди што се додадени на симулаторот или контролорот.
  • Уреди – Изберете уред од списокот и кликнете Уреди за да ги уредите неговите својства
  • Додај – Кликнете за да додадете нов уред (врз основа на драјверите во списокот на провајдери).
    • Пример – Кога додавате нов уред, потребно е единствено име на пример.
    • Име - Изборно. Име за уредот
    • Опис (опционално. Опис за уредот.
    • Возач – Изберете го соодветниот двигател (врз основа на двигателите во списокот на добавувачи).
  • Избриши – Изберете уред од списокот и кликнете Избриши за да го избришете уредот.

Статус
Користете го јазолот Статус за да го добиете статусот или состојбата на одреден параметар на уредот.

• Име – својство на универзално име за сите јазли.
• Уред – изберете го уредот (врз основа на списокот Уреди во јазолот Контролор). Ова ќе генерира дрво за параметри во списокот подолу. Изберете го параметарот за враќање на статусот.
• Параметар – поле само за читање кое ја прикажува патеката на параметарот на избраниот параметар.

Настан
Користете го јазолот настан за да слушате настани на уредот, како што се промените во состојбата за активирање на дејство (како команда)

• Име – својство на универзално име за сите јазли.
• Уред – изберете го уредот (врз основа на списокот Уреди во јазолот Контролор). Ова ќе генерира дрво за параметри во списокот подолу. Изберете параметар од списокот.
• Настан – Поле само за читање кое ја прикажува патеката на параметарот
• Вид на настан – Тип само за читање на избраниот параметар настан.
• Тип на параметар – Тип на податоци само за читање на избраниот параметар.
• Настан (неозначен) – паѓачко поле со список на настани што може да се слушаат

Команда
Користете го Command јазолот за да испратите команда до уред.

• Име – својство на универзално име за сите јазли.
• Уред – изберете го уредот (врз основа на списокот Уреди во јазолот Контролор). Ова ќе генерира дрво за параметри во списокот подолу. Ќе се прикажат само параметрите што може да се постават.
• Избрано – поле само за читање кое ја прикажува патеката на параметарот.
• Внесување – Изберете Рачна конфигурација за да ги видите достапните команди во паѓачкото поле што може да се изврши.

Навигација
Користете го јазолот Навигација за да извршите превртување на страницата на панел на допир TP5

• Име – својство на универзално име за сите јазли.
• Панел – Изберете го панелот на допир (додаден преку јазолот на контролната табла)
• Наредби – Изберете ја командата Flip
• G5 – Низа од командата за испраќање што може да се уредува. Изберете ја страницата од генерираната листа на страници на панелот за да го пополните ова поле.

Контролен панел
Користете го јазолот на контролната табла за да додадете контекст на панелот на допир на протокот.

• Име – својство на универзално име за сите јазли.
• Уред – Изберете го уредот со панел на допир
• Панел – Кликнете на Прелистување за да испратите датотека .TP5. Ова ќе генерира дрво само за читање на страниците и копчињата со датотеки на панелот за допир. Наведете ја оваа листа како потврда на датотеката.

Контрола на UI
Користете го јазолот за контрола на интерфејсот за програмирање копчиња или други контроли од датотеката на панелот на допир.

• Име – својство на универзално име за сите јазли.
• Уред – Изберете го уредот со панел на допир
• Тип – Изберете го типот на контрола на UI. Изберете ја контролата на корисничкиот интерфејс од дрвото на страница/копчиња подолу
• Активирање – Изберете го активирањето за контролата на UI (на прample, PUSH или RELESE)
• држава – Поставете ја состојбата на контролата на UI кога ќе се активира (на прampле, ВКЛУЧЕНО или ИСКЛУЧЕНО)

ExampРаботен тек

Во овој ексampна работниот тек, ќе:

• Поврзете се со контролер MUSE
• Изградете проток што ни овозможува да ја промениме состојбата на релето на MU-2300
• Распоредете го протокот на нашиот локален сервер Node-RED

Поврзете се со контролорот MUSE 

1. Поставете го вашиот MUSE контролер. Видете ја документацијата на
2. Повлечете јазол на контролорот од палетата на јазли MUSE Automator на платното и кликнете двапати на него за да го отворите неговиот дијалог за уредување.
3. Внесете ја IP адресата на вашиот контролер MUSE и притиснете го копчето Поврзи, а потоа копчето Готово.
   Потоа притиснете го копчето Deploy. Вашиот дијалог и јазол на контролорот треба да изгледаат вака:

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

1. Следно, да започнеме да градиме проток со влечење неколку јазли на платното. Повлечете ги следните јазли и поставете ги по редослед од лево кон десно:
   • Инјектирајте
   • Статус
   • Префрли (под палетата на функции)
   • Команда (влечете два)
   • Отстранување грешки
2. Кликнете двапати на јазолот Inject и променете го неговото име во „Manual Trigger“ и притиснете Done
3. Кликнете двапати на јазолот Статус и изменете ги следните својства:
   • Променете го неговото име во „Добиј статус на реле 1“
   • Од паѓачкото мени Уред, изберете idevice
   • Проширете го јазолот на листот на релето во стеблото и изберете 1 и потоа наведете
   • Притиснете Готово
4. Кликнете двапати на јазолот Switch и изменете ги следните својства:
   • Променете го името во „Проверете го статусот на релето 1“
   • Кликнете на копчето +додај на дното на дијалогот. Сега треба да имате две правила во списокот. Една точка на 1 порта и две точки на 2 порта
   • Внесете true во првото поле и поставете го типот на израз
   • Внесете false во второто поле и поставете го типот на израз
   • Вашиот прекинувачки јазол треба да изгледа вака:
5. Кликнете двапати на првиот команден јазол и изменете ги следните својства:
   • Променете го името во „Постави реле 1 неточно“
   • Од паѓачкото мени Уред, изберете idevice
   • Проширете го јазолот на листот на релето во стеблото и изберете 1, а потоа наведете, потоа притиснете Готово
6. Кликнете двапати на вториот Command јазол и изменете ги следните својства:
   • Променете го името во „Постави реле 1 точно“
   • Од паѓачкото мени Уред, изберете idevice
   • Проширете го јазолот на листот на релето во стеблото и изберете 1, а потоа наведете, потоа притиснете Готово
7. Поврзете ги сите јазли заедно вака:
   • Инјектирајте јазол во јазолот Статус
   • Статусниот јазол на јазолот Switch
   • Префрлете ја порта 1 на јазолот во командниот јазол наречен „Постави реле 1 неточно“
   • Префрлете ја јазолската порта 2 на командниот јазол наречен „Постави реле 1 True“
   • Поврзете ги двата командни јазли во јазолот за отстранување грешки

Откако ќе завршите со конфигурирање и поврзување на вашиот јазол, вашето платно со проток треба да изгледа вака:

Сега сте подготвени да го активирате вашиот тек. Во горниот десен агол, на апликацијата кликнете на копчето Deploy за да го распоредите вашиот проток на локалниот сервер Node-RED. Ако сте поврзани со контролер MUSE, сега треба да можете постојано да го притискате копчето на јазолот за инјектирање и да ја видите состојбата на релето што се менува од точно во неточно во окното за отстранување грешки (и да го видите/слушате релето како се вклучува самиот контролер! ).

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

• AMX канал на YouTube - htps://www.youtube.com/@AMXbyHARMAN
• AMX ресурси за програмери - htps://developer.amx.com/#!/main
• Јазол-РЕД канал на YouTube - htps://www.youtube.com/@Node-RED
• Node-RED документација - htps://nodered.org/docs/

© 2024 Харман. Сите права се задржани. 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, софтверска апликација со ниски кодови, апликација за софтвер за кодови, софтверска апликација, апликација

Референци

• Упатство за употреба