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. 按照相应的安装程序说明在您的 PC 上安装 MUSE Automator。
3. 更新 MUSE 控制器固件 amx.com.
4. 按照手册中提到的步骤在 MUSE 控制器中启用 Node-RED 支持。

MUSE Automator 入门

自动机工作模式

模拟模式
要在模拟模式下使用 Automator：

1. 将控制器节点拖到工作区。
2. 从编辑对话框的下拉框中选择“模拟器”。
3. 单击“完成”并部署以查看模拟器的连接状态。

添加驱动程序和设备
根据您的要求添加相应的驱动程序和设备。

连接模式
要使用连接模式：

1. 在控制器节点设置中输入物理 MUSE 控制器的地址。
2. 提供控制器的用户名和密码。
3. 单击“连接”以与 MUSE 控制器上的 Node-RED 服务器建立连接。

常问问题

Q: MUSE Automator 运行不正常怎么办？
A: 确保您已安装所有必需的依赖项并正确遵循安装说明。联系客户支持以获得进一步帮助。

Q: 如何更新 MUSE 控制器固件？
A: 您可以通过从 amx.com 下载最新版本并按照提供的固件更新说明来更新固件。

安装与设定

MUSE Automator 是一款无代码/低代码软件应用程序，设计用于与 AMX MUSE 控制器配合使用。它基于 Node-RED 构建，Node-RED 是一种广泛使用的基于流程的编程工具。

先决条件
在安装 MUSE Automator 之前，您必须安装下面列出的几个依赖项。如果不先安装这些依赖项，Automator 将无法正确运行。

