← Documents Documentation/hwmon/qnap-mcu-hwmon.rst GitHub 원문 ↗

Linux 6.18.37 · Hardware Monitoring

Kernel driver qnap-mcu-hwmon

QNAP NAS 관리 MCU를 통해 팬 PWM, 선택적 RPM, 케이스 온도를 제공합니다.

Source pathDocumentation/hwmon/qnap-mcu-hwmon.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

qnap-mcu-hwmon.rst:1-27

NAS 관리 MCU에 0~255 팬 출력을 설정하고 선택적으로 팬 RPM과 밀리섭씨 단위 케이스 온도를 읽습니다.

문서 개요
항목
SourceDocumentation/hwmon/qnap-mcu-hwmon.rst
분량27 source lines
PWM0~255
측정RPM·케이스 온도

원문 분량과 핵심 장치 구성을 정리합니다.

운영 흐름
MCU 결합온도 판독PWM 결정팬 출력 기록RPM 검증

장치 식별부터 센서 확인까지의 핵심 순서입니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0-or-later
2
3 Kernel driver qnap-mcu-hwmon
4 ============================
5
6 This driver enables the use of the hardware monitoring and fan control
7 of the MCU used on some QNAP network attached storage devices.
8
9 Author: Heiko Stuebner <[email protected]>
10
11 Description
12 -----------
13
14 The driver implements a simple interface for driving the fan controlled by
15 setting its PWM output value and exposes the fan rpm and case-temperature
16 to user space through hwmon's sysfs interface.
17
18 The fan rotation speed returned via the optional 'fan1_input' is calculated
19 inside the MCU device.
20
21 The driver provides the following sensor accesses in sysfs:
22
23 =============== ======= =======================================================
24 fan1_input ro fan tachometer speed in RPM
25 pwm1 rw relative speed (0-255), 255=max. speed.
26 temp1_input ro Measured temperature in millicelsius
27 =============== ======= =======================================================
28

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

QNAP NAS MCU 팬 제어

1-12

GPL-2.0-or-later 라이선스의 QNAP NAS MCU hwmon 드라이버는 QNAP NAS의 마이크로컨트롤러가 제공하는 팬 제어와 하드웨어 모니터링 기능을 연결합니다. 문서 작성자는 Heiko Stuebner입니다.

이 드라이버는 단순 PWM 팬 제어를 제공하며 MCU가 보고하는 팬 회전수와 섀시 내부 온도를 hwmon에 노출합니다.

QNAP MCU 기능
기능방향용도
PWM 팬 제어호스트→MCU팬 속도 설정
팬 RPMMCU→호스트회전 상태 감시
케이스 온도MCU→호스트섀시 열 상태 감시

NAS 관리 MCU에서 hwmon으로 전달하는 항목입니다.

MCU 기반 냉각 제어
QNAP NAS MCU 장치 결합현재 케이스 온도 판독필요한 PWM 값 결정MCU에 팬 출력 설정팬 RPM으로 실제 동작 확인

호스트의 PWM 요청과 MCU의 측정값을 결합합니다.

.. SPDX-License-Identifier: GPL-2.0-or-later

Kernel driver qnap-mcu-hwmon
============================

This driver enables the use of the hardware monitoring and fan control
of the MCU used on some QNAP network attached storage devices.

Author: Heiko Stuebner <[email protected]>

Description
-----------

팬 회전수·PWM·케이스 온도

13-27

팬 회전수 보고 기능은 선택 사항입니다. MCU가 해당 값을 지원하면 드라이버 내부에서 RPM으로 계산한 `fan1_input`을 읽기 전용으로 제공합니다.

`pwm1`은 읽기·쓰기가 가능한 팬 속도 값으로 범위는 0부터 255까지이며 255가 최대 속도입니다. `temp1_input`은 읽기 전용 케이스 온도이고 단위는 밀리섭씨입니다.

QNAP MCU sysfs 속성
속성접근단위·범위의미
fan1_inputRO, 선택 사항RPMMCU 측정값에서 계산한 팬 속도
pwm1RW0~255255가 최대 팬 속도
temp1_inputRO밀리섭씨케이스 온도

팬과 온도 인터페이스의 범위와 접근 권한입니다.

팬 설정과 검증
temp1_input으로 케이스 온도 확인0~255 범위의 pwm1 결정pwm1을 MCU에 기록fan1_input 지원 여부 확인RPM과 온도로 냉각 효과 검증

PWM 기록 후 선택적 RPM 값과 온도를 사용해 결과를 확인합니다.


The driver implements a simple interface for driving the fan controlled by
setting its PWM output value and exposes the fan rpm and case-temperature
to user space through hwmon's sysfs interface.

The fan rotation speed returned via the optional 'fan1_input' is calculated
inside the MCU device.

The driver provides the following sensor accesses in sysfs:

=============== ======= =======================================================
fan1_input        ro        fan tachometer speed in RPM
pwm1                rw        relative speed (0-255), 255=max. speed.
temp1_input        ro        Measured temperature in millicelsius
=============== ======= =======================================================