On 05/02/17 15:26, Ramesh Shanmugasundaram wrote:
> This patch adds driver support for the MAX2175 chip. This is Maxim
> Integrated's RF to Bits tuner front end chip designed for software-defined
> radio solutions. This driver exposes the tuner as a sub-device instance
> with standard and custom controls to configure the device.
>
> Signed-off-by: Ramesh Shanmugasundaram
> <ramesh.shanmugasunda...@bp.renesas.com>
> ---
> v4:
> - Addressed v4l2_ctrl name string convention (Hans)
> - "HSLS above/below" to "HSLS Above/Below"
> - "RX MODE" to "RX Mode"
> ---
> Documentation/media/v4l-drivers/index.rst | 1 +
> Documentation/media/v4l-drivers/max2175.rst | 60 ++
> drivers/media/i2c/Kconfig | 4 +
> drivers/media/i2c/Makefile | 2 +
> drivers/media/i2c/max2175/Kconfig | 8 +
> drivers/media/i2c/max2175/Makefile | 4 +
> drivers/media/i2c/max2175/max2175.c | 1437
> +++++++++++++++++++++++++++
> drivers/media/i2c/max2175/max2175.h | 108 ++
> 8 files changed, 1624 insertions(+)
> create mode 100644 Documentation/media/v4l-drivers/max2175.rst
> create mode 100644 drivers/media/i2c/max2175/Kconfig
> create mode 100644 drivers/media/i2c/max2175/Makefile
> create mode 100644 drivers/media/i2c/max2175/max2175.c
> create mode 100644 drivers/media/i2c/max2175/max2175.h
>
> diff --git a/Documentation/media/v4l-drivers/index.rst
> b/Documentation/media/v4l-drivers/index.rst
> index a606d1cdac13..d8cade53d496 100644
> --- a/Documentation/media/v4l-drivers/index.rst
> +++ b/Documentation/media/v4l-drivers/index.rst
> @@ -42,6 +42,7 @@ For more details see the file COPYING in the source
> distribution of Linux.
> davinci-vpbe
> fimc
> ivtv
> + max2175
> meye
> omap3isp
> omap4_camera
> diff --git a/Documentation/media/v4l-drivers/max2175.rst
> b/Documentation/media/v4l-drivers/max2175.rst
> new file mode 100644
> index 000000000000..201af8f217e9
> --- /dev/null
> +++ b/Documentation/media/v4l-drivers/max2175.rst
> @@ -0,0 +1,60 @@
> +Maxim Integrated MAX2175 RF to bits tuner driver
> +================================================
> +
> +The MAX2175 driver implements the following driver-specific controls:
> +
> +``V4L2_CID_MAX2175_I2S_ENABLE``
> +-------------------------------
> + Enable/Disable I2S output of the tuner.
> +
> +.. flat-table::
> + :header-rows: 0
> + :stub-columns: 0
> + :widths: 1 4
> +
> + * - ``(0)``
> + - I2S output is disabled.
> + * - ``(1)``
> + - I2S output is enabled.
> +
> +``V4L2_CID_MAX2175_HSLS``
> +-------------------------
> + The high-side/low-side (HSLS) control of the tuner for a given band.
> +
> +.. flat-table::
> + :header-rows: 0
> + :stub-columns: 0
> + :widths: 1 4
> +
> + * - ``(0)``
> + - The LO frequency position is below the desired frequency.
> + * - ``(1)``
> + - The LO frequency position is above the desired frequency.
> +
> +``V4L2_CID_MAX2175_RX_MODE (menu)``
> +-----------------------------------
> + The Rx mode controls a number of preset parameters of the tuner like sck
'sck' is short of 'sample clock' or something like that? I recommend that you
write this in full at least once in this documentation.
> + rate, sampling rate etc. These multiple settings are provided under one
> + single label called Rx mode in the datasheet. The list below shows the
> + supported modes with a brief description.
> +
> +.. flat-table::
> + :header-rows: 0
> + :stub-columns: 0
> + :widths: 1 4
> +
> + * - ``"Europe modes"``
> + * - ``"FM 1.2" (0)``
> + - This configures FM band with a sample rate of 0.512 million
> + samples/sec with a 10.24 MHz sck.
> + * - ``"DAB 1.2" (1)``
> + - This configures VHF band with a sample rate of 2.048 million
> + samples/sec with a 32.768 MHz sck.
> +
> + * - ``"North America modes"``
> + * - ``"FM 1.0" (0)``
> + - This configures FM band with a sample rate of 0.7441875 million
> + samples/sec with a 14.88375 MHz sck.
> + * - ``"DAB 1.2" (1)``
> + - This configures FM band with a sample rate of 0.372 million
> + samples/sec with a 7.441875 MHz sck.
Regards,
Hans
