Integration mit der Mobotix Q24 Kamera

Diese Anleitung ist die dritte in der Reihe, in der die Integration des DOMIQ-Systems mit den Mobotix Geräten beschrieben wird. In den ersten zwei Tutorials haben wir die Inte- gration mit der Mobotix T24 Video-Türsprechanlage, die Verwendung des SIP Protokolls und Mobotix Geräten in der Funktion der Video-Türsprechanlage dargestellt. In diesem Tutorial beschreiben wird die Integrationsmöglichkeiten der internen Mobotix Q24 Kamera.

Nach der Lektüre dieses Tutorial, erfahren Sie wie:

• Funktionen der Kamera von der DOMIQ-Benutzerschnittstelle zu steuern
• die Bereiche der Bewegungserkennung zu definieren und die Reaktion auf Bewegungin diesen Bereichen einzustellen
• die Kamera Satel Integra mit dem Alarmsystem zu integrieren.
• Das SIP Protokoll so zu verwenden, dass es über Alarmereignisse informiertBevor Sie dieses Tutorial lesen, empfehlen wir, dass Sie die anderen Tutorials aus dieser Serie lesen, weil dieses Tutorial die Anknüpfungen an die dort beschriebenen Prozeduren enthält.

1. Steuerung der KameraMit Hilfe der Programmierschnittstelle der API-Kamera ist es möglich alle Funktionen der Kamera direkt von der DOMIQ Benutzerschnittstelle zu steuern. Dadurch können Sie den Visualisierungsbildchirm oder die Seite in Remote erstellen, in den Sie die Schaltflächen platzieren, die die am häufigsten benutzten Funktionen der Kamera aufrufen.Das Senden der Befehle an der Kamera erfolgt mit Hilfe der Get Methode des HTTP Pro- tokolls. Um den Zugang zur ganzen Beschreibung der Kameraprogrammierschnittstelle zu erlangen, geben Sie im Adressfeld des Browsers http://<ip der kamera>/help ein und dann in Remote-Controlling the Camera wählen Sie The HTTP API aus.

Der weitere Teil dieses Kapitels stellt drei Beispiele für die Verwendung der Programmierschnittstelle zur Steuerung der Kamera von einer Visualisierung dar. In diesen Beispielen zeigen wir die Verwendung der Kommandos im Feld Kommando, das Element Schaltfläche. Im Feld Kommando ist es nicht notwendig, das Präfix „C“ zu verwenden. In allen anderen Fällen müssen die Befehle mit einem Präfix verwendet werden.

Dieses Kommando kann auch in anderen Funktionsbereichen des Base-Moduls, z.B. in Ereignissen, Zeitregeln, Logik usw. verwendet werden.

1.1. Änderung des Bildformats

Die Mobotix Q24 Kamera ermöglicht es das Bild in einigen Formaten anzuzeigen. Sie können das Format mit Hilfe des Parameters display_mode ändern. Die folgenden Ele- mente sind verfügbar: simple, lenscorr_l11, surround, panorama, pano_focus,

pano_dbl. Die Syntax des Kommandos zum Umschalten des Bildformats: C.HTTP.get=http://<login>:<passwort>@<ip_der_kamera>/control/con- trol?set&section=general&display_mode=<bildformat>.

Um die ganze Schnittstelle zum Umschalten des Bildformats zu erstellen, fügen Sie 6 Schaltflächen an Visualisierung hinzu. Dann geben Sie das oben genannte Kommando im Feld Kommando ein und ändern Sie den Wert des Parameters display_mode.

1.2. Änderung der Bildgröße

Die Software der Kamera ermöglicht es die Auflösung des Bildes im großen Bereich zu ändern: 160×120, 320×240, 352×288, 384×288, 640×480, 704×576, 768×576, 800×600, 1024×768, 1280×960, 2048×1536. Dadurch ist es leicher das Bild an aktuellen Bedürfnis- sen und Geschwindigkeit der Internetverbindung (insbesondere Fernzugang) anzupassen. Sie können auch die Regel in Ereignissen oder Timern definieren. Dadurch wird die Au- flösung bei der Abwesenheit verkleinert. Wenn wir aber im Bereich des lokalen Netzwer- kes sind, werden die Auflösung und Flüssigkeit des Bildes bei Fern-Verbindungen vergrößert.

