MOC

USART Port

← UART 模块 | ← 主页

文件

文件	作用
usart_port.h / usart_port.c	core_usart_* 接口 + HAL 分发 + DMA + 回调桥
usart_port_config.h	槽位表（HAL 句柄 + 波特率 + 超时）

port文件作用

1. 接口封装,HAL库提供的函数向上包了一层
2. 回调函数注册, 通过注册对象结构体,把huart句柄和回调函数放在一个结构体里实现高内聚
3. 回调函数调用, 直接看是哪个句柄,然后调用对象结构体内对应的函数指针去执行回调函数

port文件的使用

1. 无论使用 DMA 还是阻塞/中断模式，都要先在 Port 配置表中注册 UART 句柄。
2. 在 inc/usart_port_config.h 中配置逻辑实例：

static const st_usart_config_t g_usart_configs[CORE_USART_MAX] = {
    [CORE_USART1] = {
        .handle = &huart1,
        .baudrate = 115200U,
        .timeout = CORE_USART_DEFAULT_TIMEOUT
    },
};

huart1 必须由 CubeMX 生成的 MX_USART1_UART_Init() 完成硬件初始化。

3. 在 server 线程开始时注册回调并启动接收：

static uint8_t s_server_rx_buf[128];//DMA搬运缓冲区
 
static void server_uart_rx(uint8_t *data, uint16_t size)
{
    //处理本次接收数据
    if ((data != NULL) && (size > 0U)) {
        server_protocol_parse(data, size);
    }
    //启动第二次DMA接收
    core_usart_receive_to_idle_dma(CORE_USART1,
                                   s_server_rx_buf, 
                                   sizeof(s_server_rx_buf));
}
 
void server_thread(void *argument)
{
    (void)argument;
    //主次回调函数-->自己写的处理函数
    core_usart_register_rx_callback(CORE_USART1, server_uart_rx);
    //启动第一次接收DMA
    core_usart_receive_to_idle_dma(
        CORE_USART1, s_server_rx_buf, sizeof(s_server_rx_buf));
 
    for (;;) {
        server_thread_process();//线程逻辑
    }
}

线程开始时注册回调并启动首轮接收。UART 空闲线或 DMA 缓冲区接收满时执行回调，size 为本次实际接收长度；回调结束后重新启动下一轮接收。