0001 .. SPDX-License-Identifier: GPL-2.0-or-later
0002
0003 Kernel driver asus_ec_sensors
0004 =================================
0005
0006 Supported boards:
0007 * PRIME X470-PRO
0008 * PRIME X570-PRO
0009 * Pro WS X570-ACE
0010 * ProArt X570-CREATOR WIFI
0011 * ROG CROSSHAIR VIII DARK HERO
0012 * ROG CROSSHAIR VIII HERO (WI-FI)
0013 * ROG CROSSHAIR VIII FORMULA
0014 * ROG CROSSHAIR VIII HERO
0015 * ROG CROSSHAIR VIII IMPACT
0016 * ROG MAXIMUS XI HERO
0017 * ROG MAXIMUS XI HERO (WI-FI)
0018 * ROG STRIX B550-E GAMING
0019 * ROG STRIX B550-I GAMING
0020 * ROG STRIX X570-E GAMING
0021 * ROG STRIX X570-E GAMING WIFI II
0022 * ROG STRIX X570-F GAMING
0023 * ROG STRIX X570-I GAMING
0024 * ROG STRIX Z690-A GAMING WIFI D4
0025 * ROG ZENITH II EXTREME
0026
0027 Authors:
0028 - Eugene Shalygin <eugene.shalygin@gmail.com>
0029
0030 Description:
0031 ------------
0032 ASUS mainboards publish hardware monitoring information via Super I/O
0033 chip and the ACPI embedded controller (EC) registers. Some of the sensors
0034 are only available via the EC.
0035
0036 The driver is aware of and reads the following sensors:
0037
0038 1. Chipset (PCH) temperature
0039 2. CPU package temperature
0040 3. Motherboard temperature
0041 4. Readings from the T_Sensor header
0042 5. VRM temperature
0043 6. CPU_Opt fan RPM
0044 7. VRM heatsink fan RPM
0045 8. Chipset fan RPM
0046 9. Readings from the "Water flow meter" header (RPM)
0047 10. Readings from the "Water In" and "Water Out" temperature headers
0048 11. CPU current
0049 12. CPU core voltage
0050
0051 Sensor values are read from EC registers, and to avoid race with the board
0052 firmware the driver acquires ACPI mutex, the one used by the WMI when its
0053 methods access the EC.
0054
0055 Module Parameters
0056 -----------------
0057 * mutex_path: string
0058 The driver holds path to the ACPI mutex for each board (actually,
0059 the path is mostly identical for them). If ASUS changes this path
0060 in a future BIOS update, this parameter can be used to override
0061 the stored in the driver value until it gets updated.
0062 A special string ":GLOBAL_LOCK" can be passed to use the ACPI
0063 global lock instead of a dedicated mutex.
