# Devfreq 三语整理与校对记录

整理日期：2026-10-18。本记录无 frontmatter，不作为正式文章加入 sitemap。

## 来源与版本处理

- 中文：`docs/cn/Common/DVFS/Rockchip_Developer_Guide_Devfreq_CN.pdf`，V1.1.1，26 页，SHA-256 `26993cd1ca0f7109dfce3a41206c8edcef47e25c58b63be3266cc8e251b6b544`。
- 英文：`docs/en/Common/DVFS/Rockchip_Developer_Guide_Devfreq_EN.pdf`，V1.0.0，30 页，SHA-256 `7ada9dc90beec6f5b0a88b8982bcc1d59475bb5fd9f1959186588aa64e9240f6`。
- 中文历史显示 V1.1.0 增加 Linux 4.19、V1.1.1 修改格式；英文虽然标 V1.0.0，其产品表已明确 Linux 4.4 / 4.19，且 43 个编号章节与中文完全对应。不能据此断言只是封面未更新，也不改写英文版本号。
- 中文和英文分别完整保留各自正文；俄文完整翻译英文正文。对另一语种独有的技术说明，增加明确标注来源和 PDF 页码的补译段，不静默混入。
- 原 PDF 未修改，完成后重新核对 SHA-256 相同。

## 双向补译与正文差异

| 位置 | 差异 | 处理 |
| --- | --- | --- |
| §1，CN p.4 / EN p.5 | 英文 dmc ondemand 概述额外提及 VOP bandwidth | 中文对应段后明确补译英文第 5 页说明 |
| §2，CN p.5 / EN p.6 | 英文 Governor 代码列表多 `drivers/devfreq/rockchip_dmc.c` | 各自代码全保留；中文 Driver 列表本身已有该路径和 dmc ondemand 注释 |
| §4.1.6，CN p.11 / EN p.13 | 中文明确最终电压超最大值时删除频点，英文省略此句 | 英文/俄文对应段后补译并标明 CN p.11 |
| §4.1.7，CN p.12 / EN p.13–14 | 英文额外说明超最高电压禁用频点、正常温度恢复电压 | 中文对应段后补译并标明 EN p.13–14 |
| §4.2.4，CN p.15 / EN p.17 | 中文额外说明 DDR 位于 VD logic 时 leakage 等同 logic | 英文/俄文对应段后补译并标明 CN p.15 |
| §4.2.6，CN p.17 / EN p.20 | 中文明确最终电压超最大值时删除频点 | 英文/俄文对应段后补译并标明 CN p.17 |
| §6.6 / §6.7 | 中文说明 RK3399 GPU，英文部分说明 CPU；日志同时含 CPU/GPU | 各自保留并记录，不改日志 |
| 删除 OPP 短例 | 中文有全角分号，英文为半角 | 原代码分别保留，不用一份覆盖另一份 |

原始代码排除注释与空白后比较，除英文 Governor 路径和上述全半角分号外一致。三语文章则逐一对照各自来源全部代码（包括注释）验证，只有空白布局和中文兼容字形规范化，不修改参数值。

## 完整性核查

| 技术章节 | 中文 PDF 页码 | 英文 PDF 页码 | 结果 |
| --- | --- | --- | --- |
| 1–3 架构、代码路径、Menuconfig | 4–6 | 5–7 | 全文、原图、路径全保留 |
| 4.1.1–4.1.3 GPU Clock/Regulator/OPP | 6–8 | 7–9 | 跨页代码完整续接 |
| 4.1.4–4.1.5 GPU leakage/PVTM | 8–11 | 9–12 | 所有选择器、范围、值保留 |
| 4.1.6–4.1.8 IR-Drop/宽温/负载 | 11–12 | 12–15 | 双向差异补译，公式文本完整 |
| 4.2.1–4.2.3 DMC Clock/Regulator/OPP | 13–15 | 15–17 | 完整 |
| 4.2.4–4.2.6 DMC leakage/PVTM/IR-Drop | 15–18 | 17–21 | 跨页值表、注释、最后代码全保留 |
| 4.2.7–4.2.9 场景/负载/VOP | 18–20 | 21–23 | 所有状态码、频率及带宽区间保留 |
| 4.3 BUS / PLL DVFS | 20–21 | 23–25 | 完整，原文括号疑点不猜改 |
| 5 用户态接口 | 21–22 | 25 | 全部属性和注释保留 |
| 6.1–6.5 调试 | 22–24 | 26–28 | 所有日志与调频调压命令保留 |
| 6.6–6.8 日志及修改电压 | 24–26 | 28–30 | 完整到最后一个 IR-Drop 示例 |

