シリアル通信アプリの通信モード

• 1: シリアル通信アプリの書式モード（アスキー形式）
• 1.1: シリアル通信アプリ 書式モード（アスキー）の 0xDB コマンド
• 2: シリアル通信アプリの書式モード（バイナリ形式）
• 2.1: シリアル通信アプリ 書式モード（バイナリ）の 0xDB コマンド
• 3: シリアル通信アプリのチャットモード
• 4: シリアル通信アプリの透過モード
• 5: シリアル通信アプリのヘッダ付き透過モード

:000148454C4C4F8B  <- 入力
:DBA1800103  <- 出力

:780148454C4C4F13  <- 出力

0xA5 0x5A 0x00 0x07 0x00 0x01 0x48 0x45 0x4C 0x4C 0x4F 0x43 0x04    <- 入力
0xA5 0x5A 0x00 0x04 0xDB 0xA1 0x80 0x01 0xFB 0x04  <- 出力

0xA5 0x5A 0x00 0x07 0x78 0x01 0x48 0x45 0x4C 0x4C 0x4F 0x3B 0x04  <- 出力

810A4778:0> Hello  <- 入力
810A4778:1>  <- 出力

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

Hello  <- 入力

Hello  <- 出力

Hello  <- 入力
;U;00004;219;0x820163B2;000;000;0,1,Hel...;6E;  <- 出力

;U;00003;000;0x820163B2;255;000;Hello;42;  <- 出力

1 - シリアル通信アプリの書式モード（アスキー形式）

概要

送信側の端末へ特定の書式に従ったデータを入力すると、受信側の端末も特定の書式に従ったデータを出力します。

データは16進数のアスキー文字列で表現します。

• TWELITE UART では、SET ピンを GND へ接続して起動すると書式モード（アスキー）が有効となります。
• TWELITE / TWELITE DIP では、EX1 ピンを GND へ接続して起動すると書式モード（バイナリ）が有効となります。

扱うことのできる書式の形式は2種類あります。

• 簡易形式：論理デバイスIDだけを使用する。超簡単！標準アプリのUART伝送機能と互換性あり
• 拡張形式：論理デバイスIDに加えて、シリアルIDや再送回数などの送信オプションを使用できる

例えば、5バイトのバイナリデータ 0x48 0x45 0x4C 0x4C 0x4F は、簡易形式を使って次のように送信できます。

【送信側】

:000148454C4C4F8B  <- 入力
:DBA1800103  <- 出力

【受信側】

:780148454C4C4F13  <- 出力

基本の書式

基本形式や拡張形式で表現したデータ列を送信するときは、アスキー文字列（0-9,A-F）へ変換します。

書式は超簡単！標準アプリ（App_Twelite）や親機・中継機アプリ（App_Wings）の親機の出力と同様に、:で始まりCRLFで終わります。

• すべて ASCII 文字
• 先頭は : (0x3A)
• チェックサムはペイロードの合計の2の補数
• 末端は CRLF (\r\n/0x0D 0x0A)
• ビッグエンディアン

例えば、バイナリデータ 0x00 0x11 0x22 0x33 0xAA 0xBB 0xCC は次のように表現します。

:00112233AABBCC69<CR><LF>

親機と子機の区別

書式モードは、親機と子機を区別します。

親子間では、アプリケーションIDと周波数チャネルを合わせる必要があります。

送信元の判別

書式モードでは、受信したデータから送信元を判別できます。

簡易形式の書式では論理デバイスIDを、拡張形式の書式では論理デバイスIDに加えて拡張アドレスを利用します。

簡易形式の書式

書式モードの簡易形式を利用する場合は、次の書式に従います。

送信側の入力

受信側の出力

送信側の出力（応答メッセージ）

使用例

親機から全子機に対してバイト列 0x11 0x22 0x33 0xAA 0xBB 0xCC を送信する例を示します。

【送信側：親機】

:7801112233AABBCCF0<CR><LF>  <- 入力
:DBA1800103<CR><LF>  <- 出力

末尾の0xF0はチェックサム：0x78から0xCCまでの合計の2の補数のLSBから8ビット。

【受信側：全子機】

:0001112233AABBCC68<CR><LF>  <- 出力

末尾の0x68はチェックサム：0x00から0xCCまでの合計の2の補数のLSBから8ビット。

拡張形式の書式

書式モードの拡張形式を利用する場合は、次の書式に従います。

送信側の入力

送信先の指定に論理デバイスIDを使用する場合

