添加普冉 PY32F040 OTA 双工程代码生成模板

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-18 18:59:56 +08:00
commit 331864dc64
496 changed files with 329040 additions and 0 deletions
@@ -0,0 +1,101 @@
+/******************************************************************************
+ * @file    jb_uart.h
+ * @brief   USART3 协议串口驱动（PB10=TX / PB11=RX）
+ * @author  cyWu <1917507415@qq.com>
+ * @date    2026.08.10
+ * @version V1.0.0
+ * @history
+ * - V1.0.0, 2026.08.10, cyWu, 首次发布
+ ******************************************************************************/
+
+#ifndef __JB_UART_H__
+#define __JB_UART_H__
+
+#include <stdint.h>
+#include "py32f0xx_hal.h"
+
+/*============================================================================*/
+/* 宏定义（PY32F040 手册 PortB AF：PB10/PB11 = USART3 @ AF4）                   */
+/*============================================================================*/
+
+#ifndef JB_UART_BAUDRATE
+#define JB_UART_BAUDRATE                (9600U)
+#endif
+
+#define JB_USART                        USART3
+#define JB_USART_IRQn                   USART3_4_IRQn
+#define JB_USART_CLK_ENABLE()           __HAL_RCC_USART3_CLK_ENABLE()
+
+#define JB_USART_TX_PIN                 GPIO_PIN_10
+#define JB_USART_TX_GPIO_PORT           GPIOB
+#define JB_USART_TX_AF                  GPIO_AF4_USART3
+#define JB_USART_TX_GPIO_CLK_ENABLE()   __HAL_RCC_GPIOB_CLK_ENABLE()
+
+#define JB_USART_RX_PIN                 GPIO_PIN_11
+#define JB_USART_RX_GPIO_PORT           GPIOB
+#define JB_USART_RX_AF                  GPIO_AF4_USART3
+#define JB_USART_RX_GPIO_CLK_ENABLE()   __HAL_RCC_GPIOB_CLK_ENABLE()
+
+/*============================================================================*/
+/* 错误码                                                                      */
+/*============================================================================*/
+
+typedef enum {
+    JB_UART_OK = 0,
+    JB_UART_ERR_PARAM,
+    JB_UART_ERR_BUSY,
+    JB_UART_ERR_TIMEOUT,
+    JB_UART_ERR_NOT_INIT,
+    JB_UART_ERR_HAL,
+    JB_UART_ERR_UNKNOWN
+} JbUart_Ret_t;
+
+/**
+ * @brief  单字节 RX 回调（上层注册，驱动不依赖协议）
+ * @param  byte 收到的字节
+ */
+typedef void (*JbUartRxCallback_t)(uint8_t byte);
+
+/*============================================================================*/
+/* 句柄（供 MSP / IRQ）                                                        */
+/*============================================================================*/
+
+extern UART_HandleTypeDef g_jb_uart_handle;
+#define UartHandle  g_jb_uart_handle
+
+/*============================================================================*/
+/* 外部接口                                                                    */
+/*============================================================================*/
+
+/**
+ * @brief  注册 RX 回调（建议在 jb_uart_init 前调用）
+ * @param  cb 回调，NULL 表示不向上层投递
+ */
+void jb_uart_set_rx_callback(JbUartRxCallback_t cb);
+
+/**
+ * @brief  初始化 USART3：9600 8N1 + RX 中断
+ * @return JbUart_Ret_t
+ */
+JbUart_Ret_t jb_uart_init(void);
+
+/**
+ * @brief  主循环调用：刷出 RX 调试日志
+ */
+void jb_uart_run(void);
+
+/**
+ * @brief  阻塞发送
+ * @param  buf 数据
+ * @param  len 长度
+ * @return 成功返回 len，失败返回 -1
+ */
+int32_t jb_uart_write(uint8_t *buf, uint32_t len);
+
+/**
+ * @brief  获取初始化状态
+ * @return JbUart_Ret_t
+ */
+JbUart_Ret_t jb_uart_get_status(void);
+
+#endif /* __JB_UART_H__ */