mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-05 18:39:59 +00:00
82e3430dfa
These are "all-in-one" CPU liquid coolers that can be monitored and controlled through a proprietary USB HID protocol. While the models have differently sized radiators and come with varying numbers of fans, they are all indistinguishable at the software level. The driver exposes fan/pump speeds and coolant temperature through the standard hwmon sysfs interface. Fan and pump control, while supported by the devices, are not currently exposed. The firmware accepts up to 61 trip points per channel (fan/pump), but the same set of trip temperatures has to be maintained for both; with pwmX_auto_point_Y_temp attributes, users would need to maintain this invariant themselves. Instead, fan and pump control, as well as LED control (which the device also supports for 9 addressable RGB LEDs on the CPU water block) are left for existing and already mature user-space tools, which can still be used alongside the driver, thanks to hidraw. A link to one, which I also maintain, is provided in the documentation. The implementation is based on USB traffic analysis. It has been runtime tested on x86_64, both as a built-in driver and as a module. Signed-off-by: Jonas Malaco <jonas@protocubo.io> Link: https://lore.kernel.org/r/20210319045544.416138-1-jonas@protocubo.io [groeck: Removed unnecessary spinlock.h include] Signed-off-by: Guenter Roeck <linux@roeck-us.net>
42 lines
1.2 KiB
ReStructuredText
42 lines
1.2 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0-or-later
|
|
|
|
Kernel driver nzxt-kraken2
|
|
==========================
|
|
|
|
Supported devices:
|
|
|
|
* NZXT Kraken X42
|
|
* NZXT Kraken X52
|
|
* NZXT Kraken X62
|
|
* NZXT Kraken X72
|
|
|
|
Author: Jonas Malaco
|
|
|
|
Description
|
|
-----------
|
|
|
|
This driver enables hardware monitoring support for NZXT Kraken X42/X52/X62/X72
|
|
all-in-one CPU liquid coolers. Three sensors are available: fan speed, pump
|
|
speed and coolant temperature.
|
|
|
|
Fan and pump control, while supported by the firmware, are not currently
|
|
exposed. The addressable RGB LEDs, present in the integrated CPU water block
|
|
and pump head, are not supported either. But both features can be found in
|
|
existing user-space tools (e.g. `liquidctl`_).
|
|
|
|
.. _liquidctl: https://github.com/liquidctl/liquidctl
|
|
|
|
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)
|
|
======================= ========================================================
|