Elecard Network Source

Elecard Network Source is a GStreamer plugin for receiving media data from the network. It receives the UDP, RTP, SRT and RIST packets and feeds the filter graph with stream data contained in these packets. SRT uses librist.

Features

Elecard Network Source has the following features:

  • Supports UDP, RTP, SRT, and RIST;

  • Supports Forward Error Correction (FEC);

  • Supports various stream types;

  • Supports various encryption methods.

Parameter Description

Below is the table describing Elecard Network Source parameters and their values.

Parameter Name

Description

Value Type

Available Values [range]

Default

Flags

announcements

Indicates an array of data obtained from SAP announcements.

Boxed pointer of type GstAnnouncesDescr

null

readable

data-packets-count

Indicates the number of received UDP packets.

Unsigned Integer64

[0 – 18446744073709551615]

0

readable

fec-port-columns

Specifies the port for getting data contained in columns of the FEC (Forward Error Correction) matrix.

Integer

[0 – 65535]

10502

readable, writable

fec-port-rows

Specifies the port for getting data contained in rows of the FEC (Forward Error Correction) matrix.

Integer

[0 – 65535]

10501

readable, writable

fec-restored-packets

Indicates the number of packets restored by using the FEC technology.

Unsigned Integer64

[0 – 18446744073709551615]

0

readable

fec-type

Specifies the FEC operation mode.

Integer
0 — FEC disabled
1 — only FEC rows are used
2 — FEC rows and columns are used

0

readable, writable

input-bitrate-bps

Indicates the current bit rate in bit/s. The bit rate is measured within a window specified in the instant-stats-period parameter.

Unsigned Integer64

[0 – 18446744073709551615]

0

readable

instant-dropped-packets

Indicates the number of dropped UDP packets. The value is measured within a window specified in the instant-stats-period parameter.

Integer

[0 – 2147483647]

0

readable

instant-fec-restored-packets

Indicates the number of packets restored via FEC. The value is measured within a window specified in the instant-stats-period parameter.

Integer

[0 – 2147483647]

0

readable

instant-stats-period

Specifies the size of the window (in seconds) for measuring current statistics.

Integer

[0 – 2147483647]

30

readable, writable

latency-value

Specifies latency in milliseconds between getting and displaying data when receiving elementary streams. This latency ensures smooth content playback. The parameter is ignored if a TS stream is received.

Integer

[0 – 2147483647]

1500

readable, writable

license-state

Indicates the component license state.

String

evaluation

readable

lost-data-packets

Indicates the total number of lost UDP packets.

Unsigned Integer64

[0 – 18446744073709551615]

0

readable

mcast-group

Specifies the IP address of a multicast group for receiving a stream or IP address of the interface that receives unicast traffic.

String

234.5.5.5

readable, writable

mcast-iface-ip

Specifies the IP address of the interface that receives traffic. If the value is empty, the interfaces are checked one after another until the one that receives the stream is found.

String

null

readable, writable

name

Specifies the name of the object.

String

netsrc0

readable, writable

parent

Specifies the parent of the object.

Object of type GstObject

readable, writable

payload-type

Specifies the type of the received stream. Available types:

  • elementary — Elementary stream;

  • mp2t — MPEG2 Transport stream;

  • mp2t-over-rtp — MPEG2 Transport over RTP stream.

Enum
0 — elementary
1 — mp2t
2 — mp2t-over-rtp

1

readable, writable

port

Specifies the port for stream receipt.

Integer

[0 – 65535]

10200

readable, writable

receiver-statistics

Indicates the received stream statistics.

String

“”

readable, writable

reconnect-timeout

Specifies the period in seconds. If the period expires and there is no stream, the component will try to resend the request to connect to the multicast group using IGMP (if UDP/RTP streams are received), or it will try to reconnect to the source (in case of SRT/RIST connection). If the value is set to 0, there will be no reconnect attempts.

Integer

0

readable, writable

rist-buffer-size

Specifies the size of the buffer (in milliseconds) for storing last received RIST packets.

Integer

[0 – 2147483647]

1000

readable, writable

rist-profile

Specifies the RIST profile.

Enum
0 — Simple
1 — Main
2 — Advanced

1

readable, writable

rist-url-parameters

Specifies the string with additional RIST URL parameters in the following format:

parameter_name = parameter_value & parameter_name = parameter_value...

String

null

readable, writable

sap-address

Specifies the multicast address for receiving SAP announcements.

String

224.2.127.254

readable, writable

sap-port

Specifies the port for receiving SAP announcements.

Integer

9875

readable, writable

sap-timeout

Specifies the period (in seconds) during which the announcement from the list of SAP announcements is considered active.

Integer

[0 – 2147483647]

30

readable, writable

sdp-file-path

Specifies the path to the stream description file in the SDP format. In the up-to-date component, both the path and the textual SDP representation have the same parameter.

String

“”

readable, writable

server

Specifies the server address for limiting the number of received streams by using only this address.

String

null

readable, writable

srt-delay

Specifies the delay (in milliseconds) for restoring lost packets when receiving an SRT stream.

Integer

[0 – 2147483647]

0

readable, writable

srt-rist-encryption-type

Specifies the encryption type for SRT and RIST streams. For RIST, the encryption is not supported in the Simple profile. Additionally, the AES-192 encryption is not supported by RIST at all.

Enum
0 — Disabled
1 — AES-128
2 — AES-256
3 — AES-192 (SRT only)

0

readable, writable

srt-rist-passphrase

Specifies the password for connecting to SRT and RIST streams with Main and Advanced profiles. The parameter is inactive if srt-rist-encryption-type is set to 0.

String

null

readable, writable

srt-stream-id

Specifies the unique name the component sends to the server in the SRT Caller mode for identification before connection. The maximum length is 512 characters. The parameter is inactive in the Listener mode.

String

null

readable, writable

ssm-enable-filtering

Enables or disables the filtering of multicast streams if multiple sources are present. Available modes:

  • Disable — the multicast stream is received from any source;

  • Enable — the multicast stream is received from the source that was first to start sending data.

Enum
0 — Disable
1 — Enable

0

readable, writable

status-work-ok

Indicates the current status of the received stream. If the value is 0, the stream is not received. If the value is 1, the stream is received.

Integer

[0 – 1]

0

readable

transport

Specifies the transport protocol used to receive data. Available protocols:

  • udp — UDP;

  • rtp — RTP;

  • srt caller — SRT in the Caller mode;

  • srt listener — SRT in the Listener mode;

  • rist caller — RIST in the Caller mode;

  • rist listener — RIST in the Listener mode.

Enum
0 — udp
1 — rtp
4 — srt caller
5 — srt listener
6 — rist caller
7 — rist listener

0

readable, writable

uri

Specifies the stream URI in the following way:

[(udp | rtp | srt)://][interface@]address[:port]

If the value is not empty, this parameter takes priority over transport, mcast-group, port, meaning that this is a URI parameter that will be used in this case.

String

udp://234.5.5.5:10200

readable, writable