Bluetooth GATT Characteristic Reference
Unread Alert Status (0x2A45)
This characteristic consists of ?Category ID? and ?uint8? which shows the number of unread alerts/messages.
Quick Summary
Payload length is profile-defined or variable based on field formats. This page is generated from official GATT XML and presented as implementation-ready guidance.
At a Glance
Key reference details for BLE implementation, interoperability testing, and AI-assisted troubleshooting.
| Property | Value |
|---|---|
| Name | Unread Alert Status |
| UUID | 0x2A45 |
| Type | org.bluetooth.characteristic.unread_alert_status |
| XML Root | Characteristic |
| Source File | org.bluetooth.characteristic.unread_alert_status.xml |
| Field Count | 2 |
Field Specification
Parsed field definitions from the source XML value structure.
| Field | Requirement | Format | Unit | Exponent | Notes |
|---|---|---|---|---|---|
| Category ID | Mandatory | N/A | - | - | The value shows the category for unread alert count |
| Unread count | Mandatory | uint8 | - | - | How many unread alerts exist on the server. |
Byte Layout and Decode
Payload length is profile-defined or variable based on field formats.
function decodePayload(dataView, offset = 0) {
// Parse category_id (N/A) according to Bluetooth format rules.
const unread_count = dataView.getUint8(offset + 0);
return { category_id, unread_count };
}Use Cases and Integration Notes
BLE Telemetry
Map characteristic values into dashboards and alerts for device observability.
Firmware Regression
Compare decoded fields across builds to detect protocol or scaling changes.
App Integration
Build stable parsing paths that convert raw payloads into typed app models.
Implementation Checklist
- Validate payload length and mandatory fields before decode.
- Decode with Bluetooth-specified signedness, unit, and exponent handling.
- Convert units at presentation boundaries to avoid drift in business logic.
- Persist raw packets and decoded values for reproducible troubleshooting.
FAQ
What is Unread Alert Status in Bluetooth GATT?
Unread Alert Status is defined as a Bluetooth GATT characteristic entry with type org.bluetooth.characteristic.unread_alert_status and UUID 0x2A45.
What UUID identifies Unread Alert Status?
The UUID for Unread Alert Status is 0x2A45.
How should I parse Unread Alert Status?
Payload length is profile-defined or variable based on field formats.
Where does this definition come from?
This page is generated from the Bluetooth SIG mirror XML in the oesmith/gatt-xml repository.
How does this page support BLE implementation?
The page combines structured tables, practical Q&A, and JSON-LD metadata to help teams validate integrations and troubleshoot consistently.