Skip to content

lassefactory/divera-hacs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DIVERA 24/7 – Home Assistant Integration

Buy me a Beer

Eine inoffizielle Home Assistant Integration für DIVERA 24/7, die Einsätze in Echtzeit über eine WebSocket-Verbindung empfängt.


Funktionsweise

Die Integration verbindet sich dauerhaft per WebSocket mit den DIVERA-Servern (wss://ws.divera247.com). Sobald DIVERA einen neuen Alarm meldet, wird einmalig die REST-API abgefragt und der Sensor in Home Assistant aktualisiert – ohne unnötiges Polling.


Voraussetzungen

  • Home Assistant OS, Supervised oder Core
  • DIVERA 24/7 Account mit API-Zugang
  • HACS installiert (für die empfohlene Installation)

Installation über HACS (empfohlen)

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

  1. HACS in Home Assistant öffnen
  2. Oben rechts auf die drei Punkte klicken → Benutzerdefinierte Repositories
  3. Folgendes eintragen:
    • Repository: https://github.com/lassefactory/divera-hacs
    • Kategorie: Integration
  4. Hinzufügen klicken
  5. In HACS nach DIVERA 24/7 suchen und Herunterladen klicken
  6. Home Assistant neu starten

Manuelle Installation

  1. Den Ordner custom_components/divera/ aus diesem Repository herunterladen
  2. In das Home Assistant Konfigurationsverzeichnis kopieren:
    config/custom_components/divera/
    
  3. Home Assistant neu starten

Die fertige Verzeichnisstruktur sollte so aussehen:

config/
└── custom_components/
    └── divera/
        ├── __init__.py
        ├── config_flow.py
        ├── const.py
        ├── coordinator.py
        ├── manifest.json
        ├── sensor.py
        ├── strings.json
        └── translations/
            ├── de.json
            └── en.json

Einrichtung

  1. In Home Assistant: Einstellungen → Geräte & Dienste → Integration hinzufügen
  2. Nach DIVERA suchen und auswählen
  3. API-Schlüssel eingeben
    • Den Accesskey aus DIVERA eintragen
    • DIVERA → Einstellungen → DEBUG → Accesskey kopieren
  4. Einheit auswählen aus der Liste der verfügbaren Einheiten
  5. Fertig – der Sensor erscheint automatisch

Sensor

Nach der Einrichtung wird ein Sensor erstellt:

sensor.divera_<einheitname>

State Stichwort des aktiven Alarms oder Kein aktiver Einsatz

Attribute

Attribut Beschreibung
stichwort Alarmstichwort
beschreibung Freitext / Meldungstext
adresse Einsatzadresse
einsatz_id Interne DIVERA Alarm-ID
prioritaet Sonderrechte (true/false)
alarmiert_am Alarmierungszeitpunkt (ISO 8601)
geschlossen true wenn Einsatz abgeschlossen
fahrzeuge Alarmierte Fahrzeuge
latitude / longitude GPS-Koordinaten (werden automatisch auf der Karte angezeigt)
+ weitere Alle weiteren Felder aus der DIVERA API

Blueprint – Alarm-Automation

Im Ordner blueprints/ liegt ein fertiges Blueprint, mit dem du ganz einfach Automationen erstellen kannst.

Blueprint installieren

Blueprint importieren

Oder manuell: Datei blueprints/divera_alarm.yaml kopieren nach:

config/blueprints/automation/divera/divera_alarm.yaml

In HA: Einstellungen → Automationen → Blueprints – das Blueprint erscheint automatisch

Blueprint verwenden

Das Blueprint bietet folgende Einstellungen:

Einstellung Beschreibung
DIVERA Sensor Auswahl des DIVERA-Sensors
Stichwörter filtern Kommagetrennte Stichwörter die NICHT auslösen sollen (z. B. THL, Übung)
Aktionen Frei definierbar – Benachrichtigung, Licht, TTS, etc.

Beispiel-Automation

automation:
  - alias: "DIVERA Alarm – Benachrichtigung"
    use_blueprint:
      path: divera/divera_alarm.yaml
      input:
        sensor_entity: sensor.divera_meine_einheit
        filter_keywords: "THL, Übung, Feuer Klein"
        actions:
          - service: notify.mobile_app_mein_handy
            data:
              title: "Neuer Einsatz!"
              message: >
                {{ state_attr('sensor.divera_meine_einheit', 'stichwort') }}
                – {{ state_attr('sensor.divera_meine_einheit', 'adresse') }}

Debugging

Debug-Logging in configuration.yaml aktivieren:

logger:
  default: warning
  logs:
    custom_components.divera: debug

Logs einsehen unter: Einstellungen → System → Protokolle


Fehlerbehebung

Problem Lösung
Integration erscheint nicht HA vollständig neu starten, nicht nur neu laden
Kein aktiver Einsatz trotz Alarm Debug-Logging aktivieren und Logs prüfen
Ungültiger API-Schlüssel Neuen Accesskey in DIVERA unter Einstellungen → DEBUG generieren
Automation löst nicht aus Prüfen ob Stichwort-Filter das Stichwort ausschließt

Lizenz

Dieses Projekt steht unter der Creative Commons Attribution-NonCommercial 4.0 (CC BY-NC 4.0) Lizenz. Nutzung und Weitergabe erlaubt, jedoch keine kommerzielle Nutzung ohne ausdrückliche Genehmigung.

Dieses Projekt ist nicht offiziell mit DIVERA GmbH verbunden.

About

Divera Alarmierung einfach in Homeassistant empfangen und weiterverarbeiten

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

No contributors

Languages