1 .. SPDX-License-Identifier: GPL-2.0-or-later
3 Kernel driver aquacomputer-d5next
4 =================================
8 * Aquacomputer D5 Next watercooling pump
9 * Aquacomputer Farbwerk RGB controller
10 * Aquacomputer Farbwerk 360 RGB controller
11 * Aquacomputer Octo fan controller
18 This driver exposes hardware sensors of listed Aquacomputer devices, which
19 communicate through proprietary USB HID protocols.
21 For the D5 Next pump, available sensors are pump and fan speed, power, voltage
22 and current, as well as coolant temperature. Also available through debugfs are
23 the serial number, firmware version and power-on count. Attaching a fan to it is
24 optional and allows it to be controlled using temperature curves directly from the
25 pump. If it's not connected, the fan-related sensors will report zeroes.
27 The pump can be configured either through software or via its physical
28 interface. Configuring the pump through this driver is not implemented, as it
29 seems to require sending it a complete configuration. That includes addressable
30 RGB LEDs, for which there is no standard sysfs interface. Thus, that task is
31 better suited for userspace tools.
33 The Octo exposes four temperature sensors and eight PWM controllable fans, along
34 with their speed (in RPM), power, voltage and current.
36 The Farbwerk and Farbwerk 360 expose four temperature sensors. Depending on the device,
37 not all sysfs and debugfs entries will be available.
42 The devices communicate via HID reports. The driver is loaded automatically by
43 the kernel and supports hotswapping.
48 ================ =============================================
49 temp[1-4]_input Temperature sensors (in millidegrees Celsius)
50 fan[1-2]_input Pump/fan speed (in RPM)
51 power[1-2]_input Pump/fan power (in micro Watts)
52 in[0-2]_input Pump/fan voltage (in milli Volts)
53 curr[1-2]_input Pump/fan current (in milli Amperes)
54 ================ =============================================
59 ================ =================================================
60 serial_number Serial number of the device
61 firmware_version Version of installed firmware
62 power_cycles Count of how many times the device was powered on
63 ================ =================================================