# Rockchip DRM Display Driver — 三语校对记录

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

## 原稿及处理基准

| 语言 | 原稿相对资料根目录路径 | 版本 | 页数 | SHA-256 |
| --- | --- | --- | --- | --- |
| 中文 | `cn/Common/DISPLAY/DRM/Rockchip_Developer_Guide_DRM_Display_Driver_CN.pdf` | V5.9.0 | 81 | `B082995186CF5A987AC3BF4C18DA76D57203D72FCA4F6FC93596EBFB61D3D4BD` |
| 英文 | `en/Common/DISPLAY/DRM/Rockchip_Developer_Guide_DRM_Display_Driver_EN.pdf` | V5.9.0 | 87 | `18B4B1B8D5CAABF1ADA11725795E8C00A58734EDE8FCF33BA621C62B43C06C56` |

资料根目录为 `D:\ArmSoM\chatgpt-ai-work\github\docs`。原 PDF 未修改。中文文章以中文原稿为基准；英文按英文原稿校正提取排版；俄文完整翻译英文技术正文。没有把中文独有的措辞偷偷混入英文。两份原稿的版本相同，技术章节编号全部对应，分页不同。

删除第 1 页封面非技术信息、免责声明、商标/版权声明与联系方式；第 2 页保留前言和产品技术版本表，删除读者对象；第 3–4 页修订记录删除；第 5–6 页静态目录由站点已有目录替代。保留全部 12 个技术章节和末尾参考文件清单。源码中的注释、许可证或署名不按封面内容删除。

## 逐章覆盖

以下页码为 PDF 物理页码；一页可能包含前一章结尾和后一章开头。

| 技术章 | 中文页 | 英文页 | 内容核对 |
| --- | --- | --- | --- |
| 前言、产品版本 | 2 | 2 | 19 项 SoC/内核对应关系完整保留 |
| 1 DSS | 7–8 | 7–8 | VOP 1.0/2.0、加速模块与 DDR/显示链路 |
| 2 DRM | 8–9 | 8–10 | 设备节点、两种识别方式、概念表、显示/交互流程图 |
| 3 软件驱动 | 10–29 | 10–32 | U-Boot/Kernel、logo、Video Console、排障、DTS、图层、色域 |
| 4 Display feature | 29–54 | 32–58 | 完整能力/接口大表、衍生 SoC、全部 DCLK 策略及配置 |
| 5 多屏 | 54–57 | 58–62 | connector-mirror、两种 connector-split、完整 DTS |
| 6 硬件 | 57–60 | 62–65 | RGB/TTL/MCU、BT656/BT1120、bus_format、LVDS mapping |
| 7 扫描时序 | 60–63 | 65–68 | 扫描图、DRM 定义、配置转换、当前时序 |
| 8 带宽 | 63–64 | 68–69 | ARGB/NV12、所有数值与 MIPI 计算 |
| 9 调试 | 64–76 | 69–82 | 9.1–9.13、完整跨页 modetest 日志及所有命令 |
| 10 FAQ | 76–81 | 82–87 | 10.1–10.12，包括小分辨率、DSC、aclk、mirror |
| 11 定位问题 | 81 | 87 | 7 项定位步骤 |
| 12 参考文档 | 81 | 87 | 9 项原始参考资料 |

每篇原技术正文包含 115 个编号标题（12 个主章及其子章）。正文 45 张可编辑表格，共 314 行（包含表头/Markdown分隔行）；另有 19 个数据行的产品版本表。恢复跨页片段后每篇 109 个代码块；英文和俄文代码块逐字一致。中文代码依据中文原稿，保留中文注释和该原稿的命令写法，而非覆盖为英文版。

## 配图

- 中文：55 张独立原图，来自中文 PDF。
- 英文/俄文：共用 55 张独立原图，来自英文 PDF。
- 资源目录 `assets/`，文件名包含语言、物理页码和 PDF 图像对象名，便于追溯。
- 所有原图按嵌入图像导出，不以整页 PDF 图替代正文，不拉伸或裁切。表格恢复为可编辑表格；公式恢复为可编辑文字，而非截图替代。
- alt 按文章语言本地化并标明所属技术章节和原页码。原图内部的原始文字不伪装成本地化后的图片。
- 已逐一验证 55 个图片链接存在；原图字节导出保持独立文件。视觉重点检查公式页、跨页大表、原始图形和末章，不声称做过所有目标硬件/显示组合测试。

