Documentation/wmi/devices/lenovo-wmi-other.rst

Source file repositories/reference/linux-study-clean/Documentation/wmi/devices/lenovo-wmi-other.rst

File Facts

System
Linux kernel
Corpus path
Documentation/wmi/devices/lenovo-wmi-other.rst
Extension
.rst
Size
6276 bytes
Lines
149
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

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

===========================================================
Lenovo WMI Interface Other Mode Driver (lenovo-wmi-other)
===========================================================

Introduction
============
Lenovo WMI Other Mode interface is broken up into multiple GUIDs,
The primary Other Mode interface provides advanced power tuning features
such as Package Power Tracking (PPT). It is paired with multiple data block
GUIDs that provide context for the various methods.


Other Mode
----------

WMI GUID ``DC2A8805-3A8C-41BA-A6F7-092E0089CD3B``

The Other Mode WMI interface uses the firmware_attributes class to expose
various WMI attributes provided by the interface in the sysfs. This enables
CPU and GPU power limit tuning as well as various other attributes for
devices that fall under the "Gaming Series" of Lenovo devices. Each
attribute exposed by the Other Mode interface has corresponding
capability data blocks which allow the driver to probe details about the
attribute. Each attribute has multiple pages, one for each of the platform
profiles managed by the Gamezone interface. Attributes are exposed in sysfs
under the following path:

::

  /sys/class/firmware-attributes/lenovo-wmi-other/attributes/<attribute>/

Additionally, this driver also exports attributes to HWMON.

LENOVO_CAPABILITY_DATA_00
-------------------------

WMI GUID ``362A3AFE-3D96-4665-8530-96DAD5BB300E``

The LENOVO_CAPABILITY_DATA_00 interface provides various information that
does not rely on the gamezone thermal mode.

The following HWMON attributes are implemented:
 - fanX_div: internal RPM divisor
 - fanX_input: current RPM
 - fanX_target: target RPM (tunable, 0=auto)

Due to the internal RPM divisor, the current/target RPMs are rounded down to
its nearest multiple. The divisor itself is not necessary to be a power of two.

LENOVO_CAPABILITY_DATA_01
-------------------------

WMI GUID ``7A8F5407-CB67-4D6E-B547-39B3BE018154``

The LENOVO_CAPABILITY_DATA_01 interface provides various information that
relies on the gamezone thermal mode, including power limits of integrated
CPU and GPU components.

Each attribute has the following properties:
 - current_value
 - default_value
 - display_name
 - max_value
 - min_value
 - scalar_increment
 - type

The following firmware-attributes are implemented:

Annotation

Implementation Notes