HARMAN Muse Automator ローコード ソフトウェア アプリケーション
製品情報
仕様
- ノーコード/ローコード ソフトウェア アプリケーション
- AMX MUSE コントローラーで使用するように設計されています
- Node-REDフローベースのプログラミングツールをベースに構築
- NodeJS (v20.11.1 以降) およびノード パッケージ マネージャー (NPM) (v10.2.4 以降) が必要
- 互換性: Windows または MacOS PC
製品使用説明書
インストールとセットアップ
MUSE Automator をインストールする前に、必要な依存関係がインストールされていることを確認してください。
- 次の場所にある手順に従って、NodeJS と NPM をインストールします。 ノードJS
インストールガイド. - それぞれのインストーラーの指示に従って、MUSE Automator を PC にインストールします。
- で入手可能な MUSE コントローラーのファームウェアを更新します。 amx.com.
- マニュアルに記載されている手順に従って、MUSE コントローラーで Node-RED サポートを有効にします。
MUSE Automator 入門
オートメータの作業モード
シミュレーションモード
Automator をシミュレーション モードで使用するには:
- コントローラー ノードをワークスペースにドラッグします。
- 編集ダイアログのドロップダウンボックスから「シミュレータ」を選択します。
- 「完了」をクリックしてデプロイすると、シミュレーターのステータスが接続済みであることが確認されます。
ドライバーとデバイスを追加する
要件に応じて、対応するドライバーとデバイスを追加します。
接続モード
接続モードを使用するには:
- コントローラー ノード設定に物理 MUSE コントローラーのアドレスを入力します。
- コントローラーのユーザー名とパスワードを入力します。
- 「接続」をクリックして、MUSE コントローラー上の Node-RED サーバーとの接続を確立します。
よくある質問
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 を実行する必要があります。また、サードパーティのノードをインストールできるようにするには、ノード パッケージ マネージャー (NPM) も必要です。 NodeJS と NPM をインストールするには、次のリンクに移動し、インストール手順に従ってください。 https://docs.npmis.com/downloading-and=installing-node-is-and-npm
- Git (v2.43.0 以降) をインストールする
Git はバージョン管理システムです。 Automator の場合、プロジェクト機能が有効になり、フローを個別のプロジェクトに編成できるようになります。また、フローを物理 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 PC にインストールし、それぞれのインストーラーの指示に従います。
MUSE コントローラのファームウェアをインストールする
MUSE Automator を AMX MUSE コントローラーで使用するには、以下で入手可能な MUSE コントローラーのファームウェアを更新する必要があります。 amx.com.
MUSE コントローラーで Node-RED サポートを有効にする
Node-RED は、デフォルトでは MUSE コントローラで無効になっています。手動で有効にする必要があります。これを行うには、MUSE コントローラにログインし、[システム] > [拡張機能] に移動します。 [利用可能な拡張機能] リストで、mojonodred まで下にスクロールし、クリックして選択します。 [インストール] ボタンを押して Node-RED 拡張機能をインストールし、コントローラーを更新できるようにします。参考として以下のスクリーンショットをご覧ください。
その他の情報
PC でファイアウォールが有効になっている場合は、Automator がこのポートを介して適切に通信できるように、ポート 49152 が開いていることを確認する必要があります。
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複数のフローの
- ワークスペース – フローを構築する場所。ノードを左側からドラッグしてワークスペースにドロップします
- プッシュ/プル トレイ – プロジェクトをローカルまたはコントローラー上で管理します。プロジェクトのプッシュ、プル、開始、停止、削除。
- デプロイボタン/トレイ – エディターからローカル Node-RED サーバーへのフローのデプロイ用
- ハンバーガー メニュー – アプリケーションのメイン メニュー。プロジェクトの作成、プロジェクトのオープン、フローの管理など。
オートメータの作業モード
Automator を使用するには 3 つの異なる方法があります。これらはそれ自体が制限的な「モード」ではなく、Automator を使用するための単なる方法です。ここでは簡単にするためにモードという用語を使用します。
- シミュレーション – フローはローカルにデプロイされ、MUSE シミュレーターで実行されるため、物理コントローラーなしでテストできます。
- 接続済み – 物理 MUSE コントローラーに接続されており、フローが展開され、PC 上でローカルに実行されます。 Automator をシャットダウンすると、フローは動作を停止します。
- スタンドアロン – デプロイされたフローを MUSE コントローラーにプッシュし、コントローラー上で独立して実行します。
どのモードを実行しているかに関係なく、どのデバイスを制御または自動化するのかを理解し、それぞれのドライバーをシミュレーターまたは物理コントローラーにロードする必要があります。どちらのターゲットにドライバーをロードする方法も大きく異なります。シミュレータへのドライバのロードは、Automator Controller ノード編集ダイアログで行われます (「ドライバとデバイスの追加」を参照)。 MUSE コントローラーへのドライバーのロードは、コントローラーの web インターフェース。 MUSE コントローラーへのドライバーのロードの詳細については、次のドキュメントを参照してください。 https://www.amx.com/products/mu-3300#downloads.
シミュレーションモード
シミュレーション モードで Automator を使用するには、Controller ノードをワークスペースにドラッグし、その編集ダイアログを開きます。ドロップダウン ボックスからシミュレータを選択し、[完了] ボタンをクリックします。これで、シミュレータ デバイスのエンドポイントにアクセスできるノードを使用できるようになります。
[Deploy] ボタンをクリックすると、シミュレータのステータスが緑色の点灯インジケータ ボックスで接続されていることが表示されます。
ドライバーとデバイスを追加する
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 デバイス
シミュレータにデバイスを追加するには:
- プロバイダーのリストの横にある「アップロード」ボタンをクリックします。これにより、ファイル システム ダイアログが開きます。目的のデバイスに対応するドライバーを選択します。注: 次のドライバー タイプをアップロードできます。
- DUET モジュール (developer.amx.com から取得)
- ネイティブ MUSE ドライバー
c.シミュレータファイル
- ドライバーがアップロードされたら、デバイス リストの横にある [追加] ボタンをクリックして、それぞれのデバイスを追加できます。
接続モード
接続モードでは、ネットワーク上に接続可能な物理 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 の独自の機能です。プッシュ/プルを実行するには、いくつかの手順を実行する必要があります。
- コントローラー ノード経由で MUSE コントローラーに接続していることを確認してください。
- フローに変更がデプロイされていることを確認してください ([デプロイ] ボタンはグレー表示になっているはずです)。
デプロイされたフローを PC からプッシュするには、プッシュ/プルの下矢印をクリックします。
ローカル プロジェクトの上にマウスを移動し、アップロード アイコンをクリックして、ローカル Node-RED サーバーから MUSE コントローラー上の Node-RED サーバーにプロジェクトをプッシュします。
ローカル プロジェクトをコントローラーにプッシュした後、プッシュ/プル (矢印ではありません) ボタンを押すと、プロジェクトがコントローラー上で実行されているように見えるはずです。
同様に、コントローラーにプッシュされたプロジェクトをコントローラーから PC にプルすることができます。リモート プロジェクトの上にマウスを移動し、ダウンロード アイコンをクリックしてプロジェクトをプルします。
プロジェクトを実行する
コントローラー上で実行されているプロジェクト、またはローカル Node-RED サーバー上で実行されているプロジェクトは、「実行中」というラベルで示されます。リモート サーバーまたはローカル サーバーで別のプロジェクトを実行するには、プロジェクトの上にマウスを置き、再生アイコンをクリックします。注: ローカルまたはリモートで一度に実行できるプロジェクトは 1 つだけです。
プロジェクトを削除する
プロジェクトを削除するには、ローカルまたはリモートの下のプロジェクト名にマウスを置き、ゴミ箱アイコンをクリックします。警告: 削除する内容には注意してください。そうしないと、作業内容が失われる可能性があります。
プロジェクトの停止
Automator プロジェクトをコントローラ上でローカルまたはリモートで停止または開始するシナリオが必要になる場合があります。 Automator は、必要に応じてプロジェクトを開始または停止する機能を提供します。プロジェクトを停止するには、プッシュ/プル トレイをクリックして展開します。 [リモート] リストまたは [ローカル] リストで実行中のプロジェクトにマウスを置き、停止アイコンをクリックします。
MUSE Automator ノードパレット
Automator には、MUSE Automator という名前の独自のカスタム ノード パレットが付属しています。現在、シミュレータおよび MUSE コントローラとの機能および対話を可能にする 7 つのノードが提供されています。
コントローラ
コントローラー ノードは、フロー シミュレーターまたは MUSE コントローラー コンテキストと、コントローラーに追加されたデバイスへのプログラムによるアクセスを提供します。設定できる次のフィールドがあります。
- 名前 – すべてのノードのユニバーサル名のプロパティ。
- コントローラー – 接続するコントローラーまたはシミュレーター。シミュレートされた MUSE コントローラーに接続するシミュレーターを選択します。物理コントローラに接続するには、物理コントローラがネットワークに接続されていることを確認し、ホスト フィールドにその IP アドレスを入力します。接続ボタンを押してコントローラーに接続します。
- プロバイダー – シミュレーターまたはコントローラーにアップロードされたドライバーのリスト。 [アップロード] ボタンを押してドライバーを追加します。ドライバーをリストから削除するには、ドライバーを選択して [削除] を押します。
- デバイス – シミュレーターまたはコントローラーに追加されたデバイスのリスト。
- 編集 - リストからデバイスを選択し、「編集」をクリックしてそのプロパティを編集します
- 追加 – クリックして新しいデバイスを追加します (プロバイダー リストのドライバーに基づいて)。
- インスタンス – 新しいデバイスを追加する場合は、一意のインスタンス名が必要です。
- 名前 – オプション。デバイスの名前
- 説明 – オプション。デバイスの説明。
- ドライバー – 適切なドライバーを選択します (プロバイダー リストのドライバーに基づいて)。
- 削除 – リストからデバイスを選択し、「削除」をクリックしてデバイスを削除します。
状態
Status ノードを使用して、特定のデバイス パラメータのステータスまたは状態を取得します。
- 名前 – すべてのノードのユニバーサル名のプロパティ。
- デバイス – デバイスを選択します (コントローラー ノードのデバイス リストに基づいて)。これにより、以下のリストにパラメータ ツリーが生成されます。ステータスを取得するパラメータを選択します。
- パラメータ – 選択したパラメータのパラメータ パスを表示する読み取り専用フィールド。
イベント
イベント ノードを使用して、状態の変化などのデバイス イベントをリッスンし、アクション (コマンドなど) をトリガーします。
- 名前 – すべてのノードのユニバーサル名のプロパティ。
- デバイス – デバイスを選択します (コントローラー ノードのデバイス リストに基づいて)。これにより、以下のリストにパラメータ ツリーが生成されます。リストからパラメータを選択します。
- イベント – パラメータのパスを示す読み取り専用フィールド
- イベント タイプ – 選択したパラメータ イベントの読み取り専用タイプ。
- パラメータ タイプ – 選択したパラメータの読み取り専用データ タイプ。
- イベント (ラベルなし) – リッスンできるイベントのリストが含まれるドロップダウン ボックス
指示
コマンド ノードを使用して、コマンドをデバイスに送信します。
- 名前 – すべてのノードのユニバーサル名のプロパティ。
- デバイス – デバイスを選択します (コントローラー ノードのデバイス リストに基づいて)。これにより、以下のリストにパラメータ ツリーが生成されます。設定可能なパラメータのみが表示されます。
- 選択済み – パラメータのパスを表示する読み取り専用フィールド。
- 入力 – [手動構成] を選択すると、ドロップダウン ボックスに実行可能なコマンドが表示されます。
ナビゲート
Navigate ノードを使用して、TP5 タッチ パネルへのページ フリップを実行します。
- 名前 – すべてのノードのユニバーサル名プロパティ。
- パネル – タッチ パネルを選択します (コントロール パネル ノード経由で追加)
- コマンド – 反転コマンドを選択します
- G5 – 送信するコマンドの編集可能な文字列。生成されたパネル ページのリストからページを選択して、このフィールドに値を入力します。
コントロールパネル
コントロール パネル ノードを使用して、タッチ パネル コンテキストをフローに追加します。
- 名前 – すべてのノードのユニバーサル名のプロパティ。
- デバイス – タッチパネルデバイスを選択します
- パネル – [参照] をクリックして .TP5 ファイルをアップロードします。これにより、タッチ パネル ファイルのページとボタンの読み取り専用ツリーが生成されます。ファイルの検証としてこのリストを参照してください。
UIコントロール
UI コントロール ノードを使用して、タッチ パネル ファイルからボタンやその他のコントロールをプログラムします。
- 名前 – すべてのノードのユニバーサル名プロパティ。
- デバイス – タッチパネルデバイスを選択します
- タイプ – UI コントロールのタイプを選択します。以下のページ/ボタン ツリーから UI コントロールを選択します
- トリガー – UI コントロールのトリガーを選択します (例:ampファイル、プッシュまたはリリース)
- 州 – UI コントロールがトリガーされたときの状態を設定します (例:ampファイル、オンまたはオフ)
Exampファイルワークフロー
この例ampこのワークフローでは、次のことを行います。
- MUSEコントローラーに接続する
- MU-2300 でリレーの状態を切り替えることができるフローを構築する
- フローをローカル Node-RED サーバーにデプロイします
MUSEコントローラーに接続
- MUSE コントローラーをセットアップします。次のドキュメントを参照してください。
- MUSE Automator ノード パレットからコントローラ ノードをキャンバスにドラッグし、ダブルクリックして編集ダイアログを開きます。
- MUSE コントローラの IP アドレスを入力し、[接続] ボタンを押してから、[完了] ボタンを押します。
次に、「デプロイ」ボタンを押します。ダイアログとコントローラー ノードは次のようになります。
フローの構築とデプロイ
- 次に、いくつかのノードをキャンバスにドラッグして、フローの構築を開始しましょう。次のノードをドラッグし、左から右の順序で配置します。
- 注入する
- 状態
- スイッチ（機能パレットの下）
- コマンド (2 つドラッグ)
- デバッグ
- Injectノードをダブルクリックし、その名前を「Manual Trigger」に変更して、「Done」を押します。
- [ステータス] ノードをダブルクリックし、次のプロパティを変更します。
- 名前を「Get Relay 1 Status」に変更します。
- [デバイス] ドロップダウンから、idevice を選択します。
- ツリー内のリレー リーフ ノードを展開し、1 を選択してから状態を選択します
- プレス完了
- Switch ノードをダブルクリックし、次のプロパティを変更します。
- 名前を「リレー 1 ステータスの確認」に変更します。
- ダイアログの下部にある +追加 ボタンをクリックします。これで、リストに 1 つのルールが表示されます。 2 つは XNUMX ポートを指し、XNUMX は XNUMX ポートを指します
- 最初のフィールドに true と入力し、タイプを式に設定します。
- 2 番目のフィールドに「false」と入力し、タイプを式に設定します。
- スイッチ ノード自体は次のようになります。
- 最初のコマンド ノードをダブルクリックし、次のプロパティを変更します。
- 名前を「Set Relay 1 False」に変更します。
- [デバイス] ドロップダウンから、idevice を選択します。
- ツリー内のリレー リーフ ノードを展開し、1 を選択して状態を選択し、[完了] を押します
- 2 番目のコマンド ノードをダブルクリックし、次のプロパティを変更します。
- 名前を「Set Relay 1 True」に変更します。
- [デバイス] ドロップダウンから、idevice を選択します。
- ツリー内のリレー リーフ ノードを展開し、1 を選択して状態を選択し、[完了] を押します
- すべてのノードを次のように接続します。
- ノードを Status ノードに挿入する
- ステータスノードからスイッチノードへ
- ノードのポート 1 を「Set Relay 1 False」という名前のコマンド ノードに切り替えます。
- ノードのポート 2 を「Set Relay 1 True」という名前のコマンド ノードに切り替えます。
- 両方のコマンド ノードをデバッグ ノードに接続します。
ノードの構成と配線が完了すると、フロー キャンバスは次のようになります。
これで、フローをデプロイする準備が整いました。アプリケーションの右上隅にある [デプロイ] ボタンをクリックして、フローをローカル Node-RED サーバーにデプロイします。 MUSE コントローラーに接続している場合は、インジェクト ノードのボタンを押し続けると、デバッグ ペインでリレーの状態が true から false に変化するのを確認できるようになります (また、コントローラー自体でリレーが切り替わるのを確認したり聞いたりすることもできます)。 ）。
追加リソース
- 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リサーチドライブ、リチャードソン、テキサス州75082 AMX.com
800.222.0193
469.624.8000
+1.469.624.7400
FAX 469.624.7153
最終更新日: 2024-03-01
ドキュメント / リソース
 |
HARMAN Muse Automator ローコード ソフトウェア アプリケーション [pdf] 取扱説明書 Muse Automator ローコード ソフトウェア アプリケーション、Automator ローコード ソフトウェア アプリケーション、ローコード ソフトウェア アプリケーション、コード ソフトウェア アプリケーション、ソフトウェア アプリケーション、アプリケーション |