Skip to main content
Version: 2.4.0

シリアライズ情報

キューブから取得できる読み込み/通知情報をまとめて 1 つの情報として提供します。本機能は何らかの理由でシリアライズされた情報が必要となった場合に使用する機能です。他のすべての読み込み/通知情報が取得できる環境であれば、使用する必要はありません。

note

この機能はデフォルトでは無効になっています。設定 - シリアライズ情報の通知設定で有効化してはじめて利用可能になります。

シリアライズ情報は以下の特性（characteristic）を使うことで取得できます。特性は設定と同じです。

プロパティ値
Characteristic UUID10B201FF-5B3B-4571-9508-CF3EFCD7BBAE
PropertiesWrite, Read, Notify
DescriptorConfiguration

書き込み操作​

シリアライズ情報に使用する書き込み操作はありません。

読み出し操作 / 通知​

この特性は BLE セントラルに情報を通知します。 通知される情報は読み出し操作でも取得できます。

note

特性は設定と共通です。これらの情報も取得されますので、利用の際には設定 - 読み出し操作や設定 - 通知も確認してください。

シリアライズ情報の取得​

以下のデータが取得できます。

データ位置タイプ内容例
0UInt8情報の種類0xf0 シリアライズ情報の取得
119Byteシリアライズ情報省略

情報の種類​

0xf0 は「シリアライズ情報の取得」を表します。

特性が設定と共通なので、以下に記載されている情報も取得できます。この情報の種類の値を調べて、どの情報を取得したか判断してください。

シリアライズ情報​

以下のビット位置およびビットサイズのデータが取得できます。

ビット位置ビットサイズ内容
04 ビットReserved
41 ビット機能ボタンの状態
52 ビットtoio ID 検出状態
71 ビットPosition ID または Standard ID のキューブの角度（下位）
88 ビットPosition ID または Standard ID のキューブの角度（上位）
168 ビットPosition ID のキューブの中心の X 座標値（下位）
246 ビットPosition ID のキューブの中心の X 座標値（上位）
302 ビットPosition ID のキューブの中心の Y 座標値（下位）
328 ビットPosition ID のキューブの中心の Y 座標値（中位）
404 ビットPosition ID のキューブの中心の Y 座標値（上位）
444 ビットStandard ID の値（下位）
488 ビットStandard ID の値（中下位）
568 ビットStandard ID の値（中上位）
648 ビットStandard ID の値（上位）
728 ビットモーター ID 1（左）の速度
808 ビットモーター ID 2（右）の速度
885 ビット目標指定付きモーター制御または複数目標指定付きモーター制御の応答
933 ビットモーション検出情報の姿勢検出
967 ビットバッテリー残量
1031 ビットモーション検出情報の水平検出
1045 ビットモーション検出情報のシェイク検出
1091 ビットモーション検出情報の衝突検出
1101 ビットモーション検出情報のダブルタップ検出
1111 ビットReserved
1128 ビット姿勢角情報（オイラー角）の Roll（ロール/X 軸）の絶対値
1208 ビット姿勢角情報（オイラー角）の Pitch（ピッチ/Y 軸）の絶対値
1288 ビット姿勢角情報（オイラー角）の Yaw（ヨー/Z 軸）の絶対値
1361 ビット姿勢角情報（オイラー角）の Roll（ロール/X 軸）の符号
1371 ビット姿勢角情報（オイラー角）の Pitch（ピッチ/Y 軸）の符号
1381 ビット姿勢角情報（オイラー角）の Yaw（ヨー/Z 軸）の符号
1392 ビットReserved
1413 ビット磁気センサーの磁石の状態
1448 ビット磁気センサーの磁力の強度
機能ボタンの状態​

ボタンで取得できる機能ボタンの状態を表します。

値機能ボタンの状態
0b0押されていない
0b1押されている
toio ID 検出状態​

読み取りセンサーで取得できる現在の toio ID の検出状態を表します。

値toio ID 検出状態
0b01Standard ID の読み取り中
0b10Position ID の読み取り中
0b11読み取り中でない
Position ID または Standard ID のキューブの角度​

読み取りセンサーで取得できるPosition ID のキューブの角度またはStandard ID のキューブの角度を表します。どちらか最後に取得された角度が反映されます。

Position ID のキューブの中心の X 座標値​

