パル・キュー・アリアアプリからの出力の詳細（親機・中継機アプリ）

パル・キュー・アリアアプリに共通する出力書式の詳細

パル・キュー・アリアアプリの子機から受信したデータは、共通の書式に沿って出力されます。ここには、その詳細を記しています。それぞれの具体的な出力例は、各アプリのページをご覧ください。

全体

データ形式

#	データ	内容	備考
	`char`	ヘッダ	`:`のみ
0	`uint32`	中継機のシリアルID	中継なしの場合`80000000`
4	`uint8`	LQI	`0`-`255`
5	`uint16`	続き番号
7	`uint32`	送信元のシリアルID	`0x8???????`
11	`uint8`	送信元の論理デバイスID
12	`uint8`	センサー種別	`0x80`のみ
13	`uint8`	PAL基板バージョンとPAL基板ID	`0x81`など
14	`uint8`	センサーデータの数
15	`[uint8]`	センサーデータの羅列	長さ\(N\)のバイト列
15+\(N\)	`uint8`	チェックサム1	直前までのCRC8
	`uint8`	チェックサム2	チェックサム1までのLRC8
	`char`	フッタ	CR (`0x0D`/`'\r'`)
	`char`	フッタ	LF (`0x0A`/`'\n'`)

出力データの例

:80000000A8001C82012B1E01808103113008020D0C1130010203E40000000101EC6E

	#	データ	内容	値
`:`		`char`	ヘッダ	`:`
`80000000`	0	`uint32`	中継機のシリアルID	中継なし
`A8`	4	`uint8`	LQI	`168/255`
`001C`	5	`uint16`	続き番号	`28`
`82012B1E`	7	`uint32`	送信元のシリアルID	`0x2012B1E`
`01`	11	`uint8`	送信元の論理デバイスID	`0x01`
`80`	12	`uint8`	センサー種別	-
`81`	13	`uint8`	PAL基板バージョンとPAL基板ID	`0x81`
`03`	14	`uint8`	センサーデータの数	`3`つ
`1130...0101`	15	`[uint8]`	センサーデータの羅列	長さ17のバイト列
`EC`	15+17	`uint8`	チェックサム1	`0xEC`
`6E`		`uint8`	チェックサム2	`0x6E`
		`char`	フッタ	`'\r'`
		`char`	フッタ	`'\n'`

センサーデータ

データ形式

#	データ	内容	備考
0	`uint8`	情報ビット	データの型や拡張バイトの有無
1	`uint8`	データソース	センサー値の種類
2	`uint8`	拡張バイト	センサー値の付加情報
3	`uint8`	データ長	センサー値の長さ
4	`[uint8]`	データ	センサー値

出力データの例

113008020D0C

	#	データ	内容	値
`11`	0	`uint8`	情報ビット	拡張バイトあり、`uint16`
`30`	1	`uint8`	データソース	電圧
`08`	2	`uint8`	拡張バイト	電源電圧
`02`	3	`uint8`	データ長	`2`バイト
`0D0C`	4	`[uint8]`	データ	`3340`mV

情報ビット

センサー値のデータ型や拡張バイトの有無、読み込みエラーの有無を示します。

bit	7	6	5	4	3	2	1	0
機能	ERR	-	-	EXT	-	TYP:2	TYP:1	TYP:0

各機能は次の内容を示します。

機能	説明	値	内容
ERR	読み込みエラーの有無	`0`	正常
		`1`	エラーあり
EXT	拡張バイトの有無	`0`	拡張バイトなし
		`1`	拡張バイトあり
TYP	データ型	`000`	`uint8`
		`001`	`uint16`
		`010`	`uint32`
		`011`	N/A
		`100`	`int8`
		`101`	`int16`
		`110`	`int32`
		`111`	`[uint8]`

データソース

センサー値の種類を示します。

値	内容
`0x00`	磁気
`0x01`	温度
`0x02`	湿度
`0x03`	照度
`0x04`	加速度
`0x05`	イベント
`0x30`	電圧
`0x34`	パケットプロパティ