送信先の指定に拡張アドレスを使用する場合

オプション列の詳細

拡張形式では、オプション列を指定することで細かな設定を行うことができます。

オプション列は、オプションのIDと引数の繰り返しで表現します。終端は 0xFF とします。

0x01：MAC ACKの有効化

MAC層のACK（確認応答）を有効化します。

頻繁にデータを送信する場合には適しませんが、信頼性を向上できる場合があります。

0x02：アプリケーション再送の有効化

MAC ACK を使用するときは、0x00-0x0Fを指定します。送信に成功するまで、それぞれ0-16回の再送を行います。

MAC ACK を使用しないときは、0x81-0x8Fを指定します。必ず1-16回の再送を行います。

応答メッセージは、すべての再送が終了してから出力します。

0x03：初回送信の遅延の最小値

初回送信までの遅延の最小値をミリ秒で指定できます。

0x04：初回送信の遅延の最大値

初回送信までの遅延の最大値をミリ秒で指定できます。

0x05：アプリケーション再送の間隔

アプリケーション再送を有効化した際の再送間隔をミリ秒で指定します。

0x06：平行要求の許可

平行要求を許可します。

平行要求を許可すると、要求を完了するまでブロックせず、次の要求処理を受け付けることができるようになります。

例えば 0.5 秒の遅延を設定した要求を3回連続して入力した場合、初期状態では 0.5 秒後、1.0秒後、1.5秒後と順番に処理します。ところが、平行要求を許可した場合は、0.5秒後に順不同で送信要求を処理します。なおパケット分割を必要とする場合は使用できません。

0x07：応答メッセージの無効化

送信側へデータを入力した際に出力される応答メッセージを無効とします。

0x08：送信後スリープ

送信後、速やかに本体をスリープさせます。

RXが立ち上がりエッジを検知すると、スリープから復帰します。何か1バイトのデータを入力してください。

スリープ復帰後、UART の初期化が終わると入力を受け付けます。

受信側の出力

送信側の出力（応答メッセージ）

使用例

親機から子機に対してバイト列 0x11 0x22 0x33 0xAA 0xBB 0xCC を送信する例を示します。

論理デバイスIDを指定する例

親機から論理デバイスID0x42の子機へ送信する例を示します。

• 応答IDは0x01
• オプションなし
• 親機の拡張アドレスは0x81000000（シリアルID0x1000000）

【送信側：親機】

:42A001FF112233AABBCC87<CR><LF>  <- 入力
:DBA1010182<CR><LF>  <- 出力

末尾の0x87はチェックサム：0x42から0xCCまでの合計の2の補数のLSBから8ビット。

【受信側：子機】

:00A00181000000FFFFFFFFC80006112233AABBCC7D<CR><LF>  <- 出力

末尾の0x7Dはチェックサム：最初の0x00から0xCCまでの合計の2の補数のLSBから8ビット。

拡張アドレスを指定する例

親機から拡張アドレス0x81000001（シリアルID0x1000001）の子機へ送信する例を示します。

• 応答IDは0x01
• オプションなし
• 親機の拡張アドレスは0x81000000（シリアルID0x1000000）

【送信側：親機】

:80A00181000001FF112233AABBCCC7<CR><LF>  <- 入力
:DBA1010182<CR><LF>  <- 出力

末尾の0xC7はチェックサム：0x80から0xCCまでの合計の2の補数のLSBから8ビット。

【受信側：子機】

:00A0018100000081000001C80006112233AABBCCF7<CR><LF>  <- 出力

末尾の0xF7はチェックサム：最初の0x00から0xCCまでの合計の2の補数のLSBから8ビット。

MAC ACKを使用する例

親機から論理デバイスID0x42の子機へ MAC ACK を使用して送信する例を示します。

• 応答IDは0x01
• オプションは0x01：MAC ACKの有効化を指定
• 親機の拡張アドレスは0x81000000（シリアルID0x1000000）

【送信側：親機】

:42A00101FF112233AABBCC86<CR><LF>  <- 入力
:DBA1010182<CR><LF>  <- 出力

末尾の0x86はチェックサム：0x42から0xCCまでの合計の2の補数のLSBから8ビット。

【受信側：子機】

:00A00181000000FFFFFFFFC80006112233AABBCC7D<CR><LF>  <- 出力

末尾の0x7Dはチェックサム：0x00から0xCCまでの合計の2の補数のLSBから8ビット。

遅延を設ける例

