模块化设计原则：高内聚低耦合、模块划分方法、接口设计规范
好，咱们今天聊聊模块化设计。说实话，这是嵌入式开发里最基础也最容易被忽视的东西。我见过太多项目，一开始图省事，把所有代码塞到一个文件里，结果后期改一个bug能牵出一串问题。嗯，我自己也踩过这个坑。
一、高内聚与低耦合：两个核心指标
先说说这两个词。高内聚，说白了就是一个模块内部的东西要紧密相关。比如你写一个I2C驱动，那跟I2C协议相关的初始化、读写、时序控制，都应该放在这个模块里。别把I2C的代码和UART的代码混在一起，那叫“乱炖”。
低耦合呢，就是模块之间的依赖要尽量少。我举个例子，你写了一个温度传感器驱动，它不应该直接去操作GPIO引脚。应该通过一个抽象的硬件接口层来访问。这样哪天换了MCU，你只需要改底层接口，上层代码纹丝不动。
核心原则：
- 高内聚：一个模块只做一件事，并且做好它
- 低耦合：模块之间通过接口通信，不直接访问内部数据
我在项目中遇到过这样一个情况：有个同事把LED控制、按键扫描、串口打印全写在一个.c文件里。结果想复用LED控制代码到另一个项目，得把按键和串口的代码一起搬过去。你说这多尴尬？
二、模块划分方法：怎么切才合理？
模块划分没有标准答案，但我个人习惯遵循几个原则：
- 按功能划分：比如传感器模块、通信模块、存储模块、显示模块。这是最直观的方式。
- 按硬件抽象层划分：底层驱动、中间层、应用层。这样换硬件时只改底层。
- 按业务逻辑划分：比如状态机模块、数据处理模块、告警模块。
你想想看，一个典型的嵌入式项目，模块划分大概长这样：
| 层级 | 模块 | 职责 |
|---|---|---|
| 应用层 | 业务逻辑模块 | 处理具体业务，比如温度报警、数据上报 |
| 中间层 | 协议解析模块 | 解析Modbus、CAN等协议，不关心硬件 |
| 驱动层 | 硬件抽象层 | 封装GPIO、SPI、I2C等操作 |
| 底层 | MCU外设驱动 | 直接操作寄存器 |
这里有个避坑指南：千万不要把模块切得太细。我曾经见过一个项目，一个功能拆了七八个文件，每个文件就几十行代码。结果找函数定义得翻半天，反而降低了开发效率。模块的大小，我个人觉得一个.c文件控制在200-500行比较合适。
三、接口设计规范：让别人用得舒服
接口设计，说白了就是“你给别人用，怎么让人家用得顺手”。我总结了几条铁律：
接口设计三要素：
- 命名清晰：一看函数名就知道它干嘛的。比如
i2c_write_byte()，而不是i2c_wb() - 参数简洁：参数不要超过4个。超过4个建议用结构体传参
- 返回值明确：统一返回错误码，0表示成功，负数表示错误
来看一个实际例子。假设你要设计一个温度传感器驱动模块：
/* 好的接口设计 */
typedef struct {
uint8_t addr; /* I2C地址 */
uint32_t freq; /* 采样频率 */
uint8_t resolution; /* 分辨率 */
} temp_sensor_cfg_t;
int temp_sensor_init(temp_sensor_cfg_t *cfg);
int temp_sensor_read(float *temperature);
int temp_sensor_deinit(void);
/* 不好的接口设计 */
void init_temp(uint8_t a, uint32_t f, uint8_t r);
void read_temp(void); /* 返回值去哪了？ */为什么说第一个好？因为参数用结构体封装了，以后要加配置项，不需要改函数签名。而且每个函数都有明确的返回值，调用者可以判断是否成功。第二个函数 read_temp() 连返回值都没有，温度数据怎么拿？靠全局变量？那耦合度就上去了。
注意：接口设计时，尽量避免暴露内部数据结构。比如你模块内部用了一个链表，但对外接口应该只提供“插入、删除、查找”这样的操作，而不是直接把链表头指针暴露出去。否则别人一改你的链表，整个模块就崩了。
四、实际项目中的模块化案例
我记得之前做一个智能家居项目，需要控制灯光、窗帘、空调。一开始大家各写各的，结果发现灯光模块里调用了窗帘模块的变量，窗帘模块又依赖空调模块的初始化顺序。改一个模块，其他模块都得跟着改。
后来我们重新划分模块，每个设备独立成一个模块，通过一个统一的消息总线通信。灯光模块只管发“开灯”命令，不关心谁去执行。窗帘模块也只管自己的电机控制。这样每个模块都可以单独测试，单独复用。
嗯，这里要强调一点：模块化不是一蹴而就的。项目初期可以适当放宽，但随着代码量增加，一定要及时重构。我见过太多项目，前期图快不拆分，后期代码膨胀到几万行，想拆都拆不动了。
五、总结一下
模块化设计，说白了就是“分而治之”。把大问题拆成小问题，每个小问题独立解决。高内聚保证模块内部不乱，低耦合保证模块之间不打架。接口设计则是模块之间的“契约”，写清楚、写规范，别人用起来才舒服。
最后送大家一句话：写代码的时候，多想想三个月后的自己能不能看懂。如果连自己都看不懂，那别人更不可能用得好。好了，这一章就到这里，下一章咱们聊聊头文件的设计规范。