## 提取和显示修复

1. 用页面字符几何顺序恢复中英文混合标题，避免中文标题被错误拆成两行并颠倒位置。修复兼容部首、PDF 自动折行和多余空格。
2. 识别灰底代码框，排除仅为表格单元格或行内代码背景的矩形；保留缩进，拼接跨页 DTS、diff 和 modetest 日志，不删除日志字段。
3. 合并 4.1 能力表和 4.2 接口表的续页；展开合并的 SoC 单元格为每行明确的名称，保留所有参数。中英表格数据行对应，不将续页误当散落正文。
4. 中文第 15 页、英文第 16 页有两条矢量公式，PDF 文本层没有字符。视觉核对后恢复 `size = width × height × bpp / (8 × 1024 × 1024)` 及 `size = 1920 × 1080 × 32 / (8 × 1024 × 1024) = 8 MB`。原式等号保留，近似/取整疑点见下文。
5. 英文第 46 页将一个三列 VP/接口配置表的 Markdown 源码直接印在正文中；参照该文字和中文第 42 页相应表格恢复为三列表格，不新增数据。
6. 英文第 78–79 页把 modetest 输出解释和下一条说明误放入代码框，并印出字面代码围栏。恢复为自然语言正文与独立的 `modetest -M rockchip -s 156@71:1920x1080` 命令；俄文解释完整翻译，命令不变。
7. 原始可用外部链接（drm_fourcc、vop2_dump、Xrandr）恢复到正文；没有把 PDF 内部 `af://` 编辑器锚点作为网站链接。参考文件名不伪造为已存在下载地址。
8. 不重复实现语言切换或目录；按仓库现有 collection、translation_key 和布局接入。表格前后保留空行。

## 同版本原文差异与待核对事项

| 位置 | 保留的原始信息与疑点 | 处理 |
| --- | --- | --- |
| 3.1.4 | 部分段落写 `kernel_logo.bmp`，前文及 DTS 写 `logo_kernel.bmp`；另写 `route_dis0` 而例子为 `route_dsi0` | 不擅改路径，要求以 SDK 文件和节点为准 |
| 3.1.5 | `1920×1080×32/(8×1024×1024)=8 MB` 实际约 7.91 MiB，原文未明确写向上取整 | 保留原式和 8 的配置值，记录疑点 |
| 3.1.6 | `bootargs` 示例结尾使用弯引号；停机调试使用 `while(1)`；个别语句缺分号 | 保留源文，不视为生产可直接执行的补丁 |
| 3.2.2 | 源表出现 `rocckhip_rgb.c` 等拼写 | 保留并要求对照实际 BSP，不猜测文件名 |
| 3.2.4.1 | 正文出现 `charege_logo,mode`，DTS 示例为 `charge_logo,mode` | 保留可追溯原始标识符 |
| 3.2.4.2 | RK3568 共 6 层，却同时建议主屏超过 3 层、其他两个屏各不少于 2 层 | 数量描述矛盾；保留原例和原描述，实际分配按硬件/SDK核对 |
| 4.2 | RK3288 RGB 英文写 `GB888`，中文写 `RGB888`；若干 HDMI 协议/最大分辨率组合也应对照 datasheet | 各语言保持自己的来源，未静默合并 |
| 4.5 多处 | 中文描述为整数倍分频，英文写 “output frequency is an integer multiple of the PLL frequency”，方向可能相反 | 英文原描述保留；俄文明确归因英文原稿并指向本记录；不改 PLL 参数 |
| 4.5.5.1 | `dclk_vp0/1/` 末尾多斜杠 | 保留原文 |
| 4.5.5.4 | RK3576 段落混用 `hdmi_phy_pll` 与 `hdmi_phy0_pll`；“dclk 大于 4k@60Hz”混用频率与显示模式 | 保留原文，不推断新时钟名或阈值 |
| 4.5.5.5 / 4.5.6.5 | 叙述同时写不超过/小于等于 600MHz 和大于等于 600MHz；相应表格写 `>600MHz` 与 `<600MHz`，没有等于条件 | 保留全部边界，要求查驱动分支，未自行选一边 |
| 4.5.6.4 | 中文两 DP/一 HDMI 配置表表头重复“接口配置1/2”；英文标为 1/2/3/4 | 各自保留，四个数据列均完整；不静默修改中文表头 |
| 4.5.6.5 | 场景文字说 DP0 使用 VP1，紧接表格列 VP2→DP0 | 保留文字与表格，不猜测哪一个正确 |
| 5.1 | 英文将 7 路输出描述成由 VP3 经 BT656/BT1120 输出，和图中整个系统共 7 路的语义不够一致 | 英文保留；俄文明确 7 路为原文所述整体四组场景，不把它当成 VP3 单口能力保证 |
| 6.1.1 | VOP 版本指向“3.1”，实际能力表在 4.1 | 保留源文引用并在此标注 |
| 9.2 | 英文命令含字面 `**ff900000.vop**`，中文命令没有星号；英文示例路径含 `**video_port0**` | 保留原稿差异，星号是强调残留风险，实际命令必须核对并使用真实设备路径 |
| 9.5 | 533280000 与 533279987 HZ 的示例差异很小，原文仍称很可能无法亮屏 | 保留日志与原作者判断，不写成 ArmSoM 测试结论或普适精度阈值 |
| 9.11 | 暂停 weston/Xorg 的命令原文写大写 `Kill` | 保留，提示 shell 命令大小写需实机核对 |
| 10.1 | 原文建议 Logic 电压增加 100mv | 仅是原文排障建议，不作安全电压保证；必须检查芯片、电源和板级限制 |