親機から論理デバイスID0x42の子機へ 768ms の遅延を設けて送信する例を示します。

• 応答IDは0x01
• オプションは0x03：初回送信の遅延の最小値を指定
• 親機の拡張アドレスは0x81000000（シリアルID0x1000000）

【送信側：親機】

:42A001030300FF112233AABBCC81<CR><LF>  <- 入力
:DBA1010182<CR><LF>  <- 出力

末尾の0x81はチェックサム：0x42から0xCCまでの合計の2の補数のLSBから8ビット。

【受信側：子機】

:00A00181000000FFFFFFFFC80006112233AABBCC7D<CR><LF>  <- 出力

末尾の0x7Dはチェックサム：0x00から0xCCまでの合計の2の補数のLSBから8ビット。

0xDB コマンド

インタラクティブモードの設定を行う代わりに、UART から 0xDB コマンドを入力することでモジュールの操作や設定を行うことができます。

1.1 - シリアル通信アプリ 書式モード（アスキー）の 0xDB コマンド

入力の書式

コマンド番号の一覧

0xF0：ACKの有効化

ACK 応答の要求を行います。

パラメータはありません。

応答の書式

0xF1：端末情報の取得

アドレス等の情報を表示します。起動時にも出力されます。

パラメータはありません。

応答の書式

0xF2：端末設定の適用

設定を適用します。

応答の書式

成功した場合

失敗した場合

0xF3：端末設定の取得

設定を取得します。

応答の書式

0xF8：端末の制御

起動時にサイレントモードを有効としていた場合に、これを解除します。

応答の書式

0xFD：端末設定の消去

設定を初期化し、本体をリセットします。

パラメータおよび応答はありません。

0xFE：端末設定の保存

適用した設定を保存し、本体をリセットします。

パラメータおよび応答はありません。

0xFF：端末のリセット

適用した設定を破棄し、本体をリセットします。

パラメータおよび応答はありません。

パラメータの一覧（0xF2/0xF3）

0xF2：端末設定の適用 および 0xF3：端末設定の取得 のパラメータは、識別子とデータ（ビッグエンディアン）の繰り返しで表現します。

0x00：アプリケーションID

アプリケーションIDを指定します。

0x01：周波数チャネルマスク

周波数チャネルのビットマスクを指定します。

使用するチャネルのビットを立てます。例えば、11チャネルを使う場合は1<<11です。

0x02：再送回数と出力

電波の送信出力と、透過モードおよびヘッダ付き透過モードにおいてパケットを追加で送信する回数を指定します。

下位の1バイトのみを使用します。そのうち上位の4ビットが再送回数（0-9）、下位の4ビットが送信出力（0-3）です。例えば、8回再送／出力3 であれば 0x0083です。

0x03：論理デバイスID

論理デバイスIDを指定します。

0x04：役割

子機のみ有効です。以下の値を指定します。通常はネットワーク層を利用しない配送方式を選択してください。

ネットワーク層を利用しない配送方式

• 0：通常の指定（親機または子機）
• 1-3：中継子機（論理デバイスIDを1-100 または 120とします）1-3の数値は最大中継段数を指します。最大中継段数まで再送を繰り返す方式のため、中継機の配置や数によっては重複したパケットを中継します。

ネットワーク層を利用する配送方式

• 11：親機
• 12：中継機
• 13：子機

0x05：中継レイヤ

中継レイヤの番号です。中継機は中継レイヤ数の上位（より小さい値）の中継機・親機への接続を試みます。役割を12としているときにだけ有効です。

0x06：通信モード

• 0：透過モード
• 1：書式モード（アスキー）
• 2：書式モード（バイナリ）
• 3：チャットモード
• 4：ヘッダ付き透過モード

0x07：ボーレート

UART ボーレートを指定します。

0x08：パリティ

以下の設定の組み合わせにおいて、設定値の総和を指定します。

• Bit
  • 0：8Bit
  • 8：7Bit
• Parity
  • 0：None
  • 1：Odd
  • 2：Even
• Stop
  • 0：STOP 1
  • 4：STOP 2

例えば、7-E-1 なら 8+2+0=10(0xA) を指定します。

0x09：暗号化機能

暗号化機能の有無を指定します。

• 0：無効
• 1：AES128bit の暗号化を有効

0x0A：暗号化キー

16バイトの暗号化キーを指定します。

インタラクティブモードでは設定できないバイナリ列を格納できます。この場合、インタラクティブモードの表示が崩れる場合があります。

