dvbsrc: GStreamer Bad Plugins 1.0 Plugins Reference Manual

dvbsrc

Properties

guint	bandwidth-hz	Read / Write
GstDvbSrcBandwidth	bandwidth	Read / Write
GstDvbSrcCode_Rate	code-rate-hp	Read / Write
GstDvbSrcCode_Rate	code-rate-lp	Read / Write
gchararray	device	Read / Write
gint	diseqc-src	Read / Write
gint	freq	Read / Write
GstDvbSrcGuard	guard	Read / Write
GstDvbSrcHierarchy	hierarchy	Read / Write
GstDvbSrcInversion	inversion	Read / Write
GstDvbSrcModulation	modulation	Read / Write
gchar *	pids	Write
gchararray	pol	Read / Write
gint	srate	Read / Write
GstDvbSrcTransmission_Mode	trans-mode	Read / Write
gpointer	tune	Write
gint	adapter	Read / Write
gint	diseqc-source	Read / Write
guint	frequency	Read / Write
gint	frontend	Read / Write
gchar *	polarity	Read / Write / Construct
guint	symbol-rate	Read / Write
guint	stats-reporting-interval	Read / Write
guint64	timeout	Read / Write
guint	dvb-buffer-size	Read / Write
GstDvbSrcDelsys	delsys	Read / Write
GstDvbSrcPilot	pilot	Read / Write
GstDvbSrcRolloff	rolloff	Read / Write
gint	stream-id	Read / Write
guint64	tuning-timeout	Read / Write
guint	isdbt-layer-enabled	Read / Write
GstDvbSrcCode_Rate	isdbt-layera-fec	Read / Write
GstDvbSrcModulation	isdbt-layera-modulation	Read / Write
gint	isdbt-layera-segment-count	Read / Write
gint	isdbt-layera-time-interleaving	Read / Write
GstDvbSrcCode_Rate	isdbt-layerb-fec	Read / Write
GstDvbSrcModulation	isdbt-layerb-modulation	Read / Write
gint	isdbt-layerb-segment-count	Read / Write
gint	isdbt-layerb-time-interleaving	Read / Write
GstDvbSrcCode_Rate	isdbt-layerc-fec	Read / Write
GstDvbSrcModulation	isdbt-layerc-modulation	Read / Write
gint	isdbt-layerc-segment-count	Read / Write
gint	isdbt-layerc-time-interleaving	Read / Write
gint	isdbt-partial-reception	Read / Write
guint	isdbt-sb-segment-count	Read / Write
gint	isdbt-sb-segment-idx	Read / Write
gint	isdbt-sb-subchannel-id	Read / Write
gint	isdbt-sound-broadcasting	Read / Write
guint	lnb-lof1	Read / Write
guint	lnb-lof2	Read / Write
guint	lnb-slof	Read / Write
GstDvbSrcInterleaving	interleaving	Read / Write

Signals

void	tuning-done	Run Last
void	tuning-fail	Run Last
void	tuning-start	Run Last
void	tune	Action

Types and Values

struct

GstDvbSrc

Object Hierarchy

    GObject
    ╰── GInitiallyUnowned
        ╰── GstObject
            ╰── GstElement
                ╰── GstBaseSrc
                    ╰── GstPushSrc
                        ╰── GstDvbSrc

Description

dvbsrc can be used to capture media from DVB cards. Supported DTV broadcasting standards include DVB-T/C/S, ATSC, ISDB-T and DTMB.

Example launch line

gst-launch-1.0 dvbsrc modulation="QAM 64" trans-mode=8k bandwidth=8 frequency=514000000 code-rate-lp=AUTO code-rate-hp=2/3 guard=4  hierarchy=0 ! mpegtsdemux name=demux ! queue max-size-buffers=0 max-size-time=0 ! mpegvideoparse ! mpegvideoparse ! mpeg2dec ! xvimagesink demux. ! queue max-size-buffers=0 max-size-time=0 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! pulsesink

Captures a full transport stream from DVB card 0 that is a DVB-T card at tuned frequency 514000000 Hz with other parameters as seen in the pipeline and renders the first TV program on the transport stream.

gst-launch-1.0 dvbsrc modulation="QAM 64" trans-mode=8k bandwidth=8 frequency=514000000 code-rate-lp=AUTO code-rate-hp=2/3 guard=4  hierarchy=0 pids=100:256:257 ! mpegtsdemux name=demux ! queue max-size-buffers=0 max-size-time=0 ! mpegvideoparse ! mpeg2dec ! xvimagesink demux. ! queue max-size-buffers=0 max-size-time=0 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! pulsesink