Die Syntax des Kommandos ist wie folgt: C.HTTP.get=http://<login>:<passwort>@<ip_der_kamera>/control/con-
trol?set&section=imagecontrol&size=<groesse>


1.3. Verkleinerung/Vergrößerung des Bildes

Verkleinerung und Vergrößerung des Bildes, das sog. Zoom. Dadurch können Sie die De- tails des Bildes sehen. Die Kamera ermöglicht bis zu achtmalige Vergrößerung des ange- zeigten Bildes. Vergrößerung kann konkret (z. B. fünfmalige Vergrößerung) oder in Bezug auf die vorherige Einstellung ausgedrückt werden, z.B. erhöht um 1. Die Änderung der Vergrößerung wird in Promillen ausgedrückt, also einer Vergrößerung um 1 der Wert von 1000 entspricht.

Die Syntax des Kommandos für konkrete Änderung ist wie folgt:

C.HTTP.get=http://<login>:<passwort>@<ip_der_kamera>/control/
click.cgi?zoom=<vergroesserung>

Änderung der Vergrößerung im Bezug auf die vorherige Einstellung:

HTTP.get=http://<login>:<passwort>@<ip_der_kamera>/control/
click.cgi?zoomrel=<aenderung_der_vergroesserung>

Jedes Mal, wenn Sie dieses Kommando ausgeführt wird, wird die Größe einmal ver- größert. Um das Bild zu verkleinern, sollte der absolute Wert der Vergrößerung als eine negative Zahl ausgedrückt werden.

In den dargestellten Beispielen bitte ändern Sie das Login und Passwort sowie die IP Adresse der Kamera.

2. Integration der Kamera mit dem Base Modul
Die Integration der Kamera mit dem Base Modul ist der Ausgangspunkt zur Integration

mit anderen Systemen des intelligenten Gebäudes.

Kamerasoftware arbeitet mit der außen Software zusammen, also es ist möglich die voll- ständige Integration der Kamera mit dem DOMIQ System, und damit mit ganzer Installa- tion des intelligenten Gebäudes durchzuführen. Die Integration ist bidirektional und erfolgt nach dem folgenden Verfahren:

2.1. Senden der Information an Base Modul

Nach der Erstellung einer einfachen Regel wird das Base Modul Informationen über jedes Ereignis empfangen, das in der Kamera aufgerufen wurde. Das Base kann also auf Fol- genden reagieren: Drücken der Schaltflächen auf Video-Türsprechanlage, Bewegungser- kennung, Geräuscherkennung usw.

1. Loggen Sie sich in Konfigurationsschnittstelle der Kamera ein.
2. Wählen Sie Admin setup aus (neues Fenster wird geöffnet).
3. In Transfer Profiles wählen Sie IP Notify Profiles:
   • Klicken Sie auf Add new profile am unteren Rand des Bildschirms.
   • In der Zelle IP Notify Profile geben Sie den Namen des Profils an, z.B. Base.
   • In der Liste IP Notify Type wählen Sie Custom Configuration.
   • Im Feld Destination Address geben Sie IP:4224 ein, z.B. 192.168.10.20:4224
   • Wählen Sie Raw TCP/IP im Feld Data Protocol und Plain text im Feld Data Type.
   • Im letzten Fenster werden die Meldungen definiert, die an Base Modul übergaben werden, wenn ein in der Kamera definiertes Ereignis aufgerufen wird. Wir zeigen unten nur wie den Aktionsnamen, der das Ereignis aufgerufen hat, zu übergeben. Zu diesem Zweck geben Sie ein:
   • MOBOTIX.event.q24=$(EVT.EST.ACTIVATED). Das bedeutet, dass der Name der Aktion, die das Ereignis aufgerufen hat, wird als das Kommando C.MOBOTIX.event.q24=<ereignis> vom Base empfangen. Wenn das Tür- klingeln gedrückt wird, ist es: C.MOBOTIX.event.q24=CameraBellButton.Die Beispielkonfiguration wird unten dargestellt.

Die Beispielkonfiguration wird unten dargestellt.

4. Klicken Sie auf Set, um die Änderungen zu bestätigen und dann klicken Sie auf Close um sie im Speicher des Geräts zu speichern.

2.2. Empfang der Information aus Base Modul

Die Ereignisse in der Kamera können durch beliebige Meldung aufgerufen werden, die vom TCP/IP empfangen werden. In deisem Bespiel dient die TCP/IP Meldung zum Aufruf der Bildaufnahme. Die Aktion wird wie folgt definiert:

