パルアプリからの出力（親機・中継機アプリ）

パルアプリからデータを受信した際の出力書式

全般

パルアプリから受信したデータは、センサ種別とその値からなるセンサーデータの羅列によって表現します。

パルアプリに共通する書式の詳細については、共通書式の詳細をご覧ください。

以降では、製品の種別に応じた具体的な例を取り上げます。

開閉センサーパル

以前はここにPythonを使って解釈する方法を記載していましたが、現在は公式ライブラリを配布しています。 MWings for Python をご利用ください。

データ形式

#	データ	内容	備考
	`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`	センサーデータの数	`3`のみ
		センサーデータ1
15	`uint8`	情報ビット	`0x11`のみ
16	`uint8`	データソース	`0x30`のみ
17	`uint8`	拡張バイト	`0x08`のみ
18	`uint8`	データ長	`2`のみ
19	`uint16`	データ	電源電圧（mV）
		センサーデータ2
21	`uint8`	情報ビット	`0x11`のみ
22	`uint8`	データソース	`0x30`のみ
23	`uint8`	拡張バイト	`0x01`のみ
24	`uint8`	データ長	`2`のみ
25	`uint16`	データ	ADC1の電圧（mV）
		センサーデータ3
27	`uint8`	情報ビット	`0x00`のみ
28	`uint8`	データソース	`0x00`のみ
29	`uint8`	拡張バイト	`0x00`のみ
30	`uint8`	データ長	`1`のみ
31	`uint8`	データ	磁気データ
		センサーデータの末端
32	`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	開閉パルV1
`03`	14	`uint8`	センサーデータの数	`3`つ
			センサーデータ1
`11`	15	`uint8`	情報ビット	拡張バイトあり`uint16`
`30`	16	`uint8`	データソース	電圧
`08`	17	`uint8`	拡張バイト	電源
`02`	18	`uint8`	データ長	`2`バイト
`0D0C`	19	`uint16`	データ	`3340`mV
			センサーデータ2
`11`	21	`uint8`	情報ビット	拡張バイトあり`uint16`
`30`	22	`uint8`	データソース	電圧
`01`	23	`uint8`	拡張バイト	ADC1
`02`	24	`uint8`	データ長	`2`バイト
`03E4`	25	`uint16`	データ	`996`mV
			センサーデータ3
`00`	27	`uint8`	情報ビット	拡張バイトなし`uint8`
`00`	28	`uint8`	データソース	磁気
`00`	29	`uint8`	拡張バイト	なし
`01`	30	`uint8`	データ長	`1`バイト
`01`	31	`uint8`	データ	N極が近づいた
			センサーデータの末端
`EC`	32	`uint8`	チェックサム1	`0xEC`
`6E`		`uint8`	チェックサム2	`0x6E`
		`char`	フッタ	`'\r'`
		`char`	フッタ	`'\n'`

データの判別条件

親機・中継機アプリは、さまざまな種類の子機からデータを受信することができます。

出力されたデータがパルアプリ（開閉センサーパル）のものであるかを確認するには、次の箇所を参照してください。

#	データ	項目	条件
0	`uint32`	中継機のシリアルID	MSBが1であること
7	`uint32`	送信元のシリアルID	MSBが1であること
12	`uint8`	センサー種別	`0x80`であること
13	`uint8`	PAL基板バージョンとPAL基板ID	`0x81`であること
-	-	ペイロードのサイズ	33バイトであること

パーサの実装例

環境センサーパル

以前はここにPythonを使って解釈する方法を記載していましたが、現在は公式ライブラリを配布しています。 MWings for Python をご利用ください。

データ形式

#	データ	内容	備考
	`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	`0x82`のみ
14	`uint8`	センサーデータの数	`5`のみ
		センサーデータ1
15	`uint8`	情報ビット	`0x11`のみ
16	`uint8`	データソース	`0x30`のみ
17	`uint8`	拡張バイト	`0x08`のみ
18	`uint8`	データ長	`2`のみ
19	`uint16`	データ	電源電圧（mV）
		センサーデータ2
21	`uint8`	情報ビット	`0x11`のみ
22	`uint8`	データソース	`0x30`のみ
23	`uint8`	拡張バイト	`0x01`のみ
24	`uint8`	データ長	`2`のみ
25	`uint16`	データ	ADC1の電圧（mV）
		センサーデータ3
27	`uint8`	情報ビット	`0x05`のみ
28	`uint8`	データソース	`0x01`のみ
29	`uint8`	拡張バイト	`0x00`のみ
30	`uint8`	データ長	`2`のみ
31	`int16`	データ	温度データ
		センサーデータ4
