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