Beschreibung
Abfrage, ob bei DIVERA 24/7 ein Einsatz ansteht, mit allen Einsatzdaten.
- Gerät
- Gira HomeServer
- Version
- 0.1.0
- Lizenz
- Ein Schlüssel je HomeServer (MAC-Adresse), dauerhaft nutzbar
- Thema
- Sicherheit
Hinweis zur Schnittstelle: Der Baustein nutzt die Schnittstelle von DIVERA 24/7. Ändert der Anbieter sie oder stellt sie ein, kann der Baustein eingeschränkt oder gar nicht mehr funktionieren, bis er angepasst ist. Wir passen ihn nach Möglichkeit an, einen Anspruch darauf gibt es nicht.
Anleitung
Besonderheiten beim HomeServer
- Statt Parametern gibt es Eingänge mit Startwert. Auswahllisten des X1 sind Zahlen, Ja/Nein-Werte sind
0und1. - Der Lizenzschlüssel ist der letzte Text-Eingang. Ein neuer Wert an diesem Eingang wird sofort geprüft.
- Eine Prüfung des Schlüssels im Editor und eine Simulation gibt es nicht, der HomeServer prüft immer.
Divera Alarm
Logikbaustein von SMoLabs. Fragt bei DIVERA 24/7 ab, ob ein Einsatz anliegt (GET /api/last-alarm), und gibt die Einsatzdaten aus. Abgefragt wird, wenn E1 einen Wert ungleich 0 bekommt. DIVERA empfiehlt ein Intervall von mindestens 20 Sekunden, bei zu vielen Abfragen antwortet die API mit HTTP 429.
Welcher API-Key? Einheit (Verwaltung > Schnittstellen): alle Einsätze der Einheit. Persönlich (Einstellungen > Debug): nur Einsätze, bei denen der Benutzer adressiert ist. Systembenutzer (Verwaltung > Benutzer): braucht das Recht „Alarmierungen“.
Fehlerverhalten: Bei Verbindungsproblemen, HTTP 429 oder Serverfehlern bleiben die Ausgänge auf dem letzten Stand, damit ein laufender Einsatz nicht kurz verschwindet. Bei einem ungültigen Key (HTTP 401/403) werden sie zurückgesetzt. Der Grund steht an A28 Debug.
Eingänge
| Nr. | Name | Init | Bedeutung |
|---|---|---|---|
| 1 | E1 Trigger | 0 | Ungleich 0: startet die Abfrage. |
| 2 | E2 API-Key | „“ | API-Key laut Beschreibung. |
| 3 | E3 Art des API-Keys (1 = Einheit, 2 = Persönlich, 3 = Systembenutzer) | 1 | 1 = Einheit, 2 = Persönlich, 3 = Systembenutzer. Davon hängen Filter und Fehlertexte ab. |
| 4 | E4 Filter adressierter Benutzer (UCR-ID, 0 = aus) | 0 | UCR-ID (Zuordnung Benutzer zu Einheit). Der Einsatz zählt nur, wenn diese UCR-ID adressiert ist. 0 = aus. Bei persönlichem Key ohne Wirkung, weil DIVERA dann selbst filtert. |
| 5 | E5 Lizenzschlüssel | „“ | Lizenzschlüssel für diesen HomeServer (von smolabs.de). Ohne gültigen Schlüssel bleibt der Baustein untätig. |
Ausgänge
| Nr. | Name | Init | Bedeutung |
|---|---|---|---|
| 1 | A1 Einsatzalarm | 0 | 1, solange ein offener Einsatz anliegt. Bei einem beendeten Einsatz 0. |
| 2 | A2 Stichwort | „“ | Stichwort des Einsatzes. |
| 3 | A3 Meldung | „“ | Meldungstext. |
| 4 | A4 Datum/Uhrzeit | „“ | Alarmierungszeit, Format TT.MM.JJJJ hh:mm:ss (Ortszeit des HomeServers). |
| 5 | A5 Impuls neuer Einsatz | 0 | 1 Sekunde 1 bei einem neuen Einsatz. Nach einem Neustart nur, wenn der Einsatz jünger als 5 Minuten ist. |
| 6 | A6 Adresse | „“ | Einsatzort. |
| 7 | A7 Sonderrechte | 0 | 1 bei Sonderrechten. |
| 8 | A8 Angaben zum Objekt | „“ | Angaben zum Objekt. |
| 9 | A9 Anrufer | „“ | Anrufer. |
| 10 | A10 Patient | „“ | Patient. |
| 11 | A11 Bemerkung | „“ | Bemerkung. |
| 12 | A12 Anzahl gelesen | 0 | Wie viele Empfänger die Alarmierung gelesen haben. |
| 13 | A13 Einsatznummer | „“ | Einsatznummer (Fremd-ID). |
| 14 | A14 Einsatz-ID | 0 | ID des Einsatzes bei DIVERA, z. B. für die Einsatzrückmeldung mit Divera Status (SMoLabs). |
| 15 | A15 Breitengrad | 0 | Koordinaten des Einsatzortes. |
| 16 | A16 Längengrad | 0 | Koordinaten des Einsatzortes. |
| 17 | A17 Einsatzmittel | „“ | Weitere Felder der Alarmierung. |
| 18 | A18 Fahrtziel | „“ | Weitere Felder der Alarmierung. |
| 19 | A19 Zusatz 1 | „“ | Weitere Felder der Alarmierung. |
| 20 | A20 Zusatz 2 | „“ | Weitere Felder der Alarmierung. |
| 21 | A21 Zusatz 3 | „“ | Weitere Felder der Alarmierung. |
| 22 | A22 Einsatz beendet | 0 | 1, wenn DIVERA den Einsatz als beendet meldet. |
| 23 | A23 Anzahl Empfänger | 0 | Anzahl der Empfänger. |
| 24 | A24 Rückmeldung bis | „“ | Ende des Rückmeldezeitraums. |
| 25 | A25 Selbst adressiert (persönlicher Key) | 0 | Nur mit persönlichem Key: 1, wenn man selbst adressiert ist. |
| 26 | A26 Eigene Rückmeldung Status-ID (persönlicher Key) | 0 | Nur mit persönlichem Key: Status-ID der eigenen Rückmeldung. |
| 27 | A27 Lizenzstatus | „“ | Ergebnis der Lizenzprüfung, z. B. „Lizenz gültig (2026-000123)“. |
| 28 | A28 Debug | „“ | Ergebnis bzw. Fehler der letzten Abfrage. |
Lizenz
Der Lizenzschlüssel wird am letzten Text-Eingang des Bausteins eingetragen. Der Baustein prüft ihn auf dem HomeServer, offline und gebunden an die MAC-Adresse des HomeServers. Der Ausgang „Lizenzstatus“ zeigt das Ergebnis, bei einem Schlüssel für ein anderes Gerät auch die MAC-Adresse dieses HomeServers. Ohne gültigen Schlüssel bleibt der Baustein untätig. Den Schlüssel erhältst du beim Kauf über smolabs.de. Ein Schlüssel für den X1 schaltet keinen HomeServer-Baustein frei und umgekehrt.
Changelog
Version 0.1.0
- Erste Version für den HomeServer auf Basis der X1-Bausteine | SMoLabs.
Rezensionen
Es gibt noch keine Rezensionen.