ONVIF Profil S Library
Inhaltsverzeichnis
- Vorbemerkungen zur Library
- Vorbemerkungen zur Integration von Geräten
- Hinweise zum Symcon-System / Host
- Folgende Module beinhaltet die ONVIF Library
- Changelog
- Spenden
- Lizenz
Vorbemerkungen zur Library
Diese Library wurde nicht dazu entwickelt komplett den Profil S Spezifikationen zu entsprechen oder deren gesamten Funktionsumfang abzubilden.
Vielmehr liegt der Schwerpunkt auf eine einfache und unkomplizierte Integration bestimmter Bestandteile (LiveStream, Steuerung) und Funktionen (Events, Digital Ein-/Ausgänge) in Symcon.
Dadurch ist es auch möglich Geräte in Symcon einzubinden welche ihrerseits die Spezifikationen nicht vollständig oder nicht korrekt umsetzen.
Vorbemerkungen zur Integration von Geräten
Es werden Instanzen zum auffinden (Discovery) und einrichten (Konfigurator) von Geräten in Symcon bereitgestellt.
Diese Instanzen werden nur korrekt funktionieren, wenn die betreffenden Geräte entsprechend Konfiguriert wurden.
So gibt es Geräte bei welchen am Werk z.B. das ONVIF Protokoll deaktiviert ist.
Oder eine entsprechende Zugangsberechtigung erstellt oder erweitert werden muss.
Eine Konfiguration der Geräte über Symcon ist in dieser Library nicht vorgesehen.
Unerlässlich ist eine korrekte Uhrzeit auf den Geräten, da eine Authentifizierung sonst fehlschlägt.
Es wird dringend empfohlen vor der Integration in IPS folgende Parameter in den Geräten fertig zu konfigurieren und ggfls. zu testen:
- Netzwerk-Schnittstelle (IP-Adresse)
- Auffindbarkeit / Discovery über ONVIF aktivieren
- Zugangsdaten (u.U. eigene für ONVIF)
- Die Zugangsdaten sollten bei allen Geräten identisch sein.
- Zeitsynchronisation
- Nach Möglichkeit sollten die Geräte und der Symcon Host die Uhrzeit aus der gleichen Quelle beziehen (NTP-Server).
- PTZ-Vorpositionen / Szenen (sofern vorhanden)
- h26x-Profile bzw. Media-Profile für ONVIF
Hinweise zum Symcon-System / Host
Die Maximale Anzahl der gleichzeitig verwendbaren RTSP-Streams hängt von der Symcon Lizenz ab. Bitte hierzu die Funktionsübersicht der Editionen beachten.
Um Ereignisse der Geräte in Symcon zu verarbeiten wird ein Webhook pro IO-Modul erzeugt.
Hier wird aktuell nur der interne WebServer von Symcon auf Port 3777 unterstützt.
Die IP-Adresse auf welchem Symcon die Daten empfängt wird automatisch ermittelt.
Bei System mit aktiven NAT-Support funktioniert die automatische Erkennung der eigenen IP-Adresse nicht. Hier wird die PublicIP aus den Symcon-Spezialschaltern benutzt.
Auch bei Systemen mit aktiven NAT-Support wird extern nur der Port 3777 unterstützt, und muss somit korrekt weitergeleitet werden.
Damit Geräte über das Discovery-Modul gefunden werden können, müssen bei NAT Systemen Multicast-Pakete korrekt weitergeleitet werden.
Für das Discovery werden Pakete über die Multicast-Adresse 239.255.255.250
auf Port 3702
gesendet und empfangen.
Folgende Module beinhaltet die ONVIF Library
- ONVIF Discovery (Dokumentation) Erkennt ONVIF kompatible Geräte innerhalb des lokalen LAN.
- ONVIF Configurator (Dokumentation) Unterstützt beim Einrichten der verschiedenen Instanzen für ein ONVIF-Gerät.
- ONVIF IO (Dokumentation) Stellt die Verbindung zu einem ONVIF-Gerät her.
- ONVIF Media Stream (Dokumentation) Konfiguriert ein IPS Medien-Objekt (RTSP-Stream) anhand der Geräte-Fähigkeiten.
- ONVIF Image Grabber (Dokumentation) Lädt Snapshots (Standbilder) von dem Gerät und legt es in einem Media-Objekt ab.
- ONVIF Digital Input (Dokumentation) Bildet die Digitalen Eingänge in Symcon ab.
- ONVIF Digital Output (Dokumentation) Bildet Digitale Ausgänge (Relays) in Symcon ab.
- ONVIF Events (Dokumentation) Bildet empfangbare ONVIF-Ereignisse in Symcon ab.
Changelog
Version 1.07:
- Die Ansteuerung der PTZ-Kommandos kann invertiert werden.
- Eventuelle Fehlermeldung wenn die Option
Variablenprofil benutzt Namen der Szenen
aktiviert war.
Version 1.06:
- Eventuell wurden die Topics eines Events falsch ermittelt.
- Statusvariablen für Topics mit Sonderzeichen wurden nicht korrekt angelegt.
Version 1.05:
- Fehlermeldung wenn Geräte keinen Namen für PTZ-Szenen geliefert haben.
- Fehlermeldung im IO wenn Geräte keine Auflösung, kein Encoding oder keine Bitrate gemeldet haben.
Version 1.02:
- ONVIF_StopPTZ und das Anhalten beim loslassen der PTZ-Overlay Steuerung hat bei einigen Geräten nicht funktioniert
- Profile ONVIF.Time und ONVIF.Speed waren bei der Beschreibung vertauscht
- Fehlende Übersetzungen ergänzt
Version 1.01:
- Release für Symcon 5.5
- Fehlende Übersetzungen ergänzt
Version 1.00:
- Beta Release für Symcon 5.5
Spenden
Die Library ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert: