7da5c7b74c
问题一(安全级):绑定真实参数源后,Type203 走 SN=1..4 的预置与固化会回 COT=7 肯定确认,但 parameter_apply 一次都没被调用 —— 区域 1..4 的分段项在 mapped() 里凑不出 changes[],commit_stage() 的 n==0 让 apply 被跳过,而 values[] 与 parameter_commits 照旧更新,回读也返回出厂镜像冒充当前值。 主站看到"改成功",保护定值一个字没动。 修法:remote_action() 在绑定真实源后对 SN!=0 一律否定确认;remote_lookup() 对 SN!=0 的读返回错误而不是镜像;READ_AREA 绑定后只报区域 0;提交计数移到 真调过 apply 之后。未绑定模拟面保留 0..4 与原有语义,模拟器不受影响。 新增 preset_to_prot_set_test:真实 TCP 夹具 + 手写线上字节,链接 iec104_core/iec104_source/iec104_dtu_table/prot_set,钉住五条契约。四个 变异体(删入口守卫、计数移回无条件、删读侧守卫、READ_AREA 恒报 4)分别 红在对应断言上,证明用例不是为变绿而放松。 问题二:prot_set 的 g_prot_set_meta[].comm_addr 是与语义桥表冲突的错误 第二真源,17 项里 13 项地址指向完全不同的点表语义(如 0x8842 过流一段 定值被标成检同期压差闭锁定值),另有 10 项地址在点表里根本不存在。产品 代码零引用,但 adc_cal.h 已把它当"变比的家"引用,等于给错表盖章。 修法:删除 comm_addr 字段与全部地址注释,元数据表改 4 字段;协议地址的 唯一真源是 iec104_dtu_table.c 的 17 项语义桥表。同步改 check_setview_limits 的 meta 解析、两处单测与四篇活文档。armcc 实测 .constdata 640 B 不变。 验证:Keil 0 错误 0 警告(Code=365,928 / RO=45,764 / RW=2,752 / ZI=168,392,RW_IRAM1=113,720 B / 86.76%);transport 11/11、真实 TCP 验收 13/13、prot_set 173/173、prot_elm 60/60、prot_dim 44/44、 prot_set_store 16/16、adc_cal 150/150、iec104_serv 60/60、iec104_dtu 7/7;check_setview_limits 40/40/40 OK;模拟器构建 OK;pre-commit RC=0。
App/ — 应用层
自研代码(非 CubeMX 生成、非第三方库)。本目录是项目的应用层:任务编排、业务逻辑、 日志与配置引擎、工具函数。所有文件遵循
docs/代码规范/嵌入式C语言代码规范_V1.0.md。
职责
Src/main.c(CubeMX 初始化)→ app_main_init(本目录 app/app_main.c)→ osKernelStart →
6 个 FreeRTOS 任务(见 task/)。osKernelStart 之前全是内核启动前代码,禁止调用任何
FreeRTOS/CMSIS-RTOS API(本条与「就绪屏障位必须 osFlagsNoClear」的理由 → docs/子系统设计/控制台单写者日志设计.md §2.5 与 docs/架构设计/项目启动顺序管理.md)。
目录结构(按职责分层)
| 目录 | 内容 | README |
|---|---|---|
app/ |
应用入口与全局:app_main.c/h(初始化入口)、app_cfg.h(裁剪决策占位说明,当前无宏)、sys_events.h(就绪事件) |
app/README.md |
cfg/ |
配置引擎:/config.ini 解析 + 原子持久化(旧二进制档已废弃,2026-10-10) |
cfg/README.md |
sync/ |
时间同步任务:time_sync.c/h |
sync/README.md |
algo/ |
采集与算法层:语义取数 + 有效性判定 + 采样环/相量/测频 + 定值模型 + 保护元件框架 | algo/README.md(索引);设计 → docs/算法/采集与算法层设计说明.md |
log/ |
日志子系统:syslog(NAND)+ 控制台单写者日志 | log/README.md |
task/ |
FreeRTOS 任务实现(6 个任务) | task/README.md |
util/ |
通用工具:CRC / 环形缓冲 / 墙钟时间 | util/README.md |
iec60870/ |
通信协议:IEC 60870-5-104,只维护一个实现——common/ 编解码 + 104/ 协议与平台适配(core/source/net_mcu/dtu_table/comm 同目录) |
iec60870/README.md(目录说明与设计约束);结构见本文末节 |
关键约束
- 配置引擎单任务收敛:
cfg/为静态态、属主是 defaultTask;UI 保存请求经SYS_EVT_CFG_SAVE事件唤醒,netTask/uiTask 不得直接触碰配置引擎 - syslog 唯一写者:
/log/*只由 defaultTask 写入 - 新增任务/缓冲/栈前必须先核算 RAM 余量(
docs/内存管理/)
通信协议:iec60870/ 结构
104 只维护一个实现。2026-11-18 由 App/protocol/ 迁入(该中间层目录已删除),同日把
原独立的 104_port/ 适配层并入 104/,此后不再有「协议核心」与「适配层」两个平行目录:
| 子目录 | 内容 |
|---|---|
common/ |
ASDU / 信息对象 / 时间编解码与从站主体(与 101 等其它 60870 协议共用) |
104/ |
APCI 传输(Link / Connection / TcpServer / SendManager / AsduQueue)+ 业务状态机(104/business/)+ 平台适配与装配(iec104_core / iec104_source / iec104_net_mcu / iec104_dtu_table / iec104_comm)+ DTU 点表 profile(iec104_dtu_profile.h) |
改动口径:全部按项目自有代码对待(命名、注释、结构遵循 docs/代码规范/);
iec104_* 是本项目自己的装配与平台层,IEC104_* / IEC60870_* 是协议主体与共享编解码。
设计入口 → docs/iec60870/板端落地/IEC104上行设计说明.md;目录说明与改动纪律 → iec60870/README.md。
相关文档
- 架构全景:
docs/架构设计/项目架构总览.md - 启动顺序:
docs/架构设计/项目启动顺序管理.md - 配置引擎:
docs/子系统设计/配置文件设计.md - 日志:
docs/子系统设计/控制台单写者日志设计.md、docs/子系统设计/运行与自检记录设计.md