拡張バイト

連続データのインデックスなど、センサー値の付加情報を示します。

データソースが磁気／温度／湿度／照度／パケットプロパティの場合

なし

データソースが加速度の場合

加速度サンプルデータの属性を示します。

bit	7	6	5	4	3	2	1	0
機能	SFQ:2	SFQ:1	SFQ:0	SNM:4	SNM:3	SNM:2	SNM:1	SNM:0

各機能は次の内容を示します。

機能	説明	値	内容
SFQ	サンプリング周波数	`000`（`0x00\|SNM`）	25Hz
		`001`（`0x20\|SNM`）	50Hz
		`010`（`0x40\|SNM`）	100Hz
		`011`（`0x60\|SNM`）	190Hz
		`100`以上	未定義
SNM	サンプル番号	`0`-`31`	古い順

データソースがイベントの場合

イベントの発生要因を示します。

値	内容
`0x00`	磁気
`0x01`	温度
`0x02`	湿度
`0x03`	照度
`0x04`	加速度
`0x31`	デジタル入力
`0x35`	タイマ

データソースが電圧の場合

対象を示します。

値	内容
`0x01`	ADC1
`0x02`	ADC2
`0x03`	ADC3
`0x04`	ADC4
`0x08`	電源

データ長

続くデータのバイト数を示します。

データ

センサー値を表します。

データソースが磁気の場合

データ型はuint8です。

値	内容
`0x00`	磁石なし
`0x01`	N極が近づいた
`0x02`	S極が近づいた
`0x80`	磁石なし（定期送信）
`0x81`	N極が近くにある（定期送信）
`0x82`	S極が近くにある（定期送信）

データソースが温度の場合

データ型はint16です。

100倍されたセ氏の温度を表します。

データソースが湿度の場合

データ型はuint16です。

100倍された相対湿度を表します。

データソースが照度の場合

データ型はuint32です。

ルクスの値を表します。

データソースが加速度の場合

int16のデータが3つ続きます。

X,Y,Z軸の値（mG）の合計は6バイトです。

byte	0	1	2	3	4	5
内容	X:15-8	X:7-0	Y:15-8	Y:7-0	Z:15-8	Z:7-0

データソースがイベントの場合

uint8のデータが4つ続きます。

先頭のデータがイベントの内容を表し、残りは未使用です。

byte	0	1	2	3
内容	使用	未使用	未使用	未使用

拡張バイトが磁気の場合

先頭の値	内容
`0x00`	磁石なし
`0x01`	N極が近くにある
`0x02`	S極が近くにある

拡張バイトが加速度の場合

先頭の値	内容
`0x01`	サイコロ：1
`0x02`	サイコロ：2
`0x03`	サイコロ：3
`0x04`	サイコロ：4
`0x05`	サイコロ：5
`0x06`	サイコロ：6
`0x08`	シェイク
`0x10`	ムーブ

拡張バイトがタイマの場合

先頭の値	内容
`0x01`	タイマによる起床

データソースが電圧の場合

データ型はuint16です。

mV単位の電圧を表します。

データソースがパケットプロパティの場合

uint8のデータが3つ続きます。

byte	0	1	2
データ	パケットID	起床要因の根源	起床要因の条件

各データは次の内容を表します。

データ	値	内容
パケットID	`0`	イベントなし、ADC1と電源の電圧のみ
	`1`-`127`	イベントなし、その他のデータあり
	`128`	イベントあり、ADC1と電源の電圧のみ
	`129`-`255`	イベントあり、その他のデータあり
起床要因の根源	`0x00`	磁気
	`0x01`	温度
	`0x02`	湿度
	`0x03`	照度
	`0x04`	加速度
	`0x31`	デジタル入力
	`0x35`	タイマ
起床要因の条件	`0x00`	イベントが発生した
	`0x01`	値が変化した
	`0x02`	値がしきい値を上回った
	`0x03`	値がしきい値を下回った
	`0x04`	値が範囲を満たした