요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Kernel driver pwm-fan
=====================
This driver enables the use of a PWM module to drive a fan. It uses the
generic PWM interface thus it is hardware independent. It can be used on
many SoCs, as long as the SoC supplies a PWM line driver that exposes
the generic PWM API.
Author: Kamil Debski <[email protected]>
Description
-----------
The driver implements a simple interface for driving a fan connected to
a PWM output. It uses the generic PWM interface, thus it can be used with
a range of SoCs. The driver exposes the fan to the user space through
the hwmon's sysfs interface.
The fan rotation speed returned via the optional 'fan1_input' is extrapolated
from the sampled interrupts from the tachometer signal within 1 second.
The driver provides the following sensor accesses in sysfs:
=============== ======= =======================================================
fan1_input ro fan tachometer speed in RPM
pwm1_enable rw keep enable mode, defines behaviour when pwm1=0
0 -> disable pwm and regulator
1 -> enable pwm; if pwm==0, disable pwm, keep regulator enabled
2 -> enable pwm; if pwm==0, keep pwm and regulator enabled
3 -> enable pwm; if pwm==0, disable pwm and regulator
pwm1 rw relative speed (0-255), 255=max. speed.
=============== ======= =======================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
하드웨어 독립적인 PWM 팬 드라이버
1-21Kamil Debski가 작성한 `pwm-fan` 드라이버는 PWM 모듈로 팬을 구동합니다. 일반 PWM 인터페이스를 사용하므로 하드웨어 독립적이며, 일반 PWM API를 노출하는 PWM 라인 드라이버를 SoC가 제공하면 여러 SoC에서 사용할 수 있습니다.
PWM 출력에 연결된 팬을 제어하는 단순 인터페이스를 구현하고 hwmon sysfs를 통해 사용자 공간에 공개합니다.
선택적 `fan1_input`의 팬 회전 속도는 1초 동안 타코미터 신호에서 샘플링한 인터럽트를 바탕으로 외삽해 계산합니다.
일반 PWM 출력과 선택적 타코미터 입력을 연결합니다.
PWM 출력과 타코미터 판독을 독립적으로 처리합니다.
Kernel driver pwm-fan
=====================
This driver enables the use of a PWM module to drive a fan. It uses the
generic PWM interface thus it is hardware independent. It can be used on
many SoCs, as long as the SoC supplies a PWM line driver that exposes
the generic PWM API.
Author: Kamil Debski <[email protected]>
Description
-----------
The driver implements a simple interface for driving a fan connected to
a PWM output. It uses the generic PWM interface, thus it can be used with
a range of SoCs. The driver exposes the fan to the user space through
the hwmon's sysfs interface.
The fan rotation speed returned via the optional 'fan1_input' is extrapolated
from the sampled interrupts from the tachometer signal within 1 second.
pwm1_enable 모드와 0 듀티 동작
22-32`fan1_input`은 읽기 전용이며 타코미터 팬 속도를 RPM으로 제공합니다.
`pwm1`은 읽기·쓰기가 가능한 상대 속도 0~255이고 255가 최고 속도입니다.
`pwm1_enable`은 읽기·쓰기가 가능하며 `pwm1=0`일 때 PWM과 레귤레이터를 어떻게 유지할지 정합니다.
모드 0은 PWM과 레귤레이터를 비활성화합니다. 모드 1은 PWM 모드를 사용하지만 듀티가 0이면 PWM만 끄고 레귤레이터는 켜 둡니다.
모드 2는 듀티가 0이어도 PWM과 레귤레이터를 모두 켜 둡니다. 모드 3은 PWM을 사용하지만 듀티가 0이면 PWM과 레귤레이터를 모두 끕니다.
pwm1=0일 때 PWM·레귤레이터 상태를 정확히 구분합니다.
정지 시 전원 유지 요구에 맞는 enable 모드를 선택합니다.
The driver provides the following sensor accesses in sysfs:
=============== ======= =======================================================
fan1_input ro fan tachometer speed in RPM
pwm1_enable rw keep enable mode, defines behaviour when pwm1=0
0 -> disable pwm and regulator
1 -> enable pwm; if pwm==0, disable pwm, keep regulator enabled
2 -> enable pwm; if pwm==0, keep pwm and regulator enabled
3 -> enable pwm; if pwm==0, disable pwm and regulator
pwm1 rw relative speed (0-255), 255=max. speed.
=============== ======= =======================================================
요약·해설
pwm-fan.rst:1-32하드웨어 독립적인 PWM 출력과 0~255 상대 속도를 제공하고 0 듀티에서 PWM·레귤레이터를 유지하는 네 모드를 정의합니다.
원문 분량과 핵심 장치 구성을 정리합니다.
장치 인식부터 측정·제어까지의 핵심 순서입니다.