RF Tuner Control Reference | Linux 6.18.37

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

ext-ctrls-rf-tuner.rst:1-89

RF tuner API는 안테나에서 IF 또는 baseband 출력까지 이어지는 filter와 gain stage를 각각 조정하고 synthesizer lock을 확인합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기

1 .. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later

3 .. _rf-tuner-controls:

5 **************************

6 RF Tuner Control Reference

7 **************************

9 The RF Tuner (RF_TUNER) class includes controls for common features of

10 devices having RF tuner.

12 In this context, RF tuner is radio receiver circuit between antenna and

13 demodulator. It receives radio frequency (RF) from the antenna and

14 converts that received signal to lower intermediate frequency (IF) or

15 baseband frequency (BB). Tuners that could do baseband output are often

16 called Zero-IF tuners. Older tuners were typically simple PLL tuners

17 inside a metal box, while newer ones are highly integrated chips

18 without a metal box "silicon tuners". These controls are mostly

19 applicable for new feature rich silicon tuners, just because older

20 tuners does not have much adjustable features.

22 For more information about RF tuners see

23 `Tuner (radio) <http://en.wikipedia.org/wiki/Tuner_%28radio%29>`__

24 and `RF front end <http://en.wikipedia.org/wiki/RF_front_end>`__

25 from Wikipedia.

28 .. _rf-tuner-control-id:

30 RF_TUNER Control IDs

31 ====================

33 ``V4L2_CID_RF_TUNER_CLASS (class)``

34 The RF_TUNER class descriptor. Calling

35 :ref:`VIDIOC_QUERYCTRL` for this control will

36 return a description of this control class.

38 ``V4L2_CID_RF_TUNER_BANDWIDTH_AUTO (boolean)``

39 Enables/disables tuner radio channel bandwidth configuration. In

40 automatic mode bandwidth configuration is performed by the driver.

42 ``V4L2_CID_RF_TUNER_BANDWIDTH (integer)``

43 Filter(s) on tuner signal path are used to filter signal according

44 to receiving party needs. Driver configures filters to fulfill

45 desired bandwidth requirement. Used when

46 V4L2_CID_RF_TUNER_BANDWIDTH_AUTO is not set. Unit is in Hz. The

47 range and step are driver-specific.

49 ``V4L2_CID_RF_TUNER_LNA_GAIN_AUTO (boolean)``

50 Enables/disables LNA automatic gain control (AGC)

52 ``V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO (boolean)``

53 Enables/disables mixer automatic gain control (AGC)

55 ``V4L2_CID_RF_TUNER_IF_GAIN_AUTO (boolean)``

56 Enables/disables IF automatic gain control (AGC)

58 ``V4L2_CID_RF_TUNER_RF_GAIN (integer)``

59 The RF amplifier is the very first amplifier on the receiver signal

60 path, just right after the antenna input. The difference between the

61 LNA gain and the RF gain in this document is that the LNA gain is

62 integrated in the tuner chip while the RF gain is a separate chip.

63 There may be both RF and LNA gain controls in the same device. The

64 range and step are driver-specific.

66 ``V4L2_CID_RF_TUNER_LNA_GAIN (integer)``

67 LNA (low noise amplifier) gain is first gain stage on the RF tuner

68 signal path. It is located very close to tuner antenna input. Used

69 when ``V4L2_CID_RF_TUNER_LNA_GAIN_AUTO`` is not set. See

70 ``V4L2_CID_RF_TUNER_RF_GAIN`` to understand how RF gain and LNA gain

71 differs from the each others. The range and step are

72 driver-specific.

74 ``V4L2_CID_RF_TUNER_MIXER_GAIN (integer)``

75 Mixer gain is second gain stage on the RF tuner signal path. It is

76 located inside mixer block, where RF signal is down-converted by the

77 mixer. Used when ``V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO`` is not set.

78 The range and step are driver-specific.

80 ``V4L2_CID_RF_TUNER_IF_GAIN (integer)``

81 IF gain is last gain stage on the RF tuner signal path. It is

82 located on output of RF tuner. It controls signal level of

83 intermediate frequency output or baseband output. Used when

84 ``V4L2_CID_RF_TUNER_IF_GAIN_AUTO`` is not set. The range and step

85 are driver-specific.

87 ``V4L2_CID_RF_TUNER_PLL_LOCK (boolean)``

88 Is synthesizer PLL locked? RF tuner is receiving given frequency

89 when that control is set. This is a read-only control.

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

RF tuner 신호 경로

1-33

RF Tuner(`RF_TUNER`) 클래스는 RF tuner가 있는 장치의 공통 기능을 제어합니다. 여기서 tuner는 안테나와 demodulator 사이의 radio receiver 회로로, 안테나에서 받은 RF 신호를 더 낮은 IF 또는 baseband(BB) 주파수로 변환합니다.

Baseband를 직접 출력하는 장치는 흔히 Zero-IF tuner라 부릅니다. 오래된 tuner는 금속 상자 안의 단순 PLL 방식이었지만 최신 silicon tuner는 고집적 chip입니다. 이 제어들은 조정 기능이 풍부한 silicon tuner에 주로 적용됩니다.

RF tuner signal path

Antenna와 외부 RF amplifierTuner chip 내부 LNAMixer에서 RF를 IF 또는 baseband로 down-convertIF output stage에서 최종 level 조정Demodulator로 신호 전달

각 gain stage는 안테나 입력에서 IF 또는 baseband 출력까지 순서대로 배치됩니다.

.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later

.. _rf-tuner-controls:

**************************
RF Tuner Control Reference
**************************

The RF Tuner (RF_TUNER) class includes controls for common features of
devices having RF tuner.

