Kernel driver asus_wmi_sensors | Linux 6.18.37

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약·해설

asus_wmi_sensors.rst:1-78

WMI method로 voltage·fan·temperature·current를 읽되 BIOS 결함 위험을 고려해야 합니다.

문서 개요

항목값

SourceDocumentation/hwmon/asus_wmi_sensors.rst

분량78 source lines

InterfaceASUS WMI

Risk빈번한 polling 시 firmware malfunction

원문 분량과 핵심 지원 범위입니다.

핵심 흐름

Sensor list 조회값을 hwmon에 mapping낮은 빈도로 pollingSoak test와 BIOS 검증

장치를 측정·제어하는 기본 순서입니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기

1 .. SPDX-License-Identifier: GPL-2.0-or-later

3 Kernel driver asus_wmi_sensors

4 =================================

6 Supported boards:

7 * PRIME X399-A,

8 * PRIME X470-PRO,

9 * ROG CROSSHAIR VI EXTREME,

10 * ROG CROSSHAIR VI HERO,

11 * ROG CROSSHAIR VI HERO (WI-FI AC),

12 * ROG CROSSHAIR VII HERO,

13 * ROG CROSSHAIR VII HERO (WI-FI),

14 * ROG STRIX B450-E GAMING,

15 * ROG STRIX B450-F GAMING,

16 * ROG STRIX B450-I GAMING,

17 * ROG STRIX X399-E GAMING,

18 * ROG STRIX X470-F GAMING,

19 * ROG STRIX X470-I GAMING,

20 * ROG ZENITH EXTREME,

21 * ROG ZENITH EXTREME ALPHA.

23 Authors:

24 - Ed Brindley <kernel@maidavale.org>

26 Description:

27 ------------

28 ASUS mainboards publish hardware monitoring information via WMI interface.

30 ASUS WMI interface provides a methods to get list of sensors and values of

31 such, which is utilized by this driver to publish those sensor readings to the

32 HWMON system.

34 The driver is aware of and reads the following sensors:

35 * CPU Core Voltage,

36 * CPU SOC Voltage,

37 * DRAM Voltage,

38 * VDDP Voltage,

39 * 1.8V PLL Voltage,

40 * +12V Voltage,

41 * +5V Voltage,

42 * 3VSB Voltage,

43 * VBAT Voltage,

44 * AVCC3 Voltage,

45 * SB 1.05V Voltage,

46 * CPU Core Voltage,

47 * CPU SOC Voltage,

48 * DRAM Voltage,

49 * CPU Fan RPM,

50 * Chassis Fan 1 RPM,

51 * Chassis Fan 2 RPM,

52 * Chassis Fan 3 RPM,

53 * HAMP Fan RPM,

54 * Water Pump RPM,

55 * CPU OPT RPM,

56 * Water Flow RPM,

57 * AIO Pump RPM,

58 * CPU Temperature,

59 * CPU Socket Temperature,

60 * Motherboard Temperature,

61 * Chipset Temperature,

62 * Tsensor 1 Temperature,

63 * CPU VRM Temperature,

64 * Water In,

65 * Water Out,

66 * CPU VRM Output Current.

68 Known Issues:

69 * The WMI implementation in some of Asus' BIOSes is buggy. This can result in

70 fans stopping, fans getting stuck at max speed, or temperature readouts

71 getting stuck. This is not an issue with the driver, but the BIOS. The Prime

72 X470 Pro seems particularly bad for this. The more frequently the WMI

73 interface is polled the greater the potential for this to happen. Until you

74 have subjected your computer to an extended soak test while polling the

75 sensors frequently, don't leave you computer unattended. Upgrading to new

76 BIOS version with method version greater than or equal to two should

77 rectify the issue.

78 * A few boards report 12v voltages to be ~10v.

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

지원 ASUS WMI board

1-32

이 GPL-2.0-or-later driver는 PRIME X399-A, PRIME X470-PRO, ROG CROSSHAIR VI EXTREME, VI HERO, VI HERO (WI-FI AC), VII HERO, VII HERO (WI-FI)를 지원합니다.

ROG STRIX B450-E GAMING, B450-F GAMING, B450-I GAMING, X399-E GAMING, X470-F GAMING, X470-I GAMING과 ROG ZENITH EXTREME, ZENITH EXTREME ALPHA도 지원합니다. 저자는 Ed Brindley입니다.

ASUS mainboard는 WMI interface로 hardware monitoring 정보를 게시합니다. ASUS WMI는 sensor list와 각 sensor value를 가져오는 method를 제공하고, driver는 이를 HWMON system의 sensor reading으로 노출합니다.

ASUS WMI 지원 계열

계열Board

PRIMEX399-A, X470-PRO

ROG CROSSHAIRVI EXTREME/HERO/HERO WI-FI AC, VII HERO/HERO WI-FI

ROG STRIXB450-E/F/I, X399-E, X470-F/I GAMING

ROG ZENITHEXTREME, EXTREME ALPHA

원문 지원 board를 제품군별로 정리합니다.

WMI sensor 게시

ASUS WMI interface 발견Sensor list method 호출각 sensor value method 호출유형과 label을 HWMON에 mappingSysfs reading 갱신

Firmware method 결과를 hwmon channel로 변환합니다.

.. SPDX-License-Identifier: GPL-2.0-or-later

Kernel driver asus_wmi_sensors
=================================

