Bermuda BLE Trilateration
agittins/bermuda · vv0.8.7
Bermuda Bluetooth/BLE Triangulation / Trilateration for HomeAssistant
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
switch | Switch or outlet | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
device_tracker | Presence (as an occupancy sensor) |
What people report
Bermuda tracks BLE devices via ESPHome proxies and local adapters; users report scanner and proxy flakiness. HomeKit Controller devices once triggered a bug now fixed.
- Works1
- Partly works2
- Requested1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| HomeKit Controller devices (3-element identifiers) | Works | ValueError on device registry update; fixed in v0.8.8Saved copyConfiguration - Home Assistant Core: 2026.6.4 - Home Assistant OS: 18.0 - Supervisor: 2026.06.2 - Bermuda: 0.8.5 - HomeKit Controller is installed and has active devices. ## Describe the bug Bermuda's `device_registry_updated` callback assumes every device identifier contains exactly two elements: [code] HomeKit Controller devices can have three-element identifiers. When one of these device registry entries is updated, Bermuda raises `ValueError: too many values to unpack (expected 2, got 3)` and aborts the callback. This occurred once on June 22, 2026 immediately after Home Assistant startup … Excerpt saved from GitHub on 2026-10-23. | Issue #757 · 2026-06 | |
| ESP32 Bluetooth proxy (ESPHome) | Partly works Local | Stopped sending adverts after minutes until reflashed via USBSaved copy… its no problem that the answer tooks a little bit longer, i`m happy about getting an answer :) If i take a look to the data sheet of my ESP i have an ESP32 (not S3 or C3). My ESP32s are the following ones: diymore ESP32 Mini Development Board ESP32 NodeMCU WiFi Bluetooth ESP32 CH9102F Chip Typ C The first time commissioning and flashing was via USB and the esp ready-made Project. After that i did an firmwareupdate via OTA to all of the ESPs. Your named content of the section i couldn`T find in my yamls. My have the following Content. Proxy 1 ``` substitutions: name: … Excerpt saved from GitHub on 2026-10-23. | Issue #403 · 2024-11 | |
| USB Bluetooth dongle | Partly works Local | No devices detected on older HA; v0.8.7 needs HA 2026.7+Saved copyHi, I use a USB Bluetooth dongle connected directly to the mini PC running Home Assistant. The integration doesn't work; no devices or scanners are detected. This dongle works with iBeacon integration, but maybe it doesn't work with Bermuda integration? This is the error in the registry ``` Registratore: homeassistant.config_entries Fonte: config_entries.py:762 Prima occorrenza: 21:44:02 (4 occorrenze) Ultimo accesso: 21:47:01 Error setting up entry Bermuda BLE Trilateration for bermuda Traceback (most recent call last): File "/usr/src/homeassistant/homeassistant/config_entries.py", line 762, … Excerpt saved from GitHub on 2026-10-23. | Issue #787 · 2026-07 | |
| Apple FindMy rolling-address accessories | Requested | Open PR adds metadevices following FindMy rolling Bluetooth addressesSaved copy… on: #816, Original Author: https://github.com/daviddelahoz Added improvements requested by Bermuda repo owner. As per original author: Discover enabled rolling-key devices from the FindMy integration. Create one stable Bermuda metadevice per FindMy accessory while following its confirmed rolling Bluetooth address. Accept only locally detected addresses with a recent, timezone-aware detection timestamp. Link Bermuda entities to the originating FindMy device-registry identifier so area, distance, current MAC, and presence remain on one device. Add focused tests for fresh/stale source handling … Excerpt saved from GitHub on 2026-10-23. | PR #844 · 2026-09 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Calculated
Works out its values from other data rather than talking to a device.
Found automatically over
- Bluetooth
Details
| Installs (analytics) | 10,362 (1.46%) |
|---|---|
| GitHub stars | 2,097 |
| Latest version | v0.8.7 (2026-10-20) |
| Set up in the UI | Yes |
| Maintainers | @agittins |
| License | MIT |
Notable forks
Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.
| Fork | Stars | Last push | Description |
|---|---|---|---|
| jleinenbach/bermuda | ★ 22 | 2026-10-22 | Bermuda Bluetooth/BLE Triangulation / Trilateration for HomeAssistant |
| philbert/ble-trilateration | ★ 5 | 2026-08-06 | Full 3D BLE trilateration and room tracking for multi-story homes | fork of Bermuda |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
Sources
- Documentation: https://github.com/agittins/bermuda
- Source code: https://github.com/agittins/bermuda
- Issues: https://github.com/agittins/bermuda/issues
- HACS: https://hacs.xyz