# GMAC PTP1588 校对记录

## 来源和语言基准

- 唯一原稿：英文 `Rockchip_Developer_Guide_GMAC_PTP1588_EN.pdf`，V1.0.0，16 页，文件标识 RK-KF-YF-C33。
- SHA-256：`6cafa23685d62d9f774a4fd6a798536842828e97c2e8519146d5640171e6d214`。
- 合并目录中没有同主题中文 PDF。英文保留完整技术正文，中文、俄文完整翻译英文原稿；不声称存在中文原图。三语使用英文 PDF 全部六张原图，按语言本地化图注和 alt。英文原稿的部分图内标签和示波器界面本身为中文，保留其实际面貌。
- 保留原前言技术概述及产品版本表：RK3588、RK3576、RK3568、RK3506、RV1126、RK2118，Kernel Version 为 ALL。ALL 是原稿范围，并非逐板/逐内核验证结论。
- 删除封面发布日期、文件密级、声明/商标/版权段落、联系方式、读者对象和修订记录，不修改原始 PDF。保留版本、来源信息及正文全部技术章节。

## 逐章和末章核对

| PDF 页 | 技术内容 | 完整性与处理 |
| --- | --- | --- |
| 2 | 前言概述、产品版本 | 概述完整进入适用说明；六种 SoC 及 ALL 原样保留。 |
| 4–5 | 1、1.1 原理及延迟请求—响应 | 保留原时序图与从 t1 到 t4 的七步收发流程，跨页连续对应。 |
| 5 | 1.2 偏差与时延 | 原提取文本遗漏图内公式，视觉核对后把两个公式同时恢复为可复制文本，保留原公式图。 |
| 5–6 | 1.3 报文地址 | 合并跨页的第四个 IPv4 v1 地址；IPv4 v2、IPv6、Ethernet 组播地址全部保留，不改疑似错误的 IPv6 字串。 |
| 6–8 | 1.4 GMAC 时钟原理 | 保留数字/二进制翻转范围、TSUPDT、全部寄存器名、32 位累加器框图、0x80000000、100M、0x14 和 0.466 ns。 |
| 8 | 1.5 时间戳获取 | 保留 TX 描述符图和 C 函数；描述符的四个字、OWN bit31 与 Status[30:0] 另恢复可编辑表。 |
| 9–10 | 2、2.1 ethtool 与 ptp4l | 完整保留全部 ethtool 能力/过滤模式列表、主从命令及从 420.071 到 460.086 的日志；保留 ns/ppb、s0/s1/s2、E2E/P2P 说明。 |
| 11 | 2.2 系统时钟 | 保留主从方向的 phc2sys/ptp4l 命令和同步前后四次 date 输出。 |
| 11–12 | 2.3 gPTP | 保留两个命令、配置路径、全部日志、初始巨大 RMS 值及其后 204.570 至 229.609 的每行数据。 |
| 12–14 | 3、3.1–3.2 固定 PPS | 合并跨页句子；保留全部频率示例、50% 占空比、537/463/268/195/134/61 ms、下降沿对齐及两张波形图。频率列表转换为可编辑表，原省略号不补猜。 |
| 15 | 3.3–3.4 Flex PPS 与支持范围 | 完整保留三个 period 写入、后台主从命令、100s/200s、百 ns 的原文测量陈述及 RK3568/RV1126 除外条件。 |
| 15 | 4 RT-Thread | 完整保留 RK2118 / RT-Thread 说明。 |
| 16 | 5、5.1–5.2 常见问题 | 保留 TX 超时错误串、400 与 -f 参数以及最后完整补丁；核对文件路径、hunk、条件与所有上下文行。 |

## 配图清单

六张独立图片位于 `assets/`，220 dpi 按原图区域渲染，不用整页截图代正文。

| 文件 | 英文 PDF 页 | 内容 |
| --- | --- | --- |
| en-p04-figure1.png | 4 | 主从 Sync/Follow_up/Delay_Req/Delay_Resp 时序 |
| en-p05-figure1.png | 5 | delay、offset 公式 |
| en-p07-figure1.png | 7 | Addend、Accumulator、Sub-second、Second 寄存器框图 |
| en-p08-figure1.png | 8 | TDES0–TDES3 时间戳布局 |
| en-p13-figure1.png | 13 | PPS 残余抖动示波器截图 |
| en-p14-figure1.png | 14 | PPS 下降沿对齐及周期示波器截图 |

## 提取与排版修复

- 逐页保留几何坐标以区分正文、代码框和原图。重复/空白代码框不形成空代码块，真实重复示例仍保留。
- 恢复图内公式：`delay = ((t2-t1)+(t4-t3))/2`，`offset = ((t2-t1)-(t4-t3))/2`；恢复低字/高字、OWN 与状态字段的可编辑表。
- 合并固定 PPS 的第 12–13 页跨页句；第 5–6 页 IPv4 列表续行保持为同一组四个地址。
- 复原第 12 页 `delay` 后被排版折行的 `15780 +/- 0`，仅合并原逻辑日志行，不修改任何数字或符号。
- 第 16 页 diff 的文件路径与 hunk 函数签名被 PDF 硬折行，恢复逻辑行；按可见补丁对齐上下文及新增条件行缩进，保留全部 `+`/`-` 和源码标识。未应用、编译或执行该补丁。
- 文中寄存器、十六进制值和接口通配符按 Markdown 字面显示，避免尖括号/星号/下划线影响正文。
- 三语均为 19 个原编号技术标题，另有适用说明；3 张可编辑表、19 个代码块（含恢复的公式）、6 次原图引用。

## 原文疑点（未擅自改为推测值）

1. PDF p6 的 IPv6 字串为 `FF0x:0:0:0:0:0:0:0:0:181` 与 `FF02:0:0:0:0:0:0:0:0:6B`，分组数和写法疑有问题；三语保留原字串并提示，工程配置应对照对应标准及驱动实现。没有静默缩写成另一地址。
2. PDF p9 工具名写 `phy2sys`，同段及后文命令为 `phc2sys`；前者按原文保留，不能据此认定存在同名可用工具。
3. PDF p11 文字写 CST 比 UTC “behind” 八个时区，但后面的 19:51:52 CST / 11:51:52 UTC 示例表现相反。三语显式说明矛盾，保留全部原始输出，不把错误方向作为新的事实。
4. PDF p11 的 gPTP 全称写 `general precise time protocol`。原措辞保留为来源表述，未替换成外部推测术语。
5. PDF p12 第一行 gPTP 日志将配置参数串放在 `selected /dev/ptp0 as PTP clock` 之后；首个 RMS/max 为极大整数。原样保留，不把异常首样本描述为稳定精度。
6. PDF p15 的两个后台 ptp4l 命令主从均用 eth0，而第 2.3 节主端用 end0；这是不同原文示例，执行前须核对实际网络接口和 PTP clock。文档没有提供 gPTP.cfg 的内容，未凭空补文件。
7. 源表 Kernel Version 为 ALL，且 PPS 支持排除 RK3568/RV1126；不能把这种平台范围扩展为所有 ArmSoM 产品的板级能力。

## 验证边界

三语全文、六张原图与校对记录实际保存，代码逐项保持同一来源。原文日志、波形、百纳秒/亚微秒结果不是 ArmSoM 实测；未在本机执行网络时钟同步、sysfs 写入或补丁。

网站 build、三语访问、目录/搜索/移动布局、canonical/hreflang、sitemap 与本地 HTTP 检查由本批统一验收，结果见批次交付记录。不声称 Google 已收录或排名提升。本篇不属于正在发布的固定 22-commit 队列，未经新指令不 commit/push/发布。