1. 课程导入
在嵌入式系统开发中，RISC-V 以其开放、模块化的指令集架构迅速崛起，但“裸机”环境意味着没有操作系统提供的进程管理、内存保护、日志系统与异常兜底机制。一旦程序跑飞、中断不响应、外设寄存器读写异常，开发者往往只能面对一块“沉默”的电路板。本课程的目标，正是帮助你把这种沉默转化为可观测、可推理、可定位的工程能力。
一、学习目标：从“能跑”到“能查”
本课程不满足于让你点亮一颗 LED 或跑通一个串口打印，而是聚焦于故障发生后的定位能力。具体目标包括：
- 理解 RISC-V 裸机启动流程中 PC、SP、GP、TP 等关键寄存器的初始化顺序与常见错误。
- 掌握异常与中断的入口机制，能通过 mcause、mepc、mtval 等 CSR 判断故障类型与返回地址。
- 能够使用 JTAG、OpenOCD、GDB 构建可复现的调试链路，并设置硬件断点与观察点。
- 具备从“现象”到“假设”再到“验证”的系统化排障思维，而非盲目改代码。
- 能独立完成启动失败、HardFault、内存越界、外设无响应等典型故障的定位报告。
核心转变：从“写代码的人”转变为“能证明代码为什么错的人”。裸机调试的本质，是在没有操作系统保护的情况下，用硬件提供的有限观测手段，重建程序执行的历史现场。
二、核心概念：裸机调试的四个支点
RISC-V 裸机调试与故障定位建立在四个核心概念之上，它们共同构成后续所有章节的知识底座。
| 核心概念 | 关键对象 | 典型问题 | 观测手段 |
|---|---|---|---|
| 启动与复位 | 复位向量、启动代码、链接脚本 | PC 跑飞、栈未初始化、数据段未搬移 | 反汇编、JTAG 单步、串口早期打印 |
| 异常与中断 | mtvec、mcause、mepc、mstatus | 中断不响应、异常循环、返回地址错误 | CSR 读取、异常入口断点、GDB 回溯 |
| 内存与总线 | 地址映射、MMIO、PMP、Cache | 读写无响应、数据不一致、越界访问 | 总线错误、watchpoint、内存窗口对比 |
| 调试链路 | JTAG、OpenOCD、GDB、串口 | 连接失败、断点不生效、复位后失联 | OpenOCD 日志、GDB monitor 命令 |
其中，异常与中断是裸机故障定位的核心枢纽。RISC-V 通过 CSR 寄存器把故障原因、故障地址和故障值暴露给软件，这相当于硬件在“出事”时留下了一张现场记录单。能否读懂这张记录单，直接决定了定位效率。
三、整体知识框架：三层观测体系
本课程将 RISC-V 裸机调试能力划分为三层观测体系，由外到内、由粗到细。
第一层：链路层。解决“能不能连上”的问题。包括 JTAG 引脚定义、OpenOCD 配置文件、GDB 连接命令、复位策略选择。这一层不通，后续所有调试手段都无从谈起。
第二层：控制层。解决“能不能停下来”的问题。包括硬件断点、软件断点、观察点、单步执行、寄存器与内存查看。这一层让你能够在任意时刻冻结 CPU，检查现场。
第三层：语义层。解决“停下来之后看什么”的问题。包括异常向量表解析、栈回溯、调用约定、链接脚本与反汇编对照。这一层决定你能否从寄存器值还原出程序意图。
学习建议：三层体系不是严格串行的。实际排障中，你往往需要在链路层和控制层之间反复切换，但语义层的分析能力才是区分初级与高级调试工程师的分水岭。
四、实战路线图：从环境搭建到故障复盘
为了让学习路径清晰可执行，本课程设计了一条由浅入深的实战路线。下图展示了从环境准备到故障定位的完整信号链与知识节点关系。
路线图的核心逻辑是：先建立可观测性，再建立可控制性，最后建立可解释性。没有 JTAG 连接，就无法单步；没有单步，就无法确认异常入口；没有异常入口的 CSR 现场，就无法回溯到出错的指令。这条链路环环相扣，任何一环断裂都会让定位退化为猜测。
五、典型误区与复盘思维
初学者在裸机调试中常陷入以下误区：
- 只改代码，不看现场。看到程序跑飞就反复调整逻辑，却不先读取 mcause 和 mepc，导致修改缺乏依据。
- 忽视链接脚本。把变量定义在错误的段，或栈空间与数据段重叠，引发难以复现的内存踩踏。
- 过度依赖打印。在中断或异常上下文中调用串口打印，可能引入重入问题或阻塞，反而掩盖真实故障。
- 断点设置不当。在 Flash 中设置软件断点导致写入失败，却误判为“断点不生效”。
排障铁律：先确认“故障是否可复现”，再确认“现场是否可观测”，最后才进入“根因分析”。跳过前两步直接改代码，等于在没有地图的情况下修路。
复盘时建议采用固定模板：现象描述、复现步骤、观测数据、假设列表、验证结果、根因结论、修复方案、回归验证。这套模板不仅适用于本课程，也是嵌入式团队协作中减少沟通成本的有效工具。
六、从本章开始：建立你的调试工具箱
在进入后续章节之前，请先确认你手头具备以下基础条件：
# 典型 RISC-V 裸机调试工具链
riscv64-unknown-elf-gcc # 交叉编译
riscv64-unknown-elf-gdb # 调试器
openocd # 调试探针服务
# 硬件：JTAG 调试器 + RISC-V 开发板 + USB 串口
# 软件：终端工具（minicom / picocom / screen）当你能够用 OpenOCD 连上目标板、用 GDB halt 住 CPU、并读出第一个 CSR 值时，本课程真正的训练就开始了。后续章节将沿着“启动—异常—内存—外设—复盘”的主线逐步展开，每一节都会围绕真实故障场景，训练你从现象到根因的完整推理能力。
记住：裸机调试不是玄学，而是一套可以被学习、被练习、被标准化的工程方法。你需要的不是运气，而是正确的观测点和严谨的推理链。