2018-08-30 08:15:26 -06:00
|
|
|
.. Permission is granted to copy, distribute and/or modify this
|
|
|
|
.. document under the terms of the GNU Free Documentation License,
|
|
|
|
.. Version 1.1 or any later version published by the Free Software
|
|
|
|
.. Foundation, with no Invariant Sections, no Front-Cover Texts
|
|
|
|
.. and no Back-Cover Texts. A copy of the license is included at
|
|
|
|
.. Documentation/media/uapi/fdl-appendix.rst.
|
|
|
|
..
|
|
|
|
.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections
|
|
|
|
|
2016-06-30 07:18:56 -06:00
|
|
|
*************
|
|
|
|
Frontend type
|
|
|
|
*************
|
|
|
|
|
|
|
|
For historical reasons, frontend types are named by the type of
|
|
|
|
modulation used in transmission. The fontend types are given by
|
|
|
|
fe_type_t type, defined as:
|
|
|
|
|
|
|
|
|
2016-08-30 07:21:03 -06:00
|
|
|
.. c:type:: fe_type
|
2016-06-30 07:18:56 -06:00
|
|
|
|
[media] docs-rst: add tabularcolumns to all tables
LaTeX doesn't handle too well auto-width on tables, and ReST
markup requires an special tag to give it the needed hints.
As we're using A4 paper, we have 17cm of useful spaces. As
most media tables have widths, let's use it to generate the
needed via the following perl script:
my ($line_size, $table_header, $has_cols) = (17.5, 0, 0);
my $out;
my $header = "";
my @widths = ();
sub round { $_[0] > 0 ? int($_[0] + .5) : -int(-$_[0] + .5) }
while (<>) {
if (!$table_header) {
$has_cols = 1 if (m/..\s+tabularcolumns::/);
if (m/..\s+flat-table::/) {
$table_header = 1;
$header = $_;
next;
}
$out .= $_;
next;
}
$header .= $_;
@widths = split(/ /, $1) if (m/:widths:\s+(.*)/);
if (m/^\n$/) {
if (!$has_cols && @widths) {
my ($tot, $t, $i) = (0, 0, 0);
foreach my $v(@widths) { $tot += $v; };
$out .= ".. tabularcolumns:: |";
for ($i = 0; $i < scalar @widths - 1; $i++) {
my $v = $widths[$i];
my $w = round(10 * ($v * $line_size) / $tot) / 10;
$out .= sprintf "p{%.1fcm}|", $w;
$t += $w;
}
my $w = $line_size - $t;
$out .= sprintf "p{%.1fcm}|\n\n", $w;
}
$out .= $header;
$table_header = 0;
$has_cols = 0;
$header = "";
@widths = ();
}
}
print $out;
Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
2016-08-17 05:14:19 -06:00
|
|
|
.. tabularcolumns:: |p{6.6cm}|p{2.2cm}|p{8.7cm}|
|
|
|
|
|
2016-06-30 07:18:56 -06:00
|
|
|
.. flat-table:: Frontend types
|
|
|
|
:header-rows: 1
|
|
|
|
:stub-columns: 0
|
|
|
|
:widths: 3 1 4
|
|
|
|
|
|
|
|
|
|
|
|
- .. row 1
|
|
|
|
|
|
|
|
- fe_type
|
|
|
|
|
|
|
|
- Description
|
|
|
|
|
|
|
|
- :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>` equivalent
|
2016-07-04 13:25:48 -06:00
|
|
|
type
|
2016-06-30 07:18:56 -06:00
|
|
|
|
|
|
|
- .. row 2
|
|
|
|
|
2016-07-07 12:53:44 -06:00
|
|
|
- .. _FE-QPSK:
|
2016-06-30 07:18:56 -06:00
|
|
|
|
2016-07-04 13:25:48 -06:00
|
|
|
``FE_QPSK``
|
2016-06-30 07:18:56 -06:00
|
|
|
|
|
|
|
- For DVB-S standard
|
|
|
|
|
|
|
|
- ``SYS_DVBS``
|
|
|
|
|
|
|
|
- .. row 3
|
|
|
|
|
2016-07-07 12:53:44 -06:00
|
|
|
- .. _FE-QAM:
|
2016-06-30 07:18:56 -06:00
|
|
|
|
2016-07-04 13:25:48 -06:00
|
|
|
``FE_QAM``
|
2016-06-30 07:18:56 -06:00
|
|
|
|
|
|
|
- For DVB-C annex A standard
|
|
|
|
|
|
|
|
- ``SYS_DVBC_ANNEX_A``
|
|
|
|
|
|
|
|
- .. row 4
|
|
|
|
|
2016-07-07 12:53:44 -06:00
|
|
|
- .. _FE-OFDM:
|
2016-06-30 07:18:56 -06:00
|
|
|
|
2016-07-04 13:25:48 -06:00
|
|
|
``FE_OFDM``
|
2016-06-30 07:18:56 -06:00
|
|
|
|
|
|
|
- For DVB-T standard
|
|
|
|
|
|
|
|
- ``SYS_DVBT``
|
|
|
|
|
|
|
|
- .. row 5
|
|
|
|
|
2016-07-07 12:53:44 -06:00
|
|
|
- .. _FE-ATSC:
|
2016-06-30 07:18:56 -06:00
|
|
|
|
2016-07-04 13:25:48 -06:00
|
|
|
``FE_ATSC``
|
2016-06-30 07:18:56 -06:00
|
|
|
|
|
|
|
- For ATSC standard (terrestrial) or for DVB-C Annex B (cable) used
|
2016-07-04 13:25:48 -06:00
|
|
|
in US.
|
2016-06-30 07:18:56 -06:00
|
|
|
|
|
|
|
- ``SYS_ATSC`` (terrestrial) or ``SYS_DVBC_ANNEX_B`` (cable)
|
|
|
|
|
|
|
|
|
|
|
|
Newer formats like DVB-S2, ISDB-T, ISDB-S and DVB-T2 are not described
|
|
|
|
at the above, as they're supported via the new
|
|
|
|
:ref:`FE_GET_PROPERTY/FE_GET_SET_PROPERTY <FE_GET_PROPERTY>`
|
|
|
|
ioctl's, using the :ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>`
|
|
|
|
parameter.
|
|
|
|
|
2016-08-29 14:37:59 -06:00
|
|
|
In the old days, struct :c:type:`dvb_frontend_info`
|
2016-06-30 07:18:56 -06:00
|
|
|
used to contain ``fe_type_t`` field to indicate the delivery systems,
|
2017-09-01 10:21:49 -06:00
|
|
|
filled with either ``FE_QPSK, FE_QAM, FE_OFDM`` or ``FE_ATSC``. While this
|
2016-06-30 07:18:56 -06:00
|
|
|
is still filled to keep backward compatibility, the usage of this field
|
|
|
|
is deprecated, as it can report just one delivery system, but some
|
|
|
|
devices support multiple delivery systems. Please use
|
|
|
|
:ref:`DTV_ENUM_DELSYS <DTV-ENUM-DELSYS>` instead.
|
|
|
|
|
|
|
|
On devices that support multiple delivery systems, struct
|
2016-08-29 14:37:59 -06:00
|
|
|
:c:type:`dvb_frontend_info`::``fe_type_t`` is
|
2016-06-30 07:18:56 -06:00
|
|
|
filled with the currently standard, as selected by the last call to
|
|
|
|
:ref:`FE_SET_PROPERTY <FE_GET_PROPERTY>` using the
|
|
|
|
:ref:`DTV_DELIVERY_SYSTEM <DTV-DELIVERY-SYSTEM>` property.
|