[media] DocBook: move data types to a separate section
authorMauro Carvalho Chehab <mchehab@osg.samsung.com>
Sat, 12 Dec 2015 11:56:07 +0000 (09:56 -0200)
committerMauro Carvalho Chehab <mchehab@osg.samsung.com>
Mon, 11 Jan 2016 14:19:11 +0000 (12:19 -0200)
As MEDIA_IOC_G_TOPOLOGY shares the data types already declared
for entities, pads and links, we should move those to a separate
part of the document, and use cross-references where needed.

So, move the following tables to a separate section at the
DocBook:
media-entity-type
media-entity-flag
media-pad-flag
media-link-flag

Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
Documentation/DocBook/media/v4l/media-controller.xml
Documentation/DocBook/media/v4l/media-ioc-enum-entities.xml
Documentation/DocBook/media/v4l/media-ioc-enum-links.xml
Documentation/DocBook/media/v4l/media-types.xml [new file with mode: 0644]

index def4a27aadef4413f2299350bf126e0d0477a1f0..63d48decaa6f1d5158a6c3620539eecc0e752a61 100644 (file)
@@ -85,6 +85,9 @@
     Kernel interface and an entity.m</para></listitem>
     </itemizedlist>
   </section>
+
+  <!-- All non-ioctl specific data types go here. -->
+  &sub-media-types;
 </chapter>
 
 <appendix id="media-user-func">
index 9f7614a012342f58fd2126f5b57ffdd2df67f1c5..0c4f96bfc2defe8c6b0dedb55b6194f6f06cd17b 100644 (file)
        </tbody>
       </tgroup>
     </table>
-
-    <table frame="none" pgwide="1" id="media-entity-type">
-      <title>Media entity types</title>
-      <tgroup cols="2">
-        <colspec colname="c1"/>
-        <colspec colname="c2"/>
-       <tbody valign="top">
-         <row>
-           <entry><constant>MEDIA_ENT_F_UNKNOWN</constant> and <constant>MEDIA_ENT_F_V4L2_SUBDEV_UNKNOWN</constant></entry>
-           <entry>Unknown entity. That generally indicates that
-           a driver didn't initialize properly the entity, with is a Kernel bug</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_IO_V4L</constant></entry>
-           <entry>Data streaming input and/or output entity.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_IO_VBI</constant></entry>
-           <entry>V4L VBI streaming input or output entity</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_IO_SWRADIO</constant></entry>
-           <entry>V4L Software Digital Radio (SDR) streaming input or output entity</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_IO_DTV</constant></entry>
-           <entry>DVB Digital TV streaming input or output entity</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_DTV_DEMOD</constant></entry>
-           <entry>Digital TV demodulator entity.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_MPEG_TS_DEMUX</constant></entry>
-           <entry>MPEG Transport stream demux entity. Could be implemented on hardware or in Kernelspace by the Linux DVB subsystem.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_DTV_CA</constant></entry>
-           <entry>Digital TV Conditional Access module (CAM) entity</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_DTV_NET_DECAP</constant></entry>
-           <entry>Digital TV network ULE/MLE desencapsulation entity. Could be implemented on hardware or in Kernelspace</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_CONN_RF</constant></entry>
-           <entry>Connector for a Radio Frequency (RF) signal.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_CONN_SVIDEO</constant></entry>
-           <entry>Connector for a S-Video signal.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_CONN_COMPOSITE</constant></entry>
-           <entry>Connector for a RGB composite signal.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_CONN_TEST</constant></entry>
-           <entry>Connector for a test generator.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_CAM_SENSOR</constant></entry>
-           <entry>Camera video sensor entity.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_FLASH</constant></entry>
-           <entry>Flash controller entity.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_LENS</constant></entry>
-           <entry>Lens controller entity.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_ATV_DECODER</constant></entry>
-           <entry>Analog video decoder, the basic function of the video decoder
-           is to accept analogue video from a wide variety of sources such as
-           broadcast, DVD players, cameras and video cassette recorders, in
-           either NTSC, PAL, SECAM or HD format, separating the stream
-           into its component parts, luminance and chrominance, and output
-           it in some digital video standard, with appropriate timing
-           signals.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_ENT_F_TUNER</constant></entry>
-           <entry>Digital TV, analog TV, radio and/or software radio tuner.</entry>
-         </row>
-       </tbody>
-      </tgroup>
-    </table>
-
-    <table frame="none" pgwide="1" id="media-entity-flag">
-      <title>Media entity flags</title>
-      <tgroup cols="2">
-        <colspec colname="c1"/>
-        <colspec colname="c2"/>
-       <tbody valign="top">
-         <row>
-           <entry><constant>MEDIA_ENT_FL_DEFAULT</constant></entry>
-           <entry>Default entity for its type. Used to discover the default
-           audio, VBI and video devices, the default camera sensor, ...</entry>
-         </row>
-       </tbody>
-      </tgroup>
-    </table>
   </refsect1>
 
   <refsect1>
