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

設定

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

• Role に 80 を足しておく。通常の親機子機なら 80 で良い。

• UART mode を書式モード（アスキー・バイナリ形式）に設定しておく。

サイレントモードの動作状態確認

起動直後に DB F1 メッセージが出力され、メッセージ中にサイレントモード状態かどうかの値が格納されています。

サイレントモードについて

インタラクティブモードでサイレントモードおよび書式モード（バイナリ・アスキー）に設定した場合、サイレントモードを利用できます。

サイレントモードを解除するには、サイレントモード解除の DB F8 コマンド(0xDB 0xF8 0x10, アスキー形式では :DBF810X) を送信します。

注意点

• サイレントモードを解除後は、サイレントモード状態に再設定する事は出来ません。

• 送信コマンドを投入した時の動作は未定義です。

書式モードでコマンド表現されたバイト列をアスキー形式に変換します。

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

形式の定義

チェックサムの省略

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

書式モードでコマンド表現されたバイト列をバイナリ形式に変換します。

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

形式の定義

使ってみる

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

特徴

書式モードは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 コマンド

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

サイレントモード

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

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

コマンド書式

書式は先頭をDBとし、コマンド種別およびコマンドごとに決まるパラメータとなります。

例

例えばアプリケーションIDを 0x12345678 に設定する場合、コマンド種別が F2 で、パラメータが 00 12 34 56 78 、コマンドは DB F2 12 34 56 78 となります。

アスキー形式(チェックサム省略)では :DBF212345678X となります。コマンド発行後には応答が戻ります。

バイナリー形式では、0xA5 0x5A ... XOR という加工が必要になります。 DB F2 00 12 34 56 78 というコマンドに対してバイナリで　A5 5A 80 07 DB F2 00 12 34 56 78 21 という 12 バイトを送ります。

（インタラクティブモード中での入力はしないでください）

コマンド種別

パラメータ (F2, F3)

設定(F2)、設定取得(F3) 時のパラメータは、設定種別と設定内容を列挙します。設定内容は種別によって書式が変化します。

設定種別ごとのパラメータを解説します。 ※ 0xFF(OCTET) 0xFFFF(BE_WORD) 0xFFFFFFFF(BE_DWORD) の場合は、無効値として無視されます。

凡例

• OCTET: 8bit=1バイトを示す。

• BE_WORD: ビッグエンディアン 2 OCTETを示す。例えば 0x1234 は 0x12 0x34 の順に並びます。

• BE_DWORD: ビッグエンディアン 4 OCTETを示す。例えば 0x12345678 は 0x12 0x34 0x56 0x78の順に並びます。

App_Uart を書式モードのバイナリ形式で使ってみます。

バイナリ形式では、App_Uart で直接送信したいデータをバイナリ列で入出力できるため、マイコン間通信では取り扱いがしやすくなります。反面、ヘッダやチェックサムなどの計算が必要になります。

簡易的に送信する場合は「チャットモード、プロンプト無し」も利用できます。

接続の確認

最初に基本設定とアスキー形式による動作確認を行います。接続や設定等の問題がある場合、バイナリ形式では出力等を含め確認が難しいためです。

設定

PC(TeraTerm) や macOS, Linux のターミナルソフト(CoolTerm など) を動作可能状態にして、インタラクティブモードによる設定が出来る事を確認しておいてください。

インタラクティブモードに入るには、+ + + と + を３回、一呼吸置きながら (0.2秒～1秒) 入力します。(参考：)

インタラクティブモードで以下の設定を済ませておきます。

1. 親機側は Device ID を 121 (0x79) に設定します。(i を押して 121[Enter] と入力します)

2. UART Mode を A に設定します。(m を押して A[Enter] と入力します)

3. S キーを押してセーブ＆リセットを実行します。

以下のようなメッセージが出力されます。:DB... は起動時のメッセージで、アプリケーションIDやアドレス情報が含まれます。

アスキー 形式で確認する

アスキー形式での動作を確認します。マイコンで利用される方も、まず Windows PC などでご確認ください。

コマンド列の送信方法

マイコンなどプログラムからコマンド列が入力されることを想定しており、一定時間入力が無ければ(1000ms)タイムアウトが発生して入力を無効にするようになっています。

このため、コマンド列を入力する際には、ターミナルソフト等のコピー＆ペースト機能(TeraTermならAlt+V)などを利用し、タイムアウトしないように入力してください。

なお、インタラクティブモードでは、タイムアウトが発生せず入力毎のエコーバック（入力した文字がターミナルに表示される）とチェックサムが間違えていた時にメッセージが表示できるようになっています。このためキーボードから直接入力しても試せます。

アスキー形式による親子間送受信

受信データは 0x78 からコマンド種別 0x00 でデータ 0x11 0x22 0x33 が届き、チェックサムが 0x22 です。この出力が確認できたら、今度は子機から親機に同様のメッセージを送ってみます。

親子間の簡易通信を確認しました。続いてこれと同じ送受信をバイナリ形式で行ってみます。

親機のみバイナリ形式で親子間送信

バイナリ形式の無線端末とアスキー形式の無線端末は互いに通信が可能です。入出力の書式が違うだけで、無線パケットは同じです。

ここでは親機だけバイナリ形式にしてみます。バイナリ形式での送受信を行うためには、バイナリ対応のターミナルソフトウェアが必要です。バイナリではターミナルソフトごとに操作や表示が異なりますので、よく習熟してください。

参考までに Linux, macOS 対応のターミナルを列挙します。

親機の設定

親機側のインタラクティブモードに入って UART Mode を B に設定します。

• UART Mode を B に設定します。(m を押して A[Enter] と入力します)

バイナリ対応のターミナルソフト (RealTermの場合)

親機のターミナルソフトウェアを閉じて、バイナリ対応のものを立ち上げてください。

以下では RealTerm の操作例です。

1. [Port] タブを選択し、Baud を 115200・Port を COM ポートの番号を指定して [Open] ボタンを押します。

2. [Display] タブを選択し、[Display As] 中から Hex[space] を選択しておきます。

送受信を確認する

子機からアスキー形式での送信例と同じものを送信してみます。

親機からは 0xA5 0x5A ... に続くデータが表示されます。送信したいデータに簡易書式のヘッダが付加され、さらにバイナリ書式のためのヘッダ・フッタが追加される点に注意してください。

親機子機、バイナリ形式で親子間送信

親機、子機双方をバイナリ形式に設定して送受信を試みます。

子機の設定

子機側でもインタラクティブモードに入って UART Mode を B に設定します。

• UART Mode を B に設定します。(m を押して A[Enter] と入力します)

バイナリ対応のターミナルソフト (RealTermの場合)

子機のターミナルソフトウェアを閉じて、バイナリ対応のものを立ち上げてください。

以下では RealTerm の操作例を示します。

1. RealTerm を立ち上げます。

2. [Port] タブを選択し、Baud を 115200・Port を COM ポートの番号を指定して [Open] ボタンを押します。

3. [Display] タブを選択し、[Display As] 中から Hex[space] を選択しておきます。

子機から親機への送信

子機から親機にデータ送信してみます。

子機側からデータ送信する方法はターミナルソフト毎に操作方法が違います。RealTerm の場合は、以下となります。

1. [Send]タブを開きます。

2. [Send Numbers] の２つある入力ボックスのいずれかに 0xA5 0x5A 0x80 0x05 0x78 0x00 0x11 0x22 0x33 0x78 を入力します。

3. [Send Numbers] ボタンを押します。

子機から親機への送信

親機から子機へデータ送信してみます。