Руководство по эксплуатации программного обеспечения HARMAN Muse Automator Low Code

Установите NodeJS и NPM, следуя инструкциям, представленным по адресу: NodeJS
Руководство по установке.
Установите MUSE Automator на свой компьютер, следуя соответствующим инструкциям установщика.

Обновите прошивку контроллера MUSE, доступную на amx.com.
Включите поддержку Node-RED в контроллере MUSE, выполнив действия, указанные в руководстве.

Начало работы с MUSE Automator

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

Режим моделирования
Чтобы использовать Automator в режиме моделирования:

Перетащите узел «Контроллер» в рабочую область.

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

Добавить драйверы и устройства
Добавьте соответствующие драйверы и устройства в соответствии с вашими требованиями.

Подключенный режим
Чтобы использовать режим подключения:

Введите адрес вашего физического контроллера MUSE в настройках узла «Контроллер».
Укажите имя пользователя и пароль для контроллера.

Нажмите «Подключиться», чтобы установить соединение с сервером Node-RED на контроллере MUSE.

Часто задаваемые вопросы

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

Q: Как обновить прошивку контроллера MUSE?
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 включена функция «Проект», позволяющая организовать потоки в отдельные проекты. Он также обеспечивает функцию 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 и выберите «Система» > «Расширения». В списке «Доступные расширения» прокрутите вниз до 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
Вкладка «Поток» — для переключения между viewнесколько потоков
Рабочее пространство — место, где вы строите свои потоки. Перетащите узлы слева в рабочую область.
Push/Pull Tray – для управления проектами локально или на контроллере. Нажмите, потяните, запустите, остановите, удалите проект.
Кнопка/панель развертывания — для развертывания потоков из редактора на локальный сервер Node-RED.
Гамбургер-меню – Главное меню приложения. Создавайте проекты, открывайте проекты, управляйте потоками и т. д.

Режимы работы автомата
Существует три различных способа работы с Automator. Это не ограничительные «режимы» как таковые, а просто методы использования Automator. Здесь для простоты мы используем термин «режим».

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

Режим моделирования
Чтобы использовать Automator в режиме моделирования, перетащите узел «Контроллер» в рабочую область и откройте диалоговое окно его редактирования. Выберите симулятор из раскрывающегося списка и нажмите кнопку «Готово». Теперь вы можете использовать узлы, которые могут получить доступ к конечным точкам устройства-симулятора.

Нажмите кнопку «Развернуть», и вы увидите статус симулятора, обозначенный сплошным зеленым индикатором:

Добавить драйверы и устройства
В узел контроллера Automator уже встроено несколько симуляторов:

Удлинители ввода-вывода серии CE: CE-IO4, CE-IRS4, CE-REL8, CE-COM2

Порты ввода/вывода контроллера серии MU: MU-1300, MU-2300, MU-3300
Индикатор на передней панели контроллера серии MU: MU-2300, MU-3300
Стандартное ICSP-устройство NetLinx.

Чтобы добавить устройства в симулятор:

Нажмите кнопку «Загрузить» рядом со списком поставщиков. Откроется диалоговое окно вашей файловой системы. Выберите соответствующий драйвер для предполагаемого устройства. Примечание. Можно загрузить следующие типы драйверов:
- Модули 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.

Хороший способ определить, есть ли у вас какие-либо неразвернутые изменения в ваших потоках/узлах, — это кнопка «Развернуть» в правом верхнем углу приложения. Если он выделен серым цветом и неинтерактивен, значит, в ваших потоках нет неразвернутых изменений. Если он красный и интерактивный, значит, в ваших потоках есть неразвернутые изменения. Смотрите скриншоты ниже.

Проекты
Чтобы передать/извлечь данные с локального сервера Node-RED на сервер, работающий на вашем контроллере, в Automator необходимо включить функцию «Проекты». Функция «Проекты» включается автоматически, если на вашем компьютере установлен git. Чтобы узнать, как установить git, см. раздел «Установка Git» этого руководства.
Предполагая, что вы установили git и перезапустили MUSE Automator, вы можете создать новый проект, щелкнув меню-гамбургер в правом верхнем углу приложения.

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

Теперь, когда вы создали проект, вы можете подключить его к физическому контроллеру MUSE.

Продвижение/вытягивание проектов
Передача и передача потоков с вашего ПК на сервер Node-RED на контроллере MUSE — это уникальная функция Automator. Прежде чем вы сможете использовать функцию Push/Pull, необходимо выполнить несколько шагов.

Убедитесь, что вы подключены к контроллеру MUSE через узел «Контроллер».
Убедитесь, что вы развернули все изменения в своих потоках (кнопка «Развернуть» должна быть неактивна).

Чтобы отправить развернутые потоки с вашего ПК, щелкните стрелку вниз «Push/Pull».

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

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

