BLE reference BLE advertising behavior and services
Digi XBee® 3 Zigbee® RF Module
56
BLE advertising behavior and services
When the Bluetooth radio is enabled, periodic BLE advertisements are transmitted. The
advertisement data includes the product name in the Complete Local Name field. When an XBee
device connects to the Bluetooth radio, the BLE services are listed:
n Device Information Service
n XBee API BLEService
Device Information Service
The standard Device Information Service is used. The Manufacturer, Model, and Firmware Revision
characters are provided inside the service.
XBee API BLEService
You can configure the XBee 3 Zigbee RF Module through the BLE interface using API frame requests
and responses. The API frame format through Bluetooth is equivalent to setting AP = 1 and
transmitting the frames over the UART or SPI interface. API frames can be executed over Bluetooth
regardless of the AP setting.
The BLE interface allows these frames:
n BLE Unlock API frame - 0x2C
n BLE Unlock Response frame - 0xAC
n AT Command frame - 0x08
n AT Command - Queue Parameter Value frame - 0x09
This API reference assumes that you are familiar with Bluetooth and GATT services. The specifications
for Bluetooth are an open standard and can be found at the following links:
n Bluetooth Core Specifications: bluetooth.com/specifications/bluetooth-core-specification
n Bluetooth GATT: bluetooth.com/specifications/gatt/generic-attributes-overview
The XBee API BLE Service contains two characteristics: the API Request characteristic and the API
Response characteristic. The UUIDs for the service and its characteristics are listed in the table
below.
Characteristic UUID
APIService UUID 53da53b9-0447-425a-b9ea-9837505eb59a
APIRequest Characteristic UUID
7dddca00-3e05-4651-9254-44074792c590
API Response Characteristic UUID
f9279ee9-2cd0-410c-81cc-adf11e4e5aea
API Request characteristic
UUID: 7dddca00-3e05-4651-9254-44074792c590
Permissions: Writeable
XBee API frames are broken into chunks and transmitted sequentially to the request characteristic
using write operations. Valid frames are then processed and the result is returned through indications
on the response characteristic.