요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
2
.. c:namespace:: DTV.fe
4
.. _FE_ENABLE_HIGH_LNB_VOLTAGE:
6
********************************
7
ioctl FE_ENABLE_HIGH_LNB_VOLTAGE
8
********************************
10
Name
11
====
13
FE_ENABLE_HIGH_LNB_VOLTAGE - Select output DC level between normal LNBf voltages or higher LNBf - voltages.
15
Synopsis
16
========
18
.. c:macro:: FE_ENABLE_HIGH_LNB_VOLTAGE
20
``int ioctl(int fd, FE_ENABLE_HIGH_LNB_VOLTAGE, unsigned int high)``
22
Arguments
23
=========
25
``fd``
26
File descriptor returned by :c:func:`open()`.
28
``high``
29
Valid flags:
31
- 0 - normal 13V and 18V.
33
- >0 - enables slightly higher voltages instead of 13/18V, in order
34
to compensate for long antenna cables.
36
Description
37
===========
39
Select output DC level between normal LNBf voltages or higher LNBf
40
voltages between 0 (normal) or a value grater than 0 for higher
41
voltages.
43
Return Value
44
============
46
On success 0 is returned.
48
On error -1 is returned, and the ``errno`` variable is set
49
appropriately.
51
Generic error codes are described at the
52
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
LNBf 전압 선택 선언과 flag
1-35`FE_ENABLE_HIGH_LNB_VOLTAGE`는 정상 LNBf voltage와 그보다 높은 LNBf voltage 사이에서 출력 DC level을 선택합니다.
호출 형식은 `int ioctl(int fd, FE_ENABLE_HIGH_LNB_VOLTAGE, unsigned int high)`입니다.
인수 또는 값의미
fdopen()이 반환한 파일 descriptor
high = 0정상 13V 및 18V 사용
high > 0긴 antenna cable 보상을 위해 13/18V보다 약간 높은 voltage 사용
긴 antenna cable의 voltage drop 보상 여부를 선택합니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_ENABLE_HIGH_LNB_VOLTAGE:
********************************
ioctl FE_ENABLE_HIGH_LNB_VOLTAGE
********************************
Name
====
FE_ENABLE_HIGH_LNB_VOLTAGE - Select output DC level between normal LNBf voltages or higher LNBf - voltages.
Synopsis
========
.. c:macro:: FE_ENABLE_HIGH_LNB_VOLTAGE
``int ioctl(int fd, FE_ENABLE_HIGH_LNB_VOLTAGE, unsigned int high)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``high``
Valid flags:
- 0 - normal 13V and 18V.
- >0 - enables slightly higher voltages instead of 13/18V, in order
to compensate for long antenna cables.
출력 DC level과 반환값
36-52`high`가 0이면 정상 LNBf voltage를, 0보다 크면 더 높은 LNBf voltage를 선택해 출력 DC level을 바꿉니다. 원문의 `grater` 표기는 의미상 greater를 가리키지만 영어 원문은 그대로 보존합니다.
성공 시 0, 오류 시 -1을 반환하고 `errno`를 적절히 설정합니다. 일반 오류 code는 `Generic Error Codes <gen-errors>` 절에 설명되어 있습니다.
정상 cable이면 high = 0 선택→긴 antenna cable의 voltage drop 보상이 필요하면 high > 0 선택→FE_ENABLE_HIGH_LNB_VOLTAGE 호출→13/18V 또는 약간 높은 출력 DC level 적용→반환값과 errno 확인
Cable 길이에 따른 출력 voltage 선택 절차입니다.
Description
===========
Select output DC level between normal LNBf voltages or higher LNBf
voltages between 0 (normal) or a value grater than 0 for higher
voltages.
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-enable-high-lnb-voltage.rst:1-52`high = 0`은 정상 13/18V, `high > 0`은 긴 cable의 voltage drop을 보상하는 약간 높은 출력입니다.