Zephyr 常见问题与排查思路

常见问题与排查思路

Q：编译通过但运行时硬件没反应。最常见原因是设备树节点 status 仍为 disabled，或 overlay 文件路径不对没被 CMake 收集到。先确认 build/zephyr/zephyr.dts 里目标节点已经展开为期望的配置，再确认对应驱动开关已在 prj.conf 中打开。

Q：固件超出 Flash 或 RAM。先用 west build -t rom_report 和 ram_report 找出占用大头，通常是日志、shell、协议栈和浮点格式化。可依次关闭日志、去掉 shell、改用 CONFIG_MINIMAL_LIBC、开启 CONFIG_SIZE_OPTIMIZATIONS，并把不用的外设驱动全部关掉。日志与 shell 的关掉顺序对体积影响最大。

Q：如何把应用复用到第二块板子。把与硬件相关的部分全部收进 overlay 与 Kconfig 片段，应用代码只通过 DT_ALIAS、DEVICE_DT_GET 这类接口取设备，不要写死引脚号与外设实例名。这样换板子通常只需要新增一个 overlay 文件与一个 prj_<board>.conf。

Q：怎么选择 Zephyr 版本。量产项目建议锁定官方的长期支持版本，并在工程里用 west.yml 固定 zephyr 与各 module 的 revision，避免 CI 上因为上游变动出现不可复现的构建失败。具体哪些版本属于 LTS、各版本的维护周期，以官方文档为准。

Q：调试手段有哪些。除了 shell 与日志，Zephyr 还支持 west build -t debug 启动 GDB 会话、线程分析器观察各线程栈使用、以及 trace 类子系统做运行期行为记录。排查偶发问题时，先把断言与栈哨兵打开，再逐步收窄范围，比直接上调试器更快。

把 Kconfig、设备树、west 这三件事吃透之后，Zephyr 的学习曲线会明显变缓：新硬件接进来就是写 overlay 加开配置，新功能就是开一个子系统加写业务逻辑。这也是它值得在嵌入式与端侧项目里认真评估的原因。