← Documents Documentation/ABI/testing/debugfs-alienware-wmi GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

Alienware WMI debugfs ABI

Alienware WMI device가 제공하는 system description, HWMON·platform profile private data와 GPIO pin count·상태 제어 debugfs files를 설명합니다.

Source pathDocumentation/ABI/testing/debugfs-alienware-wmi
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

System, HWMON, platform profile data

debugfs-alienware-wmi:1-44

AWCC interface의 raw system description과 fan·temperature sensor IDs, platform·thermal profile mapping을 읽기 전용 debugfs files로 노출합니다.

GPIO count와 pin control

debugfs-alienware-wmi:46-64

Device가 보고한 전체 GPIO pin 수는 읽기 전용이며 각 pinX file은 해당 GPIO pin의 상태를 읽고 쓸 수 있습니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/kernel/debug/alienware-wmi-<wmi_device_name>/system_description
2 Date: March 2025
3 KernelVersion: 6.15
4 Contact: Kurt Borja <[email protected]>
5 Description:
6 This file exposes the raw ``system_description`` number reported
7 by the WMAX device.
8
9 Only present on devices with the AWCC interface.
10
11 See Documentation/admin-guide/laptops/alienware-wmi.rst for
12 details.
13
14 RO
15
16 What: /sys/kernel/debug/alienware-wmi-<wmi_device_name>/hwmon_data
17 Date: March 2025
18 KernelVersion: 6.15
19 Contact: Kurt Borja <[email protected]>
20 Description:
21 This file exposes HWMON private data.
22
23 Includes fan sensor count, temperature sensor count, internal
24 fan IDs and internal temp IDs.
25
26 See Documentation/admin-guide/laptops/alienware-wmi.rst for
27 details.
28
29 RO
30
31 What: /sys/kernel/debug/alienware-wmi-<wmi_device_name>/pprof_data
32 Date: March 2025
33 KernelVersion: 6.15
34 Contact: Kurt Borja <[email protected]>
35 Description:
36 This file exposes Platform Profile private data.
37
38 Includes internal mapping to platform profiles and thermal
39 profile IDs.
40
41 See Documentation/admin-guide/laptops/alienware-wmi.rst for
42 details.
43
44 RO
45
46 What: /sys/kernel/debug/alienware-wmi-<wmi_device_name>/gpio_ctl/total_gpios
47 Date: May 2025
48 KernelVersion: 6.16
49 Contact: Kurt Borja <[email protected]>
50 Description:
51 Total number of GPIO pins reported by the device.
52
53 RO
54
55 What: /sys/kernel/debug/alienware-wmi-<wmi_device_name>/gpio_ctl/pinX
56 Date: May 2025
57 KernelVersion: 6.16
58 Contact: Kurt Borja <[email protected]>
59 Description:
60 This file controls GPIO pin X status.
61
62 See Documentation/wmi/devices/alienware-wmi.rst for details.
63
64 RW
65

3. 한국어 전문 번역

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

System description과 private driver data

1-44
항목내용
Date2025년 3월
KernelVersion6.15
ContactKurt Borja <[email protected]>
What설명권한
/sys/kernel/debug/alienware-wmi-<wmi_device_name>/system_descriptionWMAX device가 보고한 raw system_description number를 노출합니다. AWCC interface가 있는 device에서만 존재합니다.RO
/sys/kernel/debug/alienware-wmi-<wmi_device_name>/hwmon_dataHWMON private data를 노출합니다. Fan sensor 수, temperature sensor 수, 내부 fan IDs와 내부 temperature IDs를 포함합니다.RO
/sys/kernel/debug/alienware-wmi-<wmi_device_name>/pprof_dataPlatform Profile private data를 노출합니다. Platform profiles와 thermal profile IDs 사이의 내부 mapping을 포함합니다.RO

세 파일의 자세한 내용은 Documentation/admin-guide/laptops/alienware-wmi.rst를 참조합니다.

GPIO debugfs controls

46-64
항목내용
Date2025년 5월
KernelVersion6.16
ContactKurt Borja <[email protected]>
What설명권한
/sys/kernel/debug/alienware-wmi-<wmi_device_name>/gpio_ctl/total_gpiosDevice가 보고한 전체 GPIO pin 수RO
/sys/kernel/debug/alienware-wmi-<wmi_device_name>/gpio_ctl/pinXGPIO pin X의 상태를 제어하는 fileRW

pinX의 자세한 내용은 Documentation/wmi/devices/alienware-wmi.rst를 참조합니다.

Alienware WMI debugfs tree와 접근 권한
alienware-wmi-<wmi_device_name>system_descriptionRaw WMAX value · RO
alienware-wmi-<wmi_device_name>hwmon_data / pprof_dataDriver private data · RO
alienware-wmi-<wmi_device_name>gpio_ctl/total_gpiosPin count · RO
alienware-wmi-<wmi_device_name>gpio_ctl/pinXPin state · RW

Device별 debugfs directory 아래에서 firmware·driver private data는 조회만 하고 gpio_ctl/pinX만 상태 제어에 사용한다.