## 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

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

    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