1*0314c6acSEugene Shalygin.. SPDX-License-Identifier: GPL-2.0-or-later
2*0314c6acSEugene Shalygin
3*0314c6acSEugene ShalyginKernel driver asus_ec_sensors
4*0314c6acSEugene Shalygin=================================
5*0314c6acSEugene Shalygin
6*0314c6acSEugene ShalyginSupported boards:
7*0314c6acSEugene Shalygin * PRIME X570-PRO,
8*0314c6acSEugene Shalygin * Pro WS X570-ACE,
9*0314c6acSEugene Shalygin * ROG CROSSHAIR VIII DARK HERO,
10*0314c6acSEugene Shalygin * ROG CROSSHAIR VIII FORMULA,
11*0314c6acSEugene Shalygin * ROG CROSSHAIR VIII HERO,
12*0314c6acSEugene Shalygin * ROG CROSSHAIR VIII IMPACT,
13*0314c6acSEugene Shalygin * ROG STRIX B550-E GAMING,
14*0314c6acSEugene Shalygin * ROG STRIX B550-I GAMING,
15*0314c6acSEugene Shalygin * ROG STRIX X570-E GAMING,
16*0314c6acSEugene Shalygin * ROG STRIX X570-F GAMING,
17*0314c6acSEugene Shalygin * ROG STRIX X570-I GAMING
18*0314c6acSEugene Shalygin
19*0314c6acSEugene ShalyginAuthors:
20*0314c6acSEugene Shalygin    - Eugene Shalygin <eugene.shalygin@gmail.com>
21*0314c6acSEugene Shalygin
22*0314c6acSEugene ShalyginDescription:
23*0314c6acSEugene Shalygin------------
24*0314c6acSEugene ShalyginASUS mainboards publish hardware monitoring information via Super I/O
25*0314c6acSEugene Shalyginchip and the ACPI embedded controller (EC) registers. Some of the sensors
26*0314c6acSEugene Shalyginare only available via the EC.
27*0314c6acSEugene Shalygin
28*0314c6acSEugene ShalyginThe driver is aware of and reads the following sensors:
29*0314c6acSEugene Shalygin
30*0314c6acSEugene Shalygin1. Chipset (PCH) temperature
31*0314c6acSEugene Shalygin2. CPU package temperature
32*0314c6acSEugene Shalygin3. Motherboard temperature
33*0314c6acSEugene Shalygin4. Readings from the T_Sensor header
34*0314c6acSEugene Shalygin5. VRM temperature
35*0314c6acSEugene Shalygin6. CPU_Opt fan RPM
36*0314c6acSEugene Shalygin7. VRM heatsink fan RPM
37*0314c6acSEugene Shalygin8. Chipset fan RPM
38*0314c6acSEugene Shalygin9. Readings from the "Water flow meter" header (RPM)
39*0314c6acSEugene Shalygin10. Readings from the "Water In" and "Water Out" temperature headers
40*0314c6acSEugene Shalygin11. CPU current
41*0314c6acSEugene Shalygin
42*0314c6acSEugene ShalyginSensor values are read from EC registers, and to avoid race with the board
43*0314c6acSEugene Shalyginfirmware the driver acquires ACPI mutex, the one used by the WMI when its
44*0314c6acSEugene Shalyginmethods access the EC.
45*0314c6acSEugene Shalygin
46*0314c6acSEugene ShalyginModule Parameters
47*0314c6acSEugene Shalygin-----------------
48*0314c6acSEugene Shalygin * mutex_path: string
49*0314c6acSEugene Shalygin		The driver holds path to the ACPI mutex for each board (actually,
50*0314c6acSEugene Shalygin		the path is mostly identical for them). If ASUS changes this path
51*0314c6acSEugene Shalygin		in a future BIOS update, this parameter can be used to override
52*0314c6acSEugene Shalygin		the stored in the driver value until it gets updated.
53