文章目录
- 前言
 - 一、创建FreeRTOS工程
 - 二、创建文件对串口进行封装
 - 三、代码编写
 - 总结
 
前言
本篇文章将带大家来学习使用面向对象的方式在FreeRTOS中使用串口,使用面向对象的方法非常适合编写可移植性强的代码,那么这篇文章就带大家来看一下这个代码要怎么写。
一、创建FreeRTOS工程
开启串行调试:
 
将systick进行替换,因为使用RTOS后会占用systick作为RTOS的心跳。

开启时钟
 
 配置串口并且开启中断

 
 配置时钟树:

打开FreeRTOS

添加一个队列,用于保存串口数据。

 创建信号量:

 生成工程

二、创建文件对串口进行封装
创建uart_driver.c和uart_driver.h文件来管理串口。
创建一个bsp文件夹用来存放串口的驱动文件:

 在bsp目录下存放串口的驱动文件:

 将驱动文件添加进入keil工程中:
 
 将文件路径添加进入工程这样编译器才能正确找到这个工程:
 
三、代码编写
uart_driver.c
#include "uart_driver.h"
// 接收数据变量,用于接收中断处理
uint8_t rxData = 0;
// 外部 UART 句柄声明,通常在 main.c 中定义
extern UART_HandleTypeDef huart1;
// UART 设备数量
#define UART_NUM 3
// UART 设备列表
struct UART_Device_t *list[UART_NUM];
// 接收队列的大小
#define UART_SIZE 1000
// 当前操作的 UART 设备
PUART_Device current;
// UART1 设备初始化函数
void UART1_Device_Init(struct UART_Device_t *device) 
{
    // 将 UART 设备添加到设备列表中
    list[0] = device;
    // 初始化发送和接收信号量
    device->txSemaphore = osSemaphoreNew(1, 0, NULL);
    device->rxSemaphore = osSemaphoreNew(1, 0, NULL);
    // 初始化接收消息队列
    device->rxQueue = osMessageQueueNew(UART_SIZE, sizeof(uint8_t), NULL);
    // 配置接收中断
    HAL_UART_Receive_IT(device->huart, &rxData, 1);
}
// UART1 设备发送数据函数
HAL_StatusTypeDef UART1_Device_Send(struct UART_Device_t *device, uint8_t *data, uint16_t size, uint32_t timeout) 
{
    // 启动 UART 发送中断
    HAL_UART_Transmit_IT(device->huart, data, size);
    // 等待发送信号量释放,确保发送完成
    if (osSemaphoreAcquire(device->txSemaphore, timeout) == osOK) 
    {
        return HAL_OK;
    } 
    else 
    {
        return HAL_TIMEOUT;
    } 
}
// UART1 设备接收数据函数
HAL_StatusTypeDef UART1_Device_Receive(struct UART_Device_t *device, uint8_t *data, uint16_t size, uint32_t timeout) 
{
    uint16_t received = 0;
    uint32_t startTick = HAL_GetTick();
    
    while (received < size) 
    {
        // 从接收队列中获取数据
        if (osMessageQueueGet(device->rxQueue, &data[received], NULL, timeout) == osOK) 
        {
            received++;
        }
        else
        {
            return HAL_TIMEOUT;
        }
    }
    return HAL_OK;
}
// UART 接收中断回调函数
void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) 
{
    if (huart->Instance == USART1)
    {
        // 从列表中获取对应的 UART 设备
        struct UART_Device_t *device = list[0];
        // 将接收到的数据放入消息队列
        osMessageQueuePut(device->rxQueue, &rxData, 0, 0);
        // 重新启动接收中断
        HAL_UART_Receive_IT(device->huart, &rxData, 1);
    }   
}
// UART 发送完成中断回调函数
void HAL_UART_TxCpltCallback(UART_HandleTypeDef *huart) 
{
    if (huart->Instance == USART1)
    {
        // 从列表中获取对应的 UART 设备
        struct UART_Device_t *device = list[0];
        // 释放发送信号量,表示发送完成
        osSemaphoreRelease(device->txSemaphore);
    }
}
// UART 设备数组,定义和初始化 UART 设备
static UART_Device uart_device[UART_NUM] = {
    {.uartname = "uart1", .huart = &huart1, .init = UART1_Device_Init, .send = UART1_Device_Send, .receive = UART1_Device_Receive},
};
// 获取 UART 设备函数
PUART_Device GetUartDevice(int num)
{
    return &uart_device[num];
}
 
