嵌入式软件架构规范之

嵌入式软件架构规范之 - 分层设计

一、规范的核心思想：驱动文件的“独立性”与“复用性”

该规范的本质是通过分层隔离，实现驱动代码的高复用性、低耦合性，确保驱动模块仅关注“硬件操作逻辑”，不依赖上层业务或下层硬件接口的具体实现细节。其核心要求包括：

二、关键要点解析

1. 驱动文件不能包含应用层内容

应用层定义：指与具体业务逻辑相关的代码（如业务状态机、数据处理逻辑、通信协议解析等）。
原因：
- 驱动是“硬件操作的抽象层”，应专注于控制硬件（如GPIO读写、SPI通信时序），而非处理业务数据。
- 若驱动包含应用层逻辑，会导致驱动与特定业务强绑定，无法在其他项目中复用。

举例：

错误示范（驱动包含应用层逻辑）：

// 驱动文件（错误）：在LED驱动中处理“按键状态→LED亮灭”的业务逻辑
void LED_Driver_Process(void) {if (Key_GetState() == PRESS) {  // 调用应用层的按键状态获取函数LED_On();} else {LED_Off();}
}

正确示范（驱动仅封装硬件操作）：

// 驱动文件（正确）：仅提供LED的硬件控制接口
void LED_Init(void) {// 初始化GPIO引脚为输出模式
}
void LED_On(void) {// 写寄存器使LED点亮
}
void LED_Off(void) {// 写寄存器使LED熄灭
}

应用层调用驱动（业务逻辑与驱动分离）：

// 应用层文件：独立处理按键与LED的逻辑
void App_Main(void) {while (1) {if (Key_Detect()) {  // 应用层自己处理按键检测LED_On();  // 调用驱动提供的接口} else {LED_Off();}}
}

2. 驱动文件不能包含底层接口定义

底层接口定义：指直接操作硬件寄存器的函数或宏（如寄存器地址定义、寄存器位操作等）。
原因：
- 底层接口与具体芯片型号强相关（如STM32的寄存器地址 vs. 瑞萨的寄存器地址），若驱动依赖底层接口，会导致驱动无法跨芯片平台复用。
- 应通过“硬件抽象层（HAL）”或“芯片适配层”隔离底层差异，驱动仅调用抽象后的接口。

举例：

错误示范（驱动直接操作底层寄存器）：

// 驱动文件（错误）：直接使用STM32的寄存器地址
#define LED_GPIO_PORT GPIOA
#define LED_GPIO_PIN GPIO_PIN_5
void LED_On(void) {LED_GPIO_PORT->BSRR = LED_GPIO_PIN;  // 直接操作STM32的寄存器
}

正确示范（驱动调用底层抽象接口）：

// 底层抽象层（芯片适配层），提供统一接口
// hal_gpio.h
void HAL_GPIO_Write(GPIO_TypeDef* port, uint16_t pin, GPIO_State state);// 驱动文件（正确）：通过抽象接口操作硬件
void LED_On(void) {HAL_GPIO_Write(LED_GPIO_PORT, LED_GPIO_PIN, GPIO_HIGH);  // 调用抽象接口
}

底层实现（以STM32为例）：

// hal_gpio.c（STM32适配）
void HAL_GPIO_Write(GPIO_TypeDef* port, uint16_t pin, GPIO_State state) {if (state == GPIO_HIGH) {port->BSRR = pin;} else {port->BSRR = (uint32_t)pin << 16;  // BRR寄存器操作}
}

三、分层架构示意图

应用层（业务逻辑）
├─ 调用驱动接口（如LED_On()）
│
驱动层（硬件操作抽象）
├─ 调用底层抽象接口（如HAL_GPIO_Write()）
│
底层适配层（芯片相关）
└─ 直接操作寄存器（如STM32的GPIO寄存器）

四、遵循规范的优势

驱动复用性最大化：
- 同一驱动（如LED驱动）可直接用于STM32、瑞萨、ESP32等不同芯片平台，只需修改底层适配层。
维护成本降低：
- 硬件变更时（如更换芯片型号），只需修改底层适配层，驱动层和应用层代码无需改动。
分工清晰：
- 驱动开发人员专注于硬件操作逻辑，应用开发人员专注于业务逻辑，底层开发人员专注于芯片适配，提高协作效率。

五、常见反例与修正

反例场景	错误代码（驱动文件）	修正后代码（驱动文件）
驱动包含业务逻辑	`void LCD_ShowData(int data)` （直接处理数据格式化）	`void LCD_DrawPixel(int x, int y)` （仅提供画点接口，数据格式化由应用层处理）
驱动依赖具体芯片寄存器	`#define UART_DR ((volatile uint32_t)0x40013804)`	调用 `HAL_UART_Transmit(&huart1, buf, len, timeout)` （通过HAL库抽象接口）