0x0C：区切り文字

区切り文字列の指定を行います（0x00-0xFF）。

サイレントモード

設定方法

インタラクティブモードで以下の設定を行います。

• r: Role に 80 を足しておく。例えば、通常の親機や子機なら80とする。
• m: UART mode を書式モード（A/B）としておく。

動作確認

起動直後に出力される DB F1 応答の内容を確認します。

解除方法

DB F8 要求を行います（アスキー形式：:DBF8101D<CR><LF>）。

注意点

• サイレントモードの再設定はできません。
• サイレントモードが有効のときに送信コマンドを入力した場合の動作は未定義です。

2 - シリアル通信アプリの書式モード（バイナリ形式）

概要

送信側の端末へ特定の書式に従ったデータを入力すると、受信側の端末も特定の書式に従ったデータを出力します。

16進数で表すデータは、バイナリデータのまま表現します。

• TWELITE UART では、SET ピンを GND へ接続して起動すると書式モード（アスキー）が有効となります。
• TWELITE / TWELITE DIP では、EX1 ピンを GND へ接続して起動すると書式モード（バイナリ）が有効となります。

扱うことのできる書式の形式は2種類あります。

• 簡易形式：論理デバイスIDだけを使用。超簡単！標準アプリのUART伝送機能と互換性あり
• 拡張形式：論理デバイスIDに加えて、シリアルIDや再送回数などの送信オプションを使用できる

例えば、5バイトのバイナリデータ 0x48 0x45 0x4C 0x4C 0x4F は、簡易形式を使って次のように送信できます。

【送信側】

A5 5A 80 07 00 01 48 45 4C 4C 4F 43 04    <- 入力
A5 5A 80 04 DB A1 80 01 FB 04  <- 出力

【受信側】

A5 5A 80 07 78 01 48 45 4C 4C 4F 3B 04  <- 出力

基本の書式

基本形式や拡張形式で表現したデータ列を送信するときは、バイナリデータのまま扱います。

• すべてバイナリ
• 先頭は A5 5A の2バイト
• ペイロード長はバイト数を2バイトで表現、0x8000とORをとる
• チェックサムはペイロードのXOR
• 末端は EOT を表す 0x04（入力時は省略可）
• ビッグエンディアン

例えば、バイナリデータ 00 11 22 33 AA BB CC は次のように表現します。

A5 5A 80 07 00 11 22 33 AA BB CC DD 04

デバッグが面倒ですが、マイコン間の通信では高い効率を誇ります。

親機と子機の区別

書式モードは、親機と子機を区別します。

親子間では、アプリケーションIDと周波数チャネルを合わせる必要があります。

送信元の判別

書式モードでは、受信したデータから送信元を判別できます。

簡易形式の書式では論理デバイスIDを、拡張形式の書式では論理デバイスIDに加えて拡張アドレスを利用します。

簡易形式の書式

書式モードの簡易形式を利用する場合は、次の書式に従います。

送信側の入力

受信側の出力

送信側の出力（応答メッセージ）

使用例

親機から全子機に対してバイト列 11 22 33 AA BB CC を送信する例を示します。

【送信側：親機】

A5 5A 80 08 78 01 11 22 33 AA BB CC A4 04  <- 入力
A5 5A 80 04 DB A1 80 01 FB 04  <- 出力

末尾の0xA4はチェックサム：0x78から0xCCまでのXOR。

【受信側：全子機】

A5 5A 80 08 00 01 11 22 33 AA BB CC DC 04  <- 出力

末尾の0xDCはチェックサム：0x00から0xCCまでのXOR。

拡張形式の書式

書式モードの拡張形式を利用する場合は、次の書式に従います。

送信側の入力

送信先の指定に論理デバイスIDを使用する場合

送信先の指定に拡張アドレスを使用する場合

オプション列の詳細

拡張形式では、オプション列を指定することで細かな設定を行うことができます。

オプション列は、オプションのIDと引数の繰り返しで表現します。終端は 0xFF とします。

0x01：MAC ACKの有効化

MAC層のACK（確認応答）を有効化します。

頻繁にデータを送信する場合には適しませんが、信頼性を向上できる場合があります。

0x02：アプリケーション再送の有効化

MAC ACK を使用するときは、0x00-0x0Fを指定します。送信に成功するまで、それぞれ0-16回の再送を行います。

MAC ACK を使用しないときは、0x81-0x8Fを指定します。必ず1-16回の再送を行います。

