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;