# ISP30 开发指南 V1.2.5：来源与逐章校对记录

## 来源及范围

- 原稿：`docs/en/Common/ISP/ISP30/Rockchip_Development_Guide_ISP30_EN_v1.2.5.pdf`，436 页。
- SHA-256：`9b31aaf27ef453d15f71be2ead6455f68edd0e3b57448a83356b0a9cf6b947f0`。原 PDF 未修改。
- 没有对应中文 PDF。中、俄文完整翻译此英文版，三语使用英文 PDF 的 42 张原图，原图自身的中文标签仍保留，不伪称中文原图或全部英文标签。
- 技术正文为第 16–436 页；保留全部技术章节、后段 RK-RAW 格式说明和最后错误码/缩略语两章。前置目录由网站现有侧边目录取代；封面日期、密级、免责声明、商标/版权声明、联系信息、读者对象、修订记录不进入正文。第 2 页技术产品/系统支持记录在文章开头说明。
- RK3588 / Linux 5.10；BuildRoot、Android 为 Y，Debian、Yocto 为 N，仅为原稿历史支持范围。ArmSoM Sige7 的 RK3588 官方信息不等同于本文旧版 AIQ/SDK 的板级验证。未运行硬件命令，未进行摄像头、VCM 或画质实测。

## 完整性与提取处理

- 逐页保存文字、坐标、表格、字体及图像清单；技术正文抽取为 4660 个有页码/单元追溯标记的有序单元。章节对应保持一致，不将 API 重复说明合并删减。
- 按字体和灰色代码背景识别代码，排除被误识别为表格的单列代码框；恢复可编辑参数表及跨页文字，保留命令、路径、API、地址、数值和代码内部注释/许可证。
- 第 76 页单元 799、第 87 页单元 947 的彩色 `//` 注释因 PDF 换行被拆开，经原页图像核对后合并同一注释，不改变文字或数值。
- 第 184 页单元 2203 将原型后的普通说明从代码块拆出，完整本地化；第 430 页单元 4626 是灰框中的普通用途说明，不当作代码跳过翻译。
- 真实 Jekyll 页面复查时，进一步去除单元 4626 普通说明的 PDF 代码框缩进，避免英文被 Markdown 误识别为额外代码块；最终三语真正代码块均为 496，渲染内容逐块一致。
- 第 404 页单元 4458、4460 只去掉 CMake 左侧印刷行号 8–11，不修改命令；第 405 页位图、日志位域和示例命令保留，另附完整本地化说明。
- 保留 42 张独立原始技术图；RK-RAW 截图中的 10 张位布局/格式表额外恢复为可编辑表格，图片和表格同时可对照。日志/界面截图仍作为独立技术图保留，不以整页截图代替正文。
- RAW unpacked 图的 Pixel 数据位为各 16 位槽的高 12 位；packed 图保留原始 Pixel1/2/3 编号，不自行改为从零编号。

## 原稿疑点：保留原文，使用前核对 SDK

以下不作为已修复的技术结论；正文保留可追溯原始信息。

- 第 1 章图题 ISP21 与 ISP30 主体不一致；正文又出现 ISP21、RK356X、RV1106、AWBV32 等其他代际/型号，不能据此扩大板卡适用范围。
- §5.1.6 与 §5.1.7 同名 `rk_aiq_uapi2_camgroup_getOverlapMap`，保留两节；`Carmelaghrup`、`parsmout`、`librkaiq.sov`、`OP_MANUALl` 等源拼写不擅改。
- AE 线性/HDR 曝光时间说明存在毫秒/秒混用；直方图声称五种模式却列 Y/R/G/B 四项；手动曝光列三项开关却称四项。
- 15×15 权重说明的 AdvancedV2_t/Advanced_t 类型不一致；多节点 AecRoute 说明却称第二节点最大；HDR FRM0–3 与三元素数组不一致。
- EvBias 公式字面上除以 `abs(EvBias)`，零值行为未解释；示例数值与注释如 `.002f` / `.02` 不一致。均不猜测修正。
- 光圈 DC/P-iris、`DCIrisHoldValue` / `DCIrisValue`、Open/Close PWM 区间及表号引用存在矛盾；WinB 约束引用 WinA 偏移，保留源文。
- `V2IIR1x3` / `V13X3`、`shitbit` 等原始类型/拼写，以及 RAW merge 中不完整句子不擅补技术条件。
- p319 的 SlopeAtZero 范围含负号，p322 原图却明确写 `0.05 and 0.05`；已重新渲染 p322 核对，不是提取漏负号。`GammaBeef` / `GammaCoef` 不一致；p329 获取矩阵名 API 的说明却称获取 saturation，p338 get 模式说明却称 set，p348–349 LDCH 说明称 FEC，p373 `PADF` 拼写均保留待核。
- p200–300：`Hillitt` / `Optmod` / `Dirk_Optmod_Hillit` 疑似错拼；单元 2478 条件写“为 5”却给 0/1 范围；单元 2536 未说明 UV 比例增减方向；2666 使用 `enhance_setting` 却称 Dehaze 开关；2759、2901 默认值缺失；2825 范围原写 `0,2 to 0.016`；2862 精度 0.1 大于所列 [0.002,0.01] 范围。
- 日志例 `0x4ff4` 被称 debug，但低四位 4 对应同页 verbose；API/驱动版本匹配示例 0x30/0x40 含混；AWS/AWB、Mrerge 保留原写法。
- AIR 最小范围 [230,250] 却默认 200；白点 RG/RB 描述有不一致；RKRAWV2 推荐块说明重复称 Raw Blocks。不得据此替换常量或猜测块名。
- RKRAWV2 寄存器格式表的 Frame number 说明写成“寄存器基地址”；帧统计表 `HDR_Gain_M_REG`、`HDR_Gain_S_REG` 的原图描述写“快门寄存器”，与 Gain 字段名矛盾。恢复表保留原说明并明确待核对，而不是静默改成增益寄存器。

## 网站验证

三语共用 `078-rockchip-isp30-development` translation_key，复用现有语言切换、侧边目录、搜索和 sitemap。构建/真实页面的统一检查结果见本批交付记录；此文件本身不是正式文章，不应列入 sitemap。