Documentation/hwmon/acpi_power_meter

Chinese translated version of Documentation/hwmon/acpi_power_meter
If you have any comment or update to the content, please contact the
original document maintainer directly.  However, if you have a problem
communicating in English you can also ask the Chinese maintainer for
help.  Contact the Chinese maintainer if this translation is outdated
or if there is a problem with the translation.

Chinese maintainer: 马煜晨  380319072@qq.com
---------------------------------------------------------------------
Documentation/hwmon/acpi_power_meter 的中文翻译
如果想评论或更新本文的内容，请直接联系原文档的维护者。如果你使用英文
交流有困难的话，也可以向中文版维护者求助。如果本翻译更新不及时或者翻
译存在问题，请联系中文版维护者。
中文版维护者： 马煜晨  380319072@qq.com
中文版翻译者： 马煜晨  380319072@qq.com
中文版校译者： 马煜晨  380319072@qq.com
 

以下为正文
---------------------------------------------------------------------

Kernel driver power_meter
=========================
内核驱动power_meter

This driver talks to ACPI 4.0 power meters.

此驱动需要ACPI 4.0功率计

Supported systems:
  * Any recent system with ACPI 4.0.
    Prefix: 'power_meter'
    Datasheet: http://acpi.info/, section 10.4.

Author: Darrick J. Wong

系统支持：
  * 任何搭载ACPI 4.0 的系统。
    前缀： ' power_meter “
    数据表： http://acpi.info/ ， 10.4节。

作者：作者Darrick J.黄

 

Description
-----------

This driver implements sensor reading support for the power meters exposed in
the ACPI 4.0 spec (Chapter 10.4).  These devices have a simple set of
features--a power meter that returns average power use over a configurable
interval, an optional capping mechanism, and a couple of trip points.  The
sysfs interface conforms with the specification outlined in the "Power" section
of Documentation/hwmon/sysfs-interface.

描述
-----
该驱动工具传感器支持暴露在ACPI 4.0规范的功率计读数（10.4章节）。这些设备有一组
简单的特点--一个功率计可以返回平均功率用于结构间隔，可选封顶机制，一组跳变点。
该sysfs接口与Documentation/hwmon/sysfs-interface章节中“Power”里所陈述的说明一致。

Special Features
----------------
特殊功能
--------

The power[1-*]_is_battery knob indicates if the power supply is a battery.
Both power[1-*]_average_{min,max} must be set before the trip points will work.
When both of them are set, an ACPI event will be broadcast on the ACPI netlink
socket and a poll notification will be sent to the appropriate
power[1-*]_average sysfs file.

power[1-*]_is_battery 旋钮指示如果电源是一组电池。power[1-*]_average_{min,max}
必须在触发点之前设置。当他们都被设置时，一个ACPI事件将在ACPI netlink插座播出
且一个轮询的通知将被发送到相应的 power[1-*]_average sysfs 文件中。

The power[1-*]_{model_number, serial_number, oem_info} fields display arbitrary
strings that ACPI provides with the meter.  The measures/ directory contains
symlinks to the devices that this meter measures.

power[1-*]_{model_number, serial_number, oem_info}字段显示任意字符串，由ACPI仪表
提供。这些措施／目录包含符号连接仪表测量设备。

Some computers have the ability to enforce a power cap in hardware.  If this is
the case, the power[1-*]_cap and related sysfs files will appear.  When the
average power consumption exceeds the cap, an ACPI event will be broadcast on
the netlink event socket and a poll notification will be sent to the
appropriate power[1-*]_alarm file to indicate that capping has begun, and the
hardware has taken action to reduce power consumption.  Most likely this will
result in reduced performance.

有些计算机有能力在硬件中执行功率上限。如果在那个情况下，power[1-*]_cap及相关的
sysfs文件就会出现。当平均功耗超过上限， ACPI事件将播出在netlink的事件插座上播出
且通知将被发送到适当的power[1-*]_alarm文件中来表明已经开始封顶，并且硬件已采取行
动，以降低功耗。这很可能会导致性能降低。

There are a few other ACPI notifications that can be sent by the firmware.  In
all cases the ACPI event will be broadcast on the ACPI netlink event socket as
well as sent as a poll notification to a sysfs file.  The events are as
follows:

power[1-*]_cap will be notified if the firmware changes the power cap.
power[1-*]_interval will be notified if the firmware changes the averaging
interval.

有几个其他的ACPI通知可以被固件发送。在所有情况下，ACPI事件将在ACPI netlink
的事件插座播出以及以投票表决方式发送通知到sysfs文件。事件如下：

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