HCI Packet Helpers

Helpers for framing HCI command packets and parsing command responses in net_buf_simple buffers and packet bytes, independent of the Bluetooth Host and of the HCI driver interface, together with a lockstep helper for HCI drivers that exchange HCI commands with the controller over their own transport, for example for vendor-specific controller initialization.

Both helpers are part of every build with CONFIG_BT enabled. The lockstep helper’s header lives with the HCI driver API, under include/zephyr/drivers/bluetooth/.

These are not general application APIs: the intended users are HCI drivers and Bluetooth stack internals. Applications that need to send HCI commands alongside a running Host use the higher-level bt_hci_cmd_alloc(), bt_hci_cmd_send() and bt_hci_cmd_send_sync() APIs instead, which cooperate with the Host’s command flow control.

API Reference

Bluetooth HCI packet helpers
Bluetooth HCI lockstep command helper
Bluetooth H:4 UART driver vendor extension interface