ペイロードフォーマット
アップリンクパケットの解析
トラッカーのデータプロトコルは、異なる情報に対応するために複数のパケットを提供しており、各パケットのバイト数は異なる場合があります。フレームの構造は下図のとおりです。フレーム内容はビッグエンディアンのバイト順で送信されます。
| データ ID | データ値 |
|---|---|
| 1 バイト | 50 バイト(最大) |
データ ID: 機能番号。
データ値: 位置情報、センサーデータおよびその他の情報。
電源オンパケット (0x27)
電源オンパケットは、デバイスの起動直後に送信されます。現在の設定パラメータとデバイスステータスが含まれます。フレーム ID は 0x27 で、全長は 46 バイトです。
| 0x27 | Byte2 | Byte3~4 | Byte5~6 | Byte7 | Byte8 | Byte9~10 | Byte11~12 |
|---|---|---|---|---|---|---|---|
| ID | バッテリーレベル | ソフトウェアバージョン | ハードウェアバージョン | 動作モード | 測位ストラテジー | ハートビート間隔 | 周期モードアップリンク間隔 |
| Byte13~14 | Byte15 | Byte16 | Byte17 | Byte18 | Byte19~20 | Byte21~22 |
|---|---|---|---|---|---|---|
| イベントモードアップリンク間隔 | 3 軸加速度センサー有効化 | 分解アラーム有効化 | GNSS スキャンタイムアウト | 動作イベント有効化 | 3 軸動作しきい値 | 動作時アップリンク間隔 |
| Byte23 | Byte24~25 | Byte26 | Byte27~28 | Byte29 | Byte30 | Byte31~46 |
|---|---|---|---|---|---|---|
| 静止イベント有効化 | 静止タイムアウト | 衝撃イベント有効化 | 3 軸衝撃しきい値 | iBeacon スキャンタイムアウト (s) | UUID フィルター有効バイト数 | UUID フィルター (16 バイト) |
生ペイロード例
27 56 0100 0101 01 08 02d0 003c 003c 00 01 3c 00 001e 0005 00 0168 00 012c 03 00 00000000000000000000000000000000
| Byte | 値 | 型 | 生データ | 説明 |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 27 | 27 はパケット ID です |
| 2 | バッテリーレベル | uint8 | 56 | 0x56 = 86(DEC)バッテリーレベルは 86% です |
| 3~4 | ソフトウェアバージョン | uint16 | 0100 | 0x0100 = v1.0ソフトウェアバージョンは v1.0 です |
| 5~6 | ハードウェアバージョン | uint16 | 0101 | 0x0101 = v1.1ハードウェアバージョンは v1.1 です |
| 7 | 動作モード | uint8 | 01 | 01 = 周期モード00: 待機モード01: 周期モード02: イベントモード |
| 8 | 測位ストラテジー | uint8 | 00 | 07 = 0x07、デバイスが Bluetooth + Wi-Fi + GNSS の測位ストラテジーを使用することを意味します 00: GNSS のみ01: Wi-Fi のみ02: Wi-Fi + GNSS03: GNSS + Wi-Fi04: Bluetooth のみ05: Bluetooth + Wi-Fi06: Bluetooth + GNSS07: Bluetooth + Wi-Fi + GNSS08: GNSS + Bluetooth |
| 9~10 | ハートビート間隔 | uint16 | 02d0 | 0x02D0 = 720 分 |
| 11~12 | 周期モードアップリンク間隔 | uint16 | 003c | 0x003C = 60 分 |
| 13~14 | イベントモードアップリンク間隔 | uint16 | 003c | 0x003C = 60 分 |
| 15 | 3 軸加速度センサー有効化 | uint8 | 00 | 00: 無効01: 有効 |
| 16 | 分解アラーム有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 17 | GNSS スキャンタイムアウト | uint8 | 3c | 0x3C = 60 秒 |
| 18 | 動作イベント有効化 | uint8 | 00 | 00: 無効01: 有効 |
| 19~20 | 3 軸動作しきい値 | uint16 | 001e | 0x001e = 30 mg |
| 21~22 | 動作時アップリンク間隔 | uint16 | 0005 | 0x05 = 5 分 |
| 23 | 静止イベント有効化 | uint8 | 00 | 0x00: 無効0x01: 有効 |
| 24~25 | 静止タイムアウト | uint16 | 0168 | 0x0168 = 360 分 |
| 26 | 衝撃イベント有効化 | uint8 | 00 | 00: 無効01: 有効 |
| 27~28 | 3 軸衝撃しきい値 | uint16 | 012c | 0x012c = 300 mg |
| 29 | iBeacon スキャンタイムアウト (s) | uint8 | 03 | 0x03 = 3 秒 |
| 30 | UUID フィルター有効バイト数 | uint8 | 00 | UUID フィルター内の有効バイト数 (0–16) |
| 31~46 | UUID フィルター | 16 bytes | 0000000000000000 0000000000000000 | 16 バイトの Bluetooth UUID フィルター。先頭 N バイト(byte30 で定義)が有効です |
周期モードパケット (0x28)
周期モードパラメータパケットには、現在の動作モード設定が含まれます。フレーム ID は 0x28 で、全長は 30 バイトです。
| 0x28 | Byte2 | Byte3 | Byte4~5 | Byte6~7 | Byte8~9 | Byte10 | Byte11 | Byte12 | Byte13 | Byte14 | Byte15~30 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| ID | 動作モード | 測位ストラテジー | ハートビート間隔 | アップリンク間隔 | イベントモードアップリンク間隔 | 3 軸加速度センサー有効化 | 分解アラーム有効化 | GNSS スキャンタイムアウト | iBeacon スキャンタイムアウト | UUID フィルター有効バイト数 | UUID フィルター (16 バイト) |
生ペイロード例
28 01 07 02d0 003c 003c 01 00 3c 0a 10 00000000000000000000000000000000
| Byte | 値 | 型 | 生データ | 説明 |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 28 | 28 はパケット ID です |
| 2 | 動作モード | uint8 | 01 | 01 = 周期モード00: 待機モード01: 周期モード02: イベントモード |
| 3 | 測位ストラテジー | uint8 | 07 | 07 = 0x07、デバイスが Bluetooth + Wi-Fi + GNSS の測位ストラテジーを使用することを意味します 00: GNSS のみ01: Wi-Fi のみ02: Wi-Fi + GNSS03: GNSS + Wi-Fi04: Bluetooth のみ05: Bluetooth + Wi-Fi06: Bluetooth + GNSS07: Bluetooth + Wi-Fi + GNSS08: GNSS + Bluetooth |
| 4~5 | ハートビート間隔 | uint16 | 02d0 | 0x02D0 = 720 分 |
| 6~7 | アップリンク間隔 | uint16 | 003c | 0x003C = 60 分 |
| 8~9 | イベントモードアップリンク間隔 | uint16 | 003c | 0x003C = 60 分 イベントがトリガーされない場合、データは 60 分ごとにアップロードされます。 |
| 10 | 3 軸加速度センサー有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 11 | 分解アラーム有効化 | uint8 | 00 | 00: 無効01: 有効 |
| 12 | GNSS スキャンタイムアウト | uint8 | 3c | 0x3C = 60 秒 |
| 13 | iBeacon スキャンタイムアウト | uint8 | 0a | 0x0A = 10 秒 |
| 14 | UUID フィルター有効バイト数 | uint8 | 10 | UUID フィルター内の有効バイト数 (0–16) |
| 15~30 | UUID フィルター | 16 bytes | 0000000000000000 0000000000000000 | 16 バイトの Bluetooth UUID フィルター。先頭 N バイト(byte14 で定義)が有効です |
イベントモードパケット (0x29)
イベントパラメータパケットには、動作、静止、および衝撃イベントの設定が含まれます。フレーム ID は 0x29 で、全長は 12 バイトです。
| 0x29 | Byte2 | Byte3~4 | Byte5~6 | Byte7 | Byte8~9 | Byte10 | Byte11~12 |
|---|---|---|---|---|---|---|---|
| ID | 動作イベント有効化 | 3 軸動作しきい値 | 動作時アップリンク間隔 | 静止イベント有効化 | 静止タイムアウト | 衝撃イベント有効化 | 3 軸衝撃しきい値 |
生ペイロード例
29 01 0064 001e 01 012c 00 012c
| Byte | 値 | 型 | 生データ | 説明 |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 29 | 29 はパケット ID です |
| 2 | 動作イベント有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 3~4 | 3 軸動作しきい値 | uint16 | 0064 | 0x0064 = 100 mg |
| 5~6 | 動作時アップリンク間隔 | uint16 | 001e | 0x001E = 30 分 |
| 7 | 静止イベント有効化 | uint8 | 01 | 0x00: 無効0x01: 有効 |
| 8~9 | 静止タイムアウト | uint16 | 012c | 0x012C = 300 分 |
| 10 | 衝撃イベント有効化 | uint8 | 00 | 0x00: 無効0x01: 有効 |
| 11~12 | 3 軸衝撃しきい値 | uint16 | 0000 | 0x012c = 300 mg |
ハートビートパケット (0x2A)
ハートビートパケットは、デバイスが現在のステータスを報告するために定期的に送信されます。基本的なデバイス情報とセンサー状態が含まれます。フレーム ID は 0x2A で、全長は 6 バイトです。
| 0x2A | Byte2 | Byte3 | Byte4 | Byte5 | Byte6 |
|---|---|---|---|---|---|
| ID | バッテリーレベル | 動作モード | 測位ストラテジー | 3 軸加速度センサー有効化 | 分解アラーム有効化 |
生ペイロード例
2a 56 01 07 01 00
| Byte | 値 | 型 | 生データ | 説明 |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 2A | 2A はパケット ID です |
| 2 | バッテリーレベル | uint8 | 56 | 0x56 = 86(DEC)バッテリーレベルは 86% です |
| 3 | 動作モード | uint8 | 01 | 01 = 周期モード00: 待機モード01: 周期モード02: イベントモード |
| 4 | 測位ストラテジー | uint8 | 07 | 07 = 0x07、デバイスが Bluetooth + Wi-Fi + GNSS の測位ストラテジーを使用することを意味します 00: GNSS のみ01: Wi-Fi のみ02: Wi-Fi + GNSS03: GNSS + Wi-Fi04: Bluetooth のみ05: Bluetooth + Wi-Fi06: Bluetooth + GNSS07: Bluetooth + Wi-Fi + GNSS08: GNSS + Bluetooth |
| 5 | 3 軸加速度センサー有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 6 | 分解アラーム有効化 | uint8 | 00 | 00: 無効01: 有効 |
GNSS 位置情報データパケット (加速度センサーオン, 0x2B)
GPS 位置情報データパケットには、GNSS 測位データに加え、加速度センサーおよびバッテリー情報が含まれます。フレーム ID は 0x2B で、全長は 23 バイトです。
| 0x2B | Byte2~3 | Byte4 | Byte5~8 | Byte9~10 | Byte11~12 | Byte13~14 | Byte15~18 | Byte19~22 | Byte23 |
|---|---|---|---|---|---|---|---|---|---|
| ID | イベントステータス | モーション ID | UTC タイムスタンプ | 加速度 X | 加速度 Y | 加速度 Z | 経度 | 緯度 | バッテリーレベル |
生ペイロード例
2b 0100 00 694b3dc6 032f fffe 0241 06ca5098 01587ee4 62
| Byte | 値 | 型 | 生データ | 説明 |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 2B | 2B はパケット ID です |
| 2~3 | イベントステータス | uint16 | 0100 | 0x0100 = 分解イベントBit 0: false Bit 1: 動作開始イベント Bit 2: 動作終了イベント Bit 3: 静止イベント Bit 4: 衝撃イベント Bit 5: 温度イベント Bit 6: 光イベント Bit 7: SOS イベント Bit 8: 1 回押下イベント Bit 9: 分解イベント 16 進数への変換: 0x0001: 動作開始イベント0x0002: 動作終了イベント0x0004: 静止イベント0x0008: 衝撃イベント0x0010: 温度イベント0x0020: 光イベント0x0040: SOS イベント0x0080: 1 回押下イベント0x0100: 分解イベント |
| 4 | モーション ID | uint8 | 00 | 0: 特定の動作として記録する必要はありません。1~255: 同一の動作状態下で報告された測位データ(同じ ID は同じ動作を指します) |
| 5~8 | UTC タイムスタンプ | uint32 | 694b3dc6 | 0x694B3DC6 = 1766538694(DEC) 秒UTC 時刻に変換: 2025-12-24 01:11:34 |
| 9~10 | 加速度 X | int16 | 032f | 0x032F = 815 mg |
| 11~12 | 加速度 Y | int16 | fffe | 0xFFFE = -2 mg |
| 13~14 | 加速度 Z | int16 | 0241 | 0x0241 = 577 mg |
| 15~18 | 経度 | uint32 | 06ca5098 | 0x06CA5098 = 113,922,200 → 113.922200° |
| 19~22 | 緯度 | uint32 | 01587ee4 | 0x01587EE4 = 22,576,868 → 22.576868° |
| 23 | バッテリーレベル | uint8 | 62 | 0x62 = 98% |
Wi-Fi 位置情報データパケット(加速度センサーオン, 0x2C)
Wi-Fi 位置情報パケットには、Wi-Fi スキャン結果に加えて加速度センサーおよびバッテリー情報が含まれます。フレーム ID は 0x2C で、全長はスキャンされた Wi-Fi アクセスポイントの数に応じて動的に変化します(23 + (n-1) * 7 バイト、ここで n は MAC-RSSI ペアの数です)。
| 0x2C | Byte2~3 | Byte4 | Byte5~8 | Byte9~10 | Byte11~12 | Byte13~14 | Byte15 | Byte16 | Byte17+(n-1)*7 ~ Byte23+(n-1)*7 |
|---|---|---|---|---|---|---|---|---|---|
| ID | イベントステータス | モーション ID | UTC タイムスタンプ | 加速度センサー X | 加速度センサー Y | 加速度センサー Z | バッテリーレベル | MAC-RSSI カウント (n) | MAC-RSSI ペア (n) |
MAC-RSSI フォーマット
| Byte0~5 | Byte6 |
|---|---|
| MAC アドレス (6 bytes) | RSSI (int8) |
生ペイロード例
2c 0000 00 69685f82 0004 0015 03e5 64 05 107c61841bf8 e4 3447d468f627 e1 a4ba70bc229d d3 9483c46d5dfc d2 4c10d567b467 d0
| Byte | 値 | 型 | 生データ | 説明 |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 2C | 2C はパケット ID です |
| 2~3 | イベントステータス | uint16 | 0000 | 0x0000 = イベント未発生 Bit 0: false Bit 1: 移動開始イベント Bit 2: 移動終了イベント Bit 3: 静止イベント Bit 4: 衝撃イベント Bit 5: 温度イベント Bit 6: 光イベント Bit 7: SOS イベント Bit 8: 1 回押下イベント Bit 9: 分解イベント 16 進数への変換: 0x0001: 移動開始イベント0x0002: 移動終了イベント0x0004: 静止イベント0x0008: 衝撃イベント0x0010: 温度イベント0x0020: 光イベント0x0040: SOS イベント0x0080: 1 回押下イベント0x0100: 分解イベント |
| 4 | モーション ID | uint8 | 00 | 0: 特定のモーションとして記録する必要はありません。1~255: 同一モーション状態下で報告される測位データ(同じ ID は同じモーションを指します) |
| 5~8 | UTC タイムスタンプ | uint32 | 69685f82 | 0x69685F82 = 1768447874(DEC) 秒UTC 時刻に変換: 2026-01-15 03:31:14 |
| 9~10 | 加速度センサー X | int16 | 0004 | 0x0004 = 4 mg |
| 11~12 | 加速度センサー Y | int16 | 0015 | 0x0015 = 21 mg |
| 13~14 | 加速度センサー Z | int16 | 03e5 | 0x03E5 = 997 mg |
| 15 | バッテリーレベル | uint8 | 64 | 0x64 = 100% |
| 16 | MAC-RSSI カウント (n) | uint8 | 05 | 検出された Wi-Fi アクセスポイントの数(n = 5) |
| 17~23 | MAC-RSSI ペア 1 | 7 bytes | 107c61841bf8 e4 | MAC: 10:7C:61:84:1B:F8, RSSI: 0xE4 = -28 (int8) |
| 24~30 | MAC-RSSI ペア 2 | 7 bytes | 3447d468f627 e1 | MAC: 34:47:D4:68:F6:27, RSSI: 0xE1 = -31 (int8) |
| 31~37 | MAC-RSSI ペア 3 | 7 bytes | a4ba70bc229d d3 | MAC: A4:BA:70:BC:22:9D, RSSI: 0xD3 = -45 (int8) |
| 38~44 | MAC-RSSI ペア 4 | 7 bytes | 9483c46d5dfc d2 | MAC: 94:83:C4:6D:5D:FC, RSSI: 0xD2 = -46 (int8) |
| 45~51 | MAC-RSSI ペア 5 | 7 bytes | 4c10d567b467 d0 | MAC: 4C:10:D5:67:B4:67, RSSI: 0xD0 = -48 (int8) |
BLE 位置情報データパケット(加速度センサーオン,0x2D)
BLE 位置情報パケットには、Bluetooth スキャン結果に加えて加速度センサーおよびバッテリー情報が含まれます。フレーム ID は 0x2D で、全長はスキャンされた Bluetooth デバイスの数に応じて動的に変化します(23 + (n-1) * 7 バイト、ここで n は MAC-RSSI ペアの数で、最大 n = 5)。
| 0x2D | Byte2~3 | Byte4 | Byte5~8 | Byte9~10 | Byte11~12 | Byte13~14 | Byte15 | Byte16 | Byte17+(n-1)*7 ~ Byte23+(n-1)*7 |
|---|---|---|---|---|---|---|---|---|---|
| ID | イベントステータス | モーション ID | UTC タイムスタンプ | 加速度センサー X | 加速度センサー Y | 加速度センサー Z | バッテリーレベル | MAC-RSSI カウント (n) | MAC-RSSI ペア (n) |
MAC-RSSI フォーマット
| Byte0~5 | Byte6 |
|---|---|
| MAC アドレス (6 bytes) | RSSI (int8) |
生ペイロード例
2d 0000 00 69686032 fff9 0015 03df 64 05 c30000564b3b ce c20303003f00 ce 588c81a0fbf2 cc c20303003f03 cb c30000564af2 c7
| Byte | 値 | 型 | 生データ | 説明 |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 2D | 2D はパケット ID です |
| 2~3 | イベントステータス | uint16 | 0000 | 0x0000 = イベント未発生 Bit 0: false Bit 1: 移動開始イベント Bit 2: 移動終了イベント Bit 3: 静止イベント Bit 4: 衝撃イベント Bit 5: 温度イベント Bit 6: 光イベント Bit 7: SOS イベント Bit 8: 1 回押下イベント Bit 9: 分解イベント 16 進数への変換: 0x0001: 移動開始イベント0x0002: 移動終了イベント0x0004: 静止イベント0x0008: 衝撃イベント0x0010: 温度イベント0x0020: 光イベント0x0040: SOS イベント0x0080: 1 回押下イベント0x0100: 分解イベント |
| 4 | モーション ID | uint8 | 00 | 0: 特定のモーションとして記録する必要はありません。1~255: 同一モーション状態下で報告される測位データ(同じ ID は同じモーションを指します) |
| 5~8 | UTC タイムスタンプ | uint32 | 69686032 | 0x69686032 = 1768448050(DEC) 秒UTC 時刻に変換: 2026-01-15 03:34:10 |
| 9~10 | 加速度センサー X | int16 | fff9 | 0xFFF9 = -7 mg |
| 11~12 | 加速度センサー Y | int16 | 0015 | 0x0015 = 21 mg |
| 13~14 | 加速度センサー Z | int16 | 03df | 0x03DF = 991 mg |
| 15 | バッテリーレベル | uint8 | 64 | 0x64 = 100% |
| 16 | MAC-RSSI カウント (n) | uint8 | 05 | 検出された Bluetooth デバイスの数(n = 5、最大 5) |
| 17~23 | MAC-RSSI ペア 1 | 7 bytes | c30000564b3b ce | MAC: C3:00:00:56:4B:3B, RSSI: 0xCE = -50 (int8) |
| 24~30 | MAC-RSSI ペア 2 | 7 bytes | c20303003f00 ce | MAC: C2:03:03:00:3F:00, RSSI: 0xCE = -50 (int8) |
| 31~37 | MAC-RSSI ペア 3 | 7 bytes | 588c81a0fbf2 cc | MAC: 58:8C:81:A0:FB:F2, RSSI: 0xCC = -52 (int8) |
| 38~44 | MAC-RSSI ペア 4 | 7 bytes | c20303003f03 cb | MAC: C2:03:03:00:3F:03, RSSI: 0xCB = -53 (int8) |
| 45~51 | MAC-RSSI ペア 5 | 7 bytes | c30000564af2 c7 | MAC: C3:00:00:56:4A:F2, RSSI: 0xC7 = -57 (int8) |
GNSS 位置情報データパケット(加速度センサーオフ, 0x2E)
GNSS 位置情報データパケットには、GPS 測位データに加えてバッテリー情報が含まれます。フレーム ID は 0x2E で、全長は 17 バイトです。
| 0x2E | Byte2~3 | Byte4 | Byte5~8 | Byte9~12 | Byte13~16 | Byte17 |
|---|---|---|---|---|---|---|
| ID | イベントステータス | モーション ID | UTC タイムスタンプ | 経度 | 緯度 | バッテリーレベル |
生ペイロード例
2e 0100 01 64f1a2b3 06ca5098 01587ee4 62
| Byte | 値 | 型 | 生データ | 説明 |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 2E | 2E はパケット ID です |
| 2~3 | イベントステータス | uint16 | 0000 | 0x0000 = イベント未発生 Bit 0: false Bit 1: 移動開始イベント Bit 2: 移動終了イベント Bit 3: 静止イベント Bit 4: 衝撃イベント Bit 5: 温度イベント Bit 6: 光イベント Bit 7: SOS イベント Bit 8: 1 回押下イベント Bit 9: 分解イベント 16 進数への変換: 0x0001: 移動開始イベント0x0002: 移動終了イベント0x0004: 静止イベント0x0008: 衝撃イベント0x0010: 温度イベント0x0020: 光イベント0x0040: SOS イベント0x0080: 1 回押下イベント0x0100: 分解イベント |
| 4 | モーション ID | uint8 | 00 | 0: 特定のモーションとして記録する必要はありません。1~255: 同一モーション状態下で報告される測位データ(同じ ID は同じモーションを指します) |
| 5~8 | UTC タイムスタンプ | uint32 | 64f1a2b3 | 0x64f1a2b3 = 1693557427(DEC) 秒UTC 時刻に変換: 2023-09-01 08:37:07 |
| 9~12 | 経度 | uint32 | 06ca5098 | 0x06CA5098 = 113,922,200 → 113.922200° |
| 13~16 | 緯度 | uint32 | 01587ee4 | 0x01587EE4 = 22,576,868 → 22.576868° |
| 17 | バッテリーレベル | uint8 | 62 | 0x62 = 98% |
Wi-Fi 位置情報データパケット(加速度センサーオフ, 0x2F)
Wi-Fi 位置情報データパケットには、Wi-Fi スキャン結果に加えてバッテリー情報が含まれます。フレーム ID は 0x2F で、全長はスキャンされた Wi-Fi アクセスポイントの数に応じて動的に変化します(17 + (n-1) * 7 バイト、ここで n は MAC-RSSI ペアの数で、最大 n = 5)。
| 0x2F | Byte2~3 | Byte4 | Byte5~8 | Byte9 | Byte10 | Byte11+(n-1)*7 ~ Byte16+(n-1)*7 |
|---|---|---|---|---|---|---|
| ID | イベントステータス | モーション ID | UTC タイムスタンプ | バッテリーレベル | MAC-RSSI カウント (n) | MAC-RSSI ペア (n) |
MAC-RSSI フォーマット
| Byte0~5 | Byte6 |
|---|---|
| MAC アドレス (6 bytes) | RSSI (int8) |
生ペイロード例
2f 0000 00 69685f82 64 05 107c61841bf8 e4 3447d468f627 e1 a4ba70bc229d d3 9483c46d5dfc d2 4c10d567b467 d0
| Byte | 値 | 型 | 生データ | 説明 |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 2F | 2F はパケット ID です |
| 2~3 | イベントステータス | uint16 | 0000 | 0x0000 = イベント未発生 Bit 0: false Bit 1: 移動開始イベント Bit 2: 移動終了イベント Bit 3: 静止イベント Bit 4: 衝撃イベント Bit 5: 温度イベント Bit 6: 光イベント Bit 7: SOS イベント Bit 8: 1 回押下イベント Bit 9: 分解イベント 16 進数への変換: 0x0001: 移動開始イベント0x0002: 移動終了イベント0x0004: 静止イベント0x0008: 衝撃イベント0x0010: 温度イベント0x0020: 光イベント0x0040: SOS イベント0x0080: 1 回押下イベント0x0100: 分解イベント |
| 4 | モーション ID | uint8 | 00 | 0: 特定のモーションとして記録する必要はありません。1~255: 同一モーション状態下で報告される測位データ(同じ ID は同じモーションを指します) |
| 5~8 | UTC タイムスタンプ | uint32 | 69685f82 | 0x69685F82 = 1768447874(DEC) 秒UTC 時刻に変換: 2026-01-15 03:31:14 |
| 9 | バッテリーレベル | uint8 | 64 | 0x64 = 100% |
| 10 | MAC-RSSI カウント (n) | uint8 | 05 | 検出された Wi-Fi アクセスポイントの数(n = 5、最大 5) |
| 11~17 | MAC-RSSI ペア 1 | 7 bytes | 107c61841bf8 e4 | MAC: 10:7C:61:84:1B:F8,RSSI: 0xE4 = -28 (int8) |
| 18~24 | MAC-RSSI ペア 2 | 7 bytes | 3447d468f627 e1 | MAC: 34:47:D4:68:F6:27,RSSI: 0xE1 = -31 (int8) |
| 25~31 | MAC-RSSI ペア 3 | 7 bytes | a4ba70bc229d d3 | MAC: A4:BA:70:BC:22:9D,RSSI: 0xD3 = -45 (int8) |
| 32~38 | MAC-RSSI ペア 4 | 7 bytes | 9483c46d5dfc d2 | MAC: 94:83:C4:6D:5D:FC,RSSI: 0xD2 = -46 (int8) |
| 39~45 | MAC-RSSI ペア 5 | 7 bytes | 4c10d567b467 d0 | MAC: 4C:10:D5:67:B4:67,RSSI: 0xD0 = -48 (int8) |
BLE 位置情報データパケット(加速度センサー Off, 0x30)
BLE 位置情報データパケットには、Bluetooth スキャン結果とバッテリー情報が含まれます。フレーム ID は 0x30 で、全長はスキャンされた Bluetooth デバイス数に応じて動的に変化します(17 + (n-1) * 7 バイト、n は MAC-RSSI ペアの数で、最大 n = 5)。
| 0x30 | Byte2~3 | Byte4 | Byte5~8 | Byte9 | Byte10 | Byte11+(n-1)*7 ~ Byte16+(n-1)*7 |
|---|---|---|---|---|---|---|
| ID | イベントステータス | モーション ID | UTC タイムスタンプ | バッテリーレベル | MAC-RSSI カウント (n) | MAC-RSSI ペア (n) |
MAC-RSSI フォーマット
| Byte0~5 | Byte6 |
|---|---|
| MAC アドレス (6 bytes) | RSSI (int8) |
生ペイロード例
30 0000 00 69686032 64 05 c30000564b3b ce c20303003f00 ce 588c81a0fbf2 cc c20303003f03 cb c30000564af2 c7
| Byte | Value | Type | Raw Data | Description |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 30 | 30 はパケット ID です |
| 2~3 | イベントステータス | uint16 | 0000 | 0x0000 = イベント未発生 Bit 0: false Bit 1: 移動開始イベント Bit 2: 移動終了イベント Bit 3: 静止イベント Bit 4: 衝撃イベント Bit 5: 温度イベント Bit 6: 光イベント Bit 7: SOS イベント Bit 8: 1 回押下イベント Bit 9: 分解イベント 16 進数への変換: 0x0001: 移動開始イベント0x0002: 移動終了イベント0x0004: 静止イベント0x0008: 衝撃イベント0x0010: 温度イベント0x0020: 光イベント0x0040: SOS イベント0x0080: 1 回押下イベント0x0100: 分解イベント |
| 4 | モーション ID | uint8 | 00 | 0: 特定のモーションとして記録する必要はありません。1~255: 同一モーション状態で報告された位置情報データ(同じ ID は同じモーションを示す) |
| 5~8 | UTC タイムスタンプ | uint32 | 69686032 | 0x69686032 = 1768448050(DEC) 秒UTC 時刻に変換: 2026-01-15 03:34:10 |
| 9 | バッテリーレベル | uint8 | 64 | 0x64 = 100% |
| 10 | MAC-RSSI カウント (n) | uint8 | 05 | 検出された Bluetooth デバイス数(n = 5、最大 5) |
| 11~17 | MAC-RSSI ペア 1 | 7 bytes | c30000564b3b ce | MAC: C3:00:00:56:4B:3B,RSSI: 0xCE = -50 (int8) |
| 18~24 | MAC-RSSI ペア 2 | 7 bytes | c20303003f00 ce | MAC: C2:03:03:00:3F:00,RSSI: 0xCE = -50 (int8) |
| 25~31 | MAC-RSSI ペア 3 | 7 bytes | 588c81a0fbf2 cc | MAC: 58:8C:81:A0:FB:F2,RSSI: 0xCC = -52 (int8) |
| 32~38 | MAC-RSSI ペア 4 | 7 bytes | c20303003f03 cb | MAC: C2:03:03:00:3F:03,RSSI: 0xCB = -53 (int8) |
| 39~45 | MAC-RSSI ペア 5 | 7 bytes | c30000564af2 c7 | MAC: C3:00:00:56:4A:F2,RSSI: 0xC7 = -57 (int8) |
加速度センサー付き位置情報ステータスパケット (0x31)
位置情報ステータスパケットには、位置情報ステータスに加えて、加速度センサーデータ、イベントステータス、およびバッテリー情報が含まれます。フレーム ID は 0x31 で、全長は 15 バイトです。
| 0x31 | Byte2 | Byte3~4 | Byte5~8 | Byte9~10 | Byte11~12 | Byte13~14 | Byte15 |
|---|---|---|---|---|---|---|---|
| ID | 位置情報ステータス | イベントステータス | UTC タイムスタンプ | 加速度センサー X | 加速度センサー Y | 加速度センサー Z | バッテリーレベル |
生ペイロード例
31 00 0100 694b3db0 003a 039d fe84 62
| Byte | Value | Type | Raw Data | Description |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 31 | 31 はパケット ID です |
| 2 | 位置情報ステータス | uint8 | 00 | 0x00: 位置特定成功。0x01: GNSS スキャンがタイムアウトしました。0x02: Wi-Fi スキャンがタイムアウトしました。0x03: Wi-Fi + GNSS スキャンがタイムアウトしました。0x04: GNSS + Wi-Fi スキャンがタイムアウトしました。0x05: Bluetooth スキャンがタイムアウトしました。0x06: Bluetooth + Wi-Fi スキャンがタイムアウトしました。0x07: Bluetooth + GNSS スキャンがタイムアウトしました。0x08: Bluetooth + Wi-Fi + GNSS スキャンがタイムアウトしました。0x09: Location Server が GNSS 位置情報の解析に失敗しました。0x0A: Location Server が Wi-Fi 位置情報の解析に失敗しました。0x0B: Location Server が Bluetooth 位置情報の解析に失敗しました。0x0C: 精度が低いため位置情報の解析に失敗しました。0x0D: 時刻同期に失敗しました。0x0E: 古い Almanac が原因で失敗しました。0x0F: GNSS + Bluetooth スキャンがタイムアウトしました。 |
| 3~4 | イベントステータス | uint16 | 0000 | 0x0000 = イベント未発生 Bit 0: false Bit 1: 移動開始イベント Bit 2: 移動終了イベント Bit 3: 静止イベント Bit 4: 衝撃イベント Bit 5: 温度イベント Bit 6: 光イベント Bit 7: SOS イベント Bit 8: 1 回押下イベント Bit 9: 分解イベント 16 進数への変換: 0x0001: 移動開始イベント0x0002: 移動終了イベント0x0004: 静止イベント0x0008: 衝撃イベント0x0010: 温度イベント0x0020: 光イベント0x0040: SOS イベント0x0080: 1 回押下イベント0x0100: 分解イベント |
| 5~8 | UTC タイムスタンプ | uint32 | 694B3DB0 | 0x694B3DB0 = 1766538672(DEC) 秒UTC 時刻に変換: 2025-12-24 01:11:12 |
| 9~10 | 加速度センサー X | int16 | 003a | 0x003A = 58 mg |
| 11~12 | 加速度センサー Y | int16 | 039d | 0x039D = 925 mg |
| 13~14 | 加速度センサー Z | int16 | fe84 | 0xFE84 = -380 mg |
| 15 | バッテリーレベル | uint8 | 62 | 0x62 = 98% |
位置情報ステータスパケット(加速度センサー Off, 0x32)
位置情報ステータスパケットには、位置情報ステータスに加えて、イベントステータスとバッテリー情報が含まれます。フレーム ID は 0x32 で、全長は 9 バイトです。
| 0x32 | Byte2 | Byte3~4 | Byte5~8 | Byte9 |
|---|---|---|---|---|
| ID | 位置情報ステータス | イベントステータス | UTC タイムスタンプ | バッテリーレベル |
生ペイロード例
32 00 0100 694b3db0 62
| Byte | Value | Type | Raw Data | Description |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 32 | 32 はパケット ID です |
| 2 | 位置情報ステータス | uint8 | 00 | 0x00: 位置特定成功。0x01: GNSS スキャンがタイムアウトしました。0x02: Wi-Fi スキャンがタイムアウトしました。0x03: Wi-Fi + GNSS スキャンがタイムアウトしました。0x04: GNSS + Wi-Fi スキャンがタイムアウトしました。0x05: Bluetooth スキャンがタイムアウトしました。0x06: Bluetooth + Wi-Fi スキャンがタイムアウトしました。0x07: Bluetooth + GNSS スキャンがタイムアウトしました。0x08: Bluetooth + Wi-Fi + GNSS スキャンがタイムアウトしました。0x09: Location Server が GNSS 位置情報の解析に失敗しました。0x0A: Location Server が Wi-Fi 位置情報の解析に失敗しました。0x0B: Location Server が Bluetooth 位置情報の解析に失敗しました。0x0C: 精度が低いため位置情報の解析に失敗しました。0x0D: 時刻同期に失敗しました。0x0E: 古い Almanac が原因で失敗しました。0x0F: GNSS + Bluetooth スキャンがタイムアウトしました。 |
| 3~4 | イベントステータス | uint16 | 0100 | 0x0000 = イベント未発生 Bit 0: false Bit 1: 移動開始イベント Bit 2: 移動終了イベント Bit 3: 静止イベント Bit 4: 衝撃イベント Bit 5: 温度イベント Bit 6: 光イベント Bit 7: SOS イベント Bit 8: 1 回押下イベント Bit 9: 分解イベント 16 進数への変換: 0x0001: 移動開始イベント0x0002: 移動終了イベント0x0004: 静止イベント0x0008: 衝撃イベント0x0010: 温度イベント0x0020: 光イベント0x0040: SOS イベント0x0080: 1 回押下イベント0x0100: 分解イベント |
| 5~8 | UTC タイムスタンプ | uint32 | 694B3DB0 | 0x694B3DB0 = 1766538672(DEC) 秒UTC 時刻に変換: 2025-12-24 01:11:12 |
| 9 | バッテリーレベル | uint8 | 62 | 0x62 = 98% |
ダウンリンクパケット, FPort=5
トラッカーは LoRaWAN をサポートしており、いくつかのコマンドをダウンリンクしてパラメータを調整できます。デバイスが休止状態の場合、ダウンリンクコマンドは、デバイスが次回データをアップロードするために起床したときに有効になります。
LoRaWAN Class A の仕様上、ダウンリンクウィンドウはアップリンク後にのみ開くため、コマンドはリアルタイムではありません。例えば、報告間隔が 10 分に設定されている場合、デバイスが次の送信ウィンドウでダウンリンクコマンドを受信するまでに最大 10 分かかる可能性があります。
注意: FPort=5
デバイスステータス要求パケット (0x8F)
| 0x8F |
|---|
| ID |
例:
8F: 最新のデバイスステータスおよび位置情報パケットを要求します。
動作モード & 位置情報戦略の設定 (0x90)
| 0x90 | Byte2 | Byte3 | Byte4~5 | Byte6~7 | Byte8~9 |
|---|---|---|---|---|---|
| ID | 動作モード | 位置情報戦略 | ハートビート間隔 | 周期モードアップリンク間隔 | イベントモードアップリンク間隔 |
| Byte10 | Byte11 | Byte12 | Byte13 | Byte14 | Byte15~30 |
|---|---|---|---|---|---|
| 3 軸加速度センサー有効化 | 分解アラーム有効化 | GNSS スキャンタイムアウト (S) | iBeacon スキャンタイムアウト (S) | UUID フィルタ有効バイト数 | UUID フィルタ |
注意:
ハートビート間隔 / 周期モードアップリンク間隔 / イベントモードアップリンク間隔の単位:分
例:
90 01 01 02d0 0014 0005 01 01 1e 0a 10 00000000000000000000000000000000
| Byte | Value | Type | Raw Data | Description |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 90 | 90 はパケット ID です |
| 2 | 動作モード | uint8 | 01 | 01 = 周期モード00: スタンバイモード01: 周期モード02: イベントモード |
| 3 | 位置情報戦略 | uint8 | 01 | 00: GNSS のみ01: Wi-Fi のみ02: Wi-Fi + GNSS03: GNSS + Wi-Fi04: Bluetooth のみ05: Bluetooth + Wi-Fi06: Bluetooth + GNSS07: Bluetooth + Wi-Fi + GNSS08: GNSS + Bluetooth |
| 4~5 | ハートビート間隔 | uint16 | 02d0 | 0x02D0 = 720 分 |
| 6~7 | 周期モードアップリンク間隔 | uint16 | 0014 | 0x0014 = 20 分 |
| 8~9 | イベントモードアップリンク間隔 | uint16 | 0005 | 0x0005 = 5 分イベントが発生しない場合、データは 5 分ごとにアップロードされます。 |
| 10 | 3 軸加速度センサー有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 11 | 分解アラーム有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 12 | GNSS スキャンタイムアウト | uint8 | 1E | 0x1E = 30 秒 |
| 13 | iBeacon スキャンタイムアウト | uint8 | 0A | 0x0A = 10 秒 |
| 14 | UUID フィルタ有効バイト数 | uint8 | 10 | UUID フィルタ内の有効バイト数 (0–16) |
| 15~30 | UUID フィルタ | 16 bytes | 0000000000000000 0000000000000000 | 16 バイトの Bluetooth UUID フィルタ。先頭の N バイトのみ(byte30 で定義)が有効 |
イベントモードしきい値の設定 (0x91)
| 0x91 | Byte2 | Byte3~4 | Byte5~6 | Byte7 | Byte8~9 |
|---|---|---|---|---|---|
| ID | モーションイベントを有効化 | 3軸モーションしきい値 | モーション時のアップリンク間隔 | 静止イベントを有効化 | 静止タイムアウト |
| Byte10 | Byte11~12 |
|---|---|
| ショックイベントを有効化 | 3軸ショックしきい値 |
例:
91 01 001e 0005 01 01 2c
| Byte | 値 | 型 | 生データ | 説明 |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 91 | 91 はパケット ID です |
| 2 | モーションイベントを有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 3~4 | 3軸モーションしきい値 | uint16 | 001e | 0x001E = 30 mg加速度が 30 mg を超えると、デバイスは動作中であると判断します |
| 5~6 | モーション時のアップリンク間隔 | uint16 | 0005 | 0x0005 = 5 分モーションが検出されると、報告間隔は 5 分になります |
| 7 | 静止イベントを有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 8~9 | 静止タイムアウト | uint16 | 012c | 0x012C = 300 分デバイスが 300 分以上静止したままの場合、静止イベントがトリガーされます |
| 10 | ショックイベントを有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 11~12 | 3軸ショックしきい値 | uint16 | 012c | 0x012C = 300 mg加速度が 300 mg を超えると、ショックイベントがトリガーされます |
デバイスステータスパケットの要求 (0x92)
| 0x92 |
|---|
| ID |
例:
92: GNSS 位置情報の取得を強制します。
動作モード & 測位戦略 & イベントモードしきい値の設定 (0x97)
| 0x97 | Byte2 | Byte3 | Byte4~5 | Byte6~7 | Byte8~9 |
|---|---|---|---|---|---|
| ID | 動作モード | 測位戦略 | ハートビート間隔 | 周期モードアップリンク間隔 | イベントモードアップリンク間隔 |
| Byte10 | Byte11 | Byte12 | Byte13 | Byte14 | Byte15~30 |
|---|---|---|---|---|---|
| 3軸加速度センサを有効化 | 分解アラームを有効化 | GNSS スキャンタイムアウト | iBeacon スキャンタイムアウト | UUID フィルタ有効バイト数 | UUID フィルタ |
モーションイベント設定
| Byte31 | Byte32~33 | Byte34~35 |
|---|---|---|
| モーションイベントを有効化 | 3軸モーションしきい値 | モーション時のアップリンク間隔 |
静止イベント設定
| Byte36 | Byte37~38 |
|---|---|
| 静止イベントを有効化 | 静止タイムアウト |
ショックイベント設定
| Byte39 | Byte40~41 |
|---|---|
| ショックイベントを有効化 | 3軸ショックしきい値 |
例:
97 01 02 003c 001e 000a 01 01 0a 05 10 00000000000000000000000000000000 01 001e 0005 01 012c 01 012c
| Byte | 値 | 型 | 生データ | 説明 |
|---|---|---|---|---|
| 1 | フレーム ID | uint8 | 97 | 97 はパケット ID です |
| 2 | 動作モード | uint8 | 01 | 00: スタンバイモード01: 周期モード02: イベントモード |
| 3 | 測位戦略 | uint8 | 02 | 00: GNSS のみ01: Wi-Fi のみ02: Wi-Fi + GNSS03: GNSS + Wi-Fi04: Bluetooth のみ05: Bluetooth + Wi-Fi06: Bluetooth + GNSS07: Bluetooth + Wi-Fi + GNSS08: GNSS + Bluetooth |
| 4~5 | ハートビート間隔 | uint16 | 003c | 0x003C = 60 秒 |
| 6~7 | 周期モードアップリンク間隔 | uint16 | 001e | 0x001E = 30 秒 |
| 8~9 | イベントモードアップリンク間隔 | uint16 | 000a | 0x000A = 10 分イベントがトリガーされない場合、データは 10 分ごとにアップロードされます。 |
| 10 | 3軸加速度センサを有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 11 | 分解アラームを有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 12 | GNSS スキャンタイムアウト | uint8 | 0a | 0x0A = 10 秒 |
| 13 | iBeacon スキャンタイムアウト | uint8 | 05 | 0x05 = 5 秒 |
| 14 | UUID フィルタ有効バイト数 | uint8 | 10 | 0x10 = 16 バイト |
| 15~30 | UUID フィルタ | byte[16] | 0000000000000000 0000000000000000 | UUID フィルタ値 (16 バイト) |
| 31 | モーションイベントを有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 32~33 | 3軸モーションしきい値 | uint16 | 001e | 0x001E = 30 mg |
| 34~35 | モーション時のアップリンク間隔 | uint16 | 0005 | 0x0005 = 5 分モーションが検出されると、報告間隔は 5 分になります |
| 36 | 静止イベントを有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 37~38 | 静止タイムアウト | uint16 | 012c | 0x012C = 300 分 |
| 39 | ショックイベントを有効化 | uint8 | 01 | 00: 無効01: 有効 |
| 40~41 | 3軸ショックしきい値 | uint16 | 012c | 0x012C = 300 mg |
技術サポート & 製品ディスカッション
弊社製品をお選びいただきありがとうございます。弊社は、製品をできるだけスムーズにご利用いただけるよう、さまざまなサポートを提供しています。お好みやニーズに応じて選択いただける、複数のコミュニケーションチャネルをご用意しています。