アリアアプリ マニュアル

• 1: アリアアプリ マニュアル
• 1.1: アリアアプリの使用方法
• 1.1.1: アリアアプリの動作確認
• 1.1.2: アリアアプリの動作モード
• 1.1.2.1: アリアアプリのTWELITE ARIAモード
• 1.1.2.2: アリアアプリの開閉センサーパルモード
• 1.2: アリアアプリの設定方法
• 1.2.1: アリアアプリのOTAによる設定
• 1.2.2: アリアアプリのTWELITE R2/R3による設定
• 1.3: インタラクティブモード（アリアアプリ）

1 - アリアアプリ マニュアル

1.1 - アリアアプリの使用方法

1.1.1 - アリアアプリの動作確認

必要なもの

1. TWELITE CUE
2. MONOSTICK

電池を入れる

CR2032電池の＋側を電池ホルダー（＋）の向きで差し込みます。TWELITE CUEのLEDが3回点滅すれば正常です。
起動後は5秒毎に送信をし、送信時にLEDが1回点滅します。

また、TWELITE ARIAの電池ホルダーは構造上、半田付け部が外れやすいため、以下に注意して電池を挿入してください。

• コイン電池の取り外し時には電池ホルダーの半田付け部に力がかかりにくくなるように、電池ホルダーを上から軽く指で押さえながらコイン電池を取り外すことを推奨します。
• TWELITE ARIAの運用時は、専用ケースで電池ホルダーを上から押さえながら使用することを推奨します。

固定用磁石を取り付ける

図の位置の窪みに磁石を取り付けると、TWELITE ARIAを金属面に貼り付けることができます。必要に応じてお使いください。

ケースに入れる

丸印で示したようにケースの縁にある爪に引っ掛けて収めてください。

ケースを開ける

ケースの切り込みにコインを差し込みこじ開けてください。

親機・中継機の準備

通信相手として親機が必要です。通信距離を延長する場合は中継機が使用できます。親機、中継機にはMONOSTCK - モノスティックを使用することができます。

MONOSTCK - モノスティックのアプリは親機・中継機アプリ Wings-ウイングスのバージョンv1-01-4以上を書き込んでください。

動作確認をする

TWELITE ARIAを動かしたり、磁石を近づけたりして、パソコンに接続したMONOSTICKで受信したデータを確認してみましょう。

TWELITE STAGE SDKの準備

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

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 - モノスティックを使用することができます。
以下の手順で親機・中継機アプリ Wings-ウイングスをMONOSTICK - モノスティックに書き込んでください。

1. トップメニューから 2:アプリの書換 > 1:BINから選択を選択してください。
2. MONOSTICK BLUE を使用している場合はApp_Wings_MONOSTICK_BLUE_… を選択し、MONOSTICK RED を使用している場合はApp_Wings_MONOSTICK_RED_… を選択してください。
3. 書き込み完了後はインタラクティブモードに入らずにESCキーを長押ししてトップメニューに戻ってください。

ビューアを選択する

1. トップメニューから 1:ビューア > 4: CUE/ARIAビューア を選択します。
2. TWELITE ARIA タブをクリックします。

TWELITE ARIAの動作確認をする

温度、湿度を計測する

5秒ごとに温湿度の値が更新されます。

磁石を検出させる

• 磁石のN極を磁気センサーに近づけると「[N極]」と表示されます。
• 磁石のS極を磁気センサーに近づけると「[S極]」と表示されます。
• 磁石を磁気センサーから遠ざけると「 —- 」と表示されます。

モードを変更する

モードを変更することで、TWELITE ARIAの振る舞いを変更することができます。

詳しくは以下のページをご確認ください。

モード選択

設定を変更する

グループ分けや送信頻度の変更などはインタラクティブモードで設定できます。

インタラクティブモードへの移行方法は以下のページをご確認ください。

設定方法

また、設定できる項目については以下のページをご確認ください。

インタラクティブモード

ログを出力する

パルスクリプトで温湿度などのデータをCSV形式でログに出力することができます。

詳しくは以下のページをご確認ください。

パルスクリプト

グラフを描画する

パルビューアで温湿度や磁気センサーの値をグラフで見ることができます。

