本技能旨在为智能体提供一套可重复的方法论，用于依据 MCU 参考手册编写外设驱动。其核心用途包括：在没有厂商 HAL 的情况下启动驱动、在 MCU 系列之间移植外设、依据参考手册验证 HAL 行为，以及调试那些「按示例应该能工作」的外设。
工作流程包含以下环节：
一、参考手册导航。典型 RM 结构包括内存映射（外设基地址）、外设章节（UART、SPI、GPIO 等，内含功能描述、寄存器映射表、寄存器位定义、时序与电气说明）以及电气特性（时钟限制、建立/保持时间）。技能强调在复制寄存器写入之前，应先从编程模型章节入手。
二、提取寄存器映射。以 USART 为例，从 RM 中提取基地址 0x40004400，并用结构体定义寄存器，如 SR（0x00 状态）、DR（0x04 数据）、BRR（0x08 波特率）、CR1（0x0C 控制）等，并定义宏指向该地址。需要验证偏移列与结构体布局一致（保留字需填充）。
三、初始化序列检查清单。外设启动顺序为：1. 使能总线时钟（RCC/APB/AHB 寄存器）；2. 复位外设（如 RM 要求）；3. 配置引脚（GPIO 复用功能）；4. 配置外设寄存器（模式、波特率等）；5. 使能外设（UE、TE、RE 位）；6. 使能 NVIC 中断（如采用中断驱动）；7. 首次事务前验证状态标志。技能以「先使能 UART 后开时钟」为例说明错误：此时 USART 时钟仍关闭，操作无效。
四、位定义规范。依据 RM 定义 CR1 中的 M[1:0]、PCE、PS、TE、RE、UE 等位，使用位移宏表示，并在注释中记录 RM 章节号以便审计。
五、时序与忙等待。依据 RM 轮询 BUSY 标志直至复位完成，例如等待 PLL 就绪；需遵守电气特性章节中的启动时间（振荡器稳定、PLL 锁定）。
六、驱动结构优劣对比。好的驱动分层且引用 RM，例如 usart2_init 中依次使能时钟、配置引脚、设置波特率、配置控制寄存器；坏的驱动使用魔法数字且未使能时钟，例如直接向 0x4000440C 写入 0x2000，无法辨认外设与位含义。
七、智能体使用示例。可通过 /peripherals-from-datasheet 指令请求引导完成 STM32 RM 中的 USART 初始化，或询问 SPI 时序相关的参考手册章节。
常见问题包括：外设无响应（时钟未使能，需先设置 RCC/APB 使能位）；波特率错误（PCLK 假设错误，需使用实际时钟树重新计算）；GPIO 复用错误（MUX 值取自错误表格，需交叉核对引脚定义与 AF 表）；中断卡住（状态标志清除顺序错误，需参阅 RM 的「清除标志」子章节）；数据静默损坏（字节序或位宽不匹配，需匹配寄存器访问大小）。
相关技能涵盖裸机文档阅读、MMIO 与位操作、GPIO 裸机、嵌入式链接脚本等，但本技能将其保持为独立技能。