← Documents Documentation/admin-guide/laptops/alienware-wmi.rst GitHub 원문 ↗

Linux 6.18.37 · Administration / Laptops

Alienware WMI Driver

Dell gaming 장치의 AWCC Platform Profile·HWMON sensor·G-Mode·manual fan boost interface와 강제 probe 방법을 설명합니다.

Source pathDocumentation/admin-guide/laptops/alienware-wmi.rst
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

WMAX와 AWCC

alienware-wmi.rst:1-24

세대에 따라 달라진 WMAX WMI device의 역할과 driver 범위를 설명합니다.

지원 기능과 probe

alienware-wmi.rst:25-61

지원 제품군, force module parameter와 upstream 모델 등록 절차를 정리합니다.

Platform Profile

alienware-wmi.rst:62-86

thermal profile class device와 G-Mode의 연동 방식을 안내합니다.

HWMON

alienware-wmi.rst:87-127

sensor monitoring과 0~255 fan boost sysfs interface를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 .. SPDX-License-Identifier: GPL-2.0-or-later
2
3 ====================
4 Alienware WMI Driver
5 ====================
6
7 Kurt Borja <kuurtb@gmail.com>
8
9 This is a driver for the "WMAX" WMI device, which is found in most Dell gaming
10 laptops and controls various special features.
11
12 Before the launch of M-Series laptops (~2018), the "WMAX" device controlled
13 basic RGB lighting, deep sleep mode, HDMI mode and amplifier status.
14
15 Later, this device was completely repurpused. Now it mostly deals with thermal
16 profiles, sensor monitoring and overclocking. This interface is named "AWCC" and
17 is known to be used by the AWCC OEM application to control these features.
18
19 The alienware-wmi driver controls both interfaces.
20
21 AWCC Interface
22 ==============
23
24 WMI device documentation: Documentation/wmi/devices/alienware-wmi.rst
25
26 Supported devices
27 -----------------
28
29 - Alienware M-Series laptops
30 - Alienware X-Series laptops
31 - Alienware Aurora Desktops
32 - Dell G-Series laptops
33
34 If you believe your device supports the AWCC interface and you don't have any of
35 the features described in this document, try the following alienware-wmi module
36 parameters:
37
38 - ``force_platform_profile=1``: Forces probing for platform profile support
39 - ``force_hwmon=1``: Forces probing for HWMON support
40
41 If the module loads successfully with these parameters, consider submitting a
42 patch adding your model to the ``awcc_dmi_table`` located in
43 ``drivers/platform/x86/dell/alienware-wmi-wmax.c`` or contacting the maintainer
44 for further guidance.
45
46 Status
47 ------
48
49 The following features are currently supported:
50
51 - :ref:`Platform Profile <platform-profile>`:
52
53 - Thermal profile control
54
55 - G-Mode toggling
56
57 - :ref:`HWMON <hwmon>`:
58
59 - Sensor monitoring
60
61 - Manual fan control
62
63 .. _platform-profile:
64
65 Platform Profile
66 ----------------
67
68 The AWCC interface exposes various firmware defined thermal profiles. These are
69 exposed to user-space through the Platform Profile class interface. Refer to
70 :ref:`sysfs-class-platform-profile <abi_file_testing_sysfs_class_platform_profile>`
71 for more information.
72
73 The name of the platform-profile class device exported by this driver is
74 "alienware-wmi" and it's path can be found with:
75
76 ::
77
78 grep -l "alienware-wmi" /sys/class/platform-profile/platform-profile-*/name | sed 's|/[^/]*$||'
79
80 If the device supports G-Mode, it is also toggled when selecting the
81 ``performance`` profile.
82
83 .. note::
84 You may set the ``force_gmode`` module parameter to always try to toggle this
85 feature, without checking if your model supports it.
86
87 .. _hwmon:
88
89 HWMON
90 -----
91
92 The AWCC interface also supports sensor monitoring and manual fan control. Both
93 of these features are exposed to user-space through the HWMON interface.
94
95 The name of the hwmon class device exported by this driver is "alienware_wmi"
96 and it's path can be found with:
97
98 ::
99
100 grep -l "alienware_wmi" /sys/class/hwmon/hwmon*/name | sed 's|/[^/]*$||'
101
102 Sensor monitoring is done through the standard HWMON interface. Refer to
103 :ref:`sysfs-class-hwmon <abi_file_testing_sysfs_class_hwmon>` for more
104 information.
105
106 Manual fan control on the other hand, is not exposed directly by the AWCC
107 interface. Instead it let's us control a fan `boost` value. This `boost` value
108 has the following aproximate behavior over the fan pwm:
109
110 ::
111
112 pwm = pwm_base + (fan_boost / 255) * (pwm_max - pwm_base)
113
114 Due to the above behavior, the fan `boost` control is exposed to user-space
115 through the following, custom hwmon sysfs attribute:
116
117 =============================== ======= =======================================
118 Name Perm Description
119 =============================== ======= =======================================
120 fan[1-4]_boost RW Fan boost value.
121
122 Integer value between 0 and 255
123 =============================== ======= =======================================
124
125 .. note::
126 In some devices, manual fan control only works reliably if the ``custom``
127 platform profile is selected.
128

