zhongxuanzhen/433_STM32
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
zhongxuanzhen
2026-03-24 16:59:20 +08:00
commit e439dd465e
1311 changed files with 692196 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

621
indexed-jingling-puffin.md Normal file
View File

@ -0,0 +1,621 @@
# E32-433TBH-SC 项目去UI化准备计划
## 一、项目背景与目标
### 背景
当前项目使用OLED显示屏和按键系统提供用户界面，通过菜单系统配置和测试E32-433无线模块的TX（发送）和RX（接收）功能。为了简化硬件、降低成本并专注于核心无线通信功能，需要删除所有UI相关代码。
### 目标
1. **删除所有UI相关代码**：OLED显示、按键输入、菜单系统
2. **提取核心TX/RX功能**：保留并优化无线通信的核心逻辑
3. **实现配置文件支持**：从Flash读取配置参数
4. **保留LED指示**：使用LED作为状态反馈
5. **提供手动接口**：保留外部触发发送/接收的API接口
6. **支持编译模式选择**：通过编译选项选择TX/RX/双模模式
### 工作模式
- **TX设备**：上电后自动循环发送测试数据，LED_TX闪烁指示
- **RX设备**：上电后自动接收数据，LED_RX闪烁指示，维护丢包统计
- **手动接口**：提供API供外部代码触发单次发送/接收
---
## 二、当前代码分析
### 2.1 TX模式实现（application.c: 442-499）
**状态机流程**：
```
TX_MODE_INIT → TX_MODE_SEND → TX_MODE_WAIT → TX_MODE_END
```
**核心代码路径**：
- `tx_mode_callback()` - 主状态机
- `tx_e32_send()` - 发送数据
- `e32_demo_menu_config()` - 配置模块
- `e32_demo_transmit()` - 底层发送
**数据包格式**：
```c
"TX.总次数.当前序号." // 例如: "TX.010.001."
```
**配置参数**（menu_config_t）：
```c
typedef struct {
int work_mode; // 工作模式 (0-3)
int rate_mode; // 空速模式 (2-5)
int channel; // 信道 (0-41)
int tx_power; // 发射功率 (21/24/27/30)
int tx_count; // 发送次数 (10-100)
} menu_config_t;
```
### 2.2 RX模式实现（application.c: 619-719）
**状态机流程**：
```
RX_MODE_INIT → RX_MODE_RECV → RX_MODE_WAIT → RX_MODE_END
```
**核心代码路径**：
- `rx_mode_callback()` - 主状态机
- `rx_analysis()` - 数据包解析
- `rx_mode_display()` - 丢包统计
- `uart1_check_rx_done()` - 接收检查
**丢包统计算法**：
```c
lost_number = tx_number_record - rx_count;
lost_percent = (lost_number * 100) / tx_number_record;
```
### 2.3 RF433驱动层状态
**已完成的重构**：
- `Driver_RF433/Inc/rf433_hal.h` - 硬件抽象层接口
- `Driver_RF433/Src/rf433_hal.c` - 硬件抽象层实现
- `Driver_RF433/Inc/rf433.h` - 主驱动接口
- `Driver_RF433/Src/rf433.c` - 主驱动实现
**已实现的API**：
```c
// 初始化和配置
rf433_init()
rf433_set_config()
rf433_set_work_mode()
// TX功能
rf433_transmit()
// RX功能
rf433_rx_start()
rf433_rx_stop()
rf433_receive()
```
---
## 三、需要删除的UI相关代码
### 3.1 OLED显示相关（需完全删除）
**文件列表**：
- `Core/Src/u8g2_hal.c` - OLED硬件接口
- `Core/Inc/u8g2_hal.h`
- `Core/Src/i2c.c` - I2C接口（仅用于OLED）
- `Core/Inc/i2c.h`
- `Middlewares/u8g2Lib/` - 整个U8g2图形库
**删除的函数调用**：
```c
// 这些调用需要删除
OLED_ClearBuffer()
OLED_DrawStr()
OLED_DrawLine()
OLED_SendBuffer()
OLED_SetDrawColor()
OLED_DrawBox()
OLED_DrawXBMP()
```
### 3.2 按键输入相关（需完全删除）
**文件列表**：
- `Core/Src/key.c` - 按键处理
- `Core/Inc/key.h`
**删除的函数调用**：
```c
key_check_press()
key_set_continue()
```
### 3.3 菜单系统相关（需完全删除）
**文件列表**：
- `Middlewares/MultMenu/menu/menu.c` - 菜单核心
- `Middlewares/MultMenu/menu/menu.h`
- `Middlewares/MultMenu/menu/menuConfig.h`
- `Middlewares/MultMenu/application/application.c` - 菜单应用
- `Middlewares/MultMenu/application/application.h`
- `Middlewares/MultMenu/disp/dispDirver.c` - 显示驱动
- `Middlewares/MultMenu/disp/dispDirver.h`
**删除的函数调用**：
```c
Menu_Init()
Menu_Task()
AddItem()
// 所有 xxx_callback() 函数
```
### 3.4 需要保留的核心文件
**RF433驱动**：
- `Driver_RF433/` - 整个目录保留
**底层硬件**：
- `Core/Src/usart.c` - UART通信（已集成RF433）
- `Core/Src/fifo.c` - FIFO缓冲
- `Core/Src/gpio.c` - GPIO控制
- `Core/Src/tim.c` - 定时器（用于超时检测）
**USB CDC**：
- `USB_DEVICE/` - 保留用于调试输出（可选）
**系统文件**：
- `Core/Src/main.c` - 主程序
- `Core/Src/stm32f1xx_it.c` - 中断处理
- `Core/Src/systick.c` - 系统定时器
---
## 四、核心功能提取方案
### 4.1 TX模式提取
**创建新文件**：`Core/Src/rf433_tx_app.c`
**核心功能**：
```c
// TX状态机
typedef enum {
TX_STATE_INIT = 0,
TX_STATE_SENDING,
TX_STATE_WAITING,
TX_STATE_IDLE,
} tx_state_t;
// TX应用结构体
typedef struct {
tx_state_t state;
uint32_t send_count;
uint32_t total_count;
uint32_t send_interval_ms;
uint32_t last_send_time;
rf433_register_t config;
} rf433_tx_app_t;
// 核心API
rf433_error_t rf433_tx_app_init(const rf433_register_t *config);
rf433_error_t rf433_tx_app_start(uint32_t count, uint32_t interval_ms);
rf433_error_t rf433_tx_app_stop(void);
rf433_error_t rf433_tx_app_manual_send(uint8_t *data, uint16_t length);
void rf433_tx_app_task(void); // 主循环调用
```
**实现要点**：
1. 去除所有OLED显示调用，替换为LED控制
2. 去除按键检测，改为自动循环或手动API触发
3. 保留数据包构造逻辑：`sprintf(buffer, "TX.%03d.%03d.", total, current)`
4. 保留配置流程：调用`rf433_set_config()`设置模块参数
5. 保留LED指示：发送时LED_TX亮起
### 4.2 RX模式提取
**创建新文件**：`Core/Src/rf433_rx_app.c`
**核心功能**：
```c
// RX状态机
typedef enum {
RX_STATE_INIT = 0,
RX_STATE_RECEIVING,
RX_STATE_IDLE,
} rx_state_t;
// RX统计结构体
typedef struct {
uint32_t total_received;
uint32_t total_expected;
uint32_t lost_packets;
uint8_t lost_percent;
} rf433_rx_stats_t;
// RX应用结构体
typedef struct {
rx_state_t state;
rf433_rx_stats_t stats;
uint32_t tx_current_number;
uint32_t tx_total_number;
uint32_t tx_number_record;
rf433_register_t config;
} rf433_rx_app_t;
// 核心API
rf433_error_t rf433_rx_app_init(const rf433_register_t *config);
rf433_error_t rf433_rx_app_start(void);
rf433_error_t rf433_rx_app_stop(void);
void rf433_rx_app_task(void); // 主循环调用
rf433_error_t rf433_rx_app_get_stats(rf433_rx_stats_t *stats);
```
**实现要点**：
1. 去除所有OLED显示调用，替换为LED控制
2. 保留数据包解析：校验"TX"前缀，提取序号
3. 保留丢包统计算法
4. 保留LED指示：接收时LED_RX闪烁
5. 提供API获取统计信息（供外部查询）
### 4.3 配置文件支持
**创建新文件**：`Core/Src/rf433_config_file.c`
**功能实现**：
```c
// Flash配置结构体（对齐Flash扇区）
typedef struct {
uint32_t magic; // 魔数标识 0xA5A5A5A5
uint32_t version; // 配置版本
rf433_register_t rf_config; // RF433配置
uint32_t tx_count; // 发送次数
uint32_t tx_interval; // 发送间隔
uint8_t work_mode; // 工作模式
uint8_t reserved[7]; // 对齐到16字节
uint32_t crc; // CRC校验
} rf433_flash_config_t;
// 核心API
rf433_error_t rf433_config_load(rf433_flash_config_t *config);
rf433_error_t rf433_config_save(const rf433_flash_config_t *config);
rf433_error_t rf433_config_reset_to_default(rf433_flash_config_t *config);
```
**Flash地址规划**：
- 使用STM32的最后一页Flash（如0x0800FC00-0x08010000）
- 配置大小：64字节（单页足够）
- 提供默认配置，首次启动时自动写入
### 4.4 手动接口API
**创建新文件**：`Core/Inc/rf433_manual.h`
**接口定义**：
```c
// 手动发送接口
rf433_error_t rf433_manual_send(uint8_t *data, uint16_t length);
// 手动接收接口（阻塞模式）
rf433_error_t rf433_manual_recv(uint8_t *buffer, uint16_t max_len,
uint16_t *actual_len, uint32_t timeout);
// 获取RX统计信息
rf433_error_t rf433_manual_get_rx_stats(rf433_rx_stats_t *stats);
// 重置统计信息
rf433_error_t rf433_manual_reset_stats(void);
```
---
## 五、编译模式配置
### 5.1 预编译宏定义
在`rf433_config.h`中定义：
```c
// 工作模式选择（三选一）
#define RF433_WORK_MODE_TX 1 // 仅TX模式
#define RF433_WORK_MODE_RX 2 // 仅RX模式
#define RF433_WORK_MODE_DUAL 3 // 双模模式（同时支持TX和RX）
// 当前工作模式（在编译选项中定义）
#ifndef RF433_MODE
#define RF433_MODE RF433_WORK_MODE_TX // 默认TX模式
#endif
// 功能裁剪
#define RF433_ENABLE_CONFIG_FILE 1 // 启用配置文件
#define RF433_ENABLE_LED_INDICATOR 1 // 启用LED指示
#define RF433_ENABLE_USB_DEBUG 0 // 禁用USB调试（可选）
```
### 5.2 Keil项目配置
**TX设备配置**：
- Preprocessor Symbols: `RF433_MODE=1`
- 保留文件：`rf433_tx_app.c`
- 排除文件：`rf433_rx_app.c`（或通过条件编译）
**RX设备配置**：
- Preprocessor Symbols: `RF433_MODE=2`
- 保留文件：`rf433_rx_app.c`
- 排除文件：`rf433_tx_app.c`（或通过条件编译）
**双模设备配置**：
- Preprocessor Symbols: `RF433_MODE=3`
- 保留文件：`rf433_tx_app.c`、`rf433_rx_app.c`
### 5.3 条件编译示例
```c
#if (RF433_MODE == RF433_WORK_MODE_TX) || (RF433_MODE == RF433_WORK_MODE_DUAL)
// TX相关代码
#include "rf433_tx_app.h"
#endif
#if (RF433_MODE == RF433_WORK_MODE_RX) || (RF433_MODE == RF433_WORK_MODE_DUAL)
// RX相关代码
#include "rf433_rx_app.h"
#endif
```
---
## 六、main.c重构方案
### 6.1 初始化流程
```c
int main(void) {
HAL_Init();
SystemClock_Config();
// 硬件初始化（保留必要部分）
MX_GPIO_Init();
MX_USART1_UART_Init();
MX_TIM2_Init(); // 用于超时检测
#if RF433_ENABLE_USB_DEBUG
MX_USB_DEVICE_Init();
#endif
// 加载配置文件
rf433_flash_config_t config;
if (rf433_config_load(&config) != RF433_OK) {
// 加载失败，使用默认配置
rf433_config_reset_to_default(&config);
rf433_config_save(&config);
}
// 初始化RF433模块
rf433_init(&config.rf_config);
// 初始化TX/RX应用层
#if (RF433_MODE == RF433_WORK_MODE_TX) || (RF433_MODE == RF433_WORK_MODE_DUAL)
rf433_tx_app_init(&config.rf_config);
rf433_tx_app_start(config.tx_count, config.tx_interval);
#endif
#if (RF433_MODE == RF433_WORK_MODE_RX) || (RF433_MODE == RF433_WORK_MODE_DUAL)
rf433_rx_app_init(&config.rf_config);
rf433_rx_app_start();
#endif
// 启动UART接收
HAL_UART_Receive_IT(&huart1, &usb_rx_data, 1);
// 主循环
while (1) {
#if (RF433_MODE == RF433_WORK_MODE_TX) || (RF433_MODE == RF433_WORK_MODE_DUAL)
rf433_tx_app_task();
#endif
#if (RF433_MODE == RF433_WORK_MODE_RX) || (RF433_MODE == RF433_WORK_MODE_DUAL)
rf433_rx_app_task();
#endif
HAL_Delay(1);
}
}
```
### 6.2 删除的内容
```c
// 删除这些初始化
// MX_I2C2_Init(); // OLED用的I2C
// Menu_Init(); // 菜单初始化
// 删除主循环中的这些调用
// Menu_Task(); // 菜单任务
// usb_receive_to_tx_send(); // USB桥接（可选保留）
```
---
## 七、实施步骤
### 阶段1：准备工作（1-2小时）
- [ ] 创建新文件模板
- `Core/Src/rf433_tx_app.c`
- `Core/Src/rf433_rx_app.c`
- `Core/Src/rf433_config_file.c`
- `Core/Inc/rf433_manual.h`
- [ ] 备份原项目代码
- [ ] 创建新的Keil项目配置（TX/RX版本）
### 阶段2：TX功能提取（2-3小时）
- [ ] 从`application.c`提取`tx_mode_callback`核心逻辑
- [ ] 实现`rf433_tx_app.c`：
- 状态机（去除菜单相关）
- 自动发送逻辑
- LED指示
- 手动发送接口
- [ ] 测试TX功能
### 阶段3：RX功能提取（2-3小时）
- [ ] 从`application.c`提取`rx_mode_callback`核心逻辑
- [ ] 实现`rf433_rx_app.c`：
- 状态机（去除菜单相关）
- 数据包解析
- 丢包统计
- LED指示
- 统计查询接口
- [ ] 测试RX功能
### 阶段4：配置文件实现（2-3小时）
- [ ] 实现Flash读写函数
- [ ] 定义默认配置
- [ ] 实现配置加载/保存
- [ ] 测试配置持久化
### 阶段5：删除UI代码（1-2小时）
- [ ] 删除OLED相关文件和调用
- [ ] 删除按键相关文件和调用
- [ ] 删除菜单系统文件和调用
- [ ] 清理main.c初始化代码
- [ ] 编译测试，确保无错误
### 阶段6：集成测试（2-3小时）
- [ ] TX模式测试
- 自动循环发送
- LED指示正常
- 手动发送接口测试
- [ ] RX模式测试
- 自动接收
- 丢包统计准确
- LED指示正常
- [ ] 双模模式测试
- [ ] 配置文件测试
- 默认配置加载
- 配置修改和保存
- 配置恢复默认值
### 阶段7：优化和文档（1-2小时）
- [ ] 代码优化和注释
- [ ] 编写使用说明
- [ ] 更新项目文档
- [ ] 创建编译配置说明
**总计时间：11-18小时**
---
## 八、测试验证方案
### 8.1 TX模式测试
**测试项目**：
1. 上电自动启动发送
2. 按配置间隔循环发送
3. LED_TX闪烁指示
4. 发送计数正确
5. 数据包格式正确："TX.010.001."
6. 手动发送接口正常工作
**测试方法**：
- 使用逻辑分析仪或示波器观察UART输出
- 使用另一台RX设备接收并验证
- 观察LED指示
### 8.2 RX模式测试
**测试项目**：
1. 上电自动启动接收
2. 正确解析数据包
3. 丢包统计准确
4. LED_RX闪烁指示
5. 统计查询接口返回正确数据
**测试方法**：
- 使用TX设备发送测试数据
- 通过LED观察接收状态
- 通过手动接口查询统计信息
### 8.3 配置文件测试
**测试项目**：
1. 首次启动写入默认配置
2. 修改配置后重启，配置保持
3. 配置损坏时自动恢复默认值
4. 配置CRC校验正确
**测试方法**：
- 修改配置参数
- 断电重启
- 读取Flash验证
---
## 九、关键文件清单
### 9.1 需要创建的文件
| 文件路径 | 功能描述 | 代码量估算 |
|---------|---------|-----------|
| `Core/Src/rf433_tx_app.c` | TX应用层实现 | ~300行 |
| `Core/Inc/rf433_tx_app.h` | TX应用层接口 | ~80行 |
| `Core/Src/rf433_rx_app.c` | RX应用层实现 | ~400行 |
| `Core/Inc/rf433_rx_app.h` | RX应用层接口 | ~100行 |
| `Core/Src/rf433_config_file.c` | 配置文件实现 | ~200行 |
| `Core/Inc/rf433_config_file.h` | 配置文件接口 | ~60行 |
| `Core/Inc/rf433_manual.h` | 手动接口定义 | ~50行 |
### 9.2 需要修改的文件
| 文件路径 | 修改内容 | 变更量 |
|---------|---------|--------|
| `Core/Src/main.c` | 重构初始化和主循环 | -50行，+100行 |
| `Core/Src/usart.c` | 保留RF433集成，删除USB桥接 | -20行 |
| `Core/Inc/main.h` | 删除UI相关定义 | -30行 |
### 9.3 需要删除的文件
**整个目录删除**：
- `Middlewares/MultMenu/` （整个菜单系统）
- `Middlewares/u8g2Lib/` （OLED图形库）
**单个文件删除**：
- `Core/Src/u8g2_hal.c`
- `Core/Inc/u8g2_hal.h`
- `Core/Src/i2c.c`
- `Core/Inc/i2c.h`
- `Core/Src/key.c`
- `Core/Inc/key.h`
---
## 十、风险评估与缓解措施
### 10.1 风险识别
| 风险 | 影响 | 概率 | 缓解措施 |
|------|------|------|---------|
| 删除UI后无法调试 | 高 | 中 | 保留USB CDC调试输出，使用LED指示关键状态 |
| 配置文件损坏导致设备无法启动 | 中 | 低 | 提供配置恢复机制，使用CRC校验 |
| TX/RX功能提取不完整 | 高 | 中 | 充分测试，保留原代码作为参考 |
| Flash写入失败 | 中 | 低 | 添加错误处理，提供默认配置 |
| LED指示不够直观 | 低 | 中 | 定义清晰的闪烁模式文档 |
### 10.2 回滚计划
如果在实施过程中发现严重问题：
1. 保留原项目代码作为备份
2. 使用Git版本控制，可随时回退
3. 分阶段实施，每阶段测试通过后再进行下一阶段
## 十二、总结
本计划详细描述了如何从现有项目中提取TX/RX核心功能，删除所有UI相关代码，并实现：
1. **纯RF433通信功能**：专注于无线收发核心逻辑
2. **配置文件支持**：从Flash读取配置，无需菜单设置
3. **LED状态指示**：使用LED替代OLED显示
4. **手动API接口**：保留外部触发的灵活性
5. **编译模式选择**：支持TX/RX/双模三种编译模式
实施完成后，将得到一个精简、高效、易于集成的RF433通信模块，Flash占用减少约30KB（去除UI库），RAM占用减少约5KB，更适合嵌入式产品应用。