Supported boards:
 * PRIME X399-A,
 * PRIME X470-PRO,
 * ROG CROSSHAIR VI EXTREME,
 * ROG CROSSHAIR VI HERO,
 * ROG CROSSHAIR VI HERO (WI-FI AC),
 * ROG CROSSHAIR VII HERO,
 * ROG CROSSHAIR VII HERO (WI-FI),
 * ROG STRIX B450-E GAMING,
 * ROG STRIX B450-F GAMING,
 * ROG STRIX B450-I GAMING,
 * ROG STRIX X399-E GAMING,
 * ROG STRIX X470-F GAMING,
 * ROG STRIX X470-I GAMING,
 * ROG ZENITH EXTREME,
 * ROG ZENITH EXTREME ALPHA.

Authors:
    - Ed Brindley <kernel@maidavale.org>

Description:
------------
ASUS mainboards publish hardware monitoring information via WMI interface.

ASUS WMI interface provides a methods to get list of sensors and values of
such, which is utilized by this driver to publish those sensor readings to the
HWMON system.

WMI가 제공하는 측정값

33-67

Voltage sensor는 CPU Core Voltage, CPU SOC Voltage, DRAM Voltage, VDDP Voltage, 1.8V PLL Voltage, +12V, +5V, 3VSB, VBAT, AVCC3, SB 1.05V를 포함합니다. 원문 목록에는 CPU Core, CPU SOC, DRAM Voltage가 한 번 더 반복되어 있습니다.

Fan과 pump sensor는 CPU Fan RPM, Chassis Fan 1·2·3 RPM, HAMP Fan RPM, Water Pump RPM, CPU OPT RPM, Water Flow RPM, AIO Pump RPM입니다.

Temperature sensor는 CPU Temperature, CPU Socket Temperature, Motherboard Temperature, Chipset Temperature, Tsensor 1 Temperature, CPU VRM Temperature, Water In, Water Out입니다. Electrical current로 CPU VRM Output Current도 읽습니다.

ASUS WMI sensor 그룹

그룹항목

VoltageCPU Core/SOC, DRAM, VDDP, 1.8V PLL, +12V, +5V, 3VSB, VBAT, AVCC3, SB 1.05V

FanCPU, Chassis 1~3, HAMP, CPU OPT

Pump/flowWater Pump, Water Flow, AIO Pump

TemperatureCPU, socket, motherboard, chipset, Tsensor 1, VRM, Water In/Out

CurrentCPU VRM Output Current

WMI method가 반환하는 측정 종류입니다.

Sensor 유형 mapping

Sensor 이름 읽기Voltage·fan·temperature·current 분류표준 단위로 값 변환중복 label을 안정적으로 처리Hwmon attribute 게시

WMI가 제공한 이름과 값을 표준 hwmon 유형으로 분류합니다.


The driver is aware of and reads the following sensors:
 * CPU Core Voltage,
 * CPU SOC Voltage,
 * DRAM Voltage,
 * VDDP Voltage,
 * 1.8V PLL Voltage,
 * +12V Voltage,
 * +5V Voltage,
 * 3VSB Voltage,
 * VBAT Voltage,
 * AVCC3 Voltage,
 * SB 1.05V Voltage,
 * CPU Core Voltage,
 * CPU SOC Voltage,
 * DRAM Voltage,
 * CPU Fan RPM,
 * Chassis Fan 1 RPM,
 * Chassis Fan 2 RPM,
 * Chassis Fan 3 RPM,
 * HAMP Fan RPM,
 * Water Pump RPM,
 * CPU OPT RPM,
 * Water Flow RPM,
 * AIO Pump RPM,
 * CPU Temperature,
 * CPU Socket Temperature,
 * Motherboard Temperature,
 * Chipset Temperature,
 * Tsensor 1 Temperature,
 * CPU VRM Temperature,
 * Water In,
 * Water Out,
 * CPU VRM Output Current.

BIOS WMI 구현의 알려진 문제

68-78

일부 ASUS BIOS의 WMI 구현에는 bug가 있습니다. 이 때문에 fan이 멈추거나 maximum speed에 고정되고, temperature reading이 멈출 수 있습니다. 이는 driver 문제가 아니라 BIOS 문제이며 PRIME X470-PRO에서 특히 심한 것으로 보입니다.

WMI interface를 자주 polling할수록 문제가 생길 가능성이 커집니다. Sensor를 빈번하게 polling하는 extended soak test를 수행하기 전에는 computer를 unattended 상태로 두지 않아야 합니다. Method version이 2 이상인 새 BIOS로 upgrade하면 문제가 해결되어야 합니다.

일부 board는 12V voltage를 약 10V로 보고합니다.

ASUS WMI 위험과 대응

문제영향/대응

빈번한 pollingFan 정지·최대속도 고정·temperature 고정 위험 증가

PRIME X470-PRO특히 문제가 심한 것으로 알려짐

BIOS method < 2Method version 2 이상 BIOS로 upgrade

12V reading일부 board에서 약 10V로 오보고

Firmware 문제의 증상과 완화 방법입니다.

안전한 검증

최신 BIOS와 method version 확인낮은 polling 빈도로 시작Extended soak test 수행Fan·temperature 고정 여부 관찰검증 전 unattended 운용 금지

운영 전 firmware와 장시간 polling 안정성을 확인합니다.

Known Issues:
 * The WMI implementation in some of Asus' BIOSes is buggy. This can result in
   fans stopping, fans getting stuck at max speed, or temperature readouts
   getting stuck. This is not an issue with the driver, but the BIOS. The Prime
   X470 Pro seems particularly bad for this. The more frequently the WMI
   interface is polled the greater the potential for this to happen. Until you
   have subjected your computer to an extended soak test while polling the
   sensors frequently, don't leave you computer unattended. Upgrading to new
   BIOS version with method version greater than or equal to two should
   rectify the issue.
 * A few boards report 12v voltages to be ~10v.