1. Wählen Sie Setup Menu und dann Event Settings aus.
2. MarkierenSiedasAuswahlfeldinIPReceive(RC)EventsundfüllenSiediefolgendenParameter aus:
   • Das Feld IP Receive Port bleibt mit der Standardnummer 8000.
   • In der Liste IP Receive Compare wählen Sie String Compare aus.
   • Im Feld IP Receive Message geben Sie einen beligebigen Wert ein, der das Ereignis aufrufen soll. Verwenden Sie keine Leerzeichen. Wir haben das Wort re- cording verwendet.
3. Klicken Sie auf Set um die Änderungen zu bestätigen.
4. GehenSiezumSetupMenuzurückundwählenSieRecordingaus.ImneuenFensterfüllen Sie die folgenden Parameter aus:
   • In Arming wählen Sie in der Liste Enable aus.
   • In Recording wählen Sie Event Recording aus. Wählen Sie Include audio, wenn Sie möchten das Ton aufnehmen.
   • In Start Recording wählen Sie die Aktion, die die Aufnahme aufrufen wird. Sie können mehreren Positionen auswählen, wenn Sie die gedrückte Schaltfläche Ctrl (PC) oder cmd (Mac) halten. Wir haben die folgende Option ausgewählt: RC: IP Receive.
   • Die weiteren drei Optionen bestimmen die Parameter und Zeit des aufgenomme- nen Bildes.

Die Beispielkonfiguration wird unten dargestellt:

6. Konfiguration fertig. Wenn die Kamera die TCP/IP Meldung recording empfägt, wird die Aufnahme des Bildes gestartet.
7. Klicken Sie auf Set um die Änderungen zu bestätigen und dann Close um sie im Speicher des Geräts zu speichern.

Im weiteren Teil des Tutorials stellen wir dar, wie TCP/IP aus Base Modul zu senden. Jetzt können Sie die Kamera mit dem Satel Alarmsystem integrieren.

3. Integration mit dem Satel Alarmsystem

Die Integration des Alarmsystems und Monitoring ermöglicht eine noch bessere und umfassendere Überwachung des Gebäudes/der Wohnung bei Abwesenheit der Bewohner. Durch Bestimmung der Bewegungserkennungszonen können Sie sofort über Verlet- zung dieser Zonen informiert werden. Dies erfolgt mit Hilfe der Benachrichtigung oder SIP Verbindung an Ihrem Handy oder Tablet. Mit Hilfe der Live-Ansicht können Sie das Risiko beurteilen und eine schnelle Entscheidung treffen.

3.1. Automatische Aufnahme

Dank automatisches Aufrufs sind Sie sicher, dass kein Alarmereignis Ihrer Aufmerksam- keit entgeht. Die Aufnahme kann nach Verleztung der Bewegungserkennungszone aufge- rufen oder wenn ein Alarmsensor (PIR Sensor, Reedschalter, Sensor des Einschmeißens einer Scheibe, Rauchsensor, Überschwemmungsensor usw.) aufgerufen werden.

3.1.1. Aufnahme aufgerufene durch Bewegungserkennung Definition der Bereiche der Bewegungserkennung

Die Bereiche der Bewegungserkennung sollen nach der Montage der Kamera definiert werden. Die Definition des Bereichs erfolgt wie folgt:

1. DrückenSiedieUmschalttasteunddoppelklickenSieaufAnsichtdesBildesimKonfi- gurator der Kamera. Ein kleines gelbes Quadrat wird angezeigt.
2. LassenSiedieUmschalttastelosundklickenSieaufgegenüberliegendeEckedesBe- reichs. Der Bereich wird als Rechteck mit gelbem Umriss angezeigt.
3. Wählen Sie Setup Menu > Event Settings aus.
4. In Video Motion Windows wählen Sie aus der Liste Hide but highlight on event aus(der Bereich wird mit rotem Umriss im Falle der Verletzung markiert).
5. Die Kamera hat zwei standarddefinierten Profile VM und VM2. In VM klicken Sie auf Add Rectangle, um den definierten Bereich hinzuzufügen. Im Feld Video Motion De- finitions (VM) sehen Sie die Parameter des definierten Rechteckes. Sie können meh- rere Bereiche in einem Profil definieren. Zu diesem Zweck erstellen Sie die Punkte 1 und 2 und dann klicken Sie auf Add Rectangle. Dadurch wird im Feld Video Motion Definitions (VM) einen weiteren Bereich hinzugefügt.

