|
|
||
|---|---|---|
| .. | ||
| .vscode | ||
| Drivers | ||
| HardWare | ||
| Inc | ||
| MDK-ARM | ||
| Src | ||
| m_app | ||
| README.md | ||
| keilkill.bat | ||
README.md
智能水产投料机 V1.0.3
工程概述
本工程基于 STM32F103RCT6 + STM32Cube HAL + Keil MDK,实现设备的控制、联网与投喂。
- BootLoader:
STM32F103_BootLoader/,负责 OTA 固件烧录、试运行计数与失败回滚 - 应用固件:
STM32F103_App1/,当前运行版本 V1.0.3
产品型号配置
同一套板子适配两种产品,编译前在 Inc/main.h 顶部通过一个宏二选一:
#define PRODUCT_WITH_FEED_SCALE 0
| 取值 | 产品 | 投喂行为 |
|---|---|---|
1 |
智能水产投料机(接 RS485 磅秤) | feeding 按 onceWt 定量自动投喂,带重量反增/超时保护;sw1 指令被忽略 |
0 |
基础四路继电器(不接磅秤) | feeding / sw1 直接开关投喂继电器 1,由平台侧自行计时 |
硬件接口
| 接口 | 用途 | 引脚 | 参数 |
|---|---|---|---|
| USART1 | 蓝牙串口调试 / 日志输出 | PA9/PA10 | 115200-8N1 |
| USART2 | RS485 喂料秤 | PA2/PA3 | 9600-8N1 |
| USART3 | 4G Air780E MQTT | PB10/PB11 | 921600-8N1(见下文波特率自适应) |
| Relay1 | 投喂电机控制 | PB7 | 高电平吸合 |
| Relay2~4 | 备用控制 | PB8/PC0/PC2 | 高电平吸合 |
| I2C(软件) | AT24C02 配置存储 | PA11/PA12 | 页写入 |
| SPI(软件) | W25Q64 外部 Flash | PB3/PB4/PA15/PB5 | OTA 固件暂存 |
| ADC1 | 电池电压检测 | PA0 | 低电量上报 pow:0 |
| PA8 | 手动模式检测 | PA8 | 高电平=手动模式 |
| PC13 | LED2 心跳 / TPL5010 喂狗 | PC13 | 每 1s 翻转(见下文看门狗) |
看门狗(双狗架构)
| 看门狗 | 超时 | 喂狗点 | 作用 |
|---|---|---|---|
| IWDG(片内独立看门狗) | ~26s(LSI 漂移下最短 ~17s) | APP 主循环、app_bg_service()(所有 AT/OTA 等待每 20ms 让出一次);BL 的擦除/拷贝循环 |
固件卡死 → 复位;BL 启动,OTA 试运行期计一次试错 |
| TPL5010(外置硬件狗) | 7 分钟 | PC13(LED2) 电平翻转:APP activeEvents() 每秒翻转;BL 进入时及长循环中翻转 |
MCU 完全失控(含 IWDG 失效)时的最后兜底 |
注意:LED2 同时承担运行指示和外部狗喂狗,修改 LED2 闪烁逻辑时必须保持周期性翻转,否则 7 分钟后整板复位。
4G 波特率自适应(115200 → 921600)
- Air780E 出厂/自适应模式只覆盖 9600~115200;921600 必须用
AT+IPR固定。 - APP 联网时永远先按 115200 探测(避免向自适应侦测窗口发送其他波特率的乱码):
- 通 → 发
AT+IPR=921600+AT&W固化,切换到 921600(日志出现baud -> 921600); - 不通(模块已固化 921600)→ 直接切 921600 连接。
- 通 → 发
- 切换由
USART3_SetBaudRate()运行中重写 BRR 完成,不影响 GPIO/DMA/NVIC。
OTA 升级
流程
平台下发 iot.ota.upgrade.post(url, crc16, ver)
→ APP: 模块硬复位 → HTTP HEAD 拿大小 → 擦 W25Q64 槽 B
→ 3072 字节/块分段下载(AT+HTTPPARA BREAK/BREAKEND + HTTPACTION + HTTPREAD)
→ 每块写 W25Q64 并回读校验,全程累计 CRC16
→ 整包 CRC + 栈顶/复位向量校验 → 可靠上报 result.post(等 OK + 重试)
→ 写 OTA 信息区(状态 DOWNLOADED) → 复位进 BootLoader
BootLoader:
→ 擦除备份槽 → 备份当前 APP1 到槽 A(失败则中止更新,留在旧版本)
→ 擦 APP1 → 写入新固件 → CRC + 向量校验 → 状态 INSTALLED → 跳转
新 APP 试运行:
→ MQTT 就绪 + 首次发布成功 + 3s → 上报 confirm.post
→ 确认标志写 W25Q64(回读验证 + 3 次重试)→ 版本号存 EEPROM
→ 下次启动 BL 清理 OTA 标志,升级完成
Flash 分区
内部 Flash(256KB):
| 区域 | 地址 | 大小 |
|---|---|---|
| BootLoader | 0x08000000 |
32KB |
| APP1 运行区 | 0x08008000 |
224KB |
W25Q64 外部 Flash(8MB):
| 区域 | 地址 | 用途 |
|---|---|---|
| 槽 A | 0x000000 (256KB) |
当前固件备份(回滚镜像) |
| 槽 B | 0x040000 (256KB) |
新固件下载暂存 |
| 信息区 A/B | 0x080000 / 0x081000 (各 4KB) |
OTA 状态双副本(magic + 序号 + checksum) |
健康检查与回退
新固件"健康" = 4G 附着 → MQTT 连接 → 首次发布成功。回退判据(3 次真实故障才回退):
- 看门狗复位(IWDG/WWDG,固件真的卡死)→ BL 计一次试错(读
RCC->CSR判别); - 健康超时(MQTT 就绪 1 分钟仍无首次发布)→ APP 复位前自行计一次;
- 上电/按键/普通软件复位不计次——现场断电、断网不会误触发回退;
- 试运行期间完全断网 → 不计次、不回退,持续等待网络恢复。
掉电/断网安全性
| 故障点 | 结果 |
|---|---|
| 下载中断网/掉电 | 信息区未更新,旧固件照常运行,平台可重推 |
| BL 备份阶段掉电 | backup_valid=0,重启后重新备份 |
| BL 擦写 APP1 中途掉电 | 状态 COPYING 视为 DOWNLOADED,重启后完整重做(备份不会被坏镜像覆盖) |
| 备份创建失败 | 中止更新,留在旧版本,下次重启重试 |
| 回退过程掉电 | 重启后重新执行回退拷贝 |
其他要点
- OTA 触发时先强制停止投喂(断开继电器 1)
- 下载期间蓝牙命令、秤轮询、LED 心跳、电量检测照常运行(
bg_delay切片让出),业务状态上报暂时屏蔽 - 分段接收按
+HTTPREAD: <len>声明长度收齐即处理,无静默等待;40KB 固件全程约 38 秒(含模块复位重连 ~15s)
主要功能
- MQTT 联网:Air780E 4G 模块,通过 MQTT 连接云平台
- 远程控制:平台下发开关
sw1/sw2/sw3/sw4、feeding指令(投料机模式下sw1被忽略,投喂只能走feeding) - 自动投喂(
PRODUCT_WITH_FEED_SCALE = 1):- 平台设置单次投喂量
onceWt - 平台下发
feeding=true启动投喂 - 继电器 1 吸合,RS485 秤实时读取重量
- 当重量减少 ≥
onceWt时自动停止,带重量反增与 10 分钟超时保护
- 平台设置单次投喂量
- 去皮/标定:平台设置
zero空载重量,设置后按最新原始重量重新计算剩余料重并立即上报 - OTA 升级:见上文专题
- 蓝牙调试:USART1 支持
RESET/INFO/STATUS/R1ON~R4OFF/ALLON/ALLOFF/OTA/RECOVERY/HELP等命令 - 掉电安全:继电器 2~4 联网后从 EEPROM 恢复上次状态;继电器 1 上电强制断开,防止误投料
平台数据字段
| 字段 | 含义 | 说明 |
|---|---|---|
ver |
固件版本号 | 每次状态上报携带,平台可据此识别设备是否发生回退 |
weight |
空载重量 | 平台显示为去皮重量 zero |
zero |
剩余料重 | 平台显示为当前剩余料重 |
onceWt |
单次投喂量 | 每次投喂目标重量 |
feeding / sw1 |
第一路继电器状态 | 1=投喂中,0=停止,两个标识符等效 |
sw2~sw4 |
备用继电器状态 | 0/1 |
pow |
电量状态 | 1=正常,0=低电量 |
下行报文由 m_app/proto.c 按键名定位解析("sw2" 不会误中 "sw21",其他字段里的 true/false 不会造成误判)。
串口调试命令
通过 USART1(蓝牙串口)发送:
RESET - 系统复位
INFO - 打印 MQTT 配置
STATUS - 打印继电器状态
R1ON - 打开继电器 1
R1OFF - 关闭继电器 1
R2ON/R2OFF ~ R4ON/R4OFF - 控制继电器 2~4
ALLON - 打开所有继电器
ALLOFF - 关闭所有继电器
OTA - 复位进入 BootLoader 检查升级
RECOVERY - 复位进入 BootLoader
HELP - 显示支持命令
代码分层(APP)
main.c 只保留三行初始化和主循环,逻辑全部下沉到模块:
int main(void)
{
SCB->VTOR = FLASH_BASE | Application_1_Addr;
Board_Init(); // 基础硬件:HAL/时钟/GPIO/DMA/UART/看门狗(SYSINIT/system.c)
app_init(); // 业务模块初始化(SYSINIT/app_loop.c)
app_loop_init();
while (1) {
IWDG_Feed();
app_loop_process(); // 业务调度(SYSINIT/app_loop.c)
}
}
目录结构
STM32F103_App1/
├── Src/
│ └── main.c # 仅 VTOR + Board_Init/app_init/主循环
├── Inc/
│ └── main.h # 产品型号宏 PRODUCT_WITH_FEED_SCALE、MQTT 默认配置
├── m_app/
│ ├── proto.c/h # 平台 JSON 报文取值工具(按键名定位)
│ └── ota_app.h # Flash 分区定义(BootLoader 32K + APP1 224K)
├── HardWare/
│ ├── USER_CMD/ # 蓝牙串口命令处理
│ ├── FEED_SCALE/ # RS485 喂料秤与定量投喂状态机
│ ├── RELAY/ # 继电器控制、反馈检测、平台指令执行
│ ├── NETWORK/ # 网络抽象层:状态上报/响应/发送互斥
│ ├── CAR/ # Air780E AT 驱动、波特率自适应、OTA 下载
│ ├── UART/ # USART1/2/3 初始化、运行中切波特率、中断/DMA 接收
│ ├── 24C02/ # EEPROM 读写(页写入)
│ ├── IIC/ # 软件 I2C
│ ├── ADC/ # 电池电压检测
│ ├── LED/ # 指示灯(LED2 兼任 TPL5010 喂狗)
│ ├── LOG/ # 分级日志(USART1 输出)
│ ├── SYSINIT/ # Board_Init/IWDG、app_init、主循环调度、后台任务切片
│ └── W25Q64/ # 外部 Flash 驱动与 OTA 双槽信息区
└── MDK-ARM/ # Keil 工程文件
STM32F103_BootLoader/
├── Src/main.c # 硬件初始化 + IWDG + 入口
├── m_app/ota_boot.c # OTA 状态机:备份/烧录/试运行计数/回退/跳转
├── HardWare/W25Q64/ # 外部 Flash 驱动(与 APP 共用设计)
├── HardWare/LOG/ # 分级日志(与 APP 相同)
└── MDK-ARM/ # Keil 工程文件
编译烧录
Keil GUI:
- 打开
MDK-ARM/STM32F103rb_App1.uvprojx(BootLoader 工程同理) - 按产品形态设置
Inc/main.h中的PRODUCT_WITH_FEED_SCALE - 编译下载(先烧 BootLoader 到
0x08000000,APP1 起始地址0x08008000) - 首次启动会自动把默认 MQTT 配置写入 AT24C02
命令行(CI/脚本可用):
# 编译(Keil 安装目录的 UV4,-r 全量 -b 增量,-o 输出日志)
/c/Keil_v5/UV4/UV4.exe -r -j0 STM32F103rb_App1.uvprojx -o build.txt
# 烧录(J-Link 命令脚本,工程 MDK-ARM 目录下有现成的 jlink_flash.jlink)
JLink.exe -CommanderScript jlink_flash.jlink
版本
- Version: 1.0.3
- Author: Helei