Програмне забезпечення HARMAN Muse Automator Low Code

Інформація про продукт

Технічні характеристики

• Програмне забезпечення без коду/з низьким кодом
• Призначений для використання з контролерами AMX MUSE
• Створено на основі потокового інструменту програмування Node-RED
• Потрібен NodeJS (v20.11.1+) і Node Package Manager (NPM) (v10.2.4+)
• Сумісність: ПК з Windows або MacOS

Інструкція з використання продукту

Встановлення та налаштування

Перед встановленням MUSE Automator переконайтеся, що ви встановили необхідні залежності:

1. Встановіть NodeJS і NPM, дотримуючись інструкцій, наведених на: NodeJS
   Керівництво по установці.
2. Встановіть MUSE Automator на свій ПК, дотримуючись відповідних інструкцій інсталятора.
3. Оновіть мікропрограму контролера MUSE, доступну на amx.com.
4. Увімкніть підтримку Node-RED у контролері MUSE, дотримуючись кроків, зазначених у посібнику.

Початок роботи з MUSE Automator

Режими роботи автомата

Режим моделювання
Щоб використовувати Automator у режимі моделювання:

1. Перетягніть вузол контролера в робочу область.
2. Виберіть «симулятор» зі спадного списку в діалоговому вікні редагування.
3. Натисніть «Готово» та розгорніть, щоб побачити статус симулятора як підключеного.

Додайте драйвери та пристрої
Додайте відповідні драйвери та пристрої відповідно до ваших вимог.

Режим підключення
Щоб використовувати режим підключення:

1. Введіть адресу вашого фізичного контролера MUSE у налаштуваннях вузла контролера.
2. Введіть ім’я користувача та пароль для контролера.
3. Натисніть «Підключитися», щоб встановити з’єднання з сервером Node-RED на контролері MUSE.

FAQ

Q: Що робити, якщо MUSE Automator не працює належним чином?
A: Переконайтеся, що ви встановили всі необхідні залежності та правильно дотримувалися інструкцій зі встановлення. Зверніться до служби підтримки клієнтів для подальшої допомоги.

Q: Як оновити мікропрограму контролера MUSE?
A: Ви можете оновити мікропрограму, завантаживши останню версію з amx.com і виконавши надані інструкції щодо оновлення мікропрограми.

Встановлення та налаштування

MUSE Automator — це програмне забезпечення без коду/з низьким кодом, призначене для використання з контролерами AMX MUSE. Він побудований на основі Node-RED, широко використовуваного потокового інструменту програмування.

передумови
Перш ніж інсталювати MUSE Automator, ви повинні встановити кілька залежностей, описаних нижче. Якщо ці залежності не встановити спочатку, Automator не працюватиме належним чином.

1. Інсталяція 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
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
Щоб використовувати MUSE Automator із контролером AMX MUSE, вам потрібно оновити мікропрограму контролера MUSE, доступну на amx.com.

Увімкніть підтримку Node-RED у контролері MUSE
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.

1. MUSE Automator Palette – користувацькі вузли для роботи з пристроями HARMAN
2. Вкладка Flow – для перемикання між views кількох потоків
3. Робочий простір – де ви будуєте свої потоки. Перетягніть вузли зліва на робочу область
4. Push/Pull Tray – для керування проектами локально або на контролері. Натисніть, потягніть, запустіть, зупиніть, видаліть проект.
5. Кнопка/лоток розгортання – для розгортання потоків із редактора на локальний сервер Node-RED
6. Гамбургерне ​​меню – головне меню програми. Створюйте проекти, відкривайте проекти, керуйте потоками тощо.

Режими роботи автомата
Є три різні способи роботи з Automator. Це не обмежувальні «режими» як такі, а лише методи використання Automator. Ми використовуємо тут термін режим для простоти.

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

Режим моделювання
Щоб використовувати Automator у режимі симуляції, перетягніть вузол контролера в робочу область і відкрийте його діалогове вікно редагування. Виберіть симулятор зі спадного списку та натисніть кнопку Готово. Тепер ви можете використовувати вузли, які мають доступ до кінцевих точок симулятора.

Натисніть кнопку «Розгорнути», і ви побачите стан симулятора, позначений як «підключений» із суцільним зеленим полем індикатора:

