# Crypto / HWRNG 校对工作记录

## 主任务统一验收更新（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 或发布。

状态：2026-10-16 已完成三语全文、图片入库与逐章结构校对；统一网站构建和浏览器验收由主任务继续。不是平台硬件验证报告。

## 来源与范围

- 中文：`cn/Common/CRYPTO/Rockchip_Developer_Guide_Crypto_HWRNG_CN.pdf`，V1.4.2，49 页。
- 英文：`en/Common/CRYPTO/Rockchip_Developer_Guide_Crypto_HWRNG_EN.pdf`，V1.4.2，52 页。
- 中文以中文原稿为准；英文以英文原稿为准；俄文翻译技术正文。两份同版本原稿仍需逐项对照，不能仅因版本相同便认定内容相同。
- 中文图使用中文 PDF 原图；英文及俄文使用英文 PDF 原图。初步识别每份 5 个图片对象，其中 2 个为性能数据表图片，需另外恢复为可编辑表格。
- 原始 PDF 只读，不修改。全部原厂性能数据必须标为原文测试数据，不属于 ArmSoM 实测。

## 已发现的源文问题与保留规则

1. **删除线具有技术意义**：英文 PDF 第 10 页 §2.1.2 用删除线表示驱动尚未实现的算法模式。已查看该页渲染图；不可将纯文本提取后失去删除线的列表作为“全部已支持”的列表发布。AES/SM4 的 XTS、CTS、CCM、CBC-MAC/CMAC，以及 HASH 列表中的 SHA512_224/SHA512_384 有删除线。需与中文对应页逐项对照。
2. **算法名称内部矛盾**：英文 §1.2 列出 SHA512-224/SHA512-256；§2.1.2 删除线列表却写 SHA512_224/SHA512_384。枚举又是 `RK_ALGO_SHA512_224` 和 `RK_ALGO_SHA512_256`。保留原始拼写及上下文，不能把 `_384` 静默改成 `_256`。
3. **标识符拼写**：`RK_CIPIHER_MODE` 是源代码枚举名，尽管看似拼写错误，不按自然语言拼写修正。
4. **标题与代码枚举名不同**：§3.2.5.3 标题为 `RK_OEM_HR_OTP_KEYID`，代码声明为 `enum RK_OEM_OTP_KEYID`。记录差异，不修改 API 常量。
5. **AEAD tag 方向**：英文 §3.2.6.25/26 将 `tag` 说明为“input for encryption, output for decryption”，疑似输入输出方向倒置；保留源文信息，并在最终正文附近提示需对照对应 SDK 实现确认。
6. **虚拟地址接口的参数说明**：英文 §3.2.6.21 使用 `src`/`dst`，注意事项却提到 `in_fd`/`out_fd`。§3.2.6.24 声明 `aad_virt`，参数描述写 `in`。不得把这些差异当作已验证接口行为。
7. **RSA 填充枚举注释**：§3.2.5.7 中 PSS_SHA384、PSS_SHA512 的注释分别写 SHA1、SHA256，疑似复制错误。代码及注释保留，另行提示。
8. **RSA 测试公式**：英文第 50 页同时使用 `d` 表示参与运算的数据和私钥指数，表达不清；不猜测替换变量。
9. **缺少函数原型**：英文 §3.2.6.22 `rk_ae_init` 标题后直接进入功能说明。已渲染检查英文第 41 页，原文确实没有函数声明；中文也无原型，不根据其它接口编造声明。
10. **空章节**：已渲染核对英文最后一页（第 52 页）及中文最后一页（第 49 页），§6 References、§7 Appendix、§7.1 Professional Term 确实只有标题，没有后续正文。三语保留标题并说明为空章节。
11. **同版本文本差异**：中文 §1.1 明确 TDES 支持 EEE/EDE，§1.2 明确只支持 EDE；英文对应表未完整写出这些限制。最终稿需显式注明中文补充来源，不能误称英文原稿已有该信息。

## 本轮整理与核对