読み取りセンサーで取得できるPosition ID のキューブの中心の X 座標値を表します。 値の最大値が0x3fffまでで、それ以上の値の場合は切り捨てられます。

Position ID のキューブの中心の Y 座標値​

読み取りセンサーで取得できるPosition ID のキューブの中心の Y 座標値を表します。 値の最大値が0x3fffまでで、それ以上の値の場合は切り捨てられます。

Standard ID の値​

読み取りセンサーで取得できるStandard ID の値を表します。 値の最大値が0xfffffffまでで、それ以上の値の場合は切り捨てられます。

モーター ID 1（左）の速度​

モーターで取得できるモーター ID 1（左）の速度を表します。 設定 - モーターの速度情報の取得の設定が無効の場合は常に0x00となります。

モーター ID 2（右）の速度​

モーターで取得できるモーター ID 2（右）の速度を表します。 設定 - モーターの速度情報の取得の設定が無効の場合は常に0x00となります。

目標指定付きモーター制御または複数目標指定付きモーター制御の応答​

モーターで取得できる目標指定付きモーター制御の応答内容または複数目標指定付きモーター制御の応答内容を表します。 最後に実行した目標指定付きモーター制御もしくは複数目標指定付きモーター制御の応答結果を反映し、制御の実行中は0x1fの状態になります。

値目標指定付きモーター制御または複数目標指定付きモーター制御の応答
0x1f目標指定付きモーター制御または複数目標指定付きモーター制御を実行中
0x1f以外目標指定付きモーター制御の応答または複数目標指定付きモーター制御の応答と同じ
モーション検出情報の姿勢検出​

モーション検出で取得できる姿勢検出を表します。

バッテリー残量​

バッテリーで取得できるバッテリー残量を表します。

モーション検出情報の水平検出​

モーション検出で取得できる水平検出を表します。

モーション検出情報のシェイク検出​

モーション検出で取得できるシェイク検出を表します。

モーション検出情報の衝突検出​

モーション検出で取得できる衝突検出を表します。

モーション検出情報のダブルタップ検出​

モーション検出で取得できるダブルタップ検出を表します。

姿勢角情報（オイラー角）の Roll（ロール/X 軸）の絶対値​

姿勢角検出で取得できる姿勢角情報（オイラー角）の Roll（ロール/X 軸）の絶対値を表します。符号の情報は姿勢角情報（オイラー角）の Roll（ロール/X 軸）の符号を参照してください。

姿勢角情報（オイラー角）の Pitch（ピッチ/Y 軸）の絶対値​

姿勢角検出で取得できる姿勢角情報（オイラー角）の Pitch（ピッチ/Y 軸）の絶対値を表します。符号の情報は姿勢角情報（オイラー角）の Pitch（ピッチ/Y 軸）の符号を参照してください。

姿勢角情報（オイラー角）の Yaw（ヨー/Z 軸）の絶対値​

姿勢角検出で取得できる姿勢角情報（オイラー角）の Yaw（ヨー/Z 軸）の絶対値を表します。符号の情報は姿勢角情報（オイラー角）の Yaw（ヨー/Z 軸）の符号を参照してください。

姿勢角情報（オイラー角）の Roll（ロール/X 軸）の符号​

姿勢角検出で取得できる姿勢角情報（オイラー角）の Roll（ロール/X 軸）の符号を表します。絶対値の情報は姿勢角情報（オイラー角）の Roll（ロール/X 軸）の絶対値を参照してください。

姿勢角情報（オイラー角）の Pitch（ピッチ/Y 軸）の符号​

姿勢角検出で取得できる姿勢角情報（オイラー角）の Pitch（ピッチ/Y 軸）の符号を表します。絶対値の情報は姿勢角情報（オイラー角）の Pitch（ピッチ/Y 軸）の絶対値を参照してください。

姿勢角情報（オイラー角）の Yaw（ヨー/Z 軸）の符号​

姿勢角検出で取得できる姿勢角情報（オイラー角）の Yaw（ヨー/Z 軸）の符号を表します。絶対値の情報は姿勢角情報（オイラー角）の Yaw（ヨー/Z 軸）の絶対値を参照してください。

磁気センサーの磁石の状態​

磁気センサーで取得できる磁石の状態を表します。

磁気センサーの磁力の強度​

磁気センサーで取得できる磁石の強度を表します。 なおシリアライズ情報では磁石の方向は取得できません。