Files
STM32F4-Base/Drivers/BSP/NETCFG/README.md
T
wandering1 39bd06adea 为自建代码目录补齐 README,建立目录级导航体系
- 新增 26 份目录 README:App/(+log,task,util,protocol)、Drivers/BSP/(+8子系统)、
  Src/、Inc/、scripts/、tools/(+6子工具)、test/、MDK-ARM/、simulator/(+sim,tests)
- 每份含:定位、文件清单表、关键约束/陷阱、指向 docs 权威文档
- 第三方库与生成代码目录排除(CMSIS/HAL/Middlewares/Lib/SDL2)
- docs/文档规范.md 新增 §1.1b 代码目录 README 约定;根 README 目录结构加入说明
2026-09-26 12:25:36 +08:00

1.5 KiB
Raw Blame History

Drivers/BSP/NETCFG/ — 网络配置

网络参数的加载 / 保存 / 旧档迁移(IP、掩码、网关等)。 本模块是网络配置的持久化层,与 App/cfg_file.c(配置引擎)配合工作。

文件一览

文件 作用
net_cfg.c/h 网络配置加载(net_cfg_load)/ 保存(net_cfg_save_run)+ RAM 副本管理
net_cfg_legacy.c/h 旧版配置档迁移(首启时把旧格式转换为当前格式)

工作流

defaultTask:net_cfg_load(含旧档迁移)→ 置 STORAGE_READY
    ↓ (网络配置在屏障前已加载)
netTask:只读 RAM 副本 → net_stack_bring_up(不在 netTask 里读盘)
    ↓
UI 改配置 → SYS_EVT_CFG_SAVE 事件 → defaultTask 执行 net_cfg_save_run + cfg_file_poll
    ↓
netTask 消费 SYS_EVT_NET_RECONFIG → 立即重建网络(新 IP 免重启生效)

⚠️ 约束

  • 网络配置在 STORAGE_READY 屏障之前由 defaultTask 加载完毕,netTask 只读 RAM 副本
  • UI 保存请求经 SYS_EVT_CFG_SAVE 事件交由 defaultTask(配置引擎属主)执行, netTask/uiTask 不得直接触碰配置引擎(cfg_file 是静态态、单任务收敛)
  • 网络代次号(generation)用于各 TCP 服务判断是否需重建监听

相关文档

  • docs/子系统设计/网络配置说明.md — 网口设置页与即时生效机制
  • docs/子系统设计/配置文件设计说明.md — 配置引擎
  • docs/架构设计/项目启动顺序管理.md — 就绪屏障