요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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로 설정하기를 권장합니다.