応答メッセージは、すべての再送が終了してから出力します。

0x03：初回送信の遅延の最小値

初回送信までの遅延の最小値をミリ秒で指定できます。

0x04：初回送信の遅延の最大値

初回送信までの遅延の最大値をミリ秒で指定できます。

0x05：アプリケーション再送の間隔

アプリケーション再送を有効化した際の再送間隔をミリ秒で指定します。

0x06：平行要求の許可

平行要求を許可します。

平行要求を許可すると、要求を完了するまでブロックせず、次の要求処理を受け付けることができるようになります。

例えば 0.5 秒の遅延を設定した要求を3回連続して入力した場合、初期状態では 0.5 秒後、1.0秒後、1.5秒後と順番に処理します。ところが、平行要求を許可した場合は、0.5秒後に順不同で送信要求を処理します。なおパケット分割を必要とする場合は使用できません。

0x07：応答メッセージの無効化

送信側へデータを入力した際に出力される応答メッセージを無効とします。

0x08：送信後スリープ

送信後、速やかに本体をスリープさせます。

RXが立ち上がりエッジを検知すると、スリープから復帰します。何か1バイトのデータを入力してください。

スリープ復帰後、UART の初期化が終わると入力を受け付けます。

受信側の出力

送信側の出力（応答メッセージ）

使用例

親機から子機に対してバイト列 11 22 33 AA BB CC を送信する例を示します。

論理デバイスIDを指定する例

親機から論理デバイスID0x01の子機へ送信する例を示します。

• 応答IDは0x01
• オプションなし

【送信側：親機】

A5 5A 80 0A 01 A0 01 FF 11 22 33 AA BB CC 82 04  <- 入力
A5 5A 80 04 DB A1 01 01 7A 04  <- 出力

末尾の0xC1はチェックサム：0x42から0xCCまでのXOR。

【受信側：子機】

A5 5A 80 14 00 A0 01 82 03 68 41 FF FF FF FF FF 00 06 11 22 33 AA BB CC 2D 04  <- 出力

末尾の0x2Dはチェックサム：0x00から0xCCまでのXOR。

拡張アドレスを指定する例

親機から拡張アドレス0x820163B2（シリアルID0x20163B2）の子機へ送信する例を示します。

• 応答IDは0x01
• オプションなし

【送信側：親機】

A5 5A 80 0E 80 A0 01 82 01 63 B2 FF 11 22 33 AA BB CC 51 04  <- 入力
A5 5A 80 04 DB A1 01 01 7A 04  <- 出力

末尾の0x51はチェックサム：0x80から0xCCまでのXOR。

【受信側：子機】

A5 5A 80 14 00 A0 01 82 03 68 41 82 01 63 B2 FF 00 06 11 22 33 AA BB CC 7F 04  <- 出力

末尾の0x7Fはチェックサム：0x00から0xCCまでのXOR。

MAC ACKを使用する例

親機から論理デバイスID0x01の子機へ MAC ACK を使用して送信する例を示します。

• 応答IDは0x01
• オプションは0x01：MAC ACKの有効化を指定

【送信側：親機】

A5 5A 80 0B 01 A0 01 01 FF 11 22 33 AA BB CC 83 04  <- 入力
A5 5A 80 04 DB A1 01 01 7A 04  <- 出力

末尾の0x83はチェックサム：0x01から0xCCまでのXOR。

【受信側：子機】

A5 5A 80 14 00 A0 01 82 03 68 41 00 00 01 01 FF 00 06 11 22 33 AA BB CC 2D 04  <- 出力

末尾の0x2Dはチェックサム：0x00から0xCCまでのXOR。

遅延を設ける例

親機から論理デバイスID0x01の子機へ 768ms の遅延を設けて送信する例を示します。

• 応答IDは0x01
• オプションは0x03：初回送信の遅延の最小値を指定

【送信側：親機】

A5 5A 80 0D 01 A0 01 03 03 00 FF 11 22 33 AA BB CC 82 04  <- 入力
A5 5A 80 04 DB A1 01 01 7A 04  <- 出力

末尾の0x82はチェックサム：0x01から0xCCまでのXOR。

【受信側：子機】

A5 5A 80 14 00 A0 01 82 03 68 41 FF FF FF FF FF 00 06 11 22 33 AA BB CC 2D 04  <- 出力

末尾の0x2Dはチェックサム：0x00から0xCCまでのXOR。

0xDB コマンド

