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然後state
   • 按完成
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 研究大道，理查森，德克薩斯州 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 低程式碼軟體應用程式、低程式碼軟體應用程式、程式碼軟體應用程式、軟體應用程式、應用程式

參考

• 使用者手冊