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