# キューアプリ TWELITE CUEには加速度センサーと磁気センサーが搭載されており、両方のセンサーのデータも出力メッセージに含まれます。 このページでは出力メッセージからそれらのセンサーデータの読み方について解説します。 {% hint style="info" %} 書式は[パルアプリ](https://wings.twelite.info/how-to-use/parent-mode/receive-message/app_pal)と同様です。詳しい説明は[こちら](https://wings.twelite.info/how-to-use/parent-mode/receive-message/app_pal/app_pal-detail)をご覧ください。 {% endhint %} ## センサーデータの簡易的な読み方 {% hint style="info" %} 以下のご案内はTWELITE CUEモード時のご案内です。 動作センサーパルモードの場合は、[こちら](https://wings.twelite.info/how-to-use/parent-mode/app_pal#sensparu-2)をご確認ください。 また、開閉センサーパルモードの場合は[こちら](https://wings.twelite.info/how-to-use/parent-mode/app_pal#sensparu)をご確認ください。 {% endhint %} 下記のデータ羅列は、: に始まり改行コードまでの１６進数データをテキストで表現したものです。 ``` :80000000CF7F7382019E3B0180050F003400038135001205040406000000113008020B8611300102042E000000018015044006FFF00010FC1815044106FFF00018FC1815044206FFF00010FC0015044306FFF80000FC1015044406FFF00010FC1815044506FFE00018FBF815044606FFE80000FC0015044706FFE80010FBF815044806FFE80010FC0815044906FFE80010FC080C0E[CR][LF] ``` 上記は逐次解釈する書式ですので、厳密に解釈するのは煩雑です。 {% hint style="info" %} データの詳細情報は[こちら](https://wings.twelite.info/how-to-use/parent-mode/receive-message/app_pal/app_pal-detail)をご参照ください。 {% endhint %} そのため、各センサーの値の場所とその抽出例をご説明します。\ その際、: を 0 文字目とします。 ### データの位置の表記法 以下の説明では、データの位置を示す際、Pythonのリストの指定の表記ような以下の書式でご案内します。 ``` [データの開始位置:データの開始位置+文字数] ``` 例えば、15文字目から4文字を指定する場合は、以下のように表記します。 ``` [15:15+4] ``` ### 加速度 加速度データは103文字目から時系列順でX、Y、Zに並んだ加速度が10個分格納されます。\ 加速度は、符号付整数で単位はmg(1重力加速度(g)の1/1000)です。\ ＊データが12文字、ヘッダが8文字で、20文字ごとにデータが並ぶ。 ``` [93:93+2] 80 磁気センサー [103:103+12] FFF00010FC18 データ１ FFF0(X軸)/0010(Y軸)/FC18(Z軸) [123:123+12] FFF00018FC18 データ２ FFF0(X軸)/0018(Y軸)/FC18(Z軸) [143:143+12] FFF00010FC00 ... [163:163+12] FFF80000FC10 [183:183+12] FFF00010FC18 [203:203+12] FFE00018FBF8 [223:223+12] FFE00018FBF8 [243:243+12] FFE80010FBF8 [263:263+12] FFE80010FC08 [283:283+12] FFE80010FC08 データ10 ``` ### 磁気センサー 磁気センサーは93文字目から2文字分です。\ 磁気センサーは下表の値を出力します。
磁気センサーデータ意味
磁気センサーのデータ意味
00磁石が遠ざかった。
01磁石のN極が近づいた。
02磁石のS極が近づいた。
80磁石が近くにない。(タイマーによる定期送信)
81磁石のN極が近くにある。(タイマーによる定期送信)
82磁石がS極が近くにある。(タイマーによる定期送信)
例えば、磁石が近くにない状態から、磁石(N極)が一定期間センサーの近くにある場合、以下のように磁気センサーの値が変化します。 ``` 80 -- 80 -- 80 -- 01(※) -- 81 -- 81 -- ``` ※ 多くの場合は磁石のN極を検出したときに01になりますが、設置環境によっては、出力値が一定期間安定せず、02や稀に00が出力される場合があります。 また、磁石が近くにあるかだけ知りたい場合は、94文字目だけ確認し、0だったら磁石が近くにない、1または2の時は磁石が近くにあると判定します。 ### センサーのデータの抽出例 1サンプル目の加速度と磁気センサーのデータを取得するPythonの対話モードでの実行例です。\ シリアルメッセージから、1サンプル目の加速度の文字列を取り出し、数値に変換します。その際、そのままだと符号無の数値ですので、符号付の数値に変換します。\ 磁気センサーのデータをシリアル出力から抜き出し、上表に従って磁気センサーが検出している状態に変換し、加速度データと磁気センサーの情報を標準出力しております。 ```python >>> t =':80000000CF7F7382019E3B0180050F003400038135001205040406000000113008020B8611300102042E000000018015044006FFF00010FC1815044106FFF00018FC1815044206FFF00010FC0015044306FFF80000FC1015044406FFF00010FC1815044506FFE00018FBF815044606FFE80000FC0015044706FFE80010FBF815044806FFE80010FC0815044906FFE80010FC080C0E' >>> x = int(t[103:103+4], 16) # 103文字目から4文字(データ1のX軸)取り出し整数値へ変換 >>> x = (-65536 + x) if x >= 32768 else x # 符号付き16ビット整数の対応 >>> y = int(t[107:107+4], 16) # 103文字目から4文字(データ1のX軸)取り出し整数値へ変換 >>> y = (-65536 + y) if y >= 32768 else y # 符号付き16ビット整数の対応 >>> z = int(t[111:111+4], 16) # 103文字目から4文字(データ1のX軸)取り出し整数値へ変換 >>> z = (-65536 + z) if z >= 32768 else z # 符号付き16ビット整数の対応 >>> print("x=%d, y=%d, z=%d" % (x, y, z)) x=-16, y=16, z=-1000 >>> v = int(t[93:93+2], 16) # 63文字目から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] AE LQI [11:11+4] 0098 続き番号 [15:15+8] 810B6492 送信元のシリアルID [23:23+2] 01 送信元の論理デバイスID [25:25+2] 80 センサー種別(80で固定) [27:27+2] 05 PAL基板バージョンとPAL基板ID(TWELITE CUEは05) ``` ### 開閉センサーパルのデータの判別方法 親機・中継機アプリはTWELITE PALからだけではなく、様々なアプリのデータを受信することができるので、出力されたデータがどのアプリのデータか区別する必要があります。\ \ TWELITE CUEの出力メッセージは、改行コード抜きで299文字(改行コードありでは301文字)で、ほかのセンサーパルのデータとは文字数が違うため、文字数で見分けると簡単です。\ ただし、シリアル通信アプリなどのように受信メッセージの文字数が決まっていないものもありますので、文字数だけでは見分けられない場合があります。 より厳密に区別するには、文字数と以下の項目を確認してください。 * 1文字目が8であること * 15文字目が8であること * 25、26文字目が '80' であること * 27、28文字目が '05' であること ## TWELITE CUEモード ### 出力例 ``` :80000000B1001B810B64650180050F003400038135001205040403000000113008020D3411300102052E000000018015044006FC28FFB0001815044106FC28FFB0000815044206FC30FFB0FFF815044306FC30FFC0FFF815044406FC28FFB0000015044506FC38FFA8001015044606FC30FFB0FFF015044706FC30FFB8FFD815044806FC20FFB0000015044906FC40FFA80018A62C ^^^^^^^1^2^^^3^^^^^^^4^5^6^7^8^^^^^^^^^^^^^9^^^^^^^^^^^^^^^a^^^^^^^b^^^c^^^^^^^d^^^e^^^^^^^f^g^^^^^^^h^^^i^^^j^^^k^^^^^^^l^^^m^^^n^^^o ^p^q ```
意味バイト数データ例備考
意味バイト数データ例備考
1中継機シリアルID480000000
2LQI1B1
3続き番号2001B
4送信元シリアルID4810B6465
5送信元LID101
6センサー種別180
7PAL IDとPAL Ver105TWELITE CUE
8センサーデータ数10F15
9センサーデータ0700340003813500パケットプロパティ参照
aセンサーデータ181205040403000000イベント参照
bセンサーデータ2 (ヘッダ)4113008022バイト、拡張ビット有
電圧(電源電圧)
詳しくはこちらを参照してください。
cセンサーデータ220D343350ｍV
dセンサーデータ3 (ヘッダ)4113001022バイト、拡張ビット有
電圧(ADC1)
詳しくはこちらを参照してください。
eセンサーデータ32052E1432mV
fセンサーデータ4 (ヘッダ)400000001