Die Beispielkonfiguration wird unten dargestellt:

6. Definieren Sie die Reaktion der Kamera auf Bewegungserkennung. Dies kann z.B. Be- ginn der Aufnahme oder Wiedergabe des Tons usw. sein. In diesem Fall die Reaktion ist Senden der IP Meldung an das Base Modul.
7. Gehen Sie zu Setup Menu zurück und dann wählen Sie Action Group Overview aus. Fügen Sie die neue Gruppe (Schaltfläche Add new group) hinzu.
8. Im neuen Fenster ergänzen Sie die Parameter der Gruppe:
   • Geben Sie den Namen der Gruppe, z.B. Bewegung ein.
   • In der Liste wählen Sie Enable aus.
   • In Event Selection wählen Sie VM – Video Motion aus.
   • In Actions fügen Sie die neue Aktion hinzu (Schaltfläche Add new action) und dann wählen Sie in der Liste IP Notify:<profilname> in diesem Fall IP Notify: Base.
9. Klicken Sie auf Set um die Änderungen zu bestätigen und dann auf Close um Sie im Speicher des Geräts zu speichern.

Reaktion des Base Moduls

Die Kamera ermöglicht es als direkte Reaktion auf Bewegungserkennung die Aufnahme zu beginnen. In diesem Fall soll aber die Aufnahme nur bei der Abwesenheit der Men- schen im Gebäude/in der Wohnung aufgerufen werden. Zu diesem Zweck erstellen Sie das Ereignis, das den Zustand der Alarmanlage überprüft und über Beginn der Aufnahme entscheidet.

1. Im Base Konfigurator gehen Sie zum Lesezeichen Ereignisse.
2. Fügen Sie das neue Ereignis hinzu und ergänzen Sie ihre Parameter:
   • Geben Sie die Beschreibung ein (optional)
   • Im Feld Kanal geben Sie C.MOBOTIX.event.q24 ein (wie im Kapitel 2.1 Senden der Information an Base Modul.)
   • Im Feld Daten geben Sie den Profilnamen der Bewegungserkennung ein. In die- sem Fall VM.
   • Im Feld Bedingung geben Sie: E.IDS.armed.<zone>==1 ein, wo <zone> steht für die Zonenummer, die Anwesenheit der Menschen im Gebäude eindeutig bestimmt.

3. Klicken Sie auf Kommando hinzufügen…. Im Fenster im Feld Name geben Sie C.TCP.send.<IP der kamera>:8000 ein. In der Zelle Wert geben Sie die Mel- dung ein, die an Kamera gesendet werden sollte. In diesem Fall ist es das Wort recor- ding (es ruft die vordefinierte Regel zum Beginn der Aufnahme aus). Das Kommando wird nur dann ausgeführt, wenn die Meldung aus dem Feld Bedingung erfüllt wird.

Optional kann das Base Modul die Benachrichtigung an allen registrierten Remote Appli- kationen senden oder SIP Verbindung an ausgewählten Personen machen. Die Be- schreibung dieser Funktionalitäten finden Sie im Kapitel 4.

3.1.2. Aufnahme, die durch Alarmsensoren aufgerufen wird

Diese Art der Aufnahme ist besser, weil die Aktivität der mit Alarmanlage verbundenen Sensoren berücksichtigt ist. Es ist auch unzuverlässig, weil die Fehler bei der Bewegung- serkennung vermieden werden können. Das Verfahren beschränkt sich auf ein einzelnes Ereignis, das wie folgt definiert ist:

1. Fügen Sie das neue Ereignis hinzu und ergänzen Sie ihr Parameter:
   • Geben Sie die Beschreibung ein (optional)
   • Im Feld Kanal geben Sie: E.IDS.input.(%d+) ein – ein beliebiger Zugang der Alarmanlage.
   • Im Feld Daten geben Sie 1 ein.
   • Im Feld Bedingung geben Sie E.IDS.armed.<zone>==1 ein, wo <zone> steht für die Zonenummer, die die Anwesenheit der Menschen im Gebäude eindeutig bestimmt.
