42ac68e3d4
This driver exposes hardware sensors of the Gigabyte AORUS Waterforce all-in-one CPU liquid coolers, which communicate through a proprietary USB HID protocol. Report offsets were initially discovered in [1] and confirmed by me on a Waterforce X240 by observing the sent reports from the official software. Available sensors are pump and fan speed in RPM, as well as coolant temperature. Also available through debugfs is the firmware version. Attaching a fan is optional and allows it to be controlled from the device. If it's not connected, the fan-related sensors will report zeroes. The addressable RGB LEDs and LCD screen are not supported in this driver and should be controlled through userspace tools. [1]: https://github.com/liquidctl/liquidctl/issues/167 Signed-off-by: Aleksa Savic <savicaleksa83@gmail.com> Link: https://lore.kernel.org/r/20231207122402.107032-1-savicaleksa83@gmail.com Signed-off-by: Guenter Roeck <linux@roeck-us.net>
48 lines
1.3 KiB
ReStructuredText
48 lines
1.3 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0-or-later
|
|
|
|
Kernel driver gigabyte_waterforce
|
|
=================================
|
|
|
|
Supported devices:
|
|
|
|
* Gigabyte AORUS WATERFORCE X240
|
|
* Gigabyte AORUS WATERFORCE X280
|
|
* Gigabyte AORUS WATERFORCE X360
|
|
|
|
Author: Aleksa Savic
|
|
|
|
Description
|
|
-----------
|
|
|
|
This driver enables hardware monitoring support for the listed Gigabyte Waterforce
|
|
all-in-one CPU liquid coolers. Available sensors are pump and fan speed in RPM, as
|
|
well as coolant temperature. Also available through debugfs is the firmware version.
|
|
|
|
Attaching a fan is optional and allows it to be controlled from the device. If
|
|
it's not connected, the fan-related sensors will report zeroes.
|
|
|
|
The addressable RGB LEDs and LCD screen are not supported in this driver and should
|
|
be controlled through userspace tools.
|
|
|
|
Usage notes
|
|
-----------
|
|
|
|
As these are USB HIDs, the driver can be loaded automatically by the kernel and
|
|
supports hot swapping.
|
|
|
|
Sysfs entries
|
|
-------------
|
|
|
|
=========== =============================================
|
|
fan1_input Fan speed (in rpm)
|
|
fan2_input Pump speed (in rpm)
|
|
temp1_input Coolant temperature (in millidegrees Celsius)
|
|
=========== =============================================
|
|
|
|
Debugfs entries
|
|
---------------
|
|
|
|
================ =======================
|
|
firmware_version Device firmware version
|
|
================ =======================
|