3. 한국어 전문 번역

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

Alienware WMI driver 개요

1-24

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

작성자: Kurt Borja <kuurtb@gmail.com>

이 driver는 대부분의 Dell gaming laptop에 있는 `WMAX` WMI device를 지원하며 여러 특수 기능을 제어합니다.

M-Series laptop 출시 전인 약 2018년까지 `WMAX` device는 기본 RGB lighting, deep sleep mode, HDMI mode와 amplifier 상태를 제어했습니다.

이후 이 device의 용도는 완전히 바뀌었습니다. 지금은 주로 thermal profile, sensor monitoring과 overclocking을 담당합니다. 이 interface는 `AWCC`라 하며, AWCC OEM application이 이런 기능을 제어하는 데 사용하는 것으로 알려져 있습니다.

`alienware-wmi` driver는 두 interface를 모두 제어합니다.

AWCC interface

WMI device 문서: `Documentation/wmi/devices/alienware-wmi.rst`

지원 장치, 강제 probe와 기능 상태

25-61

지원 장치

지원 대상은 Alienware M-Series laptop, Alienware X-Series laptop, Alienware Aurora Desktop과 Dell G-Series laptop입니다.

장치가 AWCC interface를 지원한다고 생각하지만 이 문서에 설명된 기능이 없다면 다음 `alienware-wmi` module parameter를 사용해 보십시오.

module parameter동작
force_platform_profile=1platform profile 지원 probe를 강제합니다.
force_hwmon=1HWMON 지원 probe를 강제합니다.

이 parameter로 module이 성공적으로 load되면 `drivers/platform/x86/dell/alienware-wmi-wmax.c`의 `awcc_dmi_table`에 모델을 추가하는 patch를 제출하거나, 추가 안내를 위해 maintainer에게 연락하는 것을 고려하십시오.

현재 지원 기능

interface기능
Platform Profilethermal profile 제어, G-Mode toggle
HWMONsensor monitoring, manual fan 제어

Platform Profile

62-86

AWCC interface는 firmware가 정의한 여러 thermal profile을 노출합니다. 이 profile은 Platform Profile class interface를 통해 user space에 제공됩니다. 자세한 내용은 `sysfs-class-platform-profile <abi_file_testing_sysfs_class_platform_profile>`을 참조하십시오.

이 driver가 export하는 platform-profile class device 이름은 `alienware-wmi`입니다. 다음 명령으로 경로를 찾을 수 있습니다.

grep -l "alienware-wmi" /sys/class/platform-profile/platform-profile-*/name | sed 's|/[^/]*$||'

장치가 G-Mode를 지원한다면 `performance` profile을 선택할 때 G-Mode도 toggle됩니다.

참고: 모델 지원 여부를 확인하지 않고 이 기능의 toggle을 항상 시도하려면 `force_gmode` module parameter를 설정할 수 있습니다.

HWMON sensor와 fan boost

87-127

AWCC interface는 sensor monitoring과 manual fan 제어도 지원합니다. 두 기능 모두 HWMON interface를 통해 user space에 노출됩니다.

이 driver가 export하는 hwmon class device 이름은 `alienware_wmi`입니다. 다음 명령으로 경로를 찾을 수 있습니다.

grep -l "alienware_wmi" /sys/class/hwmon/hwmon*/name | sed 's|/[^/]*$||'

sensor monitoring은 표준 HWMON interface를 사용합니다. 자세한 내용은 `sysfs-class-hwmon <abi_file_testing_sysfs_class_hwmon>`을 참조하십시오.

반면 manual fan 제어는 AWCC interface가 직접 노출하지 않습니다. 대신 fan `boost` 값을 제어할 수 있습니다. 이 `boost` 값은 fan PWM에 대해 대략 다음과 같이 동작합니다.

pwm = pwm_base + (fan_boost / 255) * (pwm_max - pwm_base)

이 동작에 따라 fan `boost` 제어는 다음 custom hwmon sysfs attribute를 통해 user space에 노출됩니다.

NamePermDescription
fan[1-4]_boostRW0부터 255 사이의 정수 fan boost 값입니다.

참고: 일부 장치에서는 `custom` platform profile을 선택해야 manual fan 제어가 안정적으로 동작합니다.