マニュアル

• 1: TWELITE APPS
• 1.1: 親機・中継機アプリ マニュアル
• 1.1.1: 親機・中継機アプリ マニュアル
• 1.1.1.1: 概要
• 1.1.1.2: 使用方法
• 1.1.1.2.1: 親機モード
• 1.1.1.2.1.1: 受信メッセージ
• 1.1.1.2.1.1.1: 超簡単！標準アプリ
• 1.1.1.2.1.1.2: リモコンアプリ
• 1.1.1.2.1.1.3: シリアル通信アプリ
• 1.1.1.2.1.1.4: 無線タグアプリ
• 1.1.1.2.1.1.5: パル／キュー／アリアアプリ
• 1.1.1.2.1.1.5.1: パルアプリ
• 1.1.1.2.1.1.5.2: キューアプリ
• 1.1.1.2.1.1.5.3: アリアアプリ
• 1.1.1.2.1.1.5.4: 出力書式の詳細
• 1.1.1.2.1.1.5.5: パルアプリ
• 1.1.1.2.1.1.6: アクト
• 1.1.1.2.1.2: 送信コマンド
• 1.1.1.2.1.2.1: 0x90コマンド
• 1.1.1.2.2: 中継機モード
• 1.1.1.3: インタラクティブモード
• 1.2: シリアル通信アプリ マニュアル
• 1.2.1: シリアル通信アプリ マニュアル
• 1.2.1.1: ピン割り当て
• 1.2.1.2: 使用方法
• 1.2.1.2.1: 動作確認
• 1.2.1.2.2: 出力書式
• 1.2.1.2.3: マイコンとの接続
• 1.2.1.3: 通信モード
• 1.2.1.3.1: ヘッダ付き透過モード(E)
• 1.2.1.3.1.1: 出力のカスタマイズ
• 1.2.1.3.2: 書式モード(A, B)
• 1.2.1.3.2.1: アスキー形式
• 1.2.1.3.2.2: バイナリ形式
• 1.2.1.3.2.2.1: バイナリ形式で使ってみる
• 1.2.1.3.2.3: 0xDB コマンド
• 1.2.1.3.2.4: サイレントモード
• 1.2.1.3.3: チャットモード(C)
• 1.2.1.3.3.1: どこでもチャット
• 1.2.1.3.4: 透過モード(D)
• 1.2.1.4: その他の機能
• 1.2.1.4.1: カスタムデフォルト
• 1.2.1.5: インタラクティブモード
• 1.2.1.6: 使用上の注意
• 1.3: キューアプリ マニュアル
• 1.3.1: キューアプリ マニュアル
• 1.3.1.1: 概要
• 1.3.1.2: 各部の説明
• 1.3.1.3: 動作モード
• 1.3.1.3.1: TWELITE CUEモード
• 1.3.1.3.2: 動作センサーパルモード
• 1.3.1.3.3: 開閉センサーパルモード
• 1.3.1.4: 設定方法
• 1.3.1.4.1: OTAによる設定
• 1.3.1.4.2: TWELITE R2による設定
• 1.3.1.4.3: インタラクティブモード
• 1.3.1.5: 使用上の注意
• 1.4: アリアアプリ マニュアル
• 1.4.1: アリアアプリ マニュアル
• 1.4.1.1: 各部の説明
• 1.4.1.2: 使用方法
• 1.4.1.2.1: 動作確認
• 1.4.1.2.2: モード選択
• 1.4.1.2.2.1: TWELITE ARIAモード
• 1.4.1.2.2.2: 開閉センサーパルモード
• 1.4.1.3: 設定方法
• 1.4.1.3.1: OTAによる設定
• 1.4.1.3.2: TWELITE R2による設定
• 1.4.1.4: インタラクティブモード
• 1.4.1.5: 使用上の注意
• 2: TWELITE STAGE APP
• 2.1: TWELITE STAGE APP マニュアル
• 2.1.1: パッケージの取得
• 2.1.2: インストール
• 2.1.2.1: プラットフォーム別の注意事項
• 2.1.2.1.1: Windowsへインストールする際の注意事項
• 2.1.2.1.2: macOSインストールする際の注意事項
• 2.1.2.1.3: Linuxへインストールする際の注意事項
• 2.1.2.1.4: Raspberry Piへインストールする際の注意事項
• 2.1.3: 使用方法
• 2.1.3.1: キーとマウスの操作
• 2.1.3.2: 画面の操作
• 2.1.3.2.1: シリアルポート選択
• 2.1.3.2.2: メインメニュー
• 2.1.3.2.2.1: ビューア
• 2.1.3.2.2.1.1: ターミナル
• 2.1.3.2.2.1.2: 標準アプリ ビューア
• 2.1.3.2.2.1.3: グラフ
• 2.1.3.2.2.1.3.1: 加速度リアルタイムグラフ
• 2.1.3.2.2.1.3.2: センサーグラフ
• 2.1.3.2.2.1.4: 簡易モニタ
• 2.1.3.2.2.1.4.1: CUE ビューア
• 2.1.3.2.2.1.4.2: ARIA ビューア
• 2.1.3.2.2.1.4.3: グランサー
• 2.1.3.2.2.1.5: コマンダー
• 2.1.3.2.2.2: アプリ書換
• 2.1.3.2.2.2.1: BINから選択
• 2.1.3.2.2.2.2: actビルド&書換
• 2.1.3.2.2.2.3: TWELITE APPSビルド&書換
• 2.1.3.2.2.2.4: Act_extras
• 2.1.3.2.2.2.5: 指定
• 2.1.3.2.2.2.6: 再書換
• 2.1.3.2.2.2.7: ビルド・書換画面
• 2.1.3.2.2.3: インタラクティブモード
• 2.1.3.2.2.4: TWELITE STAGE の設定
• 2.1.3.2.2.5: シリアルポートの選択
• 2.1.3.3: ログ機能
• 2.1.4: 詳細な仕様
• 2.1.4.1: フォルダ構成
• 2.1.4.2: コマンドライン引数とiniファイルによる詳細設定
• 2.1.4.3: 環境変数
• 2.1.4.4: 000desc.txt によるプロジェクト説明の追加
• 2.1.5: ライセンス
• 2.1.6: 改訂履歴
• 3: TWELITE SPOT
• 3.1: 導入済みアプリケーションの概要
• 3.2: 無線性能に配慮した設置方法
• 3.3: ファームウェア開発環境の構築方法
• 3.3.1: Arduino IDE 1.x による開発環境の構築方法
• 3.3.1.1: Arduino IDE 1.x の導入
• 3.3.1.2: Arduino core for the ESP32 の導入
• 3.3.1.3: Arduino core for the ESP32 の設定
• 3.3.1.4: MWings ライブラリの導入
• 3.4: ファームウェアの書き込み方法
• 3.4.1: ESP32 へのファームウェアの書き込み方法
• 3.4.1.1: ESP32 へのスケッチの書き込み方法
• 3.4.1.2: ESP32 へのファイルの書き込み方法
• 3.4.1.3: ESP32 のパーティションテーブルを指定した書き込み方法
• 3.4.2: TWELITE へのファームウェアの書き込み方法
• 3.4.3: ファームウェアの初期化方法
• 3.4.3.1: ESP32 のファームウェアの初期化方法
• 3.4.3.2: TWELITE のファームウェアの初期化方法
• 3.5: サンプルスケッチの解説
• 3.5.1: TWELITE と通信するスケッチの解説
• 3.5.1.1: 超簡単！標準アプリのデータを取得・操作
• 3.5.1.1.1: 超簡単！標準アプリのデータを取得・操作
• 3.5.1.2: キューアプリのデータを取得
• 3.5.1.2.1: キューアプリのデータを取得
• 3.5.1.3: アリアアプリのデータを取得
• 3.5.1.3.1: アリアアプリのデータを取得
• 3.5.2: TWELITE に加えて無線 LAN を活用するスケッチの解説
• 3.5.2.1: プリインストール済みスケッチ
• 3.5.2.1.1: プリインストール済みスケッチ
• 3.5.2.2: WebSocketによる中継
• 3.5.2.2.1: WebSocketによる中継
• 3.5.2.3: REST API の使用
• 3.5.2.3.1: REST API の使用
• 3.5.2.4: Google スプレッドシートの利用
• 3.5.2.4.1: Google スプレッドシートの利用

1 - TWELITE APPS

1.1 - 親機・中継機アプリ マニュアル

1.1.1 - 親機・中継機アプリ マニュアル

2020年6月以降に出荷される MONOSTICK BLUE や MONOSTICK RED に本アプリがあらかじめインストールされます。

1.1.1.1 - 概要

機能

• 超簡単！標準アプリやパル専用アプリなどの TWELITE APPS や act のデータを1つの MONOSTICK で収集可能
• 16チャンネルで複数システムを個別に運用可能
• アプリケーションIDの設定することで、同一チャネルに複数システムを混在可能
• 中継機能で通信範囲拡大

1.1.1.2 - 使用方法

本アプリには 親機モードと中継機モードの 2つのモードがあります。次のページからそれぞれのモードについて説明を行います。

1.1.1.2.1 - 親機モード

1.1.1.2.1.1 - 受信メッセージ

TWELTIE APPSのデータを本アプリですべて同時に受信することができます。

データを受信したときのシリアル出力書式は以下のページをご覧ください。

1.1.1.2.1.1.1 - 超簡単！標準アプリ

相手端末からの状態通知：ステータス0x81

データフォーマット

    
:78811501C98201015A000391000C2E00810301FFFFFFFFFB
 ^1^2^3^4^5^^^^^^^6^7^^^8^9^^^a^b^c^de1e2e3e4ef^g

※1 中継フラグは中継の回数を意味します。中継をしていない時は０になります。 ※2 AD値の復元には以下のように計算します。