Captures and renders a transport stream from DVB card 0 that is a DVB-T card for a program at tuned frequency 514000000 Hz with PMT PID 100 and elementary stream PIDs of 256, 257 with other parameters as seen in the pipeline.

gst-launch-1.0 dvbsrc polarity="h" frequency=11302000 symbol-rate=27500 diseqc-source=0 pids=50:102:103 ! mpegtsdemux name=demux ! queue max-size-buffers=0 max-size-time=0 ! mpegvideoparse ! mpeg2dec ! xvimagesink demux. ! queue max-size-buffers=0 max-size-time=0 ! mpegaudioparse ! mpg123audiodec ! audioconvert ! pulsesink

Captures and renders a transport stream from DVB card 0 that is a DVB-S card for a program at tuned frequency 11302000 kHz, symbol rate of 27500 kBd (kilo bauds) with PMT PID of 50 and elementary stream PIDs of 102 and 103.

gst-launch-1.0 dvbsrc frequency=515142857 guard=16 trans-mode="8k" isdbt-layer-enabled=7 isdbt-partial-reception=1 isdbt-layera-fec="2/3" isdbt-layera-modulation="QPSK" isdbt-layera-segment-count=1 isdbt-layera-time-interleaving=4 isdbt-layerb-fec="3/4" isdbt-layerb-modulation="qam-64" isdbt-layerb-segment-count=12 isdbt-layerb-time-interleaving=2 isdbt-layerc-fec="1/2" isdbt-layerc-modulation="qam-64" isdbt-layerc-segment-count=0 isdbt-layerc-time-interleaving=0 delsys="isdb-t" ! tsdemux ! "video/x-h264" ! h264parse ! queue ! avdec_h264 ! videoconvert ! queue ! autovideosink

Captures and renders the video track of TV Paraíba HD (Globo affiliate) in Campina Grande, Brazil. This is an ISDB-T (Brazilian ISDB-Tb variant) broadcast.

1	gst-launch-1.0 dvbsrc frequency=503000000 delsys="atsc" modulation="8vsb" pids=48:49:52 ! decodebin name=dec dec. ! videoconvert ! autovideosink dec. ! audioconvert ! autoaudiosink

Captures and renders KOFY-HD in San Jose, California. This is an ATSC broadcast, PMT ID 48, Audio/Video elementary stream PIDs 49 and 52 respectively.

Synopsis

Element Information

plugin	dvb
author	P2P-VCR, C-Lab, University of Paderborn, Zaheer Abbas Merali <zaheerabbas at merali dot org> Reynaldo H. Verdejo Pinochet <reynaldo@osg.samsung.com>
class	Source/Video

Element Pads

name	src
direction	source
presence	always
details	video/mpegts, mpegversion=(int)2, systemstream=(boolean)true

Functions

Types and Values

struct GstDvbSrc

struct GstDvbSrc;

Property Details

The `“bandwidth-hz”` property

  “bandwidth-hz”             guint

Channel bandwidth in Hz.

Flags: Read / Write

Default value: 8000000

The `“bandwidth”` property

  “bandwidth”                GstDvbSrcBandwidth

(DVB-T) Bandwidth. Deprecated.

Flags: Read / Write

Default value: 8

The `“code-rate-hp”` property

  “code-rate-hp”             GstDvbSrcCode_Rate

(DVB-T, DVB-S/S2 and DVB-C) High priority code rate.

Flags: Read / Write

Default value: AUTO

The `“code-rate-lp”` property

  “code-rate-lp”             GstDvbSrcCode_Rate

(DVB-T) Low priority code rate.

Flags: Read / Write

Default value: 1/2

The `“device”` property

  “device”                   gchararray

The device directory.

Flags: Read / Write

Default value: "/dev/dvb/adapter0"

The `“diseqc-src”` property

  “diseqc-src”               gint

DISEqC selected source (-1 disabled) (DVB-S).

Flags: Read / Write

Allowed values: [-1,7]

Default value: -1

The `“freq”` property

  “freq”                     gint

Frequency.

Flags: Read / Write

Allowed values: >= 0

Default value: 0

The `“guard”` property

  “guard”                    GstDvbSrcGuard

(DVB-T) Guard Interval.

Flags: Read / Write

Default value: 16

The `“hierarchy”` property

  “hierarchy”                GstDvbSrcHierarchy

(DVB-T) Hierarchy information.

Flags: Read / Write

Default value: 1

The `“inversion”` property

  “inversion”                GstDvbSrcInversion

(DVB-T and DVB-C) Inversion information.

Flags: Read / Write

Default value: ON