uart_driver.h
#ifndef __UART_DRIVER_H__
#define __UART_DRIVER_H__
#include "main.h"
#include "cmsis_os.h"
// 定义 UART 设备结构体
typedef struct UART_Device_t 
{
    char* uartname; // UART 设备名称
    UART_HandleTypeDef* huart; // HAL UART 句柄
    osSemaphoreId_t txSemaphore; // 发送信号量
    osSemaphoreId_t rxSemaphore; // 接收信号量
    osMessageQueueId_t rxQueue;  // 接收消息队列
    
    // 初始化函数指针
    void (*init)(struct UART_Device_t *device);
    // 发送函数指针
    HAL_StatusTypeDef (*send)(struct UART_Device_t *device, uint8_t *data, uint16_t size, uint32_t timeout);
    // 接收函数指针
    HAL_StatusTypeDef (*receive)(struct UART_Device_t *device, uint8_t *data, uint16_t size, uint32_t timeout);
} UART_Device, *PUART_Device;
// 函数原型声明
HAL_StatusTypeDef UART_Device_Send(struct UART_Device_t *device, uint8_t *data, uint16_t size, uint32_t timeout);
HAL_StatusTypeDef UART_Device_Receive(struct UART_Device_t *device, uint8_t *data, uint16_t size, uint32_t timeout);
PUART_Device GetUartDevice(int num);
#endif
 
使用步骤;
void StartDefaultTask(void *argument)
{
  /* USER CODE BEGIN StartDefaultTask */
  /* Infinite loop */
	
	
	PUART_Device uart1_device = GetUartDevice(0);
	uart1_device->init(uart1_device);
	uart1_device->send(uart1_device, "Hello", sizeof("Hello"), 1000);
	
	
  for(;;)
  {
		HAL_StatusTypeDef status = uart1_device->receive(uart1_device, rxBuffer, 1, 1000);
		if (status == HAL_OK)
		{
				// 处理接收到的数据
				uart1_device->send(uart1_device, "Hello", sizeof("Hello"), 1000);
		}		
    osDelay(1);
  }
  /* USER CODE END StartDefaultTask */
}
 
代码编写思路:
这段代码设计了一个 UART 驱动程序,主要实现了 UART 数据的异步发送和接收。以下是其实现思路:
-  
初始化:
- 在 
UART1_Device_Init函数中,首先将 UART 设备添加到一个全局设备列表中。 - 使用 
osSemaphoreNew创建发送和接收信号量,这些信号量用于同步发送和接收操作的完成状态。 - 使用 
osMessageQueueNew创建接收消息队列,用于存储接收到的数据。 - 启动接收中断,允许 UART 在接收到数据时触发中断。
 
 - 在 
 -  
发送数据:
UART1_Device_Send函数启动 UART 的发送中断,异步地发送数据。- 发送函数会等待发送信号量的释放,确保数据已经完全发送出去。如果在指定时间内未释放信号量,则返回超时错误。
 
 -  
接收数据:
UART1_Device_Receive函数从接收消息队列中获取数据,直到接收到指定数量的数据或超时。- 这个函数通过消息队列来接收数据,确保接收到的数据在队列中等待处理。
 
 -  
中断回调:
HAL_UART_RxCpltCallback函数在 UART 接收中断时被调用。它将接收到的数据放入接收消息队列,并重新启动接收中断,确保持续接收数据。HAL_UART_TxCpltCallback函数在 UART 发送中断时被调用。它释放发送信号量,通知发送操作已完成。
 
整体思路是利用中断和 FreeRTOS 的信号量及消息队列机制,实现 UART 数据的异步发送和接收,以提高数据传输的效率和可靠性。
总结
本篇文章主要讲解了在FreeRTOS中使用面向对象的方式使用串口,掌握这种编程方式对于工程管理是非常有必要的。
工程代码公众号回复:FreeRTOS串口

















