hemoparrot的专栏

通过本模板项目，你可以快速搭建一个可复用、可维护、可扩展的 STM32 项目框架，并支持测试、平台适配、状态管理与模块解耦。📌 本系列文档全部完结，感谢阅读和支持！如你希望我将模板完整发布到 GitHub 并维护开源仓库，请留言或私信反馈。

本文是《STM32 模块化开发实战指南》第 7 篇，聚焦于模块可移植性设计。我们将探讨如何让同一个模块在裸机、RTOS、甚至 PC 模拟环境下无缝运行，并结合 Makefile 条件编译、平台抽象接口、Mock 替换策略等方法，提升项目的重用性和适配能力。

本文是《STM32 模块化开发实战指南》第 6 篇，专注于“裸机项目的单元测试设计”。我们将从为什么 STM32 项目也需要测试出发，设计一个简洁的 tests/ 结构和测试驱动模型，并结合前文模块（如 RingBuffer、UART）示例演示如何验证模块正确性，提升项目质量。

本文是《STM32 模块化开发实战指南》第 5 篇，聚焦于 STM32 裸机开发中最核心也最容易被忽视的部分——中断服务机制。我们将介绍如何正确、高效地设计中断处理函数（ISR），实现数据与事件从中断上下文传递到主逻辑的通道，并构建一个清晰、可维护、非阻塞的事件通知机制。

endif通过本篇内容，你学会了如何将 BLE 模块的运行逻辑抽象为有限状态机管理，并结合事件队列实现状态驱动。它不仅让逻辑更清晰、代码更可靠，也为扩展连接管理、功耗控制、主从共存等复杂功能打下良好基础。📌 下一篇我们将聚焦于“中断驱动与事件分发机制”，如何搭建可靠的 ISR → 应用逻辑通知体系，实现非阻塞、解耦的高效事件流。

endifRingBuffer 是 STM32 项目中最基础也最通用的一个功能模块。它的好坏会直接影响串口、BLE、通信协议、甚至主任务调度的性能。在后续章节中，我们将继续围绕模块架构构建协议处理、AT 系统、状态机框架等更高级内容。

本文是《STM32 模块化开发实战指南》系列的导读篇，旨在介绍整个系列的写作目的、适用读者、技术路径和每一篇的主题规划。适合从事 STM32、裸机或 RTOS 嵌入式开发的个人开发者、初创工程师或企业项目团队。

职责清晰：每个模块只做一件事，出错范围可控；接口明确：函数暴露即接口，模块之间可独立测试与替换；复用性强：像 UART、RingBuffer 等可跨多个项目使用；可维护性好：逻辑解耦，不影响其他模块，便于多人协作；可扩展性强：添加新功能只需扩展app/层或层即可。✅ 如果你写的main.c已超过 500 行，就该尝试用本文方法对项目做一次架构重构。

/ 非阻塞读// 中断入口#endif：初始化串口：阻塞发送一个字节：从环形缓冲区中读取一个字节，若无数据返回 -1：在中断服务函数中调用，用于处理接收逻辑通过本篇内容，你学会了如何从零设计一个结构清晰、接口友好、非阻塞收发、可中断驱动的 UART 驱动模块，作为后续所有通信模块（BLE、AT、协议栈等）的基础。下一篇我们将聚焦 RingBuffer 模块，深入讲解其结构设计、边界处理和测试策略。完整源码结构和每篇文章链接将在专栏持续更新。