インタラクティブモードの設定を行う代わりに、UART から 0xDB コマンドを入力することでモジュールの操作や設定を行うことができます。

2.1 - シリアル通信アプリ 書式モード（バイナリ）の 0xDB コマンド

入力の書式

コマンド番号の一覧

0xF0：ACKの有効化

ACK 応答の要求を行います。

パラメータはありません。

応答の書式

0xF1：端末情報の取得

アドレス等の情報を表示します。起動時にも出力されます。

パラメータはありません。

応答の書式

0xF2：端末設定の適用

設定を適用します。

応答の書式

成功した場合

失敗した場合

0xF3：端末設定の取得

設定を取得します。

応答の書式

0xF8：端末の制御

起動時にサイレントモードを有効としていた場合に、これを解除します。

応答の書式

0xFD：端末設定の消去

設定を初期化し、本体をリセットします。

パラメータおよび応答はありません。

0xFE：端末設定の保存

適用した設定を保存し、本体をリセットします。

パラメータおよび応答はありません。

0xFF：端末のリセット

適用した設定を破棄し、本体をリセットします。

パラメータおよび応答はありません。

パラメータの一覧（0xF2/0xF3）

0xF2：端末設定の適用 および 0xF3：端末設定の取得 のパラメータは、識別子とデータ（ビッグエンディアン）の繰り返しで表現します。

0x00：アプリケーションID

アプリケーションIDを指定します。

0x01：周波数チャネルマスク

周波数チャネルのビットマスクを指定します。

使用するチャネルのビットを立てます。例えば、11チャネルを使う場合は1<<11です。

0x02：再送回数と出力

電波の送信出力と、透過モードおよびヘッダ付き透過モードにおいてパケットを追加で送信する回数を指定します。

下位の1バイトのみを使用します。そのうち上位の4ビットが再送回数（0-9）、下位の4ビットが送信出力（0-3）です。例えば、8回再送／出力3 であれば 0x0083です。

0x03：論理デバイスID

論理デバイスIDを指定します。

0x04：役割

子機のみ有効です。以下の値を指定します。通常はネットワーク層を利用しない配送方式を選択してください。

ネットワーク層を利用しない配送方式

• 0：通常の指定（親機または子機）
• 1-3：中継子機（論理デバイスIDを1-100 または 120とします）1-3の数値は最大中継段数を指します。最大中継段数まで再送を繰り返す方式のため、中継機の配置や数によっては重複したパケットを中継します。

ネットワーク層を利用する配送方式

• 11：親機
• 12：中継機
• 13：子機

0x05：中継レイヤ

中継レイヤの番号です。中継機は中継レイヤ数の上位（より小さい値）の中継機・親機への接続を試みます。役割を12としているときにだけ有効です。

0x06：通信モード

• 0：透過モード
• 1：書式モード（バイナリ）
• 2：書式モード（バイナリ）
• 3：チャットモード
• 4：ヘッダ付き透過モード

0x07：ボーレート

UART ボーレートを指定します。

0x08：パリティ

以下の設定の組み合わせにおいて、設定値の総和を指定します。

• Bit
  • 0：8Bit
  • 8：7Bit
• Parity
  • 0：None
  • 1：Odd
  • 2：Even
• Stop
  • 0：STOP 1
  • 4：STOP 2

例えば、7-E-1 なら 8+2+0=10(0xA) を指定します。

0x09：暗号化機能

暗号化機能の有無を指定します。

• 0：無効
• 1：AES128bit の暗号化を有効

0x0A：暗号化キー

16バイトの暗号化キーを指定します。

インタラクティブモードでは設定できないバイナリ列を格納できます。この場合、インタラクティブモードの表示が崩れる場合があります。

0x0C：区切り文字

区切り文字列の指定を行います（0x00-0xFF）。

サイレントモード

設定方法

インタラクティブモードで以下の設定を行います。

• r: Role に 80 を足しておく。例えば、通常の親機や子機なら80とする。
• m: UART mode を書式モード（A/B）としておく。

動作確認

起動直後に出力される DB F1 応答の内容を確認します。

解除方法

DB F8 要求を行います（バイナリ形式：A5 5A 80 03 DB F8 10 33 04）。

注意点

• サイレントモードの再設定はできません。
• サイレントモードが有効のときに送信コマンドを入力した場合の動作は未定義です。

3 - シリアル通信アプリのチャットモード

MONOSTICK を PC 等へ接続することで、複数の端末同士のチャットを行うことができます。