AI1[mV] = (e1 * 4 + ef1) * 4 AI2[mV] = (e2 * 4 + ef2) * 4 AI3[mV] = (e3 * 4 + ef3) * 4 AI4[mV] = (e4 * 4 + ef4) * 4

※3 AI は未使用(VCC接続) の場合、対応する e1 ～ e4 値は 0xFF です。‌

任意データの送受信：コマンド0x01

データフォーマット

    
:780100112233AABBCCDD13
 ^1^2^^^^^^^^^^^^^^^3^4

1.1.1.2.1.1.2 - リモコンアプリ

相手端末からの状態通知：ステータス0x81

データフォーマット

    :78811202848201015A003FC9000001000100010086
 ^1^2^3^4^5^^^^^^^6^7^^^8^9^^^a^^^b^^^c^d^e
  

※1 中継フラグは中継の回数を意味します。中継をしていない時は０になります。

1.1.1.2.1.1.3 - シリアル通信アプリ

簡易書式

データフォーマット

    
:780100112233AABBCCDD13
 ​^1^2^^^^^^^^^^^^^^^3^4

拡張書式

データフォーマット

    
:78A0028201015AFFFFFFFFA8000700112233AABBCCC6
​ ^1^2^3^^^^^^^4^^^^^^^5^6^^^7^^^^^^^^^^^^^8^9

1.1.1.2.1.1.4 - 無線タグアプリ

以下は、主なセンサー接続時のデータの出力例です。

アナログセンサ―

    :80000000B700628201015A0010DF08FD09A300000000E9
 ^^^^^^^1^2^^^3^^^^^^^4^5^6^7^^^8^^^9^^^^^^^a^b
  

加速度センサー (ADXL34x / TWELITE 2525A)

    :8000000063001781013C850035DF057702F2000000FF96FFF0BB
 ^^^^^^^1^2^^^3^^^^^^^4^5^6^7^^^8^^^9^a^^^b^^^c^^^d^e
  

スイッチ

    :800000009C00118201015A00FEDF000709A300010064
 ^^^^^^^1^2^^^3^^^^^^^4^5^6^7^^^8^^^9^a^b^c^d
  

電源電圧の計算方法

• 読み値が170(0xAA)以下の場合
  電源電圧[mV] = 1950+読み値*5

• 読み値が170(0xAA)より大きいの場合

  電源電圧[mV] = 2800+(読み値-170)*10

1.1.1.2.1.1.5 - パル／キュー／アリアアプリ

1.1.1.2.1.1.5.1 - パルアプリ

センサーデータの簡易的な読み方

下記のデータ羅列は、: に始まり改行コードまでの１６進数データをテキストで表現したものです。

    :80000000CF7F7382019E3B0180050F003400038135001205040406000000113008020B8611300102042E000000018015044006FFF00010FC1815044106FFF00018FC1815044206FFF00010FC0015044306FFF80000FC1015044406FFF00010FC1815044506FFE00018FBF815044606FFE80000FC0015044706FFE80010FBF815044806FFE80010FC0815044906FFE80010FC080C0E[CR][LF]
  

上記が逐次解釈する書式ですので、厳密に解釈するのが煩雑です。

そのため、以下に使用するセンサーパルごとのデータのある場所とその抽出例のコードを示します。
その際、: を 0 文字目とします。

データの位置の表記法

以下の説明では、データの位置を示す際、Pythonのリストの指定の表記ような以下の書式でご案内します。

    [データの開始位置:データの開始位置+文字数]
  

例えば、15文字目から4文字を指定する場合は、以下のように表記します。

    [15:15+4]
  

開閉センサーパル

開閉センサーパルからのデータを受信すると以下のような出力メッセージがシリアル出力されます。

    :80000000A8001C82012B1E01808103113008020D0C1130010203E40000000101EC6E[CR][LF]
  

磁気センサーのデータは63文字目から2文字分です。
磁気センサーは下表の値を出力します。

例えば、磁石が近くにない状態から、磁石(N極)が一定期間センサーの近くにある場合、以下のように磁気センサーの値が変化します。

    80 -- 80 -- 80 -- 01(※) -- 81 -- 81 --
  

※ 多くの場合は磁石のN極を検出したときに01になりますが、設置環境によっては、出力値が一定期間安定せず、02や稀に00が出力される場合があります。

また、磁石が近くにあるかだけ知りたい場合は、64文字目だけ確認し、0だったら磁石が近くにない、1または2の時は磁石が近くにあると判定します。

センサーのデータの抽出例

以下は磁気センサーの状態を抜き出すためのPythonの対話モードでの実行例です。
以下の例では、63文字目と64文字目を抜き出して数値に変換し、上表に従って磁気センサーが検出している状態に変換し、標準出力しております。

    
>>> t = ':80000000A8001C82012B1E01808103113008020D0C1130010203E40000000101EC6E'
>>> v = int(t[63:63+2], 16) # 63文字目から2文字取り出し、整数値に変換
>>> periodic = True if (v & 0x80) else False # 定期送信パケットかどうか調べる(Trueだったら定期送信)
>>> status = 'S' if (v & 0x4F) == 2 else 'N' if (v & 0x4F) == 1 else 'Open' # 磁気センサーの状態を取得する。
>>> print('Magnet: %s, %s' % (periodic, status))
Magnet: False, N

アドレスなどのセンサー以外のデータ

出力メッセージは、磁気センサーのデータ以外に以下の情報が含まれております。

    データ位置  データ例   意味
[1:1+8]    80000000  中継機のシリアルID
[9:9+2]    A8        LQI
[11:11+4]  001C      続き番号
[15:15+8]  82012B1E  送信元のシリアルID
[23:23+2]  01        送信元の論理デバイスID
[25:25+2]  80        センサー種別(80で固定)
[27:27+2]  81        PAL基板バージョンとPAL基板ID(開閉センサーパルは81)
  

開閉センサーパルのデータの判別方法

親機・中継機アプリはTWELITE PALからだけではなく、様々なアプリのデータを受信することができるので、出力されたデータがどのアプリのデータか区別する必要があります。

開閉センサーパルの出力メッセージは、改行コード抜きで69文字(改行コードありでは71文字)で、ほかのセンサーパルのデータとは文字数が違うため、文字数で見分けると簡単です。
ただし、シリアル通信アプリなどのように受信メッセージの文字数が決まっていないものもありますので、文字数だけでは見分けられない場合があります。

より厳密に区別するには、文字数と以下の項目を確認してください。

• 1文字目が8であること
• 15文字目が8であること
• 25、26文字目が ‘80’ であること
• 27、28文字目が ‘81’ であること

環境センサーパル

環境センサーパルからのデータを受信すると以下のような出力メッセージがシリアル出力されます。

    :8000000084811F810EFF6D04808205113008020AEB11300102035A0501000209E3010200020E3A02030004000001BE6C00[CR][LF]
  

温度などのセンサーデータは63文字目から94文字目までに含まれております。
各データの位置やデータ形式は以下の通りです。

    データ位置 意味
[63:63+4] 温度(符号付整数、単位は°Cの100倍(23.56°C→2356))
[75:75+4] 湿度(符号無整数、単位は%の100倍(25.99%→2599))
[87:87+8] 照度(符号無整数、単位はLux)
  

以下は、環境センサーパルのデータを取得するためのPythonの対話モードでの実行例です。
出力メッセージから、温度、湿度、照度の文字列を取り出し、数値に変換します。その際、そのままだと符号無の数値ですので、温度は符号付の数値に変換します。
そのあと、センサーのデータを出力しますが、温度と湿度データは100倍されたデータですので、出力時に100で割った値を出力しています。

    
>>> t = ':8000000084811F810EFF6D04808205113008020AEB11300102035A0501000209E3010200020E3A02030004000001BE6C00'
>>> temp = int(t[63:63+4], 16) # 63文字目から4文字取り出し、整数値に変換
>>> temp = (-65536 + temp) if temp >= 32768 else temp # 符号付き16ビット整数の対応
>>> hum = int(t[75:75+4], 16)
>>> illum = int(t[87:87+8], 16)
>>> print('temperature: %f' % ( temp/100.0 ))
temperature: 25.310000
>>> print('humidity: %f' % ( hum/100.0 ))
humidity: 36.420000
>>> print('illuminance: %d' % illum)
illuminance: 446

アドレスなどのセンサー以外のデータ

出力メッセージは、温湿度、照度センサーのデータ以外に以下の情報が含まれております。

    データ位置  データ例   意味
[1:1+8]    80000000  中継機のシリアルID
[9:9+2]    84        LQI
[11:11+4]  8114      続き番号
[15:15+8]  810EFF6D  送信元のシリアルID
[23:23+2]  04        送信元の論理デバイスID
[25:25+2]  80        センサー種別(80で固定)
[27:27+2]  82        PAL基板バージョンとPAL基板ID(開閉センサーパルは81)
  

環境センサーパルのデータの判別方法

親機・中継機アプリはTWELITE PALからだけではなく、様々なアプリのデータを受信することができるので、出力メッセージがどのアプリの出力か区別する必要があります。

環境センサーパルの出力メッセージは、改行コード抜きで99文字(改行コードありでは101文字)で、ほかのセンサーパルなどのデータとは文字数が違うため、文字数で見分けると簡単です。
ただし、シリアル通信アプリなどのように受信メッセージの文字数が決まっていないものもありますので、文字数だけでは見分けられない場合があります。

より厳密に区別するには、文字数と以下の項目を確認してください。

• 1文字目が8であること
• 15文字目が8であること
• 25、26文字目が ‘80’ であること
• 27、28文字目が ‘82’ であること

動作センサーパル

