# アリアアプリ

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

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

{% hint style="info" %}
書式は[パルアプリ](/how-to-use/parent-mode/receive-message/app_pal.md)と同様です。詳しい説明は[こちら](/how-to-use/parent-mode/receive-message/app_pal/app_pal-detail.md)をご覧ください。
{% endhint %}

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

{% hint style="info" %}
以下のご案内はTWELITE ARIAモード時のご案内です。

開閉センサーパルモードの場合は[こちら](/how-to-use/parent-mode/receive-message/app_pal.md#sensparu)をご確認ください。
{% endhint %}

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

```
:80000000CF00028201BAA201800607003400038135001205350401000000113008020D201130010204ED00000001800501000209D0010200020F347934[CR][LF]
```

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

{% hint style="info" %}
データの詳細情報は[こちら](/how-to-use/parent-mode/receive-message/app_pal/app_pal-detail.md)をご参照ください。
{% endhint %}

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

### データの位置の表記法

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

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

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

```
[15:15+4]
```

### 温湿度センサー

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

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

### 磁気センサー

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

<table><thead><tr><th width="150">磁気センサーデータ</th><th>意味</th></tr></thead><tbody><tr><td>磁気センサーのデータ</td><td>意味</td></tr><tr><td>00</td><td>磁石が遠ざかった。</td></tr><tr><td>01</td><td>磁石のN極が近づいた。</td></tr><tr><td>02</td><td>磁石のS極が近づいた。</td></tr><tr><td>80</td><td>磁石が近くにない。(タイマーによる定期送信)</td></tr><tr><td>81</td><td>磁石のN極が近くにある。(タイマーによる定期送信)</td></tr><tr><td>82</td><td>磁石がS極が近くにある。(タイマーによる定期送信)</td></tr></tbody></table>

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

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

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

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

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

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

```python
>>> 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
```

<table><thead><tr><th width="150"></th><th></th><th width="150"></th><th width="171"></th><th></th></tr></thead><tbody><tr><td></td><td>意味</td><td>バイト数</td><td>データ例</td><td>備考</td></tr><tr><td>1</td><td>中継機シリアルID ​</td><td>4</td><td>80000000</td><td>中継されていない場合は80000000</td></tr><tr><td>2</td><td>LQI</td><td>1</td><td>CF</td><td>大きいほど電波品質が良い</td></tr><tr><td>3</td><td>続き番号</td><td>2</td><td>0002</td><td></td></tr><tr><td>4</td><td>送信元シリアルID</td><td>4</td><td>8201BAA2</td><td></td></tr><tr><td>5</td><td>送信元LID</td><td>1</td><td>01</td><td></td></tr><tr><td>6</td><td>センサー種別</td><td>1</td><td>80</td><td>TWELITE ARIAは80固定</td></tr><tr><td>7</td><td>PAL ID</td><td>1</td><td>06</td><td>TWELITE ARIAモードは06</td></tr><tr><td>8</td><td>センサーデータ数</td><td>1</td><td>07</td><td></td></tr><tr><td>9</td><td>センサーデータ0(ヘッダ)</td><td>4</td><td>00340003</td><td>拡張バイトなし、符号なし1バイト、パケットプロパティが3バイト</td></tr><tr><td>a</td><td>センサーデータ0</td><td>3</td><td>813500</td><td>タイマーイベントで送信した</td></tr><tr><td>b</td><td>センサーデータ1(ヘッダ)</td><td>4</td><td>12053504</td><td>拡張バイトあり、符号なしLong、タイマーイベント情報</td></tr><tr><td>c</td><td>センサーデータ1</td><td>4</td><td>01000000</td><td>タイマーが起床させた</td></tr><tr><td>d</td><td>センサーデータ2(ヘッダ)</td><td>4</td><td>11300802</td><td>符号なし2バイト、電源電圧</td></tr><tr><td>e</td><td>センサーデータ2</td><td>2</td><td>0D20</td><td>3360mV</td></tr><tr><td>f</td><td>センサーデータ3(ヘッダ)</td><td>4</td><td>11300102</td><td>符号なし2バイト、ADC1</td></tr><tr><td>g</td><td>センサーデータ3</td><td>2</td><td>04ED</td><td>1261mV</td></tr><tr><td>h</td><td>センサーデータ4(ヘッダ)</td><td>4</td><td>00000001</td><td>拡張バイトなし、符号なし1バイト、磁気センサー</td></tr><tr><td>i</td><td>センサーデータ4</td><td>1</td><td>80</td><td>変化なし、オープン<br>(00: 磁石が離れた。<br>01: N極が近づいた<br>02: S局が近づいた<br>80: 変化なし(磁石なし)<br>81: 変化なし(N極が近くにある)<br>82: 変化なし(S極が近くにある))</td></tr><tr><td>j</td><td>センサーデータ5(ヘッダ)</td><td>4</td><td>05010002</td><td>拡張バイトなし、符号あり2バイト、温度</td></tr><tr><td>k</td><td>センサーデータ5</td><td>2</td><td>09D0</td><td>25.12℃</td></tr><tr><td>l</td><td>センサーデータ6(ヘッダ)</td><td>4</td><td>01020002</td><td>拡張バイトなし、符号なし2バイト、湿度</td></tr><tr><td>m</td><td>センサーデータ6</td><td>2</td><td>0F34</td><td>38.92%</td></tr><tr><td>n</td><td>チェックサム1</td><td>1</td><td>79</td><td>1～ｍまでのLRC</td></tr><tr><td>o</td><td>チェックサム2</td><td>1</td><td>34</td><td>1～nまでのCRC8</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wings.twelite.info/how-to-use/parent-mode/receive-message/app_aria.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.