zhunk 3 veckor sedan
förälder
incheckning
cf00bdd267

+ 61 - 0
CBD_FOTA_BootLoader/.workbuddy/memory/2026-10-08.md

@@ -0,0 +1,61 @@
+# 2026-10-08 工作日志
+
+## BootLoader 代码审计(只读静态分析,未改动任何源码)
+- 对 CBD_FOTA_BootLoader(APM32F103 / RT-Thread 4.0.2 / BL_VERSION 1.2.5)完成漏洞与代码质量审计。
+- 产出报告:工程根目录 `代码审计报告_CBD_FOTA_BootLoader_2026-10-08.md`(P0×3 / P1×4 / P2×4 / P3×16)。
+- 核心结论:
+  1. main.c:328-329 HMI 串口 rx_buffer[256] 溢出(msg.size 可达 ~1023,为环形缓冲累计未读长度)→ BSS 破坏,P0。
+  2. rt_fota.c:641/671/702 升级包 block_size 未校验 → 堆越界读写,P0。
+  3. quicklz qlz_decompress 输出长度由流头自报(dsiz)无上限 → 堆溢出,P0(fastlz 有 FASTLZ_SAFE,反例)。
+  4. 升级包无签名 + AES 密钥硬编码(sys_config.h:30 / rt_fota.c:62)+ ymodem/HMI 命令无鉴权 → 完整攻击链。
+  5. 跳转 APP 未 __enable_irq、NVIC 清理被注释、未设 VTOR(依赖 APP 侧 board.c:464 兜底)。
+  6. drv_flash_f1.c 擦除路径(:153)缺 APM32 要求的"解锁前关中断"(写路径 :95 有)。
+  7. stop_in_bootloader 默认值字符串 "0"(0x30) 与二进制读写语义不一致 → 出厂设备被强制留引导模式。
+  8. main.c erasedf_area 仍是 16MB 时代旧偏移 15729152 + fal_erase.len 未初始化。
+- 需上机验证:IWDG(10s±LSI漂移) 与 312KB 擦除(6~12.5s) 余量、擦除路径关中断缺失的实际影响。
+- 审计时基线:源文件 mtime 2026-10-07 23:35(用户可能仍在编辑,行号以该版本为准)。
+- 备注:用户要求"不改代码",因此未动任何源码,也未动 readme.md。
+
+## 第一批修复执行完成(P0-1 / P0-2 / P0-3),版本 1.2.6
+- 用户指示:"执行第一批修复,每次修改代码要变更版本号(和)readme"。
+- 代码改动(git diff:+56 行,纯新增,无删除):
+  - main.c Hmi_thread_entry:读取前将 msg.size 钳位到 sizeof(rx_buffer)-1=255,读取后对 rx_length 再钳位,LOG_W 记录截断(P0-1)。
+  - rt_fota.c 升级循环 6 处新增校验(P0-2/P0-3):
+    ① Site A(block_hdr_pos>=2048 主分支)② 跨缓冲分支容量校验 ③ 跨缓冲第二段读取量校验
+    ④ hdr_tmp 补齐分支校验 ⑤⑥ 两处 qlz_decompress 前 qlz_size_decompressed()<=4096 预校验。
+  - 校验失败统一 fota_err=RT_FOTA_GENERAL_ERR; goto __exit_upgrade(升级失败但保留原 APP,不破坏设备)。
+- 版本:sys_config.h RT_FOTA_SW_VERSION "1.2.5"→"1.2.6";main.c COMPILE "20260713"→"20261008";readme.md 顶部新增 2026-10-08 版本说明。
+- 备份:.workbuddy/memory/backup_20261008_135412/{rt_fota.c.bak,main.c.bak}。
+- 编译验证:CLI 全量重建 143 条命令全部成功(GCC 6.3.1,21.7s);产物 Debug/rtthread.bin = 165568 B(text 163436/data 2132/bss 8568),<200KB bl 分区。
+- 构建告警(均为预存在,非本次引入):fastlz.c 的 rt_malloc/rt_free implicit declaration;fal_def.h assert `return 1` 的指针转换告警(对应审计 P3-7);rt_fota.c:951 HMI_WRITE implicit declaration(rt_fota.c 未声明 extern,建议下次补一行)。
+- 构建方法沉淀:见 rtthread-studio-cli-build 技能新增的"Python 直编法"(make -n 出命令清单 → Python subprocess 逐条用 6.3.1 执行,规避 PATH/工具链错配坑)。
+- 未动:审计报告(保持时点文档原貌);代码改动未提交 git。
+
+## 第二批修复:RTC_BKP_DR2 升级请求 → ymodem_ota(v1.2.7)
+- 需求(用户):读取 RTC_BKP_DR2,若为 0x5AA5 则停留 bootloader,然后执行 ymodem_ota。
+- 跨工程背景:APP 侧(Application_CBD)已实现 JSONRPC "update" 指令 → 写 BKP_DR2=0x5AA5 + 复位(dtu_uart2.c:2036-2048,__HAL_RCC_PWR/BKP_CLK_ENABLE + HAL_PWR_EnableBkUpAccess + *(__IO uint16_t*)(BKP_BASE+4*2));APP main.c:43-52 启动时读并清除该 boot_flag。bootloader 侧检测为本次补齐的一环。
+- 实现(rt_fota.c,本次 +43 行):
+  - 新增 rt_fota_check_ymodem_request()(放在 rt_fota_thread_entry 之前):使能 PWR/BKP 时钟 + DBP 解锁 → 读 *(__IO uint16_t *)(BKP_BASE + 4*2);==RT_FOTA_YMODEM_REQ_BKP_MAGIC(0x5AA5) 时**读取即清**(防 ymodem 复位后循环进入)并返回 RT_EOK。
+  - rt_fota_thread_entry 中(boot_verify 之后、Shell 初始化之前):命中 → led_upgrade_mode + ymodem_ota(1, RT_NULL)(默认下载分区 fm_area;内部完成后复位、正常不返回)。
+  - 另补 extern void HMI_WRITE(char *fmt,...); 消除 rt_fota.c 隐式声明编译告警(第二批候选之一)。
+- 版本:sys_config.h 1.2.6→**1.2.7**;readme 顶部新增"版本说明 2026-10-08(第二次)"。
+- 编译(增量,.d 依赖跟踪生效):6 条命令(ymodem_ota.o/main.o/rt_fota.o + 链接 + objcopy + size)全部成功、重编零告警;rtthread.bin **165940B**(+372B),text 163808/data 2132/bss 8568;固件内含 "RTC_BKP_DR2 = 0x5AA5" 与 "1.2.7" 字符串(grep -a 验证)。
+- 备份:backup_20261008_144903_batch2/{rt_fota.c,sys_config.h,readme.md}.bak。
+- 完整链路:APP(JSONRPC update) 写 DR2→复位 → bootloader 检测→清标志→ ymodem(uart2,115200) 收 RBL 包写 fm_area → 复位 → bootloader 校验 fm_area 并搬运到 app → 启动新固件。ymodem 失败时复位回正常启动(标志已清、自愈);平台可重发 update 指令重试。
+## 第二批(剩余四项)完成:v1.2.8
+- P1-2 rt_fota.c 跳转序列规范化:禁/清全部 NVIC(用寄存器遍历替代原注释循环——F1 无 FPU_IRQn)、清 PendSV/SysTick 挂起、停 SysTick、HAL_DeInit×2+RCC_DeInit、SCB->VTOR=app_addr+DSB/ISB、__set_MSP → __set_CONTROL(0) → __enable_irq → 跳转。反汇编逐条核对通过:CONTROL 切换后仅剩全局/绝对访问(此前实现依赖 r7 帧指针寻址"侥幸可用",现已与优化等级无关)。
+- P1-4 drv_flash_f1.c:stm32_flash_erase_bank 重写为分块擦除(每块 ≤ FLASH_ERASE_CHUNK_PAGES=16 页),每块内 __disable_irq + HAL_FLASH_Unlock → Erase → Lock + __enable_irq;同时满足 APM32"解锁前关中断"与 IWDG 喂狗(避免 312KB 整片关中断 6~12s 触发复位)。
+- P2-1 rt_fota.c:stop_in_bootloader 读取改为先取 4 字节再归一化,兼容字符串 "0"/"1"(0x30/0x31,EasyFlash 默认值)与二进制 0/1;修复新设备默认值 "0" 按二进制读为 0x30(非零)被误判为停留引导模式的缺陷。
+- P2-2 main.c:eraseapp / erasedf_area 改用 fal_partition_find 获取真实分区对象(修正 erasedf_area 旧 16MB 偏移 15729152 与 fal_erase.len 未初始化),并增加执行结果打印。
+- 版本 1.2.8(sys_config.h)+ readme「版本说明 2026-10-08(第三次)」。
+- 编译:增量 7 条命令(rt_fota.o/main.o/drv_flash_f1.o/ymodem_ota.o + 链接 + objcopy + size)全成功、零告警;bin 166468B(+528B);grep -a 确认 "eraseapp done"/"erasedf_area done"/"1.2.8"/"RTC_BKP_DR2 = 0x5AA5" 均在固件中。
+- 备份:backup_20261008_163326_batch2b/{rt_fota.c,main.c,drv_flash_f1.c,sys_config.h,readme.md}.bak。
+- 至此第二批全部完成(含早前的 RTC 升级入口与 HMI_WRITE extern)。
+
+## 第三批(部分):P2-4 Ymodem 完整性加固(v1.2.9)
+- 背景:发现 ymodem_ota.c 有用户 14:53 的未提交改动(成功后先切回 uart1 再打印成功信息)——已保留并在本版一并编译(readme 第四次条目第 2 点注明"既有改动,一并纳入")。
+- 改动 1(ymodem_on_begin):文件名结束符查找 + 大小解析全部限定在首包 len 内(用**手写循环**替代 rt_strlen/atol——minilibc 无 memchr/strnlen,链接表已核实均无);无效首包 RYM_CODE_CAN;"大小 > 分区"检查扩展为拒绝 0。
+- 改动 2(ymodem_on_data):收满首包声明长度后拒收后续数据包(RYM_CODE_CAN),防超发写入未擦除区。关键语义:rym 回调 len=**整块**(128/1024,含 0x1A 填充),故用"cur >= total 才拦"而非"cur+len > total",避免误伤末包填充(正常流程末包写完后不再有数据包)。
+- 版本 1.2.9 + readme「版本说明 2026-10-08(第四次)」;编译增量 6 条命令全成功、0 告警;bin 166788B(+320B),固件内含 "Data overrun"/"Invalid file name in handshake"/"1.2.9"。
+- 备份:backup_20261008_163838_batch3/。
+- 第三批剩余:P1-1(升级包签名/鉴权——需方案决策:HMAC-SHA256 / ECDSA / 暂缓;且需固件打包工具配合,已向用户列出选项);P1-3(IWDG 余量上机实测——需硬件,无法在 CLI 完成)。