- 三语各 104 个正文标题（含文章标题）、34 个 §3.2.6 API 小节、81 个代码块、10 张可编辑表格、5 张原图。包含前言的技术范围与 3 行 kernel 产品版本表；“RK 系列芯片”（CN）与“含 Crypto IP 的所有 Rockchip 芯片”（EN）措辞区别保留，不扩大为 ArmSoM 支持承诺。
- 三语均从第 1 章完整保留到第 7 章/§7.1；不是摘要。中文使用中文源文，英文使用英文源文，俄文完整翻译英文自然语言正文，代码与原有英文注释不翻译。
- 英文和俄文的 81 个代码块逐字一致。跨页代码按连续页、页底/页顶几何边界拼回，未改硬件地址、宏、寄存器常量或 API 标识符。灰底表格曾被重复识别为代码，已按表格几何覆盖关系去重。
- 中文编号与标题因不同字体被拆成倒序片段，已恢复为与英文一致的完整章节层级；修复 `rockchip,cryptov2-rng`、`/dev/random`、`/dev/urandom`、OTP API 等行内代码提取顺序。修复 CJK 部首字形（长、齐、见、贝、角）及跨行参数说明。
- HTML 页内追溯注释保留 PDF 页码和原始提取块编号。独立编号步骤的点作 Markdown 转义，避免追溯注释导致浏览器每项重新从 1 编号。
- 10 个独立图片均已实际查看。中文使用 CN p11/p13/p45/p47；英文和俄文使用 EN p12/p15/p48/p50。原图本身的英文 UI/图例保留，未假称中文原图的图中文字全部为中文。
- CN p47 的两张性能数据表与 EN p50 转录逐值复核一致；原图保留，并恢复 19 行吞吐数据和 8 行 RSA 时延为可编辑表格。AES 三列顺序始终为 128/192/256 位。柱状图底部 11 组分块/virt/dma_fd 数值亦恢复成可编辑表格，单位保留 kB/s，与后一表 MBps 分开。
- 原始 PDF 未修改。未执行示例代码、OTP 写入、锁定或硬件测试。Git 提交及统一网站检查交由主任务；本子任务没有 commit、push 或发布。

## 补充原文差异与疑点

- §3.2.6.25/26 的 tag 方向并非仅疑似问题：中文明确为加密 out、解密 in，英文相反。三语正文附近已显式标明冲突；没有静默混用源版本，最终行为须按 SDK 实现核验。
- §3.2.4.3 的 `key`：中文写 keyladder 操作时无效，英文写 otp key；各自保留，不能视为两个词在所有 SDK 中同义。
- §3.2.3 的 CMA 起始地址 `0x10000000`：中文是“尽量不要修改”，英文是“do not change”；保留措辞差异，地址值均不变。
- §4.2.2 中文写 V3 最高 350M，英文写 V3/V4。正文依各自来源保留，不能据此保证某个板卡的最高频率。
- §3.2.6.24 中文注意事项中出现 `rk_ae_set_virt` 和 `add`，与小节/API 的 `rk_ae_set_aad_virt`/AAD 不一致；保留为源文疑点。
- §2.1.2 的 SM4 模式列表重复 OFB；英文硬件差异表 RK1808 的 HASH 单元格写 `SHA-1SHA-224`，中文有 `/`。源文保留，不将其解释成新的算法名。
- §5.1 推荐 CTR 是原文陈述，不构成对任意协议的安全建议；应结合认证、IV/nonce 使用及完整威胁模型。文章未新增“所有算法均安全”的结论。
- 采用平台参考适用说明：未确认具体 ArmSoM 板卡的 BSP/TEE/OTP 适配，不填写未经验证的产品支持列表。源文的 kernel 4.19/5.10/6.1 提交依赖完整保留，代码中的提交作者及 Signed-off-by 作为技术溯源保留。

## 验证清单

- 构建复查修复 source 注释后、性能图与可编辑表格之间缺少空行导致的 kramdown 表格解析问题；表格内容不变。
- 俄文 §5.2 第 2 项按英文 p51 修正“物理不连续”否定关系，明确非连续内存需要驱动整理及复制；未改变任何代码。
- 构建复查将 EN/CN 的 5 处 cat 管道命令补为行内代码，防止裸露 `|` 被识别为单行表；命令字符未变，俄文原已正确保护。

- [x] 中英文逐章完整性与差异校对，含 34 个 API 小节。
- [x] 跨页代码拼接、缩进、行内代码及参数完整性。
- [x] 原图逐张检查与性能图表数值转录复核。
- [x] 三语全文、标题、简介、图注及 alt。
- [x] 适用范围与官方平台资料入口，明确未经 ArmSoM 硬件验证。
- [ ] 三语页面构建、切换、目录、窄屏、链接、搜索及 SEO 验收。
- [ ] 本篇单独本地 commit；未经用户另行指令不得 push 或发布。