1.. SPDX-License-Identifier: GPL-2.0-or-later
2
3Kernel driver asus_ec_sensors
4=================================
5
6Supported boards:
7 * PRIME X470-PRO
8 * PRIME X570-PRO
9 * Pro WS X570-ACE
10 * ProArt X570-CREATOR WIFI
11 * ROG CROSSHAIR VIII DARK HERO
12 * ROG CROSSHAIR VIII HERO (WI-FI)
13 * ROG CROSSHAIR VIII FORMULA
14 * ROG CROSSHAIR VIII HERO
15 * ROG CROSSHAIR VIII IMPACT
16 * ROG MAXIMUS XI HERO
17 * ROG MAXIMUS XI HERO (WI-FI)
18 * ROG STRIX B550-E GAMING
19 * ROG STRIX B550-I GAMING
20 * ROG STRIX X570-E GAMING
21 * ROG STRIX X570-E GAMING WIFI II
22 * ROG STRIX X570-F GAMING
23 * ROG STRIX X570-I GAMING
24 * ROG STRIX Z690-A GAMING WIFI D4
25 * ROG ZENITH II EXTREME
26 * ROG ZENITH II EXTREME ALPHA
27
28Authors:
29    - Eugene Shalygin <eugene.shalygin@gmail.com>
30
31Description:
32------------
33ASUS mainboards publish hardware monitoring information via Super I/O
34chip and the ACPI embedded controller (EC) registers. Some of the sensors
35are only available via the EC.
36
37The driver is aware of and reads the following sensors:
38
391. Chipset (PCH) temperature
402. CPU package temperature
413. Motherboard temperature
424. Readings from the T_Sensor header
435. VRM temperature
446. CPU_Opt fan RPM
457. VRM heatsink fan RPM
468. Chipset fan RPM
479. Readings from the "Water flow meter" header (RPM)
4810. Readings from the "Water In" and "Water Out" temperature headers
4911. CPU current
5012. CPU core voltage
51
52Sensor values are read from EC registers, and to avoid race with the board
53firmware the driver acquires ACPI mutex, the one used by the WMI when its
54methods access the EC.
55
56Module Parameters
57-----------------
58 * mutex_path: string
59		The driver holds path to the ACPI mutex for each board (actually,
60		the path is mostly identical for them). If ASUS changes this path
61		in a future BIOS update, this parameter can be used to override
62		the stored in the driver value until it gets updated.
63		A special string ":GLOBAL_LOCK" can be passed to use the ACPI
64		global lock instead of a dedicated mutex.
65