STM32F4-Base

wandering1/STM32F4-Base

Fork 0

Commit Graph

Author	SHA1	Message	Date
wandering1	67d26ac37a	修正 CubeMX 重生成防丢失机制：审计脚本实测有效，恢复 5 处被覆盖定制第二次重生成验证了审计机制，并证伪了上一轮的一处假设： - 审计脚本 check_cubemx_survival.py 准确检出全部 5 处覆盖（16 项中 5 FAIL），机制有效；Src/main.c 复位原因锁存（USER CODE BEGIN Init 区）完好，是"USER CODE 区有效"的正向证据。 - 关键发现：CubeMX 本次换了一代中断函数模板（旧 HardFault_Handler / HardFault_Report 自造区 → 新函数体内 HardFault_IRQn 0 / W1_HardFault_IRQn 0）， "生成区之外的自造标记区"同样不被保留，旧假设被证伪。恢复方案（第二次升级）： - stm32f4xx_it.c：报告实现迁入 USER CODE BEGIN 0（区名从未变过的标准保护位）； Handler 本体改为生成区整函数替换，用 #define HardFault_Handler HardFault_Handler_Gen 把生成实体改名保留，链接器自动移除（.map 实证 Removing ... (2 bytes)），向量表指向手工 __asm 版（0x080001a1，18 字节）。 - iwdg.c：去掉 HAL_IWDG_Init() 调用，补 IWDG-DEFER-START-ANCHOR 锚点注释。 - FreeRTOSConfig.h：恢复 FREE_RTOS_CONFIG_HARDENING 块（两个加固宏）。 - freertos.c：补回两处任务栈中文注释（栈值未丢，.ioc 已同步）。配套： - check_cubemx_survival.py：hardfault-handler 改 wholefile + 锚点检查； UNPROTECTED_LEGACY 清单更新。 - AGENTS.md：新增"CubeMX 换模板"与"ARMCC 内联汇编语法"两条铁律，以及"uvprojx 被 Keil 自动改写不入库"条目。 - 看门狗设计说明.md：§10.1 补第二次重生成验证结论与模板换代发现， §10.2 L2/L3 全面改写（自造区名不可依赖）。验证：@build 0 错误 0 警告；pre-commit 13 钩子全通过；审计 16 通过 / 2 警告 / 0 失败。	2026-09-29 07:52:39 +08:00
wandering1	7a18d2ce28	加 CubeMX 重生成存活审计：防标记区外定制被静默覆盖背景：.ioc 的 KeepUserCode 只保护 USER CODE 标记区，标记之外的手工改动重生成即被覆盖，且多数不报编译错（2026-09-29 实测一次覆盖 4 处，含 HardFault_Handler 崩溃采集被打回空 while(1)、两个 FreeRTOS 加固宏被删）。新增 scripts/check_cubemx_survival.py： - 16 项易失清单（IWDG 延后启动 / 崩溃采集 / 栈溢出检测 / 堆失败钩子 / 断言改造 / 看门狗模块与工程挂载 / 复位原因锁存 / HAL 驱动与使能 / .ioc 关键项），断言前剥掉 C 注释防误报 - 哈希基线漂移检测（.cubemx_survival_baseline.json），--write 重建 - 标记区外存量以 WARN 提示（3 个 Fault 处理函数、栈注释）已挂 pre-commit cubemx-survival 钩子（改动 .ioc / Src / Inc / task_watchdog / .uvprojx 时触发）。文档：看门狗设计说明 §10.2 新增"重生成不丢的三层手段"方法论（L1 写 .ioc > L2 搬进 USER CODE 区（可自造标记区）> L3 审计兜底）及 .ioc / USER CODE 区可用位置 / 存量清单三张对照表；AGENTS.md 平台约束新增该规则；pre-commit 使用说明 §2.12 新增钩子详解。门禁：build 0 错误 0 警告；pre-commit 全通过。	2026-09-29 07:30:00 +08:00

Author

