f5902bcc21
两篇规划期文档改成对当前系统的描述,档名统一去掉"设计说明"的"说明"。 运行与自检记录: - 旧档重写为现状版(10 节:概览 / 记录布局 / 写入路径 / 读取与呈现 / 事件分类 / 控制台日志 / 双端差异 / 内存 / 异常恢复 / 自测要点), 删掉需求表、调研摘要、模块清单动作列、实施步骤与开放问题。 - 按代码纠正:七类记录齐备(原文只写了两类)、自检描述串换成实际 落盘的 28 条、待机阈值以 ui_tokens.h 为准、记录页已走 ui_w_records 共享组件、容量满只删该文件而非整卷清空。 - 待机屏移出本篇:它不属于日志,归 UI 侧;内容页架构补"待机屏 (覆盖层)"一节,产品需求 FR-LOG-3 拆成单纯的上电/重启分类, 待机显示归口已有的 FR-UI-3。 ADC 采样节拍: - §4.5 从 45 行压到 24 行,只留规则 / 违反的代价 / 为什么 / 兜底与 档案指针;九路置换实测表、A/B 对照、探针计数等取证归 ADC_Trap_Records.md 的 TRAP-ADC-01(那里已有完整档案)。 - adc1_gap 字段去掉"2026-10-21 起、此前固件为次数"的修订记录式括号。 - app_main.c 的注释改为指向 TRAP-ADC-01 取证、§4.5 设计口径。 引用同步:两个旧档名全仓替换(含代码注释、角色档、归档 id 表), 旧名残留 0;对 ADC 篇的 § 引用逐条复核落在真实章节上。 验证:48 个提交期钩子全通过,check_doc_links --sections-strict 通过。
Inc/ — CubeMX 生成的头文件
⚠️ 本目录文件由 STM32CubeMX 生成(
.ioc重生成会覆盖),不是自研代码。 允许在USER CODE BEGIN/END标记区之间写自定义内容。
文件一览
| 文件 | 生成 | 作用 |
|---|---|---|
main.h |
CubeMX | 主头文件:引脚宏定义(xxx_Pin / xxx_GPIO_Port) |
FreeRTOSConfig.h |
CubeMX | FreeRTOS 内核配置(堆大小、tick、优先级位数等) |
stm32f4xx_hal_conf.h |
CubeMX | HAL 模块裁剪开关(启用/禁用各外设 HAL 模块) |
stm32f4xx_it.h |
CubeMX | 中断服务函数声明 |
gpio.h / dma.h / spi.h / i2c.h / usart.h |
CubeMX | 各外设初始化函数声明 |
⚠️ 修改约定
- 自定义内容只写
USER CODE BEGIN xxx/USER CODE END xxx标记区之间 - 引脚宏(如
CH395F_CS_Pin)在main.h中定义,改引脚须在 CubeMX 中改后重新生成
关键配置速查
| 配置 | 值 | 位置 |
|---|---|---|
| FreeRTOS 堆 | configTOTAL_HEAP_SIZE(已迁 CCM) |
FreeRTOSConfig.h |
| 栈溢出检查 | configCHECK_FOR_STACK_OVERFLOW = 2 |
FreeRTOSConfig.h |
| HAL 时基 | TIM7(HAL_TIMEBASE 覆盖) |
stm32f4xx_hal_conf.h + Src/ |
| NVIC 分组 | 4 位优先级 | CubeMX 配置 |
相关文档
- 内存/堆预算:
docs/内存管理/RAM使用分析与优化方案.md - 硬件引脚:根
README.md「外设接口」表