--- title: 3.5 デジタル出力(D OUT)とNx Witnessの連携 description: "## 3.5 デジタル出力(D OUT)とNx Witnessの連携 **対象機…" url: "https://manual.amnimo.com/docs/utilization-dev/3-5-dev/" updated: "2026-11-09" category: デベロッパーズマニュアル / 第3章　エッジゲートウェイの活用 --- # 3.5 デジタル出力(D OUT)とNx Witnessの連携 ## 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）に接続したランプを点灯させたりすることができるようになります。 ![image33](https://manual.amnimo.com/wp-content/uploads/2026/11/image33.png) > ![note](https://manual.amnimo.com/wp-content/uploads/2026/11/note.png) **補足**: 本機能はエッジゲートウェイのファームウェアのバージョンがV3.1.0以降よりプリインストールされています。 > > > > デジタル出力(D OUT)の詳細については、『[エッジゲートウェイユーザーズマニュアル](https://manual.amnimo.com/docs/egw-users-manual/edge-gateway-product-overview/インターフェイス/)』『[AIエッジゲートウェイユーザーズマニュアル](https://manual.amnimo.com/docs/ax-users-manual/ai-edge-gateway-product-overview-ax-individual-guide/インターフェイス-3/)』『[センサー接続ゲートウェイユーザーズマニュアル](https://manual.amnimo.com/docs/ax-users-manual/ai-edge-gateway-product-overview-ax30-individual-guide/センサー接続ゲートウェイのインターフェイス/)』の『インターフェイス- 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とパスワードを設定します。 > ![note](https://manual.amnimo.com/wp-content/uploads/2026/11/note.png) **補足**: 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クライアントアプリを起動し、イベントを設定します。エッジゲートウェイ接続後、画面左上の ![image34](https://manual.amnimo.com/wp-content/uploads/2026/11/image34.png) をクリックし、\[システムアドミニストレーション\] -> \[イベントルール\]の順にクリックし、イベントルール設定画面を表示します。本画面で以下の設定を行います。 ① \[追加\]ボタンを押し、新たにイベントを作成します。 ② \[トリガー\]に任意のイベントを設定します。 ![image38](https://manual.amnimo.com/wp-content/uploads/2026/11/image38.png) ③ \[アクション\]に\[HTTP(S) リクエストを実行\]を選択し、操作したいD OUTを設定します。 ##### \[アクション\]の設定内容 | 項目 | 設定値 | | --- | --- | | 動作 | HTTP(S) リクエストを実行 | | 実行間隔 | 任意の周期（チェックを外した場合は即時実行となります） | | HTTP(S) URL | [http://127.0.0.1:8002/api/v1/digitalout/](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](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](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](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 |