| .. SPDX-License-Identifier: GPL-2.0-or-later |
| |
| Kernel driver asus_ec_sensors |
| ================================= |
| |
| Supported boards: |
| * PRIME X470-PRO |
| * PRIME X570-PRO |
| * Pro WS X570-ACE |
| * ProArt X570-CREATOR WIFI |
| * ProArt B550-CREATOR |
| * ROG CROSSHAIR VIII DARK HERO |
| * ROG CROSSHAIR VIII HERO (WI-FI) |
| * ROG CROSSHAIR VIII FORMULA |
| * ROG CROSSHAIR VIII HERO |
| * ROG CROSSHAIR VIII IMPACT |
| * ROG CROSSHAIR X670E HERO |
| * ROG CROSSHAIR X670E GENE |
| * ROG MAXIMUS XI HERO |
| * ROG MAXIMUS XI HERO (WI-FI) |
| * ROG STRIX B550-E GAMING |
| * ROG STRIX B550-I GAMING |
| * ROG STRIX X570-E GAMING |
| * ROG STRIX X570-E GAMING WIFI II |
| * ROG STRIX X570-F GAMING |
| * ROG STRIX X570-I GAMING |
| * ROG STRIX Z390-F GAMING |
| * ROG STRIX Z690-A GAMING WIFI D4 |
| * ROG ZENITH II EXTREME |
| * ROG ZENITH II EXTREME ALPHA |
| |
| Authors: |
| - Eugene Shalygin <eugene.shalygin@gmail.com> |
| |
| Description: |
| ------------ |
| ASUS mainboards publish hardware monitoring information via Super I/O |
| chip and the ACPI embedded controller (EC) registers. Some of the sensors |
| are only available via the EC. |
| |
| The driver is aware of and reads the following sensors: |
| |
| 1. Chipset (PCH) temperature |
| 2. CPU package temperature |
| 3. Motherboard temperature |
| 4. Readings from the T_Sensor header |
| 5. VRM temperature |
| 6. CPU_Opt fan RPM |
| 7. VRM heatsink fan RPM |
| 8. Chipset fan RPM |
| 9. Readings from the "Water flow meter" header (RPM) |
| 10. Readings from the "Water In" and "Water Out" temperature headers |
| 11. CPU current |
| 12. CPU core voltage |
| |
| Sensor values are read from EC registers, and to avoid race with the board |
| firmware the driver acquires ACPI mutex, the one used by the WMI when its |
| methods access the EC. |
| |
| Module Parameters |
| ----------------- |
| * mutex_path: string |
| The driver holds path to the ACPI mutex for each board (actually, |
| the path is mostly identical for them). If ASUS changes this path |
| in a future BIOS update, this parameter can be used to override |
| the stored in the driver value until it gets updated. |
| A special string ":GLOBAL_LOCK" can be passed to use the ACPI |
| global lock instead of a dedicated mutex. |
