[media] DocBook: document 1 Hz flag
authorAntti Palosaari <crope@iki.fi>
Thu, 19 Dec 2013 02:40:49 +0000 (23:40 -0300)
committerMauro Carvalho Chehab <m.chehab@samsung.com>
Wed, 5 Mar 2014 17:16:12 +0000 (14:16 -0300)
Update documentation to reflect 1 Hz frequency step flag.

Cc: Hans Verkuil <hverkuil@xs4all.nl>
Signed-off-by: Antti Palosaari <crope@iki.fi>
Acked-by: Hans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: Mauro Carvalho Chehab <m.chehab@samsung.com>
Documentation/DocBook/media/v4l/vidioc-enum-freq-bands.xml
Documentation/DocBook/media/v4l/vidioc-g-frequency.xml
Documentation/DocBook/media/v4l/vidioc-g-modulator.xml
Documentation/DocBook/media/v4l/vidioc-g-tuner.xml
Documentation/DocBook/media/v4l/vidioc-s-hw-freq-seek.xml

index 6541ba0175eddbe1078c47778a646c3bb7dd0f1b..4e8ea65f7282257f3f72d95de5f1439d2b3023e2 100644 (file)
@@ -100,7 +100,7 @@ See <xref linkend="v4l2-tuner-type" /></entry>
            <entry><structfield>capability</structfield></entry>
            <entry spanname="hspan">The tuner/modulator capability flags for
 this frequency band, see <xref linkend="tuner-capability" />. The <constant>V4L2_TUNER_CAP_LOW</constant>
-capability must be the same for all frequency bands of the selected tuner/modulator.
+or <constant>V4L2_TUNER_CAP_1HZ</constant> capability must be the same for all frequency bands of the selected tuner/modulator.
 So either all bands have that capability set, or none of them have that capability.</entry>
          </row>
          <row>
@@ -109,7 +109,8 @@ So either all bands have that capability set, or none of them have that capabili
            <entry spanname="hspan">The lowest tunable frequency in
 units of 62.5 kHz, or if the <structfield>capability</structfield>
 flag <constant>V4L2_TUNER_CAP_LOW</constant> is set, in units of 62.5
-Hz, for this frequency band.</entry>
+Hz, for this frequency band. A 1 Hz unit is used when the <structfield>capability</structfield> flag
+<constant>V4L2_TUNER_CAP_1HZ</constant> is set.</entry>
          </row>
          <row>
            <entry>__u32</entry>
@@ -117,7 +118,8 @@ Hz, for this frequency band.</entry>
            <entry spanname="hspan">The highest tunable frequency in
 units of 62.5 kHz, or if the <structfield>capability</structfield>
 flag <constant>V4L2_TUNER_CAP_LOW</constant> is set, in units of 62.5
-Hz, for this frequency band.</entry>
+Hz, for this frequency band. A 1 Hz unit is used when the <structfield>capability</structfield> flag
+<constant>V4L2_TUNER_CAP_1HZ</constant> is set.</entry>
          </row>
          <row>
            <entry>__u32</entry>
index c7a1c462e7243fe665dab4b5e4fbcb762765f874..d1034fb61d15f1ad5bb945d34cbcffed37e9599c 100644 (file)
@@ -109,9 +109,10 @@ See <xref linkend="v4l2-tuner-type" /></entry>
            <entry>__u32</entry>
            <entry><structfield>frequency</structfield></entry>
            <entry>Tuning frequency in units of 62.5 kHz, or if the
-&v4l2-tuner; or &v4l2-modulator; <structfield>capabilities</structfield> flag
+&v4l2-tuner; or &v4l2-modulator; <structfield>capability</structfield> flag
 <constant>V4L2_TUNER_CAP_LOW</constant> is set, in units of 62.5
-Hz.</entry>
+Hz. A 1 Hz unit is used when the <structfield>capability</structfield> flag
+<constant>V4L2_TUNER_CAP_1HZ</constant> is set.</entry>
          </row>
          <row>
            <entry>__u32</entry>
index 7f4ac7e41fa8765d709794a130a2f11091b7c98a..7068b599a00dd331c39c14a2f52c79d1c21708f8 100644 (file)
@@ -113,7 +113,8 @@ change for example with the current video standard.</entry>
            <entry>The lowest tunable frequency in units of 62.5
 KHz, or if the <structfield>capability</structfield> flag
 <constant>V4L2_TUNER_CAP_LOW</constant> is set, in units of 62.5
-Hz.</entry>
+Hz, or if the <structfield>capability</structfield> flag
+<constant>V4L2_TUNER_CAP_1HZ</constant> is set, in units of 1 Hz.</entry>
          </row>
          <row>
            <entry>__u32</entry>
