单片机与物联网 / 系统课时
驱动层与应用层分离
驱动层与应用层分离
当业务代码直接调用 GPIO、UART 或 I2C 的 HAL 函数时,硬件变更会迅速扩散到整个项目。本课把硬件访问、设备驱动和业务决策拆开,并用一个可替换的 LED 接口演示如何降低耦合、支持桌面测试和后续移植。
学习目标
- 能够说明硬件访问层、设备驱动层、应用层和用户接口层的职责边界。
- 能够通过函数指针接口让应用层不依赖具体 HAL API。
- 能够使用测试替身验证业务逻辑,而不连接真实开发板。
分层要解决的耦合问题
未分层的程序常把 HAL_GPIO_WritePin()、延时、告警规则和界面输出写在同一个函数中。这样做虽然起步快,但更换引脚、迁移 MCU、增加单元测试或复用业务逻辑时,都要修改同一批文件。分层的目标不是增加目录数量,而是控制依赖方向:上层只表达“要做什么”,下层负责“如何操作硬件”。

职责边界与依赖方向
| 层次 | 主要职责 | 不应承担的职责 |
|---|---|---|
| 用户接口层 | 按键、显示、通信命令与参数输入 | 直接操作寄存器或决定底层时序 |
| 应用层 | 告警策略、模式切换、业务状态与流程 | 绑定具体引脚、总线实例或 HAL 句柄 |
| 设备驱动层 | 把 LED、传感器、电机等抽象为稳定操作 | 编写产品业务规则 |
| 硬件访问层 | GPIO、定时器、DMA、总线和中断封装 | 决定设备在业务中的用途 |
稳定的依赖方向应从上向下。应用层依赖 LedPort 之类的抽象接口,真实 GPIO 驱动和测试替身都实现该接口。这样,修改板级引脚只影响驱动实现;修改告警策略只影响应用层;测试时则可把真实驱动替换为内存中的假对象。
接口实现与可运行示例
下面的 C11 程序模拟一个分层 LED 模块。应用函数 warning_set() 只依赖 LedPort,不知道 LED 是由 GPIO、扩展芯片还是测试替身驱动。真实项目可把 gpio_led_set() 内部替换为对应 MCU 的 HAL 调用,而应用层代码保持不变。
将代码保存为 layered_led.c。
#include <stdbool.h>
#include <stdio.h>
typedef struct {
void *context;
void (*set)(void *context, bool on);
bool (*get)(void *context);
} LedPort;
typedef struct {
bool pin_level;
} GpioLed;
static void gpio_led_set(void *context, bool on) {
GpioLed *led = context;
led->pin_level = on;
printf("GPIO LED: %s\n", on ? "ON" : "OFF");
}
static bool gpio_led_get(void *context) {
const GpioLed *led = context;
return led->pin_level;
}
typedef struct {
int set_calls;
bool last_value;
} FakeLed;
static void fake_led_set(void *context, bool on) {
FakeLed *led = context;
led->set_calls++;
led->last_value = on;
}
static bool fake_led_get(void *context) {
const FakeLed *led = context;
return led->last_value;
}
static bool warning_set(LedPort *port, bool active) {
port->set(port->context, active);
return port->get(port->context) == active;
}
int main(void) {
GpioLed hardware = {false};
LedPort production = {&hardware, gpio_led_set, gpio_led_get};
printf("Application verification: %s\n",
warning_set(&production, true) ? "PASS" : "FAIL");
printf("Application verification: %s\n",
warning_set(&production, false) ? "PASS" : "FAIL");
FakeLed fake = {0, false};
LedPort test_port = {&fake, fake_led_set, fake_led_get};
warning_set(&test_port, true);
warning_set(&test_port, false);
printf("Fake calls: %d, last value: %s\n",
fake.set_calls, fake.last_value ? "ON" : "OFF");
return 0;
}使用 GCC 编译并运行:
gcc -std=c11 -Wall -Wextra -pedantic layered_led.c -o layered_led
./layered_led预期输出:
GPIO LED: ON
Application verification: PASS
GPIO LED: OFF
Application verification: PASS
Fake calls: 2, last value: OFF输出表明同一应用逻辑既能控制模拟 GPIO,也能在测试环境中记录调用次数。真实固件中通常把接口声明放入公共头文件,把 HAL 相关实现限制在驱动源文件内,并让应用层只包含抽象接口头文件。
设计检查与常见错误
首先检查依赖是否反向。驱动层不应调用应用层的告警策略,否则底层模块会知道过多业务细节。其次避免把所有接口都设计成全局单例;通过 context 传入实例,可以同时管理多个 LED、传感器或总线设备。最后,接口应围绕设备能力设计,例如“设置亮度”比“写某个寄存器位”更稳定。
常见错误是只把文件移动到 drivers 目录,却仍让应用层直接访问 GPIOA、huart1 或 HAL_Delay()。这种做法只有目录分层,没有依赖分层。修复方法是把硬件标识和 HAL 调用封装进驱动实现,再通过窄接口暴露必要能力。验证时可搜索应用目录,确认其中不再出现具体外设句柄和寄存器名称。
练习与验收
- 将示例中的
LedPort扩展为支持亮度设置的set_percent()接口。初始条件是亮度范围为 0~100;实现时必须在驱动层完成范围限制;验收标准是应用层传入 120 时,测试替身记录的最终值为 100。 - 为蜂鸣器设计一个
BuzzerPort,应用层只表达“开启告警”和“关闭告警”。测试替身需要统计开启次数;验收标准是不连接硬件也能确认连续两次告警流程只触发一次开启操作。
本课总结
- 分层的核心是稳定职责和单向依赖,而不是单纯拆分目录。
- 应用层依赖抽象接口后,硬件实现、板级配置和测试替身可以独立替换。
- 窄接口、实例上下文和依赖检查能显著降低移植与测试成本。
下一课预告
下一课将学习“非阻塞状态机”,把分层后的业务流程改写为可持续推进的状态、事件和时间条件,使多个功能能够在同一个主循环中协作运行。