動作センサーパルからのデータを受信すると以下のような出力メッセージがシリアル出力されます。

    :80000000BA002382011CEF01808312113008020D0211300102055C1504400600100010045015044106000800100430150442060000001004381504430600080018043015044406000000180458150445060000002004381504460600080018042815044706FFE80010042015044806FFF00010043815044906FFE80018043015044A06FFF80018044015044B06FFF80018041815044C0600000010042015044D0600000028045015044E0600000008043815044F0600000018043828A5[CR][LF]
  

加速度データは63文字目から時系列順でX、Y、Zに並んだ加速度が16個分格納されます。
加速度は、符号付整数で単位はmg(1重力加速度(g)の1/1000)です。
＊データが12文字、ヘッダが8文字で、20文字ごとにデータが並びます。

    データ位置    データ例      意味
[63:63+12]   001000100450 データ１ 0010(X軸)/0010(Y軸)/0450(Z軸)
[83:83+12]   000800100430 データ２ 0008(X軸)/0010(Y軸)/0430(Z軸)
[103:103+12] 000000100438 ...
[123:123+12] 000800180430
[143:143+12] 000000180458
[163:163+12] 000000200438
[183:183+12] 000800180428
[203:203+12] FFE800100420
[223:223+12] FFF000100438
[243:243+12] FFE800180430
[263:263+12] FFF800180440
[283:283+12] FFF800180418
[303:303+12] 000000100420
[323:323+12] 000000280450
[343:343+12] 000000080438
[363:363+12] 000000180438 データ16
  

以下は、1サンプル目の加速度を取得するためのPythonの対話モードでの実行例です。
出力メッセージから、1サンプル目の加速度の文字列を取り出し、数値に変換します。その際、そのままだと符号無の数値ですので、符号付の数値に変換します。
変換後、加速度データを出力します。

    
>>> t = ':80000000BA002382011CEF01808312113008020D0211300102055C1504400600100010045015044106000800100430150442060000001004381504430600080018043015044406000000180458150445060000002004381504460600080018042815044706FFE80010042015044806FFF00010043815044906FFE80018043015044A06FFF80018044015044B06FFF80018041815044C0600000010042015044D0600000028045015044E0600000008043815044F0600000018043828A5'
>>> x = int(t[63:63+4], 16) # 63文字目から4文字取り出し、整数値に変換(X軸)
>>> x = (-65536 + x) if x >= 32768 else x # 符号付き16ビット整数の対応
>>> y = int(t[67:67+4], 16) # 67文字目から4文字取り出し、整数値に変換(Y軸)
>>> y = (-65536 + y) if y >= 32768 else y # 符号付き16ビット整数の対応
>>> z = int(t[71:71+4], 16) # 63文字目から4文字取り出し、整数値に変換(Z軸)
>>> z = (-65536 + z) if z >= 32768 else z # 符号付き16ビット整数の対応
>>> print('x:%d, y:%d, z:%d' % ( x, y, z ))
x:16, y:16, z:1104

アドレスなどのセンサー以外のデータ

出力メッセージは、加速度センサーのデータ以外に以下の情報が含まれております。

    データ位置  データ例   意味
[1:1+8]    80000000  中継機のシリアルID
[9:9+2]    BA        LQI
[11:11+4]  0023      続き番号
[15:15+8]  82011CEF  送信元のシリアルID
[23:23+2]  01        送信元の論理デバイスID
[25:25+2]  80        センサー種別(80で固定)
[27:27+2]  83        PAL基板バージョンとPAL基板ID(開閉センサーパルは81)
  

動作センサーパルのデータの判別方法

親機・中継機アプリはTWELITE PALからだけではなく、様々なアプリのデータを受信することができるので、出力メッセージがどのアプリのデータか区別する必要があります。

動作センサーパルの出力メッセージは、改行コード抜きで379文字(改行コードありでは381文字)で、ほかのセンサーパルなどのデータとは文字数が違うため、文字数で見分けると簡単です。
ただし、シリアル通信アプリなどのように出力メッセージの文字数が決まっていないものもありますので、文字数だけでは見分けられない場合があります。

より厳密に区別するには、文字数と以下の項目を確認してください。

• 1文字目が8であること
• 15文字目が8であること
• 25、26文字目が ‘80’ であること
• 27、28文字目が ‘83’ であること

出力例

以下は、パルごとのデータの出力例です。

開閉センサーパル

    :80000000A8001C82012B1E01808103113008020D0C1130010203E40000000101EC6E
 ^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8​^9^a^b^c^^^d^e^f^g^h^^^i^j^k^l^m^n^o^p
 0                   10                  20                  30
  

環境センサーパル

    ​:8000000084811F810EFF6D04808205113008020AEB11300102035A0501000209E3010200020E3A02030004000001BE6C00
 ​^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8^9^a^b^c^^^d^e^f^g^h^^^i^j^k^l^m^^^n^o^p^q^r^^^s^t^u^v^w^^^^^^^x^y^z
 0                   10                  20                  30                  40
  

動作センサーパル

出力例

    :80000000BA002382011CEF01808312113008020D0211300102055C1504400600100010045015044106000800100430150442060000001004381504430600080018043015044406000000180458150445060000002004381504460600080018042815044706FFE80010042015044806FFF00010043815044906FFE80018043015044A06FFF80018044015044B06FFF80018041815044C0600000010042015044D0600000028045015044E0600000008043815044F0600000018043828A5
 ​^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8^9^a^b^c^^^d^e^f^g^h^^^i^j^k^l^m^^^^^^^^^^^n^o^p^q^r^^^^^^^^^^^s  ...                                                                                                                                                                                                                                                               ^t^u^v^w^^^^^^^^^^^x^y^z
 0                   10                  20                  30                  40                  50                  60                  70                  80                  90                  100                 110                 120                 130                 140                 150                 160                 170                 180
  

通知パル

    :80000000C9BBC082014C3501808403113008020D0C1130010203F9120504041000000097C6
 ^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8^9^a^b^c^^^d^e^f^g^h^^^i^j^k^l^m^n^^^^^o^p^q
 0                   10                  20                  30
  

1.1.1.2.1.1.5.2 - キューアプリ

TWELITE CUEには加速度センサーと磁気センサーが搭載されており、両方のセンサーのデータも出力メッセージに含まれます。

このページでは出力メッセージからそれらのセンサーデータの読み方について解説します。

センサーデータの簡易的な読み方

下記のデータ羅列は、: に始まり改行コードまでの１６進数データをテキストで表現したものです。

    :80000000CF7F7382019E3B0180050F003400038135001205040406000000113008020B8611300102042E000000018015044006FFF00010FC1815044106FFF00018FC1815044206FFF00010FC0015044306FFF80000FC1015044406FFF00010FC1815044506FFE00018FBF815044606FFE80000FC0015044706FFE80010FBF815044806FFE80010FC0815044906FFE80010FC080C0E[CR][LF]
  

上記は逐次解釈する書式ですので、厳密に解釈するのは煩雑です。

そのため、各センサーの値の場所とその抽出例をご説明します。
その際、: を 0 文字目とします。

データの位置の表記法

以下の説明では、データの位置を示す際、Pythonのリストの指定の表記ような以下の書式でご案内します。

    [データの開始位置:データの開始位置+文字数]
  

例えば、15文字目から4文字を指定する場合は、以下のように表記します。

    [15:15+4]
  

加速度

加速度データは103文字目から時系列順でX、Y、Zに並んだ加速度が10個分格納されます。
加速度は、符号付整数で単位はmg(1重力加速度(g)の1/1000)です。
＊データが12文字、ヘッダが8文字で、20文字ごとにデータが並ぶ。

    [93:93+2]    80           磁気センサー
[103:103+12] FFF00010FC18 データ１ FFF0(X軸)/0010(Y軸)/FC18(Z軸)
[123:123+12] FFF00018FC18 データ２ FFF0(X軸)/0018(Y軸)/FC18(Z軸)
[143:143+12] FFF00010FC00 ...
[163:163+12] FFF80000FC10
[183:183+12] FFF00010FC18
[203:203+12] FFE00018FBF8
[223:223+12] FFE00018FBF8
[243:243+12] FFE80010FBF8
[263:263+12] FFE80010FC08
[283:283+12] FFE80010FC08 データ10
  

磁気センサー

磁気センサーは93文字目から2文字分です。
磁気センサーは下表の値を出力します。

例えば、磁石が近くにない状態から、磁石(N極)が一定期間センサーの近くにある場合、以下のように磁気センサーの値が変化します。

    80 -- 80 -- 80 -- 01(※) -- 81 -- 81 --
  

※ 多くの場合は磁石のN極を検出したときに01になりますが、設置環境によっては、出力値が一定期間安定せず、02や稀に00が出力される場合があります。

また、磁石が近くにあるかだけ知りたい場合は、94文字目だけ確認し、0だったら磁石が近くにない、1または2の時は磁石が近くにあると判定します。

センサーのデータの抽出例

1サンプル目の加速度と磁気センサーのデータを取得するPythonの対話モードでの実行例です。
シリアルメッセージから、1サンプル目の加速度の文字列を取り出し、数値に変換します。その際、そのままだと符号無の数値ですので、符号付の数値に変換します。
磁気センサーのデータをシリアル出力から抜き出し、上表に従って磁気センサーが検出している状態に変換し、加速度データと磁気センサーの情報を標準出力しております。

    
>>> t =':80000000CF7F7382019E3B0180050F003400038135001205040406000000113008020B8611300102042E000000018015044006FFF00010FC1815044106FFF00018FC1815044206FFF00010FC0015044306FFF80000FC1015044406FFF00010FC1815044506FFE00018FBF815044606FFE80000FC0015044706FFE80010FBF815044806FFE80010FC0815044906FFE80010FC080C0E'
>>> x = int(t[103:103+4], 16) # 103文字目から4文字(データ1のX軸)取り出し整数値へ変換
>>> x = (-65536 + x) if x >= 32768 else x # 符号付き16ビット整数の対応
>>> y = int(t[107:107+4], 16) # 103文字目から4文字(データ1のX軸)取り出し整数値へ変換
>>> y = (-65536 + y) if y >= 32768 else y # 符号付き16ビット整数の対応
>>> z = int(t[111:111+4], 16) # 103文字目から4文字(データ1のX軸)取り出し整数値へ変換
>>> z = (-65536 + z) if z >= 32768 else z # 符号付き16ビット整数の対応
>>> print("x=%d, y=%d, z=%d" % (x, y, z))
x=-16, y=16, z=-1000
>>> v = int(t[93:93+2], 16) # 63文字目から2文字取り出し、整数値に変換
>>> periodic = True if (v & 0x80) else False # 定期送信パケットかどうか調べる(Trueだったら定期送信)
>>> status = 'S' if (v & 0x4F) == 2 else 'N' if (v & 0x4F) == 1 else 'Open' # 磁気センサーの状態を取得する。
>>> print('Magnet: %s, %s' % (periodic, status))
Magnet: True, Open

