[media] DocBook: document SDR transmitter
authorAntti Palosaari <crope@iki.fi>
Sat, 10 Oct 2015 16:51:01 +0000 (13:51 -0300)
committerMauro Carvalho Chehab <mchehab@osg.samsung.com>
Tue, 20 Oct 2015 17:42:01 +0000 (15:42 -0200)
Add documentation for V4L SDR transmitter (output) devices.

Signed-off-by: Antti Palosaari <crope@iki.fi>
Signed-off-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
Documentation/DocBook/media/v4l/compat.xml
Documentation/DocBook/media/v4l/dev-sdr.xml
Documentation/DocBook/media/v4l/io.xml
Documentation/DocBook/media/v4l/pixfmt.xml
Documentation/DocBook/media/v4l/v4l2.xml
Documentation/DocBook/media/v4l/vidioc-g-fmt.xml
Documentation/DocBook/media/v4l/vidioc-querycap.xml

index 6c4e95146d160b4a3db5f570750ded0c39e0c5fc..5701a08ed792dae2cf3fdbd5a8a8bda4fe29cc2d 100644 (file)
@@ -2604,6 +2604,10 @@ and &v4l2-mbus-framefmt;.
          <para>Added <constant>V4L2_CID_RF_TUNER_RF_GAIN</constant>
 RF Tuner control.</para>
        </listitem>
+       <listitem>
+         <para>Added transmitter support for Software Defined Radio (SDR)
+Interface.</para>
+       </listitem>
       </orderedlist>
     </section>
 
index 3344921354e8c3d6dd308b8811f4797a582d696e..a659771f7b7cca90feb6e22958d1e480e881d084 100644 (file)
@@ -28,6 +28,16 @@ Devices supporting the SDR receiver interface set the
 <structfield>capabilities</structfield> field of &v4l2-capability;
 returned by the &VIDIOC-QUERYCAP; ioctl. That flag means the device has an
 Analog to Digital Converter (ADC), which is a mandatory element for the SDR receiver.
+    </para>
+    <para>
+Devices supporting the SDR transmitter interface set the
+<constant>V4L2_CAP_SDR_OUTPUT</constant> and
+<constant>V4L2_CAP_MODULATOR</constant> flag in the
+<structfield>capabilities</structfield> field of &v4l2-capability;
+returned by the &VIDIOC-QUERYCAP; ioctl. That flag means the device has an
+Digital to Analog Converter (DAC), which is a mandatory element for the SDR transmitter.
+    </para>
+    <para>
 At least one of the read/write, streaming or asynchronous I/O methods must
 be supported.
     </para>
@@ -39,14 +49,15 @@ be supported.
     <para>
 SDR devices can support <link linkend="control">controls</link>, and must
 support the <link linkend="tuner">tuner</link> ioctls. Tuner ioctls are used
-for setting the ADC sampling rate (sampling frequency) and the possible RF tuner
-frequency.
+for setting the ADC/DAC sampling rate (sampling frequency) and the possible
+radio frequency (RF).
     </para>
 
     <para>
-The <constant>V4L2_TUNER_SDR</constant> tuner type is used for SDR tuners, and
-the <constant>V4L2_TUNER_RF</constant> tuner type is used for RF tuners. The
-tuner index of the RF tuner (if any) must always follow the SDR tuner index.
+The <constant>V4L2_TUNER_SDR</constant> tuner type is used for setting SDR
+device ADC/DAC frequency, and the <constant>V4L2_TUNER_RF</constant>
+tuner type is used for setting radio frequency.
+The tuner index of the RF tuner (if any) must always follow the SDR tuner index.
 Normally the SDR tuner is #0 and the RF tuner is #1.
     </para>
 
@@ -59,9 +70,9 @@ The &VIDIOC-S-HW-FREQ-SEEK; ioctl is not supported.
     <title>Data Format Negotiation</title>
 
     <para>
-The SDR capture device uses the <link linkend="format">format</link> ioctls to
-select the capture format. Both the sampling resolution and the data streaming
-format are bound to that selectable format. In addition to the basic
+The SDR device uses the <link linkend="format">format</link> ioctls to
+select the capture and output format. Both the sampling resolution and the data
+streaming format are bound to that selectable format. In addition to the basic
 <link linkend="format">format</link> ioctls, the &VIDIOC-ENUM-FMT; ioctl
 must be supported as well.
     </para>
