요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_SET_VOLTAGE:
********************
ioctl FE_SET_VOLTAGE
********************
Name
====
FE_SET_VOLTAGE - Allow setting the DC level sent to the antenna subsystem.
Synopsis
========
.. c:macro:: FE_SET_VOLTAGE
``int ioctl(int fd, FE_SET_VOLTAGE, enum fe_sec_voltage voltage)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``voltage``
An integer enumerated value described at :c:type:`fe_sec_voltage`
Description
===========
This ioctl allows to set the DC voltage level sent through the antenna
cable to 13V, 18V or off.
Usually, a satellite antenna subsystems require that the digital TV
device to send a DC voltage to feed power to the LNBf. Depending on the
LNBf type, the polarization or the intermediate frequency (IF) of the
LNBf can controlled by the voltage level. Other devices (for example,
the ones that implement DISEqC and multipoint LNBf's don't need to
control the voltage level, provided that either 13V or 18V is sent to
power up the LNBf.
.. attention:: if more than one device is connected to the same antenna,
setting a voltage level may interfere on other devices, as they may lose
the capability of setting polarization or IF. So, on those cases, setting
the voltage to SEC_VOLTAGE_OFF while the device is not is used is
recommended.
Return Value
============
On success 0 is returned.
On error -1 is returned, and the ``errno`` variable is set
appropriately.
Generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Antenna cable DC level 선언
1-30`FE_SET_VOLTAGE`는 antenna subsystem으로 보내는 DC level을 설정합니다. 호출 형식은 `int ioctl(int fd, FE_SET_VOLTAGE, enum fe_sec_voltage voltage)`입니다.
SEC voltage enum으로 13V, 18V 또는 off를 선택합니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_SET_VOLTAGE:
********************
ioctl FE_SET_VOLTAGE
********************
Name
====
FE_SET_VOLTAGE - Allow setting the DC level sent to the antenna subsystem.
Synopsis
========
.. c:macro:: FE_SET_VOLTAGE
``int ioctl(int fd, FE_SET_VOLTAGE, enum fe_sec_voltage voltage)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``voltage``
An integer enumerated value described at :c:type:`fe_sec_voltage`
LNBf 전원·편파·IF 제어
31-60Antenna cable로 보내는 DC voltage를 13V, 18V 또는 off로 설정합니다.
위성 antenna subsystem은 보통 LNBf에 전원을 공급하도록 Digital TV 장치의 DC voltage가 필요합니다. LNBf 형식에 따라 voltage level로 편파 또는 intermediate frequency(IF)를 제어할 수 있습니다.
DiSEqC나 multipoint LNBf를 구현한 장치 등은 voltage level 제어가 필요하지 않을 수 있지만, LNBf 전원을 켜기 위해 13V 또는 18V 가운데 하나는 보내야 합니다.
여러 장치가 같은 antenna를 공유하면 voltage 설정이 다른 장치의 편파 또는 IF 선택을 방해할 수 있습니다. 사용하지 않을 때 `SEC_VOLTAGE_OFF`로 설정하는 것이 권장됩니다.
성공 시 0, 오류 시 -1을 반환하고 `errno`를 설정합니다. 일반 오류는 `Generic Error Codes <gen-errors>` 절을 따릅니다.
전원 공급과 공유 antenna 간섭을 함께 고려합니다.
Description
===========
This ioctl allows to set the DC voltage level sent through the antenna
cable to 13V, 18V or off.
Usually, a satellite antenna subsystems require that the digital TV
device to send a DC voltage to feed power to the LNBf. Depending on the
LNBf type, the polarization or the intermediate frequency (IF) of the
LNBf can controlled by the voltage level. Other devices (for example,
the ones that implement DISEqC and multipoint LNBf's don't need to
control the voltage level, provided that either 13V or 18V is sent to
power up the LNBf.
.. attention:: if more than one device is connected to the same antenna,
setting a voltage level may interfere on other devices, as they may lose
the capability of setting polarization or IF. So, on those cases, setting
the voltage to SEC_VOLTAGE_OFF while the device is not is used is
recommended.
Return Value
============
On success 0 is returned.
On error -1 is returned, and the ``errno`` variable is set
appropriately.
Generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
요약·해설
fe-set-voltage.rst:1-60LNBf 전원과 편파/IF를 제어하며 공유 antenna에서는 미사용 시 voltage off가 권장됩니다.