アドレスなどのセンサー以外のデータ

出力メッセージは、加速度、磁気センサーのデータ以外に以下の情報が含まれております。

    データ位置  データ例   意味
[1:1+8]    80000000  中継機のシリアルID
[9:9+2]    AE        LQI
[11:11+4]  0098      続き番号
[15:15+8]  810B6492  送信元のシリアルID
[23:23+2]  01        送信元の論理デバイスID
[25:25+2]  80        センサー種別(80で固定)
[27:27+2]  05        PAL基板バージョンとPAL基板ID(TWELITE CUEは05)
  

開閉センサーパルのデータの判別方法

親機・中継機アプリはTWELITE PALからだけではなく、様々なアプリのデータを受信することができるので、出力されたデータがどのアプリのデータか区別する必要があります。

TWELITE CUEの出力メッセージは、改行コード抜きで299文字(改行コードありでは301文字)で、ほかのセンサーパルのデータとは文字数が違うため、文字数で見分けると簡単です。
ただし、シリアル通信アプリなどのように受信メッセージの文字数が決まっていないものもありますので、文字数だけでは見分けられない場合があります。

より厳密に区別するには、文字数と以下の項目を確認してください。

• 1文字目が8であること
• 15文字目が8であること
• 25、26文字目が ‘80’ であること
• 27、28文字目が ‘05’ であること

TWELITE CUEモード

出力例

    :80000000B1001B810B64650180050F003400038135001205040403000000113008020D3411300102052E000000018015044006FC28FFB0001815044106FC28FFB0000815044206FC30FFB0FFF815044306FC30FFC0FFF815044406FC28FFB0000015044506FC38FFA8001015044606FC30FFB0FFF015044706FC30FFB8FFD815044806FC20FFB0000015044906FC40FFA80018A62C
 ^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8^^^^^^^^^^^^^9^^^^^^^^^^^^^^^a^^^^^^^b^^^c^^^^^^^d^^^e^^^^^^^f^g^^^^^^^h^^^i^^^j^^^k^^^^^^^l^^^m^^^n^^^o                                                                                                                                                                ^p^q
  

パケットプロパティ

    00340003810402
^1^2^3^4^5^6^7
  

イベント

    1205040410000000
^1^2^3^4^5^6^7^8
  

1.1.1.2.1.1.5.3 - アリアアプリ

TWELITE ARIAには温湿度センサーと磁気センサーが搭載されており、両方のセンサーのデータも出力メッセージに含まれます。

このページでは出力メッセージからそれらのセンサーデータの読み方について解説します。

センサーデータの簡易的な読み方

下記のデータ羅列は、: に始まり改行コードまでの１６進数データをテキストで表現したものです。

    :80000000CF00028201BAA201800607003400038135001205350401000000113008020D201130010204ED00000001800501000209D0010200020F347934[CR][LF]
  

上記は逐次解釈する書式ですので、厳密に解釈するのは煩雑です。

そのため、各センサーの値の場所とその抽出例をご説明します。
その際、: を 0 文字目とします。

データの位置の表記法

以下の説明では、データの位置を示す際、Pythonのリストの指定の表記ような以下の書式でご案内します。

    [データの開始位置:データの開始位置+文字数]
  

例えば、15文字目から4文字を指定する場合は、以下のように表記します。

    [15:15+4]
  

温湿度センサー

温度などのセンサーデータは103文字目から118文字目までに含まれております。
各データの位置やデータ形式は以下の通りです。

    データ位置   意味
[103:103+4] 温度(符号付整数、単位は°Cの100倍(23.56°C→2356))
[115:115+4] 湿度(符号無整数、単位は%の100倍(25.99%→2599))
  

磁気センサー

磁気センサーは93文字目から2文字分です。
磁気センサーは下表の値を出力します。

例えば、磁石が近くにない状態から、磁石(N極)が一定期間センサーの近くにある場合、以下のように磁気センサーの値が変化します。磁石(N極)が一定期間センサーの近くにある場合、以下のように磁気センサーの値が変化します。

    80 -- 80 -- 80 -- 01(※) -- 81 -- 81 --
  

※ 多くの場合は磁石のN極を検出したときに01になりますが、設置環境によっては、出力値が一定期間安定せず、02や稀に00が出力される場合があります。

また、磁石が近くにあるかだけ知りたい場合は、94文字目だけ確認し、0だったら磁石が近くにない、1または2の時は磁石が近くにあると判定します。

センサーのデータの抽出例

以下は、温湿度と磁気センサーのデータを取得するPythonの対話モードでの実行例です。
出力メッセージから、温度、湿度、照度の文字列を取り出し、数値に変換します。その際、そのままだと符号無の数値ですので、温度は符号付の数値に変換します。
そのあと、センサーのデータを出力しますが、温度と湿度データは100倍されたデータですので、出力時に100で割った値を出力しています。
また、磁気センサーのデータをシリアル出力から抜き出し、上表に従って磁気センサーが検出している状態に変換し、加速度データと磁気センサーの情報を標準出力しております。

    
>>> t = ':80000000CF00028201BAA201800607003400038135001205350401000000113008020D201130010204ED00000001800501000209D0010200020F347934'
>>> temp = int(t[103:103+4], 16) # 63文字目から4文字取り出し、整数値に変換
>>> temp = (-65536 + temp) if temp >= 32768 else temp # 符号付き16ビット整数の対応
>>> hum = int(t[115:115+4], 16)
>>> print('temperature: %f, humidity: %f' % ( temp/100.0, hum/100.0 ))
temperature: 25.120000, humidity: 38.920000
>>> v = int(t[93:93+2], 16) # 93文字目から2文字取り出し、整数値に変換
>>> periodic = True if (v & 0x80) else False # 定期送信パケットかどうか調べる(Trueだったら定期送信)
>>> status = 'S' if (v & 0x4F) == 2 else 'N' if (v & 0x4F) == 1 else 'Open' # 磁気センサーの状態を取得する。
>>> print('Magnet: %s, %s' % (periodic, status))
Magnet: True, Open

アドレスなどのセンサー以外のデータ

出力メッセージは、センサーのデータ以外に以下の情報が含まれております。

    データ位置  データ例   意味
[1:1+8]    80000000  中継機のシリアルID
[9:9+2]    CF        LQI
[11:11+4]  0002      続き番号
[15:15+8]  8201BAA2  送信元のシリアルID
[23:23+2]  01        送信元の論理デバイスID
[25:25+2]  80        センサー種別(80で固定)
[27:27+2]  06        PAL基板バージョンとPAL基板ID(TWELITE ARIAは06)
  

TWELITE ARIAのデータの判別方法

親機・中継機アプリはTWELITE PALからだけではなく、様々なアプリのデータを受信することができるので、出力メッセージがどのアプリの出力か区別する必要があります。

TWELITE ARIAの出力メッセージは、改行コード抜きで123文字(改行コードありでは125文字)で、ほかのセンサーパルなどのデータとは文字数が違うため、文字数で見分けると簡単です。
ただし、シリアル通信アプリなどのように受信メッセージの文字数が決まっていないものもありますので、文字数だけでは見分けられない場合があります。

より厳密に区別するには、文字数と以下の項目を確認してください。

• 1文字目が8であること
• 15文字目が8であること
• 25、26文字目が ‘80’ であること
• 27、28文字目が ‘06’ であること

TWELITE ARIAモード

出力例

    :80000000CF00028201BAA201800607003400038135001205350401000000113008020D201130010204ED00000001800501000209D0010200020F347934
 ^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8^^^^^^^9^^^^^a^^^^^^^b^^^^^^^c^^^^^^^d^^^e^^^^^^^f^^^g^^^^^^^h^i^^^^^^^j^^^k^^^^^^^l^^^m^n^o
  

1.1.1.2.1.1.5.4 - 出力書式の詳細

出力書式

    :80000000A8001C82012B1E01808103113008020D0C1130010203E40000000101EC6E
 ^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^​^9^a^b
  

センサーデータ

センサーデータは以下のような構成で表記されます。

    113008020D0C
^1^2^3^4^^^5
  

情報ビット

データの型や拡張バイトの有無、読み込みエラーの有無を示すデータです。
読み方は以下の通りです。

データソース

データの種類を示します。

拡張バイト

何サンプル目のデータか、ADCの何番目のデータかなどデータの補助的な値が格納されます。

データ長

データのバイト数を示します。

データ

センサーの実データが格納されています。

1.1.1.2.1.1.5.5 - パルアプリ

出力書式

    
:80000000A8001C82012B1E01808103113008020D0C1130010203E40000000101EC6E
 ^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^​^9^a^b

センサーデータ

センサーデータは以下のような構成で表記されます。

    
113008020D0C
^1^2^3^4^^^5

情報ビット

データの型や拡張バイトの有無、読み込みエラーの有無を示すデータです。 読み方は以下の通りです。

データソース

