Bluetooth GATT Characteristic Reference

New Alert (0x2A46)

org.bluetooth.characteristic.new_alert

This characteristic consists of ?Category ID?, ?uint8?, and ?UTF-8 string? fields. The size of this characteristic is dynamic because of the variable length text (?UTF-8?) field. The minimum length of ?UTF-8 string? is 0 octets and maximum length of ?UTF-8 string? is 18 octets.

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	New Alert
UUID	0x2A46
Type	org.bluetooth.characteristic.new_alert
XML Root	Characteristic
Source File	org.bluetooth.characteristic.new_alert.xml
Field Count	3

Field Specification

Parsed field definitions from the source XML value structure.

Field	Requirement	Format	Unit	Exponent	Notes
Category ID	Mandatory	N/A	-	-	This field shows the category of the new alert.
Number of New Alert	Mandatory	uint8	-	-	This field provides the number of new alerts in the server.
Text String Information	Optional	utf8s	-	-	The field provides brief text information for the last alert.

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 number_of_new_alert = dataView.getUint8(offset + 0);
  // Parse text_string_information (utf8s) according to Bluetooth format rules.
  return { category_id, number_of_new_alert, text_string_information };
}

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 New Alert in Bluetooth GATT?

New Alert is defined as a Bluetooth GATT characteristic entry with type org.bluetooth.characteristic.new_alert and UUID 0x2A46.

What UUID identifies New Alert?

The UUID for New Alert is 0x2A46.

How should I parse New Alert?