The `“modulation”` property

  “modulation”               GstDvbSrcModulation

(DVB-T/T2/C/S2, TURBO and ATSC) Modulation type.

Flags: Read / Write

Default value: QAM 16

The `“pids”` property

  “pids”                     gchar *

Colon-separated list of PIDs (eg. 110:120) to capture. ACT and CAT are automatically included but PMT should be added explicitly. Special value 8192 gets full MPEG-TS.

Flags: Write

Default value: "8192"

The `“pol”` property

  “pol”                      gchararray

Polarity [vhHV] (DVB-S).

Flags: Read / Write

Default value: "h"

The `“srate”` property

  “srate”                    gint

Symbol Rate (DVB-S, DVB-C).

Flags: Read / Write

Allowed values: >= 0

Default value: 0

The `“trans-mode”` property

  “trans-mode”               GstDvbSrcTransmission_Mode

(DVB-T) Transmission mode.

Flags: Read / Write

Default value: 8K

The `“tune”` property

  “tune”                     gpointer

Atomically tune to channel. (For Apps).

Flags: Write

The `“adapter”` property

  “adapter”                  gint

The DVB adapter device number (eg. 0 for adapter0).

Flags: Read / Write

Allowed values: [0,16]

Default value: 0

The `“diseqc-source”` property

  “diseqc-source”            gint

(DVB-S/S2) Selected DiSEqC source. Only needed if you have a DiSEqC switch. Otherwise leave at -1 (disabled).

Flags: Read / Write

Allowed values: [G_MAXULONG,7]

Default value: -1

The `“frequency”` property

  “frequency”                guint

Center frequency to tune into. Measured in kHz for the satellite distribution standars and Hz for all the rest.

Flags: Read / Write

Default value: 0

The `“frontend”` property

  “frontend”                 gint

The frontend device number (eg. 0 for frontend0).

Flags: Read / Write

Allowed values: [0,16]

Default value: 0

The `“polarity”` property

  “polarity”                 gchar *

(DVB-S/S2) Polarity [vhHV] (eg. V for Vertical).

Flags: Read / Write / Construct

Default value: "H"

The `“symbol-rate”` property

  “symbol-rate”              guint

(DVB-S/S2, DVB-C) Symbol rate in kBd (kilo bauds).

Flags: Read / Write

Default value: 0

The `“stats-reporting-interval”` property

  “stats-reporting-interval” guint

The number of reads before reporting frontend stats.

Flags: Read / Write

Default value: 100

The `“timeout”` property

  “timeout”                  guint64

Post a message after timeout microseconds (0 = disabled).

Flags: Read / Write

Default value: 1000000

The `“dvb-buffer-size”` property

  “dvb-buffer-size”          guint

The kernel buffer size used by the DVB api.

Flags: Read / Write

Default value: 1925120

The `“delsys”` property

  “delsys”                   GstDvbSrcDelsys

Delivery System.

Flags: Read / Write

Default value: UNDEFINED

The `“pilot”` property

  “pilot”                    GstDvbSrcPilot

Pilot (DVB-S2).

Flags: Read / Write

Default value: AUTO

The `“rolloff”` property

  “rolloff”                  GstDvbSrcRolloff

Rolloff (DVB-S2).

Flags: Read / Write

Default value: auto

The `“stream-id”` property

  “stream-id”                gint

(DVB-T2 and DVB-S2 max 255, ISDB max 65535) Stream ID (-1 = disabled).

Flags: Read / Write

Allowed values: [G_MAXULONG,65535]

Default value: -1

The `“tuning-timeout”` property

  “tuning-timeout”           guint64

Microseconds to wait before giving up tuning/locking on a signal.

Flags: Read / Write

Default value: 10000000000

The `“isdbt-layer-enabled”` property

  “isdbt-layer-enabled”      guint

(ISDB-T) Layer Enabled (7 = All layers).

Flags: Read / Write

Allowed values: [1,7]

Default value: 7

The `“isdbt-layera-fec”` property

  “isdbt-layera-fec”         GstDvbSrcCode_Rate

(ISDB-T) layer A Forward Error Correction.

Flags: Read / Write

Default value: AUTO

The `“isdbt-layera-modulation”` property

  “isdbt-layera-modulation”  GstDvbSrcModulation

(ISDB-T) Layer A modulation type.

Flags: Read / Write

Default value: AUTO

The `“isdbt-layera-segment-count”` property

  “isdbt-layera-segment-count” gint

(ISDB-T) Layer A segment count (-1 = AUTO).

Flags: Read / Write

Allowed values: [G_MAXULONG,13]

Default value: -1

