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