修复多连接的问题

2026-07-19 15:27:49 +08:00
parent 9ed4c22022
commit e06d849007
38 changed files with 2475 additions and 1953 deletions
--- a/Drivers/BSP/RS485/rs485.c
+++ b/Drivers/BSP/RS485/rs485.c
@@ -2,21 +2,18 @@
 * æ¨¡å<C2A1>—å<E28094><C3A5>ç§°ï¼šRS-485 å<>Šå<C5A0>Œå·¥é€šä¿¡é©±åŠ¨
 * æ¨¡å<C2A1>—åŠŸèƒ½ï¼šRS-485 å<>Šå<C5A0>Œå·¥é€šä¿¡é©±åŠ¨å®žçŽ°ï¼Œæ ¸å¿ƒè¦<C3A8>ç‚¹ï¼š
 *          1. å<>‘é€<C3A9>å‰<C3A5>æ‹‰é«˜ DEï¼ˆåˆ‡æ<E280A1>¢åˆ°å<C2B0>‘é€<C3A9>æ€<C3A6>ï¼‰
- *          2. HAL_UART_Transmit 内部已等待 TC（发送完成）标志
+ *          2. HAL_UART_Transmit å†…éƒ¨å·²ç‰ï¿?TCï¼ˆå<CB86>‘é€<C3A9>å®Œæˆ<C3A6>ï¼‰æ ‡å¿—
 *          3. å<>‘é€<C3A9>å®Œæ¯•å<E280A2>Žæ‹‰ä½Ž DEï¼ˆåˆ‡å›žæŽ¥æ”¶æ€<C3A6>ï¼‰
- *          4. 使用 HAL_UARTEx_ReceiveToIdle_IT 实现变长帧接收
- *          参考：ST AN3070 应用笔记、controllerstech.com RS485 教程
+ *          4. ä½¿ç”¨ HAL_UARTEx_ReceiveToIdle_IT å®žçŽ°å<EFBFBD>˜é•¿å¸§æŽ¥ï¿? *          å<>‚è€ƒï¼šST AN3070 åº”ç”¨ç¬”è®°ã€<C3A3>controllerstech.com RS485 æ•™ç¨‹
 * é€‚ç”¨å¹³å<C2B3>°ï¼šSTM32F4 ç³»åˆ—
- * 作者：王建锋
- * 创建日期：2026-07-18
- * 修改记录：
- *     2026-07-18  王建锋  创建初始版本
+ * ä½œè€…ï¼šçŽ‹å»ºï¿? * åˆ›å»ºæ—¥æœŸï¿?026-07-18
+ * ä¿®æ”¹è®°å½•ï¿? *     2026-07-18  çŽ‹å»ºï¿? åˆ›å»ºåˆ<C3A5>å§‹ç‰ˆæœ¬
 */

 #include "rs485.h"

 /*
- * 内部辅助宏 - 方向控制
+ * å†…éƒ¨è¾…åŠ©ï¿?- æ–¹å<C2B9>‘æŽ§åˆ¶
 */
 #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 å¤–è®¾å<C2BE>¥æŸ„
 *           dir_port - DE å¼•è„š GPIO ç«¯å<C2AF>£
 *           dir_pin  - DE å¼•è„š GPIO ç¼–å<E28093>·
- * 返回值：无
- * 限定条件：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;
+ * è¿”å›žå€¼ï¼šï¿? * é™<C3A9>å®šæ<C5A1>¡ä»¶ï¼šUART ï¿?GPIO é¡»å…ˆï¿?CubeMX å®Œæˆ<C3A6>åˆ<C3A5>å§‹ï¿? * å‡½æ•°è¯´æ˜Žï¼šåˆ<C3A5>å§‹åŒ–å<E28093>Žç«‹å<E280B9>³å°† DE æ‹‰ä½Žï¼Œä½¿ RS-485 æ”¶å<C2B6>‘å™¨å¤„äºŽæŽ¥æ”¶çŠ¶ï¿? */
+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 句柄指针
+ * å‡½æ•°åŠŸèƒ½ï¼šé˜»å¡žæ–¹å¼<EFBFBD>å<EFBFBD>‘é€<EFBFBD>æ•°ï¿? * å…¥å<C2A5>£å<C2A3>‚æ•°ï¼šhandle  - RS-485 å<>¥æŸ„æŒ‡é’ˆ
 *           data    - å¾…å<E280A6>‘é€<C3A9>æ•°æ<C2B0>®ç¼“å†²åŒº
 *           len     - å¾…å<E280A6>‘é€<C3A9>å—èŠ‚æ•°
