Configuration of IP cameras

Data point name

Data point name of the created camera. Use the button to define a display name for the camera (written to the respective camera data point element object.device.name) which shall be shown instead of the data point name.

Description

Description for the camera.

Server

Specify the host which shall receive the streaming data of the camera. In addition you can define a list of hosts that shall be used for streaming if the first host is overloaded. The "..." button opens the following panel which lists all available hosts.

Available interfaces

A list of all available hosts (Video interface option must be enabled, see Host).

Secondary interfaces

If the host which receives the streaming data is overloaded, one of the configured hosts will take over according to the defined order (from top to bottom).

Note: If hosts are used for streaming and recording video data, the order of the configured streaming hosts and recording hosts shall match (only in case of failover redundancy, see also Recording - failover).

Configuration

Type

Select one of the available camera types with this selection list. The following types are available:

Axis camera
Bosch camera
Mobotix camera
ONVIF camera (refer to Retrieve information from ONVIF cameras)
RTSP stream
Sony camera
USB camera/Test stream

The user has different configuration options depending on the selected camera type. Some options are not available for every camera type.

Encapsulation

Depending on the camera type you can choose between http, https and rcpp.


Camera type	encap
Axis	http, https
Bosch	rcpp
ONVIF	http, https
Sony	http, https

URL extension

It is set automatically depending on the camera type.


Camera type	URL extension
ONVIF	/onvif/device_service

IP address

Type in the IP address of the camera.

Port

Must be specified according to the configuration of the video source respectively the encapsulation.

User

Must be specified according to the configuration of the video source.

The default user name for most of the BOSCH cameras is the "live".

Password

Must be specified according to the configuration of the video source.

PTZ

You can specify the number of presets for a camera and if the image shall be mirrored along the X or Y axis.

Streaming

You can select how many streams shall be available with the checkboxes Stream 1, Stream 2 and Stream 3.

Codec

Depending on the selected camera type different codecs are available:


Camera type	Codec
Axis	H264, H265, MJPEG, MPEG4
Bosch	ANY, H263, H264, H265, MJPEG, MPEG4
Mobotix	MJPEG
ONVIF	H264, H265, MJPEG, MPEG4
Sony	H264, H265, MJPEG, MPEG4
RTSP Stream	H263, H264, H265, MJPEG, MPEG4
USB Kamera/Test Stream	ANY

Encapsulation

Depending on the selected camera type different protocols are available: .


Camera type	Protocol
Axis	http, rtsp
Mobotix	http
ONVIF	http, rtsp
Sony	http, rtsp
RTSP Stream	rtsp

Streamlayout

Only available for Bosch cameras. This parameter defines how the interlace frames are packed:

Progressive
Topfieldtop
Bottomfieldtop
Weaved

Port

Must be specified according to the configuration of the video source respectively the encapsulation.

If no port is specified, the default values for rtsp (=5544) and http (=80) are used by default.

User

Must be specified according to the configuration of the video source.

Password

Must be specified according to the configuration of the video source.

Clone Stream

When enabled a stream can be selected by ID that should be cloned to the current stream.

Tip: This can be used to direct the same stream into different recordings.

Tip: By cloning a stream the required bandwidth can be reduced, as the stream is only received once from the video source.

URL extension

Depending on the configuration of the video source there are different options available.


Camera type	URL extension
Axis	/axis-media/media.amp /mpeg4/media.amp /mjpg/video.mjpg
Mobotix	/control/faststream.jpg
ONVIF	/onvif-media/media.amp
Sony	/media/video1 /media/video2
RTSP Stream	/media/video1

Media Profile

Must be specified according to the configuration of the video source.

Parameter

Depending on the configuration of the video source there are different options available.


Camera type	Parameter	Description
Axis	compression	Setting of the compression. Possible values: 0-100 Default: 30
	fps	Number of transmitted frames per second. Possible values: 1-30 Default: 25
	resolution	Resolution of the video stream. Possible values: QCIF, CIF, 2CIF, 4CIF Default: 4CIF respectively the camera's value.
	rotation	Enables image rotation by 180°. Possible values: 0, 180 Default: 0 respectively the camera's value.
