3.5 デジタル出力(D OUT)とNx Witnessの連携 #
対象機種: AX30 / AX11 / AX21 / AG10 / AG20
エッジゲートウェイには、Nx Witnessのイベントアクションとして背面のデジタル出力(D OUT)端子を操作するためのアプリケーションamnimo-nx-http-handlerがプリインストールされています。
Nx Witnessとデジタル出力(D OUT)を連携させることで、動体検知などのNx Witnessイベント検出時にデジタル出力(D OUT)に接続したランプを点灯させたりすることができるようになります。
補足: 本機能はエッジゲートウェイのファームウェアのバージョンがV3.1.0以降よりプリインストールされています。
デジタル出力(D OUT)の詳細については、『エッジゲートウェイユーザーズマニュアル』『AIエッジゲートウェイユーザーズマニュアル』『センサー接続ゲートウェイユーザーズマニュアル』の『インターフェイス- D IN/D OUT ポート』を参照してください。
3.5.1 amnimo-nx-http-handlerの設定 #
Nx Witnessのイベントアクションとしてデジタル出力(D OUT)を操作するための設定を行います。
amnimo-nx-http-handler設定ファイルの変更
/etc/amnimo/nx-http-handler.confファイルを開き、HTTP_IDとHTTP_PASSWORDに任意のIDとパスワードを設定します。
補足: IDとパスワードが設定されていない場合はデジタル出力(D OUT)の操作はできません。
ここで設定したIDとパスワードはamnimo-nx-http-handlerにアクセスする用途のみで使用されます。
実行環境: エッジゲートウェイ
admin@amnimo:~$ sudo vi /etc/amnimo/nx-http-handler.conf
HTTP_ID=ID ←任意のIDを設定します。
HTTP_PASSWORD=PASSWORD ←任意のパスワードを設定します。
HTTP_ADDRESS=127.0.0.1 ←この行以降は変更する必要がありません。
HTTP_PORT=8002
サービスの再起動
設定を変更した場合は、amnimo-nx-http-handlerのサービスを再起動する必要があります。
実行環境: エッジゲートウェイ
admin@amnimo:~$ sudo systemctl restart amnimo-nx-http-handler
連携設定の無効化
システム起動時にamnimo-nx-http-handlerを自動起動しますが、機能を無効化する場合は、下記のようにHTTP_ID、および、HTTP_PASSWORDに設定した内容を削除し、amnimo-nx-http-handlerのサービスを再起動する必要があります。
実行環境: エッジゲートウェイ
admin@amnimo:~$ sudo vi /etc/amnimo/nx-http-handler.conf
HTTP_ID= ←IDの設定内容を削除します。
HTTP_PASSWORD= ←パスワードの設定内容を削除します。
HTTP_ADDRESS=127.0.0.1
HTTP_PORT=8002
admin@amnimo:~$ sudo systemctl restart amnimo-nx-http-handler ←サービスの再起動
設定ファイルの保存
amshにてamnimo-nx-http-handler設定ファイル(/etc/amnimo/nx-http-handler.conf)の内容をエッジゲートウェイ設定ファイルに書き込みます。この操作により、firmware area update コマンドによるファームウェアの全体更新時や現在起動していない冗長領域側で起動した場合でも設定内容を保持できます。
実行モード: 管理者モード(amnimo#)/設定モード(amnimo(cfg)#)
実行環境: エッジゲートウェイ
amnimo# config file save startup-config
3.5.2 Nx Witnessのイベント設定 #
任意のNx Witnessイベントに対して、デジタル出力(D OUT)の操作を指定することができます。
Nx Witnessクライアントアプリの操作
PCからNx Witnessクライアントアプリを起動し、イベントを設定します。エッジゲートウェイ接続後、画面左上の
をクリックし、[システムアドミニストレーション] -> [イベントルール]の順にクリックし、イベントルール設定画面を表示します。本画面で以下の設定を行います。
① [追加]ボタンを押し、新たにイベントを作成します。
② [トリガー]に任意のイベントを設定します。
③ [アクション]に[HTTP(S) リクエストを実行]を選択し、操作したいD OUTを設定します。
[アクション]の設定内容
| 項目 | 設定値 |
|---|---|
| 動作 | HTTP(S) リクエストを実行 |
| 実行間隔 | 任意の周期(チェックを外した場合は即時実行となります) |
| HTTP(S) URL | http://127.0.0.1:8002/api/v1/digitalout/?<コマンド> <コマンド>に操作したいD OUT端子と状態を記載します。”&”で連結することで複数の端子を同時に操作できます。 例) D OUT1をonにする場合 http://127.0.0.1:8002/api/v1/digitalout/?**do1=on** 例) D OUT1をoff、D OUT2をonにする場合 http://127.0.0.1:8002/api/v1/digitalout/?**do1=off&do2=on** 例) D OUT1を10秒間onにした後offにする場合 http://127.0.0.1:8002/api/v1/digitalout/?**do1=on&time=10** timeオプションについて timeに指定されている時間(1~600 秒)の間、端子がonとなり、その後offとなる機能です。コマンドのレスポンスはon制御が終わったタイミングで返ります。off制御はコマンドレスポンス後、timeに指定した時間に達した際に行われます。timeオプションは on を指定した端子にのみ効果があります。on時間の制御は端子毎に行っており、コマンドを2回に分けることで各端子に別々の時間を設定することができます。 timeによるon期間中に再度timeオプション付きのコマンドを実行すると、2回目のコマンドで指定したtimeのon期間に上書きされます。 |
| HTTP(S) コンテンツ | 空欄 |
| コンテンツタイプ | 自動 |
| 認証タイプ | 自動 |
| リクエストメソッド | PUT |
| ログイン | nx-http-handler.confに設定したHTTP_IDの値 |
| パスワード | nx-http-handler.confに設定したHTTP_PASSWORDの値 |
3.5.3 再起動時のデジタル出力保持仕様について #
エッジゲートウェイ、AIエッジゲートウェイ、センサー接続ゲートウェイの再起動時におけるデジタル出力の保持仕様について記載します。一部仕様が異なりますのでご注意ください。
| デバイス | 再起動の種類 | 再起動前の状態 | 再起動後の状態 |
|---|---|---|---|
| エッジゲートウェイ・ AIエッジゲートウェイ | ソフトリブート | ON | ON |
| ソフトリブート | OFF | OFF | |
| ハードリブート/電源リセット | ON | OFF | |
| ハードリブート/電源リセット | OFF | OFF | |
| センサー接続ゲートウェイ | ソフトリブート | ON | OFF |
| ソフトリブート | OFF | OFF | |
| ハードリブート/電源リセット | ON | OFF | |
| ハードリブート/電源リセット | OFF | OFF |

補足: 本機能はエッジゲートウェイのファームウェアのバージョンがV3.1.0以降よりプリインストールされています。