wmi/devices/dell-wmi-ddv.rst

1 .. SPDX-License-Identifier: GPL-2.0-or-later
4 Dell DDV WMI interface driver (dell-wmi-ddv)
10 Many Dell notebooks made after ~2020 support a WMI-based interface for
15 so it was called `DDV`. Currently the ``dell-wmi-ddv`` driver supports
21              trial-and-error, please keep that in mind.
27 including batteries. It has a form similar to `CC-PPPPPP-MMMMM-YMD-SSSS-FFF`
52 …), Locale("MS\\0x409"), Description("WMI Function"), guid("{8A42EA14-4F2A-FD45-6422-0087F7A7E608}"…
67 …[WmiMethodId(11), Implemented, read, write, Description("Return Battery Relative State-Of-Charge."…
79 Each WMI method takes an ACPI buffer containing a 32-bit index as input argument,
80 with the first 8 bit being used to specify the battery when using battery-related
92 The data format of many battery-related methods seems to be based on the
93 `Smart Battery Data Specification`, so unknown battery-related methods are
97 -------------------------------------
102 ------------------------------
107 -----------------------------------
112 -----------------------------------
117 - bits 0 to 4 contain the manufacture day.
118 - bits 5 to 8 contain the manufacture month.
119 - bits 9 to 15 contain the manufacture year biased by 1980.
125 --------------------------------
130 ----------------------------------
135 - "Li-I" for Li-Ion
138 -------------------------------
143 ---------------------------
149 ---------------------------
154 -------------------------------------
156 Returns a manufacture-defined value as an u16.
159 -----------------------------------------
164 ------------------------------
169 -------------------------
174 --------------------------------------
178 - ``0x0``: Success
179 - ``0x1``: Interface not supported
180 - ``0xfffffffe``: Error/Timeout
186 ---------------------------------
191 - a block number starting with 0 (u8)
192 - 31 bytes of unknown data
198 ---------------------------------
203 ---------------------------------------
214 --------------------------
219 ---------------------------------
225 - fan type (u8)
226 - fan speed in RPM (little endian u16)
229 -------------------------------------
235 - thermal type (u8)
236 - current temperature (s8)
237 - min. temperature (s8)
238 - max. temperature (s8)
239 - unknown field (u8)
271 Reverse-Engineering the DDV WMI interface
280 5. Use the built-in UEFI diagnostics to view sensor types/values for fan/thermal
287 1. Load the ``dell-wmi-ddv`` driver, use the ``force`` module param
290 3. Compare the data with the built-in UEFI diagnostics.
295 to the ``dell-wmi-ddv`` driver.
297 See Documentation/admin-guide/reporting-issues.rst for further information.