Bosch	resolution	Name of the desired stream (stream1 = first configured stream in the encoder, stream2 = second configured stream in the encoder). Possible values: stream1, stream2 Default: stream1
Mobotix	fps	Number of transmitted frames per second. Possible values: 1-30 Default: 25
ONVIF	profile	Profile which shall be streamed. Possible values: All available profiles.
	pullpointsubscription	Allows to enable a polling for events by setting "`>pullpointsubscription=true`". The event data is stored within the Camera data point `<CameraDP<.object.device.events` and can also be accessed via the front panel of a camera, by clicking on the ONVIF Events button. Note: Since each camera provides a variety of different events, it is up to the user to decide which events to use and how to process them.
	eventsubscription	Allows to subscribe for events by setting "`eventsubscription=true`". The event data is stored within the Camera data point `<CameraDP<.object.device.events` and can also be accessed via the front panel of a camera, by clicking on the ONVIF Events button. Note: Since each camera provides a variety of different events, it is up to the user to decide which events to use and how to process them.
USB Kamera/Test Stream	device	Specifies the USB device.
	interval	Defines in which interval (in milliseconds) images shall be generated when used as test stream.
	timestep	When used as test stream, it defines in which interval (in milliseconds) the time in the picture is refreshed.

The "..." button opens a panel with a list of all available parameters. This list contains parameters of all cameras, therefore it depends on the camera which parameter you can actually use. If your camera supports any other parameter which is not in this list, you can add this parameter via the button. The parameters are stored on the internal data point element _VIDEO_OA_MAIN.general.generalUserDefFields.

Click the button to delete a selected parameter and to reset the list to the default parameters.

Recording

Allows to select one of the configured recordings and enables it for the stream.

In case failover-redundancy is defined for a recording, you can change the recording default settings for each camera stream. Click the "..." button to select another primary recording server. In this case the ranking of the configured failover hosts will change (refer to Recording - failover for further information).

Multicast

It is possible to configure multicast for each stream.

Note: Receiving multicast data is only supported for streams with one of the following codecs: H264, H263 and MPEG4.

Clicking on this button opens the following panel:


Parameter	Example value	Description
Multicast address	239.7.7.3	Multicast address of the camera/the encoder.
multicastPort	8765	Multicast port of the camera.
operatornetmulticastaddress	224.1.2.3	Multicast address used in proxy mode.
operatornetmulticastaddressrangebegin	224.0.1.2	Used multicast start address for the IP range in proxy mode.
operatornetmulticastaddressrangeend	239.255.255.255	Used multicast end address for the IP range in proxy mode.
operatornetmulticastport	1234	Multicast port used in proxy mode.
payloadtype	95\|96	In case that several media streams are sent to the same multicast address/port per RTP, the streams can be distinguished by the payload type. If no payload type is configured the first payload type which is received is used.
prop-parameter-sets	Z0IAKeNQFAe2AtwEBAaQeJEV,aM48gA	If SPS and PPS are not included in-band this parameter must be set appropriately. This parameter is a part of the SDP (Session Description Protocol) which is exchanged e.g. via the RTSP handshake.
ipinterfaceoperatornet	0.0.0.0	The multicast socket to the operator shall be bound to this IP address.
ipinterfacedevicenet	0.0.0.0	The multicast socket to the device shall be bound to this IP address.
ssrc		Synchronization source as decimal value (default = 0). It identifies the data source and is automatically assigned by the first received RTP packet.
config	000001B003000001B5090000010000000 12000C488BA9850584121463F	If the config header is not included in-band in the MPEG4 visual stream, this parameter must be set appropriately. This parameter is a part of the SDP (Session Description Protocol) which is exchanged e.g. via the RTSP handshake.

Important notes

The standard connection is as follows:

Camera/Encoder -> Unicast -> Interface-Proxy -> depending on the configured transport mode (0=Unicast, 1=Multicast, 2=TCP) -> Decoder (e.g. workstation or display monitor)
If rtp://<Multicast ipv4 address>:<port> is defined as URL for streaming, the connection is as follows:

Camera/Encoder -> Multicast -> Interface-Proxy -> depending on the configured transport mode (0=Unicast, 1=Multicast, 2=TCP) -> Decoder (e.g. workstation or display monitor)
In case that operatornetmulticastaddress = multicastaddress and operatornetmulticastport = multicastPort, the interface proxy for all decoder connections with transport mode 1 (=multicast) is disabled. In this case the interface does not transfer data to the decoders. The decoder receives the multicast data directly from the multicast sender (encoder or camera). If a decoder requests a unicast connection, the streaming proxy is enabled for this connection. To ensure that no streaming connection is established between interface and encoder/camera, the payloadtype must be set explicitly and there must not be a configured recording connection.
In case of Multi-Homed-Hosts it may happen that receiving or sending multicast data must be explicitly bound to a network adapter.
Recording connections are always TCP connections. If a recording connection is configured, the streaming proxy is always enabled.