データの種類を示します。

拡張バイト

何サンプル目のデータか、ADCの何番目のデータかなどデータの補助的な値が格納されます。

データ長

データのバイト数を示します。

データ

センサーの実データが格納されています。

出力例

以下は、パルごとのデータの出力例です。

開閉センサーパル

    
:80000000A8001C82012B1E01808103113008020D0C1130010203E40000000101EC6E
 ^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8​^9^a^b^c^^^d^e^f^g^h^^^i^j^k^l^m^n^o^p
 0                   10                  20                  30

環境センサーパル

    
​:8000000084811F810EFF6D04808205113008020AEB11300102035A0501000209E3010200020E3A02030004000001BE6C00
 ​^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8^9^a^b^c^^^d^e^f^g^h^^^i^j^k^l^m^^^n^o^p^q^r^^^s^t^u^v^w^^^^^^^x^y^z
 0                   10                  20                  30                  40

動作センサーパル

出力例

    
:80000000BA002382011CEF01808312113008020D0211300102055C1504400600100010045015044106000800100430150442060000001004381504430600080018043015044406000000180458150445060000002004381504460600080018042815044706FFE80010042015044806FFF00010043815044906FFE80018043015044A06FFF80018044015044B06FFF80018041815044C0600000010042015044D0600000028045015044E0600000008043815044F0600000018043828A5
 ​^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8^9^a^b^c^^^d^e^f^g^h^^^i^j^k^l^m^^^^^^^^^^^n^o^p^q^r^^^^^^^^^^^s  ...                                                                                                                                                                                                                                                               ^t^u^v^w^^^^^^^^^^^x^y^z
 0                   10                  20                  30                  40                  50                  60                  70                  80                  90                  100                 110                 120                 130                 140                 150                 160                 170                 180

通知パル

    
:80000000C9BBC082014C3501808403113008020D0C1130010203F9120504041000000097C6
 ^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8^9^a^b^c^^^d^e^f^g^h^^^i^j^k^l^m^n^^^^^o^p^q
 0                   10                  20                  30

1.1.1.2.1.1.6 - アクト

データフォーマット

    
:FEAA008201015A00000000B7000F424154310F0CEE000B03FF03FF03FF92
​ ^1^2^3^^^^^^^4^^^^^^^5^6^^^7^^^^^^^^^^^^^^^^^^^^^^^^^^^^^8^9

1.1.1.2.1.2 - 送信コマンド

コマンドを入力することで子機に対して電波を送信することができます。

送信できるコマンドは以下のページをご覧ください。

1.1.1.2.1.2.1 - 0x90コマンド

    :0190010004000169[CR][LF]
 ^1^2^3^^^^^^^4^5
  

コマンドパラメータ

4バイトのコマンドパラメータを組み合わせてコマンドを指定します。

0x00：イベントIDを送信する

TWELITE PALは受信したイベントIDごとの振る舞いが設定されております。 本パラメータでは送信先のTWELITE PALにイベントIDを送信し、設定した動作を行います。

0x01 : LEDの色、点滅パターン、明るさを送信する

送信先の通知パルにLEDの色、点滅パターン、明るさを送信します。

0x02 : 点灯時間を送信する

通知パルのLEDの点灯時間を送信します。

0x03：LEDの色をRGBWで指定する

通知パルのLEDの点灯色をRGBWで送信します。

0x04：点滅パラメータを指定する。

通知パルのLEDの点滅周期と点滅Dutyを送信します。

コマンド例

例1：イベントを送信する

論理デバイスIDが1のNOTICE PALに対してイベント1を送信するコマンド例です。

    :0190010004000169
 ^1^2^3^4^5^6^7^8
  

例2：通知パルのLEDの点灯色を送信する

論理デバイスIDが1のNOTICE PALに対して明るさ8で白色にゆっくり点滅させるためのコマンドです。

    :019001010601085E
 ^1^2^3^4^5^6^7^8
  

例3：通知パルのLEDの点灯色と点灯時間を送信する。

論理デバイスIDが1のNOTICE PALに対して紫に点灯させ、点灯後1秒で消灯させるコマンドです。

    :0190020104000802FF00015E
 ^1^2^3^4^5^6^7^8^9^a^b^c
  

例4：通知パルに詳細な点灯色送信する。

論理デバイスIDが1のNOTICE PALに対して紫に点灯させるコマンドです。

    :01900103FF0F0459
 ^1^2^3^4^5^^^6^7
  

例5：通知パルのLEDの点灯色と点灯時間を送信する。

論理デバイスIDが1のNOTICE PALに対して紫に点灯させ、点灯後1秒で消灯させるコマンドです。

    :0190020104000802FF00015E
 ^1^2^3^4^5^6^7^8^9^a^b^c
  

1.1.1.2.2 - 中継機モード

設定例

中継機として使用する場合、以下のようにインタラクティブモードで動作モード(l)を1以上に設定してください。

     a: (AID=0x67720102) Application ID1 [HEX:32bit]
 C: (CHL=18        ) Channels Set
 x: (PWR=      0x03) RF Power/Retry [HEX:8bit]
 b: (UOP=38400,8N1 ) UART Baud [9600-230400]
 o: (OPT=0x00000000) Option Bits [HEX:32bit]
 k: (KEY=0xA5A5A5A5) Encryption Key [HEX:32bit]
 l:$(MOD=         1) Mode (Parent or Router)
 A: (ADR=0x00000000) Access point address [HEX:32bit]
  

詳しい説明は以下のページをご覧ください。

インタラクティブモード

中継方式

TWELITE NETでは無線パケットの中継配送について、大きく分けて下表で示す2つの方式を用意しており、アプリケーションごとに異なります。本アプリでは下表で示すアプリケーションのパケットを識別し、中継することができます。

単純ネットを使用した中継

単純ネットを使用するアプリの中継を行う場合、動作モードの値を1以上に設定することで3回まで中継することができます。

例えば、1. のように親機と子機の間に中継機が3台以内であれば親機にデータが届きますが、2. ように中継機が4台以上ある場合は親機にデータが届きません。

1. 子機 —> 中継機 —> 中継機 —> 中継機 —> 親機
   → 親機が子機のデータを3回中継して受信できる。
2. 子機 —> 中継機 —> 中継機 —> 中継機 —> 中継機 -x-> 親機
   → 中継4回目で中継することをやめる。

単純ネットによる中継は、基本的に同報通信を使用して通信を行い、受信したパケットをすべて中継を行います。そのため、中継ネットワークを形成、維持するための通信が必要ないという利点がありますが、中継機が増えるほど爆発的に通信量が多くなることがあるという欠点もあります。

詳しくは こちら を参照ください。

中継ネットを使用した中継

中継ネットを使用するアプリのデータを1段の中継を行う場合、動作モードの値を1に設定してしてください。

複数回の中継を行う場合は、親機から遠くなるにつれて動作モードの設定値を大きくしてください。(設定値が昇順になっていれば設定値が飛んでもかまいません。)

本方式の最大中継回数は63回までです。

例1：1回の中継を行う場合
子機 —> 中継機(動作モード：1) —> 親機

例2：2回の中継を行う場合
子機 —> 中継機(動作モード：2) —> 中継機(動作モード：1) —> 親機

例3：3回の中継を行う場合
子機 —> 中継機(動作モード：6) —> 中継機(動作モード：3) —> 中継機(動作モード：1) —> 親機

中継ネットは上り方向の配送を効率的に実施する目的を持って設計されたツリー型ネットワークで、中継機は上位レイヤ(より動作モードの設定値が小さい親機もしくは中継機)を探索し、発見した上位レイヤ1台に対して中継を行います。

そのため、中継機の台数が増えても単純ネットほどは通信量が多くなりにくいですが、接続先を探索、維持するための通信が発生します。

詳しくは こちら をご覧ください。

静的ルーティング（中継先を直接指定）をする場合

中継ネットでの中継を行うときに、下図のような配置を考えた場合、中継機2の接続先は親機もしくは中継機1のどちらかを自動的に選択します。

基本的には、中継する回数が少ない方が親機への配送率が高くなる場合が多いですが、中継機2の接続先として親機が選択されてしまった場合、親機と中継機2の間に障害物があるため、通信品質が悪くなり、親機への配送率が中継機1を経由するときより低くなる可能性が高くなります。

そのため、本アプリには中継機の接続先を TWELITE のシリアル番号で指定する機能 (静的ルーティング機能) があります。

静的ルーティングを行う場合は、中継機２→中継機１への経路を静的にする、または全ての経路を静的に設定します。

すべての経路の設定にはその分だけ設定が多くなり、また、中継機の故障や電波状況の変化といった状況を想定した冗長化に対応できない点がありますが、上位通信先を確定するまでの時間をなくし、速やかに中継動作に移行できる利点があります。

静的ルーティングをするには下表のように中継機1には親機のSID、中継機2には中継機1のSIDになるように接続先を設定してください。

例: 2段中継の場合 (親機 ← 中継機1 ← 中継機2 ← 子機)

※上図の壁による影響のみに対処したい場合は設定不要です。

1.1.1.3 - インタラクティブモード

インタラクティブモードでアプリの詳細設定を行うことができます。

インタラクティブモードに入るには、パソコン上のターミナルソフトから + + + と + を３回入力します。+ と + の間には 0.2 秒から 1.0 秒の間隔をあけてください。
また、TWELITE プログラマや TWELITE STAGE には簡単にインタラクティブモードに入れるショートカット機能もありますので、そちらもご利用ください。

インタラクティブモードに入ると以下の画面が表示されます。

    [CONFIG MENU/App_Wings:PARENT:0/v1-00-1/SID=82011098]
