パル・キュー・アリアアプリの子機から受信したデータは、共通の書式に沿って出力されます。ここには、その詳細を記しています。それぞれの具体的な出力例は、各アプリのページをご覧ください。
全体
データ形式
| # | データ | 内容 | 備考 |
|---|---|---|---|
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] | データ | 3340mV |
情報ビット
センサー値のデータ型や拡張バイトの有無、読み込みエラーの有無を示します。
| 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 | 値が範囲を満たした |