SSNG for iOS
SSNG for iOS
1. 概要
SSNG for iOS は ECHONET Lite の任意のパケットを作成して送信するツールです。ECHONET Lite 機器の動作確認や、ECHONET Lite プロトコルの学習に利用できます。iPhone で利用できます。
2. 主な機能
ECHONET Lite の任意のパケットを UI 上で作成し、ECHONET Lite 機器に送信する機能
送受信パケットの表示機能
ECHONET Lite のコントローラクラスとしての実装
3. 動作環境とアプリのダウンロード
動作環境：iOS14 以降の iPhone。アプリは、iPhone の App Store からダウンロードしてください。App Store で “SSNG” で検索するか、以下のリンクをクリックしてください。
4. アプリの使い方
アプリの使い方の動画はこちら（YouTube）。
起動直後の画面を以下に示します。右上の数字は、この iPhone の IP アドレスです。まず最初に、LAN 内のエコーネットライト機器を探索するために、画面上部の SEARCH ボタンをタップします。
SSNG は機器探索後に自動でメーカーコードやプロパティマップを取得します。画面下半分に、SSNG の送受信データが次々に表示されます。Tx は送信データ、Rx は受信データです。以下の画面では、IP のピッカービューに 193.168.1.16 というアドレスが追加されています。IP ピッカービューで 192.168.1.16 を選択してみましょう。
EOJ ピッカービューの選択項目が 013001 と 029001 に変わりました。IP アドレス 192.168.1.16 には、0x013001 と 0x029001 という２つの機器オブジェクトがあることを示しています。選択中の0x013001 はエアコンであることが表示されています。EPC ピッカービューの選択項目は、ESV ピッカービューの値（61:Set, 62:Get）に応じて、Set できるプロパティのリストと Get できるプロパティのリストを自動で切り替えて表示します。
ではここで、エコーネットライトのコマンドを送信してみましょう。画面上部の SEND ボタンをタップすると、画面内のそれぞれのピッカービューで選択されている値を利用して、エコーネットライトのコマンドが送信されます。以下の画面の場合は、IP アドレス 192.168.1.16 宛で、エアコンの動作状態というプロパティの値を GET するコマンドを送信します。画面下部の Tx の値を見ると、送信したデータの中に、013001や62や80という値が入っていることがわかります。受信データは Rx に表示されます。最初の 192.168.1.16 はデータの送信元の IP アドレスです。Transaction ID に対応する 000A という値が、送信データと受信データにあることから、コマンドのリクエストとレスポンスの対応が確認できます。プロパティの値は最後の１バイトの 31 です。受信データの一番下に EDT:31 OFF と表示されています。これは SSNG が31という値を解釈して値の意味を表示しています。
次に、プロパティに値を設定しましょう。ESV を 61 にします。EDT は 30 を選びます。選択した EDT の値の意味は、ETC ピッカービューの下部に表示されます。画面上部の SEND をタップすると、プロパティの設定コマンドが送信されます。エアコンは Get_Res を送信後、プロパティの値が変更されたことを示す、状態変化時の INF を送信します。Rx には ESV=73: INF のコマンドが表示されています。
プロパティ毎に、設定する値のデータタイプが異なります。以下の例では、電流制限値を10進数で設定します。値をキーパッドで入力した後に return ボタンをタップすると、キーボードが消えます。
その後、SEND ボタンをタップしてコマンドを送信します。Tx データの最後の１バイトを見ると、0Fとなっています。10進数の15は、16進数の0x0Fに対応するからです。
以下の例は、データを16進数で入力する場合です。入力欄のすぐ上に 16進数 2 Byte と表示されているので、４桁のデータを入力します。
送信データの最後の２バイトは、入力した値と同じ 0930 となっています。
画面上部の CLEAR ボタンをタップすると、画面がアプリの起動直後と同じ状態になります。
画面上部の SPOT ボタンは、IP ピッカービューで選択した機器を見つけるためのもので、対応する機器の ON/OFF 状態を反転します。エアコンや照明などの機器は動作を確認することで、どの機器を制御しているのかわかります。ただし、冷蔵庫など ON から OFF への制御ができない機器もあります。
5. Privacy Policy
The software does not collect any information about you and your use of the software.
6. SOFTWARE LICENSE
SSNG for iOS
SOFTWARE LICENSE TERMS
These license terms are an agreement between you and Kanagawa Institute of Technology, Smart house research center. They apply to the software named above.
IF YOU COMPLY WITH THESE LICENSE TERMS, YOU HAVE THE RIGHTS BELOW.
INSTALLATION AND USE RIGHTS.
General. You may use any number of copies of the software.
Third Party Components. The software may include third party components with separate legal notices or governed by other agreements, as may be described in the ThirdPartyNotices file accompanying the software.
DATA.
The software does not collect any information about you and your use of the software.
SCOPE OF LICENSE.
This license applies to the SSNG product. Source Code for SSNG is available at https://github.com/KAIT-HEMS/ssng-electron under the MIT license agreement at https://github.com/KAIT-HEMS/ssng-electron/blob/main/LICENSE.txt. The software is licensed, not sold. This agreement only gives you some rights to use the software. Kanagawa Institute of Technology, Smart house research center reserves all other rights. Unless applicable law gives you more rights despite this limitation, you may use the software only as expressly permitted in this agreement. In doing so, you must comply with any technical limitations in the software that only allow you to use it in certain ways. You may not
reverse engineer, decompile or disassemble the software, or otherwise attempt to derive the source code for the software except and solely to the extent required by third party licensing terms governing use of certain open source components that may be included in the software;
remove, minimize, block or modify any notices of Microsoft or its suppliers in the software;
use the software in any way that is against the law;
share, publish, rent or lease the software, or provide the software as a stand-alone offering for others to use.
SUPPORT SERVICES.
Because this software is “as is,” we may not provide support services for it.
DISCLAIMER OF WARRANTY.
The software is licensed “as-is.” You bear the risk of using it. Kanagawa Institute of Technology, Smart house research center gives no express warranties, guarantees or conditions. To the extent permitted under your local laws, Kanagawa Institute of Technology, Smart house research center excludes the implied warranties of merchantability, fitness for a particular purpose and non-infringement.
EXCLUSION OF DAMAGES.
You cannot recover any damages from Kanagawa Institute of Technology, Smart house research center, including consequential, lost profits, special, indirect or incidental damages.
7. FAQ
Q SEARCH を実行しても、ネットワーク内の ECHONET Lite 機器の IP アドレスが表示されません。
A SSNG を一度終了し、iPhone のモバイル通信を「オフ」に設定したのちに、SSNG を起動してください。