每语言：43 个编号标题、49 个代码/日志围栏、1 张技术版本可编辑表、1 张架构图。技术正文没有独立排版表格；OPP/debug 输出本身为代码格式，完整可复制保留，不做截图代替。

全体技术页已查看渲染图；没有额外未提取矢量图或图像公式。负载目标表达式 `90%-5%/2` 及代码中的 `40% - 20% / 2` 按原文保留，没有擅自改括号或运算优先级。

## 配图与提取修复

- 中文 `assets/cn-p4-1.png` 来自中文第 4 页；英文/俄文 `assets/en-p5-1.png` 来自英文第 5 页。分别以 220 DPI 裁出，核对所有标签、连线与边界完整，未拉伸或重新绘制。
- 合并跨页代码、注释、DTS 的 OPP 节点及英文 §4.1.7 跨页句子；仅去掉空的灰色代码框，不删除任何非空技术内容。
- 规范提取中的中文部首兼容字形和明显普通词重复；恢复 `operating-points-v2`、`opp-microvolt-<selector>` 等换行标识符。
- 正文尖括号转义，避免误作 HTML。俄文保留全部代码/日志原始语言，参数与 API 不翻译。
- 移除用户指定非技术内容；技术产品表、版本来源与代码注释保留。

## 原文疑点与适配边界

1. 中英文 §4.2.7 均将 `SYS_STATUS_DUALVIEW` 写了两遍，§4.2.8 则是 `SYS_STATUS_DUALVIEW` 与 `SYS_STATUS_ISP`。不猜改源条件；俄文明确指出矛盾，实机适配需核对 DMC 驱动。
2. 中英文 OPP 删除说明均含 `disabeld`，实际代码为 `disabled`；就近增加校对提示。中文短例全角 `；` 保留原文，不能直接当作有效 DTS 编译。
3. 英文 GPU leakage 说明使用 `rockchip, leak-voltage-sel`，代码及中文是 `rockchip,leakage-voltage-sel`；正文就近标明差异。代码注释中另外存在 `leakage-voltage-sell`，保留待核。
4. Clock 说明写 `clock`，代码使用 `clocks`；英文出现 `System-status-freq`、`Bus-supply` 大写，代码是小写；俄文明确指出，不改源代码。
5. §4.3.1 PLL 表的 `opp-1512000000` 与后续 `opp-1008000000` 之间看不到前一节点闭合 `};`，两份原稿如此；板级片段也含省略号或不完整结束分号。不擅自补结构，交付的是文档示例而非已编译 DTS。
6. §6.8 英文引用 §4.2.6（DMC IR-Drop），实际示例操作 GPU，GPU 对应 §4.1.6；保留原引用并记录。
7. 部分原稿代码注释说明值与实际配置不完全一致，例如修改后 IR-Drop 注释仍说 50000uV 而配置区间为 75000；各值与注释都原样保留，不作硬件操作依据。
8. 命令示例混有 C 风格注释，不是可直接粘贴执行的完整 shell 脚本。升频先升压、降频先降频再降压的源文警告完整保留；整理过程中未执行硬件写入命令。
9. 源产品表“所有芯片、Linux 4.4/4.19”不代表全部 ArmSoM 板卡可用。具体 SoC、PMIC/Regulator、时钟、OPP、电源域、PVTM、BSP/内核需逐板确认。文章标为平台参考，日志和 Vmin 结论是原厂示例，不是 ArmSoM 实测。

## 验证状态

已通过：三语实际保存、43/43 原目录逐项覆盖、最后 §6.8 完整、各语言全部代码去空白一致性检查、图像链接及图像完整性、原 PDF 哈希。

复用已有文章集合、translation_key 和模板，没有修改共享 SEO、robots、验证文件或站点配置。Jekyll 构建、语言互链、搜索/列表、sitemap/canonical/hreflang、响应头、侧边目录与手机滚动交由主代理统一验证；本记录不冒称已经通过这些运行时检查。

没有 commit、push、发布、Search Console 提交或 DNS 修改。