# MIPI DSI2 提取与三语校对记录

## 来源和范围

- 原稿：`docs/cn/Common/DISPLAY/MIPI/Rockchip_Developer_Guide_MIPI_DSI2_CN.pdf`，74 页，V2.3.0。
- 未提供对应英文 PDF。中文为共同基准，英文、俄文完整翻译技术正文，不拼接旧版英文资料。三个版本均使用中文原稿的 72 张原始技术图，不伪称英文原图；图内中文标识如实保留，图注/alt 本地化。
- 原文范围：RK3576 Kernel 6.1；RK3588 Kernel 5.10/6.1。文章仅作 ArmSoM 平台参考，板卡、具体 BSP、内核分支、面板、供电/复位时序与布线仍须核对，未进行硬件验证。
- 不执行示例中的寄存器、sysfs、PHY 配置或补丁操作。原厂示例、波形与测量值不写成 ArmSoM 实测。

## 完整性清单

源技术正文为 PDF 第 6–74 页，包含全部 19 个主章节、115 个技术标题。各章范围已按正文而非目录核对：

| 章节 | 内容 | 原 PDF 页 |
|---|---|---|
| 1–2 | Introduction、功能列表 | 6 |
| 3–6 | SoC 接口差别、Host/DPHY 差别与应用 | 7–8 |
| 7 | U-Boot/kernel 驱动、配置、参考 DTS | 9–10 |
| 8 | 完整 DTS、三页属性表、时序、flags、初始化包类型 | 10–17 |
| 9–10 | 视频包时序与带宽公式 | 18–19 |
| 11 | DSC、slice、编码、带宽、PPS、实例 | 19–23 |
| 12–13 | 显示路由、DSC bypass、启动 LOGO | 24–26 |
| 14–15 | 单/双通道、dual-link、SerDer、多屏、DC-PHY | 26–35 |
| 16–17 | 动态帧率与 PSR | 35–36 |
| 18 | 协议层、状态机、Escape/LPDT/ULPS/HSDT/BTA、短/长包、DI、视频时序 | 36–51 |
| 19 | FAQ、时钟、通信、TE、主从切换、完整驱动补丁、PHY 电压/电阻/时序 | 52–74 |

最后一节 `19.10.3.5 Ths_exit` 及命令保留。正文没有另附技术附录。封面声明、非技术修订记录/读者对象与重复目录不进入文章；技术版本和适用范围保留。原 PDF 未修改。技术图内部已有的厂商水印未改写/重绘，避免损伤技术内容。

## 提取和排版修复

- 按几何坐标提取正文、灰底代码、表格和图片。只删除同一页同一坐标同一文本的重复灰底框，不删除不同位置的重复示例。
- 连续跨页代码按原顺序合并，包括 DTS 和第 60–69 页驱动补丁。修复补丁路径 `.c`/`.h`、函数签名和 hunk 头的 PDF 视觉折行；不修改参数、掩码或寄存器值。
- 第 11–13 页属性表合并为一个可编辑表格：保留跨页首行 `backlight`，恢复合并单元格的属性、说明和取值；修复 `rockchip,lane-rate`、`prepare-delay-ms` 等断词。表内 `|` 转义，避免 flags 分裂成错误列；尖括号实体转义，防止 HTML 吞掉数值。
- Eotp 四字段粘连恢复成独立代码行；修复汉字兼容字形、列表编号和正文特殊符号。代码注释保留原语言，未做自动“优化”。
- 72 张图均独立提取为 PNG，检查全部接触表及关键表格放大图，保留图例和标签，不用整页 PDF 图片代替正文。
- 图中可编辑内容补录：DSI/PHY 兼容性、带宽输入及公式、DSC 带宽、PPS 27 字段与 31 个 PA 值、面板速率/porch、DPHY 状态、模式进入/退出序列、Escape 命令、DI 字段、29 行数据类型、cap-peaking 寄存器/设置/阻值。PPS 原图只展示到 PA31，不猜测后续字节。
- 每段保留原 PDF 页码与 block 注释，便于追溯；正文不重复加入语言切换。使用既有 translation_key、分类和站点机制。

## 原文疑点：保持原值，需厂商/BSP 核对

| 位置 | 问题与处理 |
|---|---|
| p.6、p.14 | 功能列表写 DSI-2 Version 1.1，Eotp 说明写 RK3588/RK3576 DSI V2.0；保留两处，不擅自解释为同一版本。 |
| p.11–13 | 属性表写 `auto-calculation`，DTS 示例写 `auto-calculation-mode`；保留。若干布尔项写“布尔类型 string”，保留并在译文标注原文措辞，不猜为合法 DT 类型。 |
| p.19 | C-PHY 代入公式使用 4450，而同图 Htotal=4400；C-PHY 左侧公式单位 Gsps，右侧数值单位 Gbps。均按原图记录，不把结果视为修正计算或实测。 |
| p.21、p.23 | DSC 波形/带宽及客户屏参数只按源文记载，不用其推出所有面板均可按固定 1/3 带宽工作。 |
| p.35 | 原文 `tree-wire-trios` 疑为 `three-wire trios`；译文给出三线含义并保留原拼写说明。 |
| p.52 | `mipi_pixel_clock = cds_clk/2` 的 `cds_clk` 与其他 DSC 时钟名称可能不一致，保持原拼写。 |
| p.60–69 | 补丁为文档示例，未验证可直接应用。`REG_645M_MASK` 为 GENMASK(2, 0)，读取却 `>> 4`；cap_peaking 的掩码/移位亦需核对；保留原值，不修算法。 |
| p.71–73 | 正文电阻编码前半为 43/46/49/52/56/60/66/73Ω；p.73 设置图为 42/44/46/49/52/58/64/73Ω。分别保留并在三语图表旁提示，不选择其一覆盖。 |
| p.73 | 寄存器默认 `EDGE_CON_DIR` 与设置指南、补丁中依 DPHY/CPHY 选择方向的写法需按实际芯片/BSP核对。寄存器表保留原图默认值。 |

## 验证状态

- 本主题文件和 72 张图已保存；三语 115 个源技术标题、72 个图引用与完整代码共同基准已对照。
- 原图、提取段落、跨页表和最后一章已检查；没有使用摘要替代章节。
- 统一 Jekyll 构建、浏览器桌面/手机显示、搜索、语言切换、sitemap/canonical/hreflang/robots 由主任务统一验收后补充结果；本记录不冒称已经通过。
- 不提交 Search Console、不修改 DNS、不发布；本子任务不执行 commit 或 push。