Skip to content
Home Assistant TestFlight
Energy

Bermuda BLE Trilateration

agittins/bermuda · vv0.8.7

HACSCalculated

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.

EntityShows up asNote
switchSwitch or outlet
binary_sensorSensor (motion, contact, leak, smoke…)
sensorSensor (temperature, humidity, air quality…)
device_trackerPresence (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
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
HomeKit Controller devices (3-element identifiers)WorksValueError on device registry update; fixed in v0.8.8
Saved copy
Configuration - 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 LocalStopped sending adverts after minutes until reflashed via USB
Saved 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 donglePartly works LocalNo devices detected on older HA; v0.8.7 needs HA 2026.7+
Saved copy
Hi, 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 accessoriesRequestedOpen PR adds metadevices following FindMy rolling Bluetooth addresses
Saved 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 stars2,097
Latest versionv0.8.7 (2026-10-20)
Set up in the UIYes
Maintainers@agittins
LicenseMIT

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.

ForkStarsLast pushDescription
jleinenbach/bermuda★ 222026-10-22Bermuda Bluetooth/BLE Triangulation / Trilateration for HomeAssistant
philbert/ble-trilateration★ 52026-08-06Full 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.