요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
2
.. c:namespace:: RC
4
.. _lirc_set_measure_carrier_mode:
6
***********************************
7
ioctl LIRC_SET_MEASURE_CARRIER_MODE
8
***********************************
10
Name
11
====
13
LIRC_SET_MEASURE_CARRIER_MODE - enable or disable measure mode
15
Synopsis
16
========
18
.. c:macro:: LIRC_SET_MEASURE_CARRIER_MODE
20
``int ioctl(int fd, LIRC_SET_MEASURE_CARRIER_MODE, __u32 *enable)``
22
Arguments
23
=========
25
``fd``
26
File descriptor returned by open().
28
``enable``
29
enable = 1 means enable measure mode, enable = 0 means disable measure
30
mode.
32
Description
33
===========
35
.. _lirc-mode2-frequency:
37
Enable or disable measure mode. If enabled, from the next key
38
press on, the driver will send ``LIRC_MODE2_FREQUENCY`` packets. By
39
default this should be turned off.
41
Return Value
42
============
44
On success 0 is returned, on error -1 and the ``errno`` variable is set
45
appropriately. The generic error codes are described at the
46
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
이름, 선언과 인자
1-31`LIRC_SET_MEASURE_CARRIER_MODE`는 receiver의 carrier 측정 mode를 켜거나 끕니다.
int ioctl(int fd, LIRC_SET_MEASURE_CARRIER_MODE, __u32 *enable);인자 또는 값설명
fdopen()이 반환한 LIRC 장치 file descriptor
enable = 1Carrier 측정 mode 활성화
enable = 0Carrier 측정 mode 비활성화
0과 1로 상태를 선택합니다.
.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
.. c:namespace:: RC
.. _lirc_set_measure_carrier_mode:
***********************************
ioctl LIRC_SET_MEASURE_CARRIER_MODE
***********************************
Name
====
LIRC_SET_MEASURE_CARRIER_MODE - enable or disable measure mode
Synopsis
========
.. c:macro:: LIRC_SET_MEASURE_CARRIER_MODE
``int ioctl(int fd, LIRC_SET_MEASURE_CARRIER_MODE, __u32 *enable)``
Arguments
=========
``fd``
File descriptor returned by open().
``enable``
enable = 1 means enable measure mode, enable = 0 means disable measure
mode.
FREQUENCY packet과 기본 상태
32-40측정 mode를 활성화하면 다음 key press부터 driver가 `LIRC_MODE2_FREQUENCY` packet을 보냅니다. Payload는 측정한 modulation carrier frequency를 Hertz 단위로 나타냅니다.
이 mode는 기본적으로 꺼져 있어야 합니다. 필요할 때만 켜고 측정이 끝나면 다시 끄면 일반 MODE2 stream에 frequency packet이 섞이는 범위를 제한할 수 있습니다.
LIRC_CAN_MEASURE_CARRIER feature 확인→enable = 1로 ioctl 호출→다음 key press의 LIRC_MODE2_FREQUENCY packet 읽기→enable = 0으로 기본 상태 복원
Feature 확인 후 필요한 입력 구간에만 측정을 활성화합니다.
Description
===========
.. _lirc-mode2-frequency:
Enable or disable measure mode. If enabled, from the next key
press on, the driver will send ``LIRC_MODE2_FREQUENCY`` packets. By
default this should be turned off.
반환값
41-46성공하면 0, 오류이면 -1을 반환하고 `errno`를 설정합니다. 공통 오류는 Generic Error Codes 절을 따릅니다.
Return Value
============
On success 0 is returned, on error -1 and the ``errno`` variable is set
appropriately. The generic error codes are described at the
:ref:`Generic Error Codes <gen-errors>` chapter.
요약·해설
lirc-set-measure-carrier-mode.rst:1-46측정을 켜면 다음 key press부터 MODE2_FREQUENCY packet이 추가됩니다. 기본값은 off이며 feature를 확인한 뒤 필요한 구간에만 활성화합니다.