@@ -121,7 +122,8 @@ Hz.</entry>
            <entry>The highest tunable frequency in units of 62.5
 KHz, or if the <structfield>capability</structfield> flag
 <constant>V4L2_TUNER_CAP_LOW</constant> is set, in units of 62.5
-Hz.</entry>
+Hz, or if the <structfield>capability</structfield> flag
+<constant>V4L2_TUNER_CAP_1HZ</constant> is set, in units of 1 Hz.</entry>
          </row>
          <row>
            <entry>__u32</entry>
index 6cc82010c7366921792eb4204655bfc92675d0bc..b0d865933da69247aaf85a569d1de4cc1a28acf4 100644 (file)
@@ -134,7 +134,9 @@ the structure refers to a radio tuner the
            <entry spanname="hspan">The lowest tunable frequency in
 units of 62.5 kHz, or if the <structfield>capability</structfield>
 flag <constant>V4L2_TUNER_CAP_LOW</constant> is set, in units of 62.5
-Hz. If multiple frequency bands are supported, then
+Hz, or if the <structfield>capability</structfield> flag
+<constant>V4L2_TUNER_CAP_1HZ</constant> is set, in units of 1 Hz.
+If multiple frequency bands are supported, then
 <structfield>rangelow</structfield> is the lowest frequency
 of all the frequency bands.</entry>
          </row>
@@ -144,7 +146,9 @@ of all the frequency bands.</entry>
            <entry spanname="hspan">The highest tunable frequency in
 units of 62.5 kHz, or if the <structfield>capability</structfield>
 flag <constant>V4L2_TUNER_CAP_LOW</constant> is set, in units of 62.5
-Hz. If multiple frequency bands are supported, then
+Hz, or if the <structfield>capability</structfield> flag
+<constant>V4L2_TUNER_CAP_1HZ</constant> is set, in units of 1 Hz.
+If multiple frequency bands are supported, then
 <structfield>rangehigh</structfield> is the highest frequency
 of all the frequency bands.</entry>
          </row>
@@ -270,7 +274,7 @@ applications must set the array to zero.</entry>
            <entry><constant>V4L2_TUNER_CAP_LOW</constant></entry>
            <entry>0x0001</entry>
            <entry>When set, tuning frequencies are expressed in units of
-62.5&nbsp;Hz, otherwise in units of 62.5&nbsp;kHz.</entry>
+62.5 Hz instead of 62.5 kHz.</entry>
          </row>
          <row>
            <entry><constant>V4L2_TUNER_CAP_NORM</constant></entry>
@@ -360,6 +364,11 @@ radio tuners.</entry>
        <entry>The range to search when using the hardware seek functionality
        is programmable, see &VIDIOC-S-HW-FREQ-SEEK; for details.</entry>
          </row>
+         <row>
+       <entry><constant>V4L2_TUNER_CAP_1HZ</constant></entry>
+       <entry>0x1000</entry>
+       <entry>When set, tuning frequencies are expressed in units of 1 Hz instead of 62.5 kHz.</entry>
+         </row>
        </tbody>
       </tgroup>
     </table>
index 5b379e752194a2b096ce512e11facde121c8aabc..a5fc4c4880f3366767d9ac56483dd71176ac6df6 100644 (file)
@@ -121,7 +121,9 @@ field and the &v4l2-tuner; <structfield>index</structfield> field.</entry>
            <entry>If non-zero, the lowest tunable frequency of the band to
 search in units of 62.5 kHz, or if the &v4l2-tuner;
 <structfield>capability</structfield> field has the
-<constant>V4L2_TUNER_CAP_LOW</constant> flag set, in units of 62.5 Hz.
+<constant>V4L2_TUNER_CAP_LOW</constant> flag set, in units of 62.5 Hz or if the &v4l2-tuner;
+<structfield>capability</structfield> field has the
+<constant>V4L2_TUNER_CAP_1HZ</constant> flag set, in units of 1 Hz.
 If <structfield>rangelow</structfield> is zero a reasonable default value
 is used.</entry>
          </row>
@@ -131,7 +133,9 @@ is used.</entry>
            <entry>If non-zero, the highest tunable frequency of the band to
 search in units of 62.5 kHz, or if the &v4l2-tuner;
 <structfield>capability</structfield> field has the
-<constant>V4L2_TUNER_CAP_LOW</constant> flag set, in units of 62.5 Hz.
+<constant>V4L2_TUNER_CAP_LOW</constant> flag set, in units of 62.5 Hz or if the &v4l2-tuner;
+<structfield>capability</structfield> field has the
+<constant>V4L2_TUNER_CAP_1HZ</constant> flag set, in units of 1 Hz.
 If <structfield>rangehigh</structfield> is zero a reasonable default value
 is used.</entry>
          </row>