Re: [RFC v6 2/9] Documentation:DocBook:v4l: Update the controls.xmlfor TI FM driver

From: Mauro Carvalho Chehab
Date: Fri Dec 03 2010 - 07:14:14 EST


Em 03-12-2010 10:50, manjunatha_halli@xxxxxx escreveu:
> From: Manjunatha Halli <manjunatha_halli@xxxxxx>
>
> Added entries for following 2 new CID's which are added for TI FM
> driver:
> - V4L2_CID_RSSI_THRESHOLD
> - V4L2_CID_TUNE_AF
>
> Signed-off-by: Manjunatha Halli <manjunatha_halli@xxxxxx>
> ---
> Documentation/DocBook/v4l/controls.xml | 12 ++++++++++++
> 1 files changed, 12 insertions(+), 0 deletions(-)
>
> diff --git a/Documentation/DocBook/v4l/controls.xml b/Documentation/DocBook/v4l/controls.xml
> index 2fae3e8..b560953 100644
> --- a/Documentation/DocBook/v4l/controls.xml
> +++ b/Documentation/DocBook/v4l/controls.xml
> @@ -132,6 +132,18 @@ consumption state.</entry>
> <entry>Loudness mode (bass boost).</entry>
> </row>
> <row>
> + <entry><constant>V4L2_CID_RSSI_THRESHOLD</constant></entry>
> + <entry>integer</entry>
> + <entry>Set RSSI threshold level. Change the default threshold
> +level used to select valid frequencies during vidioc_s_hw_freq_seek.</entry>
> + </row>
> + <row>
> + <entry><constant>V4L2_CID_TUNE_AF</constant></entry>
> + <entry>integer</entry>
> + <entry>Set Alternative Frequency mode. Enable or disable
> +alternative frequency mode.</entry>
> + </row>
> + <row>
> <entry><constant>V4L2_CID_BLACK_LEVEL</constant></entry>
> <entry>integer</entry>
> <entry>Another name for brightness (not a synonym of

Sorry, but, I doubt that any userspace application developer will find those descriptions
useful.

For the threshold: I understand that this is the carrier strength used to detect a
channel, right? If so, please improve the description.
Also, The better is to associate its scale to a carrier level in some unit like dB.

The second control means absolutely nothing... It is not a boolean value, and what
is "alternative" frequency mode?

Cheers,
Mauro.

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/