# Rockchip DDR 三语整理与校对记录

## 主任务统一验收更新（2026-10-16）

以下结果覆盖本记录早期的“待统一验收”状态：Jekyll 构建成功；本篇三语页面、原图、站内链接、表格及代码渲染检查通过；代码块 HTML 文本与 Markdown 一致。全批 30 页均已实际在浏览器打开，390px 窄屏检查无页面横向溢出，目录自动折叠，长表格/代码具备横向滚动。目录跳转、高亮、展开以及三语切换另经实际交互抽查。

本篇三个正式 HTTPS URL 均已进入现有 sitemap 和搜索索引；canonical 指向自身、hreflang 互相对应并包含自身，x-default 指向英文。robots、Google 验证文件、DNS 和原始 PDF 未修改。仅本地检查，不代表正式站响应、搜索引擎收录或硬件适配已验证。完整批次验收见 [交付报告](../common-batch-036-045/DELIVERY.md)。本地提交按用户指定顺序执行；不得自行 push 或发布。

## 来源及处理方式

- 中文：`docs/cn/Common/DDR/Rockchip_Developer_Guide_DDR_CN.pdf`，110 页，V2.7.2。
- 英文：`docs/en/Common/DDR/Rockchip_Developer_Guide_DDR_EN.pdf`，115 页，V2.7.2。
- 中文依中文正文；英文依英文正文；俄文完整翻译英文技术正文，原代码、命令、API、参数和日志保持来源语言。正文源注释提供 PDF 页码及提取块号，便于追踪。
- 原始 PDF 只读，未修改。去除封面日期/密级、法律及联系信息、读者对象和修订记录；前言的技术范围与产品版本表保留。代码内版本、时间、提交信息及必要署名不按封面声明删除。
- 文章编号与 translation_key：`037-rockchip-ddr`。不新增网站模板、语言切换、搜索或 sitemap 实现。

## 逐章覆盖

| 章节 | 中文 PDF | 英文 PDF | 核对要点 |
|---|---|---|---|
| 1 开发 FAQ | 8–52 | 7–54 | 全部 §1.1–1.29；bin 路径、四频点、DTS/OPP、容量、de-skew、ECC、MR5 和高温刷新表 |
| 2 问题排查 | 53–56 | 55–58 | 症状、原因、定位方法及原始图像；电压/RZQ 操作标明风险 |
| 3 颗粒验证 | 57–81 | 59–85 | Android、Linux、Linux 3.10、RV1108、RK3308 全流程；定频/变频/reboot/sleep，不缩写重复流程 |
| 4 DQ 眼图 | 82–89 | 86–93 | 二维/一维工具、标记说明、数值图及全部最小眼宽表 |
| 5 带宽工具 | 90–93 | 94–97 | 获取、平台、参数、运行条件、输出字段及 FAQ |
| 6 焊接检测 | 94–104 | 98–109 | 所有测试步骤、PASS/FAIL/中断示例、DDP 与 pin 对应图、FAQ |
| 7 HAL DDR ECC | 105–110 | 110–115 | 术语、配置、API、示例、错误注入和最后 MMU/异常处理补丁 |

最后一页已通过 Poppler 渲染视觉核对：CN p110 的 `Default_Handler()` 补丁完整保留；EN p115 包含 MMU 地址空间补丁及异常处理补丁，均保留。没有把末页或复杂代码当作无正文。

## 提取及排版修复

- 按页面几何区分正文、灰底代码、真实表格和图片。排除误检为表格的整页文本，恢复 EN §1.23 stressapptest/memtester 正文。
- 中文字体基线差异导致的标题拆行已合并；字形部首如“⻅/⻓/⻬”恢复正常汉字。保留所有技术数值，不推算替换。
- 相邻跨页代码框按几何位置接续；保留代码缩进、日志和 patch 行。§1.15 三条紧连的 echo 命令恢复换行，原注释保留，标为 text 而非可直接执行脚本。
- RK3399 双层合并表头展开成 5 个明确列名，原数据不变。表格保持可编辑，Windows 路径、频率、寄存器/十六进制值不改。
- source 注释后、图片后与表格前均留空行，避免 kramdown 吞表。分段步骤编号使用显式转义编号，避免重复从 1 开始。
- 正文尖括号占位符保护为行内代码，防止 `<INTERRUPT>`、`<DDR frequency in MHz>` 等被 HTML 解析吞掉。眼图 `*` 标记按字面显示。
- HTML 复查发现正文 `ps | grep memtester` 与眼图 `|` 标记被误识别成单行表，已将正文中非代码的管道/星号转义，命令与图示含义不变。预期每语 28 张可编辑表（原正文 19、前言 1、截图转录 8）。
- 配置截图、UART/频点/低功耗/刷新配置表、眼宽数字表、日志和英文 `config.ini` 可编辑转录放在原图之后；原图同时保留。眼图本身及示意图保留为图像，不以整页截图替代正文。