概要

テキストチャットを実現します。

プロンプトの表示とエコーバック（入力した文字の出力）を行います。すべての端末は子機として、同報通信を行います。

例えば、ある端末から他の端末へ Hello という文字列を送信する場合は、次のように振る舞います。

【送信側】

810A4778:0> Hello  <- 入力
810A4778:1>  <- 出力

【受信側】

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

チャットモードは、プロンプトの表示とエコーバック（自身へ入力された文字の出力）を行います。

全ての端末は子機としたうえで、送信内容はブロードキャストします。すべての端末と通信できますが宛て先は指定できません。またバイナリデータは送れません。文字列のみ対応しています（0x00-0x1F, 0x7F は送信不可）。

中継は3段（3ホップ）まで対応しています。初期設定では中継しません。

親機と子機の区別

チャットモードは、親機と子機を区別しません。

アプリケーションIDと周波数チャネルが同一であれば、どの端末へ入力したデータもほかの端末へと送信されます。

送信元の判別

受信側に出力される補助情報の識別情報から送信元を判別できます。

インタラクティブモードのh: Header formatを空欄としたときは、7桁のシリアルIDの先頭へ0x8を付与した拡張アドレスを使用します。例えば、以下の出力では送信元のシリアルIDが0x10A4778であったと分かります。

[810A4778:0] Hello

インタラクティブモードのh: Header formatへ任意の文字列を設定したときは、それをハンドル名として利用します。ただし、ハンドル名は無線パケットに格納するデータを消費します。

送信側の入力書式

プロンプトに続けて、メッセージと改行文字を入力します。

810A4778:0> Hello

受信側の出力書式

補助情報に続けて、受信したメッセージを出力します。

補助情報は、モジュールの拡張アドレスまたはハンドル名と、続き番号を含みます。

[810A4778:0] Hello

その他の入力

エスケープシーケンスに対応したターミナルでは、以下の制御コマンドを使用できます。

• Ctrl-L：画面のクリア
• Ctrl-C：入力のキャンセル
• BS/DEL：カーソルを戻す

4 - シリアル通信アプリの透過モード

外部マイコン同士を簡単に接続できますが、書式を用いて通信を最適化するには書式モード（アスキー／バイナリ）が適しています。

概要

純粋にUARTを無線化します。

書式を必要としないため、既存の UART 通信を簡単に無線化できます。

一方で、データの区切りがあいまいになってしまうほか、受信側の出力から送信元を判別できないといった欠点があります。

初期状態では、送信トリガ文字にCRLFを指定しています。したがって、送信側へ入力されたデータをCRLFで区切り、CRLF よりも前のデータを送信します。

例えば、送信側の端末へ Hello<Enter> と入力すると、受信側の端末はそのまま Hello を出力します。

【送信側】

Hello  <- 入力

【受信側】

Hello  <- 出力

連続して入力された文字列を80バイトごとに分割して送信します。トリガ文字までのデータは通常80バイト以下としてください。

全ての端末は子機としたうえで、送信内容はブロードキャストします。すべての端末と通信できますが宛て先は指定できません。アスキー文字だけでなく、バイナリデータも送信できます。

中継は3段（3ホップ）まで対応しています。初期設定では中継しません。

親機と子機の区別

透過モードは、親機と子機を区別しません。

アプリケーションIDと周波数チャネルが同一であれば、どの端末へ入力したデータもほかの端末へと送信されます。

送信元の判別

透過モードでは、送信元を判別できません。

送信元を判別するには、送信側へ入力するデータそのものに送信元の情報を含める必要があります。

送信トリガ

送信側の入力に書式はありませんが、データはある時点で分割されたのち、パケットごとに無線で送信されます。

したがって、次に挙げる送信トリガを意識しなくてはなりません。

• データ入力後のタイムアウトを迎えたとき
• 入力データが最小データサイズを満たしたとき
• 送信トリガ文字を受け取ったとき

送信トリガの設定は、インタラクティブモードのk：送信トリガ項目から指定します。

設定例

送信トリガ文字をLF、最小データサイズを8バイト、タイムアウトを30msとする場合は次のように設定します。

 m: set UART mode (D)
 k: set Tx Trigger (sep=0x0a, min_bytes=8 dly=30[ms])
 o: set option bits (0x00000100)

5 - シリアル通信アプリのヘッダ付き透過モード

概要

初期状態で有効となっています。

