Bermuda BLE Trilateration für Home Assistant (Marketplace-Integration)

Installationen: 10.399 teilen Analysedaten
GitHub-Sterne: 2.108
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: v0.8.7, 20. Oktober 2026
Kategorie: Anwesenheit und Standort
Art: Marketplace-Integration
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: bermuda
Quelle: github.com/agittins/bermuda
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Screenshots Aus der README von agittins/bermuda.

The integration, in Settings, Devices & Services

Bermuda integration configuration option flow

Überblick

Bermuda BLE Trilateration verfolgt Bluetooth-Geräte in Home Assistant pro Raum und nutzt dafür Signalmesswerte von Bluetooth-Proxys. Die Integration funktioniert mit ESPHome-Bluetooth-Proxys und Shelly-Plus-Geräten oder neueren, und ein USB-Bluetooth-Adapter am Host kann die einfache Verfolgung von zu Hause oder nicht zu Hause übernehmen. Für jedes ausgewählte Gerät erstellt sie Entfernungs- und Bereichssensoren sowie Geräte-Tracker-Entitäten, die mit Personen verknüpft werden können, um den Status zu Hause oder unterwegs zu erfassen. Sie unterstützt iBeacon-Geräte, auch solche mit zufälligen MAC-Adressen, und Geräte, die über die Komponente Private BLE Device eingerichtet wurden. Die Einstellungen umfassen Referenzleistung, Dämpfung, maximalen Verfolgungsradius, Glättung, maximale Geschwindigkeit und Signalversätze pro Scanner, mit Kalibrierungsschritten in den Optionen. Eine Aktion zum Ausgeben der Geräte liefert die internen Daten mit den Messwerten jedes Scanners, und die Integration läuft lokal und wird in der Benutzeroberfläche eingerichtet.

Zusammenfassung der README und des Codes von agittins/bermuda, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Schalter
Sensoren
Anwesenheit

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Bermuda BLE Trilateration

Benutzername
Passwort

Nach der Einrichtung

Maximaler Radius in Metern für die einfache BereichserkennungBei der einfachen Bereichsfunktion wird ein Gerät dem Bereich seines nächsten Empfängers zugeordnet, wenn es innerhalb dieses Radius liegt. Bei einem kleinen Wert wechseln Geräte zwischen den Empfängern auf unbekannt, bei einem großen Wert erscheinen Geräte immer im Bereich ihres nächsten Empfängers.
Max Velocity in Metern pro Sekunde: Messwerte ignorieren, die eine schnellere Entfernung als dieses Limit nahelegen. 3 m/s (10 km/h) ist ein guter Wert.Wenn ein Messwert bedeutet, dass sich ein Gerät schneller als dieser Wert entfernt, wird der Messwert ignoriert. Menschen gehen normalerweise mit 1,4 m/s, mit einer Schere in der Hand bewegen sie sich mit 3 m/s.
Devtracker Timeout in Sekunden, nach dem ein Gerät als Not Home gilt.Wie schnell device_tracker-Entitäten auf not_home gesetzt werden, nachdem keine Advertisements mehr empfangen werden. 30 bis 300 Sekunden sind wahrscheinlich gut.
Update Interval: How oft (in Sekunden) die Sensorwerte aktualisiert werden.Kürzere Entfernungen lösen weiterhin sofort aus, größere Entfernungen werden dadurch in der Häufigkeit begrenzt, damit deine Datenbank weniger wächst.
Glättungs-Samples: Wie viele Samples zur Glättung der Entfernungswerte verwendet werden.Über wie viele Samples die Entfernung gemittelt wird. Größere Zahlen führen zu einem langsameren Anstieg der Entfernung. Kürzere Entfernungen sind nicht betroffen. 10 oder 20 scheint gut zu sein.
Attenuation: Environment-Dämpfungsfaktor für die Entfernungsberechnung und Kalibrierung.Nachdem du ref_power bei 1 Meter eingestellt hast, passe die Dämpfung an, damit andere Entfernungen einigermaßen richtig angezeigt werden.
Reference Power: Standard-RSSI in 1 Meter Entfernung für die Entfernungskalibrierung.Lege deinen am häufigsten genutzten Beacon 1 Meter (3,28') von deinem am häufigsten genutzten Proxy / Scanner entfernt hin. Passe ref_power an, bis der Entfernungssensor eine niedrigste (nicht durchschnittliche) Entfernung von 1 Meter anzeigt.
Konfigurierte Geräte: Wähle aus, welche Bluetooth-Geräte oder Beacons mit Sensoren verfolgt werden.
Gerät
Scanner
Speichern und schließenWenn du mit der Kalibrierung zufrieden bist, setze dieses Häkchen und klicke auf Submit. Deine Änderungen werden gespeichert und du kannst mit dem nächsten Kalibrierschritt fortfahren. Lass das Häkchen entfernt, während du die Einstellungen anpasst und testest.
DämpfungNachdem du die obigen Einstellungen für Messwerte bei 1 m Entfernung angepasst hast, bewege das Gerät weiter weg (zum Beispiel 5 Meter) und passe die Dämpfung an, bis die berechneten Entfernungen mit dem tatsächlichen Abstand zwischen Scanner und Gerät übereinstimmen. Klicke auf Absenden, um die neuen Entfernungsschätzungen zu sehen.
ReferenzleistungUm diese Einstellung zu kalibrieren, platziere das Gerät 1 Meter vom Scanner entfernt und passe den Wert an, bis die obigen Zahlen diese Entfernung von 1 m widerspiegeln. Beachte, dass die Werte erst nach einem Klick auf Absenden neu berechnet werden und eine negativere Zahl zu einer kleineren Entfernung führt.
Gerät
Speichern und schließen
RSSI-Versätze pro ScannerLass den Wert auf null, um den globalen Standard zu übernehmen, oder gib eine Zahl ungleich null ein, um den von diesem Scanner gemeldeten RSSI zu versetzen. Passe ihn an, bis die geschätzte Entfernung oben mit dem tatsächlichen Abstand zwischen diesem Scanner und dem ausgewählten sendenden Gerät übereinstimmt. Negative Werte erhöhen die Entfernung, positive Werte verringern sie.

Texte aus dem Code von agittins/bermuda. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

SensorenEntfernung, Bereich

Aktionen

Geräte ausgebenGibt die interne Datenstruktur zurück, optional begrenzt auf die angegebenen Adressen. Enthält den RSSI und weitere Informationen von jedem Scanner.Felder: Adressen, Konfigurierte Geräte, Schwärzen

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Einige Bluetooth Proxies haben keinen Bereich

Aus der README

Area-based device location (ie, device-level room prescence) is working reasonably well.
Creates sensors for Area and Distance for devices you choose
Supports iBeacon devices, including those with randomised MAC addresses (like Android phones running HA Companion App)
Supports IRK (resolvable keys) via the Private BLE Device core component. Once your iOS device (or Android!) is set up in Private BLE Device, it will automatically receive Bermuda sensors as well!
Creates device_tracker entities for chosen devices, which can be linked to "Person"s for Home/Not Home tracking
Configurable settings for rssi reference level, environmental attenuation, max tracking radius
Provides a comprehensive json/yaml dump of devices and their distances from each bluetooth receiver, via the bermuda.dump_devices service.

Aus der README von agittins/bermuda, MIT License. Gekürzt.