📚 课程目录第3章软件分层设计思想

3. 软件分层设计思想

在单片机低功耗与内存管理移植适配工程中，软件分层设计不是“把代码分文件夹”这么简单，而是把硬件差异、时序细节、资源策略、业务逻辑解耦到不同抽象层级，使低功耗策略和内存策略能够被独立替换、验证与复用。分层做得好，换一颗MCU或换一套RTOS，应用层几乎不动；分层做得差，任何一次芯片替换都会演变成全局改代码。

一、分层架构的核心优势

分层架构的本质是依赖方向单一化：上层依赖下层提供的接口，下层不感知上层的存在。对低功耗与内存管理而言，这种单向依赖带来四个直接收益：

可移植性：硬件相关代码集中在HAL，换芯片只改HAL实现，驱动层以上保持稳定。
可测试性：中间件层和应用层可脱离真实硬件，用桩函数或模拟器验证低功耗状态机与内存池逻辑。
可复用性：同一套内存池、日志、事件框架可跨项目复用，减少重复开发。
可维护性：低功耗策略变更只影响特定层，避免“牵一发而动全身”。

分层不是越多越好。层数过多会引入调用开销和内存占用，对RAM只有几KB的单片机反而有害。通常四层结构（HAL、驱动、中间件、应用）已能覆盖绝大多数低功耗与内存管理需求。

二、四层职责划分

下面用一张结构关系图说明四层之间的依赖方向与典型职责。图中箭头表示“上层调用下层接口”，反向依赖被严格禁止。

四层职责可以进一步用表格对比，便于在工程中快速判断某段代码应放在哪一层。

层级	核心职责	典型接口	低功耗关注点	内存关注点
应用层	业务逻辑、模式决策	app_task_run()、app_power_policy()	何时进入Sleep/Stop	任务栈大小、动态分配策略
中间件层	通用机制、框架	mem_pool_alloc()、event_post()	低功耗状态机、唤醒源管理	内存池、环形缓冲、碎片控制
驱动层	外设控制、中断处理	uart_send()、spi_transfer()	外设时钟门控、DMA唤醒	DMA缓冲区、静态分配
HAL	寄存器与芯片特性封装	hal_gpio_set()、hal_enter_stop()	电源模式寄存器、唤醒配置	链接脚本、堆栈布局

三、接口设计原则

分层能否真正落地，取决于接口设计是否守住边界。以下五条原则在低功耗与内存管理场景中尤为关键：

接口最小化：每层只暴露必要函数，避免上层直接操作寄存器或内存地址。
参数显式化：低功耗模式、超时时间、缓冲区大小等必须作为参数传入，不依赖全局变量。
错误可返回：所有可能失败的接口返回错误码，便于上层决定是否重试或降级。
无隐式内存分配：驱动层和HAL禁止调用malloc，内存分配统一由中间件层内存池管理。
可重入与中断安全：明确接口是否可在中断中调用，避免低功耗唤醒路径上的竞态。

一个实用判断法：如果某个函数需要知道“当前是哪个芯片型号”或“当前处于哪种低功耗模式”，它大概率不属于应用层。应用层只表达“我要低功耗”，不表达“如何低功耗”。

四、案例：低功耗串口接收的分层实现

以“串口接收数据后唤醒系统”为例，展示四层如何协作。应用层只关心“有数据要处理”，驱动层负责“如何收”，HAL负责“如何唤醒”。

/* HAL层：封装芯片进入STOP模式与串口唤醒配置 */
hal_status_t hal_enter_stop_with_uart_wakeup(uart_id_t id) {
    /* 配置UART RX引脚为唤醒源，关闭无关时钟 */
    pmu_set_wakeup_source(WAKEUP_UART_RX);
    pmu_enter_stop_mode();
    return HAL_OK;
}

/* 驱动层：提供阻塞/非阻塞接收接口，不感知业务 */
int uart_receive_async(uart_id_t id, uint8_t *buf, uint16_t len,
                       void (*cb)(uint8_t *data, uint16_t size)) {
    /* 配置DMA，注册回调，使能中断 */
    return uart_dma_start(id, buf, len, cb);
}

/* 中间件层：事件框架 + 内存池，统一管理接收缓冲区 */
void event_post(event_id_t id, void *data, uint16_t size) {
    event_t *evt = mem_pool_alloc(size + sizeof(event_t));
    if (!evt) return; /* 内存不足，丢弃或降级 */
    evt->id = id;
    memcpy(evt->payload, data, size);
    event_queue_push(evt);
}

/* 应用层：只处理业务，不关心底层如何唤醒 */
void app_uart_on_data(uint8_t *data, uint16_t size) {
    if (size > 0) {
        app_protocol_parse(data, size);
        app_power_request(APP_POWER_ACTIVE); /* 有数据，保持活跃 */
    }
}

这个案例中，应用层没有出现任何寄存器名、DMA通道号或电源模式常量；驱动层没有出现业务协议解析；HAL没有出现内存池。各层边界清晰，替换芯片时只需重写HAL中的hal_enter_stop_with_uart_wakeup，其余代码不受影响。

五、常见误区与复盘

误区一：分层等于多文件。把代码拆成多个.c文件但互相直接调用全局变量，仍然是“伪分层”。真正的分层要求接口清晰、依赖单向。
误区二：HAL过度抽象。把UART、SPI、I2C全部抽象成统一“总线接口”，反而增加复杂度。HAL应贴近芯片特性，驱动层再做统一。
误区三：中间件层承担业务。内存池、事件框架是机制，不是策略。业务决策必须留在应用层，否则中间件无法复用。
误区四：忽略中断上下文。低功耗唤醒常在中断中发生，接口若未标注中断安全性，容易在唤醒路径上产生内存竞争。

复盘时可用三个问题检验分层质量：换一颗同系列MCU需要改几层？低功耗策略变更影响几层？内存分配失败时能否在中间件层统一降级？如果答案分别是“一层”“一层”“能”，说明分层设计基本到位。

分层设计最终服务于两个目标：让低功耗策略可插拔，让内存管理可收敛。HAL守住硬件差异，驱动层守住外设时序，中间件层守住资源机制，应用层守住业务决策。四层各司其职，移植适配才不至于变成重写工程。