Datenpunktelement "link"

Das Element link beinhaltet alle Konfigurationsparameter, die das Video Subsystem vimaccOA zur Konfiguration des entsprechenden Video Objekts benötigt. Alle link Informationen werden vom Video OA Manager interpretiert und in die vimaccOA Datenbank synchronisiert.

Das Element link ist ein dyn_string mit immer genau drei Einträgen. Im nicht redundanten Betrieb ist nur der erste Eintrag relevant. Im redundanten Betrieb kann über die drei Einträge das Verhalten des Video Objektes im jeweiligen vimaccOA Redundanz Zustand konfiguriert werden.

Der erste Eintrag gilt für den Redundanzzustand das beide Video Server verfügbar sind (RC0).

Der zweite Eintrag gilt für den Redundanzzustand, dass Server 1 noch aktiv ist und Server 2 ausgefallen ist (RC1).

Der dritte Eintrag gilt für den Redundanzzustand, dass Server 2 noch aktiv ist und Server 1 ausgefallen ist (RC2).

Im Normalfall sind immer alle drei Einträge exakt gleich konfiguriert. Manchmal macht es aber Sinn, dass im Redundanzfall z.B. andere Streaming- oder Aufzeichnungsparameter verwendet werden. Unterschiedliche Parametrierungen werden aber derzeit vom Framework nicht unterstützt.

Schlüsselwörter für Rechner (VIDEO_OA_HOST)

Für jeden Rechner im Video System wird ein VIDEO_OA_HOST angelegt. Im Normalfall ist/sind:

  • für die Video OA Server die folgenden Flags gesetzt:

    „isControlInterface=true;isVideoInterface=true;isRecordingServer=true, isRtspServer=true“

  • für die Video OA Display Server nur das Flag „isDisplayServer=true“ gesetzt

Folgende link Einträge werden für VIDEO_OA_HOST unterstützt:

Schlüsselwort Beschreibung
ip IP Adresse des Video OA Systems
hostname Host Name des Video OA Systems
isControlInterface Legt fest ob das Video OA System als Control Interface arbeiten soll (0 oder 1).
isDisplayServer Legt fest ob das Video OA System als Display Server arbeiten soll (0 oder 1).
isRecordingServer Legt fest ob das Video OA System als Recording Server arbeiten soll (0 oder 1).
isRtspServer Legt fest ob das Video OA System als RTSP Server arbeiten soll (0 oder 1).
isStreamingProxy Legt fest ob das Video OA System als Streaming Proxy arbeiten soll (0 oder 1).
isVideoInterface Legt fest ob das Video OA System als Video Interface arbeiten soll (0 oder 1).

Beispiel

ip=192.168.200.99;hostname=CCTV-SRV1;isControlInterface=true;isRecordingServer=true,

isDisplayServer=false,isRtspServer=false,isVideoInterface=false

Schlüsselwörter für Control Interfaces (VIDEO_OA_CONTROL_INTERFACE)

Das Control Interface stellt die Schnittstelle zwischen WinCC OA und dem Video Subsystem vimaccOA dar. Auf jedem Video OA Server wird ein Control Interface Prozess gestartet. In einem Video OA System kann es maximal 2 Control Interfaces geben, die dann redundant agieren. Die Control Interfaces werden bei der Video OA System Konfiguration automatisch vom Video Video Objekt Explorer angelegt.

Folgende link Einträge werden für VIDEO_OA_CONTROL_INTERFACE unterstützt:

Schlüsselwort Beschreibung
function=CMS,INTERFACE_VIMACC_CONTROL
mode=1|0 Das Control Interface ist aktiv / nicht aktiv
port=[4227] TCP Port zur Kommunikation mit vimaccOA
username=[user] Username für die Authentifizierung beim vimaccOA. Kann frei vergeben werden
password=[pwd]

Passwort für die Authentifizierung beim vimaccOA.

Kann frei vergeben werden

Beispiel

function=CMS,INTERFACE_VIMACC_CONTROL;port=4227;password=pwd;username=user;mode=1

Schlüsselwörter für IP-Kameras (VIDEO_OA_CAMERA)

Für die link Informationen von IP-Kameras werden unterschiedliche Parameter benötigt.

  • Allgemeine Parameter

  • Steuerungsparameter

  • Streamingparameter

  • Herstellerspezifische Zusatzparameter.

Allgemeine Parameter:

