frontend parameters

하드웨어별 매개변수와 새 property API

이 문서는 GFDL-1.1-no-invariants-or-later 라이선스를 따르며 C 자료형 `dvb_frontend_parameters`를 설명합니다.

튜닝을 위해 frontend 장치에 전달하는 매개변수 종류는 사용하는 하드웨어에 따라 달라집니다.

기존 `struct dvb_frontend_parameters`는 전송 시스템별 구조체를 union으로 포함합니다. 그러나 새 delivery system이 더 많은 데이터를 요구하면서 기존 구조체 크기로는 부족해졌고, 크기를 단순 확장하면 기존 애플리케이션의 ABI가 깨집니다.

그래서 이 매개변수들은 `FE_GET_PROPERTY/FE_SET_PROPERTY <FE_GET_PROPERTY>` ioctl 사용으로 대체되었습니다. 새 API는 기존 delivery system에 속성을 추가하거나 새로운 delivery system을 도입할 수 있을 만큼 유연합니다.

DVB-S2, DVB-T2, DVB-C2, ISDB 같은 새 시스템을 지원하려는 애플리케이션은 property API를 사용해야 합니다.

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

.. c:type:: dvb_frontend_parameters

*******************
frontend parameters
*******************

The kind of parameters passed to the frontend device for tuning depend
on the kind of hardware you are using.

The struct ``dvb_frontend_parameters`` uses a union with specific
per-system parameters. However, as newer delivery systems required more
data, the structure size weren't enough to fit, and just extending its
size would break the existing applications. So, those parameters were
replaced by the usage of
:ref:`FE_GET_PROPERTY/FE_SET_PROPERTY <FE_GET_PROPERTY>`
ioctl's. The new API is flexible enough to add new parameters to
existing delivery systems, and to add newer delivery systems.

So, newer applications should use
:ref:`FE_GET_PROPERTY/FE_SET_PROPERTY <FE_GET_PROPERTY>`
instead, in order to be able to support the newer System Delivery like
DVB-S2, DVB-T2, DVB-C2, ISDB, etc.

All kinds of parameters are combined as a union in the
``dvb_frontend_parameters`` structure:

공통 구조체와 주파수 단위

`dvb_frontend_parameters`는 `frequency`, spectral `inversion`, 그리고 QPSK·QAM·OFDM·VSB별 구조체를 담는 union `u`로 구성됩니다.

QPSK frontend에서 `frequency`는 LNB의 local oscillator frequency(LOF)에 실질적으로 더해지는 offset, 즉 intermediate frequency를 뜻하며 kHz 단위로 지정합니다.

QAM과 OFDM frontend에서는 `frequency`가 절대 주파수를 뜻하며 Hz 단위로 지정합니다.

.. code-block:: c

    struct dvb_frontend_parameters {
	uint32_t frequency;     /* (absolute) frequency in Hz for QAM/OFDM */
		    /* intermediate frequency in kHz for QPSK */
	fe_spectral_inversion_t inversion;
	union {
	    struct dvb_qpsk_parameters qpsk;
	    struct dvb_qam_parameters  qam;
	    struct dvb_ofdm_parameters ofdm;
	    struct dvb_vsb_parameters  vsb;
	} u;
    };

In the case of QPSK frontends the ``frequency`` field specifies the
intermediate frequency, i.e. the offset which is effectively added to
the local oscillator frequency (LOF) of the LNB. The intermediate
frequency has to be specified in units of kHz. For QAM and OFDM
frontends the ``frequency`` specifies the absolute frequency and is
given in Hz.

QPSK 매개변수

위성 QPSK frontend는 `dvb_qpsk_parameters` 구조체를 사용합니다.

`symbol_rate`는 초당 symbol 수이고, `fec_inner`는 forward error correction 설정입니다.

.. c:type:: dvb_qpsk_parameters

QPSK parameters
===============

For satellite QPSK frontends you have to use the ``dvb_qpsk_parameters``
structure:


.. code-block:: c

     struct dvb_qpsk_parameters {
	 uint32_t        symbol_rate;  /* symbol rate in Symbols per second */
	 fe_code_rate_t  fec_inner;    /* forward error correction (see above) */
     };

QAM 매개변수

케이블 QAM frontend는 `dvb_qam_parameters` 구조체를 사용합니다.

구조체는 `symbol_rate`, 내부 FEC인 `fec_inner`, 변조 형식인 `modulation`을 포함합니다.

.. c:type:: dvb_qam_parameters

QAM parameters
==============

for cable QAM frontend you use the ``dvb_qam_parameters`` structure:


.. code-block:: c

     struct dvb_qam_parameters {
	 uint32_t         symbol_rate; /* symbol rate in Symbols per second */
	 fe_code_rate_t   fec_inner;   /* forward error correction (see above) */
	 fe_modulation_t  modulation;  /* modulation type (see above) */
     };

VSB 매개변수

ATSC frontend는 `dvb_vsb_parameters` 구조체로 지원합니다.

이 구조체는 `fe_modulation_t` 형식의 `modulation` 필드 하나로 변조 방식을 지정합니다.

.. c:type:: dvb_vsb_parameters

VSB parameters
==============

ATSC frontends are supported by the ``dvb_vsb_parameters`` structure:


.. code-block:: c

    struct dvb_vsb_parameters {
	fe_modulation_t modulation; /* modulation type (see above) */
    };

OFDM 매개변수

DVB-T frontend는 `dvb_ofdm_parameters` 구조체로 지원합니다.

이 구조체는 대역폭, high/low priority stream의 code rate, constellation, transmission mode, guard interval, hierarchy 정보를 포함합니다.

.. c:type:: dvb_ofdm_parameters

OFDM parameters
===============

DVB-T frontends are supported by the ``dvb_ofdm_parameters`` structure:


.. code-block:: c

     struct dvb_ofdm_parameters {
	 fe_bandwidth_t      bandwidth;
	 fe_code_rate_t      code_rate_HP;  /* high priority stream code rate */
	 fe_code_rate_t      code_rate_LP;  /* low priority stream code rate */
	 fe_modulation_t     constellation; /* modulation type (see above) */
	 fe_transmit_mode_t  transmission_mode;
	 fe_guard_interval_t guard_interval;
	 fe_hierarchy_t      hierarchy_information;
     };