VelocAI logo Bluetooth Explorer Documentation

Bluetooth GATT Descriptor Reference

Time Trigger Setting (0x290E)

org.bluetooth.descriptor.time_trigger_setting

The value of the descriptor has two parts. Part one is a condition field and occupies one octet, and part two is the comparison value (trigger point) that the characteristic value is checked against.

Quick Summary

Payload length is 7 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.

PropertyValue
NameTime Trigger Setting
UUID0x290E
Typeorg.bluetooth.descriptor.time_trigger_setting
XML RootDescriptor
Source Fileorg.bluetooth.descriptor.time_trigger_setting.xml
Field Count4

Field Specification

Parsed field definitions from the source XML value structure.

Field Requirement Format Unit Exponent Notes
ConditionMandatoryuint8---
Value (None)C1uint8--No comparison value required
Value (Time Interval)C2uint24org.bluetooth.unit.time.second0-
Value (Count)C3uint16---

Byte Layout and Decode

Payload length is 7 bytes.

function decodePayload(dataView, offset = 0) {
  const condition = dataView.getUint8(offset + 0);
  const value_none = dataView.getUint8(offset + 1);
  // Parse value_time_interval (uint24) according to Bluetooth format rules.
  const value_count = dataView.getUint16(offset + 2, true);
  return { condition, value_none, value_time_interval, value_count };
}

Use Cases and Integration Notes

Descriptor Validation

Verify descriptor presence and format during integration and interoperability testing.

Client Configuration

Use descriptor semantics to configure notifications, indications, or presentation metadata.

Debug Diagnostics

Capture descriptor values alongside characteristic data for deeper BLE troubleshooting.

Implementation Checklist

  • Read descriptor metadata after characteristic discovery to confirm behavior contracts.
  • Respect descriptor read/write requirements before ATT operations.
  • Document descriptor values in exported BLE session logs for reproducibility.
  • Keep descriptor handling aligned with Bluetooth SIG format definitions.

FAQ

What is Time Trigger Setting in Bluetooth GATT?

Time Trigger Setting is defined as a Bluetooth GATT descriptor entry with type org.bluetooth.descriptor.time_trigger_setting and UUID 0x290E.

What UUID identifies Time Trigger Setting?

The UUID for Time Trigger Setting is 0x290E.

How should I parse Time Trigger Setting?

Payload length is 7 bytes.

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.