요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0-or-later
Kernel driver nzxt-smart2
=========================
Supported devices:
- NZXT RGB & Fan controller
- NZXT Smart Device v2
Description
-----------
This driver implements monitoring and control of fans plugged into the device.
Besides typical speed monitoring and PWM duty cycle control, voltage and current
is reported for every fan.
The device also has two connectors for RGB LEDs; support for them isn't
implemented (mainly because there is no standardized sysfs interface).
Also, the device has a noise sensor, but the sensor seems to be completely
useless (and very imprecise), so support for it isn't implemented too.
Usage Notes
-----------
The device should be autodetected, and the driver should load automatically.
If fans are plugged in/unplugged while the system is powered on, the driver
must be reloaded to detect configuration changes; otherwise, new fans can't
be controlled (`pwm*` changes will be ignored). It is necessary because the
device has a dedicated "detect fans" command, and currently, it is executed only
during initialization. Speed, voltage, current monitoring will work even without
reload. As an alternative to reloading the module, a userspace tool (like
`liquidctl`_) can be used to run "detect fans" command through hidraw interface.
The driver coexists with userspace tools that access the device through hidraw
interface with no known issues.
.. _liquidctl: https://github.com/liquidctl/liquidctl
Sysfs entries
-------------
======================= ========================================================
fan[1-3]_input Fan speed monitoring (in rpm).
curr[1-3]_input Current supplied to the fan (in milliamperes).
in[0-2]_input Voltage supplied to the fan (in millivolts).
pwm[1-3] Controls fan speed: PWM duty cycle for PWM-controlled
fans, voltage for other fans. Voltage can be changed in
9-12 V range, but the value of the sysfs attribute is
always in 0-255 range (1 = 9V, 255 = 12V). Setting the
attribute to 0 turns off the fan completely.
pwm[1-3]_enable 1 if the fan can be controlled by writing to the
corresponding pwm* attribute, 0 otherwise. The device
can control only the fans it detected itself, so the
attribute is read-only.
pwm[1-3]_mode Read-only, 1 for PWM-controlled fans, 0 for other fans
(or if no fan connected).
update_interval The interval at which all inputs are updated (in
milliseconds). The default is 1000ms. Minimum is 250ms.
======================= ========================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
NZXT RGB & Fan Controller의 지원 범위
1-23GPL-2.0-or-later `nzxt-smart2` 드라이버는 NZXT RGB & Fan Controller와 NZXT Smart Device v2를 지원합니다.
장치에 연결된 팬의 모니터링과 제어를 구현하며, 일반적인 회전 속도와 PWM 듀티뿐 아니라 각 팬에 공급되는 전압과 전류도 보고합니다.
장치에는 RGB LED용 커넥터 두 개가 있지만 표준화된 sysfs 인터페이스가 없어서 이 드라이버는 조명을 지원하지 않습니다.
소음 센서도 탑재되어 있으나 매우 부정확하고 실용성이 없다고 판단되어 지원하지 않습니다.
하드웨어 기능과 드라이버 지원 상태를 구분합니다.
팬 한 채널에서 여러 전기·기계 값을 함께 제공합니다.
.. SPDX-License-Identifier: GPL-2.0-or-later
Kernel driver nzxt-smart2
=========================
Supported devices:
- NZXT RGB & Fan controller
- NZXT Smart Device v2
Description
-----------
This driver implements monitoring and control of fans plugged into the device.
Besides typical speed monitoring and PWM duty cycle control, voltage and current
is reported for every fan.
The device also has two connectors for RGB LEDs; support for them isn't
implemented (mainly because there is no standardized sysfs interface).
Also, the device has a noise sensor, but the sensor seems to be completely
useless (and very imprecise), so support for it isn't implemented too.
팬 핫플러그와 재감지
24-40장치는 자동으로 감지되고 드라이버도 자동 적재됩니다. 그러나 시스템이 켜진 상태에서 팬을 연결하거나 분리한 경우에는 구성이 바뀐 사실을 감지하도록 드라이버를 다시 적재해야 합니다.
재적재하지 않으면 새 팬의 `pwm*` 변경은 무시되어 제어할 수 없습니다. 장치에 전용 `detect fans` 명령이 있으며 현재 드라이버는 초기화할 때만 이 명령을 실행하기 때문입니다.
재적재하지 않아도 속도, 전압, 전류 모니터링은 계속 동작합니다. 대안으로 `liquidctl` 같은 사용자 공간 도구가 hidraw 인터페이스를 통해 `detect fans` 명령을 실행할 수 있습니다.
드라이버와 hidraw로 장치에 접근하는 사용자 공간 도구는 알려진 문제 없이 함께 사용할 수 있습니다.
핫플러그 뒤 모니터링과 제어의 차이를 보여줍니다.
구성 변경 후 제어 채널을 다시 활성화합니다.
Usage Notes
-----------
The device should be autodetected, and the driver should load automatically.
If fans are plugged in/unplugged while the system is powered on, the driver
must be reloaded to detect configuration changes; otherwise, new fans can't
be controlled (`pwm*` changes will be ignored). It is necessary because the
device has a dedicated "detect fans" command, and currently, it is executed only
during initialization. Speed, voltage, current monitoring will work even without
reload. As an alternative to reloading the module, a userspace tool (like
`liquidctl`_) can be used to run "detect fans" command through hidraw interface.
The driver coexists with userspace tools that access the device through hidraw
interface with no known issues.
.. _liquidctl: https://github.com/liquidctl/liquidctl팬별 측정과 PWM 속성
41-62`fan[1-3]_input`은 팬 속도를 RPM으로, `curr[1-3]_input`은 공급 전류를 밀리암페어로, `in[0-2]_input`은 공급 전압을 밀리볼트로 보고합니다.
`pwm[1-3]`은 PWM 팬에서는 듀티를, 그 밖의 팬에서는 공급 전압을 제어합니다. 전압 제어 팬은 9~12V 범위이지만 sysfs 값은 항상 0~255이며, 값 1은 9V, 값 255는 12V입니다. 0을 쓰면 팬을 완전히 끕니다.
읽기 전용 `pwm[1-3]_enable`은 장치가 해당 팬을 자체 감지하여 `pwm*` 쓰기로 제어할 수 있으면 1, 아니면 0입니다. `pwm[1-3]_mode`도 읽기 전용이며 PWM 팬이면 1, 비-PWM 팬 또는 미연결이면 0입니다.
`update_interval`은 모든 입력의 갱신 간격을 밀리초로 설정합니다. 기본값은 1000밀리초이고 허용되는 최소값은 250밀리초입니다.
세 팬 채널의 측정·제어 속성을 정리합니다.
감지 상태와 팬 방식을 확인한 뒤 출력값을 적용합니다.
Sysfs entries
-------------
======================= ========================================================
fan[1-3]_input Fan speed monitoring (in rpm).
curr[1-3]_input Current supplied to the fan (in milliamperes).
in[0-2]_input Voltage supplied to the fan (in millivolts).
pwm[1-3] Controls fan speed: PWM duty cycle for PWM-controlled
fans, voltage for other fans. Voltage can be changed in
9-12 V range, but the value of the sysfs attribute is
always in 0-255 range (1 = 9V, 255 = 12V). Setting the
attribute to 0 turns off the fan completely.
pwm[1-3]_enable 1 if the fan can be controlled by writing to the
corresponding pwm* attribute, 0 otherwise. The device
can control only the fans it detected itself, so the
attribute is read-only.
pwm[1-3]_mode Read-only, 1 for PWM-controlled fans, 0 for other fans
(or if no fan connected).
update_interval The interval at which all inputs are updated (in
milliseconds). The default is 1000ms. Minimum is 250ms.
======================= ========================================================
요약·해설
nzxt-smart2.rst:1-62세 팬의 RPM·전류·전압을 읽고 0~255 출력으로 제어하며, 전원 중 팬 구성 변경 시 재감지가 필요합니다.
원문 분량과 핵심 장치 구성을 정리합니다.
장치 인식부터 측정·제어까지의 핵심 순서입니다.