# 068-rockchip-gpio 校对记录

校对日期：2026-10-18。三语完整技术正文和原图已保存；全站构建、搜索、SEO、链接及浏览器验收由主任务统一执行，本记录不预先宣称已经通过。

## 来源、版本与语言策略

- 唯一原稿：`D:\ArmSoM\chatgpt-ai-work\github\docs\cn\Common\GPIO\Rockchip_Developer_Guide_GPIO_CN.pdf`，42 页，V1.0.1。
- SHA-256：`25d24277bbbad7e2e7dfee3e591a3f38dbf431b893c2fe5c4b15580f2d888e91`。
- 未提供对应英文 PDF；中文完整整理中文技术正文，英文与俄文完整翻译该正文。三语共用中文 PDF 的 17 张独立原图，不将其中的英文标签冒充英文来源。图注和 alt 按文章语言本地化。
- 技术正文从 PDF p.4 保留至末页 p.42，包括最后 §10.9 和代码/补丁。封面日期、密级、声明、联系方式、读者对象、修订表与重复目录不进入文章；p.2 的技术适用表保留。代码许可证、作者和必要技术提交信息保留。原 PDF 未修改。

## 完整性统计

| 语言 | 原文技术标题 | 代码块 | 独立原图 | 可编辑表格 |
|---|---:|---:|---:|---:|
| ZH | 39 | 77 | 17 | 13 |
| EN | 39 | 77 | 17 | 13 |
| RU | 39 | 77 | 17 | 13 |

表格包含原文适用表 1 张、正文 gpio4 分组表 1 张，以及图片内寄存器/地址内容恢复的 11 张表；另保留寄存器标题/地址文本的可编辑转录。图片和表格同时保留，用于追溯。p.29 芯片地址空间图为结构图，保留清晰原图，不以整页截图替代正文。

## 逐章检查

| 章节 | PDF 页码 | 保留与检查范围 |
|---|---|---|
| 1 IO-Domain | 4–7 | 电压域、寄存器位、原理图、Kernel/U-Boot 配置 |
| 2 Kernel 开发 | 7–16 | 引脚复用、驱动强度、输入输出、完整 C 示例、动态 IOMUX |
| 3 U-Boot 开发 | 16–21 | LED/GPIO 驱动、DTS、probe 调用过程、跨页代码 |
| 4 用户态 | 21–23 | sysfs、gpiod、命令及输出 |
| 5 休眠唤醒 | 23–25 | 唤醒 GPIO 与休眠电平配置 |
| 6 扩展芯片 | 25–26 | 配置与驱动路径 |
| 7 GPIO 模拟 I2C | 26–27 | DTS、menuconfig 与配置说明 |
| 8 调试工具 | 27–35 | IO/IOMUX/Pinconfig/PinDebug，全寄存器表、地址、掩码和命令 |
| 9 排查步骤 | 35–39 | 电源、复用、时钟、冲突与寄存器确认 |
| 10 FAQ | 39–42 | 全部 9 小节，JTAG、平台限制、中断绑定与延迟 |

全部 39 个技术页已渲染视觉核对。提取重复的灰框代码去重，移除空代码框；跨页连续代码合并，长 C 示例和补丁没有截短。中文兼容字形按文字规范还原。p.8 引脚说明中提取黏连的 `&gpio3RK_PB7` 恢复为 `&gpio3 RK_PB7`；折断的 `pmu-io-domain` 与 diff 文件头恢复连接。U-Boot probe 的跨页句子合并。§10.9 灰底的自然语言说明不是代码，三语均作完整正文处理。图片中的寄存器说明、写使能条件、复位值、PCIE/JTAG 条件和 B/HW/W 注释均恢复为可编辑内容。原稿内部省略号按原文保留，不补造缺失程序。

## 保留的原文疑点（未擅改）

- §1.1 出现 `GRM/PMUGRF`，与后文 `GRF` 术语不一致；原文保留。
- p.9 DTS 例存在 `rockchip,pin` 单数形式，其他例使用 `rockchip,pins`；不全局替换属性名。
- p.10 `gpio2a0_ds` 表复位值 `0x6`，但可见驱动强度映射只列 `3'b000` 至 `3'b101`；原值和映射完整保留，不猜测缺失编码。
- p.15 前文说 RK3588 Android12，代码注释涉及 Android14；保留并要求实际 SDK 复核。
- §8.1.1 p.30 原文称写 bit0，但该处未给对应实际写命令；未自行补造。
- §8.1.2 p.34 文字说写 `0x1234`，命令却写 `0xffff1234` 并有高 16 位 mask 注释，输出也为 `ffff1234`。全部照录，不能把任一数值当作通用硬件结论。
- §9.3 讨论 GPIO4，但时钟状态命令示例出现 gpio3；未替换。
- §9.5 有“IO复位”表述，且 GPIO2C2 文字与图中 GPIO1_A5/A6/A7 示例不一致；分别保留。
- §10.4 标题写 RV1108 `gpio1a0~gpio1b1`，正文写 `gpio3b0~gpio3c3`，原文冲突保留。
- §10.8 为原文中断绑定补丁，不代表当前所有 SDK 的 API 或行为；未应用补丁。

## ArmSoM 适用和安全

源适用表为“Rockchip所有平台”，并不等于所有 ArmSoM 板卡支持所有例子。具体例涉及 RK3399、RK3588、RV1103/RV1106、RV1108；内核/U-Boot、Android、SDK/BSP、引脚、电压域及外设接线必须按实际板卡核实。无硬件实测。文中 IO 域设置、GPIO 输出、时钟操作、寄存器写入与休眠操作可能影响系统或损伤硬件，均未执行。

## 文件与验证边界

文章：`_articles/068-rockchip-gpio.md`、`_articles_zh/068-rockchip-gpio.md`、`_articles_ru/068-rockchip-gpio.md`；原图：本目录 `assets/`。统一 translation_key，类别复用 `interfaces`，未改共享语言切换、目录、SEO、搜索或模板。三语代码块逐块一致。此子任务没有 commit、push、发布、搜索引擎提交、DNS 或权限操作。