+ 58 - 0
CBD_FOTA_BootLoader/.workbuddy/memory/2026-10-13.md

@@ -0,0 +1,58 @@
+# 2026-10-13 工作日志
+
+## v1.3.0 升级失败自动回滚机制(第四批)
+
+用户需求(4 条):
+1. 升级可用时,搬运前备份 app 固件到 df_area
+2. app 启动后清 RTC_BKP_DR2=0(查证:Application_CBD/applications/main.c:44-52 已实现,无需改动)
+3. bootloader 检测 DR2 非 0 → 标记 0xDEAD + 从 df_area 备份回滚 app
+4. uart4 收到 dbg_restore → 从 df_area 备份恢复到 app
+
+改动文件(4 个):
+- `applications/sys_config.h`:RT_FOTA_SW_VERSION 1.2.9 → 1.3.0
+- `applications/rt_fota.h`:导出 rt_fota_backup_app_to_df / rt_fota_restore_app_from_df(int)
+- `applications/rt_fota.c`:
+  - 文件头 v1.3.0 区块:DR2 常量(0x5AA5/0xDEAD)、备份格式(4KB 头 magic "FBK1" + len + data CRC32 + head CRC32)、rt_fota_backup_head_t、bkp 读/写 helper(check_ymodem_request 已重构复用)
+  - 新增 `rt_fota_backup_app_to_df()`(失效旧头→读 app 算 CRC→擦数据区→回写→写头;失败不阻断升级)
+  - 新增 `rt_fota_restore_app_from_df(consume_backup)`(头校验→数据 CRC→擦 app→回写→可选消费)
+  - 新增 `rt_fota_check_boot_state()`(线程入口 shell 前调用;失败→0xDEAD→回滚→copy_version 对齐 fm_area)
+  - `rt_fota_start_application()`:向量表/栈校验通过后写 0xDEAD
+  - `rt_fota_thread_entry()`:ymodem 检测后调 check_boot_state;升级搬运前调 backup
+- `applications/main.c`:COMPILE "20261013";resetapp 改走校验恢复;backupapp 填充;新增 dbg_restore
+
+关键设计决策(追溯用):
+- DR2 三值语义:0=启动成功 / 0x5AA5=升级请求 / 0xDEAD=启动尝试标记
+- 备份写入顺序(头最后写)保证任意掉电点不残留"半新半旧有效备份"
+- 回滚后对齐 fm_area 版本 → 防"同一包回滚后再次自动应用"死循环
+- 自动回滚消费备份(擦头)→ 防"恢复-崩溃"循环磨损 onchip flash;手动命令不消费(可重复调试)
+- resetapp 原裸搬运会把 4KB 备份头搬进 app(写坏),故统一走校验恢复路径;裸搬运替代 = shell `fota clone`
+- df_area 原 RBL"默认固件兜底"路径自然失效(校验不过跳过),行为无害
+- 无电池冷启动 DR2 可能随机非 0 → 触发一次回滚尝试(readme 已注明边界与收紧方案)
+
+编译验证:
+- 全量重编 147 条命令 0 失败、新增代码 0 告警(仅剩 fastlz / fal_def.h 历史已知告警)
+- text 167288 / data 2132 / bss 8560 / bin 169420B(v1.2.9 基线 166788B,+2632B)
+- 构建脚本:`D:\RT-ThreadStudio\workspace\.bl_src_backups\build_bl.py`(bootloader 版)
+
+备份与脚本(均工程外):
+- `D:\RT-ThreadStudio\workspace\.bl_src_backups\backup_20261013_145135_batch4`(4 个源文件)
+- patch_v130.py / update_readme.py / touch_all.py / build_bl.py
+
+待办(需上机):
+- 回滚全链路:升级→备份→跳转→模拟启动失败→复位→自动回滚→旧固件启动、备份消费
+- dbg_restore / backupapp 手动命令
+- 长擦写(备份~NOR 312KB / 恢复~onchip 312KB)IWDG(syswatch 60+15s) 余量复测
+- 无电池冷启动随机 DR2 边界行为
+
+## v1.3.1 dr2 msh 命令(第五批)
+
+用户需求:msh 增加设置 DR2=0 的指令——手动进入 bootloader(停留维护)后重新上电,DR2 残留非 0(如启动失败检测写入的 0xDEAD)会被 rt_fota_check_boot_state() 误判为"APP 未正常启动"而误触发 df_area→app 回滚,需要手动清除手段。
+
+实现:
+- `rt_fota.c` 末尾追加 msh 命令 `dr2`:无参 → 查看值并标注语义(0 正常 / 0x5AA5 升级请求 / 0xDEAD 启动失败标记 / 其它未知);`dr2 0` → 清 0;`dr2 <val>` → 写入(调试:0xDEAD 验回滚 / 0x5AA5 验 ymodem);非法参数打印 usage;写入后回读打印确认
+- `sys_config.h`:RT_FOTA_SW_VERSION 1.3.0 → 1.3.1(COMPILE 20261013 不变)
+- `readme.md`:新增"版本说明 2026-10-13(第六次)"
+
+编译验证:全量重编 147 条命令 0 失败、新增代码 0 告警(仅 fastlz / fal_def.h 历史告警);text 167884 / data 2132 / bss 8560 / bin 170016B(v1.3.0 基线 169420B,+596B)
+
+备份:`.bl_src_backups/backup_20261013_152514_batch5`(rt_fota.c / sys_config.h / readme.md)+ patch_v131.py

Filskillnaden har hållts tillbaka eftersom den är för stor
+ 32 - 0
CBD_FOTA_BootLoader/.workbuddy/memory/MEMORY.md


Filskillnaden har hållts tillbaka eftersom den är för stor
+ 240 - 0
CBD_FOTA_BootLoader/代码审计报告_CBD_FOTA_BootLoader_2026-10-08.md