詳しくは以下のページをご確認ください。

パルビューア

1.1.2 - アリアアプリの動作モード

TWELITE ARIAモード

TWELITE ARIAの初期モードです。

温湿度計測とドアの開閉の検知を同時に行うことができるオールインワンモードです。

開閉センサーパルモード

開閉センサーパルとして動作するモードです。

ドアの開閉や工場設備の稼働状況を計測する場合は本モードを使用します。

1.1.2.1 - アリアアプリのTWELITE ARIAモード

工場出荷時は本モードに設定されております。

設定

本モードを使用する場合は以下の項目を設定してください。

親機の出力

代表的な電池寿命

• 5秒に1度の定期送信のみの場合、約340日
• 5秒に1度の定期送信 + 1分に1度磁石を近づけた場合、約300日
• 1分に1度の定期送信のみの場合、約4年
• 1分に1度の定期送信 + 1分に1度磁石を近づけた場合、約2.5年

1.1.2.2 - アリアアプリの開閉センサーパルモード

設定

本モードを使用する場合は以下の項目を設定してください。

親機の出力

代表的な電池寿命

1日に200回の開閉を行なった場合、約4年です。（含１分毎の定期送信）
1日に0回の開閉を行なった場合、約4.5年です。（含１分毎の定期送信）

1.2 - アリアアプリの設定方法

アリアアプリを設定する方法は以下の2種類あります。

設定できる内容に関してはインタラクティブモードをご確認ください。

OTAによる設定

OTAとはOver the Airの略です。非接触での通信を意味します。OTA設定はインタラクティブモードの設定をケーブル接続不要で行う機能です。

OTAを実行するには MONOSTICK-モノスティックが必要です。

TWELITE R2を使用する設定

TWELITE CUEの7PインターフェイスにTWELITE R2/R3を接続し、インタラクティブモードで設定を行うことも可能です。

1.2.1 - アリアアプリのOTAによる設定

OTA設定は、インタラクティブモードの設定を無線経由で行う機能です。

OTAによる設定手順

以下の手順でOTAによる設定を行います。

1. TWELITE STAGE APPを起動する

パソコンにTWELITE STAGE SDK をインストールし、MWSTAGEフォルダ内のTWELITE_Stageを起動する。

2. MONOSTICKにOTA設定用のアプリを書き込む

2: アプリ書換 > 1: BINから選択 を開き、App_ARIA_OTA_... を選択する。

3. インタラクティブモードで設定値を入力する

3: インタラクティブモードを選択し、値を編集・保存する。

4. OTA設定を実行する

MONOSTICKから約20cm以内の距離に TWELITE ARIA を置く。本体の電源を投入するか、または磁石を磁気センサーへ5回以上接近させて、TWELITE ARIA の LED が点滅することを確認する。

5. MONOSTICKの出力を確認する

次のようなメッセージの出力を確認する。 出力されない場合はこちら

6. MONOSTICKのアプリを書き戻す

2: アプリ書換 > 1: BINから選択 を開き、App_Wings_MONOSTICK_... を選択する。

OTAに失敗した場合

距離が遠い

次のようなメッセージは、距離が遠いことを示します。

OTA FAILURE
  OTA request TS=20515[ms]
  LQI:63 (RF strength, >= 100)
  SID:810BA765
  TWELITE ARIA:v1.1.1
  Protocol Version:0x13

--— LQI is small. Please make TWELITE ARIA closer. —--

この場合は、MONOSTICK と TWELITE ARIA の距離を近づけてください。

対象が異なる

次のようなメッセージは、TWELITE ARIA のファームウェアが異なっているか、間違って TWELITE CUE を近づけていることを示します。

OTA FAILURE
  OTA request TS=20515[ms]
  LQI:180 (RF strength, >= 100)
  SID:810BA765
  TWELITE ARIA:v1.1.1
  Protocol Version:0x11

--— Different protocol version. Please update TWELITE ARIA. —--

この場合は、間違って TWELITE CUE を近づけていないか確認してください。 また、TWELITE ARIA のファームウェアを書き換えていた場合は、TWELITE R2/R3を使って App_ARIA へ書き戻してください。