33	`uint8`	情報ビット	`0x01`のみ
34	`uint8`	データソース	`0x02`のみ
35	`uint8`	拡張バイト	`0x00`のみ
36	`uint8`	データ長	`2`のみ
37	`uint16`	データ	湿度データ
		センサーデータ5
39	`uint8`	情報ビット	`0x02`のみ
40	`uint8`	データソース	`0x03`のみ
41	`uint8`	拡張バイト	`0x00`のみ
42	`uint8`	データ長	`4`のみ
43	`uint32`	データ	照度データ
		センサーデータの末端
47	`uint8`	チェックサム1	直前までのCRC8
	`uint8`	チェックサム2	チェックサム1までのLRC8
	`char`	フッタ	CR (`0x0D`/`'\r'`)
	`char`	フッタ	LF (`0x0A`/`'\n'`)

出力データの例

:8000000084811F810EFF6D04808205113008020AEB11300102035A0501000209E3010200020E3A02030004000001BE6C00

	#	データ	内容	値
`:`		`char`	ヘッダ	`:`
`80000000`	0	`uint32`	中継機のシリアルID	中継なし
`84`	4	`uint8`	LQI	`132`/`255`
`811F`	5	`uint16`	続き番号	`33055`
`810EFF6D`	7	`uint32`	送信元のシリアルID	`0x10EFF6D`
`04`	11	`uint8`	送信元の論理デバイスID	`0x04`
`80`	12	`uint8`	センサー種別
`82`	13	`uint8`	PAL基板バージョンとPAL基板ID	環境パルV1
`05`	14	`uint8`	センサーデータの数	`5`つ
			センサーデータ1
`11`	15	`uint8`	情報ビット	拡張バイトあり`uint16`
`30`	16	`uint8`	データソース	電圧
`08`	17	`uint8`	拡張バイト	電源
`02`	18	`uint8`	データ長	`2`バイト
`0AEB`	19	`uint16`	データ	`2795`mV
			センサーデータ2
`11`	21	`uint8`	情報ビット	拡張バイトあり`uint16`
`30`	22	`uint8`	データソース	電圧
`01`	23	`uint8`	拡張バイト	ADC1
`02`	24	`uint8`	データ長	`2`バイト
`035A`	25	`uint16`	データ	`858`mV
			センサーデータ3
`05`	27	`uint8`	情報ビット	拡張バイトなし`int16`
`01`	28	`uint8`	データソース	温度
`00`	29	`uint8`	拡張バイト	なし
`02`	30	`uint8`	データ長	`2`バイト
`09E3`	31	`int16`	データ	25.31°C
			センサーデータ4
`01`	33	`uint8`	情報ビット	拡張バイトなし`uint16`
`02`	34	`uint8`	データソース	湿度
`00`	35	`uint8`	拡張バイト	なし
`02`	36	`uint8`	データ長	`2`バイト
`0E3A`	37	`uint16`	データ	36.42%
			センサーデータ5
`02`	39	`uint8`	情報ビット	拡張バイトなし`uint32`
`03`	40	`uint8`	データソース	照度
`00`	41	`uint8`	拡張バイト	なし
`04`	42	`uint8`	データ長	`4`バイト
`000001BE`	43	`uint32`	データ	`446`lx
			センサーデータの末端
`6C`	47	`uint8`	チェックサム1	`0x6C`
`00`		`uint8`	チェックサム2	`0x00`
		`char`	フッタ	`'\r'`
		`char`	フッタ	`'\n'`

データの判別条件

親機・中継機アプリは、さまざまな種類の子機からデータを受信することができます。

出力されたデータがパルアプリ（環境センサーパル）のものであるかを確認するには、次の箇所を参照してください。

#	データ	項目	条件
0	`uint32`	中継機のシリアルID	MSBが1であること
7	`uint32`	送信元のシリアルID	MSBが1であること
12	`uint8`	センサー種別	`0x80`であること
13	`uint8`	PAL基板バージョンとPAL基板ID	`0x82`であること
-	-	ペイロードのサイズ	48バイトであること

パーサの実装例

動作センサーパル

以前はここにPythonを使って解釈する方法を記載していましたが、現在は公式ライブラリを配布しています。 MWings for Python をご利用ください。

データ形式