a: (AID=0x67720102) Application ID1 [HEX:32bit]
c: (CHL=18        ) Channels Set
x: (PWR=      0x03) RF Power/Retry [HEX:8bit]
b: (UOP=38400,8N1 ) UART Baud [9600-230400]
o: (OPT=0x00000000) Option Bits [HEX:32bit]
k: (KEY=0xA5A5A5A5) Encryption Key [HEX:32bit]
m: (MOD=         0) Mode (Parent or Router)
A: (ADR=0x00000000) Access point address [HEX:32bit]

 [ESC]:Back [!]:Reset System [M]:Extr Menu
  

設定コマンド一覧

オプションビットの設定

オプションビット設定値を各ビットごとに解説します。

TWELITE APPS のアプリケーションIDと周波数チャンネルの初期設定値

本アプリが初期設定の時は超簡単！標準アプリと通信できるようになっておりますが、アプリケーション ID と周波数チャンネルを通信相手の TWELITE に合わせることでほかの TWELITE APPS とも通信することができます。下表は TWELITE APPS のアプリケーション ID と周波数チャンネルの初期設定値なので、これを参考に本アプリを設定してください。

異なる複数の TWELITE APPS のデータを同時に受信する場合

本アプリは異なる TWELITE APPS の電波が混在していても、アプリケーション ID と周波数チャンネルをそろえていただければ受信することできます。例えば、超簡単！標準アプリの子機とパルアプリの子機がそれぞれある場合に、アプリケーションIDと周波数チャンネルをすべての TWELITE でそろえれば、本アプリがインストールされた TWELITE で子機の電波を受信・中継が可能になります。
その際は、下表の例のように設定を行います。

1.2 - シリアル通信アプリ マニュアル

1.2.1 - シリアル通信アプリ マニュアル

シリアル通信アプリ（App_Uart）は、UART（シリアル）通信に特化したアプリケーションです。UARTはマイコンで一般的に利用されるシリアル通信方式です。

TWELITE UARTには本アプリがあらかじめインストールされており、配線すればすぐにマイコン等で無線通信をすることができます。

ダウンロード

TWELITE STAGE - トワイライトステージ をインストールして、TWELITE STAGEのメニューから[アプリ書換] → [TWELITE APPSビルド&書換] → [App_Uart]を選択してアプリを書換えてください。

1.2.1.1 - ピン割り当て

本解説で使用するピン名は、超簡単！標準アプリの名前定義 (M1-M3, BPS, TX, RX, I1-I4) を用います。以下に各TWELITEの配列を記載します。

ピン配列表(v1.2以降)

TWELITE/TWELITE DIP

※ DIO番号は半導体データシートに基づく信号名で、ピン番号ではありません。TWELITE DIP の場合はピンに記載されるシルクの数字記載が DIO 番号です。

※ オープンは Hi レベルでも可。設計上必要と考える場合はプルアップ(10k～100kΩ)してください。
※ Lo は GND レベル。設計上必要と考える場合はプルダウン(100Ω程度)してください。
※ 未使用ピンはオープンにしてください。

TWELITE UART

各部の説明はこちら をご確認ください。

1.2.1.2 - 使用方法

1.2.1.2.1 - 動作確認

必要なもの

MONOSTICKとTWELITE UARTを使用する場合

1. TWELITE UART
2. TWELITE R2
3. USBケーブル (充電専用不可)
4. MONOSTICK

TWELITE UARTを2つ使用する場合

1. TWELITE UART x 2
2. TWELITE R2 x 2
3. USBケーブル (充電専用不可) x 2

TWELITE STAGE SDKの準備

まず最初にTWELITE STAGE SDK の最新版をパソコンにインストールします。

MONOSTICKの準備

TWELITE UARTを2つ使用して動作確認をする場合は、ここを読み飛ばしてください。

TWELITE STAGE APPを起動する

1. MONOSTICKをパソコンのUSBポートに接続します。

2. インストールしたTWELITE STAGE SDKのMWSTAGEフォルダ内の以下のファイルをダブルクリックしてください。
・TWELITE_stage.exe（Windows）
・TWELITE_stage.command（macOS）
・TWELITE_stage.run（Linux）
起動するとUSBに接続されたMONOSTICKが画面上に表示されます。

3. シリアルポート選択画面から 1: MONOSTICK を選択してください。

4. デバイスを選択するとTWELITE STAGE APPのトップメニュー画面が表示されます。

シリアル通信アプリを書き込む

通信相手としてMONOSTCK - モノスティック を使用することができます。
以下の手順でシリアル通信アプリをMONOSTICK - モノスティックに書き込んでください。

1. トップメニューから 2:アプリの書換 > 1:BINから選択を選択してください。

2. MONOSTICK BLUE を使用している場合はApp_Uart_BLUE… _を選択し、_MONOSTICK RED _を使用している場合は_App_Uart_RED… を選択してください。

3. 書き込み完了後はインタラクティブモードに入らずにESCキーを長押ししてトップメニューに戻ってください。

4. トップメニューから 1:ビューア> 1: ターミナル を選択します。

TWELITE UARTの準備

TWELITE UARTを2つ使用する場合は、以下の作業を2回行ってください。

TWELITE R2と接続する

図のようにTWELITE R2とTWELITE UARTを接続します。

接続できたら、TWELITE R2のUSBコネクターに通信ができるUSBケーブルを接続してください。

TWELITE STAGE APPを起動する

1. TWELITE R2に接続されているUSBケーブルをパソコンのUSBポートに接続します。

2. インストールしたTWELITE STAGE SDKのMWSTAGEフォルダ内の以下のファイルをダブルクリックしてください。
・TWELITE_stage.exe（Windows）
・TWELITE_stage.command（macOS）
・TWELITE_stage.run（Linux）
起動するとUSBに接続されたTWELITE R2が画面上に表示されます。

3. シリアルポート選択画面から1: TWELITE R2を選択してください。

4. デバイスを選択するとTWELITE STAGE APPのトップメニュー画面が表示されます。

5. トップメニューから 1:ビューア> 1: ターミナル を選択します。

ターミナルを開くと上図のように出力されます。

通信を確認する

TWELITE UARTにHELLO<Enter>と入力すると、MONOSTICKに補助情報が含まれた形でHELLOが表示されます。TWELITE UARTにも出力が出ますが、これは送信完了を示すメッセージです。

MONOSTICKからも同様にメッセージを送信できます。

    [送信側]
HELLO                                           <- 入力
;U;00818;219;0x81025A17;000;013;13,1,HEL...;55; <- 出力

[受信側]
;U;00777;120;0x81025A17;120;013;HELLO;26;       <-出力
  

1.2.1.2.2 - 出力書式

初期設定

初期モードではインタラクティブモードのh: set header formatを設定することで書式を自由に設定できます。

初期設定では、書式が以下のように設定されています。

    ;U;%t;%i;0x%A;%q;%s;<*>;%X;\n
  

この設定の意味は以下の通りです。

例えば送信側からHELLO<Enter>と入力した場合、出力側からは以下のように出力され、それぞれのデータの意味は下表の通りです。

    ;U;00777;120;0x81025A17;120;013;HELLO;79;
;1;2----;3--;4---------;5--;6--;7----;8-;
  

出力の設定の詳細については出力のカスタマイズ をご覧ください。

出力の変更例

実際に設定を変更してみましょう。

例えば、Excelで取り扱いやすくするためにカンマ(,)でデータを区切り、付加情報を送信機のシリアル番号と電波強度、続き番号のみにすると設定は以下のようになります。

    --- CONFIG/TWE UART APP V1-04-5/SID=0x82018ca0/LID=0x78 -- ---
...
 h: set header format [%A,%q,%s,*\n]
...
---
 S: save Configuration
 R: reset to Defaults
  

この設定をし、送信側からHELLO<Enter>と入力した場合、出力側からは以下のように出力されます。

    81025A17,120,013,HELLO
  

1.2.1.2.3 - マイコンとの接続

シリアル通信を行う

PCからArudinoに入力したシリアルデータをTWELITE UARTを介して、もう一台のArduinoに無線で送信し、そのデータを解釈するサンプルです。

用意する電子部品

以下のものを2セット用意してください。

1. TWELITE UART
2. Arduino UNO
3. 抵抗 2.2kΩ(赤・赤・赤)
4. 抵抗 3.3kΩ(橙・橙・赤)

配線

設定

TWELITE UARTをTWELITE R2などを使用して、以下のような設定にしてください。

    --- CONFIG/TWE UART APP V1-04-5/SID=0x82018ca0/LID=0x78 -- ---
 a: set Application ID (0x67720103)
 i: set Device ID (120=0x78)
 c: set Channels (18)
 x: set RF Conf (3)
 r: set Role (0x0)
 l: set Layer (0x1)
 b: set UART baud (38400)
 B: set UART option (8N1)
 m: set UART mode (E)
 k: set Tx Trigger (sep=0x0d0a, min_bytes=0 dly=0[ms])
 h: set header format [;%A;%q;*;\n]            <- ここを変更(書式の変更)
 C: set crypt mode (0)
 o: set option bits (0x00010100)               <- ここを変更(ボーレートの変更)
---
 S: save Configuration
 R: reset to Defaults
  

サンプルSketch

Arduino IDEを起動させ、以下のプログラムをコピー&ペーストし、Arduinoに書き込んでください。

    
#include <SoftwareSerial.h>

SoftwareSerial MWSerial(2, 3); // RX, TX

#define BLOCK_MAX 10

char *p;
char buf[256];

// データ列を区切り文字で分割してString型の配列に入れる。
int split( char* source, char delimiter, String* result ){
  char* p = source;
  char tmp[81];
  memset(tmp, 0, sizeof(tmp));
  int n = 0;
  int block = 0;

  // ヌル文字が来るか分けたブロック数がBLOCK_MAXになったらやめる。
  while( *p != 0 && block < BLOCK_MAX ){

    // 区切り文字が来たら、String型に変換する。
    if( *p == delimiter ){
      // 分割したデータが0バイトの時は何もしない。
      if( n > 0 ){
        // 念のためヌル文字を末尾に代入。
        tmp[n] = 0;
        result[block] = String(tmp);
        block++;

        n = 0;
        memset(tmp, 0, sizeof(tmp));
      }
    }else{
      tmp[n] = *p;
      n++;
    }
    p++;
  }

  return block;
}

