wmi/devices/alienware-wmi.rst

1 .. SPDX-License-Identifier: GPL-2.0-or-later
4 Dell AWCC WMI interface driver (alienware-wmi)
10 The WMI device WMAX has been implemented for many Alienware and Dell's G-Series
14 with thermal control and overclocking.
17 manage manufacturer predefined thermal profiles. The alienware-wmi driver
30 -------------------------
37 …), Locale("MS\\0x409"), Description("WMI Function"), guid("{A70591CE-A997-11DA-B012-B622A1EF5492}"…
46 …[WmiMethodId(20), Implemented, read, write, Description("Thermal Information.")] void Thermal_Info…
47 …[WmiMethodId(21), Implemented, read, write, Description("Thermal Control.")] void Thermal_Control(…
75 ------------------
84 Thermal Methods
88 -------------------------------------------------------------
90 +--------------------+------------------------------------+--------------------+
93 | 0x01               | Get the number of temperature      | - Byte 1: Fan ID   |
95 +--------------------+------------------------------------+--------------------+
96 | 0x02               | Get the temperature sensor IDs     | - Byte 1: Fan ID   |
97 |                    | related to a fan sensor ID         | - Byte 2: Index    |
98 +--------------------+------------------------------------+--------------------+
101 -------------------------------------------------------------------
103 +--------------------+------------------------------------+--------------------+
106 | 0x01               | Unknown.                           | - None             |
107 +--------------------+------------------------------------+--------------------+
108 | 0x02               | Get system description number with | - None             |
111 |                    | - Byte 0: Number of fans           |                    |
112 |                    | - Byte 1: Number of temperature    |                    |
114 |                    | - Byte 2: Unknown                  |                    |
115 |                    | - Byte 3: Number of thermal        |                    |
117 +--------------------+------------------------------------+--------------------+
118 | 0x03               | List an ID or resource at a given  | - Byte 1: Index    |
120 |                    | unknown IDs and thermal profile    |                    |
129 +--------------------+------------------------------------+--------------------+
130 | 0x04               | Get the current temperature for a  | - Byte 1: Sensor   |
132 +--------------------+------------------------------------+--------------------+
133 | 0x05               | Get the current RPM for a given    | - Byte 1: Fan ID   |
135 +--------------------+------------------------------------+--------------------+
136 | 0x06               | Get fan speed percentage. (not     | - Byte 1: Fan ID   |
138 +--------------------+------------------------------------+--------------------+
139 | 0x07               | Unknown.                           | - Unknown          |
140 +--------------------+------------------------------------+--------------------+
141 | 0x08               | Get minimum RPM for a given FAN    | - Byte 1: Fan ID   |
143 +--------------------+------------------------------------+--------------------+
144 | 0x09               | Get maximum RPM for a given FAN    | - Byte 1: Fan ID   |
146 +--------------------+------------------------------------+--------------------+
147 | 0x0A               | Get balanced thermal profile ID.   | - None             |
148 +--------------------+------------------------------------+--------------------+
149 | 0x0B               | Get current thermal profile ID.    | - None             |
150 +--------------------+------------------------------------+--------------------+
151 | 0x0C               | Get current `boost` value for a    | - Byte 1: Fan ID   |
153 +--------------------+------------------------------------+--------------------+
156 ---------------------------------------------------------------
158 +--------------------+------------------------------------+--------------------+
161 | 0x01               | Activate a given thermal profile.  | - Byte 1: Thermal  |
163 +--------------------+------------------------------------+--------------------+
164 | 0x02               | Set a `boost` value for a given    | - Byte 1: Fan ID   |
165 |                    | fan ID.                            | - Byte 2: Boost    |
166 +--------------------+------------------------------------+--------------------+
168 These are the known thermal profile codes:
170 +------------------------------+----------+------+
171 | Thermal Profile              | Type     | ID   |
174 +------------------------------+----------+------+
175 | G-Mode                       | Special  | 0xAB |
176 +------------------------------+----------+------+
178 +------------------------------+----------+------+
180 +------------------------------+----------+------+
182 +------------------------------+----------+------+
184 +------------------------------+----------+------+
186 +------------------------------+----------+------+
188 +------------------------------+----------+------+
190 +------------------------------+----------+------+
192 +------------------------------+----------+------+
194 +------------------------------+----------+------+
196 +------------------------------+----------+------+
198 If a model supports the User Selectable Thermal Tables (USTT) profiles, it will
199 not support the Legacy profiles and vice-versa.
201 Every model supports the CUSTOM (0x00) thermal profile. GMODE replaces
202 PERFORMANCE in G-Series laptops.
205 ---------------------------------------------------------------
207 +--------------------+------------------------------------+--------------------+
210 | 0x01               | Toggle *Game Shift*.               | - None             |
211 +--------------------+------------------------------------+--------------------+
212 | 0x02               | Get *Game Shift* status.           | - None             |
213 +--------------------+------------------------------------+--------------------+
218 This method is only present on Dell's G-Series laptops and it's implementation
219 implies GMODE thermal profile is available, even if operation 0x03 of
222 G-key on Dell's G-Series laptops also changes Game Shift status, so both are
229 ---------------------------------------------------------------
238 embedded STM32 RGB lighting controller with USB/HID capabilities. It's vendor ID
244 +--------------+--------------------------------------------------------------+
249 |              |                               +------------------------------+
252 +--------------+-------------------------------+------------------------------+
255 |              |                               +------------------------------+
258 +--------------+-------------------------------+------------------------------+
267 ------------------------------------------------------------------
269 +--------------------+------------------------------------+--------------------+
272 | Pin number         | Set the pin status                 | - Byte 1: Pin      |
274 +--------------------+------------------------------------+--------------------+
277 ----------------------------------------------
279 +--------------------+------------------------------------+--------------------+
282 | N/A                | Get the total number of GPIOs      | - None             |
283 +--------------------+------------------------------------+--------------------+
290 ------------------------------------------------------------------
292 +--------------------+------------------------------------+--------------------+
295 | Pin number         | Get the pin status                 | - None             |
296 +--------------------+------------------------------------+--------------------+
306 ----------------------------------------------
317 * `AlexIII <https://github.com/AlexIII/tcc-g15>`_
318 * `T-Troll <https://github.com/T-Troll/alienfx-tools/>`_
319 …/gabriel.marcanobrady.family/blog/2024/12/16/dell-g5-5505-se-acpi-or-figuring-out-how-to-reset-the…