Schlüsselwort Beschreibung
mode=1|0 Die Kamera Interface ist aktiv / nicht aktiv
function=FIX|PTZ Fix montierte Kamera / PTZ Kamera
ip=<ip-address> IP Adresse der Video Kamera
permanentConnection=0|1 Verbindung wird bei Bedarf / dauerhaft aufgebaut
flipx=0|1 Umkehr der x-Achse (rechts/links) bei PTZ Steuerung
flipy=0|1 Umkehr der y-Achse (hoch/runter) bei PTZ Steuerung
flipz=0|1 Umkehr der z-Achse (zoom in/out) bei PTZ Steuerung

Steuerungsparameter:

Für die PTZ Steuerung von IP-Kameras werden verschiedene Standard und herstellerspezifische

Protokolle unterstützt. Die folgende Liste gibt eine Übersicht der unterstützten Protokolle:

Schlüsselwort Beschreibung
ctrlProtocol=ONVIF_VIDEO_DEVICE Standard ONVIF Kamera
ctrlProtocol=VAPIX_VIDEO_DEVICE Axis IP-Kamera
ctrlProtocol=RCPP_VIDEO_DEVICE Bosch IP-Kamera (RCP + Protokoll)
ctrlProtocol=MOBOTIX_VIDEO_DEVICE Mobotix IP-Kamera
ctrlProtocol=MOXA_VIDEO_DEVICE Moxa IP-Kamera
ctrlProtocol=SONY_VIDEO_DEVICE Sony IP-Kamera
ctrlProtocol=ANY_VIDEO_DEVICE Standard IP-Kamera (RTSP oder HTTP Stream)
ctrlProtocol=TEST_STREAMING_DEVICE Test Kamera (USB/ Laptop Kamera/ Stream Generator)
encapsulation=http|https URL Präfix für den Verbindungsaufbau
ctrlPort=<port> TCP Port für die Steuerung der Video Kamera
ctrlUser=<user> Username für die Steuerung der Video Kamera
ctrlPassword=<pwd> Passwort für die Steuerung der Video Kamera
creates_ftpalarms=0|1 Aktiviert oder deaktiviert die Überwachung des zugehörigen Verzeichnisses des FTP-Servers
ftpalarm_deadtime_msec Totzeit (optional), Defaultwert ist 5000
ftpalarm_upload_subdirectory Unterverzeichnis relativ zum FTP-Rootverzeichnis (optional). Per Default wird die ID der Kamera als Verzeichnisname angenommen. Ist dann wichtig, wenn ein Encoder zwar mehrere Kameras anbinden kann, im Encoder aber nur eine Upload-Verzeichnis konfiguriert werden kann. In dem Fall landen alle FTP-Alarmdateien aller Kameras dieses Encoder in einem Verzeichnis auf dem FTP Server. Es wird dann zumindest erwartet, dass die Dateinamen am Ende die ID der Kamera enthalten (z.B. 3_12_2014_14_03_58_79_cam0002_prealarm.jpg, so dass der Alarm eindeutig einem vimacc Device zugeordnet werden kann.

Streamingparameter:

Video OA unterstützt bis zu drei verschiedene Streams pro Kamera. Die Streamingparameter haben

immer die Syntax stream<Nr>_<parameter>. Durch die Streamnummer lassen sich die Parameter für

die einzelnen Streams unterscheiden.

Schlüsselwort Beschreibung
stream1_codec=MJPEG|MPEG4|H264|ANY Video codec für die Decodierung
stream1_enc=http|rtsp streaming URL Präfix für den Verbindungsaufbau
stream1_port=<port> streaming URL Port für den Verbindungsaufbau
stream1_user=<user> Streaming URL Benutzername
stream1_password=<pwd> Streaming URL Passwort
stream1_urlExt<urlExt> Streaming URL Extension

Video OA unterstützt pro Stream eine Aufzeichnungsverbindung. Die Streamingparameter haben

immer die Syntax stream<Nr>_<parameter>. Durch die Streamnummer lassen sich die Parameter für

die einzelnen Streams unterscheiden.

Schlüsselwort Beschreibung
stream1_recording=<RECORDING_SESSION_DP> Verweis auf den Datenpunkt für die Aufzeichnungsverbindung

Herstellerspezifische Zusatzparameter:

Herstellerspezifisch gibt es noch weitere Zusatzparameter, die parametriert werden können. Die folgende Aufstellung zeigt die unterstützten herstellerspezifischen Zusatzparameter:

Zusatzparameter für ONVIF_VIDEO_DEVICE:

Schlüsselwort Beschreibung
stream1_profile=<profile> Vordefiniertes Streaming-Profil für den Abruf
stream1_ptzToken=<token> Vordefinierter Token für die PTZ Kontrolle

Zusatzparameter für VAPIX_VIDEO_DEVICE:

Schlüsselwort Beschreibung
stream1_fps=[1-25] Framerate für den Stream
stream1_rotation=0|180 Drehen des Videobildes um 0/180 Grad
stream1_rtpoverrtsp=false|true Bildübertragung erfolgt über UDP (false) oder über TCP (true)

Zusatzparameter für RCPP_VIDEO_DEVICE:

Schlüsselwort Beschreibung
stream1_encapsulation=rcpp Bosch eigenes RCPP Protokoll
stream1_resolution=stream1|stream2 Vordefiniertes Streaming-Profil für den Abruf
stream1_rtpoverhttp=false|true Bildübertragung erfolgt über UDP (false) oder über TCP (true)

Zusatzparameter für TEST_STREAMING_DEVICE:

Schlüsselwort Beschreibung
stream1_device=0|1|2 Nummer des Video Capture Devices (USB Kamera)
stream1_resolution=640x480 Auflösung des Video Capture Devices (USB Kamera)
stream1_interval=[500] Intervall für die Testbildgenerierung
stream1_timestep=[500] Zeitintervall für die Zeit im Testbild

Konfigurationsbeispiele

BEISPIEL

ONVIF Kamera link Informationen:

ctrlProtocol=ONVIF_VIDEO_DEVICE;mode=1;function=PTZ;ip=192.168.1.1;

ctrlPort=80;ctrlUser=user;ctrlPassword=pwd;encapsulation=http;

ctrlURLExt=/onvif/device_service;flipx=0;flipy=0;flipz=0;

stream1_enc=rtsp;stream1_codec=H264;stream1_user=user;

stream1_password=pwd;stream1_ptztoken=quality_h264;

stream1_profile=quality_h264;stream1_urlExt=/onvif-media/media.amp;

BEISPIEL

Beispiel für Axis IP-Kamera link Informationen:

ctrlProtocol=VAPIX_VIDEO_DEVICE;

mode=1;function=PTZ;ip=192.168.1.1;ctrlUser=admin;

ctrlPassword=admin;encapsulation=http;flipx=0;flipy=0;flipz=0;

stream1_codec=H264;stream1_user=admin;

stream1_password=admin;

stream1_urlExt=/axis-media/media.amp;

stream1_enc=rtsp;

stream1_fps=25; stream2_codec=MJPEG;

stream2_user=admin;

stream2_password=admin;

stream2_urlExt=/mjpg/video.mjpg;

stream2_enc=http;

BEISPIEL

Beispiel für Bosch IP-Kamera link Informationen:

ctrlProtocol=RCPP_VIDEO_DEVICE;

mode=1;function=PTZ;ip=192.168.1.1;ctrlPort=1756;

ctrlUser=user;encapsulation=rcpp;flipx=0;flipy=0;flipz=0;

stream1_codec=ANY;

stream1_resolution=stream1;

stream2_codec=ANY;

stream2_resolution=stream2;

BEISPIEL

Beispiel für Mobotix IP-Kamera link Informationen:

ctrlProtocol=MOBOTIX_VIDEO_DEVICE;

mode=1;function=FIX;ip=192.168.1.1;flipx=0;flipy=0;flipz=0; stream1_codec=MJPEG;

stream1_user=user;

stream1_password=pwd;

stream1_urlExt=/control/faststream.jpg;

stream1_enc=http;

BEISPIEL

Beispiel für Sony IP-Kamera link Informationen:

ctrlProtocol=SONY_VIDEO_DEVICE;

mode=1;function=PTZ;ip=192.168.1.1;ctrlPort=80;ctrlUser=user;

ctrlPassword=pwd;

encapsulation=http;

flipx=0;flipy=0;flipz=0;

stream1_codec=H264;

stream1_user=admin;

stream1_password=admin;

stream1_enc=http;

stream1_urlExt=/h264;

BEISPIEL

Beispiel für Standard RTSP Kamera link Informationen:

ctrlProtocol=ANY_VIDEO_DEVICE;

mode=1;function=FIX;ip=192.168.200.42;flipx=0;flipy=0;flipz=0; stream1_password=pwd;

stream1_user=user;

stream1_urlExt=/h264;

stream1_enc=rtsp;

stream1_codec=H264;

BEISPIEL

Beispiel für Video Capture Device (Laptop Kamera oder USB Kamera) link Informationen:

ctrlProtocol=TEST_STREAMING_DEVICE;mode=1; function=FIX;

stream1_codec=ANY;stream1_device=0;

BEISPIEL

Beispiel für Test Streaming Generator link Informationen:

ctrlProtocol=TEST_STREAMING_DEVICE;mode=1;function=FIX;

stream1_codec=ANY;stream1_interval=500;

stream1_timestep=500;

Schlüsselwörter für analoge Kameras (VIDEO_OA_CAMERA)

Für die link Informationen von analogen Kameras werden unterschiedliche Parameter benötigt.

Allgemeine Konfigurationsparameter, Steuerungsparameter und Streamingparameter. Allgemein gibt es die folgenden Einträge:

Allgemeine Parameter

Schlüsselwort Beschreibung
mode=1|0 Das Kamera Interface ist aktiv / nicht aktiv
permanentConnection=0|1 Verbindung wird bei Bedarf / dauerhaft aufgebaut.

Die Streamingparameter werden für analoge Kameras im Encoder konfiguriert. Entsprechend verweisen die Streamingparameter auf den Video Encoder, wo die Kamera angeschlossen ist:

Streaming-Parameter

Schlüsselwort Beschreibung
videoEncoder=[Encoder_<nr>] Video Encoder, wo die Kamera angeschlossen ist
videoPort=[nr] Video Port am Encoder

Die PTZ Parameter werden für analoge Kameras je nachdem, ob der Encoder interne PTZ Treiber oder der vimaccOA PTZ Treiber verwendet wird, konfiguriert:

PTZ Parameter

Schlüsselwort Beschreibung
function=FIX|PTZ Fix montierte Kamera / SNK Kamera
flipx=0|1 Umkehr der x-Achse (rechts/links) bei PTZ Steuerung
flipy=0|1 Umkehr der y-Achse (hoch/runter) bei PTZ Steuerung
flipz=0|1 Umkehr der z-Achse (zoom in/out) bei PTZ Steuerung
ptzDevice=[SERIAL_PTZ oder ENCODER] PTZ Device, wo die serielle Leitung der Kamera angeschlossen ist.
ptzMode=transparent|intern Verwendung des Encoder PTZ Treibers oder Transparenter Modus für vimaccOA PTZ Treiber
ptzProtocol=GLOBE_PTZ_PROTOCOL Funkwerk/Plettac Protokoll
ptzProtocol=KDEC_PTZ_PROTOCOL Geutebrück Protokoll
ptzProtocol=MULTISEC_PTZ_PROTOCOL Lederer, Funkwerk/Plettac Protokoll
ptzProtocol=PELCOD_PTZ_PROTOCOL PELCO D Protokoll
ptzProtocol=PST95_PTZ_PROTOCOL Siemens Protokoll
ptzProtocol=VPT_PTZ_PROTOCOL Eneo Protokoll
ptzAddress=[1-255] RS-485 Bus Addresse

BEISPIEL

Beispiel für eine analoge PTZ Kamera mit PELCOD Protokoll:

mode=1;videoEncoder=Encoder_00001;videoPort=2;function=PTZ;flipx=0;flipy=0;

flipz=0;ptzMode=transparent;ptzDevice=Encoder_00001;

ptzProtocol=PELCOD_PTZ_PROTOCOL;ptzAddress=01

Schlüsselwörter für Kreuzschienen (VIDEO_OA_SWITCHING_MATRIX)

Für die link Informationen von Kreuzschienen werden unterschiedliche Parameter benötigt.

Allgemeine Parameter

Schlüsselwort Beschreibung
mode=1|0 Die Kreuzschiene ist aktiv / nicht aktiv
ip IP-Adresse der Kreuzschiene
ctrlPort Port über den die Kreuzschiene angesprochen wird
ctrlUser Benutzername für die Kreuzschienensteuerung
ctrlPassword Passwort für die Kreuzschienensteuerung

Steuerungsparameter

Schlüsselwort Beschreibung
ctrlProtocol=TEST_SWITCHING_MATRIX Protokoll zur internen Simulation einer Kreuzschiene
ctrlProtocol=GEVISOFT_SWITCHING_MATRIX Protokoll zum Zugriff auf eine Geutebrück Kreuzschiene
encapsulation=gsc Kapselung für eine Geutebrück Kreuzschiene
ptzMode=intern Die Kreuzschiene verfügt über eine PTZ-Steuerung
ptzMode=transparent Die PTZ-Steuerung der angeschlossenen Kameras ist nur über externe Geräte möglich

BEISPIEL

Beispiel für eine analoge PTZ Kamera mit PELCOD Protokoll:

mode=1;

ip=192.168.200.24;

ctrlPort=1236;

ctrlUser=username;

ctrlPassword=sssss;

encapsulation=gsc;

ctrlProtocol=GEVISOFT_SWITCHING_MATRIX;

ptzMode=transparent;

Schlüsselwörter für Encoder-Pool-Kanäle (VIDEO_OA_ENCODER_POOL_CHANNEL)

Für die link Informationen von Encoder-Pool-Kanälen werden unterschiedliche Parameter benötigt.

Allgemeine Parameter

Schlüsselwort Beschreibung
mode=1|0 Der Encoder-Pool-Kanal ist aktiv / nicht aktiv
matrixOutputPort=1 Ausgangsadressbezeichnung der Kreuzschiene
encoderPort Poolname des Kanals
switchingMatrix Name der zugehörigen Kreuzschiene
videoEncoder=[Encoder_<nr>] Video-Encoder an dem die Kreuzschiene angeschlossen ist
videoPort=[nr] Video-Port am Encoder

BEISPIEL

mode=1;

matrixOutputPort=1;

encoderPool=live;

switchingMatrix=AnalogSwitchingMatrix1;

videoEncoder=Encoder_00003;videoPort=2

Schlüsselwörter für Aufzeichnungsverbindungen (VIDEO_OA_RECORDING_SESSION)

Für die link Informationen von Aufzeichnungsverbindungen werden unterschiedliche Parameter benötigt.

Allgemeine Parameter

Schlüsselwort Beschreibung
mode=1|0 Die Aufzeichnungsverbindung ist nicht aktiv
recordingMode=ALARM|RING Daueraufzeichnung oder Alarmaufzeichnung
redundancyMode=NONE|LOAD_BALANCING| FULL_REDUNDANCY Redundanz-Modus
recordingServer<1..4> Host-Datenpunkt für den entsprechenden Aufzeichnungsserver
recordingServer2 Host-Datenpunkt für den zweiten Aufzeichnungsserver

Daueraufzeichnungsparameter

Schlüsselwort Beschreibung
ringSize=<seconds> Aufbewahrungszeit der Daueraufzeichnungen; 0 bedeutet manuelle Wartung, also manuelles Löschen der Aufzeichnungen

Alarmaufzeichnungsparameter

Schlüsselwort Beschreibung
prealarm=<seconds> Voralarmzeit; 0 bedeutet kein Voralarm, also stopp solange keine Alarmaufzeichnung gestartet wird
postalarm=<seconds> Nachalarmzeit; 0 bedeutet infinit
autoDelete=<seconds> Aufbewahrungszeit der Alarmaufzeichnungen; 0 bedeutet manuelle Wartung, also manuelles Löschen der Aufzeichnungen

BEISPIEL

Beispiel für Daueraufzeichnung:

mode=1;recordingMode=RING;redundancyMode=FULL_REDUNDANCY;

recordingServer1=VIDEO_SERVER_1;path1=C:/vimacc/data/record/RING;

recordingServer2=VIDEO_SERVER_2;path2=C:/vimacc/data/record/RING;

function=SERVER;ringSize=86400;

BEISPIEL

Beispiel für Alarmaufzeichnung:

mode=1;recordingMode=ALARM;redundancyMode=NONE;

recordingServer1=VIDEO_SERVER_1;path1=C:/vimacc/data/record/ALARM;

function=SERVER;prealarm=60;postalarm=0;autoDelete=3600;

Schlüsselwörter für FTP-Alarmempfänger (VIDEO_OA_FTP_ALARM_RECEIVER)

Für die link Informationen von FTP-Alarmempfängern werden unterschiedliche Parameter benötigt.

Allgemeine Parameter

Schlüsselwort Beschreibung
mode=1|0 Die Aufzeichnungsverbindung ist nicht aktiv
ftpserver Zugangsdaten für den FTP-Server – IP-Adresse des Servers
ftpport Zugangsdaten für den FTP-Server - Port
ftpusername Zugangsdaten für den FTP-Server - Benutzername
ftpuserpwd Zugangsdaten für den FTP-Server - Passwort
ftpWatchDirPath Root Verzeichnis des FTP Servers
ftpexcludedsubdirlist Verzeichnisse, die komplett ignoriert werden sollen (optional)
ftpalarmfileextensions Dateiendungen, die zu einer Alarmierung führen (optional). Default ist jpg
function Fixer Parameter (wird automatisch auf FTP_ALARM_RECEIVER gesetzt)

BEISPIEL

mode=1;

ftpserver=127.0.0.1;

ftpport=21;

ftpusername=ftptest;

ftpuserpwd=ftptest;

ftpWatchDirPath=c:/temp/ftproot;

ftpexcludedsubdirlist=Autobahn,cam2/test;

ftpalarmfileextensions=jpg,txt;

function=FTP_ALARM_RECEIVER;