The `“isdbt-layera-time-interleaving”` property

  “isdbt-layera-time-interleaving” gint

(ISDB-T) Layer A time interleaving (-1 = AUTO).

Flags: Read / Write

Allowed values: [G_MAXULONG,8]

Default value: -1

The `“isdbt-layerb-fec”` property

  “isdbt-layerb-fec”         GstDvbSrcCode_Rate

(ISDB-T) layer B Forward Error Correction.

Flags: Read / Write

Default value: AUTO

The `“isdbt-layerb-modulation”` property

  “isdbt-layerb-modulation”  GstDvbSrcModulation

(ISDB-T) Layer B modulation type.

Flags: Read / Write

Default value: AUTO

The `“isdbt-layerb-segment-count”` property

  “isdbt-layerb-segment-count” gint

(ISDB-T) Layer B segment count (-1 = AUTO).

Flags: Read / Write

Allowed values: [G_MAXULONG,13]

Default value: -1

The `“isdbt-layerb-time-interleaving”` property

  “isdbt-layerb-time-interleaving” gint

(ISDB-T) Layer B time interleaving (-1 = AUTO).

Flags: Read / Write

Allowed values: [G_MAXULONG,8]

Default value: -1

The `“isdbt-layerc-fec”` property

  “isdbt-layerc-fec”         GstDvbSrcCode_Rate

(ISDB-T) layer C Forward Error Correction.

Flags: Read / Write

Default value: AUTO

The `“isdbt-layerc-modulation”` property

  “isdbt-layerc-modulation”  GstDvbSrcModulation

(ISDB-T) Layer C modulation type.

Flags: Read / Write

Default value: AUTO

The `“isdbt-layerc-segment-count”` property

  “isdbt-layerc-segment-count” gint

(ISDB-T) Layer C segment count (-1 = AUTO).

Flags: Read / Write

Allowed values: [G_MAXULONG,13]

Default value: -1

The `“isdbt-layerc-time-interleaving”` property

  “isdbt-layerc-time-interleaving” gint

(ISDB-T) Layer C time interleaving (-1 = AUTO).

Flags: Read / Write

Allowed values: [G_MAXULONG,8]

Default value: -1

The `“isdbt-partial-reception”` property

  “isdbt-partial-reception”  gint

(ISDB-T) Partial Reception (-1 = AUTO).

Flags: Read / Write

Allowed values: [G_MAXULONG,1]

Default value: 1

The `“isdbt-sb-segment-count”` property

  “isdbt-sb-segment-count”   guint

(ISDB-T) SB segment count.

Flags: Read / Write

Allowed values: [1,13]

Default value: 1

The `“isdbt-sb-segment-idx”` property

  “isdbt-sb-segment-idx”     gint

(ISDB-T) SB segment IDX.

Flags: Read / Write

Allowed values: [0,12]

Default value: 0

The `“isdbt-sb-subchannel-id”` property

  “isdbt-sb-subchannel-id”   gint

(ISDB-T) SB Subchannel ID (-1 = AUTO).

Flags: Read / Write

Allowed values: [G_MAXULONG,41]

Default value: 0

The `“isdbt-sound-broadcasting”` property

  “isdbt-sound-broadcasting” gint

(ISDB-T) Sound Broadcasting.

Flags: Read / Write

Allowed values: [0,1]

Default value: 0

The `“lnb-lof1”` property

  “lnb-lof1”                 guint

LNB's Local oscillator frequency used for low band reception (kHz).

Flags: Read / Write

Default value: 9750000

The `“lnb-lof2”` property

  “lnb-lof2”                 guint

LNB's Local oscillator frequency used for high band reception (kHz).

Flags: Read / Write

Default value: 10600000

The `“lnb-slof”` property

  “lnb-slof”                 guint

LNB's Upper bound for low band reception (kHz).

Flags: Read / Write

Default value: 11700000

The `“interleaving”` property

  “interleaving”             GstDvbSrcInterleaving

(DTMB) Interleaving type.

Flags: Read / Write

Default value: AUTO

Signal Details

The `“tuning-done”` signal

void
user_function (GstDvbSrc *gstdvbsrc,
               gpointer   user_data)

Signal emited when the tunner has successfully got a lock on a signal.

Parameters

gstdvbsrc	the element on which the signal is emitted
user_data	user data set when the signal handler was connected.

Flags: Run Last

The `“tuning-fail”` signal

void
user_function (GstDvbSrc *gstdvbsrc,
               gpointer   user_data)

Signal emited when the tunner failed to get a lock on the signal.

Parameters

gstdvbsrc	the element on which the signal is emitted
user_data	user data set when the signal handler was connected.

