datasheet-and-refmanual-reading

数据手册和参考手册阅读

目的

教会 Agent 系统地阅读 MCU 数据手册和参考手册：哪些章节与固件相关，如何交叉参照引脚表和寄存器映射，以及如何避开文档中的陷阱（勘误、脚注、条件字段）。此技能不会与 skills/baremetal/peripherals-from-datasheet 合并——本技能讲解如何阅读文档；该技能讲解如何根据文档编写驱动。

适用场景

• 开始为不熟悉的芯片编写驱动
• 解决含糊不清的寄存器位行为
• 在 PCB／固件签核前验证电气和时序限制
• 补充 skills/baremetal/peripherals-from-datasheet（侧重实现）
• 回答“在 RM 的哪里能找到 X？”

工作流程

1. 文档类型

文档	主要用途
数据手册	引脚排列、最大额定值、封装、简要特性
参考手册（RM）	寄存器映射、位字段、时钟树、外设行为
编程手册（PM）	Cortex-M 内核、NVIC、MPU、调试（ARM 文档）
勘误表	影响固件的芯片缺陷及其规避方法

阅读数据手册，了解有什么；阅读 RM，了解如何编程。

2. RM 初读顺序

1. Memory and bus architecture (address map)
2. Reset and clock control (RCC / CGU)
3. GPIO / pin multiplexing
4. Target peripheral chapter (e.g. USART, SPI, DMA)
5. NVIC / EXTI interrupt mapping table
6. Electrical characteristics (only if timing-critical)
7. Errata — search peripheral name

3. 寄存器映射提取清单

对于每个寄存器：

• 外设基地址偏移（对照内存映射表验证）
• 复位值（会影响读-改-写操作的默认值）
• 只读／只写／写 1 清零位
• 依赖模式的字段（查看表格下方的“备注”）
• 副作用：清除标志、自动清零位、保留位必须写 0

/* Good — named constants from RM bit table */
#define USART_CR1_UE   (1U << 13)
#define USART_CR1_TE   (1U << 3)

/* Bad — magic numbers without RM citation */
*(volatile uint32_t *)0x40011000 = 0x2000;

4. 引脚／信号交叉参照

Schematic net → Datasheet pin table (AF number)
             → RM GPIO chapter (MODER, AFR)
             → Peripheral chapter (USART_TX on PA2 = AF7)

务必确认复位后的默认状态（模拟模式、上拉／下拉、JTAG 引脚）。

5. 时序和电气方面的陷阱

• 外部总线模式的建立／保持时间（FSMC、SDIO）
• ADC 采样时间与信号源阻抗（数据手册图表）
• GPIO 最大翻转速率与负载电容
• 仅在复位时采样的启动模式引脚

6. 勘误处理流程

Symptom matches errata?
├── Yes → apply documented workaround in driver
└── No  → verify silicon revision (DBGMCU_IDCODE / UID)

7. Agent 使用

/datasheet-and-refmanual-reading Find STM32F4 USART baud rate formula and required clock source

常见问题

症状	原因	修复方法
寄存器行为异常	查阅了错误芯片修订版的勘误	首先检查 ERRATA 表
AF 不工作	混淆了数据手册中的引脚名称和 RM 中的 AF 表	交叉核对两张表
DMA 间歇性异常	漏看了有关缓冲区对齐的脚注	查看 RM 的 DMA 章节备注
时钟不匹配	使用了数据手册首页横幅上的最大频率，而不是电压范围表中的值	使用工作条件表

相关技能

• skills/baremetal/peripherals-from-datasheet — 驱动实现工作流
• skills/baremetal/mmio-and-bit-manipulation — 安全访问寄存器
• skills/baremetal/gpio-baremetal — 根据 RM 表配置引脚复用
• skills/kernel-dev/device-tree — 设备树绑定反映 Linux 对 RM 功能的支持