3.24_433_RX版本：封装RF433模块，完成开机进入TX/RX模式并在开发板验证成功

2026-03-24 16:59:20 +08:00
commit e439dd465e
1311 changed files with 692196 additions and 0 deletions
--- a/Driver_RF433/Inc/rf433_hal.h
+++ b/Driver_RF433/Inc/rf433_hal.h
@ -0,0 +1,217 @@
+/**
+ ******************************************************************************
+ * @file    rf433_hal.h
+ * @brief   RF433硬件抽象层接口
+ * @note    基于原e32_hal.c重构，保持与原版设备兼容
+ ******************************************************************************
+ */
+
+#ifndef __RF433_HAL_H__
+#define __RF433_HAL_H__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include <stdint.h>
+#include <stdbool.h>
+
+/* ============================================================================
+ * HAL配置宏
+ * ============================================================================ */
+
+/**
+ * @brief 是否使用AUX引脚检测忙状态
+ * @note 1: 使用AUX引脚（推荐）
+ *       0: 使用延时（不推荐）
+ */
+#ifndef RF433_USE_GPIO_AUX
+#define RF433_USE_GPIO_AUX 1
+#endif
+
+/**
+ * @brief AUX引脚忙等待超时时间（ms）
+ */
+#ifndef RF433_AUX_TIMEOUT
+#define RF433_AUX_TIMEOUT 100
+#endif
+
+/* ============================================================================
+ * 错误码定义
+ * ============================================================================ */
+
+typedef enum
+{
+    RF433_HAL_OK                  = 0,  // 成功
+    RF433_HAL_ERROR               = -1, // 通用错误
+    RF433_HAL_ERROR_TIMEOUT       = -2, // 超时
+    RF433_HAL_ERROR_INVALID_PARAM = -3, // 无效参数
+    RF433_HAL_ERROR_BUSY          = -4, // 模块忙
+} rf433_hal_error_t;
+
+/* ============================================================================
+ * 工作模式枚举（与原e32_hal.h保持一致）
+ * ============================================================================ */
+
+typedef enum
+{
+    RF433_WORK_MODE_TRANSPARENT          = 0x00,  // 一般模式（透明传输）
+    RF433_WORK_MODE_WAKE_ON_RADIO_MASTER = 0x01,  // WOR主模式
+    RF433_WORK_MODE_WAKE_ON_RADIO_SLAVE  = 0x02,  // WOR从模式
+    RF433_WORK_MODE_CONFIG_AND_SLEEP     = 0x03,  // 配置/睡眠模式
+} rf433_work_mode_t;
+
+/* ============================================================================
+ * HAL初始化函数
+ * ============================================================================ */
+
+/**
+ * @brief 初始化硬件抽象层
+ * @return RF433_HAL_OK 成功
+ *         RF433_HAL_ERROR 失败
+ */
+rf433_hal_error_t rf433_hal_init(void);
+
+/**
+ * @brief 反初始化硬件抽象层
+ * @return RF433_HAL_OK 成功
+ */
+rf433_hal_error_t rf433_hal_deinit(void);
+
+/* ============================================================================
+ * UART通信函数
+ * ============================================================================ */
+
+/**
+ * @brief UART发送数据（基于原e32_hal_uart_tx）
+ * @param buffer 数据缓冲区
+ * @param length 数据长度
+ * @return RF433_HAL_OK 成功
+ *         RF433_HAL_ERROR_TIMEOUT 超时
+ */
+rf433_hal_error_t rf433_hal_uart_tx(uint8_t *buffer, uint16_t length);
+
+/**
+ * @brief UART接收数据（中断模式）
+ * @param data 接收到的数据
+ * @param length 数据长度
+ * @note 此函数由UART中断回调调用
+ */
+void rf433_hal_uart_rx_callback(uint8_t *data, uint16_t length);
+
+/**
+ * @brief UART接收完成回调函数（由HAL_UART_RxCpltCallback调用）
+ * @retval 无
+ */
+void rf433_hal_uart_rxcplt_callback(void);
+
+/* ============================================================================
+ * GPIO控制函数
+ * ============================================================================ */
+
+/**
+ * @brief 等待AUX引脚变为空闲（基于原e32_hal_aux_wait）
+ * @return RF433_HAL_OK 成功
+ *         RF433_HAL_ERROR_TIMEOUT 超时
+ */
+rf433_hal_error_t rf433_hal_aux_wait(void);
+
+/**
+ * @brief 设置工作模式（基于原e32_hal_work_mode）
+ * @param mode 工作模式
+ * @return RF433_HAL_OK 成功
+ *         RF433_HAL_ERROR_TIMEOUT 超时
+ */
+rf433_hal_error_t rf433_hal_set_work_mode(rf433_work_mode_t mode);
+
+/**
+ * @brief 复位模块（基于原e32_hal_reset）
+ * @return RF433_HAL_OK 成功
+ */
+rf433_hal_error_t rf433_hal_reset(void);
+
+/* ============================================================================
+ * FIFO操作函数
+ * ============================================================================ */
+
+/**
+ * @brief 写入FIFO
+ * @param data 数据指针
+ * @param length 数据长度
+ * @return RF433_HAL_OK 成功
+ *         RF433_HAL_ERROR_FULL FIFO满
+ */
+rf433_hal_error_t rf433_hal_fifo_write(const uint8_t *data, uint16_t length);
+
+/**
+ * @brief 读取FIFO
+ * @param data 数据缓冲区
+ * @param length 期望读取长度
+ * @param actual_length 实际读取长度
+ * @return RF433_HAL_OK 成功
+ *         RF433_HAL_ERROR_EMPTY FIFO空
+ */
+rf433_hal_error_t rf433_hal_fifo_read(uint8_t *data, uint16_t length, uint16_t *actual_length);
+
+/**
+ * @brief 获取FIFO数据长度
+ * @param length 数据长度输出
+ * @return RF433_HAL_OK 成功
+ */
+rf433_hal_error_t rf433_hal_fifo_get_length(uint16_t *length);
+
+/**
+ * @brief 清空FIFO
+ * @return RF433_HAL_OK 成功
+ */
+rf433_hal_error_t rf433_hal_fifo_clear(void);
+
+/* ============================================================================
+ * 定时器回调函数
+ * ============================================================================ */
+
+/**
+ * @brief 1ms定时器回调（用于超时检测）
+ * @note 此函数需要在1ms定时器中断中调用
+ */
+void rf433_hal_1ms_callback(void);
+
+/* ============================================================================
+ * 兼容函数声明（用于保持与原代码的兼容性）
+ * ============================================================================ */
+
+/**
+ * @brief UART接收超时1ms回调（兼容原uart1_rx_timeout_1ms_callback）
+ * @note 此函数需要在1ms定时器中断中调用
+ */
+void uart1_rx_timeout_1ms_callback(void);
+
+/**
+ * @brief UART等待响应（阻塞模式，兼容原uart1_wait_response_blocked）
+ * @param buffer 数据缓冲区
+ * @param length 数据长度输出
+ * @note 与main.h中的声明保持一致，返回void
+ */
+void uart1_wait_response_blocked(uint8_t *buffer, uint16_t *length);
+
+/**
+ * @brief UART检查接收完成（兼容原uart1_check_rx_done）
+ * @param buffer 数据缓冲区
+ * @param length 数据长度输出（uint32_t*，与main.h中的声明保持一致）
+ * @return true 接收到数据
+ *         false 无数据
+ */
+bool uart1_check_rx_done(uint8_t *buffer, uint32_t *length);
+
+/**
+ * @brief 检查接收完成标志（用于RF433应用层）
+ * @return true 接收完成
+ *         false 接收未完成
+ */
+bool rf433_hal_check_rx_done(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __RF433_HAL_H__ */