1.2.2 - アリアアプリのTWELITE R2/R3による設定

TWELITE ARIAの7PインターフェイスへTWELITE R2/R3を接続することで設定できます。

TWELITE R2/R3を使用して設定する場合は以下の手順で設定してください。

1. TWELITE STAGE APPを起動する

パソコンへTWELITE STAGE SDK をインストールし、MWSTAGEフォルダ内のTWELITE_Stageを起動する。

2. インタラクティブモードで設定値を入力する

3: インタラクティブモードを選択し、値を編集・保存する。

1.3 - インタラクティブモード（アリアアプリ）

ここではアリアアプリ（App_ARIA）に固有の機能を説明します。共通機能については、TWELITE APPS マニュアル のトップページを参照してください。

表示例

次のような画面を表示します。

 --- CONFIG/App_ARIA V1-01-0/SID=0x810a7817/LID=0x01 ---
 a: set Application ID (0x67720102)
 i: set Device ID (--)
 c: set Channels (18)
 x: set Tx Power (13)
 b: set UART baud (38400)
 B: set UART option (8N1)
 k: set Enc Key (0xA5A5A5A5)
 o: set Option Bits (0x00000001)
 t: set Transmission Interval (5)
 p: set Senser Parameter (0x00000000)
 d: set Temperature Coefficient (0)
 D: set Temperature Offset (0)
 f: set Humidity Coefficient (0)
 F: set Humidity Offset (0)
---
 S: save Configuration
 R: reset to Defaults

コマンド

各コマンドの詳細を次に示します。

a：アプリケーションID

通信を行う端末はすべて同一の値とします。論理的にネットワークを分離します。

i：論理デバイスID

複数の子機を識別する必要がある場合に設定します。

1-100の任意の値を設定できます。

c：周波数チャネル

通信を行う端末はすべて同一の値とします。物理的にネットワークを分離します。

x：送信出力と再送回数

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

b：UART代替ボーレート

適用できません。TWELITE DIP 等の製品とは異なり BPS ピンがないからです。

B：UARTオプション

適用できません。TWELITE DIP 等の製品とは異なり BPS ピンがないからです。

k：暗号鍵

オプションビットの暗号化通信の有効化を設定した場合の暗号化鍵を32bitの16進数で指定します。

o：オプションビット

32bit の数値を指定します。各ビットに紐付いた設定を有効化できます。

t：送信間隔

データの送信間隔を指定します。

p：センサ固有パラメータ

動作モードの切り替えに使用します。

d：温度係数

0-60000の範囲で温度データの係数\(d\)を指定します。

0の場合は無効です。それ以外の値では、最終的な温度を\(\frac{d}{1024}\)倍とします。

D：温度オフセット

-2000-2000の範囲で温度データのオフセット\(D\)を指定します。

100倍された温度に\(D\)を加算します。最終的な温度は \(\frac{D}{100}\)°C 変化します。

f：湿度係数

0-60000の範囲で湿度データの係数\(f\)を指定します。

0の場合は無効です。それ以外の値では、最終的な湿度を\(\frac{f}{1024}\)倍とします。

F：湿度オフセット

-2000-2000の範囲で湿度データのオフセット\(F\)を指定します。

100倍された湿度に\(F\)を加算します。最終的な湿度は \(\frac{F}{100}\)% 変化します。

オプションビットの詳細

オプションビットの値の各ビットに紐付く設定を解説します。

00000001：中継機への送信を有効化

親機だけでなく、中継機へ向けた送信を有効化します。

このオプションを設定していない場合にも中継機を使用できますが、親機は重複して届いたパケットを排除します。このとき、パケットがどの中継機を通して伝わったのか、あるいは中継されていないのかを確かめる術はありません。

このオプションを設定していると、親機は複数の端末から受信した一つのパケットを別々に出力することができます。親機に接続されたデバイスが出力を分析することで、子機がどの端末の近くにあったのかを調べることができます。

00000040：OTA設定機能を無効化

OTA設定の機能を無効化します。

00001000：暗号化通信の有効化

暗号化通信を有効にします。相手側の暗号化通信も有効化する必要があります。

00010000：子機のUART出力を有効化

子機のメッセージ出力を有効化します。