void setup() {
  Serial.begin(38400);
  MWSerial.begin(38400);

  p = buf;
  memset(buf, 0, sizeof(buf));
}

void loop() {
  while (MWSerial.available()) {
    char before = *p;
    *p = MWSerial.read();

    if( before=='\r' && *p=='\n' ){
      *p = 0;                  // 末尾をNull文字にする
      String str[BLOCK_MAX];   // 区切り文字で分割した文字列を入れる
      int len = p-buf;         // シリアルで読み込んだデータ量の計算
      int block = split( buf, ';', str );  // データの分割

      if( block == 3 ){
        Serial.print("Message: ");
        Serial.println(buf);
        Serial.print("Serial No.: ");
        Serial.println(str[0]);
        Serial.print("LQI: ");
        Serial.println(str[1]);
        Serial.print("Data: ");
        Serial.println(str[2]);
        Serial.println();
      }

      p = buf;
      memset(buf, 0, sizeof(buf));
    }else{
      if( *p >= 0x20 ){
        p++;
      }
    }
  }

  while(Serial.available()){
    MWSerial.write(Serial.read());
  }
}

使用方法

Arduino IDE のシリアルモニターなどを使用して、送信側のArduinoにメッセージを入力(ここではHELLO)すると受信側のArduinoから以下のようなメッセージがシリアル出力されます。

    [送信側]
HELLO                                       <- 入力
Message: ;820109F1;000;12,1,HEL...;         <- 出力
Serial No.: 820109F1                        <- 出力
LQI: 000                                    <- 出力
Data: 12,1,HEL...                           <- 出力

[受信側]
Message: ;820109F1;177;HELLO;               <- 出力
Serial No.: 820109F1                        <- 出力
LQI: 177                                    <- 出力
Data: HELLO                                 <- 出力
  

Sketchの解説

メインループ

下記の関数がシリアル通信の処理を記述したメインループ関数です。

2～30行目ではTWELITEからのシリアル出力を読み込む処理を行っております。
TWELITEからCR+LFが来るまでは内部のバッファに受信したシリアル電文をためておき、CR+LFが来たらsplit()関数で保持していたデータを分割し、PCにシリアル出力します。

32～34行目はPCから来たシリアルデータをそのままTWELITEに送ります。

    
void loop() {
  while (MWSerial.available()) {
    char before = *p;
    *p = MWSerial.read();

    if( before=='\r' && *p=='\n' ){
      *p = 0;                  // 末尾をNull文字にする
      String str[BLOCK_MAX];   // 区切り文字で分割した文字列を入れる
      int len = p-buf;         // シリアルで読み込んだデータ量の計算
      int block = split( buf, ';', str );  // データの分割

      if( block == 3 ){
        Serial.println(buf);
        Serial.print("Serial No.: ");
        Serial.println(str[0]);
        Serial.print("LQI: ");
        Serial.println(str[1]);
        Serial.print("Data: ");
        Serial.println(str[2]);
        Serial.println();
      }

      p = buf;
      memset(buf, 0, sizeof(buf));
    }else{
      if( *p >= 0x20 ){
        p++;
      }
    }
  }

  while(Serial.available()){
    MWSerial.write(Serial.read());
  }
}

文字列を分割する関数

split()は保持しているシリアルデータを区切り文字ごとに分割する関数です。

引数の配列を前から順番に中を確認し、区切り文字になったらそこまでの配列をString型に変換してて保管します。

分割が終わったら、分割した数を戻します。

もとのシリアルデータはString型ではなくchar型の配列で、分割後はString型になりますので、変数の方の取り扱いをご注意ください。

    
int split( char* source, char delimiter, String* result ){
  char* p = source;
  char tmp[81];
  memset(tmp, 0, sizeof(tmp));
  int n = 0;
  int block = 0;

  // ヌル文字が来るか分けたブロック数がBLOCK_MAXになったらやめる。
  while( *p != 0 && block < BLOCK_MAX ){

    // 区切り文字が来たら、String型に変換する。
    if( *p == delimiter ){
      // 分割したデータが0バイトの時は何もしない。
      if( n > 0 ){
        // 念のためヌル文字を末尾に代入。
        tmp[n] = 0;
        result[block] = String(tmp);
        block++;

        n = 0;
        memset(tmp, 0, sizeof(tmp));
      }
    }else{
      tmp[n] = *p;
      n++;
    }
    p++;
  }

  return block;
}

1.2.1.3 - 通信モード

アプリ選択

TWELITE UARTにはあらかじめシリアル通信アプリが書き込まれておりますが、アプリを書き換えて振る舞いを変えることができます。
例えば、TWELITE UARTに親機・中継機アプリ を書き込むことで、TWELITE PALやTWELITE CUEなどの親機としても使用できます。

以降では、デフォルトで書き込まれているシリアル通信アプリを使用する場合の使用方法を説明します。

モード選択

TWELIET UARTではいくつかのモードがありますが、無線の１パケットの範囲で送信するのが効率が良いため、パケットサイズに対応した80バイト以下のデータを単位送信します。

ヘッダ付き透過モード(E)

TWELIET UARTではヘッダ付き透過モード(E)が標準になっています。以下のように送信側にHELLO<Enter>と入力すると受信側に補助情報が含まれた形でHELLOが表示されます。入力側にも出力が出ますが、これは送信完了を示すメッセージです。

    [送信側]
HELLO                                           <- 入力
;U;00818;219;0x81025A17;000;013;13,1,HEL...;67; <- 出力

[受信側]
;U;00777;120;0x81025A17;120;013;HELLO;79;       <-出力
  

補助情報には送信元のアドレス情報や受信時の電波強度、チェックサムなどが含められます。また、書式をカスタマイズすることも可能です。

書式モード(A、B)

書式モード(A、B)では、送信コマンドを使用してデータを送信するモードです。このコマンドを送る際にデータ形式をアスキー形式とバイナリ形式の２種類から選択できます。

SETピンをLoにした状態で電源を投入するとアスキー書式モード(A)で起動します。

送信コマンドには論理IDのみを使用した簡易形式と、32bitアドレス指定や様々な送信オプションを設定可能な拡張形式が有り、再送回数やMAC ACKの使用の有無などのオプションを指定可能です。

    [送信側]
:000148454C4C4F8B                            <-入力
:DBA1800103                                  <-出力

[受信側]
:780148454C4C4F13                            <-出力
  

書式モードでは、インタラクティブモードではなくコマンドによる設定も可能です。

詳しくはこちら をご確認ください。

チャットモード(C)

チャットモード(C)では、プロンプトの表示とエコーバック（自身が入力した文字が端末にも表示される）が行われます。全ての無線端末は子機の設定とします。電波到達範囲の全ての端末にメッセージが伝達され複数の端末でチャットできます。

    [送信側]
810A4778:0> Hello                           <-入力
810A4778:1>                                 <-出力

[受信側]
[810A4778:0] Hello                          <-出力
82018CA0:0>                                 <-出力
  

プロンプトに表示されるTWELITEのシリアル番号の代わりにハンドル名を出力することも可能です。

詳しくはこちら をご確認ください。

透過モード(D)

透過モード(D)では、書式を必要としない通信が可能です。エコーバックやプロンプト表示がないためマイコンとの通信に適しています。

    [送信側]
Hello                                       <-入力

[受信側]
Hello                                       <-出力
  

詳しくはこちら をご確認ください。

1.2.1.3.1 - ヘッダ付き透過モード(E)

TWELIET UARTではヘッダ付き透過モード(E)が標準になっています。

以下のようにして送信側にHELLO<Enter>と入力すると、受信側に補助情報が含まれた形でHELLOが表示されます。入力側にも出力が出ますが、これは送信完了を示すメッセージです。

    [送信側]
HELLO                                           <- 入力
;U;00818;219;0x81025A17;000;013;13,1,HEL...;67; <- 出力

[受信側]
;U;00777;120;0x81025A17;120;013;HELLO;79;       <-出力
  

補助情報には送信元のアドレス情報や受信時の電波強度、チェックサムなどが含められます。また、書式をカスタマイズすることも可能です。

送信可能データ長

無線の１パケットの範囲で送信するのが効率が良いため、パケットサイズに対応した80バイト以下のデータを単位送信します。

送信側と受信側について

Eモードでは送信側と受信側の区別はありません。無線設定（チャネルとアプリケーションID）が同じであれば、いずれかの送信側から送信したデータは他の受信側に伝達されます。

アドレスについて

TWELITE URATは各々32bitの固定アドレスと8bit(0-100,120)の論理アドレスを設定することができます。

標準の出力書式について

出力書式は以下のような;(セミコロン)区切りになっています。

    ;U;00777;120;0x81025A17;120;013;HELLO;79;
;1;2----;3--;4---------;5--;6--;7----;8-;
  

上記書式はカスタマイズできます。

1.2.1.3.1.1 - 出力のカスタマイズ

ヘッダ付き透過モード (E) の出力はインタラクティブモードのh: set header formatで設定できます。

一番簡単な書式は*\nで、送信されたデータそのものを表示し、CRLFの改行コードを付与します。

    --- CONFIG/TWE UART APP V1-04-5/SID=0x810a479c/LID=0x01 -E ---
...
 h: set header format [*\n]

受信側で上記の設定を行うと、以下のように表示されます。
 [送信側] HELLO または HELLO
 [受信側] HELLO
  

特殊文字を含めることで様々な出力が可能です。

\(バックスラッシュ, ￥)に続く文字

%に続く文字

