Orange Pi5 kernel

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