요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
.. SPDX-License-Identifier: GPL-2.0-or-later
3
Kernel driver nzxt-kraken3
4
==========================
6
Supported devices:
8
* NZXT Kraken X53
9
* NZXT Kraken X63
10
* NZXT Kraken X73
11
* NZXT Kraken Z53
12
* NZXT Kraken Z63
13
* NZXT Kraken Z73
14
* NZXT Kraken 2023
15
* NZXT Kraken 2023 Elite
17
Author: Jonas Malaco, Aleksa Savic
19
Description
20
-----------
22
This driver enables hardware monitoring support for NZXT Kraken X53/X63/X73,
23
Z53/Z63/Z73 and Kraken 2023 (standard and Elite) all-in-one CPU liquid coolers.
24
All models expose liquid temperature and pump speed (in RPM), as well as PWM
25
control (either as a fixed value or through a temp-PWM curve). The Z-series and
26
Kraken 2023 models additionally expose the speed and duty of an optionally connected
27
fan, with the same PWM control capabilities.
29
Pump and fan duty control mode can be set through pwm[1-2]_enable, where 1 is
30
for the manual control mode and 2 is for the liquid temp to PWM curve mode.
31
Writing a 0 disables control of the channel through the driver after setting its
32
duty to 100%.
34
The temperature of the curves relates to the fixed [20-59] range, correlating to
35
the detected liquid temperature. Only PWM values (ranging from 0-255) can be set.
36
If in curve mode, setting point values should be done in moderation - the devices
37
require complete curves to be sent for each change; they can lock up or discard
38
the changes if they are too numerous at once. Suggestion is to set them while
39
in an another mode, and then apply them by switching to curve.
41
The devices can report if they are faulty. The driver supports that situation
42
and will issue a warning. This can also happen when the USB cable is connected,
43
but SATA power is not.
45
The addressable RGB LEDs and LCD screen (only on Z-series and Kraken 2023 models)
46
are not supported in this driver, but can be controlled through existing userspace
47
tools, such as `liquidctl`_.
49
.. _liquidctl: https://github.com/liquidctl/liquidctl
51
Usage Notes
52
-----------
54
As these are USB HIDs, the driver can be loaded automatically by the kernel and
55
supports hot swapping.
57
Possible pwm_enable values are:
59
====== ==========================================================================
60
0 Set fan to 100%
61
1 Direct PWM mode (applies value in corresponding PWM entry)
62
2 Curve control mode (applies the temp-PWM duty curve based on coolant temp)
63
====== ==========================================================================
65
Sysfs entries
66
-------------
68
============================== ================================================================
69
fan1_input Pump speed (in rpm)
70
fan2_input Fan speed (in rpm)
71
temp1_input Coolant temperature (in millidegrees Celsius)
72
pwm1 Pump duty (value between 0-255)
73
pwm1_enable Pump duty control mode (0: disabled, 1: manual, 2: curve)
74
pwm2 Fan duty (value between 0-255)
75
pwm2_enable Fan duty control mode (0: disabled, 1: manual, 2: curve)
76
temp[1-2]_auto_point[1-40]_pwm Temp-PWM duty curves (for pump and fan), related to coolant temp
77
============================== ================================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Kraken 3세대 장치와 PWM 제어
1-33GPL-2.0-or-later인 `nzxt-kraken3` 드라이버는 X53/X63/X73, Z53/Z63/Z73, Kraken 2023 및 Kraken 2023 Elite를 지원합니다. 작성자는 Jonas Malaco와 Aleksa Savic입니다.
모든 지원 장치는 냉각수 온도와 펌프 회전 속도를 제공하고, 펌프를 고정 듀티 또는 냉각수 온도-PWM 곡선으로 제어할 수 있습니다. Z 시리즈와 2023 시리즈는 연결된 팬의 속도와 듀티도 선택적으로 제공하며 같은 두 제어 방식을 사용합니다.
`pwm[1-2]_enable` 값 1은 직접 PWM 수동 제어, 값 2는 냉각수 온도 곡선 제어입니다. 0을 쓰면 먼저 듀티를 100%로 설정한 뒤 드라이버의 제어를 비활성화합니다.
온도 곡선의 온도 지점은 20°C부터 59°C까지 고정되어 있고, 각 지점의 PWM 값 0~255만 바꿀 수 있습니다.
제품군펌프추가 팬제어 방식
X53/X63/X73RPM·PWM없음고정 PWM 또는 온도 곡선
Z53/Z63/Z73RPM·PWM선택적 RPM·PWM고정 PWM 또는 온도 곡선
Kraken 2023/EliteRPM·PWM선택적 RPM·PWM고정 PWM 또는 온도 곡선
pwm_enable=0100% 후 제어 해제동일비활성화
pwm_enable=1직접 0~255직접 0~255수동
pwm_enable=220~59°C 곡선20~59°C 곡선자동
제품군별 센서와 PWM 제어를 정리합니다.
대상 펌프 또는 팬 채널 선택→pwm_enable 값 확인→0이면 100% 설정 후 드라이버 제어 해제→1이면 pwm 값을 직접 적용→2이면 40개 온도 곡선 지점 적용
제어 해제, 직접 제어, 곡선 제어 중 하나를 선택합니다.
.. SPDX-License-Identifier: GPL-2.0-or-later
Kernel driver nzxt-kraken3
==========================
Supported devices:
* NZXT Kraken X53
* NZXT Kraken X63
* NZXT Kraken X73
* NZXT Kraken Z53
* NZXT Kraken Z63
* NZXT Kraken Z73
* NZXT Kraken 2023
* NZXT Kraken 2023 Elite
Author: Jonas Malaco, Aleksa Savic
Description
-----------
This driver enables hardware monitoring support for NZXT Kraken X53/X63/X73,
Z53/Z63/Z73 and Kraken 2023 (standard and Elite) all-in-one CPU liquid coolers.
All models expose liquid temperature and pump speed (in RPM), as well as PWM
control (either as a fixed value or through a temp-PWM curve). The Z-series and
Kraken 2023 models additionally expose the speed and duty of an optionally connected
fan, with the same PWM control capabilities.
Pump and fan duty control mode can be set through pwm[1-2]_enable, where 1 is
for the manual control mode and 2 is for the liquid temp to PWM curve mode.
Writing a 0 disables control of the channel through the driver after setting its
duty to 100%.
곡선 전송 주의사항과 장치 오류
34-49곡선의 한 지점을 바꿀 때마다 드라이버는 완전한 곡선 전체를 장치로 전송합니다. 짧은 시간에 너무 많은 갱신을 보내면 장치가 잠기거나 일부 갱신을 버릴 수 있습니다.
안전하게 구성하려면 우선 곡선 모드가 아닌 다른 모드에서 모든 지점의 PWM 값을 설정하고, 설정이 끝난 뒤 `pwm_enable`을 곡선 모드 2로 전환해야 합니다.
드라이버는 장치가 오류 상태를 보고하면 경고를 출력합니다. USB 케이블은 연결되어 있지만 SATA 전원이 빠져 있는 경우에도 같은 오류 상태가 나타날 수 있으므로 전원 연결을 먼저 확인해야 합니다.
RGB LED와 LCD 화면은 이 드라이버에서 지원하지 않으며 `liquidctl` 같은 사용자 공간 도구를 사용할 수 있습니다.
상황원인대응
연속 지점 수정매번 전체 곡선 전송다른 모드에서 지점 설정
장치 잠김·갱신 유실너무 많은 짧은 간격 전송전송 횟수와 빈도 축소
오류 상태실제 장치 오류상태와 로그 확인
오류 상태USB만 연결되고 SATA 전원 없음SATA 전원 확인
RGB/LCD 제어 필요커널 드라이버 미지원liquidctl 사용
장치 잠김과 오류 오판을 줄이는 절차입니다.
pwm_enable을 직접 모드로 유지→40개 PWM 지점을 순서대로 설정→과도한 갱신 간격 피하기→설정 완료 후 곡선 모드 2 선택→오류 시 SATA 전원과 장치 상태 확인
전체 곡선 재전송 특성을 고려한 권장 순서입니다.
The temperature of the curves relates to the fixed [20-59] range, correlating to
the detected liquid temperature. Only PWM values (ranging from 0-255) can be set.
If in curve mode, setting point values should be done in moderation - the devices
require complete curves to be sent for each change; they can lock up or discard
the changes if they are too numerous at once. Suggestion is to set them while
in an another mode, and then apply them by switching to curve.
The devices can report if they are faulty. The driver supports that situation
and will issue a warning. This can also happen when the USB cable is connected,
but SATA power is not.
The addressable RGB LEDs and LCD screen (only on Z-series and Kraken 2023 models)
are not supported in this driver, but can be controlled through existing userspace
tools, such as `liquidctl`_.
.. _liquidctl: https://github.com/liquidctl/liquidctlUSB 사용과 sysfs 인터페이스
50-77장치는 USB HID로 자동 감지되고 드라이버도 자동 적재되며, 전원이 켜진 상태의 연결과 분리를 지원합니다.
`fan1_input`은 펌프 속도, 선택적인 `fan2_input`은 연결 팬 속도를 RPM으로 제공합니다. `temp1_input`은 냉각수 온도를 밀리도 섭씨로 제공합니다.
`pwm1`과 `pwm1_enable`은 펌프 듀티와 제어 모드를, `pwm2`와 `pwm2_enable`은 선택적 팬 듀티와 제어 모드를 담당합니다. 듀티 범위는 0~255입니다.
`temp[1-2]_auto_point[1-40]_pwm`은 펌프와 팬의 냉각수 온도-PWM 곡선을 구성합니다. 각 채널에는 20°C부터 59°C에 대응하는 40개 고정 온도 지점이 있습니다.
속성값 또는 단위대상
fan1_inputRPM펌프
fan2_inputRPM선택적 연결 팬
temp1_input밀리°C냉각수
pwm1 / pwm1_enable0~255 / 0~2펌프
pwm2 / pwm2_enable0~255 / 0~2선택적 팬
temp[1-2]_auto_point[1-40]_pwm0~25520~59°C 곡선
센서와 두 PWM 채널의 역할을 표시합니다.
USB HID 자동 인식→냉각수 온도와 RPM 읽기→펌프·팬 채널 존재 여부 확인→직접 PWM 또는 곡선 계산→듀티를 장치에 적용
USB 보고서를 읽고 선택한 제어 모드를 적용합니다.
Usage Notes
-----------
As these are USB HIDs, the driver can be loaded automatically by the kernel and
supports hot swapping.
Possible pwm_enable values are:
====== ==========================================================================
0 Set fan to 100%
1 Direct PWM mode (applies value in corresponding PWM entry)
2 Curve control mode (applies the temp-PWM duty curve based on coolant temp)
====== ==========================================================================
Sysfs entries
-------------
============================== ================================================================
fan1_input Pump speed (in rpm)
fan2_input Fan speed (in rpm)
temp1_input Coolant temperature (in millidegrees Celsius)
pwm1 Pump duty (value between 0-255)
pwm1_enable Pump duty control mode (0: disabled, 1: manual, 2: curve)
pwm2 Fan duty (value between 0-255)
pwm2_enable Fan duty control mode (0: disabled, 1: manual, 2: curve)
temp[1-2]_auto_point[1-40]_pwm Temp-PWM duty curves (for pump and fan), related to coolant temp
============================== ================================================================
요약·해설
nzxt-kraken3.rst:1-77X·Z·2023 계열의 냉각수와 RPM을 읽고 직접 PWM 또는 20~59°C의 40지점 곡선을 적용하며 과도한 곡선 전송을 경고합니다.
원문 분량과 핵심 장치 구성을 정리합니다.
장치 인식부터 측정·제어까지의 핵심 순서입니다.