SHA1

Message

Date

wandering1

67d26ac37a

修正 CubeMX 重生成防丢失机制：审计脚本实测有效，恢复 5 处被覆盖定制

第二次重生成验证了审计机制，并证伪了上一轮的一处假设：

- 审计脚本 check_cubemx_survival.py 准确检出全部 5 处覆盖（16 项中 5 FAIL），
  机制有效；Src/main.c 复位原因锁存（USER CODE BEGIN Init 区）完好，
  是"USER CODE 区有效"的正向证据。
- 关键发现：CubeMX 本次换了一代中断函数模板（旧 HardFault_Handler /
  HardFault_Report 自造区 → 新函数体内 HardFault_IRQn 0 / W1_HardFault_IRQn 0），
  "生成区之外的自造标记区"同样不被保留，旧假设被证伪。

恢复方案（第二次升级）：

- stm32f4xx_it.c：报告实现迁入 USER CODE BEGIN 0（区名从未变过的标准保护位）；
  Handler 本体改为生成区整函数替换，用 #define HardFault_Handler
  HardFault_Handler_Gen 把生成实体改名保留，链接器自动移除（.map 实证
  Removing ... (2 bytes)），向量表指向手工 __asm 版（0x080001a1，18 字节）。
- iwdg.c：去掉 HAL_IWDG_Init() 调用，补 IWDG-DEFER-START-ANCHOR 锚点注释。
- FreeRTOSConfig.h：恢复 FREE_RTOS_CONFIG_HARDENING 块（两个加固宏）。
- freertos.c：补回两处任务栈中文注释（栈值未丢，.ioc 已同步）。

配套：

- check_cubemx_survival.py：hardfault-handler 改 wholefile + 锚点检查；
  UNPROTECTED_LEGACY 清单更新。
- AGENTS.md：新增"CubeMX 换模板"与"ARMCC 内联汇编语法"两条铁律，
  以及"uvprojx 被 Keil 自动改写不入库"条目。
- 看门狗设计说明.md：§10.1 补第二次重生成验证结论与模板换代发现，
  §10.2 L2/L3 全面改写（自造区名不可依赖）。

验证：@build 0 错误 0 警告；pre-commit 13 钩子全通过；审计 16 通过 / 2 警告 / 0 失败。

2026-09-29 07:52:39 +08:00

wandering1

7a18d2ce28

加 CubeMX 重生成存活审计：防标记区外定制被静默覆盖

背景：.ioc 的 KeepUserCode 只保护 USER CODE 标记区，标记之外的手工改动
重生成即被覆盖，且多数不报编译错（2026-09-29 实测一次覆盖 4 处，含
HardFault_Handler 崩溃采集被打回空 while(1)、两个 FreeRTOS 加固宏被删）。

新增 scripts/check_cubemx_survival.py：
- 16 项易失清单（IWDG 延后启动 / 崩溃采集 / 栈溢出检测 / 堆失败钩子 /
  断言改造 / 看门狗模块与工程挂载 / 复位原因锁存 / HAL 驱动与使能 /
  .ioc 关键项），断言前剥掉 C 注释防误报
- 哈希基线漂移检测（.cubemx_survival_baseline.json），--write 重建
- 标记区外存量以 WARN 提示（3 个 Fault 处理函数、栈注释）

已挂 pre-commit cubemx-survival 钩子（改动 .ioc / Src / Inc /
task_watchdog / .uvprojx 时触发）。

文档：看门狗设计说明 §10.2 新增"重生成不丢的三层手段"方法论
（L1 写 .ioc > L2 搬进 USER CODE 区（可自造标记区）> L3 审计兜底）
及 .ioc / USER CODE 区可用位置 / 存量清单三张对照表；AGENTS.md 平台约束
新增该规则；pre-commit 使用说明 §2.12 新增钩子详解。

门禁：build 0 错误 0 警告；pre-commit 全通过。

2026-09-29 07:30:00 +08:00

2 Commits