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