요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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로 설정합니다.