文章目录
- 前言
- 一、创建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串口