Додайте драйвери та пристрої
Є кілька симуляторів, які вже вбудовані в Automator Controller Node:

• Розширювачі вводу/виводу серії 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 і встановлено за замовчуванням. Введіть ім’я користувача та пароль для вашого контролера, а потім натисніть кнопку Connect. Ви повинні побачити сповіщення про підключення Automator до сервера Node-RED на контролері MUSE. Дивіться знімок екрана нижче.

Автономний режим
Цей режим роботи з Automator просто передбачає передачу ваших потоків з локального ПК на сервер Node-RED, який працює на контролері MUSE. Для цього потрібно ввімкнути Projects (що потребує встановлення git). Прочитайте нижче, щоб дізнатися більше про проекти та Push/Pull.

Розгортання
Щоразу, коли ви вносите зміни у вузол, вам потрібно буде розгорнути ці зміни з редактора на сервері Node-RED, щоб запустити потоки. У розкривному меню «Розгорнути» є кілька варіантів того, що та як розгортати ваші потоки. Щоб дізнатися більше про розгортання в Node-RED, перегляньте документацію Node-RED.

Під час розгортання в Automator потоки розгортаються на локальному сервері Node-RED, який працює на вашому ПК. Потім розгорнуті потоки необхідно «виштовхнути» з вашого локального ПК на сервер Node-RED, який працює на контролері MUSE.

Хороший спосіб визначити, чи є у вас якісь нерозгорнуті зміни у ваших потоках/вузлах, можна за допомогою кнопки Розгорнути у верхньому правому куті програми. Якщо він неактивний і неактивний, це означає, що у ваших потоках немає нерозгорнутих змін. Якщо він червоний і інтерактивний, це означає, що у ваших потоках є нерозгорнуті зміни. Перегляньте скріншоти нижче.

Проекти
Для Push/Pull з локального сервера Node-RED на сервер, який працює на контролері, у Automator потрібно ввімкнути функцію Projects. Функція «Проекти» вмикається автоматично, якщо на вашому ПК встановлено git. Щоб дізнатися, як інсталювати git, перегляньте розділ «Встановлення Git» цього посібника.
Якщо ви встановили git і перезапустили MUSE Automator, ви можете створити новий проект, натиснувши меню гамбургера у верхньому правому куті програми.

Введіть назву проекту (пробіли та спеціальні символи не допускаються), а поки виберіть параметр Вимкнути шифрування в розділі Облікові дані. Натисніть кнопку «Створити проект», щоб завершити створення проекту.

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

Проштовхування/тягнення проектів
Пересилання та перетягування ваших потоків з ПК на сервер Node-RED на контролері MUSE є унікальною функцією Automator. Потрібно виконати кілька кроків, перш ніж ви зможете штовхати/тягнути

1. Переконайтеся, що ви підключені до свого контролера MUSE через вузол Controller
2. Переконайтеся, що ви розгорнули будь-які зміни у своїх потоках (кнопка «Розгорнути» має бути неактивною)

Щоб перемістити розгорнуті потоки з комп’ютера, натисніть стрілку Push/Pull вниз.

Наведіть курсор миші на локальний проект і клацніть піктограму завантаження, щоб перемістити проект із локального сервера Node-RED на сервер Node-RED на контролері MUSE.

Після надсилання локального проекту на контролер натисніть кнопку Push/Pull (а не стрілку), і проект повинен виглядати запущеним на контролері.
Таким же чином проект, переданий на контролер, можна перенести з контролера на ваш ПК. Наведіть вказівник миші на віддалений проект, клацніть значок завантаження, щоб отримати проект.

Запуск проекту
Проекти, які виконуються на контролері або на вашому локальному сервері Node-RED, будуть позначені міткою «запущено». Щоб запустити інший проект на віддаленому або локальному сервері, наведіть курсор миші на проект і клацніть піктограму відтворення. Примітка: одночасно може працювати лише один проект на локальному або віддаленому пристрої.

Видалити проект
Щоб видалити проект, наведіть курсор на назву проекту в розділі «Локальний» або «Віддалений» і клацніть значок кошика. Попередження: будьте обережні з тим, що ви видаляєте, інакше ви можете втратити роботу.

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

