10314c6acSEugene Shalygin.. SPDX-License-Identifier: GPL-2.0-or-later
20314c6acSEugene Shalygin
30314c6acSEugene ShalyginKernel driver asus_ec_sensors
40314c6acSEugene Shalygin=================================
50314c6acSEugene Shalygin
60314c6acSEugene ShalyginSupported boards:
79ccafe46SDebabrata Banerjee * PRIME X470-PRO
89ccafe46SDebabrata Banerjee * PRIME X570-PRO
99ccafe46SDebabrata Banerjee * Pro WS X570-ACE
10d7cc063fSEugene Shalygin * ProArt X570-CREATOR WIFI
119ccafe46SDebabrata Banerjee * ROG CROSSHAIR VIII DARK HERO
122f66cb5bSEugene Shalygin * ROG CROSSHAIR VIII HERO (WI-FI)
139ccafe46SDebabrata Banerjee * ROG CROSSHAIR VIII FORMULA
149ccafe46SDebabrata Banerjee * ROG CROSSHAIR VIII HERO
159ccafe46SDebabrata Banerjee * ROG CROSSHAIR VIII IMPACT
168f9eb10fSMichael Carns * ROG MAXIMUS XI HERO
178f9eb10fSMichael Carns * ROG MAXIMUS XI HERO (WI-FI)
189ccafe46SDebabrata Banerjee * ROG STRIX B550-E GAMING
199ccafe46SDebabrata Banerjee * ROG STRIX B550-I GAMING
209ccafe46SDebabrata Banerjee * ROG STRIX X570-E GAMING
219ccafe46SDebabrata Banerjee * ROG STRIX X570-E GAMING WIFI II
229ccafe46SDebabrata Banerjee * ROG STRIX X570-F GAMING
230314c6acSEugene Shalygin * ROG STRIX X570-I GAMING
24bae26b80SShady Nawara * ROG STRIX Z690-A GAMING WIFI D4
259992b19dSUrs Schroffenegger * ROG ZENITH II EXTREME
26*195f46e5SEric Nguyen * ROG ZENITH II EXTREME ALPHA
270314c6acSEugene Shalygin
280314c6acSEugene ShalyginAuthors:
290314c6acSEugene Shalygin    - Eugene Shalygin <eugene.shalygin@gmail.com>
300314c6acSEugene Shalygin
310314c6acSEugene ShalyginDescription:
320314c6acSEugene Shalygin------------
330314c6acSEugene ShalyginASUS mainboards publish hardware monitoring information via Super I/O
340314c6acSEugene Shalyginchip and the ACPI embedded controller (EC) registers. Some of the sensors
350314c6acSEugene Shalyginare only available via the EC.
360314c6acSEugene Shalygin
370314c6acSEugene ShalyginThe driver is aware of and reads the following sensors:
380314c6acSEugene Shalygin
390314c6acSEugene Shalygin1. Chipset (PCH) temperature
400314c6acSEugene Shalygin2. CPU package temperature
410314c6acSEugene Shalygin3. Motherboard temperature
420314c6acSEugene Shalygin4. Readings from the T_Sensor header
430314c6acSEugene Shalygin5. VRM temperature
440314c6acSEugene Shalygin6. CPU_Opt fan RPM
450314c6acSEugene Shalygin7. VRM heatsink fan RPM
460314c6acSEugene Shalygin8. Chipset fan RPM
470314c6acSEugene Shalygin9. Readings from the "Water flow meter" header (RPM)
480314c6acSEugene Shalygin10. Readings from the "Water In" and "Water Out" temperature headers
490314c6acSEugene Shalygin11. CPU current
50f545a2fdSEugene Shalygin12. CPU core voltage
510314c6acSEugene Shalygin
520314c6acSEugene ShalyginSensor values are read from EC registers, and to avoid race with the board
530314c6acSEugene Shalyginfirmware the driver acquires ACPI mutex, the one used by the WMI when its
540314c6acSEugene Shalyginmethods access the EC.
550314c6acSEugene Shalygin
560314c6acSEugene ShalyginModule Parameters
570314c6acSEugene Shalygin-----------------
580314c6acSEugene Shalygin * mutex_path: string
590314c6acSEugene Shalygin		The driver holds path to the ACPI mutex for each board (actually,
600314c6acSEugene Shalygin		the path is mostly identical for them). If ASUS changes this path
610314c6acSEugene Shalygin		in a future BIOS update, this parameter can be used to override
620314c6acSEugene Shalygin		the stored in the driver value until it gets updated.
63de8fbac5SEugene Shalygin		A special string ":GLOBAL_LOCK" can be passed to use the ACPI
64de8fbac5SEugene Shalygin		global lock instead of a dedicated mutex.
65