VelocAI logo Bluetooth Explorer Documentation

Bluetooth GATT Characteristic Reference

Current Time (0x2A2B)

org.bluetooth.characteristic.current_time

Current Time is defined in the Bluetooth GATT XML specification with type org.bluetooth.characteristic.current_time and UUID 0x2A2B.

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.

PropertyValue
NameCurrent Time
UUID0x2A2B
Typeorg.bluetooth.characteristic.current_time
XML RootCharacteristic
Source Fileorg.bluetooth.characteristic.current_time.xml
Field Count2

Field Specification

Parsed field definitions from the source XML value structure.

Field Requirement Format Unit Exponent Notes
Exact Time 256MandatoryN/A---
Adjust ReasonMandatory8bit---

Bit Map

Bit-level enumerations extracted from the XML BitField definition.

Field Bit Size Name 0 Means 1 Means
Adjust Reason01BitNo manual time updateManual time update
Adjust Reason11BitNo external reference time updateExternal reference time update
Adjust Reason21BitNo change of time zoneChange of time zone
Adjust Reason31BitNo change of DST (daylight savings time)Change of DST (daylight savings time)

Byte Layout and Decode

Payload length is profile-defined or variable based on field formats.

function decodePayload(dataView, offset = 0) {
  // Parse exact_time_256 (N/A) according to Bluetooth format rules.
  // Parse adjust_reason (8bit) according to Bluetooth format rules.
  return { exact_time_256, adjust_reason };
}

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 Current Time in Bluetooth GATT?

Current Time is defined as a Bluetooth GATT characteristic entry with type org.bluetooth.characteristic.current_time and UUID 0x2A2B.

What UUID identifies Current Time?

The UUID for Current Time is 0x2A2B.

How should I parse Current Time?

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.