요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0-or-later
Kernel driver asus_ec_sensors
=================================
Supported boards:
* MAXIMUS VI HERO
* PRIME X470-PRO
* PRIME X570-PRO
* PRIME X670E-PRO WIFI
* PRIME Z270-A
* Pro WS X570-ACE
* Pro WS WRX90E-SAGE SE
* ProArt X570-CREATOR WIFI
* ProArt X670E-CREATOR WIFI
* ProArt X870E-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 MAXIMUS Z690 FORMULA
* ROG STRIX B550-E GAMING
* ROG STRIX B550-I GAMING
* ROG STRIX B650E-I GAMING WIFI
* ROG STRIX B850-I GAMING WIFI
* ROG STRIX X570-E GAMING
* ROG STRIX X570-E GAMING WIFI II
* ROG STRIX X570-F GAMING
* ROG STRIX X570-I GAMING
* ROG STRIX X670E-E GAMING WIFI
* ROG STRIX X670E-I GAMING WIFI
* ROG STRIX X870-I GAMING WIFI
* ROG STRIX X870E-E GAMING WIFI
* ROG STRIX Z390-F GAMING
* ROG STRIX Z490-F GAMING
* ROG STRIX Z690-A GAMING WIFI D4
* ROG STRIX Z690-E GAMING WIFI
* ROG STRIX Z790-E GAMING WIFI II
* ROG STRIX Z790-I GAMING WIFI
* ROG ZENITH II EXTREME
* ROG ZENITH II EXTREME ALPHA
* TUF GAMING X670E PLUS
* TUF GAMING X670E PLUS WIFI
Authors:
- Eugene Shalygin <[email protected]>
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.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
지원 ASUS mainboard
1-50이 GPL-2.0-or-later driver는 ASUS의 MAXIMUS VI HERO, PRIME X470-PRO, PRIME X570-PRO, PRIME X670E-PRO WIFI, PRIME Z270-A, Pro WS X570-ACE, Pro WS WRX90E-SAGE SE를 지원합니다.
ProArt 계열은 X570-CREATOR WIFI, X670E-CREATOR WIFI, X870E-CREATOR WIFI, B550-CREATOR를 지원합니다. ROG CROSSHAIR 계열은 VIII DARK HERO, VIII HERO (WI-FI), VIII FORMULA, VIII HERO, VIII IMPACT, X670E HERO, X670E GENE를 지원합니다.
ROG MAXIMUS XI HERO, XI HERO (WI-FI), Z690 FORMULA와 ROG ZENITH II EXTREME, ZENITH II EXTREME ALPHA도 지원합니다.
ROG STRIX 계열은 B550-E GAMING, B550-I GAMING, B650E-I GAMING WIFI, B850-I GAMING WIFI, X570-E GAMING, X570-E GAMING WIFI II, X570-F GAMING, X570-I GAMING, X670E-E GAMING WIFI, X670E-I GAMING WIFI, X870-I GAMING WIFI, X870E-E GAMING WIFI, Z390-F GAMING, Z490-F GAMING, Z690-A GAMING WIFI D4, Z690-E GAMING WIFI, Z790-E GAMING WIFI II, Z790-I GAMING WIFI를 지원합니다.
TUF GAMING X670E PLUS와 X670E PLUS WIFI도 지원합니다. 저자는 Eugene Shalygin입니다.
원문에 열거된 board를 제품군별로 묶었습니다.
DMI board identity로 EC register map과 mutex 경로를 고릅니다.
.. SPDX-License-Identifier: GPL-2.0-or-later
Kernel driver asus_ec_sensors
=================================
Supported boards:
* MAXIMUS VI HERO
* PRIME X470-PRO
* PRIME X570-PRO
* PRIME X670E-PRO WIFI
* PRIME Z270-A
* Pro WS X570-ACE
* Pro WS WRX90E-SAGE SE
* ProArt X570-CREATOR WIFI
* ProArt X670E-CREATOR WIFI
* ProArt X870E-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 MAXIMUS Z690 FORMULA
* ROG STRIX B550-E GAMING
* ROG STRIX B550-I GAMING
* ROG STRIX B650E-I GAMING WIFI
* ROG STRIX B850-I GAMING WIFI
* ROG STRIX X570-E GAMING
* ROG STRIX X570-E GAMING WIFI II
* ROG STRIX X570-F GAMING
* ROG STRIX X570-I GAMING
* ROG STRIX X670E-E GAMING WIFI
* ROG STRIX X670E-I GAMING WIFI
* ROG STRIX X870-I GAMING WIFI
* ROG STRIX X870E-E GAMING WIFI
* ROG STRIX Z390-F GAMING
* ROG STRIX Z490-F GAMING
* ROG STRIX Z690-A GAMING WIFI D4
* ROG STRIX Z690-E GAMING WIFI
* ROG STRIX Z790-E GAMING WIFI II
* ROG STRIX Z790-I GAMING WIFI
* ROG ZENITH II EXTREME
* ROG ZENITH II EXTREME ALPHA
* TUF GAMING X670E PLUS
* TUF GAMING X670E PLUS WIFI
EC sensor와 ACPI mutex
51-87ASUS mainboard는 Super I/O chip과 ACPI embedded controller, 즉 EC register를 통해 hardware monitoring 정보를 제공합니다. 일부 sensor는 EC를 통해서만 접근할 수 있습니다.
Driver는 chipset PCH temperature, CPU package temperature, motherboard temperature, `T_Sensor` header reading, VRM temperature를 읽습니다.
Fan·water channel로는 CPU_Opt fan RPM, VRM heatsink fan RPM, chipset fan RPM, `Water flow meter` header의 RPM, `Water In`과 `Water Out` temperature header를 읽습니다. 또한 CPU current와 CPU core voltage를 읽습니다.
Sensor value는 EC register에서 읽습니다. Board firmware와 경쟁하는 일을 피하도록 driver는 WMI method가 EC에 접근할 때 사용하는 것과 같은 ACPI mutex를 획득합니다.
Module parameter `mutex_path`는 board별 ACPI mutex path를 override하는 string입니다. 대부분 board에서 path는 같지만 future BIOS update가 이를 바꾸면 driver가 갱신되기 전까지 이 parameter로 저장값을 대체할 수 있습니다. 전용 mutex 대신 ACPI global lock을 사용하려면 special string `:GLOBAL_LOCK`을 전달합니다.
EC에서 읽는 측정 그룹입니다.
Firmware와 같은 mutex를 사용해 EC access race를 막습니다.
Authors:
- Eugene Shalygin <[email protected]>
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.
요약·해설
asus_ec_sensors.rst:1-87지원 mainboard의 EC register를 firmware와 공유하는 ACPI mutex 아래에서 읽습니다.
원문 분량과 핵심 지원 범위입니다.
장치를 측정·제어하는 기본 순서입니다.