Configuring the Universal Driver

In order for the Universal driver to receive video/audio it needs to know the Retrieval Mode, URI, codec and port.

General settings

Setting Name

Possible values

Description

Include URI options on PLAY

Yes

No

Controls whether to include query parameters in the URL used for RTSP PLAY command.

If “No” the query parameters (everything after “?”) in the Connection URI will be stripped before issuing the RTSP PLAY command.

HTTPS Enabled

No

Yes

Used only when HTTP or RTSP/RTP/HTTP/TCP streaming is selected.

No – Default value. Connection with the device will be established on the HTTP port during device add.

Yes – Connection with the device will be established over HTTPS using the HTTPS port.

HTTPS Port

1-65535

Used only when HTTPS Enabled is set to Yes.

Defines the HTTPS port to be used.

Default value is 443.

HTTPS Validate Certificate

No

Yes

Used only when HTTPS Enabled is set to Yes.

No – Default value. The driver will not check the validity of the certificate.

Yes – The driver will check the validity of the certificate of the device it is connecting to. If the certificate cannot be verified (is expired or the certificate chain does not lead to a trusted root), the connection will be dropped.

HTTPS Validate Hostname

No

Yes

Used only when HTTPS Enabled is set to Yes.

No – Default value. The driver will not check the validity of the hostname.

Yes –The driver will check whether the hostname of the device it’s connecting to matches the ones the certificate is issued to.

Video Channel settings

Setting Name

Possible values

Description

Delivery Mode

Multipart Stream

Non Multipart Stream

Used only when HTTP streaming is selected.

