xref: /linux/Documentation/userspace-api/media/drivers/max2175.rst (revision 77346a704c913268a2dad68d59523fd85dc74088)
1.. SPDX-License-Identifier: GPL-2.0
2
3Maxim Integrated MAX2175 RF to bits tuner driver
4================================================
5
6The MAX2175 driver implements the following driver-specific controls:
7
8``V4L2_CID_MAX2175_I2S_ENABLE``
9-------------------------------
10    Enable/Disable I2S output of the tuner. This is a private control
11    that can be accessed only using the subdev interface.
12    Refer to Documentation/driver-api/media/v4l2-controls.rst for more details.
13
14.. flat-table::
15    :header-rows:  0
16    :stub-columns: 0
17    :widths:       1 4
18
19    * - ``(0)``
20      - I2S output is disabled.
21    * - ``(1)``
22      - I2S output is enabled.
23
24``V4L2_CID_MAX2175_HSLS``
25-------------------------
26    The high-side/low-side (HSLS) control of the tuner for a given band.
27
28.. flat-table::
29    :header-rows:  0
30    :stub-columns: 0
31    :widths:       1 4
32
33    * - ``(0)``
34      - The LO frequency position is below the desired frequency.
35    * - ``(1)``
36      - The LO frequency position is above the desired frequency.
37
38``V4L2_CID_MAX2175_RX_MODE (menu)``
39-----------------------------------
40    The Rx mode controls a number of preset parameters of the tuner like
41    sample clock (sck), sampling rate etc. These multiple settings are
42    provided under one single label called Rx mode in the datasheet. The
43    list below shows the supported modes with a brief description.
44
45.. flat-table::
46    :header-rows:  0
47    :stub-columns: 0
48    :widths:       1 4
49
50    * - ``"Europe modes"``
51    * - ``"FM 1.2" (0)``
52      - This configures FM band with a sample rate of 0.512 million
53        samples/sec with a 10.24 MHz sck.
54    * - ``"DAB 1.2" (1)``
55      - This configures VHF band with a sample rate of 2.048 million
56        samples/sec with a 32.768 MHz sck.
57
58    * - ``"North America modes"``
59    * - ``"FM 1.0" (0)``
60      - This configures FM band with a sample rate of 0.7441875 million
61        samples/sec with a 14.88375 MHz sck.
62    * - ``"DAB 1.2" (1)``
63      - This configures FM band with a sample rate of 0.372 million
64        samples/sec with a 7.441875 MHz sck.
65