课程导入：学习目标、适用人群、课程结构、调试工具链全景概览
板级调试是嵌入式系统开发中最具挑战性的环节之一。当一块新设计的PCB（印制电路板）完成焊接、上电之后，工程师面对的不再是原理图上的理想信号，而是真实的物理世界——可能存在短路、虚焊、时序冲突、总线死锁、固件异常等各类问题。JTAG与串口日志分析，正是工程师手中最基础也最强大的两件调试利器。JTAG提供芯片内部的硬件级访问通道，能够实现断点、单步、寄存器读写和Flash编程；串口日志则提供软件运行时的行为轨迹，帮助定位逻辑错误和状态机跳转异常。本课程将系统讲解这两条调试链路的工作原理、工具选型、操作流程与实战技巧，帮助学员建立一套完整的板级调试方法论。
上图展示了本课程的核心调试框架。JTAG链路与串口日志链路并非相互替代，而是互补关系。JTAG能够在CPU挂死、系统无日志输出时，从外部强制接管芯片，读取寄存器、内存和PC指针，判断程序卡在何处；串口日志则能在系统运行时持续输出关键信息，帮助工程师理解程序的执行流程和数据变化。在实际调试中，往往需要两条链路交替使用：先用串口日志缩小问题范围，再用JTAG深入检查具体寄存器状态；或者先用JTAG设置硬件断点，再观察串口输出的上下文信息。这种双链路协同的调试模式，是解决复杂板级问题的关键能力。
1.1 学习目标与能力模型
本课程面向已经具备一定嵌入式基础的工程师，目标是帮助学员建立系统化的板级调试能力。完成本课程学习后，学员应当能够独立完成以下任务：第一，正确搭建JTAG调试环境，包括调试器选型、目标板连接、驱动安装和工具链配置；第二，熟练使用GDB命令进行断点管理、变量监视、堆栈回溯和内存查看；第三，掌握串口日志的规范化输出方法，包括日志分级、格式定义、时间戳同步和环形缓冲区管理；第四，能够结合JTAG和串口日志，对典型的板级故障（如启动失败、系统复位、外设无响应、内存访问异常）进行系统性排查。
| 能力维度 | 初级要求 | 中级要求 | 高级要求 |
|---|---|---|---|
| JTAG操作 | 能连接调试器并读取寄存器 | 能设置断点、单步跟踪、查看调用栈 | 能编写调试脚本、批量读写内存、分析时序 |
| 串口日志 | 能配置串口终端并查看输出 | 能设计日志分级和格式化输出 | 能实现日志压缩存储、远程日志和自动分析 |
| 故障定位 | 能判断是硬件还是软件问题 | 能通过日志定位到具体模块 | 能结合双链路定位到具体代码行或信号 |
| 工具链集成 | 会使用单一调试工具 | 能配置OpenOCD+GDB+串口联合环境 | 能搭建自动化调试和日志分析流水线 |
课程的能力培养遵循"理论→演示→实操→复盘"的递进路径。每个章节都会先讲解核心原理，再通过实际案例演示操作过程，最后安排动手练习和常见问题复盘。学员需要准备一块带有JTAG接口和串口输出的开发板（如STM32F4系列、i.MX6ULL或RISC-V开发板），以及对应的调试器（J-Link、ST-Link或DAP-Link）。课程中涉及的命令和脚本均基于开源工具，学员可以在自己的环境中复现。
1.2 适用人群与前置知识
本课程适合以下三类人群：第一类是嵌入式软件工程师，他们需要深入理解硬件行为，解决驱动开发中的疑难问题；第二类是硬件工程师，他们需要验证PCB设计的正确性，定位信号完整性问题或焊接缺陷；第三类是系统集成工程师，他们需要快速定位多模块协作中的接口问题。无论哪类学员，都需要具备以下前置知识：了解基本的数字电路知识（如电平、时序、上拉/下拉电阻）；熟悉C语言编程和指针操作；了解至少一种MCU或SoC的启动流程；能够使用Linux命令行或Windows终端执行基本命令。
1.3 课程结构与学习路径
本课程共30章，分为五个模块。第一模块（第1-5章）为工具链基础，涵盖调试环境搭建、JTAG原理、串口通信基础、日志规范设计和常用命令速查。第二模块（第6-12章）聚焦JTAG深度应用，包括断点机制、内存访问、Flash编程、多核调试和性能分析。第三模块（第13-19章）深入串口日志分析，涉及日志格式设计、时间戳同步、DMA传输、日志存储和远程日志。第四模块（第20-25章）讲解综合调试策略，包括启动流程调试、中断异常排查、低功耗调试和硬件故障定位。第五模块（第26-30章）为实战项目与自动化，通过三个完整案例（网络设备启动失败、电机驱动异常、传感器数据漂移）串联所有知识点，并介绍基于Python的自动化调试框架。
每个章节都遵循统一的结构：首先明确本章学习目标和关键概念，然后通过原理讲解建立理论基础，接着用实际案例演示操作流程，最后给出常见误区、练习题目和扩展阅读。学员可以根据自身基础选择学习路径：基础薄弱的学员建议按顺序学习；有经验的工程师可以跳过基础章节，直接进入综合调试和自动化部分。课程配套的代码仓库包含所有示例工程、调试脚本和日志分析工具，学员可以随时参考。
1.4 调试工具链全景概览
一个完整的板级调试工具链，远不止JTAG调试器和串口终端这么简单。从硬件层面看，工具链包括调试器（J-Link、ST-Link、OpenOCD支持的多种调试器）、逻辑分析仪、示波器、万用表和电源分析仪。从软件层面看，工具链包括IDE（VS Code、Eclipse、IAR）、命令行调试工具（GDB、OpenOCD）、串口终端（minicom、PuTTY、screen）、日志分析脚本（Python、awk、grep）以及版本管理工具（Git）。在实际项目中，这些工具需要协同工作，形成一个完整的调试闭环。
工具链的选择需要根据项目特点进行权衡。对于资源受限的MCU项目，可能只需要一个ST-Link和串口终端即可；对于复杂的SoC系统（如Linux嵌入式系统），则需要OpenOCD配合GDB进行内核调试，同时使用串口或网络日志分析系统运行状态。本课程将以开源工具链为主（OpenOCD + GDB + minicom + Python），因为这些工具免费、跨平台、可脚本化，且社区活跃。对于商业工具（如IAR、Keil、J-Link的专用软件），课程也会介绍其特点和使用场景，但不会作为教学重点。
1.5 常见误区与学习建议
在多年的调试教学和工程实践中，我们发现学员经常陷入几个误区。第一个误区是"重工具轻原理"——认为只要会用J-Link和GDB就能解决所有问题，却不理解JTAG的TAP状态机、边界扫描原理和调试接口时序。一旦遇到非标准调试场景（如多核调试、低功耗调试、JTAG链串联），就无从下手。第二个误区是"日志输出无设计"——很多工程师随意在代码中添加printf，日志格式混乱、无级别区分、无时间戳，导致问题出现时无法从海量日志中提取有效信息。第三个误区是"单链路依赖"——只会用串口日志，当系统完全挂死、日志停止输出时，就束手无策；或者只会用JTAG，却忽略了日志中蕴含的丰富上下文信息。
针对这些误区，本课程提出三点学习建议。第一，动手实践是唯一有效的学习方式。每学完一个章节，都要在真实硬件上复现案例，并尝试修改参数观察结果变化。第二，建立调试日志的习惯。从第一天开始，就为自己的代码设计规范的日志输出，包括模块名、级别、时间戳和关键参数。第三，学会"双链路思维"。在遇到问题时，先问自己：串口日志能告诉我什么？JTAG能告诉我什么？两者结合能得出什么结论？这种思维方式需要刻意练习，但一旦形成，将极大提升调试效率。