Flags: Run Last

The `“tuning-start”` signal

void
user_function (GstDvbSrc *gstdvbsrc,
               gpointer   user_data)

Signal emited when the element first attempts to tune the frontend tunner to a given frequency.

Parameters

gstdvbsrc	the element on which the signal is emitted
user_data	user data set when the signal handler was connected.

Flags: Run Last

The `“tune”` signal

void
user_function (GstDvbSrc *gstdvbsrc,
               gpointer   user_data)

Signal emited from the application to the element, instructing it to tune.

Parameters

gstdvbsrc	the element on which the signal is emitted
user_data	user data set when the signal handler was connected.

Flags: Action

dvbsrc

Properties

Signals

Types and Values

Object Hierarchy

Description

Example launch line

Synopsis

Element Information

Element Pads

Functions

Types and Values

struct GstDvbSrc

Property Details

The “bandwidth-hz” property

The “bandwidth” property

The “code-rate-hp” property

The “code-rate-lp” property

The “device” property

The “diseqc-src” property

The “freq” property

The “guard” property

The “hierarchy” property

The “inversion” property

The “modulation” property

The “pids” property

The “pol” property

The “srate” property

The “trans-mode” property

The “tune” property

The “adapter” property

The “diseqc-source” property

The “frequency” property

The “frontend” property

The “polarity” property

The “symbol-rate” property

The “stats-reporting-interval” property

The “timeout” property

The “dvb-buffer-size” property

The “delsys” property

The “pilot” property

The “rolloff” property

The “stream-id” property

The “tuning-timeout” property

The “isdbt-layer-enabled” property

The “isdbt-layera-fec” property

The “isdbt-layera-modulation” property

The “isdbt-layera-segment-count” property

The “isdbt-layera-time-interleaving” property

The “isdbt-layerb-fec” property

The “isdbt-layerb-modulation” property

The “isdbt-layerb-segment-count” property

The “isdbt-layerb-time-interleaving” property

The “isdbt-layerc-fec” property

The “isdbt-layerc-modulation” property

The “isdbt-layerc-segment-count” property

The “isdbt-layerc-time-interleaving” property

The “isdbt-partial-reception” property

The “isdbt-sb-segment-count” property

The “isdbt-sb-segment-idx” property

The “isdbt-sb-subchannel-id” property

The “isdbt-sound-broadcasting” property

The “lnb-lof1” property

The “lnb-lof2” property

The “lnb-slof” property

The “interleaving” property

Signal Details

The “tuning-done” signal

Parameters

The “tuning-fail” signal

Parameters

The “tuning-start” signal

Parameters

The “tune” signal

Parameters

The `“bandwidth-hz”` property

The `“bandwidth”` property

The `“code-rate-hp”` property

The `“code-rate-lp”` property

The `“device”` property

The `“diseqc-src”` property

The `“freq”` property

The `“guard”` property

The `“hierarchy”` property

The `“inversion”` property

The `“modulation”` property

The `“pids”` property

The `“pol”` property

The `“srate”` property

The `“trans-mode”` property

The `“tune”` property

The `“adapter”` property

The `“diseqc-source”` property

The `“frequency”` property

The `“frontend”` property

The `“polarity”` property

The `“symbol-rate”` property

The `“stats-reporting-interval”` property

The `“timeout”` property

The `“dvb-buffer-size”` property

The `“delsys”` property

The `“pilot”` property

The `“rolloff”` property

The `“stream-id”` property

The `“tuning-timeout”` property

The `“isdbt-layer-enabled”` property

The `“isdbt-layera-fec”` property

The `“isdbt-layera-modulation”` property

The `“isdbt-layera-segment-count”` property

The `“isdbt-layera-time-interleaving”` property

The `“isdbt-layerb-fec”` property

The `“isdbt-layerb-modulation”` property

The `“isdbt-layerb-segment-count”` property

The `“isdbt-layerb-time-interleaving”` property

The `“isdbt-layerc-fec”` property

The `“isdbt-layerc-modulation”` property

The `“isdbt-layerc-segment-count”` property

The `“isdbt-layerc-time-interleaving”` property

The `“isdbt-partial-reception”` property

The `“isdbt-sb-segment-count”` property

The `“isdbt-sb-segment-idx”` property

The `“isdbt-sb-subchannel-id”` property

The `“isdbt-sound-broadcasting”` property

The `“lnb-lof1”` property

The `“lnb-lof2”` property

The `“lnb-slof”` property

The `“interleaving”` property

The `“tuning-done”` signal

The `“tuning-fail”` signal

The `“tuning-start”` signal

The `“tune”` signal