Controls whether to use HTTP multipart data transfer (see https://www.w3.org/Protocols/rfc1341/7_2_Multipart.html)

Keep Alive type

Default

OPTIONS

OPTIONS (no URL)

GET_PARAMETER

RTCP

Never

Used only when RTSP streaming is selected.

Defines what type of RTSP connection keep alive should be used.

Default – selected by the driver as the most appropriate.

OPTIONS – RTSP OPTIONS command will be send by the driver periodically.

OPTIONS (no URL) – RTSP OPTIONS command without URL will be send by the driver periodically.

GET_PARAMETER – RTSP GET_PARAMETER command will be send by the driver periodically.

RTCP – Driver will send RTCP client messages.

Never – do not use keep alive.

The selection for this setting depends on the requirements of the device. If you experience periodic interruptions and reconnections of the stream (once every 30 seconds to once every 5 minutes) try changing this setting.

Retrieval Mode

Streaming

Snapshot

Streaming – RTSP streaming or HTTP streaming will be used.

Snapshot – JPEG snapshot will be used to retrieve frames.

Codec

MJPEG

MPEG-4

H264

H265

The codec of the incoming video that the driver should expect. This should match the codec selected on the device for the video stream. Can be checked on device’s Web Page or using VLC (see Testing with VideoLan Player (VLC))

Connection URI

URI to be used for establishing a video stream or to request JPEG snapshots.

NOTE: the URI must be without the IP/hostname, port and the first slash (“/”) of the URL.

Example: If the URL of the video stream for the device is:

“rtsp://192.168.0.10:5544/channel1/stream1”

then the URI should be set as:

“channel1/stream1” (without the quotes)

The IP/hostname and port will be taken from the settings.

Frames per second

0.00028 - 60

Used only when the JPEG Snapshot mode is selected.

Controls the interval at which to poll the device for JPEGs.

Examples:

60 – poll the device 60 times per second

1 – poll the device once every second

0.1 – poll the device once every 10 seconds

0.00028 – poll the device once every hour

RTSP Port

1 - 65535

Used only if RTSP streaming mode is selected.

Sets the RTSP port to be used when connecting to the device.

Streaming Mode

RTP/UDP

RTP/RTSP/TCP

HTTP

RTP/UDP multicast

RTP/RTSP/HTTP/TCP

Used only when “Streaming” is selected for Retrieval Mode.

RTP/UDP – RTSP will be used and during RTSP SETUP UDP unicast RTP transfer will be requested from the device.

RTP/RTSP/TCP - RTSP will be used and during RTSP SETUP TCP unicast interleaved RTP transfer will be requested from the device.

HTTP – HTTP streaming mode will be used. The driver will issue a HTTP GET command and will expect in response to get the video data. If HTTPS is enabled, the HTTPS port will be used.

RTP/UDP multicast - RTSP will be used and during RTSP SETUP UDP multicast RTP transfer will be requested from the device.

RTP/RTSP/HTTP/TCP – RTSP will be used and tunneled through the HTTP port. If HTTPS is enabled, the HTTPS Port will be used.

Audio Channel settings

Setting Name

Possible Values

Description

Delivery Mode

Multipart Stream

Non Multipart Stream

Used only when HTTP streaming is selected.

Controls whether to use HTTP multipart data transfer (see https://www.w3.org/Protocols/rfc1341/7_2_Multipart.html)

Keep Alive type

Default

OPTIONS

OPTIONS (no URL)

GET_PARAMETER

RTCP

Never

Used only when RTSP streaming is selected.

Defines what type of RTSP connection keep alive should be used.

Default – selected by the driver as the most appropriate.

OPTIONS – RTSP OPTIONS command will be send by the driver periodically.

OPTIONS (no URL) – RTSP OPTIONS command without URL will be send by the driver periodically.

GET_PARAMETER – RTSP GET_PARAMETER command will be send by the driver periodically.

RTCP – Driver will send RTCP client messages.

Never – do not use keep alive.

Audio Codec

PCM RAW

PCM mju-law

PCM A-law

G.711 mju-law

G.711 A-law

G.721 32 kbps Little-Endian

G.721 32 kbps Big-Endian

G.723 24 kbps Little-Endian

G.723 40 kbps Little-Endian

G.723 24 kbps Big-Endian

G.723 40 kbps Big-Endian

G.726 16 kbps Little-Endian

G.726 24 kbps Little-Endian

G.726 32 kbps Little-Endian

G.726 40 kbps Little-Endian

G.726 16 kbps Big-Endian

G.726 24 kbps Big-Endian

G.726 32 kbps Big-Endian

G.726 40 kbps Big-Endian

AAC

The codec of the incoming audio that the driver should expect.

Connection URI

URI to be used for establishing an audio streaming connection.

NOTE: the URI must be without the IP/hostname, port and the first slash (“/”) of the URL.

Example: If the URL of the audio stream for the device is:

“rtsp://192.168.0.10:5544/channel1/audio1”

then the URI should be set as:

“channel1/audio1” (without the quotes)

The IP/hostname and port will be taken from the settings.

RTSP Port

1 - 65535

Used only if RTSP streaming mode is selected.

Sets the RTSP port to be used when connecting to the device.

Streaming Mode

RTP/UDP

RTP/RTSP/TCP

HTTP

RTP/UDP Multicast

RTP/RTSP/HTTP/TCP

Used only when “Streaming” is selected for Retrieval Mode.

RTP/UDP – RTSP will be used and during RTSP SETUP UDP unicast RTP transfer will be requested from the device.

RTP/RTSP/TCP - RTSP will be used and during RTSP SETUP TCP unicast interleaved RTP transfer will be requested from the device.

HTTP – HTTP streaming mode will be used. The driver will issue a HTTP GET command and will expect in response to get the audio data. If HTTPS is enabled, the HTTPS port will be used.

RTP/UDP multicast - RTSP will be used and during RTSP SETUP UDP multicast RTP transfer will be requested from the device.

RTP/RTSP/HTTP/TCP – RTSP will be used and tunneled through the HTTP port. If HTTPS is enabled, the HTTPS Port will be used.

Configurations for different stream types:

RTSP/RTP over UDP

Retrieval Mode

Streaming

Codec

MJPEG, MPEG4, H264 or H265

Streaming Mode

RTP/HTTP

RTSP/RTP over TCP

Retrieval Mode

Streaming

Codec

MJPEG, MPEG4, H264 or H265

Streaming Mode

RTP/RTSP /TCP

RTSP/RTP over multicast

Retrieval Mode

Streaming

Codec

MJPEG, MPEG4, H264 or H265

Streaming Mode

RTP/UDP multicast

HTTP streaming

Retrieval Mode

Streaming

Delivery Mode

“Multipart Stream” or “Non Multipart Stream”

Codec

MJPEG, MPEG4, H264 or H265

Streaming Mode

HTTP

JPEG Snapshots

Retrieval Mode

Snapshot

Codec

MJPEG

Frames per second

Needed snapshot interval

Streaming Mode

HTTP

RTSP over HTTP

Retrieval Mode

Streaming

Codec

MJPEG, MPEG4, H264 or H265

Streaming Mode

RTP/RTSP/HTTP /TCP

RTSP over HTTPS

Retrieval Mode

Streaming

Codec

MJPEG, MPEG4, H264 or H265

Streaming Mode

RTP/RTSP/HTTP /TCP

HTTPS Enabled

Yes

HTTPS Validate Certificate

Yes*

HTTPS Validate Hostname

Yes*

*Note: For testing purposes only “HTTPS Validate Certificate” and “HTTPS Validate Hostname” can be disabled.

Note: All configurations except “JPEG Snapshot” are valid for audio streaming as well.

Graphical user interface, text, application

Description automatically generated