トワイライト（TWELITE）の中継機能の効果

こんにちは、ENGかぴです。

トワイライト（TWELITE）はZigBee通信であり通信の中継機能を持っています。中継機能によって通常では無線通信が届かない範囲の通信ができます。MWSTAGEのライブラリであるNWK_SIMPLEを使って中継機能の効果を確認しました。

下記記事のソースコードを流用して動作確認しています。

トワイライトを太陽光パネルで動作させたことやMWSTAGEの環境でソフト開発して無線通信したことなどについてまとめています。

中継機能の動作

親機から子機Bに無線通信を行う例で中継機能を説明します。親機から子機Bまでの距離において無線通信が届かないものとします。親機と子機Bの間に子機A（中継機能あり）を配置すると親機が送信した子機Bへの無線通信が子機Aを経由して子機Bに届くようになります。

子機Aも子機Bと同様に子機として動作させることもできるため親機は子機A及び子機Bの情報を取得できるようになります。中継機能の使用例などの詳細は下記リンクを参考にしてください。

親機と子機でアプリケーションID・チャンネル番号・アプリ識別のための文字列を共通にする必要があります。

const uint32_t APP_ID = 0x1234abcd; // application ID
const uint8_t CHANNEL = 13; // channel
const char APP_CHAR[] = "COM";

TWENETに上記で定数宣言しているAPP_IDとCHANNELを指定して設定します。

the_twelite
    << TWENET::appid(APP_ID) //アプリケーションID
    << TWENET::channel(CHANNEL) //チャンネル設定
    << TWENET::rx_when_idle(); //無線通信を受信する場合は実装

無線通信を受信する場合はrx_when_idle()を実装する必要があります。子機は親機からの受信が必要なのでrx_when_idle()を実装する必要がありますが、親機で送信専用にする場合は実装の必要はありません。

auto&& nwksmpl = the_twelite.network.use<NWK_SIMPLE>();
nwksmpl << NWK_SIMPLE::logical_id(0x01) 
	<< NWK_SIMPLE::repeat_max(1); //default:2

TWENETライブラリのnetwork関数を使用して論理IDの設定を行います。ネットワークのlogical_idに0x01～0xEFもしくはFE（IDの区別がない）をセットすることで子機として動作します。

repeat_max()に1～3を指定すると中継する回数が指定できます。0を指定すると中継機能をもたない子機になります。MWSTAGEのライブラリではデフォルトで2となるため特に指定しなくても中継機能が使用できます。例では中継する回数を1回にしています。

中継する台数が増えたり子機のリトライ回数が多い場合はパケットが渋滞して破棄されたりするため設置環境の検討が必要な場合があります。また、中継器は常に受信できるようにしておく必要があるため安定した電源が必要になります。

親機と子機（論理ID：0x02）は同軸ケーブルアンテナタイプのTWELITE DIPを使用しています。同軸ケーブルアンテナを実装しなければ電波の全く飛ばないモジュールになります。親機と子機（論理ID：0x02）を離して通信できないように配置します。

親機と子機（論理ID：0x02）の間に子機（論理ID:0x01）を配置して中継機能の動作を確認します。

親機は下表のように15、16ピンをGNDに接続するパターンで送信先を選択しSW1を押すと無線通信を行います。子機は親機からの無線通信を受けてLEDを点灯/消灯します。

親機の送信先切り替え

親機の送信先を0x02にしてSW1を押すと電波が届く範囲であれば子機（論理ID：0x02）のLEDが点灯/消灯します。動作を確認しながら子機（論理ID：0x02）のLEDが点灯/消灯しない位置に配置します。

子機（論理ID：0x01）を親機と子機（論理ID：0x02）の間に配置すると子機（論理ID：0x01）の中継機能によって子機（論理ID：0x02）のLEDが点灯/消灯することが確認できました。

子機（論理ID：0x01）の中継機能をNWK_SIMPLE::repeat_max(0)を指定して中継しない設定にすると子機（論理ID：0x02）のLEDが点灯/消灯しないことが確認できました。

App_Wingsが提供されていますがMWSTAGEのACTを使用した方が開発しやすいためて大掛かりなシステムで中継しない限りMWSTAGEのACTによる中継で問題ないと思います。

ソースコードは記事作成時点において動作確認できていますが、使用しているライブラリの更新により動作が保証できなくなる可能性があります。また、ソースコードを使用したことによって生じた不利益などの一切の責任を負いかねます。参考資料としてお使いください。

リンクからZIPファイル形式のファイルをダウンロードし、任意の場所に展開していただくとテキストファイルが生成されます。

TWELITEのソースコードはMWSTAGEの環境でアクトのソースファイルにコピーすると使用できます。子機のソースコードのNWK_SIMPLE::repeat_max(1)の引数を0にすると中継機能が停止します。