요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
Kernel driver power_meter
=========================
This driver talks to ACPI 4.0 power meters.
Supported systems:
* Any recent system with ACPI 4.0.
Prefix: 'power_meter'
Datasheet: https://uefi.org/specifications, section 10.4.
Author: Darrick J. Wong
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.rst.
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.
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.
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.
For information on enabling the power cap feature, refer to the description
of the "force_on_cap" option in the "Module Parameters" chapter.
To use the power cap feature properly, you need to set appropriate value
(in microWatts) to the `power[1-*]_cap` sysfs files.
The value must be within the range between the minimum value at `power[1-]_cap_min`
and the maximum value at `power[1-]_cap_max (both in microWatts)`.
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.
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.
Module Parameters
-----------------
* force_cap_on: bool
Forcefully enable the power capping feature to specify
the upper limit of the system's power consumption.
By default, the driver's power capping feature is only
enabled on IBM products.
Therefore, on other systems that support power capping,
you will need to use the option to enable it.
Note: power capping is potentially unsafe feature.
Please check the platform specifications to make sure
that capping is supported before using this option.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
ACPI 4.0 power meter
1-25`power_meter` driver는 ACPI 4.0 power meter와 통신하며 ACPI 4.0을 제공하는 최신 system을 지원합니다. Prefix는 `power_meter`, specification은 UEFI 사이트의 ACPI section 10.4이며 저자는 Darrick J. Wong입니다.
ACPI 4.0 chapter 10.4에 노출된 power meter sensor reading을 구현합니다. Device 기능은 configurable interval 동안의 average power use, optional hardware power capping, 두 trip point입니다.
Sysfs interface는 `Documentation/hwmon/sysfs-interface.rst`의 Power section을 따릅니다.
Firmware가 제공하는 meter capability입니다.
ACPI object가 standard hwmon Power ABI로 연결됩니다.
Kernel driver power_meter
=========================
This driver talks to ACPI 4.0 power meters.
Supported systems:
* Any recent system with ACPI 4.0.
Prefix: 'power_meter'
Datasheet: https://uefi.org/specifications, section 10.4.
Author: Darrick J. Wong
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.rst.
Trip point, metadata와 hardware cap
26-62`power[1-*]_is_battery`는 power supply가 battery인지 나타냅니다. Trip point가 동작하려면 `power[1-*]_average_min`과 `power[1-*]_average_max`를 모두 설정해야 합니다. 둘 다 설정되면 event 발생 시 ACPI netlink socket에 ACPI event가 broadcast되고 해당 `power[1-*]_average` sysfs file에 poll notification이 전달됩니다.
`power[1-*]_model_number`, `serial_number`, `oem_info`는 ACPI meter가 제공하는 임의 string을 표시합니다. `measures/` directory에는 이 meter가 측정하는 device로 향하는 symlink가 있습니다.
Hardware power cap을 강제할 수 있는 computer에서는 `power[1-*]_cap`과 관련 sysfs file이 나타납니다. 기능 활성화는 module parameter 절의 `force_on_cap` 설명을 참조하라고 원문에 적혀 있지만 실제 parameter 이름은 아래에서 `force_cap_on`으로 표기됩니다.
Power cap을 사용하려면 `power[1-*]_cap`에 microWatt 단위 값을 설정합니다. 값은 `power[1-]_cap_min`의 minimum과 `power[1-]_cap_max`의 maximum 사이여야 합니다.
Average consumption이 cap을 넘으면 ACPI netlink event와 해당 `power[1-*]_alarm` poll notification이 발생해 capping 시작을 알립니다. Hardware가 소비 전력을 낮추며 대개 성능도 감소합니다.
Firmware가 cap을 바꾸면 `power[1-*]_cap`, averaging interval을 바꾸면 `power[1-*]_interval`에 poll notification이 전달됩니다. 모든 firmware notification은 ACPI netlink event socket에도 broadcast됩니다.
Trip, metadata, cap과 notification 대상입니다.
설정 범위 확인부터 firmware notification까지입니다.
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.
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.
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.
For information on enabling the power cap feature, refer to the description
of the "force_on_cap" option in the "Module Parameters" chapter.
To use the power cap feature properly, you need to set appropriate value
(in microWatts) to the `power[1-*]_cap` sysfs files.
The value must be within the range between the minimum value at `power[1-]_cap_min`
and the maximum value at `power[1-]_cap_max (both in microWatts)`.
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.
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.
force_cap_on과 platform 안전성
63-77Boolean module parameter `force_cap_on`은 system power consumption의 upper limit를 지정하는 power-capping 기능을 강제로 enable합니다.
기본적으로 driver의 power capping은 IBM product에서만 enable됩니다. Power capping을 지원하는 다른 system에서는 이 option으로 활성화해야 합니다.
Power capping은 잠재적으로 안전하지 않은 기능입니다. Option을 사용하기 전에 platform specification에서 capping 지원 여부를 반드시 확인해야 합니다.
기본 정책과 수동 활성화 조건입니다.
Hardware support 확인이 parameter 설정보다 먼저입니다.
Module Parameters
-----------------
* force_cap_on: bool
Forcefully enable the power capping feature to specify
the upper limit of the system's power consumption.
By default, the driver's power capping feature is only
enabled on IBM products.
Therefore, on other systems that support power capping,
you will need to use the option to enable it.
Note: power capping is potentially unsafe feature.
Please check the platform specifications to make sure
that capping is supported before using this option.
요약·해설
acpi_power_meter.rst:1-77ACPI firmware power meter를 standard hwmon Power ABI로 노출하며 일부 platform에서는 hardware power cap을 제어합니다.
Source와 핵심 지원 범위입니다.
Driver를 적용할 때의 기본 순서입니다.