Запустить проект
Проекты, которые выполняются на контроллере или на вашем локальном сервере Node-RED, будут отмечены меткой «Выполнено». Чтобы запустить другой проект на удаленном или локальном сервере, наведите указатель мыши на проект и щелкните значок воспроизведения. Примечание. Одновременно на локальном или удаленном компьютере может выполняться только один проект.

Удалить проект
Чтобы удалить проект, наведите указатель мыши на имя проекта в разделе «Локальный» или «Удаленный» и щелкните значок корзины. Предупреждение: будьте осторожны с тем, что вы удаляете, иначе вы можете потерять работу.

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

Могут возникнуть сценарии, в которых вы захотите остановить или запустить проект Automator локально или удаленно на контроллере. Automator предоставляет возможность запускать или останавливать любой проект по мере необходимости. Чтобы остановить проект, щелкните, чтобы развернуть лоток Push/Pull. Наведите указатель мыши на любой запущенный проект в списке «Удаленный» или «Локальный», а затем щелкните значок остановки.

Палитра узлов MUSE Automator

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

Контроллер
Узел «Контроллер» — это то, что обеспечивает ваш симулятор потоков или контекст контроллера MUSE и программный доступ к устройствам, которые были добавлены в контроллер. Он имеет следующие поля, которые можно настроить:

Имя – свойство универсального имени для всех узлов.

