STM32WB-HCI

forked from bluetooth_hci

This crate defines a pure Rust implementation of the Bluetooth Host-Controller Interface for the STM32WB family of microcontrollers. It defines commands and events from the specification, and vendor-specific commands and events.

Version

This crate aims to match the latest firmware binaries released by ST. The minor version number of this crate should indicate the appropriate firmware version to use, refer to this table in unclear:

Usage

This crate defines a trait (Controller) that should be implemented for a specific BLE chip. Any implementor can then be used as a host::uart::UartHci to read and write to the chip.

impl stm32wb_hci::Controller for MyController {
    async fn controller_write(&mut self, header: &[u8], payload: &[u8]) -> Result<(), Self::Error> {
        // implementation...
    }
    async fn controller_read_into(&mut self, buffer: &mut [u8]) -> Result<(), Self::Error> {
        // implementation...
    }
}

The entire Bluetooth HCI is implemented in terms of these functions that handle the low-level I/O.