index 74fb394ec6676295fbf5e46813aa0bec2b4fa108..2bbeea9f3e18c80ad8206b1bfed3d37705188c78 100644 (file)
       </tgroup>
     </table>
 
-    <table frame="none" pgwide="1" id="media-pad-flag">
-      <title>Media pad flags</title>
-      <tgroup cols="2">
-        <colspec colname="c1"/>
-        <colspec colname="c2"/>
-       <tbody valign="top">
-         <row>
-           <entry><constant>MEDIA_PAD_FL_SINK</constant></entry>
-           <entry>Input pad, relative to the entity. Input pads sink data and
-           are targets of links.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_PAD_FL_SOURCE</constant></entry>
-           <entry>Output pad, relative to the entity. Output pads source data
-           and are origins of links.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_PAD_FL_MUST_CONNECT</constant></entry>
-           <entry>If this flag is set and the pad is linked to any other
-           pad, then at least one of those links must be enabled for the
-           entity to be able to stream. There could be temporary reasons
-           (e.g. device configuration dependent) for the pad to need
-           enabled links even when this flag isn't set; the absence of the
-           flag doesn't imply there is none.</entry>
-         </row>
-       </tbody>
-      </tgroup>
-    </table>
-
     <table pgwide="1" frame="none" id="media-link-desc">
       <title>struct <structname>media_link_desc</structname></title>
       <tgroup cols="3">
       </tgroup>
     </table>
 
-    <table frame="none" pgwide="1" id="media-link-flag">
-      <title>Media link flags</title>
-      <tgroup cols="2">
-        <colspec colname="c1"/>
-        <colspec colname="c2"/>
-       <tbody valign="top">
-         <row>
-           <entry><constant>MEDIA_LNK_FL_ENABLED</constant></entry>
-           <entry>The link is enabled and can be used to transfer media data.
-           When two or more links target a sink pad, only one of them can be
-           enabled at a time.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_LNK_FL_IMMUTABLE</constant></entry>
-           <entry>The link enabled state can't be modified at runtime. An
-           immutable link is always enabled.</entry>
-         </row>
-         <row>
-           <entry><constant>MEDIA_LNK_FL_DYNAMIC</constant></entry>
-           <entry>The link enabled state can be modified during streaming. This
-           flag is set by drivers and is read-only for applications.</entry>
-         </row>
-       </tbody>
-      </tgroup>
-    </table>
-    <para>One and only one of <constant>MEDIA_PAD_FL_SINK</constant> and
-    <constant>MEDIA_PAD_FL_SOURCE</constant> must be set for every pad.</para>
   </refsect1>
 
   <refsect1>
