/

キューアプリ

キューアプリからデータを受信する

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

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

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

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

        :80000000CF7F7382019E3B0180050F003400038135001205040406000000113008020B8611300102042E000000018015044006FFF00010FC1815044106FFF00018FC1815044206FFF00010FC0015044306FFF80000FC1015044406FFF00010FC1815044506FFE00018FBF815044606FFE80000FC0015044706FFE80010FBF815044806FFE80010FC0815044906FFE80010FC080C0E[CR][LF]
    

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

そのため、各センサーの値の場所とその抽出例をご説明します。
その際、: を 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 データ1 FFF0(X軸)/0010(Y軸)/FC18(Z軸)
[123:123+12] FFF00018FC18 データ2 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サンプル目の加速度の文字列を取り出し、数値に変換します。その際、そのままだと符号無の数値ですので、符号付の数値に変換します。
磁気センサーのデータをシリアル出力から抜き出し、上表に従って磁気センサーが検出している状態に変換し、加速度データと磁気センサーの情報を標準出力しております。

        
>>> 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 (ヘッダ)411300802

2バイト、拡張ビット有
電圧(電源電圧)
詳しくはこちらを参照してください。

cセンサーデータ220D343350mV
dセンサーデータ3 (ヘッダ)411300102

2バイト、拡張ビット有
電圧(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各種情報ビット値100拡張バイトなし、符号なしChar
2データソース134起床要因
3拡張バイト100
4データ長103
5パケットID181

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

6起床要因センサー104

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

タイマー:0x35

7起床要因102

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

イベント

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

イベントの発生要因

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

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

4データ長104
5データ1110

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

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

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

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

6データ23000000未使用