1.. SPDX-License-Identifier: GPL-2.0-or-later
2
3Kernel driver asus_wmi_sensors
4=================================
5
6Supported boards:
7 * PRIME X399-A,
8 * PRIME X470-PRO,
9 * ROG CROSSHAIR VI EXTREME,
10 * ROG CROSSHAIR VI HERO,
11 * ROG CROSSHAIR VI HERO (WI-FI AC),
12 * ROG CROSSHAIR VII HERO,
13 * ROG CROSSHAIR VII HERO (WI-FI),
14 * ROG STRIX B450-E GAMING,
15 * ROG STRIX B450-F GAMING,
16 * ROG STRIX B450-I GAMING,
17 * ROG STRIX X399-E GAMING,
18 * ROG STRIX X470-F GAMING,
19 * ROG STRIX X470-I GAMING,
20 * ROG ZENITH EXTREME,
21 * ROG ZENITH EXTREME ALPHA.
22
23Authors:
24    - Ed Brindley <kernel@maidavale.org>
25
26Description:
27------------
28ASUS mainboards publish hardware monitoring information via WMI interface.
29
30ASUS WMI interface provides a methods to get list of sensors and values of
31such, which is utilized by this driver to publish those sensor readings to the
32HWMON system.
33
34The driver is aware of and reads the following sensors:
35 * CPU Core Voltage,
36 * CPU SOC Voltage,
37 * DRAM Voltage,
38 * VDDP Voltage,
39 * 1.8V PLL Voltage,
40 * +12V Voltage,
41 * +5V Voltage,
42 * 3VSB Voltage,
43 * VBAT Voltage,
44 * AVCC3 Voltage,
45 * SB 1.05V Voltage,
46 * CPU Core Voltage,
47 * CPU SOC Voltage,
48 * DRAM Voltage,
49 * CPU Fan RPM,
50 * Chassis Fan 1 RPM,
51 * Chassis Fan 2 RPM,
52 * Chassis Fan 3 RPM,
53 * HAMP Fan RPM,
54 * Water Pump RPM,
55 * CPU OPT RPM,
56 * Water Flow RPM,
57 * AIO Pump RPM,
58 * CPU Temperature,
59 * CPU Socket Temperature,
60 * Motherboard Temperature,
61 * Chipset Temperature,
62 * Tsensor 1 Temperature,
63 * CPU VRM Temperature,
64 * Water In,
65 * Water Out,
66 * CPU VRM Output Current.
67
68Known Issues:
69 * The WMI implementation in some of Asus' BIOSes is buggy. This can result in
70   fans stopping, fans getting stuck at max speed, or temperature readouts
71   getting stuck. This is not an issue with the driver, but the BIOS. The Prime
72   X470 Pro seems particularly bad for this. The more frequently the WMI
73   interface is polled the greater the potential for this to happen. Until you
74   have subjected your computer to an extended soak test while polling the
75   sensors frequently, don't leave you computer unattended. Upgrading to new
76   BIOS version with method version greater than or equal to two should
77   rectify the issue.
78 * A few boards report 12v voltages to be ~10v.
79