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