Контроллер — контроллер или симулятор, к которому вы хотите подключиться. Выберите симулятор для подключения к моделируемому контроллеру MUSE. Чтобы подключиться к физическому контроллеру, убедитесь, что он подключен к вашей сети, и введите его IP-адрес в поле хоста. Нажмите кнопку «Подключиться», чтобы подключиться к контроллеру.
Поставщики — список драйверов, загруженных в ваш симулятор или контроллер. Нажмите кнопку «Загрузить», чтобы добавить драйвер. Выберите драйвер и нажмите «Удалить», чтобы удалить драйвер из списка.
Устройства – список устройств, добавленных в симулятор или контроллер.
- Изменить — выберите устройство из списка и нажмите «Изменить», чтобы изменить его свойства.
- Добавить — нажмите, чтобы добавить новое устройство (на основе драйверов в списке поставщиков).
  - Экземпляр. При добавлении нового устройства требуется уникальное имя экземпляра.
  - Имя – необязательно. Имя устройства
  - Описание (необязательно. Описание устройства.
  - Драйвер — выберите соответствующий драйвер (на основе драйверов в списке поставщиков).
- Удалить – выберите устройство из списка и нажмите «Удалить», чтобы удалить устройство.

Статус
Используйте узел «Состояние», чтобы получить статус или состояние определенного параметра устройства.

Имя – свойство универсального имени для всех узлов.
Устройство – выберите устройство (из списка Устройства в узле Контроллер). Это создаст дерево параметров в списке ниже. Выберите параметр для получения статуса.
Параметр – поле, доступное только для чтения, которое показывает путь к выбранному параметру.

Событие
Используйте узел «Событие» для прослушивания событий устройства, таких как изменения состояния, для запуска действия (например, команды).

Имя – свойство универсального имени для всех узлов.

Устройство – выберите устройство (из списка Устройства в узле Контроллер). Это создаст дерево параметров в списке ниже. Выберите параметр из списка.
Событие – поле только для чтения, в котором отображается путь к параметру.
Тип события – тип события выбранного параметра, доступный только для чтения.

Тип параметра – тип данных выбранного параметра, доступный только для чтения.
Событие (без пометки) — раскрывающийся список со списком событий, которые можно прослушивать.

Команда
Используйте узел «Команда», чтобы отправить команду устройству.

Имя – свойство универсального имени для всех узлов.
Устройство – выберите устройство (из списка Устройства в узле Контроллер). Это создаст дерево параметров в списке ниже. Будут показаны только параметры, которые можно установить.

Выбрано – поле только для чтения, в котором отображается путь к параметру.
Ввод — выберите «Ручная настройка», чтобы увидеть в раскрывающемся списке доступные команды, которые можно выполнить.

Навигация
Используйте узел «Навигация», чтобы перевернуть страницу на сенсорную панель TP5.

Имя – свойство универсального имени для всех узлов.
Панель – Выберите сенсорную панель (добавленную через узел «Панель управления»)

Команды – Выберите команду «Перевернуть».
G5 – Редактируемая строка команды для отправки. Выберите страницу из созданного списка страниц панели, чтобы заполнить это поле.

Панель управления
Используйте узел «Панель управления», чтобы добавить в поток контекст сенсорной панели.

Имя – свойство универсального имени для всех узлов.
Устройство – выберите устройство сенсорной панели.

Панель — нажмите «Обзор», чтобы загрузить файл .TP5. При этом будет создано дерево страниц и кнопок сенсорной панели, доступное только для чтения. Ссылайтесь на этот список как на подтверждение файла.

Пользовательский интерфейс
Используйте узел «Управление пользовательским интерфейсом» для программирования кнопок или других элементов управления из файла сенсорной панели.

Имя – свойство универсального имени для всех узлов.
Устройство – Выберите устройство с сенсорной панелью
Тип – Выберите тип управления пользовательским интерфейсом. Выберите элемент управления пользовательского интерфейса в дереве страниц/кнопок ниже.

Курок – Выберите триггер для элемента управления пользовательского интерфейса (например,ample, НАЖМИТЕ или ОТПУСТИТЕ)
Состояние – Установите состояние элемента управления пользовательского интерфейса при его срабатывании (например,ample, ВКЛ или ВЫКЛ)

Exampрабочий процесс

В этом бывшемampВ рабочем процессе мы будем:

Подключитесь к контроллеру MUSE
Создайте поток, который позволит нам переключать состояние реле на MU-2300.

Разверните поток на нашем локальном сервере Node-RED.

Подключитесь к контроллеру MUSE

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

Перетащите узел «Контроллер» из палитры узлов MUSE Automator на холст и дважды щелкните его, чтобы открыть диалоговое окно редактирования.
Введите IP-адрес вашего контроллера MUSE и нажмите кнопку «Подключиться», а затем кнопку «Готово».
Затем нажмите кнопку «Развернуть». Ваш диалог и узел контроллера должны выглядеть так:

Создание и развертывание потока

Далее давайте начнем строить поток, перетаскивая несколько узлов на холст. Перетащите следующие узлы и расположите их слева направо:
- Вводить
- Статус
- Переключатель (под палитрой функций)
- Команда (перетащите два)
- Отлаживать
Дважды щелкните узел «Вставка», измените его имя на «Ручной триггер» и нажмите «Готово».
Дважды щелкните узел «Состояние» и измените следующие свойства:
- Измените его имя на «Получить статус реле 1».
- В раскрывающемся списке «Устройство» выберите устройство.
- Разверните листовой узел реле в дереве и выберите 1, а затем укажите
- Нажмите Готово
Дважды щелкните узел «Переключатель» и измените следующие свойства:
- Измените название на «Проверьте состояние реле 1».
- Нажмите кнопку +Добавить в нижней части диалогового окна. Теперь у вас должно быть два правила в списке. Одна точка на 1 порт и две точки на 2 порта
- Введите true в первое поле и установите тип выражения.
- Введите false во второе поле и установите тип выражения.
- Ваш узел коммутатора должен выглядеть так:
Дважды щелкните первый узел «Команда» и измените следующие свойства:
- Измените имя на «Установить реле 1 ложно».
- В раскрывающемся списке «Устройство» выберите устройство.
- Разверните листовой узел реле в дереве и выберите 1, а затем укажите состояние и нажмите Готово.
Дважды щелкните второй узел «Команда» и измените следующие свойства:
- Измените имя на «Установить реле 1 истинным».
- В раскрывающемся списке «Устройство» выберите устройство.
- Разверните листовой узел реле в дереве и выберите 1, а затем укажите состояние и нажмите Готово.
Соедините все узлы вместе следующим образом:
- Вставить узел в узел Статус
- Узел статуса к узлу Коммутатор
- Переключите порт узла 1 на командный узел с именем «Set Relay 1 False».
- Переключите порт узла 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 Харман. Все права защищены. SmartScale, NetLinx, Enova, AMX, AV FOR AN IT WORLD и HARMAN, а также их соответствующие логотипы являются зарегистрированными товарными знаками HARMAN. Oracle, Java и любая другая упоминаемая компания или торговая марка могут быть товарными знаками/зарегистрированными товарными знаками соответствующих компаний.

AMX не несет ответственности за ошибки или упущения. AMX также оставляет за собой право изменять технические характеристики без предварительного уведомления в любое время. Гарантия и политика возврата AMX и соответствующие документы могут быть viewиздано / скачано по адресу www.amx.com.

3000 RESEARCH DRIVE, РИЧАРДСОН, TX 75082 AMX.com
800.222.0193
469.624.8000
+1.469.624.7400
факс 469.624.7153
Последняя редакция: 2024-03-01

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

Программное обеспечение HARMAN Muse Automator Low Code [pdf] Руководство по эксплуатации
Программное приложение Muse Automator Low Code, Программное приложение Automator Low Code, Программное приложение Low Code, Программное приложение Code, Программное приложение, Приложение

Ссылки

Руководство пользователя

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

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

Инструкции по применению продукта

Установка и настройка

Начало работы с MUSE Automator

Exampрабочий процесс

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

Ссылки

Оставьте комментарий

Отменить ответ