요약·해설과 원문, 전문 번역을 서로 분리했습니다. 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_send_carrier:
6
***************************
7
ioctl LIRC_SET_SEND_CARRIER
8
***************************
10
Name
11
====
13
LIRC_SET_SEND_CARRIER - Set send carrier used to modulate IR TX.
15
Synopsis
16
========
18
.. c:macro:: LIRC_SET_SEND_CARRIER
20
``int ioctl(int fd, LIRC_SET_SEND_CARRIER, __u32 *frequency)``
22
Arguments
23
=========
25
``fd``
26
File descriptor returned by open().
28
``frequency``
29
Frequency of the carrier to be modulated, in Hz.
31
Description
32
===========
34
Set send carrier used to modulate IR PWM pulses and spaces.
36
Return Value
37
============
39
On success 0 is returned, on error -1 and the ``errno`` variable is set
40
appropriately. The generic error codes are described at the
41
:ref:`Generic Error Codes <gen-errors>` chapter.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
이름, 선언과 인자
1-30`LIRC_SET_SEND_CARRIER`는 IR TX의 PWM pulse와 space를 modulation할 carrier frequency를 Hertz 단위로 설정합니다.
int ioctl(int fd, LIRC_SET_SEND_CARRIER, __u32 *frequency);인자설명
fdopen()이 반환한 LIRC 장치 file descriptor
frequency송신할 modulation carrier frequency(Hz)
IR transmitter의 modulation frequency를 전달합니다.
.. SPDX-License-Identifier: GPL-2.0 OR GFDL-1.1-no-invariants-or-later
.. c:namespace:: RC
.. _lirc_set_send_carrier:
***************************
ioctl LIRC_SET_SEND_CARRIER
***************************
Name
====
LIRC_SET_SEND_CARRIER - Set send carrier used to modulate IR TX.
Synopsis
========
.. c:macro:: LIRC_SET_SEND_CARRIER
``int ioctl(int fd, LIRC_SET_SEND_CARRIER, __u32 *frequency)``
Arguments
=========
``fd``
File descriptor returned by open().
``frequency``
Frequency of the carrier to be modulated, in Hz.
IR TX modulation 설정
31-35설정한 carrier는 이후 IR 송신에서 pulse가 켜진 구간의 PWM modulation에 사용됩니다. 호출 전에 `LIRC_CAN_SET_SEND_CARRIER` feature를 확인해야 합니다.
Carrier frequency는 protocol 또는 target receiver가 기대하는 값과 맞아야 하며, duty cycle은 별도 `LIRC_SET_SEND_DUTY_CYCLE`로 설정합니다.
Description
===========
Set send carrier used to modulate IR PWM pulses and spaces.
반환값
36-41성공하면 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-send-carrier.rst:1-41송신 carrier는 Hertz 단위이며 protocol과 target receiver에 맞춰야 합니다. Duty cycle은 별도 ioctl로 설정합니다.