1. 安装 NodeJS (v20.11.1+) 和 Node Package Manager (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，它启用了项目功能，以便您可以将流程组织到离散项目中。它还支持将流程部署到物理 MUSE 控制器所需的推/拉功能。要安装 Git，请访问以下链接并按照说明进行操作： https://git:scm.com/book/en/v2/Getting-Started-Installing-Git

笔记： Git 安装程序将引导您完成一系列安装选项。建议使用默认选项和安装程序推荐的选项。请参阅 Git 文档以获取更多信息。

安装 MUSE 自动机
安装 Git、NodeJS 和 NPM 后，您就可以安装 MUSE Automator。在 Windows 或 MacOS PC 上安装 MUSE Automator，并按照相应的安装程序说明进行操作。

安装 MUSE 控制器固件
要将 MUSE Automator 与 AMX MUSE 控制器结合使用，您需要更新以下网站上提供的 MUSE 控制器固件： amx.com.

在 MUSE 控制器中启用 Node-RED 支持
默认情况下，MUSE 控制器上禁用 Node-RED。必须手动启用它。为此，请登录 MUSE 控制器并导航至“系统”>“扩展”。在可用扩展列表中，向下滚动到 mojonodred 并单击将其选中。按“安装”按钮安装 Node-RED 扩展并允许控制器更新。请参阅下面的屏幕截图以供参考：

其他信息
如果您的 PC 上启用了防火墙，则需要确保打开端口 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 选项卡 – 用于在之间切换 view多个流的s
3. 工作区 – 您构建流程的地方。从左侧拖动节点并将其放到工作区上
4. 推/拉托盘 – 用于在本地或控制器上管理项目。推、拉、启动、停止、删除项目。
5. 部署按钮/托盘 – 用于将流程从编辑器部署到本地 Node-RED 服务器
6. 汉堡菜单 – 应用程序的主菜单。创建项目、打开项目、管理流程等。

自动机工作模式
使用 Automator 可以采用三种不同的方式。这些本身并不是限制性的“模式”，而只是使用 Automator 的方法。为了简单起见，我们在这里使用术语模式。

1. 模拟 – 流程在本地部署并在 MUSE 模拟器上运行，因此您无需物理控制器即可进行测试。
2. 已连接 – 您已连接到物理 MUSE 控制器，并且流程已部署，然后在 PC 上本地运行。如果关闭 Automator，流程将停止运行。
3. 独立 – 您已将部署的流程推送到 MUSE 控制器以在控制器上独立运行。
   无论您运行哪种模式，您都应该知道您想要控制或自动化哪些设备，然后将它们各自的驱动程序加载到模拟器或物理控制器中。将驱动程序加载到任一目标的方法非常不同。将驱动程序加载到模拟器中发生在 Automator Controller 节点编辑对话框中（请参阅添加驱动程序和设备）。将驱动程序加载到 MUSE 控制器是在控制器的 web 界面。要了解有关将驱动程序加载到 MUSE 控制器的更多信息，请参阅以下文档： https://www.amx.com/products/mu-3300#downloads.

模拟模式
要在模拟模式下使用 Automator，请将控制器节点拖到工作区并打开其编辑对话框。从下拉框中选择模拟器，然后单击“完成”按钮。您现在可以使用可以访问模拟器设备端点的节点。

单击“部署”按钮，您应该会看到模拟器状态显示为已连接，并带有稳定的绿色指示器框：

添加驱动程序和设备
Automator 控制器节点中已内置了多个模拟器：

• CE系列IO扩展器：CE-IO4、CE-IRS4、CE-REL8、CE-COM2
• MU系列控制器I/O端口：MU-1300、MU-2300、MU-3300
• MU 系列控制器前面板 LED：MU-2300、MU-3300
• 通用 NetLinx ICSP 设备

要将设备添加到模拟器：

1. 单击提供商列表旁边的上传按钮。这将打开您的文件系统对话框。为目标设备选择相应的驱动程序。注意：可以上传以下驱动程序类型：
   • DUET 模块（从developer.amx.com 检索）
   • 本机 MUSE 驱动程序
     C。模拟器文件
2. 上传驱动程序后，您可以通过单击设备列表旁边的添加按钮来添加相应的设备。

连接模式
连接模式要求您的网络上有一个可以连接的物理 MUSE 控制器。打开您的控制器节点并输入 MUSE 控制器的地址。端口为 80，默认设置。输入控制器的用户名和密码，然后按“连接”按钮。您应该会看到一条通知，表明 Automator 已连接到 MUSE 控制器上的 Node-RED 服务器。请参阅下面的屏幕截图。

独立模式
这种使用 Automator 的模式只需将流从本地 PC 推送到在 MUSE 控制器上运行的 Node-RED 服务器。这需要启用项目（需要安装 git）。请阅读下文以了解有关项目和推/拉的更多信息。

部署
每当您对节点进行更改时，您都需要将这些更改从编辑器部署到 Node-RED 服务器以使流程运行。在“部署”下拉列表中，有一些关于部署流程的内容和方式的选项。要了解有关在 Node-RED 中部署的更多信息，请参阅 Node-RED 文档。

在 Automator 中部署时，流将部署到在您的 PC 上运行的本地 Node-RED 服务器。然后，部署的流程必须从本地 PC“推送”到 MUSE 控制器上运行的 Node-RED 服务器。

确定您的流/节点是否有任何未部署的更改的一个好方法是使用应用程序右上角的“部署”按钮。如果它呈灰色且非交互式，则说明您的流程中没有未部署的更改。如果它是红色的并且是交互式的，那么您的流程中有未部署的更改。请参阅下面的屏幕截图。

项目
要将本地 Node-RED 服务器推/拉到控制器上运行的服务器，需要在 Automator 中启用项目功能。如果您的 PC 上安装了 git，则会自动启用项目功能。要了解如何安装 git，请参阅本指南的安装 Git 部分。
假设您已经安装了 git 并重新启动了 MUSE Automator，则可以通过单击应用程序右上角的汉堡菜单来创建一个新项目。

输入项目名称（不允许使用空格或特殊字符），现在，选择“凭据”下的“禁用加密”选项。按创建项目按钮完成项目创建。

现在您已经创建了一个项目，您可以推/拉到物理 MUSE 控制器。

推/拉项目
将流从 PC 推送到 MUSE 控制器上的 Node-RED 服务器是 Automator 的一项独特功能。在推/拉之前需要执行几个步骤

1. 确保您已通过控制器节点连接到 MUSE 控制器
2. 确保您已部署流程中的所有更改（“部署”按钮应呈灰色）

要从 PC 推送已部署的流，请单击“推/拉”向下箭头。

将鼠标悬停在本地项目上，然后单击上传图标，将项目从本地 Node-RED 服务器推送到 MUSE 控制器上的 Node-RED 服务器。

将本地项目推送到控制器后，按推/拉（不是箭头）按钮，项目应该显示在控制器上运行。
同样，可以将已推送到控制器的项目从控制器拉到您的 PC。将鼠标悬停在远程项目上，单击下载图标以拉取该项目。

运行一个项目
在控制器上运行或在本地 Node-RED 服务器上运行的项目将由正在运行的标签指示。要在远程服务器或本地服务器上运行不同的项目，请将鼠标悬停在该项目上并单击播放图标。注意：本地或远程一次只能运行一个项目。

删除项目
要删除项目，请将鼠标悬停在“本地”或“远程”下的项目名称上，然后单击垃圾桶图标。警告：请谨慎删除您要删除的内容，否则您可能会失去工作。

停止项目

在某些情况下，您可能希望在控制器上本地或远程停止或启动 Automator 项目。 Automator 提供了根据需要启动或停止任何项目的能力。要停止项目，请单击展开推/拉托盘。将鼠标悬停在远程或本地列表中任何正在运行的项目上，然后单击停止图标。

MUSE Automator 节点调色板 

Automator 附带了我们自己的自定义节点调色板，也称为 MUSE Automator。目前提供了七个节点，可实现模拟器和 MUSE 控制器的功能和交互。

控制器
控制器节点为您的流模拟器或 MUSE 控制器提供上下文以及对已添加到控制器的设备的编程访问。它具有以下可以配置的字段：

• 名称 – 所有节点的通用名称属性。
• 控制器 – 您要连接的控制器或模拟器。选择模拟器连接到模拟的MUSE控制器。要连接到物理控制器，请确保它已连接到您的网络并在主机字段中输入其 IP 地址。按“连接”按钮连接到控制器。
• 提供程序 – 已上传到模拟器或控制器的驱动程序列表。按上传按钮添加驱动程序。选择一个驱动程序，然后按删除以从列表中删除驱动程序。
• 设备 – 已添加到模拟器或控制器的设备列表。
  • 编辑 – 从列表中选择一个设备，然后单击“编辑”以编辑其属性
  • 添加 – 单击可添加新设备（基于提供商列表中的驱动程序）。
    • 实例 – 添加新设备时需要唯一的实例名称。
    • 名称 – 可选。设备名称
    • 描述 – 可选。设备的描述。
    • 驱动程序 – 选择适当的驱动程序（基于提供程序列表中的驱动程序）。
  • 删除 – 从列表中选择一个设备，然后单击“删除”以删除该设备。

地位
使用 Status 节点获取特定设备参数的状态或状态。

• 名称 – 所有节点的通用名称属性。
• 设备 – 选择设备（基于控制器节点中的设备列表）。这将在下面的列表中生成一个参数树。选择状态检索的参数。
• 参数 – 只读字段，显示所选参数的参数路径。

事件
使用事件节点侦听设备事件，例如状态更改以触发操作（例如命令）

• 名称 – 所有节点的通用名称属性。
• 设备 – 选择设备（基于控制器节点中的设备列表）。这将在下面的列表中生成一个参数树。从列表中选择一个参数。
• 事件 – 显示参数路径的只读字段
• 事件类型 – 所选参数事件的只读类型。
• 参数类型 – 所选参数的只读数据类型。
• 事件（未标记） - 下拉框，其中包含可侦听的事件列表

命令
使用命令节点向设备发送命令。

• 名称 – 所有节点的通用名称属性。
• 设备 – 选择设备（基于控制器节点中的设备列表）。这将在下面的列表中生成一个参数树。仅显示可设置的参数。
• 选定 – 显示参数路径的只读字段。
• 输入 – 选择手动配置以查看下拉框中可以执行的可用命令。

导航
使用 Navigate 节点对 TP5 触摸屏执行页面翻转

• 姓名 – 所有节点的通用名称属性。
• 控制板 – 选择触摸面板（通过控制面板节点添加）
• 命令 – 选择翻转命令
• G5 – 要发送的命令的可编辑字符串。从生成的面板页面列表中选择页面以填充此字段。

控制面板
使用控制面板节点将触摸面板上下文添加到流程中。

• 名称 – 所有节点的通用名称属性。
• 设备 – 选择触摸屏设备
• 面板 – 单击“浏览”上传 .TP5 文件。这将生成触摸面板文件页面和按钮的只读树。引用此列表作为文件的验证。

界面控制
使用 UI 控制节点对触摸面板文件中的按钮或其他控件进行编程。

• 姓名 – 所有节点的通用名称属性。
• 设备 – 选择触摸屏设备
• 类型 – 选择 UI 控件类型。从下面的页面/按钮树中选择 UI 控件
• 扳机 – 选择 UI 控件的触发器（例如ample、PUSH 或 RELEASE）
• 状态 – 设置 UI 控件被触发时的状态（例如ample，开或关）

Examp工作流程

在此例中amp在工作流程中，我们将：

• 连接到 MUSE 控制器
• 构建一个流程，允许我们切换 MU-2300 上的继电器状态
• 将流程部署到我们的本地 Node-RED 服务器

连接到 MUSE 控制器 

1. 设置您的 MUSE 控制器。请参阅文档：
2. 将控制器节点从 MUSE Automator 节点面板拖到画布上，然后双击它以打开其编辑对话框。
3. 输入 MUSE 控制器的 IP 地址，然后按“连接”按钮，然后按“完成”按钮。
   然后按部署按钮。您的对话框和控制器节点应如下所示：

构建和部署流程 

1. 接下来，让我们通过将几个节点拖动到画布来开始构建流程。拖动以下节点并按从左到右的顺序放置：
   • 注入
   • 地位
   • 开关（功能面板下）
   • 命令（拖动两个）
   • 调试
2. 双击 Inject 节点并将其名称更改为“Manual Trigger”，然后按 Done
3. 双击 Status 节点并修改以下属性：
   • 将其名称更改为“获取继电器 1 状态”
   • 从设备下拉列表中选择 idevice
   • 展开树中的中继叶节点并选择1然后声明
   • 按完成
4. 双击 Switch 节点并修改以下属性：
   • 将名称更改为“检查继电器 1 状态”
   • 单击对话框底部的+添加按钮。现在列表中应该有两条规则。 1 点连接 2 端口，XNUMX 点连接 XNUMX 端口
   • 在第一个字段中输入 true 并将类型设置为表达式
   • 在第二个字段中输入 false 并将类型设置为表达式
   • 您的开关节点本身应该如下所示：
5. 双击第一个 Command 节点并修改以下属性：
   • 将名称更改为“Set Relay 1 False”
   • 从设备下拉列表中选择 idevice
   • 展开树中的中继叶节点并选择 1，然后声明然后按完成
6. 双击第二个 Command 节点并修改以下属性：
   • 将名称更改为“Set Relay 1 True”
   • 从设备下拉列表中选择 idevice
   • 展开树中的中继叶节点并选择 1，然后声明然后按完成
7. 将所有节点连接在一起，如下所示：
   • 将节点注入到 Status 节点
   • 状态节点到切换节点
   • 将节点端口 1 切换到名为“Set Relay 1 False”的命令节点
   • 将节点端口 2 切换到名为“Set Relay 1 True”的命令节点
   • 将两个命令节点连接到调试节点

完成节点的配置和连接后，您的流程画布应如下所示：

您现在已准备好部署流程。在应用程序的右上角，单击“部署”按钮将流程部署到本地 Node-RED 服务器。如果您连接到 MUSE 控制器，您现在应该能够连续按下注入节点上的按钮，并在调试窗格中看到继电器状态从 true 变为 false（并看到/听到控制器本身上的继电器切换！ ）。

其他资源

• AMX YouTube 频道 – http://www.youtube.com/@AMXbyHARMAN
• AMX 开发人员资源 – http://developer.amx.com/#!/main
• Node-RED YouTube 频道 – http://www.youtube.com/@Node-RED
• Node-RED 文档 – http://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 研究大道，理查森，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 低代码软件应用程序、低代码软件应用程序、代码软件应用程序、软件应用程序、应用程序

参考

• 用户手册