diff --git a/Documentation/DocBook/media/v4l/media-types.xml b/Documentation/DocBook/media/v4l/media-types.xml
new file mode 100644 (file)
index 0000000..0c5c9c0
--- /dev/null
@@ -0,0 +1,166 @@
+<section id="media-controller-types">
+<title>Types and flags used to represent the media graph elements</title>
+
+    <table frame="none" pgwide="1" id="media-entity-type">
+      <title>Media entity types</title>
+      <tgroup cols="2">
+       <colspec colname="c1"/>
+       <colspec colname="c2"/>
+       <tbody valign="top">
+         <row>
+           <entry><constant>MEDIA_ENT_F_UNKNOWN</constant> and <constant>MEDIA_ENT_F_V4L2_SUBDEV_UNKNOWN</constant></entry>
+           <entry>Unknown entity. That generally indicates that
+           a driver didn't initialize properly the entity, with is a Kernel bug</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_IO_V4L</constant></entry>
+           <entry>Data streaming input and/or output entity.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_IO_VBI</constant></entry>
+           <entry>V4L VBI streaming input or output entity</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_IO_SWRADIO</constant></entry>
+           <entry>V4L Software Digital Radio (SDR) streaming input or output entity</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_IO_DTV</constant></entry>
+           <entry>DVB Digital TV streaming input or output entity</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_DTV_DEMOD</constant></entry>
+           <entry>Digital TV demodulator entity.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_MPEG_TS_DEMUX</constant></entry>
+           <entry>MPEG Transport stream demux entity. Could be implemented on hardware or in Kernelspace by the Linux DVB subsystem.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_DTV_CA</constant></entry>
+           <entry>Digital TV Conditional Access module (CAM) entity</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_DTV_NET_DECAP</constant></entry>
+           <entry>Digital TV network ULE/MLE desencapsulation entity. Could be implemented on hardware or in Kernelspace</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_CONN_RF</constant></entry>
+           <entry>Connector for a Radio Frequency (RF) signal.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_CONN_SVIDEO</constant></entry>
+           <entry>Connector for a S-Video signal.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_CONN_COMPOSITE</constant></entry>
+           <entry>Connector for a RGB composite signal.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_CONN_TEST</constant></entry>
+           <entry>Connector for a test generator.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_CAM_SENSOR</constant></entry>
+           <entry>Camera video sensor entity.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_FLASH</constant></entry>
+           <entry>Flash controller entity.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_LENS</constant></entry>
+           <entry>Lens controller entity.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_ATV_DECODER</constant></entry>
+           <entry>Analog video decoder, the basic function of the video decoder
+           is to accept analogue video from a wide variety of sources such as
+           broadcast, DVD players, cameras and video cassette recorders, in
+           either NTSC, PAL, SECAM or HD format, separating the stream
+           into its component parts, luminance and chrominance, and output
+           it in some digital video standard, with appropriate timing
+           signals.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_ENT_F_TUNER</constant></entry>
+           <entry>Digital TV, analog TV, radio and/or software radio tuner.</entry>
+         </row>
+       </tbody>
+      </tgroup>
+    </table>
+
+    <table frame="none" pgwide="1" id="media-entity-flag">
+      <title>Media entity flags</title>
+      <tgroup cols="2">
+       <colspec colname="c1"/>
+       <colspec colname="c2"/>
+       <tbody valign="top">
+         <row>
+           <entry><constant>MEDIA_ENT_FL_DEFAULT</constant></entry>
+           <entry>Default entity for its type. Used to discover the default
+           audio, VBI and video devices, the default camera sensor, ...</entry>
+         </row>
+       </tbody>
+      </tgroup>
+    </table>
+
+    <table frame="none" pgwide="1" id="media-pad-flag">
+      <title>Media pad flags</title>
+      <tgroup cols="2">
+       <colspec colname="c1"/>
+       <colspec colname="c2"/>
+       <tbody valign="top">
+         <row>
+           <entry><constant>MEDIA_PAD_FL_SINK</constant></entry>
+           <entry>Input pad, relative to the entity. Input pads sink data and
+           are targets of links.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_PAD_FL_SOURCE</constant></entry>
+           <entry>Output pad, relative to the entity. Output pads source data
+           and are origins of links.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_PAD_FL_MUST_CONNECT</constant></entry>
+           <entry>If this flag is set and the pad is linked to any other
+           pad, then at least one of those links must be enabled for the
+           entity to be able to stream. There could be temporary reasons
+           (e.g. device configuration dependent) for the pad to need
+           enabled links even when this flag isn't set; the absence of the
+           flag doesn't imply there is none.</entry>
+         </row>
+       </tbody>
+      </tgroup>
+    </table>
+
+    <para>One and only one of <constant>MEDIA_PAD_FL_SINK</constant> and
+    <constant>MEDIA_PAD_FL_SOURCE</constant> must be set for every pad.</para>
+
+    <table frame="none" pgwide="1" id="media-link-flag">
+      <title>Media link flags</title>
+      <tgroup cols="2">
+       <colspec colname="c1"/>
+       <colspec colname="c2"/>
+       <tbody valign="top">
+         <row>
+           <entry><constant>MEDIA_LNK_FL_ENABLED</constant></entry>
+           <entry>The link is enabled and can be used to transfer media data.
+           When two or more links target a sink pad, only one of them can be
+           enabled at a time.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_LNK_FL_IMMUTABLE</constant></entry>
+           <entry>The link enabled state can't be modified at runtime. An
+           immutable link is always enabled.</entry>
+         </row>
+         <row>
+           <entry><constant>MEDIA_LNK_FL_DYNAMIC</constant></entry>
+           <entry>The link enabled state can be modified during streaming. This
+           flag is set by drivers and is read-only for applications.</entry>
+         </row>
+       </tbody>
+      </tgroup>
+    </table>
+
+</section>