修复多连接的问题

This commit is contained in:
2026-07-19 15:27:49 +08:00
parent a08d26bcb0
commit e862009bcd
38 changed files with 2475 additions and 1953 deletions
+48 -77
View File
@@ -2,21 +2,18 @@
* 模��称:RS-485 ��工通信驱动
* 模�功能:RS-485 ��工通信驱动实现,核心�点:
* 1. ���拉高 DE(切�到���)
* 2. HAL_UART_Transmit 内部已等待 TC(发送完成)标志
* 2. HAL_UART_Transmit 内部已等�TC(��完�)标志
* 3. ��完毕�拉低 DE(切回接收�)
* 4. 使用 HAL_UARTEx_ReceiveToIdle_IT 实现变长帧接收
* 参考:ST AN3070 应用笔记、controllerstech.com RS485 教程
* 4. 使用 HAL_UARTEx_ReceiveToIdle_IT 实现�长帧接� * �考:ST AN3070 应用笔记�controllerstech.com RS485 教程
* 适用平�:STM32F4 系列
* 作者:王建锋
* 创建日期:2026-07-18
* 修改记录:
* 2026-07-18 王建锋 创建初始版本
* 作者:王建� * 创建日期�026-07-18
* 修改记录� * 2026-07-18 王建� 创建�始版本
*/
#include "rs485.h"
/*
* 内部辅助宏 - 方向控制
* 内部辅助�- 方�控制
*/
#define RS485_DIR_TX(h) HAL_GPIO_WritePin((h)->dir_port, (h)->dir_pin, GPIO_PIN_SET)
#define RS485_DIR_RX(h) HAL_GPIO_WritePin((h)->dir_port, (h)->dir_pin, GPIO_PIN_RESET)
@@ -31,60 +28,49 @@
* huart - UART 外设�柄
* dir_port - DE 引脚 GPIO 端�
* dir_pin - DE 引脚 GPIO 编�
* 返回值:无
* 限定条件:UART 和 GPIO 须先由 CubeMX 完成初始化
* 函数说明:初始化后立即将 DE 拉低,使 RS-485 收发器处于接收状态
*/
void rs485_init(rs485_handle_t *handle,
UART_HandleTypeDef *huart,
GPIO_TypeDef *dir_port,
uint16_t dir_pin)
{
handle->huart = huart;
handle->dir_port = dir_port;
handle->dir_pin = dir_pin;
handle->rx_size = 0;
* 返回值:� * �定�件:UART �GPIO 须先�CubeMX 完��始� * 函数说明:�始化�立�将 DE 拉低,使 RS-485 收�器处于接收状� */
void rs485_init(rs485_handle_t *p_handle,
UART_HandleTypeDef *p_huart,
GPIO_TypeDef *p_dir_port,
uint16_t dir_pin) {
p_handle->huart = p_huart;
p_handle->dir_port = p_dir_port;
p_handle->dir_pin = dir_pin;
p_handle->rx_size = 0;
/* 默认进入接收状态 */
RS485_DIR_RX(handle);
/* 默认进入接收状�?*/
RS485_DIR_RX(p_handle);
}
/*
* 函数功能:阻塞方式发送数据
* 入口参数:handle - RS-485 句柄指针
* 函数功能:阻塞方���数� * 入��数:handle - RS-485 �柄指针
* data - 待��数�缓冲区
* len - 待��字节数
* timeout - 发送超时(ms),传 0 使用默认值
* 返回值:HAL_OK / HAL_TIMEOUT / HAL_ERROR
* 限定条件:须在主循环或 RTOS 任务中调用,不可在 UART 中断中调用
* 函数说明:
* 时序:DE=HIGH → UART 发送 N 字节 → 等 TC → DE=LOW
* HAL_UART_Transmit 内部会等待 TXE(发送寄存器空)逐字节搬数据,
* 最后还会等待 TC(发送完成)标志,确保最后一字节的停止位已移出。
* 因此返回后再拉低 DE 是安全的
* timeout - ��超时(ms),�0 使用默认� * 返回值:HAL_OK / HAL_TIMEOUT / HAL_ERROR
* �定�件:须在主循环�RTOS 任务中调用,���UART 中断中调� * 函数说明� * 时�:DE=HIGH �UART ��?N 字节 ��TC �DE=LOW
* HAL_UART_Transmit 内部会等�TXE(��寄存器空)�字节�数�� * 最�还会等�TC(��完�)标志,确�最�一字节的�止�已移出�? * 因此返回��拉低 DE 是安全的
*/
HAL_StatusTypeDef rs485_transmit(rs485_handle_t *handle,
const uint8_t *data,
HAL_StatusTypeDef rs485_transmit(rs485_handle_t *p_handle,
const uint8_t *p_data,
uint16_t len,
uint32_t timeout)
{
HAL_StatusTypeDef status;
uint32_t timeout) {
HAL_StatusTypeDef status = HAL_OK;
if (timeout == 0U) {
timeout = RS485_TIMEOUT_DEFAULT;
}
/* 1. 切换到发送状态 */
RS485_DIR_TX(handle);
/* 1. 切�到��状�*/
RS485_DIR_TX(p_handle);
/* 2. 阻塞发送(内部等待 TC) */
status = HAL_UART_Transmit(handle->huart,
(uint8_t *)data,
/* 2. 阻塞��(内部等待 TC�*/
status = HAL_UART_Transmit(p_handle->huart,
(uint8_t *)p_data,
len,
timeout);
/* 3. 发送完毕或超时,切回接收状态 */
RS485_DIR_RX(handle);
/* 3. ��完毕或超时,切回接收状�*/
RS485_DIR_RX(p_handle);
return status;
}
@@ -92,42 +78,27 @@ HAL_StatusTypeDef rs485_transmit(rs485_handle_t *handle,
/*
* 函数功能:�动中断方�接收(IDLE 空闲帧检测)
* 入��数:handle - RS-485 �柄指针
* buf - 接收缓冲区
* buf_size - 缓冲区最大容量
* 返回值:HAL_OK / HAL_ERROR
* 限定条件:UART 须已开启全局中断(NVIC 使能)
* 函数说明:
* 使用 HAL_UARTEx_ReceiveToIdle_IT 实现变长帧接收。
* 当 UART 总线空闲超过 1 个字符时间后,硬件触发 IDLE 中断,
* HAL 自动调用 HAL_UARTEx_RxEventCallback 并返回已接收字节数。
* 用户须在该回调中重新调用本函数重新开启接收
*/
HAL_StatusTypeDef rs485_receive_start(rs485_handle_t *handle,
uint8_t *buf,
uint16_t buf_size)
{
handle->rx_size = 0;
return HAL_UARTEx_ReceiveToIdle_IT(handle->huart, buf, buf_size);
* buf - 接收缓冲� * buf_size - 缓冲区最大容� * 返回值:HAL_OK / HAL_ERROR
* �定�件:UART 须已开�全局中断(NVIC 使能� * 函数说明� * 使用 HAL_UARTEx_ReceiveToIdle_IT 实现�长帧接收�? * �UART 总线空闲超过 1 个字符时间�,硬件触�IDLE 中断� * HAL 自动调用 HAL_UARTEx_RxEventCallback 并返回已接收字节数�? * 用户须在该回调中�新调用本函数�新开�接� */
HAL_StatusTypeDef rs485_receive_start(rs485_handle_t *p_handle,
uint8_t *p_buf,
uint16_t buf_size) {
p_handle->rx_size = 0;
return HAL_UARTEx_ReceiveToIdle_IT(p_handle->huart, p_buf, buf_size);
}
/*
* 函数功能:缓存最近一次接收的字节数
* 入口参数:handle - RS-485 句柄指针
* size - 本次接收到的字节数
* 返回值:无
* 限定条件:须在 HAL_UARTEx_RxEventCallback 中调用
*/
void rs485_rx_set_size(rs485_handle_t *handle, uint16_t size)
{
handle->rx_size = size;
* 函数功能:缓存最近一次接收的字节� * 入��数:handle - RS-485 �柄指针
* size - 本次接收到的字节� * 返回值:� * �定�件:须�HAL_UARTEx_RxEventCallback 中调� */
void rs485_rx_set_size(rs485_handle_t *p_handle, uint16_t size) {
p_handle->rx_size = size;
}
/*
* 函数功能:获取最近一次接收的字节数
* 入口参数:handle - RS-485 句柄指针
* 返回值:字节数
*/
uint16_t rs485_rx_get_size(const rs485_handle_t *handle)
{
return handle->rx_size;
* 函数功能:获�最近一次接收的字节� * 入��数:handle - RS-485 �柄指针
* 返回值:字节� */
uint16_t rs485_rx_get_size(const rs485_handle_t *p_handle) {
return p_handle->rx_size;
}
+9 -9
View File
@@ -50,9 +50,9 @@ typedef struct {
* 限定条件:UART 和 GPIO 须先由 CubeMX 完成初始化
* 函数说明:初始化后默认处于接收状态(DE 引脚拉低)
*/
void rs485_init(rs485_handle_t *handle,
UART_HandleTypeDef *huart,
GPIO_TypeDef *dir_port,
void rs485_init(rs485_handle_t *p_handle,
UART_HandleTypeDef *p_huart,
GPIO_TypeDef *p_dir_port,
uint16_t dir_pin);
/*
@@ -66,8 +66,8 @@ void rs485_init(rs485_handle_t *handle,
* 函数说明:发送前自动拉高 DE,发送完成后等待 TC 标志再拉低 DE,
* 确保最后一字节完全移出后再切换到接收状态
*/
HAL_StatusTypeDef rs485_transmit(rs485_handle_t *handle,
const uint8_t *data,
HAL_StatusTypeDef rs485_transmit(rs485_handle_t *p_handle,
const uint8_t *p_data,
uint16_t len,
uint32_t timeout);
@@ -82,8 +82,8 @@ HAL_StatusTypeDef rs485_transmit(rs485_handle_t *handle,
* 收到完整帧后在 RxEventCallback 中通知用户。
* 用户须在回调中重新调用本函数重新开启接收
*/
HAL_StatusTypeDef rs485_receive_start(rs485_handle_t *handle,
uint8_t *buf,
HAL_StatusTypeDef rs485_receive_start(rs485_handle_t *p_handle,
uint8_t *p_buf,
uint16_t buf_size);
/*
@@ -93,7 +93,7 @@ HAL_StatusTypeDef rs485_receive_start(rs485_handle_t *handle,
* 限定条件:须在 HAL_UART_RxCpltCallback / HAL_UARTEx_RxEventCallback 中调用
* 函数说明:将 HAL 回调中接收到的数据大小回写到句柄的 rx_size 字段
*/
void rs485_rx_set_size(rs485_handle_t *handle, uint16_t size);
void rs485_rx_set_size(rs485_handle_t *p_handle, uint16_t size);
/*
* 函数功能:获取最近一次接收的字节数
@@ -101,7 +101,7 @@ void rs485_rx_set_size(rs485_handle_t *handle, uint16_t size);
* 返回值:最近一次接收的字节数
* 限定条件:须在 HAL_UARTEx_RxEventCallback 触发后调用
*/
uint16_t rs485_rx_get_size(const rs485_handle_t *handle);
uint16_t rs485_rx_get_size(const rs485_handle_t *p_handle);
#ifdef __cplusplus
}