In this context, RF tuner is radio receiver circuit between antenna and
demodulator. It receives radio frequency (RF) from the antenna and
converts that received signal to lower intermediate frequency (IF) or
baseband frequency (BB). Tuners that could do baseband output are often
called Zero-IF tuners. Older tuners were typically simple PLL tuners
inside a metal box, while newer ones are highly integrated chips
without a metal box "silicon tuners". These controls are mostly
applicable for new feature rich silicon tuners, just because older
tuners does not have much adjustable features.

For more information about RF tuners see
`Tuner (radio) <http://en.wikipedia.org/wiki/Tuner_%28radio%29>`__
and `RF front end <http://en.wikipedia.org/wiki/RF_front_end>`__
from Wikipedia.


.. _rf-tuner-control-id:

RF_TUNER Control IDs
====================

``V4L2_CID_RF_TUNER_CLASS (class)``

Bandwidth, gain stage와 PLL lock

34-89

`V4L2_CID_RF_TUNER_CLASS`는 RF_TUNER 클래스 설명자이며 `VIDIOC_QUERYCTRL`로 설명을 읽습니다. `V4L2_CID_RF_TUNER_BANDWIDTH_AUTO`가 설정되면 드라이버가 channel bandwidth를 자동 구성합니다. 해제되면 `V4L2_CID_RF_TUNER_BANDWIDTH`로 signal path filter의 요구 bandwidth를 Hz 단위로 지정하며 범위와 step은 드라이버별입니다.

LNA, mixer, IF의 각 `_GAIN_AUTO` 제어는 해당 stage의 AGC를 켜거나 끕니다. 수동 gain 제어는 대응하는 auto 제어가 해제되었을 때 사용하며 각 범위와 step은 드라이버별입니다.

RF tuner gain stage

항목설명

`V4L2_CID_RF_TUNER_RF_GAIN`안테나 직후 별도 chip에 있는 최초 RF amplifier입니다. 같은 장치에 RF와 LNA gain이 함께 있을 수 있습니다.

`V4L2_CID_RF_TUNER_LNA_GAIN`Tuner chip에 통합되고 안테나 입력 가까이에 있는 첫 번째 내부 gain stage입니다.

`V4L2_CID_RF_TUNER_MIXER_GAIN`RF를 down-convert하는 mixer block 내부의 두 번째 gain stage입니다.

`V4L2_CID_RF_TUNER_IF_GAIN`Tuner 출력의 마지막 gain stage로 IF 또는 baseband output level을 조정합니다.

안테나에서 출력으로 진행하는 순서와 집적 위치를 구분합니다.

읽기 전용 `V4L2_CID_RF_TUNER_PLL_LOCK`이 설정되면 synthesizer PLL이 lock되어 RF tuner가 지정한 주파수를 수신하고 있음을 뜻합니다.

    The RF_TUNER class descriptor. Calling
    :ref:`VIDIOC_QUERYCTRL` for this control will
    return a description of this control class.

``V4L2_CID_RF_TUNER_BANDWIDTH_AUTO (boolean)``
    Enables/disables tuner radio channel bandwidth configuration. In
    automatic mode bandwidth configuration is performed by the driver.

``V4L2_CID_RF_TUNER_BANDWIDTH (integer)``
    Filter(s) on tuner signal path are used to filter signal according
    to receiving party needs. Driver configures filters to fulfill
    desired bandwidth requirement. Used when
    V4L2_CID_RF_TUNER_BANDWIDTH_AUTO is not set. Unit is in Hz. The
    range and step are driver-specific.

``V4L2_CID_RF_TUNER_LNA_GAIN_AUTO (boolean)``
    Enables/disables LNA automatic gain control (AGC)

``V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO (boolean)``
    Enables/disables mixer automatic gain control (AGC)

``V4L2_CID_RF_TUNER_IF_GAIN_AUTO (boolean)``
    Enables/disables IF automatic gain control (AGC)

``V4L2_CID_RF_TUNER_RF_GAIN (integer)``
    The RF amplifier is the very first amplifier on the receiver signal
    path, just right after the antenna input. The difference between the
    LNA gain and the RF gain in this document is that the LNA gain is
    integrated in the tuner chip while the RF gain is a separate chip.
    There may be both RF and LNA gain controls in the same device. The
    range and step are driver-specific.

``V4L2_CID_RF_TUNER_LNA_GAIN (integer)``
    LNA (low noise amplifier) gain is first gain stage on the RF tuner
    signal path. It is located very close to tuner antenna input. Used
    when ``V4L2_CID_RF_TUNER_LNA_GAIN_AUTO`` is not set. See
    ``V4L2_CID_RF_TUNER_RF_GAIN`` to understand how RF gain and LNA gain
    differs from the each others. The range and step are
    driver-specific.

``V4L2_CID_RF_TUNER_MIXER_GAIN (integer)``
    Mixer gain is second gain stage on the RF tuner signal path. It is
    located inside mixer block, where RF signal is down-converted by the
    mixer. Used when ``V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO`` is not set.
    The range and step are driver-specific.

``V4L2_CID_RF_TUNER_IF_GAIN (integer)``
    IF gain is last gain stage on the RF tuner signal path. It is
    located on output of RF tuner. It controls signal level of
    intermediate frequency output or baseband output. Used when
    ``V4L2_CID_RF_TUNER_IF_GAIN_AUTO`` is not set. The range and step
    are driver-specific.

``V4L2_CID_RF_TUNER_PLL_LOCK (boolean)``
    Is synthesizer PLL locked? RF tuner is receiving given frequency
    when that control is set. This is a read-only control.