요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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_get_rec_resolution:
6
*****************************
7
ioctl LIRC_GET_REC_RESOLUTION
8
*****************************
10
Name
11
====
13
LIRC_GET_REC_RESOLUTION - Obtain the value of receive resolution, in microseconds.
15
Synopsis
16
========
18
.. c:macro:: LIRC_GET_REC_RESOLUTION
20
``int ioctl(int fd, LIRC_GET_REC_RESOLUTION, __u32 *microseconds)``
22
Arguments
23
=========
25
``fd``
26
File descriptor returned by open().
28
``microseconds``
29
Resolution, in microseconds.
31
Description
32
===========
34
Some receivers have maximum resolution which is defined by internal
35
sample rate or data format limitations. E.g. it's common that
36
signals can only be reported in 50 microsecond steps.
38
This ioctl returns the integer value with such resolution, with can be
39
used by userspace applications like lircd to automatically adjust the
40
tolerance value.
42
Return Value
43
============
45
On success 0 is returned, on error -1 and the ``errno`` variable is set
46
appropriately. The generic error codes are described at the
47
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
이름, 선언과 인자
1-30`LIRC_GET_REC_RESOLUTION`은 receiver의 시간 resolution을 microsecond 단위로 조회합니다. 결과는 `__u32 *microseconds`에 기록됩니다.
int ioctl(int fd, LIRC_GET_REC_RESOLUTION, __u32 *microseconds);인자설명
fdopen()이 반환한 LIRC 장치 file descriptor
microseconds수신 시간 resolution을 받을 pointer
Receiver가 구분할 수 있는 시간 간격을 받습니다.
.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
.. c:namespace:: RC
.. _lirc_get_rec_resolution:
*****************************
ioctl LIRC_GET_REC_RESOLUTION
*****************************
Name
====
LIRC_GET_REC_RESOLUTION - Obtain the value of receive resolution, in microseconds.
Synopsis
========
.. c:macro:: LIRC_GET_REC_RESOLUTION
``int ioctl(int fd, LIRC_GET_REC_RESOLUTION, __u32 *microseconds)``
Arguments
=========
``fd``
File descriptor returned by open().
``microseconds``
Resolution, in microseconds.
Sample rate 제한과 tolerance
31-41일부 receiver는 내부 sample rate나 data format 때문에 최대 resolution이 제한됩니다. 예를 들어 신호 시간을 50 microsecond 단위로만 보고할 수 있습니다.
이 ioctl은 그 정수 간격을 반환합니다. `lircd` 같은 userspace application은 이를 이용해 decode tolerance를 장치 정밀도에 맞게 자동 조정할 수 있습니다.
LIRC_CAN_GET_REC_RESOLUTION 확인→LIRC_GET_REC_RESOLUTION 호출→microsecond 단위 간격 읽기→Decoder tolerance를 resolution에 맞춰 조정
Hardware 정밀도보다 좁은 허용 오차를 피합니다.
Description
===========
Some receivers have maximum resolution which is defined by internal
sample rate or data format limitations. E.g. it's common that
signals can only be reported in 50 microsecond steps.
This ioctl returns the integer value with such resolution, with can be
used by userspace applications like lircd to automatically adjust the
tolerance value.
반환값
42-47성공하면 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-get-rec-resolution.rst:1-47Receiver의 sample rate나 data format이 만드는 최소 시간 단위를 알려 줍니다. Decoder는 이 값을 바탕으로 hardware 정밀도에 맞는 tolerance를 정할 수 있습니다.