2. Klicken Sie auf Kommando hinzufügen…. Im Fenster im Feld Name geben Sie C.TCP.send.<IP der Kamera>:8000 ein. In der Zelle Wert geben Sie die Mel- dung ein, die an Kamera gesendet werden sollte. In diesem Fall ist es das Wort recor- ding (es ruft die vordefinierte Regel zum Beginn der Aufnahme aus). Das Kommando wird nur dann ausgeführt, wenn die Meldung aus dem Feld Bedingung erfüllt wird.

Optional kann das Base Modul die Benachrichtigung an allen registrierten Remote Appli- kationen senden oder SIP Verbindung an ausgewählten Personen herstellen. Die Be- schreibung dieser Funktionalitäten finden Sie im Kapitel 4.

4. Optionale Reaktionen

Die Reaktion des Systems auf Verletzung des Wachens oder Zonen der Bewegungser- kennung muss nicht auf Aufnahme des Bildes beschränkt werden. In diesem Kapitel stel- len wir dar, wie die Alarmbenachrichtigungen zu senden und die SIP Alarmverbindung an mobilden Geräten herzustellen.

4.1. Alarmbenachrichtigungen

Das Base Modul ermöglicht es die Benachrichtigungen mit dem beliebigen Inhalt an allen DOMIQ/Remote Applikationen zu senden. Um solche Aktion zu definieren, fügen Sie zum Ereignis, das die Aufnahme aufruft, ein zusätzliches Kommando wie folgt:

Im Feld Name geben Sie C.REMOTE.notify ein. In der Zelle Wert geben Sie einen be- liebigen Inhalt der Meldung ein.

Wenn Sie die Aktion definieren, werden die Benutzer jedes Mal über den Aufruf der Alar- maufnahme informiert.

4.2. SIP-Alarmverbindung
Das Base Modul beginnt die SIP Verbindung nach der Verleztung der Zone der Bewe-

gungserkennung oder Alarmsensoren und informiert den Benutzer über dieses Ereignis.

Die Konfiguration des Servers, der Benutzerkonten oder SIP Benutzerapplikationen wurde im Tutorial TU-0012 („DOMIQ, SIP und Mobotix Kameras”) detalliert beschrieben. De- shalb werden wir es hier nicht darstellen. Wir zeigen nur diese Konfigurationselemente, die geändert werden sollten.

Im Falle der SIP-Alarmverbindungen empfehlen wir ein separates Profil der SIP Verbin- dungen zu definieren, um die Alarmverbindungen und die normalen Verbindungen eindeu- tig zu trennen. Beim Definieren des Alarmprofils sollen Sie (es ist aber nicht notwendig) die Tonbenachrichtigung auswählen (die Option Message name), die am Anfang der Alarmverbindung wiedergegeben wird. Dadurch weißt der Benutzer, dass er mit der Alar- mverbindung zu tun hat.

Sie können die fertigen Töne, die in der Kamera verfügbar sind, auswählen (z.B. Ton mit dem Namen Alarm) oder Ihren eigenen Audiodateien hochladen. Im Tutorial MOBOTIX T24 Türsprechanlage haben wir beschrieben wie die eigenen Audiodateien hochzuladen.

Im Vergleich zum vorigen Tutorial wird die Art des Beginns der Verbindung mit mobilen Geräten geändert. Statt IP-Benachrichtigung verwenden wir Programmierinterface der Kamera.

Wir werden auch das Kommando darstellen, mit dem die Verbindung mit dem ausgewähl- ten SIP Benutzer möglich ist.

Die beide Kommandos haben ein C-Präfix, weil in diesem Fall in der Definition die Ereignisse verwendent werden, wo es erforderlich ist.

Um sich mit allen Geräten in einem Profil zu verbinden, verwenden Sie das folgende Kommando:C.HTTP.get=http://<login>:<passwort>@<ip_der_kamera>/control/rcon- trol?action=voipphone&profile=<name_des_profils>

Die Syntax des Kommandos, mit dem die Verbindung mit bestimmten SIP Benutzer möglich ist, ist wie folgt: C.HTTP.get=http://<login>:<passwort>@<ip_der_kamera>/control/rcon-
trol?action=voipcall&sipaddr=<SIP_Adresse_des_Benutzers>


In diesen Beispielen vergessen Sie nicht das Login, Passwort und IP Adresse der Kamera zu ändern.

Um die SIP Verbindungen automatisch aufzunehmen, fügen Sie ein der beschriebenen Kommandos zur Liste der Aktionen hinzu, die ausgeführt werden, wenn die Bereiche der Bewegungserkennung oder Alarmsensoren verletzt werden.