1バイト拡張ビットなし

ホールIC

詳しくはこちらを参照してください。

gセンサーデータ4180変化なし、オープン
(00: 磁石が離れた。
01: N極が近づいた
02: S局が近づいた
80: 変化なし(磁石なし)
81: 変化なし(N極が近くにある)
82: 変化なし(S極が近くにある))
hセンサーデータ5 (ヘッダ)415044006

符号あり2バイト、拡張ビット有

加速度(1サンプル目)

詳しくはこちらを参照してください。

iセンサーデータ5(X軸) 2FC28X = 392mg
jセンサーデータ5(Y軸)2FFB0Y = -800mg
kセンサーデータ5(Z軸)20018Z = 240mg
lセンサーデータ6 (ヘッダ)415044106

符号あり2バイト、拡張ビット有

加速度(2サンプル目)

詳しくはこちらを参照してください。

mセンサーデータ6(X軸)2FC28X = 176mg
nセンサーデータ6(Y軸)2FFB0Y = -1248mg
oセンサーデータ6(Z軸)20008Z = -96mg
中略
pチェックサム11A61～pの1つ前までのCRC8
qチェックサム212C1～pまでのLRC
### パケットプロパティ ``` 00340003810402 ^1^2^3^4^5^6^7 ``` | | 意味 | バイト数 | データ例 | 備考 | | - | -------- | ---- | ---- | -------------------------------------------------------------------------------------------- | | 1 | 各種情報ビット値 | 1 | 00 | 拡張バイトなし、符号なしChar | | 2 | データソース | 1 | 34 | 起床要因 | | 3 | 拡張バイト | 1 | 00 | | | 4 | データ長 | 1 | 03 | | | 5 | パケットID | 1 | 81 |

0～127、MSBはイベントがあるかどうか
0もしくは0x80はADC1と電源電圧、イベント以外はデータがないことを示す

| | 6 | 起床要因センサー | 1 | 04 |

磁気センサー:0x00
温度:0x01
湿度:0x02
照度:0x03
加速度:0x04
DIO:0x31

タイマー:0x35

| | 7 | 起床要因 | 1 | 02 |

送信要因 イベントが発生した:0x00
値が変化した:0x01
値が閾値を超えた:0x02
閾値を下回った:0x03
閾値の範囲に入った:0x04

| ### イベント ``` 1205040410000000 ^1^2^3^4^5^6^7^8 ``` | | 意味 | バイト数 | データ例 | 備考 | | - | -------- | ---- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 1 | 各種情報ビット値 | 1 | 12 | 拡張バイトあり、符号なしLong | | 2 | データソース | 1 | 05 | イベント | | 3 | 拡張バイト | 1 | 04 |

イベントの発生要因

磁気センサー:0x00
温度:0x01
湿度:0x02
照度:0x03
加速度:0x04

MSBが1の場合はデータ2にデータが存在する。

| | 4 | データ長 | 1 | 04 | | | 5 | データ1 | 1 | 10 |

イベント発生要因が磁気センサーの場合

0x00(0):近くに磁石がない
0x01(1):磁石のN極が近くにある
0x02(2):磁石のS極が近くにある

イベント発生要因が加速度の場合

0x01(1)～0x06(6)：さいころ
0x08(8)：シェイク
0x10(16)：ムーブ

| | 6 | データ2 | 3 | 000000 | 未使用 | --- # 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_cue.md?ask= ``` 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.