1 .. SPDX-License-Identifier: GPL-2.0-or-later 1 .. SPDX-License-Identifier: GPL-2.0-or-later
2 2
3 Kernel driver aquacomputer-d5next 3 Kernel driver aquacomputer-d5next
4 ================================= 4 =================================
5 5
6 Supported devices: 6 Supported devices:
7 7
8 * Aquacomputer Aquaero 5/6 fan controllers <<
9 * Aquacomputer D5 Next watercooling pump 8 * Aquacomputer D5 Next watercooling pump
10 * Aquacomputer Farbwerk RGB controller 9 * Aquacomputer Farbwerk RGB controller
11 * Aquacomputer Farbwerk 360 RGB controller 10 * Aquacomputer Farbwerk 360 RGB controller
12 * Aquacomputer Octo fan controller 11 * Aquacomputer Octo fan controller
13 * Aquacomputer Quadro fan controller 12 * Aquacomputer Quadro fan controller
14 * Aquacomputer High Flow Next sensor <<
15 * Aquacomputer Leakshield leak prevention syst <<
16 * Aquacomputer Aquastream XT watercooling pump <<
17 * Aquacomputer Aquastream Ultimate watercoolin <<
18 * Aquacomputer Poweradjust 3 fan controller <<
19 * Aquacomputer High Flow USB flow meter <<
20 * Aquacomputer MPS Flow devices <<
21 13
22 Author: Aleksa Savic 14 Author: Aleksa Savic
23 15
24 Description 16 Description
25 ----------- 17 -----------
26 18
27 This driver exposes hardware sensors of listed 19 This driver exposes hardware sensors of listed Aquacomputer devices, which
28 communicate through proprietary USB HID protoc 20 communicate through proprietary USB HID protocols.
29 21
30 The Aquaero devices expose eight physical, eig <<
31 virtual temperature sensors, as well as two fl <<
32 speed (in RPM), power, voltage and current. Te <<
33 can be controlled. <<
34 <<
35 For the D5 Next pump, available sensors are pu 22 For the D5 Next pump, available sensors are pump and fan speed, power, voltage
36 and current, as well as coolant temperature an !! 23 and current, as well as coolant temperature. Also available through debugfs are
37 available through debugfs are the serial numbe !! 24 the serial number, firmware version and power-on count. Attaching a fan to it is
38 count. Attaching a fan to it is optional and a !! 25 optional and allows it to be controlled using temperature curves directly from the
39 temperature curves directly from the pump. If !! 26 pump. If it's not connected, the fan-related sensors will report zeroes.
40 sensors will report zeroes. <<
41 27
42 The pump can be configured either through soft 28 The pump can be configured either through software or via its physical
43 interface. Configuring the pump through this d 29 interface. Configuring the pump through this driver is not implemented, as it
44 seems to require sending it a complete configu 30 seems to require sending it a complete configuration. That includes addressable
45 RGB LEDs, for which there is no standard sysfs 31 RGB LEDs, for which there is no standard sysfs interface. Thus, that task is
46 better suited for userspace tools. 32 better suited for userspace tools.
47 33
48 The Octo exposes four physical and sixteen vir !! 34 The Octo exposes four temperature sensors and eight PWM controllable fans, along
49 as well as eight PWM controllable fans, along !! 35 with their speed (in RPM), power, voltage and current.
50 and current. Flow sensor pulses are also avail <<
51 <<
52 The Quadro exposes four physical and sixteen v <<
53 sensor and four PWM controllable fans, along w <<
54 voltage and current. Flow sensor pulses are al <<
55 <<
56 The Farbwerk and Farbwerk 360 expose four temp <<
57 sixteen virtual temperature sensors of the Far <<
58 <<
59 The High Flow Next exposes +5V voltages, water <<
60 A temperature sensor can be connected to it, i <<
61 and an estimation of the dissipated/absorbed p <<
62 <<
63 The Leakshield exposes two temperature sensors <<
64 target readings). It also exposes the estimate <<
65 filled with coolant. Pump RPM and flow can be <<
66 but this is not yet implemented here. <<
67 <<
68 The Aquastream XT pump exposes temperature rea <<
69 and fan IC. It also exposes pump and fan speed <<
70 current. <<
71 <<
72 The Aquastream Ultimate pump exposes coolant t <<
73 with speed, power, voltage and current of both <<
74 It also exposes pressure and flow speed readin <<
75 <<
76 The Poweradjust 3 controller exposes a single <<
77 <<
78 The High Flow USB exposes an internal and exte <<
79 36
80 The MPS Flow devices expose the same entries a !! 37 The Quadro exposes four temperature sensors, a flow sensor and four PWM controllable
81 the same USB product ID and report sensors equ !! 38 fans, along with their speed (in RPM), power, voltage and current.
82 39
83 Depending on the device, not all sysfs and deb !! 40 The Farbwerk and Farbwerk 360 expose four temperature sensors. Depending on the device,
84 Writing to virtual temperature sensors is not !! 41 not all sysfs and debugfs entries will be available.
85 42
86 Usage notes 43 Usage notes
87 ----------- 44 -----------
88 45
89 The devices communicate via HID reports. The d 46 The devices communicate via HID reports. The driver is loaded automatically by
90 the kernel and supports hotswapping. 47 the kernel and supports hotswapping.
91 48
92 Sysfs entries 49 Sysfs entries
93 ------------- 50 -------------
94 51
95 ================ ============================= !! 52 ================ ==============================================
96 temp[1-20]_input Physical/virtual temperature !! 53 temp[1-4]_input Temperature sensors (in millidegrees Celsius)
97 temp[1-8]_offset Temperature sensor correction !! 54 fan[1-8]_input Pump/fan speed (in RPM) / Flow speed (in dL/h)
98 fan[1-9]_input Pump/fan speed (in RPM) / Flo <<
99 fan1_min Minimal fan speed (in RPM) <<
100 fan1_max Maximal fan speed (in RPM) <<
101 fan1_target Target fan speed (in RPM) <<
102 fan5_pulses Quadro flow sensor pulses <<
103 fan9_pulses Octo flow sensor pulses <<
104 power[1-8]_input Pump/fan power (in micro Watt 55 power[1-8]_input Pump/fan power (in micro Watts)
105 in[0-7]_input Pump/fan voltage (in milli Vo 56 in[0-7]_input Pump/fan voltage (in milli Volts)
106 curr[1-8]_input Pump/fan current (in milli Am 57 curr[1-8]_input Pump/fan current (in milli Amperes)
107 pwm[1-8] Fan PWM (0 - 255) 58 pwm[1-8] Fan PWM (0 - 255)
108 ================ ============================= !! 59 ================ ==============================================
109 60
110 Debugfs entries 61 Debugfs entries
111 --------------- 62 ---------------
112 63
113 ================ ============================= 64 ================ =================================================
114 serial_number Serial number of the device 65 serial_number Serial number of the device
115 firmware_version Version of installed firmware 66 firmware_version Version of installed firmware
116 power_cycles Count of how many times the d 67 power_cycles Count of how many times the device was powered on
117 ================ ============================= 68 ================ =================================================
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.