| David Brazdil | 0f672f6 | 2019-12-10 10:32:29 +0000 | [diff] [blame^] | 1 | .. SPDX-License-Identifier: GPL-2.0 |
| 2 | |
| Andrew Scull | b4b6d4a | 2019-01-02 15:54:55 +0000 | [diff] [blame] | 3 | Maxim Integrated MAX2175 RF to bits tuner driver |
| 4 | ================================================ |
| 5 | |
| 6 | The 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/media/kapi/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. |