#	データ	内容	備考
	`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	`0x83`のみ
14	`uint8`	センサーデータの数	`18`のみ
		センサーデータ1
15	`uint8`	情報ビット	`0x11`のみ
16	`uint8`	データソース	`0x30`のみ
17	`uint8`	拡張バイト	`0x08`のみ
18	`uint8`	データ長	`2`のみ
19	`uint16`	データ	電源電圧（mV）
		センサーデータ2
21	`uint8`	情報ビット	`0x11`のみ
22	`uint8`	データソース	`0x30`のみ
23	`uint8`	拡張バイト	`0x01`のみ
24	`uint8`	データ長	`2`のみ
25	`uint16`	データ	ADC1の電圧（mV）
		センサーデータ3
27	`uint8`	情報ビット	`0x15`のみ
28	`uint8`	データソース	`0x04`のみ
29	`uint8`	拡張バイト	`0x?0` 周波数とサンプル番号
30	`uint8`	データ長	`6`のみ
31	`int16`	データ	加速度データ
		センサーデータ4
37	`uint8`	情報ビット	`0x15`のみ
38	`uint8`	データソース	`0x04`のみ
39	`uint8`	拡張バイト	`0x?1` 周波数とサンプル番号
40	`uint8`	データ長	`6`のみ
41	`int16`	データ	加速度データ
		センサーデータ5
		＜省略＞
		センサデータ18
177	`uint8`	情報ビット	`0x15`のみ
178	`uint8`	データソース	`0x04`のみ
179	`uint8`	拡張バイト	`0x?F` 周波数とサンプル番号
180	`uint8`	データ長	`6`のみ
181	`int16`	データ	加速度データ
		センサーデータの末端
187	`uint8`	チェックサム1	直前までのCRC8
	`uint8`	チェックサム2	チェックサム1までのLRC8
	`char`	フッタ	CR (`0x0D`/`'\r'`)
	`char`	フッタ	LF (`0x0A`/`'\n'`)

出力データの例

:80000000BA002382011CEF01808312113008020D0211300102055C1504400600100010045015044106000800100430150442060000001004381504430600080018043015044406000000180458150445060000002004381504460600080018042815044706FFE80010042015044806FFF00010043815044906FFE80018043015044A06FFF80018044015044B06FFF80018041815044C0600000010042015044D0600000028045015044E0600000008043815044F0600000018043828A5

	#	データ	内容	値
`:`		`char`	ヘッダ	`:`
`80000000`	0	`uint32`	中継機のシリアルID	中継なし
`BA`	4	`uint8`	LQI	`186`/`255`
`0023`	5	`uint16`	続き番号	`35`
`82011CEF`	7	`uint32`	送信元のシリアルID	`0x2011CEF`
`01`	11	`uint8`	送信元の論理デバイスID	`0x01`
`80`	12	`uint8`	センサー種別
`83`	13	`uint8`	PAL基板バージョンとPAL基板ID	動作パルV1
`12`	14	`uint8`	センサーデータの数	`18`個
			センサーデータ1
`11`	15	`uint8`	情報ビット	拡張バイトあり`uint16`
`30`	16	`uint8`	データソース	電圧
`08`	17	`uint8`	拡張バイト	電源
`02`	18	`uint8`	データ長	`2`バイト
`0D02`	19	`uint16`	データ	`3330`mV
			センサーデータ2
`11`	21	`uint8`	情報ビット	拡張バイトあり`uint16`
`30`	22	`uint8`	データソース	電圧
`01`	23	`uint8`	拡張バイト	ADC1
`02`	24	`uint8`	データ長	`2`バイト
`055C`	25	`uint16`	データ	`1372`mV
			センサーデータ3
`15`	27	`uint8`	情報ビット	拡張バイトあり`int16`
`04`	28	`uint8`	データソース	加速度
`40`	29	`uint8`	拡張バイト	100Hz, 0番サンプル
`06`	30	`uint8`	データ長	`6`バイト
`001000100450`	31	`int16`	データ	X`16`mG/Y`16`mG/Z`1104`mG
			センサーデータ4
`15`	37	`uint8`	情報ビット	拡張バイトあり`int16`
`04`	38	`uint8`	データソース	加速度
`41`	39	`uint8`	拡張バイト	100Hz, 1番サンプル
`06`	40	`uint8`	データ長	`6`バイト
`000800100430`	41	`uint16`	データ	X`8`mG/Y`16`mG/Z`1072`mG
			センサーデータ5
			＜省略＞
			センサデータ15
`15`	177	`uint8`	情報ビット	拡張バイトあり`int16`
`04`	178	`uint8`	データソース	加速度
`4F`	179	`uint8`	拡張バイト	100Hz, 15番サンプル
`06`	180	`uint8`	データ長	`6`バイト
`000000180438`	181	`uint32`	データ	X`0`mG/Y`24`mG/Z`1080`mG
			センサーデータの末端
`28`	187	`uint8`	チェックサム1	`0x28`
`A5`		`uint8`	チェックサム2	`0xA5`
		`char`	フッタ	`'\r'`
		`char`	フッタ	`'\n'`

データの判別条件

親機・中継機アプリは、さまざまな種類の子機からデータを受信することができます。

出力されたデータがパルアプリ（動作センサーパル）のものであるかを確認するには、次の箇所を参照してください。

#	データ	項目	条件
0	`uint32`	中継機のシリアルID	MSBが1であること
7	`uint32`	送信元のシリアルID	MSBが1であること
12	`uint8`	センサー種別	`0x80`であること
13	`uint8`	PAL基板バージョンとPAL基板ID	`0x83`であること
-	-	ペイロードのサイズ	188バイトであること

パーサの実装例

通知パル

データ形式

#	データ	内容	備考
	`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	`0x84`のみ
