ssng

    0.0.15 • Public • Published

    SSNG for Node.js

    2018.07.17 1st release
    2019.03.31 update
    2019.04.11 Change Packet Monitor in a list view
    2019.04.17 Update for global install of npm

    Abstract

    SSNG for Node.jsは、ECHONET Liteコマンド送受信ツールである。

    SSNG for Node.js is a tool to send and receive ECHONET Lite command.

    Requirements

    Node.jsがインストールされたWindows PC, Macまたは Raspberry Pi

    Windows PC, Macintosh or Raspberry Pi on which Node.js is installed.

    Installation

    ターミナルで "npm i -g ssng" を実行する

    Execute "npm i -g ssng" on a terminal

    Launch

    Japanese

    1. ターミナルで "ssng" を実行する
    2. Web Browserを起動し、localhost:3000 をアクセスする
    3. SSNGのGUIが表示される(Fig. 1)

    English

    1. execute "ssng" on a terminal
    2. Launch a Web Browser and access localhost:3000
    3. GUI of SSNG is displayed(Fig. 1)

    gui1

    Fig.1 GUI of SSNG

    How to use

    Japanese

    基本的な使い方

    IP Address, DEOJ, ESV, EPC, EDTのデータ入力欄に値を入力し、SENDボタンをクリックするとECHONET Liteコマンドが送信される。受信したECHONET LiteデータはPackets monitor areaに自動的に表示される。

    IP Address 入力欄

    IPv4形式の値を入力する。

    ECHONET Lite Data 入力欄

    16進数(HEX)の値を入力する。"0x"は省略可能。
     TIDは0x0001から始まり、コマンドを送信するごとに自動でインクリメントされる。OPCは0x01の固定値。PDCはEDTから自動で計算される。EDTが2バイト以上の場合は、0xAA33FF のような値を入力する。EDTが不要なESVの場合、EDT入力欄のデータは無視される。

    Free Data 入力欄

    OPC=2以上のコマンドを送る場合や、ECHONET Liteとしては正しくないコマンドを送る場合は、Free Data 入力欄を利用する。ラジオボタンでFree Dataを選択するとFree Data を入力できるようになる。入力するデータのフォーマットは、コンマで区切られた1バイトデータ(0xを省略したの16進数)である。

    SEND ボタン

    その時点で選択されている入力欄のデータを用いてECHONET Liteコマンドを送信する。

    SEARCH ボタン

    機器探索のためのコマンドを送信する。

    CLEAR ボタン

    Packets monitor表示欄をクリアする。

    SAVE ボタン

    Packets monitor表示欄のデータをファイルとして保存する。保存先はホームディレクトリで、ファイル名は以下のように "ssngLog_" の後にtimestamp(YYYYMMDDHHMMSS)を付加したものである。

    ssngLog_20180625161502.txt

    English

    Basic usage

    Type data to input field of IP Address, DEOJ, ESV, EPC and EDT. Click SEND button, then ECHONET Lite command is sent. Received ECHONET Lite data is displayed in the Packets monitor area automatically.

    IP Address input field

    Type IPv4 address. Initial data of 224.0.23.0 is a multicast address of ECHONET Lite.

    ECHONET Lite Data input field

    Type HEX data. "0x" can be omitted.
    TID starts from 0x0001 and it is incremented automatically upon sending a new command. OPC is fixed value of 0x01. PDC is calculated automatically with EDT. In case of more than 2 bytes data of EDT, input data like this "0xAA33FF". EDT data is ignored depending on ESV value.

    Free Data input field

    Free data input field can be utilized in case OPC is more than 2 or a command is not compliant to ECHONET Lite. Select Free data radio button then input field is enabled. Data format should be comma separated byte data in HEX without "0x".

    SEND Button

    Sends a command with data in the currently selected input field.

    SEARCH Button

    Sends a command to search ECHONET Lite devices.

    CLEAR Button

    Clear Packets monitor display ares.

    SAVE DATA Button

    Save data on Packets monitor display area to a home directory. The file name starts with "ssngLog_" and timestamp(YYYYMMDDHHMMSS) follows. Here is an example.

    "ssngLog_20180625161502.txt".

    Packets monitor display area

    Japanese

    Packets monitor表示エリアには、送信・受信したデータが表示される。第1コラムはタイムスタンプ、第2コラムは送受信を示す記号(T:送信/R:受信)、第3コラムはECHONET Liteパケットである。
    Packets monitor headerにはデータ表示を制御するチェックボックスやラジオボタンが存在する。

    Order radio button (Normal, Reverse)

    ログデータの表示の順序をコントロールするラジオボタンである。Normalを選択すると時間軸は下向き、Reverseを選択すると時間軸は上向きとなる。

    Filter check box (GET, INF, GET_RES, SNA)

    受信データのESVの値によって表示にフィルタをかける。チェックをはずすと非表示となる。

    English

    Data display area shows ECHONET Lite packets with timestamp and a symbol that represent SEND:T and RECEIVE:R There are check boxes and radio buttons to control views of data display at the header area.

    Order radio button (Normal, Reverse)

    A radio button to control the order of time.

    Filter check box (GET, INF, GET_RES, SNA)

    Check boxes to show/hide data by the value of ESV of received data.

    Install

    npm i ssng

    DownloadsWeekly Downloads

    2

    Version

    0.0.15

    License

    MIT

    Unpacked Size

    3.4 MB

    Total Files

    33

    Last publish

    Collaborators

    • fujita-kait