上述疑点没有通过硬件、寄存器或驱动源码执行验证。SDK、内核、硬件时序、图层能力等“当前”措辞均属于 V5.9.0 原文语境，不代表所有现行产品。

## 验证状态

- 三语技术编号序列一致：115 个；最后一章和参考清单已检查。
- 英俄 109 个代码块逐字一致；三语均包含完整 109 个块，中文/英文注释与原稿差异保留。
- 45 张正文可编辑表 + 1 张产品版本表；列数检查通过，续页大表已恢复。
- 三语各 55 个图链接检查通过，均指向本仓库对应原图。
- 所有英文正文/表格说明已完整本地化为俄文；API、文件名、原始代码/日志和图中文字保留原始形式。灰底命令说明另外补充俄文解释。
- 未做硬件测试，未执行寄存器/调压/系统修改命令。没有修改源 PDF、robots、站点验证文件或公共布局。
- 批次主任务负责最终 Jekyll 构建、实际页面访问、SEO、搜索/列表和响应式交互验收；本记录不预先宣称这些已通过。
- 最终渲染复查发现：代码、图表或独立说明打断有序列表后，Kramdown 会将后续的 2./3. 等重置显示为 1。已对这些受打断列表组的数字点转义，保留原稿编号；未改代码，109 个代码块逐字比对不变。连续列表仍使用原有 Markdown 列表。

## English editorial summary

All 12 technical chapters and their 115 numbered headings are retained. English follows the supplied English V5.9.0 PDF; Russian translates that complete technical body. Chinese follows its matching V5.9.0 PDF. Differences and suspected source errors remain traceable above. Each article includes 109 code blocks, 45 body tables plus the product-version table, and 55 source figures. No ArmSoM hardware validation or deployment was performed.

## Редакторское резюме

Сохранены все 12 технических глав и 115 нумерованных заголовков. Английская статья следует английскому PDF V5.9.0, русская полностью переводит его технический текст; китайская следует китайскому PDF V5.9.0. Различия и предполагаемые ошибки оригиналов перечислены выше без произвольной замены значений. В каждой статье 109 блоков кода, 45 таблиц основной части и таблица версий платформ, 55 исходных рисунков. Аппаратная проверка ArmSoM и публикация не выполнялись.