Secondary Service (0x2801)

Quick Summary

Payload length ranges from 2 to 16 bytes depending on UUID width or variable fields. 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.

Field Specification

Parsed field definitions from the source XML value structure.

Byte Layout and Decode

Payload length ranges from 2 to 16 bytes depending on UUID width or variable fields.

function decodePayload(dataView, offset = 0) {
  const uuidRaw = new Uint8Array(dataView.buffer, dataView.byteOffset + offset + 0);
  const uuid = uuidRaw.length === 2
    ? `0x${uuidRaw[0].toString(16).padStart(2, "0")}${uuidRaw[1].toString(16).padStart(2, "0")}`
    : Array.from(uuidRaw).map((b) => b.toString(16).padStart(2, "0")).join("");
  // UUID width can be 2 bytes (16-bit) or 16 bytes (128-bit).
  return { uuid };
}

Use Cases and Integration Notes

Implementation Checklist

• Parse attribute fields strictly in declared order and format.
• Treat handles and value references as separate entities where required.
• Guard for variable-width UUID formats in mixed 16-bit and 128-bit profiles.
• Log parsed attribute metadata for post-run debugging and audits.

FAQ

Related Links

Last updated: 2026-03-04