送信側の端末へ任意のデータを入力すると、受信側の端末は受信した内容に特定の書式で補助情報を付加したデータを出力します。

初期状態では、送信側へ入力されたデータをCRLFで区切り、CRLF よりも前のデータを送信します。

例えば、送信側の端末へ Hello<Enter> と入力すると、受信側の端末は補助情報を含んだ書式で Hello を出力します。送信側の端末も送信完了といったメッセージを伝える書式を出力します。

【送信側】

Hello  <- 入力
;U;00004;219;0x820163B2;000;000;0,1,Hel...;6E;  <- 出力

【受信側】

;U;00003;000;0x820163B2;255;000;Hello;42;  <- 出力

受信側が出力する補助情報は、送信元のアドレスや受信時の電波強度、チェックサム等を含みます。補助情報の書式はカスタマイズできます。

親機と子機の区別

ヘッダ付き透過モードは、親機と子機を区別しません。

アプリケーションIDと周波数チャネルが同一であれば、どの端末へ入力したデータもほかの端末へと送信されます。

送信元の判別

ヘッダ付き透過モードで受信したデータからは、送信元を判別できます。

受信側が出力する補助情報を表すヘッダに含むことのできる論理デバイスIDやシリアルIDのデータを利用します。

受信側の出力書式

出力書式はセミコロン（;）区切りとして表現されます。

【初期状態における出力例】

;U;00777;120;0x81025A17;120;013;HELLO;79;

この出力例は、次のように解釈できます。

ヘッダフォーマットによるカスタマイズ

受信側の出力書式は、ヘッダフォーマットに従います。

ヘッダフォーマットを変更することで、受信側が出力する補助情報の内容やチェックサムの計算範囲をカスタマイズできます。

ヘッダフォーマットの変更は、インタラクティブモードの h: set header format から行います。

最も簡単な書式

最も簡単な書式を表すヘッダフォーマットは *\n です。受信したデータへ CRLF の改行文字を付与して出力します。

 h: set header format [*\n]

この場合にHELLOを送信すると、次のように振る舞います。

【受信側】

HELLO<CR><LF> または HELLO<LF>

【送信側】

HELLO<CR><LF>

フォーマットを構成する特殊文字

ヘッダフォーマットに次の特殊文字を含めることで、出力内容をカスタマイズできます。

全般

\（バックスラッシュ・￥）に続くもの

%に続くもの

チェックサムの計算

チェックサムはデータの先頭あるいはヘッダフォーマットの<を指定した箇所から%X,%xの直前までを XOR（排他的論理和）にて計算します。

初期状態の例

初期状態ではヘッダフォーマットを ;U;%t;%i;0x%A;%q;%s;<*;%X;\n としており、チェックサムの計算範囲は*;です。

すなわち、HELLO を送信した場合は HELLO; のバイナリデータを対象とするため、チェックサムは0x79です。

【Python による検証コード】

from functools import reduce

def main():
    data = "HELLO;"
    checksum = reduce(lambda x, y: x ^ y, data.encode("ascii"))
    print(f"{data} -> {hex(checksum)}")

if __name__ == "__main__":
   main()  # HELLO; -> 0x79

その他の例

例えば、ヘッダフォーマットを ;%I;*;%X とした場合を考えます。

<を指定していないため、チェックサムの計算範囲は;%I;*;です。

すなわち、HELLO を送信した場合は ;000;HELLO; のバイナリデータを対象とするため、チェックサムは 0x49 です。

【Python による検証コード】

from functools import reduce

def main():
    data = ";000;HELLO;"
    checksum = reduce(lambda x, y: x ^ y, data.encode("ascii"))
    print(f"{data} -> {hex(checksum)}")

if __name__ == "__main__":
   main()  # ;000;HELLO; -> 0x49

送信トリガ

送信側の入力に書式はありませんが、データはある時点で分割されたのち、パケットごとに無線で送信されます。

したがって、次に挙げる送信トリガを意識しなくてはなりません。

• データ入力後のタイムアウトを迎えたとき
• 入力データが最小データサイズを満たしたとき
• 送信トリガ文字を受け取ったとき

送信トリガの設定は、インタラクティブモードのk：送信トリガ項目から指定します。

設定例

送信トリガ文字をLF、最小データサイズを8バイト、タイムアウトを30msとする場合は次のように設定します。

 m: set UART mode (E)
 k: set Tx Trigger (sep=0x0a, min_bytes=8 dly=30[ms])
 o: set option bits (0x00000100)