hwmon: add driver for Aquacomputer D5 Next
This driver exposes hardware sensors of the Aquacomputer D5 Next
watercooling pump, which communicates through a proprietary USB HID
protocol.
Available sensors are pump and fan speed, power, voltage and current, as
well as coolant temperature. Also available through debugfs are the serial
number, firmware version and power-on count.
Attaching a fan 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.
This driver has been tested on x86_64, both in-kernel and as a module.
Signed-off-by: Aleksa Savic <savicaleksa83@gmail.com>
Signed-off-by: Guenter Roeck <linux@roeck-us.net>
2021-08-28 05:26:28 +00:00
|
|
|
.. SPDX-License-Identifier: GPL-2.0-or-later
|
|
|
|
|
|
|
|
|
|
Kernel driver aquacomputer-d5next
|
|
|
|
|
=================================
|
|
|
|
|
|
|
|
|
|
Supported devices:
|
|
|
|
|
|
|
|
|
|
* Aquacomputer D5 Next watercooling pump
|
2022-04-24 05:14:22 +00:00
|
|
|
* Aquacomputer Farbwerk RGB controller
|
2022-02-27 20:56:25 +00:00
|
|
|
* Aquacomputer Farbwerk 360 RGB controller
|
2022-04-04 13:42:11 +00:00
|
|
|
* Aquacomputer Octo fan controller
|
hwmon: add driver for Aquacomputer D5 Next
This driver exposes hardware sensors of the Aquacomputer D5 Next
watercooling pump, which communicates through a proprietary USB HID
protocol.
Available sensors are pump and fan speed, power, voltage and current, as
well as coolant temperature. Also available through debugfs are the serial
number, firmware version and power-on count.
Attaching a fan 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.
This driver has been tested on x86_64, both in-kernel and as a module.
Signed-off-by: Aleksa Savic <savicaleksa83@gmail.com>
Signed-off-by: Guenter Roeck <linux@roeck-us.net>
2021-08-28 05:26:28 +00:00
|
|
|
|
|
|
|
|
Author: Aleksa Savic
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
-----------
|
|
|
|
|
|
2022-02-27 20:56:25 +00:00
|
|
|
This driver exposes hardware sensors of listed Aquacomputer devices, which
|
|
|
|
|
communicate through proprietary USB HID protocols.
|
hwmon: add driver for Aquacomputer D5 Next
This driver exposes hardware sensors of the Aquacomputer D5 Next
watercooling pump, which communicates through a proprietary USB HID
protocol.
Available sensors are pump and fan speed, power, voltage and current, as
well as coolant temperature. Also available through debugfs are the serial
number, firmware version and power-on count.
Attaching a fan 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.
This driver has been tested on x86_64, both in-kernel and as a module.
Signed-off-by: Aleksa Savic <savicaleksa83@gmail.com>
Signed-off-by: Guenter Roeck <linux@roeck-us.net>
2021-08-28 05:26:28 +00:00
|
|
|
|
2022-02-27 20:56:25 +00:00
|
|
|
For the D5 Next pump, available sensors are pump and fan speed, power, voltage
|
|
|
|
|
and current, as well as coolant temperature. 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.
|
hwmon: add driver for Aquacomputer D5 Next
This driver exposes hardware sensors of the Aquacomputer D5 Next
watercooling pump, which communicates through a proprietary USB HID
protocol.
Available sensors are pump and fan speed, power, voltage and current, as
well as coolant temperature. Also available through debugfs are the serial
number, firmware version and power-on count.
Attaching a fan 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.
This driver has been tested on x86_64, both in-kernel and as a module.
Signed-off-by: Aleksa Savic <savicaleksa83@gmail.com>
Signed-off-by: Guenter Roeck <linux@roeck-us.net>
2021-08-28 05:26:28 +00:00
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
2022-04-04 13:42:11 +00:00
|
|
|
The Octo exposes four temperature sensors and eight PWM controllable fans, along
|
|
|
|
|
with their speed (in RPM), power, voltage and current.
|
|
|
|
|
|
2022-04-24 05:14:22 +00:00
|
|
|
The Farbwerk and Farbwerk 360 expose four temperature sensors. Depending on the device,
|
2022-02-27 20:56:25 +00:00
|
|
|
not all sysfs and debugfs entries will be available.
|
|
|
|
|
|
hwmon: add driver for Aquacomputer D5 Next
This driver exposes hardware sensors of the Aquacomputer D5 Next
watercooling pump, which communicates through a proprietary USB HID
protocol.
Available sensors are pump and fan speed, power, voltage and current, as
well as coolant temperature. Also available through debugfs are the serial
number, firmware version and power-on count.
Attaching a fan 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.
This driver has been tested on x86_64, both in-kernel and as a module.
Signed-off-by: Aleksa Savic <savicaleksa83@gmail.com>
Signed-off-by: Guenter Roeck <linux@roeck-us.net>
2021-08-28 05:26:28 +00:00
|
|
|
Usage notes
|
|
|
|
|
-----------
|
|
|
|
|
|
2022-02-27 20:56:25 +00:00
|
|
|
The devices communicate via HID reports. The driver is loaded automatically by
|
hwmon: add driver for Aquacomputer D5 Next
This driver exposes hardware sensors of the Aquacomputer D5 Next
watercooling pump, which communicates through a proprietary USB HID
protocol.
Available sensors are pump and fan speed, power, voltage and current, as
well as coolant temperature. Also available through debugfs are the serial
number, firmware version and power-on count.
Attaching a fan 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.
This driver has been tested on x86_64, both in-kernel and as a module.
Signed-off-by: Aleksa Savic <savicaleksa83@gmail.com>
Signed-off-by: Guenter Roeck <linux@roeck-us.net>
2021-08-28 05:26:28 +00:00
|
|
|
the kernel and supports hotswapping.
|
|
|
|
|
|
|
|
|
|
Sysfs entries
|
|
|
|
|
-------------
|
|
|
|
|
|
2022-02-27 20:56:25 +00:00
|
|
|
================ =============================================
|
|
|
|
|
temp[1-4]_input Temperature sensors (in millidegrees Celsius)
|
|
|
|
|
fan[1-2]_input Pump/fan speed (in RPM)
|
|
|
|
|
power[1-2]_input Pump/fan power (in micro Watts)
|
|
|
|
|
in[0-2]_input Pump/fan voltage (in milli Volts)
|
|
|
|
|
curr[1-2]_input Pump/fan current (in milli Amperes)
|
|
|
|
|
================ =============================================
|
hwmon: add driver for Aquacomputer D5 Next
This driver exposes hardware sensors of the Aquacomputer D5 Next
watercooling pump, which communicates through a proprietary USB HID
protocol.
Available sensors are pump and fan speed, power, voltage and current, as
well as coolant temperature. Also available through debugfs are the serial
number, firmware version and power-on count.
Attaching a fan 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.
This driver has been tested on x86_64, both in-kernel and as a module.
Signed-off-by: Aleksa Savic <savicaleksa83@gmail.com>
Signed-off-by: Guenter Roeck <linux@roeck-us.net>
2021-08-28 05:26:28 +00:00
|
|
|
|
|
|
|
|
Debugfs entries
|
|
|
|
|
---------------
|
|
|
|
|
|
2022-02-27 20:56:25 +00:00
|
|
|
================ =================================================
|
|
|
|
|
serial_number Serial number of the device
|
hwmon: add driver for Aquacomputer D5 Next
This driver exposes hardware sensors of the Aquacomputer D5 Next
watercooling pump, which communicates through a proprietary USB HID
protocol.
Available sensors are pump and fan speed, power, voltage and current, as
well as coolant temperature. Also available through debugfs are the serial
number, firmware version and power-on count.
Attaching a fan 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.
This driver has been tested on x86_64, both in-kernel and as a module.
Signed-off-by: Aleksa Savic <savicaleksa83@gmail.com>
Signed-off-by: Guenter Roeck <linux@roeck-us.net>
2021-08-28 05:26:28 +00:00
|
|
|
firmware_version Version of installed firmware
|
2022-02-27 20:56:25 +00:00
|
|
|
power_cycles Count of how many times the device was powered on
|
|
|
|
|
================ =================================================
|