## 配图

- 中文 31 张，均由中文 PDF 图像区域独立提取；英文 33 张，均由英文 PDF 提取，俄文复用英文图。
- 64 张独立 PNG 位于 `docs/rockchip-ddr/assets/`；文件名包含 `cn/en`、PDF 页码和图序号。已检查中英文全部图像联系表，并对配置、眼宽数字、引脚图等重点原图放大核对。
- 英文多出的 2 张来自 §6.2.1 英文界面配置（p98 文件夹/p99 config.ini），中文没有这节，不伪称存在中文图。
- 原工具界面或源图内仍可能含中文（英文 PDF 原图本身如此），没有生成/伪造英文图；图注和 alt 已按文章语言处理。
- 读写眼图截图中的 ASCII 图形是原技术图，保留清晰原图；数值汇总表另行可编辑转录。所有图像标签、图例按源裁切范围保留。

## 源文差异和待核对疑点

1. 英文 §6.2.1 增加英文界面配置，导致后续测试小节编号相对中文偏移；两稿各自章节完整保留，俄文跟随英文。
2. EN §1.12 一个步骤先写 kernel 3.10，后文又称 kernel 3.0；保留并在俄文标明矛盾。实际适用分支须查 SDK。
3. §1.4 RK3399 文件/频率表含 933MHz，§1.12.1 讨论 928MHz；不擅自归一数值。
4. CN §3.1.4 与 §3.2.4 写可用 3427MB，但算式为 `3294MB*0.9=3084MB`；EN 对应为 `3427MB*0.9`。已在三语相关段注明，原数值不改。
5. EN §3.3.4 写总容量 4MB 却申请 512MB；作为源文矛盾保留，俄文明确提醒。不能把 4MB 静默改为 4GB。
6. 原文容量示例 `64MB=66688kB`、`128MB=133376kB`、`256MB=266752kB`、`512MB=533504kB`、`1.5GB=1582080kB` 不是通常二进制精确换算；原样保留，按实际 `/proc/meminfo` 与测试条件核对。
7. EN §3.2.2 的 memtester 路径写在 `static_stressapptest` 下，与此前的 `static_memtester` 不一致；不猜测改路径。EN §3.4.4 memtester 流程又提 stressapptest，保留源文提醒。
8. §4 二维眼图说明先称 `*`=最大眼宽 Vref、`+`=当前 Vref，后面的 max/current 解释反向；中英文均存在。三语正文显式注明，不能视为工具行为已确认。
9. EN p87 中段两处引号内 `*` 为空且出现异常斜体，已通过原页渲染确认是 PDF 本身排版缺失，不是新提取误差。英文保留空标记并注释；俄文依据同段末尾及 CN 对应段补读 `*`，明确标记为编辑解释，仍需工具输出核对。
10. 高温刷新表原文有单独反引号和 `orrk3562...` 等拼接排版瑕疵；保留可追溯信息，不把反引号当文件名一部分。源文件版本值不改。
11. `ext_temp_ref=0` 中文图称普通芯片固定 1x（3568M/J 为 2x），英文图称由代码决策；依各自图保留，不能据此替代对应 DDR bin 源码检查。
12. §7 HAL 示例适用条件是原文的平台/版本条件，不能外推所有 ArmSoM 板卡。代码涉及 ECC poison、MMU 和异常处理，仅为原厂示例，未运行。

## 适用性与验证边界

| 语言 | 技术标题（不含文章主标题） | 可编辑表格 | 代码/日志/字面路径块 | 技术图 |
|---|---:|---:|---:|---:|
| 中文 | 150 | 28 | 244 | 31 |
| 英文 | 151 | 28 | 253 | 33 |
| 俄文 | 151 | 28 | 253 | 33 |

英文与俄文全部 253 个代码/日志/字面路径块逐字相同。合并跨页框后，中文有 1230 个源位置注释，英文和俄文各 1299 个；各源正文块均进入文章，跨页接续块合入前一个位置，不删除技术正文。

- 使用“平台参考”，没有未经证实绑定 ArmSoM 产品。源文广泛涵盖芯片/内核的表述已与实际板级兼容性区分。
- 未进行任何 ArmSoM 板卡硬件验证；未执行烧写、电压调整、内存测试、ECC 注入或重启命令。所有性能/故障现象属于原文，不是 ArmSoM 实测。
- 工具/测试资源压缩包及二进制未随本文章提供，文中路径作为来源信息保留。
- 三语完整正文、图像文件、编辑记录已保存；最终 Jekyll 构建、页面/切换/目录/搜索、窄屏、sitemap/canonical/hreflang 由主任务统一验证。
- 本子任务不执行 commit、push、发布或搜索引擎提交；主任务仅按用户已授权的顺序做本地 commit，等待后续 push 指令。