wandering1
c1e7e8c42c
L0 的 cppcheck 在 --all-files 下恒红四处，全在同一文件： App/protocol/iec104/iec104_comm.c 的 80 / 94 / 107 / 121 行，诊断为 compareValueOutOfTypeRangeError —— 拿 unsigned short 与 65535 比较， Condition is always false。根因是 IEC104_COMM_CA_MAX 与 PORT_MAX 都等于 65535u，而被比较的量是 uint16_t：那个上界判断在类型上就不可能成立。 这四处随上游 iec104_comm 落地进来，本地提交只跑暂存文件所以没人看见， CI 跑 --all-files 就每轮都红（同族盲区：暂存面与全量面不等价）。 处置走「语义不动」那一支（用户裁定 2026-10-27：A）：只删恒假的半边、 改判 if (v < MIN)，合法带口径一字未改（仍照 iec104_comm.h 的常量注释： ca 1..65535、port 1024..65535），只在第一处写清为何不再写上界、其余三处 短引用。没有把 MAX 改成 65534（按 60870-5-104 的 65535 = 未编址），因为 test/host/iec104/iec104_test.c:1521 明确断言 ca 设成 IEC104_COMM_CA_MAX 必须被接受——那会同时打断这条断言并改变现场设备行为（配 65535 的站会 突然回退工厂默认），属协议决定，不在本次范围；要改请单独裁。 验证：单文件 cppcheck 原样复刻钩子参数 → RC=0；cppcheck --all-files 由 红转绿；iec104-unit-test Passed（即 65535 那条合同照过）；@build 0 错误 0 警告（Code 231732→231720，减 12 B，RO/RW/ZI 不变）；凭证与两份台账 随之重盖（ER_IROM1 257,292→257,280、Flash 合计 258,812→258,800）； 本次触发的 13 根钩子全 Passed，含 test-coverage（删掉 4 行已覆盖代码 未被判成回退）。
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（见 AGENTS.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/ |
采集与算法层（L1/L2/L3）：语义取数 + 有效性判定 + 采样环/相量/测频 + 定值模型 + 保护元件框架 | algo/README.md（索引）；设计 → docs/算法/采集与算法层设计说明.md |
log/ |
日志子系统：syslog（NAND）+ 控制台单写者日志 | log/README.md |
task/ |
FreeRTOS 任务实现（6 个任务） | task/README.md |
util/ |
通用工具：CRC / 环形缓冲 / 墙钟时间 | util/README.md |
protocol/ |
通信协议（预留，当前为空） | protocol/README.md |
关键约束
- 配置引擎单任务收敛：
cfg/为静态态、属主是 defaultTask；UI 保存请求经SYS_EVT_CFG_SAVE事件唤醒，netTask/uiTask 不得直接触碰配置引擎 - syslog 唯一写者：
/log/*只由 defaultTask 写入 - 新增任务/缓冲/栈前必须先核算 RAM 余量（
docs/内存管理/）
相关文档
- 架构全景：
docs/架构设计/项目架构总览.md - 启动顺序：
docs/架构设计/项目启动顺序管理.md - 配置引擎：
docs/子系统设计/配置文件设计说明.md - 日志：
docs/子系统设计/控制台单写者日志设计说明.md、docs/子系统设计/运行与自检记录设计说明.md