14	`uint8`	センサーデータの数	`3`のみ
		センサーデータ1
15	`uint8`	情報ビット	`0x11`のみ
16	`uint8`	データソース	`0x30`のみ
17	`uint8`	拡張バイト	`0x08`のみ
18	`uint8`	データ長	`2`のみ
19	`uint16`	データ	電源電圧（mV）
		センサーデータ2
21	`uint8`	情報ビット	`0x11`のみ
22	`uint8`	データソース	`0x30`のみ
23	`uint8`	拡張バイト	`0x01`のみ
24	`uint8`	データ長	`2`のみ
25	`uint16`	データ	ADC1の電圧（mV）
		センサーデータ3
27	`uint8`	情報ビット	`0x12`のみ
28	`uint8`	データソース	`0x05`のみ
29	`uint8`	拡張バイト	`0x04`のみ
30	`uint8`	データ長	`4`のみ
31	`uint8`	データ	加速度イベントデータ
32	`[uint8]`		未使用
		センサーデータの末端
35	`uint8`	チェックサム1	直前までのCRC8
	`uint8`	チェックサム2	チェックサム1までのLRC8
	`char`	フッタ	CR (`0x0D`/`'\r'`)
	`char`	フッタ	LF (`0x0A`/`'\n'`)

出力データの例

:80000000C9BBC082014C3501808403 113008020D0C 1130010203F9 1205040410000000 97C6

	#	データ	内容	値
`:`		`char`	ヘッダ	`:`
`80000000`	0	`uint32`	中継機のシリアルID	中継なし
`C9`	4	`uint8`	LQI	`201`/`255`
`BBC0`	5	`uint16`	続き番号	`48064`
`82014C35`	7	`uint32`	送信元のシリアルID	`0x2014C35`
`01`	11	`uint8`	送信元の論理デバイスID	`0x01`
`80`	12	`uint8`	センサー種別
`84`	13	`uint8`	PAL基板バージョンとPAL基板ID	通知パルV1
`03`	14	`uint8`	センサーデータの数	`3`つ
			センサーデータ1
`11`	15	`uint8`	情報ビット	拡張バイトあり`uint16`
`30`	16	`uint8`	データソース	電圧
`08`	17	`uint8`	拡張バイト	電源
`02`	18	`uint8`	データ長	`2`バイト
`0D0C`	19	`uint16`	データ	`3340`mV
			センサーデータ2
`11`	21	`uint8`	情報ビット	拡張バイトあり`uint16`
`30`	22	`uint8`	データソース	電圧
`01`	23	`uint8`	拡張バイト	ADC1
`02`	24	`uint8`	データ長	`2`バイト
`03F9`	25	`uint16`	データ	`1017`mV
			センサーデータ3
`12`	27	`uint8`	情報ビット	拡張バイトあり`uint32`
`05`	28	`uint8`	データソース	イベント
`04`	29	`uint8`	拡張バイト	加速度イベント
`04`	30	`uint8`	データ長	`4`バイト
`10`	31	`uint8`	データ	ムーブ
`000000`	32	`[uint8]`
			センサーデータの末端
`97`	35	`uint8`	チェックサム1	`0x97`
`C6`		`uint8`	チェックサム2	`0xC6`
		`char`	フッタ	`'\r'`
		`char`	フッタ	`'\n'`

データの判別条件

親機・中継機アプリは、さまざまな種類の子機からデータを受信することができます。

出力されたデータがパルアプリ（通知パル）のものであるかを確認するには、次の箇所を参照してください。

#	データ	項目	条件
0	`uint32`	中継機のシリアルID	MSBが1であること
7	`uint32`	送信元のシリアルID	MSBが1であること
12	`uint8`	センサー種別	`0x80`であること
13	`uint8`	PAL基板バージョンとPAL基板ID	`0x84`であること
-	-	ペイロードのサイズ	36バイトであること