Hinweis: DiveraControl befindet sich noch in der Entwicklung. Es können Fehler auftreten, und einige geplante Funktionen fehlen noch. Eine Optimierung hat bislang nicht stattgefunden. Wer trotzdem neugierig ist, kann die Vorabversionen testen!
💡 Fehler oder Funktionswünsche? Bitte erstelle ein Issue. Vielen Dank! 👍
DiveraControl ist eine Integration von Divera 24/7 in HomeAssistant. Sie ermöglicht lokalen Administratoren oder Einheitenbesitzern den umfangreichen Datenaustausch zwischen HomeAssistant und Divera 24/7.
In Feuerwehrgebäuden und Fahrzeugen sammeln sich zahlreiche Daten an, die im Einsatzfall sinnvoll genutzt werden können. Leider gibt es kaum erschwingliche, integrierte Lösungen für die Verwaltung und Steuerung dieser Daten. HomeAssistant bietet hier eine kostengünstige Zentrale zur Steuerung von zum Beispiel:
- Beleuchtung, Türen & Toren
- Monitoren & Sprachausgaben
- Fahrzeugpositionen, Besatzungen & Status
- Gerätepositionen & Akkuständen
Hier kommt DiveraControl ins Spiel: Es stellt die Schnittstelle zur Alarmierungssoftware bereit und ermöglicht so eine nahtlose Integration.
Für wen ist diese Integration gedacht?
- Administratoren und Schnittstellennutzer einer Einheit
- Neugierige Nutzer, die die Möglichkeiten der API erkunden wollen
Hinweis: Die Integration funktioniert auch mit eingeschränkten Rechten, dann allerdings mit reduziertem Funktionsumfang. Nutzer einer Einheit können die bestehende Divera 24/7 Integration for Home Assistant verwenden.
Der Datenschutz ist im BOS-Bereich besonders wichtig. Jeder Einsatz von HomeAssistant und dieser Integration in realen Lagen erfolgt auf eigene Verantwortung. Die Einhaltung der Datenschutzrichtlinien – insbesondere im Hinblick auf Datenweitergabe, -verarbeitung und -sicherheit – liegt vollständig beim Nutzer.
Diese Integration steht in keiner Verbindung zu Divera 24/7 und wird von Divera nicht unterstützt.
- Alarmdaten
- Einheitendetails
- Verfügbarkeiten
- Fahrzeugdaten & individuelle Eigenschaften
- Berechtigungen
- Nachrichtenkanäle
Verschiedene Divera-Endpunkte sind als Services in HomeAssistant umgesetzt und ermöglichen das Übermitteln von Daten an Divera:
- Alarmerstellung, -änderung & -abschluss
- Fahrzeugdaten & individuelle Eigenschaften
- Einsatzrückmeldungen
- Nachrichtenversand
Folgende Funktionen sollen noch integriert werden:
- Hinzufügen von Besatzung zu Fahrzeugen
- Datenabfrage nur bei offenen Alarmen
- Automatisches Erstellen & Löschen von Zonen für Gebäude & Einsatzorte
- Start der Datenabfrage durch Divera-Webhook, um ständiges Polling bei Divera zu reduzieren
- Verfügbarkeit der Einsatzkräft sowie der Rollen
Divera bietet zahlreiche Endpunkte, folgende sind nicht für die Umsetzung geplant:
- Setzen von Nutzerstatus bzw. Rückmeldungen
- Löschen & Archivieren von Alarmen, Mitteilungen & Terminen
- Verwaltung von Terminen (Erstellen, Ändern, Löschen)
- Anhänge hinzufügen
- Leitstellen-Funktionen
- PRO-Version-Features (einheitenübergreifende Alarmierung)
DiveraControl ist (noch) nicht im HAC-Store verfügbar, kann aber bereits manuell hinzugefügt werden:
- HACS installieren
- Installation: Unten rechts auf "Herunterladen" klicken.
- Letzten Release herunterladen
- Dateien in
config/custom_components/diveracontrolextrahieren
Zur Einrichtung benötigt man Benutzername & Passwort oder direkt den API-Schlüssel. Die Anmeldung erfolgt initial immer mit den persönlichen Zugangsdaten. Diese Daten werden nicht gespeichert, es wird damit nur der API-Schlüssel des Nutzers abgefragt.
Falls die Anmeldung mit Benutzername/Passwort fehlschlägt oder es sich um System-, Schnittstellen-, Monitor- oder Fahrzeugbenutzer handelt, fragt die Integration direkt nach dem API-Schlüssel.
Hinweis: Divera bietet verschiedene API-Schlüssel zur Nutzung an. Neben dem persönlichen Schlüssel unter Profil -> Einstellungen -> Debug, gibt es außerdem einen allgemeinen Schnittstellenschlüssel unter Verwaltung -> Schnittstellen. Empfohlen wird jedoch die Einrichtung und Nutzung eines Schnittstellennutzers unter Verwaltung -> Schnittstellen -> System-Benutzer. Nur zu diesem lassen sich sinnvoll Berechtigungen einrichten.
Die Intervalle werden immer je Einheit eingestellt.
- Außerhalb von Einsätzen: längeres Intervall
- Während eines Einsatzes: kürzeres Intervall, das im Falle offener Alarme zur Aktualisierung der Daten genutzt wird
Hinweis: Die Integration fragt die Daten regelmäßig aktiv bei Divera ab. Auch dann, wenn keine neuen Daten vorliegen. Um die Anzahl der Anfragen nicht unnötig in die Höhe zu treiben, dürfen keine Werte niedriger als 30s eingestellt werden.