Lenovo WMI Interface Other Mode Driver

Other Mode와 power tuning

Lenovo WMI Other Mode interface는 여러 GUID로 나뉩니다. 주 interface는 Package Power Tracking(PPT) 같은 고급 power tuning 기능을 제공하고, 여러 data block GUID가 method별 context를 제공합니다.

.. 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.

firmware_attributes sysfs interface

GUID `DC2A8805-3A8C-41BA-A6F7-092E0089CD3B`의 Other Mode interface는 `firmware_attributes` class를 사용해 WMI attribute를 sysfs에 노출합니다. Lenovo Gaming Series 장치에서 CPU·GPU power limit와 기타 설정을 조정할 수 있습니다.

각 attribute에는 세부 정보를 탐색하는 capability data block이 있으며, Gamezone이 관리하는 platform profile마다 한 page씩 여러 page를 갖습니다.

attribute 경로는 `/sys/class/firmware-attributes/lenovo-wmi-other/attributes/<attribute>/`입니다.

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>/

LENOVO_CAPABILITY_DATA_01

GUID `7A8F5407-CB67-4D6E-B547-39B3BE018154`의 capability data는 integrated CPU와 GPU의 여러 power limit 정보를 제공합니다.

각 attribute는 현재값, 기본값, 표시 이름, 최댓값, 최솟값, 증가 step, type을 제공합니다. 구현된 PPT attribute는 sustained, slow, fast power limit 세 종류입니다.

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

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

The LENOVO_CAPABILITY_DATA_01 interface provides information on various
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 attributes are implemented:
 - ppt_pl1_spl: Platform Profile Tracking Sustained Power Limit
 - ppt_pl2_sppt: Platform Profile Tracking Slow Package Power Tracking
 - ppt_pl3_fppt: Platform Profile Tracking Fast Package Power Tracking

method와 capability data class

embedded binary MOF는 `bmfdec`로 decode할 수 있습니다. `LENOVO_OTHER_METHOD`는 feature 값 조회·설정, command data 조회, TAC package data 조회의 네 method를 제공합니다.

`LENOVO_CAPABILITY_DATA_00`은 ID, capability, 기본값을, `_01`은 여기에 step·최솟값·최댓값을 더합니다. `_02`는 ID, capability, data size와 그 크기의 byte-array 기본값을 제공합니다.

WMI interface description
=========================

The WMI interface description can be decoded from the embedded binary MOF (bmof)
data using the `bmfdec <https://github.com/pali/bmfdec>`_ utility:

::

  [WMI, Dynamic, Provider("WmiProv"), Locale("MS\\0x409"), Description("LENOVO_OTHER_METHOD class"), guid("{dc2a8805-3a8c-41ba-a6f7-092e0089cd3b}")]
  class LENOVO_OTHER_METHOD {
    [key, read] string InstanceName;
    [read] boolean Active;

    [WmiMethodId(17), Implemented, Description("Get Feature Value ")] void GetFeatureValue([in] uint32 IDs, [out] uint32 value);
    [WmiMethodId(18), Implemented, Description("Set Feature Value ")] void SetFeatureValue([in] uint32 IDs, [in] uint32 value);
    [WmiMethodId(19), Implemented, Description("Get Data By Command ")] void GetDataByCommand([in] uint32 IDs, [in] uint32 Command, [out] uint32 DataSize, [out, WmiSizeIs("DataSize")] uint32 Data[]);
    [WmiMethodId(99), Implemented, Description("Get Data By Package for TAC")] void GetDataByPackage([in, Max(40)] uint8 Input[], [out] uint32 DataSize, [out, WmiSizeIs("DataSize")] uint8 Data[]);
  };

  [WMI, Dynamic, Provider("WmiProv"), Locale("MS\\0x409"), Description("LENOVO CAPABILITY DATA 00"), guid("{362a3afe-3d96-4665-8530-96dad5bb300e}")]
  class LENOVO_CAPABILITY_DATA_00 {
    [key, read] string InstanceName;
    [read] boolean Active;

    [WmiDataId(1), read, Description(" IDs.")] uint32 IDs;
    [WmiDataId(2), read, Description("Capability.")] uint32 Capability;
    [WmiDataId(3), read, Description("Capability Default Value.")] uint32 DefaultValue;
  };

  [WMI, Dynamic, Provider("WmiProv"), Locale("MS\\0x409"), Description("LENOVO CAPABILITY DATA 01"), guid("{7a8f5407-cb67-4d6e-b547-39b3be018154}")]
  class LENOVO_CAPABILITY_DATA_01 {
    [key, read] string InstanceName;
    [read] boolean Active;

    [WmiDataId(1), read, Description(" IDs.")] uint32 IDs;
    [WmiDataId(2), read, Description("Capability.")] uint32 Capability;
    [WmiDataId(3), read, Description("Default Value.")] uint32 DefaultValue;
    [WmiDataId(4), read, Description("Step.")] uint32 Step;
    [WmiDataId(5), read, Description("Minimum Value.")] uint32 MinValue;
    [WmiDataId(6), read, Description("Maximum Value.")] uint32 MaxValue;
  };

  [WMI, Dynamic, Provider("WmiProv"), Locale("MS\\0x409"), Description("LENOVO CAPABILITY DATA 02"), guid("{bbf1f790-6c2f-422b-bc8c-4e7369c7f6ab}")]
  class LENOVO_CAPABILITY_DATA_02 {
    [key, read] string InstanceName;
    [read] boolean Active;

    [WmiDataId(1), read, Description(" IDs.")] uint32 IDs;
    [WmiDataId(2), read, Description("Capability.")] uint32 Capability;
    [WmiDataId(3), read, Description("Data Size.")] uint32 DataSize;
    [WmiDataId(4), read, Description("Default Value"), WmiSizeIs("DataSize")] uint8 DefaultValue[];
  };