- *           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 - å<EFBFBD>‘é€<EFBFBD>è¶…æ—¶ï¼ˆmsï¼‰ï¼Œï¿?0 ä½¿ç”¨é»˜è®¤ï¿? * è¿”å›žå€¼ï¼šHAL_OK / HAL_TIMEOUT / HAL_ERROR
+ * é™<EFBFBD>å®šæ<EFBFBD>¡ä»¶ï¼šé¡»åœ¨ä¸»å¾ªçŽ¯ï¿?RTOS ä»»åŠ¡ä¸è°ƒç”¨ï¼Œä¸<C3A4>å<EFBFBD>¯ï¿?UART ä¸æ–ä¸è°ƒï¿? * å‡½æ•°è¯´æ˜Žï¿? *   æ—¶åº<C3A5>ï¼šDE=HIGH ï¿?UART å<>‘ï¿½?N å—èŠ‚ ï¿?ï¿?TC ï¿?DE=LOW
+ *   HAL_UART_Transmit å†…éƒ¨ä¼šç‰ï¿?TXEï¼ˆå<CB86>‘é€<C3A9>å¯„å˜å™¨ç©ºï¼‰é€<C3A9>å—èŠ‚æ<E2809A>¬æ•°æ<C2B0>®ï¿? *   æœ€å<E282AC>Žè¿˜ä¼šç‰ï¿?TCï¼ˆå<CB86>‘é€<C3A9>å®Œæˆ<C3A6>ï¼‰æ ‡å¿—ï¼Œç¡®ä¿<C3A4>æœ€å<E282AC>Žä¸€å—èŠ‚çš„å<E2809E>œæ¢ä½<C3A4>å·²ç§»å‡ºï¿½? *   å› æ¤è¿”å›žå<C5BE>Žå†<C3A5>æ‹‰ä½Ž 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. åˆ‡æ<EFBFBD>¢åˆ°å<EFBFBD>‘é€<EFBFBD>çŠ¶ï¿?*/
+    RS485_DIR_TX(p_handle);

-    /* 2. 阻塞发送（内部等待 TC） */
-    status = HAL_UART_Transmit(handle->huart,
-                                (uint8_t *)data,
+    /* 2. é˜»å¡žå<EFBFBD>‘é€<EFBFBD>ï¼ˆå†…éƒ¨ç‰å¾… TCï¿?*/
+    status = HAL_UART_Transmit(p_handle->huart,
+                                (uint8_t *)p_data,
                                len,
                                timeout);

-    /* 3. 发送完毕或超时，切回接收状态 */
-    RS485_DIR_RX(handle);
+    /* 3. å<EFBFBD>‘é€<EFBFBD>å®Œæ¯•æˆ–è¶…æ—¶ï¼Œåˆ‡å›žæŽ¥æ”¶çŠ¶ï¿?*/
+    RS485_DIR_RX(p_handle);

    return status;
 }
@@ -92,42 +78,27 @@ HAL_StatusTypeDef rs485_transmit(rs485_handle_t *handle,
 /*
 * å‡½æ•°åŠŸèƒ½ï¼šå<C5A1>¯åŠ¨ä¸æ–æ–¹å¼<C3A5>æŽ¥æ”¶ï¼ˆIDLE ç©ºé—²å¸§æ£€æµ‹ï¼‰
 * å…¥å<C2A5>£å<C2A3>‚æ•°ï¼š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
+ * é™<EFBFBD>å®šæ<EFBFBD>¡ä»¶ï¼šUART é¡»å·²å¼€å<E282AC>¯å…¨å±€ä¸æ–ï¼ˆNVIC ä½¿èƒ½ï¿? * å‡½æ•°è¯´æ˜Žï¿? *   ä½¿ç”¨ HAL_UARTEx_ReceiveToIdle_IT å®žçŽ°å<C2B0>˜é•¿å¸§æŽ¥æ”¶ï¿½? *   ï¿?UART æ€»çº¿ç©ºé—²è¶…è¿‡ 1 ä¸ªå—ç¬¦æ—¶é—´å<C2B4>Žï¼Œç¡¬ä»¶è§¦ï¿?IDLE ä¸æ–ï¿? *   HAL è‡ªåŠ¨è°ƒç”¨ HAL_UARTEx_RxEventCallback å¹¶è¿”å›žå·²æŽ¥æ”¶å—èŠ‚æ•°ï¿½? *   ç”¨æˆ·é¡»åœ¨è¯¥å›žè°ƒä¸é‡<C3A9>æ–°è°ƒç”¨æœ¬å‡½æ•°é‡<C3A9>æ–°å¼€å<E282AC>¯æŽ¥ï¿? */
+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;
+ * å‡½æ•°åŠŸèƒ½ï¼šç¼“å˜æœ€è¿‘ä¸€æ¬¡æŽ¥æ”¶çš„å—èŠ‚ï¿? * å…¥å<C2A5>£å<C2A3>‚æ•°ï¼šhandle - RS-485 å<>¥æŸ„æŒ‡é’ˆ
+ *           size   - æœ¬æ¬¡æŽ¥æ”¶åˆ°çš„å—èŠ‚ï¿? * è¿”å›žå€¼ï¼šï¿? * é™<C3A9>å®šæ<C5A1>¡ä»¶ï¼šé¡»ï¿?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;
+ * å‡½æ•°åŠŸèƒ½ï¼šèŽ·å<EFBFBD>–æœ€è¿‘ä¸€æ¬¡æŽ¥æ”¶çš„å—èŠ‚ï¿? * å…¥å<C2A5>£å<C2A3>‚æ•°ï¼šhandle - RS-485 å<>¥æŸ„æŒ‡é’ˆ
+ * è¿”å›žå€¼ï¼šå—èŠ‚ï¿? */
+uint16_t rs485_rx_get_size(const rs485_handle_t *p_handle) {
+    return p_handle->rx_size;
 }
+
+
--- a/Drivers/BSP/RS485/rs485.h
+++ b/Drivers/BSP/RS485/rs485.h
@@ -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
 }