[media] DocBook: Multistream support

Document the multistream support at the DVBAPI, describing
what delivery systems currently support it (DVB-T2, DVB-S2,
ISDB-S).

DVBAPI version increased to 5.8.

[mchehab@redhat.com: Made some corrections - mostly language]
Signed-off-by: Evgeny Plehov <EvgenyPlehov@ukr.net>
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>

diff --git a/Documentation/DocBook/media/dvb/dvbapi.xml b/Documentation/DocBook/media/dvb/dvbapi.xml
index d36f8f93c4ff0c01939b96b2d25631858099b0fe..757488b24f4f2518898f13f55de57e9d708fa575 100644 (file)
--- a/Documentation/DocBook/media/dvb/dvbapi.xml
+++ b/Documentation/DocBook/media/dvb/dvbapi.xml
@@ -84,7 +84,7 @@ Added ISDB-T test originally written by Patrick Boettcher
 
 
 <title>LINUX DVB API</title>
-<subtitle>Version 5.2</subtitle>
+<subtitle>Version 5.8</subtitle>
 <!-- ADD THE CHAPTERS HERE -->
   <chapter id="dvb_introdution">
     &sub-intro;

diff --git a/Documentation/DocBook/media/dvb/dvbproperty.xml b/Documentation/DocBook/media/dvb/dvbproperty.xml
index d188be963a47c8a6bf46ede5bb9503bdb0cc06e9..3eebdac31f94e8e51702e0b8754287b3b372ad7a 100644 (file)
--- a/Documentation/DocBook/media/dvb/dvbproperty.xml
+++ b/Documentation/DocBook/media/dvb/dvbproperty.xml
@@ -793,15 +793,26 @@ typedef enum fe_hierarchy {
  } fe_hierarchy_t;
        </programlisting>
        </section>
-       <section id="DTV-ISDBS-TS-ID">
-       <title><constant>DTV_ISDBS_TS_ID</constant></title>
-       <para>Currently unused.</para>
+       <section id="DTV-STREAM-ID">
+       <title><constant>DTV_STREAM_ID</constant></title>
+       <para>DVB-S2, DVB-T2 and ISDB-S support the transmission of several
+             streams on a single transport stream.
+             This property enables the DVB driver to handle substream filtering,
+             when supported by the hardware.
+             By default, substream filtering is disabled.
+       </para><para>
+             For DVB-S2 and DVB-T2, the valid substream id range is from 0 to 255.
+       </para><para>
+             For ISDB, the valid substream id range is from 1 to 65535.
+       </para><para>
+             To disable it, you should use the special macro NO_STREAM_ID_FILTER.
+       </para><para>
+             Note: any value outside the id range also disables filtering.
+       </para>
        </section>
-       <section id="DTV-DVBT2-PLP-ID">
-               <title><constant>DTV_DVBT2_PLP_ID</constant></title>
-               <para>DVB-T2 supports Physical Layer Pipes (PLP) to allow transmission of
-                       many data types via a single multiplex. The API will soon support this
-                       at which point this section will be expanded.</para>
+       <section id="DTV-DVBT2-PLP-ID-LEGACY">
+               <title><constant>DTV_DVBT2_PLP_ID_LEGACY</constant></title>
+               <para>Obsolete, replaced with DTV_STREAM_ID.</para>
        </section>
        <section id="DTV-ENUM-DELSYS">
                <title><constant>DTV_ENUM_DELSYS</constant></title>
@@ -869,7 +880,7 @@ enum fe_interleaving {
                        <listitem><para><link linkend="DTV-GUARD-INTERVAL"><constant>DTV_GUARD_INTERVAL</constant></link></para></listitem>
                        <listitem><para><link linkend="DTV-TRANSMISSION-MODE"><constant>DTV_TRANSMISSION_MODE</constant></link></para></listitem>
                        <listitem><para><link linkend="DTV-HIERARCHY"><constant>DTV_HIERARCHY</constant></link></para></listitem>
-                       <listitem><para><link linkend="DTV-DVBT2-PLP-ID"><constant>DTV_DVBT2_PLP_ID</constant></link></para></listitem>
+                       <listitem><para><link linkend="DTV-STREAM-ID"><constant>DTV_STREAM_ID</constant></link></para></listitem>
                </itemizedlist>
                </section>
                <section id="isdbt">
@@ -1048,6 +1059,7 @@ enum fe_interleaving {
                        <listitem><para><link linkend="DTV-MODULATION"><constant>DTV_MODULATION</constant></link></para></listitem>
                        <listitem><para><link linkend="DTV-PILOT"><constant>DTV_PILOT</constant></link></para></listitem>
                        <listitem><para><link linkend="DTV-ROLLOFF"><constant>DTV_ROLLOFF</constant></link></para></listitem>
+                       <listitem><para><link linkend="DTV-STREAM-ID"><constant>DTV_STREAM_ID</constant></link></para></listitem>
                </itemizedlist>
        </section>
        <section id="turbo-params">
@@ -1070,7 +1082,7 @@ enum fe_interleaving {
                        <listitem><para><link linkend="DTV-SYMBOL-RATE"><constant>DTV_SYMBOL_RATE</constant></link></para></listitem>
                        <listitem><para><link linkend="DTV-INNER-FEC"><constant>DTV_INNER_FEC</constant></link></para></listitem>
                        <listitem><para><link linkend="DTV-VOLTAGE"><constant>DTV_VOLTAGE</constant></link></para></listitem>
-                       <listitem><para><link linkend="DTV-ISDBS-TS-ID"><constant>DTV_ISDBS_TS_ID</constant></link></para></listitem>
+                       <listitem><para><link linkend="DTV-STREAM-ID"><constant>DTV_STREAM_ID</constant></link></para></listitem>
                </itemizedlist>
        </section>
        </section>

diff --git a/Documentation/DocBook/media/dvb/frontend.xml b/Documentation/DocBook/media/dvb/frontend.xml
index 950bdfb4504b4bfaed22063e9cd137dcc33a9a9e..426c2526a4546a5fcf8ec27561d14482fa91593e 100644 (file)
--- a/Documentation/DocBook/media/dvb/frontend.xml
+++ b/Documentation/DocBook/media/dvb/frontend.xml
@@ -101,6 +101,7 @@ a specific frontend type.</para>
        FE_CAN_8VSB                   = 0x200000,
        FE_CAN_16VSB                  = 0x400000,
        FE_HAS_EXTENDED_CAPS          = 0x800000,
+       FE_CAN_MULTISTREAM            = 0x4000000,
        FE_CAN_TURBO_FEC              = 0x8000000,
        FE_CAN_2G_MODULATION          = 0x10000000,
        FE_NEEDS_BENDING              = 0x20000000,

diff --git a/Documentation/DocBook/media/dvb/intro.xml b/Documentation/DocBook/media/dvb/intro.xml
index 170064a3dc8f4b3db90bb348331ec777074f84c2..2048b53d19b9e81b2a7e159dbde0ce63c1b51f98 100644 (file)
--- a/Documentation/DocBook/media/dvb/intro.xml
+++ b/Documentation/DocBook/media/dvb/intro.xml
@@ -205,7 +205,7 @@ a partial path like:</para>
 additional include file <emphasis
 role="tt">linux/dvb/version.h</emphasis> exists, which defines the
 constant <emphasis role="tt">DVB_API_VERSION</emphasis>. This document
-describes <emphasis role="tt">DVB_API_VERSION 5.4</emphasis>.
+describes <emphasis role="tt">DVB_API_VERSION 5.8</emphasis>.
 </para>
 
 </section>