bluetooth-bridge
Pulzar open source
bluetooth-bridge
A Bluetooth host stack that runs directly on HCI, with no BlueZ, and a Bluetooth LE to MQTT bridge. Sensors in Home Assistant, GATT and pairing over MQTT, in one static binary.
No BlueZ
The HCI user channel, H4 over UART or TCP. The same behavior on every board, whatever its kernel.
Sensors without pairing
BTHome (encrypted too), Ruuvi, KKM, iBeacon and Eddystone decoded into readings.
Home Assistant
Every sensor with readings appears through MQTT discovery.
GATT and pairing over MQTT
Connect, read, write, subscribe, pair and bond; serve your own GATT services.
Bluetooth Mesh
The bridge provisions, configures and switches mesh nodes, over advertising or a GATT proxy.
Tested without hardware
Every role and pairing method runs against Bumble's virtual controllers in CI.
Install
Section titled “Install”VERSION=0.2.0ARCH=$(uname -m) # x86_64 or aarch64BASE=https://github.com/pulzar-net/bluetooth-bridge/releases/download/v$VERSIONcurl -fsSLO "$BASE/bluetooth-bridge-$ARCH-linux-musl"curl -fsSLO "$BASE/SHA256SUMS"sha256sum --check --ignore-missing SHA256SUMSsudo install -m 0755 "bluetooth-bridge-$ARCH-linux-musl" /usr/local/bin/bluetooth-bridgebluetooth-bridge --versionsha256sum --check must print OK for the file you downloaded before you install it.
Then follow getting started, or install it as a service.
Status
Section titled “Status”bluetooth-bridge is 0.x: every role, pairing method and GATT operation is tested in CI against virtual controllers, but no release has been tested on real hardware yet.
| Feature | State |
|---|---|
| HCI user channel, H4 over UART and TCP | Done0.1.0 |
| Scanning, advertising, beacons and sensors, Home Assistant discovery | Done0.1.0 |
| Connections, L2CAP, GATT client and server, pairing and bonds, privacy | Done0.1.0 |
| Bluetooth Mesh: provisioner in the bridge, GATT proxy in the library | Done0.2.0 |
| Bluetooth Mesh: PB-GATT, IV update, relay, friendship, more models | In progress |
| Testing on real controllers | In progress |
| Classic BR/EDR, then direction finding | Planned |