Bluetooth GATT Characteristic Reference

Report Map (0x2A4B)

org.bluetooth.characteristic.report_map

The Report Map characteristic is used to define formatting information for Input Report, Output Report, and Feature Report data transferred between a HID Device and HID Host, information on how this data can be used, and other information regarding physical aspects of the device (i.e. that the device functions as a keyboard, for example, or has multiple functions such as a keyboard and volume controls).

Quick Summary

Payload length is 1 bytes. 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	Report Map
UUID	0x2A4B
Type	org.bluetooth.characteristic.report_map
XML Root	Characteristic
Source File	org.bluetooth.characteristic.report_map.xml
Field Count	1

Field Specification

Parsed field definitions from the source XML value structure.

Field	Requirement	Format	Unit	Exponent	Notes
Report Map Value	Mandatory	uint8	-	-	-

Byte Layout and Decode

Payload length is 1 bytes.

function decodePayload(dataView, offset = 0) {
  const report_map_value = dataView.getUint8(offset + 0);
  return { report_map_value };
}

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 Report Map in Bluetooth GATT?

Report Map is defined as a Bluetooth GATT characteristic entry with type org.bluetooth.characteristic.report_map and UUID 0x2A4B.

What UUID identifies Report Map?

The UUID for Report Map is 0x2A4B.

How should I parse Report Map?