巧用 FreeRTOS：仿 STM32 HAL 库思想构建异步非阻塞驱动

在嵌入式系统开发中，尤其是基于 FreeRTOS 的项目中，设备驱动的设计至关重要。传统的轮询方式会浪费大量的 CPU 资源，而中断驱动虽然效率较高，但编写和维护起来相对复杂。本文将探讨如何仿照 STM32 HAL 库的设计思想，使用 FreeRTOS 实现异步非阻塞式设备驱动，从而提高系统的效率和可维护性。

STM32 HAL 库设计思想解析：驱动分层与状态机

STM32 HAL 库的一个核心思想就是驱动分层。它将硬件操作与应用逻辑解耦，使得驱动程序更容易编写、测试和维护。HAL 库通常包含以下几个层次：

• 硬件抽象层 (HAL)：直接操作硬件寄存器，提供最底层的访问接口。
• 中间件层 (Middleware)：基于 HAL 层，实现一些通用的功能模块，例如 USB 协议栈、文件系统等。
• 应用层 (Application)：调用中间件层提供的接口，实现具体的应用逻辑。

此外，HAL 库还大量使用了状态机来管理设备的状态。例如，在 SPI 通信中，状态机可以跟踪当前的传输状态，并在传输完成时通知应用程序。

FreeRTOS 实现异步非阻塞驱动：任务、队列与中断

要实现异步非阻塞驱动，我们需要利用 FreeRTOS 的任务、队列和中断机制。

1. 中断服务例程 (ISR)：当设备产生中断时，ISR 会被触发。ISR 的主要任务是将中断事件放入一个 FreeRTOS 队列中。注意，ISR 中不能调用 FreeRTOS 的 API，只能使用 xQueueSendFromISR() 等中断安全的函数。
2. 驱动任务：驱动任务负责从队列中读取中断事件，并执行相应的操作。由于驱动任务是在 FreeRTOS 的控制下运行的，因此它可以安全地调用 FreeRTOS 的 API，例如 vTaskDelay() 和 xQueueReceive()。
3. 应用任务：应用任务负责调用驱动任务提供的接口，例如读写设备数据。由于驱动任务是异步的，因此应用任务不需要等待设备操作完成，可以继续执行其他任务。

代码示例：基于 FreeRTOS 的 UART 驱动

下面是一个基于 FreeRTOS 的 UART 驱动的示例代码。该驱动使用了中断和队列来实现异步非阻塞的串口通信。

// 定义 UART 驱动的结构体
typedef struct {
  UART_HandleTypeDef *huart; // UART 句柄
  QueueHandle_t rx_queue;    // 接收队列
  QueueHandle_t tx_queue;    // 发送队列
} uart_driver_t;

// 初始化 UART 驱动
void uart_driver_init(uart_driver_t *driver, UART_HandleTypeDef *huart) {
  driver->huart = huart;
  driver->rx_queue = xQueueCreate(16, sizeof(uint8_t)); // 创建接收队列，长度为 16，每个元素大小为 1 字节
  driver->tx_queue = xQueueCreate(16, sizeof(uint8_t)); // 创建发送队列，长度为 16，每个元素大小为 1 字节
  HAL_UART_Receive_IT(huart, &driver->rx_byte, 1);    // 启动接收中断
}

// UART 中断服务例程
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) {
  uart_driver_t *driver = (uart_driver_t *)huart->pRxBuffPtr; // 获取 UART 驱动的结构体指针
  BaseType_t xHigherPriorityTaskWoken = pdFALSE;
  xQueueSendFromISR(driver->rx_queue, &driver->rx_byte, &xHigherPriorityTaskWoken); // 将接收到的数据放入接收队列
  HAL_UART_Receive_IT(huart, &driver->rx_byte, 1); // 重新启动接收中断
  portYIELD_FROM_ISR(xHigherPriorityTaskWoken);
}

// UART 驱动任务
void uart_driver_task(void *pvParameters) {
  uart_driver_t *driver = (uart_driver_t *)pvParameters; // 获取 UART 驱动的结构体指针
  uint8_t rx_byte;
  while (1) {
    if (xQueueReceive(driver->rx_queue, &rx_byte, portMAX_DELAY) == pdTRUE) { // 从接收队列中读取数据，阻塞等待
      // 处理接收到的数据
      printf("Received: %c\r\n", rx_byte);
    }
  }
}

// 创建 UART 驱动任务
void create_uart_driver_task(uart_driver_t *driver, UART_HandleTypeDef *huart) {
  driver->huart = huart;
  driver->huart->pRxBuffPtr = driver;
  xTaskCreate(uart_driver_task, "UART Driver", 128, driver, 5, NULL); // 创建 UART 驱动任务，堆栈大小为 128，优先级为 5
  uart_driver_init(driver, huart);
}

驱动实战避坑经验

1. **中断优先级设置：**FreeRTOS 下的中断优先级至关重要。务必确保中断优先级低于 configMAX_SYSCALL_INTERRUPT_PRIORITY，否则可能导致 FreeRTOS 内核崩溃。
2. **队列长度的选择：**队列长度需要根据实际的应用场景进行选择。如果队列太短，可能会导致数据丢失；如果队列太长，可能会浪费内存资源。
3. **内存管理：**使用 FreeRTOS 时，需要注意内存管理。可以使用 FreeRTOS 提供的动态内存分配函数，也可以使用静态内存分配。在嵌入式系统中，静态内存分配通常更安全可靠。
4. 避免在中断服务例程中执行耗时操作：中断服务例程应该尽可能地短小精悍，避免执行耗时的操作。耗时的操作应该放到驱动任务中执行。例如，进行复杂的协议解析或者数据处理等，都应该放在 FreeRTOS 的任务中进行，而仿照 STM32 HAL 库设计思想使用FreeRTOS实现异步非阻塞式设备驱动时，数据接收尽量只做原始数据入队操作。

总结

本文介绍了如何仿照 STM32 HAL 库的设计思想，使用 FreeRTOS 实现异步非阻塞式设备驱动。通过使用中断、队列和任务，我们可以提高系统的效率和可维护性。当然，在实际的开发过程中，还需要根据具体的硬件和应用场景进行调整和优化。在嵌入式开发中，选择合适的开发工具也很重要，例如 IAR Embedded Workbench、Keil MDK 等，都提供了强大的调试和分析功能，可以帮助开发者快速定位和解决问题。另外，像宝塔面板这类服务器管理工具，虽然主要应用于服务器运维，但了解其背后的架构设计思路，例如反向代理和负载均衡，也能帮助我们更好地理解嵌入式系统中的任务调度和资源管理。