チェックサムの計算

チェックサムは開始位置（<で指定する場合はその場所から、なければ出力の先頭）から%X,%xの出力直前までをXOR（排他的論理和）にて計算します。

     h: set header format [;%I;*;%X]
 上記のように設定した場合、

受信側で上記の設定を行うと、以下のように表示されます。
 [送信側] HELLO または HELLO
 [受信側] ;000;HELLO;49

送信側のアドレスはでHELLOという文字が届きチェックサムが0x49です。
チェックサムの計算範囲は ;000;HELLO; です。
  

計算プログラム例

    
#include <stdio.h>

int main() {
  unsigned char x = 0;
  char *p = ";000;HELLO;";

  while(*p) {
    x ^= *p;
    p++;
  }
  printf("%s -> %02x\n", argv[1], x);
}

// ;000;HELLO; -> 49

1.2.1.3.2 - 書式モード(A, B)

特徴

書式モードはTWELITE-トワイライトのUART（シリアル通信ポート）に所定の書式により入力するモードです。以下の特徴があります。

• チェックサムによるエラーチェックを行う事で UART通信のデータ化けを検出する。
• マイコンからバイナリ形式で直接送受信する。

設定方法

書式モードはインタラクティブモード にてUARTモード（m）をアスキー形式（A）またはバイナリ形式（B）に設定します。

アスキー形式（A）

送信したいバイナリデータ列をアスキー文字列（0-9,A-F）に変換して無線モジュールに入力します。

Modbus ASCII 形式の書式に倣っています。（例： バイナリ系列 0x00 0x11 0x22 0x33 0xAA 0xBB 0xCC は “:00112233AABBCC69” という文字列で表現されます。）

バイナリー形式（B）

送信したいバイナリデータ列にヘッダとチェックサムを付加し直接無線モジュールに入力します。

人手による検証は困難になりますが、マイコン間通信では最も効率が良い形式です。

送信可能文字数

• 最大送信バイト数は６４０バイトですが、１パケットに収めて送受信する事を推奨します。
  下記【書式】のAにあたる[送受信したいデータ]
• １パケットに収めるためには８０バイト以下にしてください。

書式

書式モードは、送信コマンドを使用してデータを送信するモードです。このコマンドを送る際にデータ形式をアスキー形式とバイナリ形式の２種類から選択できます。送信コマンドとデータ形式の関係は以下の図の通りです。

本ページでは下図に示す送信コマンドについて解説します。

    A: [送受信したいデータ]
 ↓↑
B: [送信コマンド[A: ] ]
 ↓↑
C: 系列Bをアスキー形式またはバイナリ形式に変換
   [形式ヘッダ [B: [A: ] ] 終端]
 ↓↑
マイコンのUART入出力
  

送信コマンドには論理IDのみを使用した簡易形式と、32bitアドレス指定や様々な送信オプションを設定可能な拡張形式が有ります。それぞれの形式を以下で説明します。

送信コマンド （簡易形式）

入力

出力

TWELITE-トワイライトから出力される形式は、入力時と同形式です。

使用例

以下のコマンドを親機に入力した場合、全子機に対し 0x11 0x22 0x33 0xAA 0xBB 0xCC というバイト列を送信します。

      0x78 0x01 0x11 0x22 0x33 0xAA 0xBB 0xCC
  

受信側は、以下のように親機の論理ID (0x00)から以下の バイト列を得ます。

      0x00 0x01 0x11 0x22 0x33 0xAA 0xBB 0xCC
  

上記バイト列はTWELITEに直接入力するわけではあり ません。アスキー形式またはバイナリ形式で表現した上、 UARTの入出力を行います。

例えば上記の出力形式の場合、アスキー形式では以下のよう に表現されます。

    :0001112233AABBCC68[CR][LF]
  

末尾の68はチェックサムです。

送信コマンド(拡張形式)

入力

出力

TWELITE-トワイライトから出力される形式は、宛先の論理IDの次に0xA0バイトが続きます。

オプション

各種送信時のオプションが指定できます。アプリケーション再送や遅延のためのオプションは、１パケットで送信できるデータ量(送受信したいデータが78バイト以内)で使用してください。

※ 本オプションはネットワーク層を利用した送信では使用しないでください。

※ 遅延や再送回数などによりコマンド入力から１秒を経過すると、コマンド処理がタイムアウトし、処理待ちのコマンドが処理されます。

※ 遅延処理やアプリケーション再送が行われている間は、内部のパケットバッファー（１０ヶ）が処理待ちで埋まっていて新しい処理要求が実行されない場合が有ります。また同時に平行処理できるパケットは５ヶとなります。

※ パケットの重複確認は、内部で割り振っている連番で新しいものを優先し旧いものは採用しません。新しい要求受け付けのパケットが先に届き、旧い要求受け付けのパケットが後に届くような場合、古いパケットは受信されません。（特に 0x06 オプションを付加した時に、このような現象が発生しやすくなります）

※ パケット分割されるデータサイズの場合に遅延処理やアプリケーション再送処理を行うと、後半のパケットが前半のパケットの処理完了後に処理されるため、大きな時間差が発生し受信側でタイムアウトを起こし受信が失敗します。原則として遅延が発生するオプションはパケット分割しない範囲で使用してください。

応答メッセージ

応答メッセージはコマンドの入力に対し、処理結果を通知します。

使用例

以下の例では、バイトまたはバイト列を 0x を省略して表記します。

    0x01 0x02 0x0A 0x0B ⇒ 01020A0B
  

※ 以下の例をそのままTWELITEに入力できるわけではなく、アスキーまたはバイナリ形式で表現します。

簡易形式

子機から親機へ（ 0203 の２バイトを送信、コマンドバイトは 01）

    
・送信コマンド
  00010203
  ^1^2

  *1 00:親機宛
  *2 データ
  

    
・応答メッセージ
  DBA18001
        ^1
  *1 01:成功, 00:失敗
  

    
・受信
  78010203
  ^1

  *1 78:子機(論理ID設定なし)から来た
  

親機から全子機へ（長い系列）

    
  78020304DB32807005D70101100001000080A005D718DB32807005D7010110
  0001000080A005D718DB32807005D70101100001000080A005D718DB328070
  05D70101100001000080A005D718DB32807005D70101100001000080A005D7
  

拡張形式

子機→親機（単純な送信）

    
・送信コマンド
  00A012FF123456
      ^1^2^3

  *1 応答番号 12
  *2 オプション無し
  *3 データ
  

    ・応答メッセージ
  DBA11201
      ^1^2

  *1 応答番号 12
  *2 01:成功
  

    ・受信データ
  78A01286300001FFFFFFFFD80003123456
      ^1^2      ^3      ^4^5  ^6

  *1 応答番号 12
  *2 送信元アドレス(86300001)
  *3 送信先アドレス（FFFFFFFF 情報なし）
  *4 通信品質(LQI)
  *5 データ部バイト数 (0003=3バイト)
  *6 データ (3バイトのデータ)
  

子機→親機（Ack付きの送信）

    
・送信コマンド
  00A01301FF123456
        ^1

   *1 ACK 指定
  

子機→親機（0.768秒後に送信）

    
・送信コマンド
  00A01001030300FF123456
          ^1^2  ^3

  *1 送信遅延最小の設定
  *2 0300(=768ms)後
  *3 オプション終端
  

カスタムデフォルト

ファームウェアバイナリに設定情報を付記した設定済みファームウェアバイナリが利用できます。例えば、ボーレートを最初から設定したファームウェアを作成しておけば、毎回インタラクティブモードなどで設定する必要がなくなります。

0xDB コマンド

インタラクティブモードでの設定を行う替わりに、書式モード（バイナリモード・アスキーモード）では、コマンドによりモジュールの動作（リセット・サイレント解除）や設定を行えます。

サイレントモード

サイレントモードでは、受信回路を動作させず稼働中にパケット受信を行いません。起動後にマイコン経由で毎回特定の設定を反映させてから、通信を始めるような場合に利用します。

1.2.1.3.2.1 - アスキー形式

    A: [送受信したいデータ]
 ↓↑
B: [コマンド表現 [A: ] ]
 ↓↑
C: 系列Bをアスキー形式またはバイナリ形式に変換
   [形式ヘッダ [B: [A: ] ] 終端]
 ↓↑
マイコンのUART入出力
  

例えば、コマンド表現で 00A01301FF123456 （子機から親機に ACK 付きで 123456 を送信する）をアスキー形式で表現すると、以下のようになります。先頭は : で B1 がチェックサム、終端は [CR][LF] となります。

    :00A01301FF123456B1[CR][LF]
  

形式の定義

チェックサムの省略

送信コマンドを入力する時に限ってチェックサムとフッタを省略し替わりに ‘X’ を指定できます。

    :00A01301FF123456B1[CR][LF] ⇒ :00A01301FF123456X
  

1.2.1.3.2.2 - バイナリ形式

    A: [送受信したいデータ]
 ↓↑
B: [コマンド表現 [A: ] ]
 ↓↑
C: 系列Bをアスキー形式またはバイナリ形式に変換
   [形式ヘッダ [B: [A: ] ] 終端]
 ↓↑
マイコンのUART入出力
  

例えば、コマンド表現で 00A01301FF123456 （子機から親機に ACK 付きで 123456 を送信する）をバイナリ形式で表現すると、以下のようになります。

    0xA5 0x5A 0x80 0x08 0x00 0xA0 0x13 0x01 0xFF 0x12 0x34 0x56 0x3D
  

形式の定義

使ってみる

バイナリ形式の確認は一般に難易度が高く、上手くコマンドが入力できない場合の分析が非常に困難です。マイコンなどでデバッグされるのに先立って、PCなど確認しやすい環境で予め実行しておくことを強くお勧めします。

1.2.1.3.2.2.1 - バイナリ形式で使ってみる