1. Zephyr调试概述：调试工具链概览、调试流程、常见调试场景
调试嵌入式系统，说白了就是跟硬件和实时性打交道。Zephyr作为一个高度可配置的RTOS，它的调试方式跟Linux完全不同，也跟裸机开发不一样。我个人习惯把Zephyr的调试分成三个层次：应用层调试、内核层调试、硬件层调试。每一层用的工具和方法都不一样。
先给你看一张整体框架图，这样你心里有个谱。
1.1 调试工具链概览
Zephyr的调试工具链，说白了就是三件套：GDB + 调试器硬件 + Zephyr自身的调试基础设施。我刚开始用Zephyr的时候，最大的困惑就是不知道哪个工具该用在哪个场景。后来踩了不少坑，才理清楚。
核心调试工具对照表
| 工具/组件 | 适用场景 | 依赖条件 | 我的评价 |
|---|---|---|---|
| GDB + OpenOCD | 断点调试、单步执行、变量查看 | JTAG/SWD调试器 | 最通用，但速度慢 |
| Segger J-Link + Ozone | 实时调试、RTT输出、时序分析 | J-Link调试器 | 我项目中最常用的组合 |
| Zephyr Shell | 运行时诊断、线程信息、内存查看 | UART或USB串口 | 不需要调试器，非常方便 |
| Logging子系统 | 模块化日志输出、等级控制 | 串口或RTT | 调试信息输出的主力 |
| Tracing子系统 | 调度行为追踪、性能分析 | CTF或RTT后端 | 性能调优必备 |
| Perf计数器 | CPU周期统计、中断延迟测量 | 硬件支持 | 精准但配置复杂 |
嗯，这里要注意：Zephyr的调试配置全部通过Kconfig控制。你需要在prj.conf里打开对应的开关。比如你想用Shell调试，就得加上CONFIG_SHELL=y。我曾经有一次忘了开这个，折腾了半天才发现Shell根本没编译进去。
1.2 调试流程
调试流程其实有套路。我总结了一个四步法，你在项目里可以直接套用。
- 确认调试环境：检查调试器连接、驱动安装、Zephyr编译选项是否正确。这一步卡住的人最多。
- 选择调试入口：根据问题类型选择工具。逻辑问题用GDB，运行时问题用Shell，性能问题用Tracing。
- 复现与定位：设置断点或日志点，缩小问题范围。我习惯先用二分法定位到模块，再深入细节。
- 修复与验证：修改代码后，确认问题不再出现。注意回归测试。
我的小技巧：调试前先在prj.conf里打开CONFIG_DEBUG=y和CONFIG_ASSERT=y。这两个开关能帮你提前发现很多隐藏问题。我项目里有个死锁bug，就是靠ASSERT抓到的。
1.3 常见调试场景
实际项目中，你遇到的调试场景无非这么几类。我按频率排了个序。
场景一：线程卡死或崩溃
这是最常见的。线程跑着跑着就不动了，或者直接HardFault。原因通常是栈溢出、优先级反转、死锁。
- 排查方法：用Shell的
kernel threads命令查看线程状态，或者用GDB查看栈回溯。 - 避坑指南：我曾经遇到过线程栈设小了，但系统没报错，只是偶尔死机。后来开了
CONFIG_THREAD_STACK_INFO=y才看到栈使用率已经99%。
场景二：中断响应延迟
中断来了，但处理不及时。这通常是因为关中断时间太长，或者中断优先级配置不对。
- 排查方法：用Perf计数器测量中断延迟，或者用Tracing看中断触发到处理的时间差。
- 我的经验：有一次客户反馈按键响应慢，我查了半天发现是某个驱动里关了中断做SPI传输，关了200微秒。改成DMA传输后问题解决。
场景三：内存泄漏
堆内存越用越少，最终分配失败。Zephyr的内存管理比较灵活，但也容易出问题。
- 排查方法：用Shell的
heap命令查看内存使用情况，或者用CONFIG_HEAP_MEM_POOL_SIZE统计。 - 注意：Zephyr的
k_malloc和k_free必须配对使用。我见过有人用k_malloc分配，却用free释放，结果内存池乱掉了。
场景四：调度异常
线程不按预期调度，或者优先级反转导致低优先级线程饿死。
- 排查方法：用Tracing子系统记录调度事件，分析线程切换的时间点。
- 避坑指南：我曾经在项目里用了
K_FOREVER等待信号量，结果信号量一直没给，线程就永远挂起了。后来加了超时机制才解决。
重要提醒：调试时不要只依赖一种工具。比如GDB断点调试会暂停整个系统，可能掩盖时序问题。我建议先用Logging和Shell做初步诊断，再用GDB做精确定位。
1.4 调试配置速查
下面这个表是我自己整理的常用调试配置，你直接复制到prj.conf里就能用。
| 配置项 | 作用 | 推荐值 |
|---|---|---|
| CONFIG_DEBUG | 开启调试功能总开关 | y |
| CONFIG_ASSERT | 启用断言检查 | y |
| CONFIG_SHELL | 启用Shell命令行 | y |
| CONFIG_LOG | 启用日志子系统 | y |
| CONFIG_TRACING | 启用追踪子系统 | y（性能分析时） |
| CONFIG_THREAD_STACK_INFO | 显示线程栈使用率 | y |
| CONFIG_HEAP_MEM_POOL_SIZE | 堆内存池大小 | 根据需求设置 |