# Posture Angle detection

.

Using a posture estimation algorithm, the posture angle (estimated value) is calculated based on the output from the cube's motion sensor (6-axis detection system). Because this posture angle is not a raw value from the motion sensor but a value calculated in the cube with the acceleration and angular velocity, it always contains a certain amount of error or drift.

This feature is **disabled** by default. It becomes operational only once enabled in Configuration - Posture angle detection settings.

Posture angle detection can be obtained using the following characteristics. These characteristics are the same for Motion Detection and Magnetic Sensor.

Property | Value |
---|---|

Characteristic UUID | 10B20106-5B3B-4571-9508-CF3EFCD7BBAE |

Properties | Write, Read, Notify |

Descriptor | Sensor Information |

## Write operations

### Requesting posture angle detection

Posture angle information can be requested by writing the following data. Once the cube receives a request, it makes a notification on the posture angle once.

Data location | Type | Content | Example |
---|---|---|---|

0 | UInt8 | Information type | `0x83` (Request for posture angle detection) |

1 | UInt8 | Notification type | `0x01` (Notifications in Euler angles) |

The types of notifications are as follows

Type of notification content | Definition |
---|---|

`0x01` | Notifications in Euler angles |

`0x02` | Notifications in quaternions |

## Read operations / Notifications

When the posture angle of the cube changes, this characteristic notifies the BLE central of this information. The notified information can also be obtained through read operations.

This characteristic is the same for Motion detection and Magnetic sensor. Since this information is also obtained, please also see Motion detection - Read operations / Notifications and Magnetic sensor - Read operations / Notifications when using this characteristic.

### Obtaining posture angle information (notifications in Euler angles)

The following data can be obtained when the type of notification content is set to Euler angle notifications.

Data location | Type | Content | Example |
---|---|---|---|

0 | UInt8 | Information type | `0x03` (Posture angle detection) |

1 | UInt8 | Notification type | `0x01` (Notifications in Euler angles) |

2 | Int16 | Roll (X axis) | `0x00B4` (180°) |

4 | Int16 | Pitch (Y axis) | `0x0000` (0°) |

6 | Int16 | Yaw (Z axis) | `0xFF4E` (-178°) |

#### Angles

The angle range is -179°(0xFF4D) to 180°(0x00B4) for roll and yaw, and -90°(0xFFA6) to 90°(0x005A) for pitch.

The rotation order is yaw (Z axis), pitch (Y axis), roll (X axis). The roll angle and pitch angle are 0° when the cube is placed horizontally on a surface with the wheel side on the bottom. The yaw angle is 0° when the cube is facing the direction it faced when it was turned on.

#### Errors

Because rotation around the Z axis (yaw angle in Euler angles) cannot be corrected using gravitational acceleration, errors will accumulate. The following is a concrete example of this effect.

- The yaw angle shifts by about 1° every few seconds even though the cube is not moving.
- The yaw angle shifts by several degrees when the cube rotates by one rotation with the Z axis as the central axis.

### Obtaining posture angle information (notifications in quaternions)

When the notification content type is set to notifications in quaternions, the following data can be obtained.

Data location | Type | Content | Example |
---|---|---|---|

0 | UInt8 | Information type | `0x03` (Posture angle detection) |

1 | UInt8 | Notification type | `0x02` (Notifications in quaternions) |

2 | Int16 | w | `0x0000` (0) |

4 | Int16 | x | `0x2710` (10,000) |

6 | Int16 | y | `0x0000` (0) |

8 | Int16 | z | `0x0000` (0) |

#### Value range

The value range is -10,000 to 10,000. In general, the quaternion range is -1 to 1. However, because notification data is expressed with the same precision as a 4-digit fixed point number, it is multiplied by 10,000 and expressed as an integer without a fractional component.