@@ -69,7 +80,8 @@ must be supported as well.
     <para>
 To use the <link linkend="format">format</link> ioctls applications set the
 <structfield>type</structfield> field of a &v4l2-format; to
-<constant>V4L2_BUF_TYPE_SDR_CAPTURE</constant> and use the &v4l2-sdr-format;
+<constant>V4L2_BUF_TYPE_SDR_CAPTURE</constant> or
+<constant>V4L2_BUF_TYPE_SDR_OUTPUT</constant> and use the &v4l2-sdr-format;
 <structfield>sdr</structfield> member of the <structfield>fmt</structfield>
 union as needed per the desired operation.
 Currently there is two fields, <structfield>pixelformat</structfield> and
index 7bbc2a48911ea26b876f2ed92ab70d881e5c38e1..da654031ef3fd82d5ec73c56ad65af38e131e0f3 100644 (file)
@@ -1006,8 +1006,14 @@ must set this to 0.</entry>
          <row>
            <entry><constant>V4L2_BUF_TYPE_SDR_CAPTURE</constant></entry>
            <entry>11</entry>
-           <entry>Buffer for Software Defined Radio (SDR), see <xref
-               linkend="sdr" />.</entry>
+           <entry>Buffer for Software Defined Radio (SDR) capture stream, see
+               <xref linkend="sdr" />.</entry>
+         </row>
+         <row>
+           <entry><constant>V4L2_BUF_TYPE_SDR_OUTPUT</constant></entry>
+           <entry>12</entry>
+           <entry>Buffer for Software Defined Radio (SDR) output stream, see
+               <xref linkend="sdr" />.</entry>
          </row>
        </tbody>
       </tgroup>
index 70cd0fd02e12dfe19f1af77833df2a3411901b9f..d871245d29735a0084ea422539a0dc23f106ca10 100644 (file)
@@ -1732,7 +1732,7 @@ extended control <constant>V4L2_CID_MPEG_STREAM_TYPE</constant>, see
   <section id="sdr-formats">
     <title>SDR Formats</title>
 
-    <para>These formats are used for <link linkend="sdr">SDR Capture</link>
+    <para>These formats are used for <link linkend="sdr">SDR</link>
 interface only.</para>
 
     &sub-sdr-cu08;
index 9cc4117644fc8ba54ac4cec515dcd51e8ae4e1de..0ceea3f5bf3a6143be017221d90cb16875c6847c 100644 (file)
@@ -157,6 +157,7 @@ applications. -->
        <authorinitials>ap</authorinitials>
        <revremark>Renamed V4L2_TUNER_ADC to V4L2_TUNER_SDR.
 Added V4L2_CID_RF_TUNER_RF_GAIN control.
+Added transmitter support for Software Defined Radio (SDR) Interface.
        </revremark>
       </revision>
 
index 4fe19a7a9a31efa3b2628e683853ef295ccf7932..ffcb448251f048a505045d4f8170a2bea2b0ab64 100644 (file)
@@ -175,7 +175,7 @@ capture and output devices.</entry>
            <entry>&v4l2-sdr-format;</entry>
            <entry><structfield>sdr</structfield></entry>
            <entry>Definition of a data format, see
-<xref linkend="pixfmt" />, used by SDR capture devices.</entry>
+<xref linkend="pixfmt" />, used by SDR capture and output devices.</entry>
          </row>
          <row>
            <entry></entry>
index 20fda75a012dc130e8a94b1935d5efe574a5dae3..cd82148dedd7ddb922c5156e7792b8735af32d4b 100644 (file)
@@ -306,6 +306,12 @@ modulator programming see
            <entry>0x00200000</entry>
            <entry>The device supports the &v4l2-pix-format; extended
 fields.</entry>
+         </row>
+         <row>
+           <entry><constant>V4L2_CAP_SDR_OUTPUT</constant></entry>
+           <entry>0x00400000</entry>
+           <entry>The device supports the
+<link linkend="sdr">SDR Output</link> interface.</entry>
          </row>
          <row>
            <entry><constant>V4L2_CAP_READWRITE</constant></entry>