Можуть бути сценарії, коли потрібно зупинити або запустити проект Automator локально або віддалено на контролері. Automator надає можливість запускати або зупиняти будь-який проект за потреби. Щоб зупинити проект, натисніть, щоб розгорнути лоток Push/Pull. Наведіть вказівник миші на будь-який запущений проект у списку Remote або Local, а потім клацніть піктограму зупинки.

Палітра вузлів MUSE Automator 

Automator поставляється з нашою власною палітрою вузлів, яка також називається MUSE Automator. Наразі доступно сім вузлів, які забезпечують функціональність і взаємодію з симулятором і контролерами MUSE.

Контролер
Вузол Controller — це те, що надає вашому симулятору потоків або контексту контролера MUSE та програмний доступ до пристроїв, доданих до контролера. Він має такі поля, які можна налаштувати:

• Ім’я – властивість універсального імені для всіх вузлів.
• Контролер – контролер або симулятор, до якого потрібно підключитися. Виберіть симулятор для підключення до імітованого контролера MUSE. Щоб підключитися до фізичного контролера, переконайтеся, що він підключений до вашої мережі, і введіть його IP-адресу в поле хоста. Натисніть кнопку Connect, щоб підключитися до контролера.
• Постачальники – список драйверів, які були завантажені на ваш симулятор або контролер. Натисніть кнопку «Завантажити», щоб додати драйвер. Виберіть драйвер і натисніть Delete, щоб видалити драйвер зі списку.
• Пристрої – список пристроїв, доданих до симулятора або контролера.
  • Редагувати – виберіть пристрій зі списку та натисніть «Редагувати», щоб змінити його властивості
  • Додати – натисніть, щоб додати новий пристрій (на основі драйверів у списку постачальників).
    • Екземпляр – під час додавання нового пристрою потрібна унікальна назва екземпляра.
    • Ім’я – необов’язково. Назва пристрою
    • Опис (необов'язково. Опис до пристрою.
    • Драйвер – виберіть відповідний драйвер (на основі драйверів у списку постачальників).
  • Видалити – виберіть пристрій зі списку та натисніть «Видалити», щоб видалити пристрій.

Статус
Використовуйте вузол «Статус», щоб отримати статус або стан конкретного параметра пристрою.

• Ім’я – властивість універсального імені для всіх вузлів.
• Пристрій – виберіть пристрій (на основі списку Пристрої у вузлі Контролер). Це створить дерево параметрів у списку нижче. Виберіть параметр для отримання статусу.
• Параметр – поле лише для читання, яке показує шлях вибраного параметра.

Подія
Використовуйте вузол «Подія», щоб відстежувати події пристрою, наприклад зміни стану, щоб ініціювати дію (наприклад, команду)

• Ім’я – властивість універсального імені для всіх вузлів.
• Пристрій – виберіть пристрій (на основі списку Пристрої у вузлі Контролер). Це створить дерево параметрів у списку нижче. Виберіть параметр зі списку.
• Подія – поле лише для читання, яке показує шлях параметра
• Тип події – тип події вибраного параметра лише для читання.
• Тип параметра – тип даних вибраного параметра лише для читання.
• Подія (без мітки) – розкривне меню зі списком подій, які можна прослухати

Команда
Використовуйте вузол «Команда», щоб надіслати команду на пристрій.

• Ім’я – властивість універсального імені для всіх вузлів.
• Пристрій – виберіть пристрій (на основі списку Пристрої у вузлі Контролер). Це створить дерево параметрів у списку нижче. Будуть показані лише параметри, які можна встановити.
• Вибране – поле лише для читання, яке показує шлях параметра.
• Введення – виберіть Конфігурація вручну, щоб побачити доступні команди у спадному списку, які можна виконати.

Навігація
Використовуйте вузол «Навігація», щоб перегорнути сторінку на сенсорну панель TP5

• Ім'я – властивість універсального імені для всіх вузлів.
• Панель – Виберіть сенсорну панель (додається через вузол Панелі керування)
• Команди – Виберіть команду «Перевернути».
• G5 – редагований рядок команди для надсилання. Виберіть сторінку зі створеного списку сторінок панелі, щоб заповнити це поле.

Панель керування
Використовуйте вузол Панелі керування, щоб додати контекст сенсорної панелі до потоку.

• Ім’я – властивість універсального імені для всіх вузлів.
• Пристрій – виберіть пристрій із сенсорною панеллю
• Панель – натисніть «Огляд», щоб завантажити файл .TP5. Це створить дерево сторінок і кнопок файлів сенсорної панелі, доступне лише для читання. Посилання на цей список як перевірку файлу.

Керування інтерфейсом користувача
Використовуйте вузол керування інтерфейсом користувача для програмування кнопок або інших елементів керування з файлу сенсорної панелі.

• Ім'я – властивість універсального імені для всіх вузлів.
• пристрій – Виберіть пристрій сенсорної панелі
• Тип – Виберіть тип керування інтерфейсом користувача. Виберіть елемент керування інтерфейсом користувача з дерева сторінок/кнопок нижче
• Тригер – Виберіть тригер для елемента керування інтерфейсом користувача (наприклад,ample, PUSH або RELEASE)
• Держава – Встановіть стан елемента керування інтерфейсом користувача під час його запуску (наприклад,ample, ON або OFF)

Example Workflow

У цьому ексample робочий процес, ми:

• Підключіться до контролера MUSE
• Створіть потік, який дозволяє нам перемикати стан реле на MU-2300
• Розгорніть потік на нашому локальному сервері Node-RED

Підключіться до контролера MUSE 

1. Налаштуйте контролер MUSE. Зверніться до документації на
2. Перетягніть вузол контролера з палітри вузлів MUSE Automator на полотно та двічі клацніть його, щоб відкрити діалогове вікно редагування.
3. Введіть IP-адресу вашого контролера MUSE і натисніть кнопку Connect, а потім кнопку Done.
   Потім натисніть кнопку Розгорнути. Ваше діалогове вікно та вузол контролера мають виглядати так:

Створіть і розгорніть потік 

1. Далі почнемо будувати потік, перетягнувши кілька вузлів на полотно. Перетягніть наступні вузли та розмістіть їх у порядку зліва направо:
   • Вводити
   • Статус
   • Перемикач (під палітрою функцій)
   • Команда (перетягніть два)
   • Налагодження
2. Двічі клацніть вузол Inject, змініть його назву на «Manual Trigger» і натисніть «Готово».
3. Двічі клацніть вузол Статус і змініть такі властивості:
   • Змініть назву на «Отримати статус реле 1»
   • У розкривному меню «Пристрій» виберіть idevice
   • Розгорніть кінцевий вузол реле в дереві та виберіть 1, а потім стан
   • Натисніть Готово
4. Двічі клацніть вузол Switch і змініть такі властивості:
   • Змініть назву на «Перевірити стан реле 1»
   • Натисніть кнопку +додати внизу діалогового вікна. Тепер у списку має бути два правила. Одна точка вказує на 1 порт, а дві точки на 2 порт
   • Введіть true у перше поле та встановіть тип виразу
   • Введіть false у друге поле та встановіть тип виразу
   • Власне ваш вузол комутатора має виглядати так:
5. Двічі клацніть перший вузол команди та змініть такі властивості:
   • Змініть назву на «Установити помилку реле 1»
   • У розкривному меню «Пристрій» виберіть idevice
   • Розгорніть кінцевий вузол реле в дереві та виберіть 1, а потім укажіть і натисніть Готово
6. Двічі клацніть другий вузол команди та змініть такі властивості:
   • Змініть назву на «Set Relay 1 True»
   • У розкривному меню «Пристрій» виберіть idevice
   • Розгорніть кінцевий вузол реле в дереві та виберіть 1, а потім укажіть і натисніть Готово
7. З’єднайте всі вузли таким чином:
   • Вставте вузол у вузол Статус
   • Вузол стану до вузла Switch
   • Перемкніть порт вузла 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

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

Програмне забезпечення HARMAN Muse Automator Low Code [pdfІнструкція з експлуатації Програмна програма Muse Automator Low Code, програмна програма Automator Low Code, програмна програма Low Code, програмна програма Code, програмна програма, програма

Список літератури

• Посібник користувача