内核驱动 power_meter

此驱动程序与 ACPI 4.0 功率计通信。

支持的系统

作者:Darrick J. Wong

描述

此驱动程序实现了 ACPI 4.0 规范(第 10.4 章)中暴露的功率计的传感器读取支持。这些设备具有一组简单的功能——一个功率计,可返回可配置间隔内的平均功耗,一个可选的限制机制,以及几个跳变点。sysfs 接口符合《sysfs 文件命名和数据格式标准》中“电源”部分概述的规范。

特殊功能

power[1-*]_is_battery 旋钮指示电源是否为电池。在跳变点起作用之前,必须同时设置 power[1-*]_average_{min,max}。当它们都设置好后,ACPI 事件将通过 ACPI netlink 套接字广播,并且轮询通知将发送到相应的 power[1-*]_average sysfs 文件。

power[1-*]_{model_number, serial_number, oem_info} 字段显示 ACPI 为该功率计提供的任意字符串。measures/ 目录包含指向此功率计所测量设备的符号链接。

某些计算机具有在硬件中强制执行功率上限的能力。如果存在这种情况,power[1-*]_cap 及相关的 sysfs 文件将出现。有关启用功率上限功能的信息,请参阅“模块参数”章节中“force_on_cap”选项的描述。要正确使用功率上限功能,您需要将适当的值(以微瓦为单位)设置到 power[1-*]_cap sysfs 文件。该值必须在 power[1-]_cap_min 的最小值和 power[1-]_cap_max 的最大值(两者均以微瓦为单位)之间。

当平均功耗超过上限时,ACPI 事件将通过 netlink 事件套接字广播,并且轮询通知将发送到相应的 power[1-*]_alarm 文件,以指示已开始限制功耗,并且硬件已采取行动降低功耗。这很可能导致性能下降。

固件可能会发送其他一些 ACPI 通知。在所有情况下,ACPI 事件都将通过 ACPI netlink 事件套接字广播,并作为轮询通知发送到 sysfs 文件。事件如下:

如果固件更改功率上限,将通知 power[1-*]_cap。如果固件更改平均间隔,将通知 power[1-*]_interval

模块参数

  • force_cap_on: bool

    强制启用功率上限功能,以指定系统功耗的上限。

    默认情况下,驱动程序的功率上限功能仅在 IBM 产品上启用。因此,在其他支持功率上限的系统上,您需要使用此选项来启用它。

    注意:功率上限是一个潜在不安全的功能。在使用此选项之前,请检查平台规格以确保支持功率上限。