요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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_TONE:
*****************
ioctl FE_SET_TONE
*****************
Name
====
FE_SET_TONE - Sets/resets the generation of the continuous 22kHz tone.
Synopsis
========
.. c:macro:: FE_SET_TONE
``int ioctl(int fd, FE_SET_TONE, enum fe_sec_tone_mode tone)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``tone``
An integer enumerated value described at :c:type:`fe_sec_tone_mode`
Description
===========
This ioctl is used to set the generation of the continuous 22kHz tone.
This call requires read/write permissions.
Usually, satellite antenna subsystems require that the digital TV device
to send a 22kHz tone in order to select between high/low band on some
dual-band LNBf. It is also used to send signals to DiSEqC equipment, but
this is done using the DiSEqC ioctls.
.. attention:: If more than one device is connected to the same antenna,
setting a tone may interfere on other devices, as they may lose the
capability of selecting the band. So, it is recommended that applications
would change to SEC_TONE_OFF when the device is not used.
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은 원문 표기를 유지합니다.
연속 22kHz tone 선언
1-30`FE_SET_TONE`은 연속 22kHz tone 생성을 켜거나 끕니다. 호출 형식은 `int ioctl(int fd, FE_SET_TONE, enum fe_sec_tone_mode tone)`입니다.
SEC tone mode enum을 전달합니다.
.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
.. c:namespace:: DTV.fe
.. _FE_SET_TONE:
*****************
ioctl FE_SET_TONE
*****************
Name
====
FE_SET_TONE - Sets/resets the generation of the continuous 22kHz tone.
Synopsis
========
.. c:macro:: FE_SET_TONE
``int ioctl(int fd, FE_SET_TONE, enum fe_sec_tone_mode tone)``
Arguments
=========
``fd``
File descriptor returned by :c:func:`open()`.
``tone``
An integer enumerated value described at :c:type:`fe_sec_tone_mode`
LNBf band 선택과 공유 antenna 주의
31-56이 ioctl은 연속 22kHz tone 생성을 설정하며 read/write 권한이 필요합니다.
위성 antenna subsystem에서는 Digital TV 장치가 22kHz tone을 보내 일부 dual-band LNBf의 high/low band를 선택합니다. DiSEqC 장비에도 signal을 보내지만 그 작업은 별도의 DiSEqC ioctl로 수행합니다.
여러 장치가 같은 antenna에 연결되면 한 장치의 tone 설정이 다른 장치의 band 선택을 방해할 수 있습니다. 장치를 사용하지 않을 때 응용 프로그램이 `SEC_TONE_OFF`로 바꾸는 것이 권장됩니다.
성공 시 0, 오류 시 -1을 반환하고 `errno`를 설정합니다. 일반 오류는 `Generic Error Codes <gen-errors>` 절을 따릅니다.
사용 중일 때만 필요한 band tone을 유지합니다.
Description
===========
This ioctl is used to set the generation of the continuous 22kHz tone.
This call requires read/write permissions.
Usually, satellite antenna subsystems require that the digital TV device
to send a 22kHz tone in order to select between high/low band on some
dual-band LNBf. It is also used to send signals to DiSEqC equipment, but
this is done using the DiSEqC ioctls.
.. attention:: If more than one device is connected to the same antenna,
setting a tone may interfere on other devices, as they may lose the
capability of selecting the band. So, it is recommended that applications
would change to SEC_TONE_OFF when the device is not used.
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-tone.rst:1-56공유 antenna에서는 tone이 다른 장치의 band 선택을 방해할 수 있어 미사용 시 SEC_TONE_OFF가 권장됩니다.