18c2ecf20Sopenharmony_ci.. SPDX-License-Identifier: GPL-2.0
28c2ecf20Sopenharmony_ci
38c2ecf20Sopenharmony_ciMaxim Integrated MAX2175 RF to bits tuner driver
48c2ecf20Sopenharmony_ci================================================
58c2ecf20Sopenharmony_ci
68c2ecf20Sopenharmony_ciThe MAX2175 driver implements the following driver-specific controls:
78c2ecf20Sopenharmony_ci
88c2ecf20Sopenharmony_ci``V4L2_CID_MAX2175_I2S_ENABLE``
98c2ecf20Sopenharmony_ci-------------------------------
108c2ecf20Sopenharmony_ci    Enable/Disable I2S output of the tuner. This is a private control
118c2ecf20Sopenharmony_ci    that can be accessed only using the subdev interface.
128c2ecf20Sopenharmony_ci    Refer to Documentation/driver-api/media/v4l2-controls.rst for more details.
138c2ecf20Sopenharmony_ci
148c2ecf20Sopenharmony_ci.. flat-table::
158c2ecf20Sopenharmony_ci    :header-rows:  0
168c2ecf20Sopenharmony_ci    :stub-columns: 0
178c2ecf20Sopenharmony_ci    :widths:       1 4
188c2ecf20Sopenharmony_ci
198c2ecf20Sopenharmony_ci    * - ``(0)``
208c2ecf20Sopenharmony_ci      - I2S output is disabled.
218c2ecf20Sopenharmony_ci    * - ``(1)``
228c2ecf20Sopenharmony_ci      - I2S output is enabled.
238c2ecf20Sopenharmony_ci
248c2ecf20Sopenharmony_ci``V4L2_CID_MAX2175_HSLS``
258c2ecf20Sopenharmony_ci-------------------------
268c2ecf20Sopenharmony_ci    The high-side/low-side (HSLS) control of the tuner for a given band.
278c2ecf20Sopenharmony_ci
288c2ecf20Sopenharmony_ci.. flat-table::
298c2ecf20Sopenharmony_ci    :header-rows:  0
308c2ecf20Sopenharmony_ci    :stub-columns: 0
318c2ecf20Sopenharmony_ci    :widths:       1 4
328c2ecf20Sopenharmony_ci
338c2ecf20Sopenharmony_ci    * - ``(0)``
348c2ecf20Sopenharmony_ci      - The LO frequency position is below the desired frequency.
358c2ecf20Sopenharmony_ci    * - ``(1)``
368c2ecf20Sopenharmony_ci      - The LO frequency position is above the desired frequency.
378c2ecf20Sopenharmony_ci
388c2ecf20Sopenharmony_ci``V4L2_CID_MAX2175_RX_MODE (menu)``
398c2ecf20Sopenharmony_ci-----------------------------------
408c2ecf20Sopenharmony_ci    The Rx mode controls a number of preset parameters of the tuner like
418c2ecf20Sopenharmony_ci    sample clock (sck), sampling rate etc. These multiple settings are
428c2ecf20Sopenharmony_ci    provided under one single label called Rx mode in the datasheet. The
438c2ecf20Sopenharmony_ci    list below shows the supported modes with a brief description.
448c2ecf20Sopenharmony_ci
458c2ecf20Sopenharmony_ci.. flat-table::
468c2ecf20Sopenharmony_ci    :header-rows:  0
478c2ecf20Sopenharmony_ci    :stub-columns: 0
488c2ecf20Sopenharmony_ci    :widths:       1 4
498c2ecf20Sopenharmony_ci
508c2ecf20Sopenharmony_ci    * - ``"Europe modes"``
518c2ecf20Sopenharmony_ci    * - ``"FM 1.2" (0)``
528c2ecf20Sopenharmony_ci      - This configures FM band with a sample rate of 0.512 million
538c2ecf20Sopenharmony_ci        samples/sec with a 10.24 MHz sck.
548c2ecf20Sopenharmony_ci    * - ``"DAB 1.2" (1)``
558c2ecf20Sopenharmony_ci      - This configures VHF band with a sample rate of 2.048 million
568c2ecf20Sopenharmony_ci        samples/sec with a 32.768 MHz sck.
578c2ecf20Sopenharmony_ci
588c2ecf20Sopenharmony_ci    * - ``"North America modes"``
598c2ecf20Sopenharmony_ci    * - ``"FM 1.0" (0)``
608c2ecf20Sopenharmony_ci      - This configures FM band with a sample rate of 0.7441875 million
618c2ecf20Sopenharmony_ci        samples/sec with a 14.88375 MHz sck.
628c2ecf20Sopenharmony_ci    * - ``"DAB 1.2" (1)``
638c2ecf20Sopenharmony_ci      - This configures FM band with a sample rate of 0.372 million
648c2ecf20Sopenharmony_ci        samples/sec with a 7.441875 MHz sck.
65