요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0-or-later
Kernel driver aquacomputer-d5next
=================================
Supported devices:
* Aquacomputer Aquaero 5/6 fan controllers
* Aquacomputer D5 Next watercooling pump
* Aquacomputer Farbwerk RGB controller
* Aquacomputer Farbwerk 360 RGB controller
* Aquacomputer Octo fan controller
* Aquacomputer Quadro fan controller
* Aquacomputer High Flow Next sensor
* Aquacomputer Leakshield leak prevention system
* Aquacomputer Aquastream XT watercooling pump
* Aquacomputer Aquastream Ultimate watercooling pump
* Aquacomputer Poweradjust 3 fan controller
* Aquacomputer High Flow USB flow meter
* Aquacomputer MPS Flow devices
Author: Aleksa Savic
Description
-----------
This driver exposes hardware sensors of listed Aquacomputer devices, which
communicate through proprietary USB HID protocols.
The Aquaero devices expose eight physical, eight virtual and four calculated
virtual temperature sensors, as well as two flow sensors. The fans expose their
speed (in RPM), power, voltage and current. Temperature offsets and fan speeds
can be controlled.
For the D5 Next pump, available sensors are pump and fan speed, power, voltage
and current, as well as coolant temperature and eight virtual temp sensors. Also
available through debugfs are the serial number, firmware version and power-on
count. Attaching a fan to it is optional and allows it to be controlled using
temperature curves directly from the pump. If it's not connected, the fan-related
sensors will report zeroes.
The pump can be configured either through software or via its physical
interface. Configuring the pump through this driver is not implemented, as it
seems to require sending it a complete configuration. That includes addressable
RGB LEDs, for which there is no standard sysfs interface. Thus, that task is
better suited for userspace tools.
The Octo exposes four physical and sixteen virtual temperature sensors, a flow sensor
as well as eight PWM controllable fans, along with their speed (in RPM), power, voltage
and current. Flow sensor pulses are also available.
The Quadro exposes four physical and sixteen virtual temperature sensors, a flow
sensor and four PWM controllable fans, along with their speed (in RPM), power,
voltage and current. Flow sensor pulses are also available.
The Farbwerk and Farbwerk 360 expose four temperature sensors. Additionally,
sixteen virtual temperature sensors of the Farbwerk 360 are exposed.
The High Flow Next exposes +5V voltages, water quality, conductivity and flow readings.
A temperature sensor can be connected to it, in which case it provides its reading
and an estimation of the dissipated/absorbed power in the liquid cooling loop.
The Leakshield exposes two temperature sensors and coolant pressure (current, min, max and
target readings). It also exposes the estimated reservoir volume and how much of it is
filled with coolant. Pump RPM and flow can be set to enhance on-device calculations,
but this is not yet implemented here.
The Aquastream XT pump exposes temperature readings for the coolant, external sensor
and fan IC. It also exposes pump and fan speeds (in RPM), voltages, as well as pump
current.
The Aquastream Ultimate pump exposes coolant temp and an external temp sensor, along
with speed, power, voltage and current of both the pump and optionally connected fan.
It also exposes pressure and flow speed readings.
The Poweradjust 3 controller exposes a single external temperature sensor.
The High Flow USB exposes an internal and external temperature sensor, and a flow meter.
The MPS Flow devices expose the same entries as the High Flow USB because they have
the same USB product ID and report sensors equivalently.
Depending on the device, not all sysfs and debugfs entries will be available.
Writing to virtual temperature sensors is not currently supported.
Usage notes
-----------
The devices communicate via HID reports. The driver is loaded automatically by
the kernel and supports hotswapping.
Sysfs entries
-------------
================ ==============================================================
temp[1-20]_input Physical/virtual temperature sensors (in millidegrees Celsius)
temp[1-8]_offset Temperature sensor correction offset (in millidegrees Celsius)
fan[1-9]_input Pump/fan speed (in RPM) / Flow speed (in dL/h)
fan1_min Minimal fan speed (in RPM)
fan1_max Maximal fan speed (in RPM)
fan1_target Target fan speed (in RPM)
fan5_pulses Quadro flow sensor pulses
fan9_pulses Octo flow sensor pulses
power[1-8]_input Pump/fan power (in micro Watts)
in[0-7]_input Pump/fan voltage (in milli Volts)
curr[1-8]_input Pump/fan current (in milli Amperes)
pwm[1-8] Fan PWM (0 - 255)
================ ==============================================================
Debugfs entries
---------------
================ =================================================
serial_number Serial number of the device
firmware_version Version of installed firmware
power_cycles Count of how many times the device was powered on
================ =================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
지원 장치와 Aquaero·D5 Next
1-46이 GPL-2.0-or-later 드라이버는 Aquacomputer Aquaero 5/6 fan controller, D5 Next watercooling pump, Farbwerk와 Farbwerk 360 RGB controller, Octo와 Quadro fan controller, High Flow Next sensor, Leakshield, Aquastream XT와 Ultimate pump, Poweradjust 3, High Flow USB flow meter, MPS Flow device를 지원합니다. 저자는 Aleksa Savic입니다.
나열한 장치들은 proprietary USB HID protocol로 통신하며, driver는 이들의 hardware sensor를 hwmon에 노출합니다.
Aquaero는 physical temperature sensor 8개, virtual sensor 8개, 계산된 virtual sensor 4개, flow sensor 2개를 제공합니다. Fan은 RPM speed, power, voltage, current를 보고하며 temperature offset과 fan speed를 제어할 수 있습니다.
D5 Next pump에서는 pump와 fan의 speed·power·voltage·current, coolant temperature, virtual temperature sensor 8개를 사용할 수 있습니다. Debugfs에는 serial number, firmware version, power-on count도 있습니다. Fan 연결은 선택 사항이며 연결하면 pump 자체의 temperature curve로 제어할 수 있습니다. 연결하지 않으면 fan 관련 sensor는 0을 보고합니다.
Pump 설정은 software 또는 physical interface에서 할 수 있지만 이 driver는 설정 기능을 구현하지 않습니다. 완전한 configuration을 한 번에 전송해야 하는 것으로 보이고, 표준 sysfs interface가 없는 addressable RGB LED 설정까지 포함되기 때문입니다. 따라서 configuration은 userspace tool에 더 적합합니다.
Driver가 처리하는 대표 장치와 기능입니다.
장치 report를 모델별 hwmon channel로 변환합니다.
.. SPDX-License-Identifier: GPL-2.0-or-later
Kernel driver aquacomputer-d5next
=================================
Supported devices:
* Aquacomputer Aquaero 5/6 fan controllers
* Aquacomputer D5 Next watercooling pump
* Aquacomputer Farbwerk RGB controller
* Aquacomputer Farbwerk 360 RGB controller
* Aquacomputer Octo fan controller
* Aquacomputer Quadro fan controller
* Aquacomputer High Flow Next sensor
* Aquacomputer Leakshield leak prevention system
* Aquacomputer Aquastream XT watercooling pump
* Aquacomputer Aquastream Ultimate watercooling pump
* Aquacomputer Poweradjust 3 fan controller
* Aquacomputer High Flow USB flow meter
* Aquacomputer MPS Flow devices
Author: Aleksa Savic
Description
-----------
This driver exposes hardware sensors of listed Aquacomputer devices, which
communicate through proprietary USB HID protocols.
The Aquaero devices expose eight physical, eight virtual and four calculated
virtual temperature sensors, as well as two flow sensors. The fans expose their
speed (in RPM), power, voltage and current. Temperature offsets and fan speeds
can be controlled.
For the D5 Next pump, available sensors are pump and fan speed, power, voltage
and current, as well as coolant temperature and eight virtual temp sensors. Also
available through debugfs are the serial number, firmware version and power-on
count. Attaching a fan to it is optional and allows it to be controlled using
temperature curves directly from the pump. If it's not connected, the fan-related
sensors will report zeroes.
The pump can be configured either through software or via its physical
interface. Configuring the pump through this driver is not implemented, as it
seems to require sending it a complete configuration. That includes addressable
RGB LEDs, for which there is no standard sysfs interface. Thus, that task is
better suited for userspace tools.Octo부터 MPS Flow까지의 센서
47-84Octo는 physical temperature sensor 4개, virtual temperature sensor 16개, flow sensor 1개, PWM 제어 fan 8개를 제공합니다. 각 fan의 RPM speed, power, voltage, current와 flow sensor pulse를 읽을 수 있습니다.
Quadro는 physical temperature sensor 4개, virtual sensor 16개, flow sensor 1개, PWM fan 4개와 각 fan의 RPM·power·voltage·current를 제공합니다. Flow sensor pulse도 읽을 수 있습니다.
Farbwerk와 Farbwerk 360은 temperature sensor 4개를 노출합니다. Farbwerk 360에는 virtual temperature sensor 16개가 추가됩니다.
High Flow Next는 +5V voltage, water quality, conductivity, flow를 보고합니다. Temperature sensor를 연결하면 그 값과 liquid cooling loop에서 dissipated 또는 absorbed power의 추정치도 제공합니다.
Leakshield는 temperature sensor 2개와 coolant pressure의 current·minimum·maximum·target reading을 제공합니다. 추정 reservoir volume과 coolant 충전량도 노출합니다. On-device 계산을 개선하도록 pump RPM과 flow를 설정하는 기능은 아직 구현되지 않았습니다.
Aquastream XT는 coolant, external sensor, fan IC temperature와 pump·fan RPM, voltage, pump current를 제공합니다. Aquastream Ultimate는 coolant와 external temperature, pump와 선택 fan의 speed·power·voltage·current, pressure, flow speed를 제공합니다.
Poweradjust 3은 external temperature sensor 하나를 제공합니다. High Flow USB는 internal·external temperature sensor와 flow meter를 제공합니다. MPS Flow는 같은 USB product ID를 사용하고 sensor report도 같으므로 High Flow USB와 동일한 항목을 노출합니다.
장치에 따라 모든 sysfs·debugfs entry가 존재하는 것은 아닙니다. Virtual temperature sensor에 쓰는 기능은 현재 지원하지 않습니다.
주요 장치의 채널 수와 특수 측정값입니다.
USB product와 report capability에 맞춰 entry를 선택합니다.
The Octo exposes four physical and sixteen virtual temperature sensors, a flow sensor
as well as eight PWM controllable fans, along with their speed (in RPM), power, voltage
and current. Flow sensor pulses are also available.
The Quadro exposes four physical and sixteen virtual temperature sensors, a flow
sensor and four PWM controllable fans, along with their speed (in RPM), power,
voltage and current. Flow sensor pulses are also available.
The Farbwerk and Farbwerk 360 expose four temperature sensors. Additionally,
sixteen virtual temperature sensors of the Farbwerk 360 are exposed.
The High Flow Next exposes +5V voltages, water quality, conductivity and flow readings.
A temperature sensor can be connected to it, in which case it provides its reading
and an estimation of the dissipated/absorbed power in the liquid cooling loop.
The Leakshield exposes two temperature sensors and coolant pressure (current, min, max and
target readings). It also exposes the estimated reservoir volume and how much of it is
filled with coolant. Pump RPM and flow can be set to enhance on-device calculations,
but this is not yet implemented here.
The Aquastream XT pump exposes temperature readings for the coolant, external sensor
and fan IC. It also exposes pump and fan speeds (in RPM), voltages, as well as pump
current.
The Aquastream Ultimate pump exposes coolant temp and an external temp sensor, along
with speed, power, voltage and current of both the pump and optionally connected fan.
It also exposes pressure and flow speed readings.
The Poweradjust 3 controller exposes a single external temperature sensor.
The High Flow USB exposes an internal and external temperature sensor, and a flow meter.
The MPS Flow devices expose the same entries as the High Flow USB because they have
the same USB product ID and report sensors equivalently.
Depending on the device, not all sysfs and debugfs entries will be available.
Writing to virtual temperature sensors is not currently supported.HID 동작과 sysfs·debugfs
85-117장치는 HID report로 통신합니다. Kernel이 driver를 자동으로 load하며 hot swapping을 지원합니다.
`temp[1-20]_input`은 physical/virtual temperature를 millidegrees Celsius로, `temp[1-8]_offset`은 temperature correction offset을 같은 단위로 제공합니다. `fan[1-9]_input`은 pump/fan speed를 RPM으로 또는 flow speed를 dL/h로 제공합니다.
`fan1_min`, `fan1_max`, `fan1_target`은 minimum, maximum, target fan speed를 RPM으로 다룹니다. `fan5_pulses`는 Quadro flow sensor pulse, `fan9_pulses`는 Octo flow sensor pulse입니다.
`power[1-8]_input`은 pump/fan power를 micro Watts, `in[0-7]_input`은 voltage를 milli Volts, `curr[1-8]_input`은 current를 milli Amperes로 제공합니다. `pwm[1-8]`은 0~255 범위의 fan PWM입니다.
Debugfs의 `serial_number`, `firmware_version`, `power_cycles`는 각각 device serial number, 설치된 firmware version, 전원이 켜진 횟수를 제공합니다.
Sysfs와 debugfs의 값과 단위를 정리합니다.
연결 변화에 따라 모델별 sensor interface를 동적으로 구성합니다.
Usage notes
-----------
The devices communicate via HID reports. The driver is loaded automatically by
the kernel and supports hotswapping.
Sysfs entries
-------------
================ ==============================================================
temp[1-20]_input Physical/virtual temperature sensors (in millidegrees Celsius)
temp[1-8]_offset Temperature sensor correction offset (in millidegrees Celsius)
fan[1-9]_input Pump/fan speed (in RPM) / Flow speed (in dL/h)
fan1_min Minimal fan speed (in RPM)
fan1_max Maximal fan speed (in RPM)
fan1_target Target fan speed (in RPM)
fan5_pulses Quadro flow sensor pulses
fan9_pulses Octo flow sensor pulses
power[1-8]_input Pump/fan power (in micro Watts)
in[0-7]_input Pump/fan voltage (in milli Volts)
curr[1-8]_input Pump/fan current (in milli Amperes)
pwm[1-8] Fan PWM (0 - 255)
================ ==============================================================
Debugfs entries
---------------
================ =================================================
serial_number Serial number of the device
firmware_version Version of installed firmware
power_cycles Count of how many times the device was powered on
================ =================================================
요약·해설
aquacomputer_d5next.rst:1-117여러 Aquacomputer cooling device의 model-specific HID report를 공통 hwmon·debugfs interface로 노출합니다.
원문 분량과 핵심 지원 범위입니다.
장치를 구성하고 측정·제어하는 기본 순서입니다.