dvbsrc

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

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

1
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.

1
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.

1
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.

1
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