요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0
3
Kernel driver kfan
4
==================
6
Supported chips:
8
* KEBA fan controller (IP core in FPGA)
10
Prefix: 'kfan'
12
Authors:
14
Gerhard Engleder <eg@keba.com>
15
Petar Bojanic <boja@keba.com>
17
Description
18
-----------
20
The KEBA fan controller is an IP core for FPGAs, which monitors the health
21
and controls the speed of a fan. The fan is typically used to cool the CPU
22
and the whole device. E.g., the CP500 FPGA includes this IP core to monitor
23
and control the fan of PLCs and the corresponding cp500 driver creates an
24
auxiliary device for the kfan driver.
26
This driver provides information about the fan health to user space.
27
The user space shall be informed if the fan is removed or blocked.
28
Additionally, the speed in RPM is reported for fans with tacho signal.
30
For fan control PWM is supported. For PWM 255 equals 100%. None-regulable
31
fans can be turned on with PWM 255 and turned off with PWM 0.
33
====================== ==== ===================================================
34
Attribute R/W Contents
35
====================== ==== ===================================================
36
fan1_fault R Fan fault
37
fan1_input R Fan tachometer input (in RPM)
38
pwm1 RW Fan target duty cycle (0..255)
39
====================== ==== ===================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
KEBA 팬 컨트롤러 IP 코어
1-16GPL-2.0 라이선스의 `kfan` 드라이버는 FPGA에 구현된 KEBA 팬 컨트롤러 IP 코어를 지원합니다. 접두사는 `kfan`이고 작성자는 Gerhard Engleder와 Petar Bojanic입니다.
항목값
장치KEBA fan controller
구현FPGA IP core
접두사kfan
작성자Gerhard Engleder, Petar Bojanic
지원 장치와 연결 형태입니다.
FPGA의 팬 IP 코어 탐색→cp500 등 상위 드라이버 결합→auxiliary device 생성→kfan 드라이버 결합→팬 상태·PWM 속성 게시
상위 FPGA 드라이버와 hwmon의 관계입니다.
.. SPDX-License-Identifier: GPL-2.0
Kernel driver kfan
==================
Supported chips:
* KEBA fan controller (IP core in FPGA)
Prefix: 'kfan'
Authors:
Gerhard Engleder <eg@keba.com>
Petar Bojanic <boja@keba.com>
팬 상태, 타코미터, PWM 제어
17-39KEBA 팬 컨트롤러는 FPGA용 IP 코어로 팬 상태를 감시하고 속도를 제어합니다. 팬은 보통 CPU와 장치 전체를 냉각합니다. CP500 FPGA의 예에서는 IP 코어가 PLC 팬을 감시·제어하고 `cp500` 드라이버가 `kfan` 보조 장치를 생성합니다.
드라이버는 팬이 제거되거나 막힌 경우 사용자 공간에 고장 상태를 알립니다. 타코 신호가 있는 팬은 RPM 단위 속도도 보고합니다.
팬 제어에는 PWM을 사용하며 값 255가 100% 듀티 사이클입니다. 속도 조절이 안 되는 팬도 PWM 255로 켜고 PWM 0으로 끌 수 있습니다.
속성권한내용
fan1_faultR팬 고장, 제거 또는 막힘
fan1_inputR타코미터 입력, RPM
pwm1RW목표 듀티 사이클 0~255
pwm1=255쓰기100%, 팬 켜기
pwm1=0쓰기팬 끄기
고장, 회전 속도, 목표 듀티 사이클을 구분했습니다.
fan1_fault로 팬 상태 확인→타코 신호가 있으면 fan1_input 읽기→필요한 목표 속도 결정→pwm1에 0~255 기록→고장과 RPM을 다시 확인
상태 확인과 PWM 출력이 함께 동작합니다.
Description
-----------
The KEBA fan controller is an IP core for FPGAs, which monitors the health
and controls the speed of a fan. The fan is typically used to cool the CPU
and the whole device. E.g., the CP500 FPGA includes this IP core to monitor
and control the fan of PLCs and the corresponding cp500 driver creates an
auxiliary device for the kfan driver.
This driver provides information about the fan health to user space.
The user space shall be informed if the fan is removed or blocked.
Additionally, the speed in RPM is reported for fans with tacho signal.
For fan control PWM is supported. For PWM 255 equals 100%. None-regulable
fans can be turned on with PWM 255 and turned off with PWM 0.
====================== ==== ===================================================
Attribute R/W Contents
====================== ==== ===================================================
fan1_fault R Fan fault
fan1_input R Fan tachometer input (in RPM)
pwm1 RW Fan target duty cycle (0..255)
====================== ==== ===================================================
요약·해설
kfan.rst:1-39FPGA 팬 컨트롤러에서 팬 제거·막힘을 감지하고 타코 RPM과 0~255 목표 PWM을 제공합니다.
원문 분량과 핵심 인터페이스입니다.
하드웨어 측정에서 hwmon 게시까지의 핵심 순서입니다.