[media] DocBook: improve documentation for DVB spectral inversion
Format it as a table and provide more details. Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
This commit is contained in:
parent
01f18d9633
commit
58e11cc3c1
|
@ -238,19 +238,45 @@ get/set up to 64 properties. The actual meaning of each property is described on
|
|||
</section>
|
||||
<section id="DTV-INVERSION">
|
||||
<title><constant>DTV_INVERSION</constant></title>
|
||||
<para>The Inversion field can take one of these values:
|
||||
</para>
|
||||
<programlisting>
|
||||
typedef enum fe_spectral_inversion {
|
||||
INVERSION_OFF,
|
||||
INVERSION_ON,
|
||||
INVERSION_AUTO
|
||||
} fe_spectral_inversion_t;
|
||||
</programlisting>
|
||||
<para>It indicates if spectral inversion should be presumed or not. In the automatic setting
|
||||
(<constant>INVERSION_AUTO</constant>) the hardware will try to figure out the correct setting by
|
||||
itself.
|
||||
</para>
|
||||
|
||||
<para>Specifies if the frontend should do spectral inversion or not.</para>
|
||||
|
||||
<section id="fe-spectral-inversion-t">
|
||||
<title>enum fe_modulation: Frontend spectral inversion</title>
|
||||
|
||||
<para>This parameter indicates if spectral inversion should be presumed or not.
|
||||
In the automatic setting (<constant>INVERSION_AUTO</constant>) the hardware
|
||||
will try to figure out the correct setting by itself. If the hardware
|
||||
doesn't support, the DVB core will try to lock at the carrier first with
|
||||
inversion off. If it fails, it will try to enable inversion.
|
||||
</para>
|
||||
|
||||
<table pgwide="1" frame="none" id="fe-spectral-inversion">
|
||||
<title>enum fe_modulation</title>
|
||||
<tgroup cols="2">
|
||||
&cs-def;
|
||||
<thead>
|
||||
<row>
|
||||
<entry>ID</entry>
|
||||
<entry>Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody valign="top">
|
||||
<row>
|
||||
<entry>INVERSION_OFF</entry>
|
||||
<entry>Don't do spectral band inversion.</entry>
|
||||
</row><row>
|
||||
<entry>INVERSION_ON</entry>
|
||||
<entry>Do spectral band inversion.</entry>
|
||||
</row><row>
|
||||
<entry>INVERSION_AUTO</entry>
|
||||
<entry>Autodetect spectral band inversion.</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</table>
|
||||
</section>
|
||||
|
||||
</section>
|
||||
<section id="DTV-DISEQC-MASTER">
|
||||
<title><constant>DTV_DISEQC_MASTER</constant></title>
|
||||
|
|
|
@ -56,23 +56,6 @@ specification is available at
|
|||
|
||||
&sub-dvbproperty;
|
||||
|
||||
<section id="fe-spectral-inversion-t">
|
||||
<title>frontend spectral inversion</title>
|
||||
<para>The Inversion field can take one of these values:
|
||||
</para>
|
||||
<programlisting>
|
||||
typedef enum fe_spectral_inversion {
|
||||
INVERSION_OFF,
|
||||
INVERSION_ON,
|
||||
INVERSION_AUTO
|
||||
} fe_spectral_inversion_t;
|
||||
</programlisting>
|
||||
<para>It indicates if spectral inversion should be presumed or not. In the automatic setting
|
||||
(<constant>INVERSION_AUTO</constant>) the hardware will try to figure out the correct setting by
|
||||
itself.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
<section id="fe-code-rate-t">
|
||||
<title>frontend code rate</title>
|
||||
<para>The possible values for the <constant>fec_inner</constant> field used on
|
||||
|
|
|
@ -82,7 +82,7 @@ DVB-C2, ISDB, etc.</para>
|
|||
struct dvb_frontend_parameters {
|
||||
uint32_t frequency; /⋆ (absolute) frequency in Hz for QAM/OFDM ⋆/
|
||||
/⋆ intermediate frequency in kHz for QPSK ⋆/
|
||||
fe_spectral_inversion_t inversion;
|
||||
&fe-spectral-inversion-t; inversion;
|
||||
union {
|
||||
struct dvb_qpsk_parameters qpsk;
|
||||
struct dvb_qam_parameters qam;
|
||||
|
|
|
@ -154,12 +154,13 @@ enum fe_status {
|
|||
|
||||
typedef enum fe_status fe_status_t;
|
||||
|
||||
typedef enum fe_spectral_inversion {
|
||||
enum fe_spectral_inversion {
|
||||
INVERSION_OFF,
|
||||
INVERSION_ON,
|
||||
INVERSION_AUTO
|
||||
} fe_spectral_inversion_t;
|
||||
};
|
||||
|
||||
typedef enum fe_spectral_inversion fe_spectral_inversion_t;
|
||||
|
||||
typedef enum fe_code_rate {
|
||||
FEC_NONE = 0,
|
||||
|
|
Loading…
Reference in New Issue