TrouBLE is a Bluetooth Low Energy (BLE) Host implementation written in Rust, with a future goal of qualification. The initial implementation was based on bleps but has been adopted to work with types and traits from bt-hci.
A BLE Host is one side of the Host Controller Interface (HCI). The BLE specification defines the software of a BLE implementation in terms of a controller (lower layer) and a host (upper layer).
These communicate via a standardized protocol, that may run over different transports such as as UART, USB or a custom in-memory IPC implementation.
The advantage of this split is that the Host can generally be reused for different controller implementations.
TrouBLE can use any controller that implements the traits from bt-hci. At present, that includes:
- nRF Softdevice Controller. Use
nrf-softdevicefor the time being if you want a production ready BLE Rust stack for nRF. - Zephyr UART HCI.
- Raspberry Pi Pico W - This is still WIP and largely untested.
The implementation has the following functionality working:
- Peripheral role - advertise as a peripheral and accept connections.
- Central role - scan for devices and establish connections.
- Basic GATT server supporting write, read, notifications
- L2CAP CoC (Connection oriented Channels) with credit management (for both central and peripheral)
See the issues for a list of TODOs.
See examples for example applications. Currently there are two examples:
nrf-sdcfor the nRF52 based using thenrf-sdccrate.serial-hciwhich runs on std using a controller attached via a serial port (Such as this Zephyr sample).
Trouble is licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
