PowerTOP 技术文档

本文档将详细介绍如何安装、使用 PowerTOP，以及如何使用其 API。PowerTOP 是一个用于诊断 Linux 系统中电源消耗和电源管理问题的工具。

1. 安装指南

PowerTOP 使用 C++ 编写，适用于基于 Linux 的操作系统。要使 PowerTOP 正常运行，需要以下依赖项：

• 内核版本 >= 2.6.38
• ncurses-devel
• libnl-devel
• 如果有 PCI，则需要 pciutils-devel
• autoconf-archive（用于构建）

在 Ubuntu 系统中，可以使用以下命令安装必要的软件包：

sudo apt install libpci-dev libnl-3-dev libnl-genl-3-dev gettext \
libgettextpo-dev autopoint gettext libncurses5-dev libncursesw5-dev libtool-bin \
dh-autoreconf autoconf-archive pkg-config

2. 项目使用说明

2.1 构建步骤

在克隆的源代码中构建 PowerTOP，使用以下命令：

./autogen.sh
./configure
make

2.2 运行 PowerTOP

PowerTOP 的基本操作包括需要的内核配置选项（或内核补丁）以确保完全功能。运行 powertop --help 可查看所有选项。

内核参数和（可选）补丁

PowerTOP 需要一些内核配置选项启用才能正常工作。截至 linux-3.3.0，以下是需要启用的配置选项（列表可能不完整）：

CONFIG_NO_HZ
CONFIG_HIGH_RES_TIMERS
CONFIG_HPET_TIMER
CONFIG_CPU_FREQ_GOV_ONDEMAND
CONFIG_USB_SUSPEND
CONFIG_SND_AC97_POWER_SAVE
CONFIG_TIMER_STATS
CONFIG_PERF_EVENTS
CONFIG_PERF_COUNTERS
CONFIG_TRACEPOINTS
CONFIG_TRACING
CONFIG_EVENT_POWER_TRACING_DEPRECATED
CONFIG_X86_MSR
ACPI_PROCFS_POWER
CONFIG_DEBUG_FS

从 linux-3.13.rc1 开始，还需要以下配置：

CONFIG_POWERCAP
CONFIG_INTEL_RAPL

patches/ 目录中的补丁是可选的，但可以启用 PowerTOP 的全部功能。

输出报告

当以 root 权限运行 PowerTOP 并且没有参数时，它将以交互模式运行。在这种模式下，PowerTOP 与 top 命令类似。

对于生成报告或提交功能性错误报告，有两种输出模式：CSV 和 HTML。可以设置采样时间、迭代次数、在哪些工作负载上运行 PowerTOP，以及是否包含 debug 级别的输出。

• 对于 HTML 报告，使用以下选项运行 PowerTOP：

powertop --html=report.html

这将生成一个静态的 report.html 文件，适用于分享。

• 对于 CSV 报告，使用以下选项运行 PowerTOP：

powertop --csv=report.csv

这将生成一个静态的 powertop.csv 文件，也适用于分享。

如果希望提交一个功能性错误报告，生成并分享一个 debug 模式的 HTML 报告，使用以下命令：

powertop --debug --html=report.html

重要提示： 由于 PowerTOP 是为特权（root）用户设计的，您的报告（特别是以 --debug 模式运行时）将包含详细系统信息。PowerTOP 不会 清理、擦除或以其他方式匿名化其报告。在分享报告时，请留意这一点。

校准和电源数据

在电池供电时，PowerTOP 跟踪系统上的功率消耗和活动。一旦收集到足够的数据，PowerTOP 可以开始报告各种活动的功率估计。通过至少运行一次校准周期，可以提高估计的准确性：

powertop --calibrate

校准包括在各种显示亮度级别（包括“关闭”）、USB 设备活动和其他工作负载之间循环。

Extech 功率分析仪/数据记录仪支持

我们的分析团队使用 Extech 功率分析仪/数据记录仪（型号 380803）。PowerTOP 通过串行电缆支持此设备，通过在命令行上传递设备节点来使用以下命令：

powertop --extech=/dev/ttyUSB0

（其中 ttyUSB0 是系统上串行到 USB 适配器的设备节点）

3. 项目 API 使用文档

PowerTOP 当前没有提供官方的 API 文档。使用时，请参考源代码和项目社区的说明。

4. 项目安装方式

请遵循以下步骤安装 PowerTOP：

1. 安装依赖项。
2. 运行构建脚本。
3. 按照使用说明运行 PowerTOP。

以上步骤将帮助您顺利安装和使用 PowerTOP，以便诊断和优化 Linux 系统的电源管理。