Files
STM32F4-Base/App/protocol/README.md
T
wandering1 2e9272cc8a feat(iec104): 在模拟器跑通共享协议核心与标准DTU点表
引入成熟 IEC 60870-5-104 子站的只读子集(App/protocol/iec60870,28 个源文件
按原字节复制,UPSTREAM.sha256 记录来源,兼容补丁保留全部断言与容量),在其上
装配单属主共享核心(Start/Poll/Stop/Get_Status),并把标准 DTU 演示点表全量
接入为唯一真源。

- iec104_core:threadless 推进,poll 零等待,通知/交互/COV 扫描全部有界;
  生命周期区分失败启动待重试、重复启动拒绝、断线保固化 RAM。
- iec104_dtu_table / iec104_source:标准 DTU 全点表注册,无数据源的点读 0,
  遥控只做模拟状态可读回,不触碰实际出口。
- iec104_sim:仅窗口与独立服务模式起真实 TCP,无头黄金模式保持确定性假统计。
- test/host/iec104_dtu:独立真实 TCP 11 项、传输层 10 项、生命周期与借用负例。

验证:lvgl_sim 真实 TCP 11/11、传输 10/10,UI 像素回归未回退;AC5 单 TU
编译 0 错误 0 诊断。板端尚未切换:完整库闭包 RAM 超 92% 门禁净增预算 25730B,
结论为停止转实施,记录在 IEC104_MCU最小可行性验证.md。旧实现与 board 服务
保持原样,未提交 MDK 工程改动,未烧板。
2026-11-17 20:48:00 +08:00

31 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# App/protocol/ — 通信协议与共享运行核心
> 存放**跨接口复用的协议逻辑**(解析 / 组帧 / 状态机)及成熟协议运行核心。
> 纯逻辑部分依赖注入;网络后端承担 I/O,板端既有胶水在对应 task(如 `App/task/iec104_serv.c`)。
> 其余协议实现暂分散在:
> - RS-485 侧:`App/task/rs485_task.c`(CRC 在驱动内)
> - 网络侧:`Drivers/BSP/NET/`
> - 远端显示:`docs/UI设计/RemoDispBus协议与接收设计说明.md`
## 已落地协议
| 子目录 | 协议 | 说明 |
|---|---|---|
| `iec104/` 旧板端路径(尚保留) | IEC 60870-5-104 被控站(TCP 工厂默认 2404 上行) | 旧纯逻辑三件套(asdu/pts/link,零 I/O、数据源 vtable 注入)与现行板端服务;历史单测及板端决策见 `docs/子系统设计/IEC104上行设计说明.md` |
| `iec104/` 新共享路径与 `iec60870/` | 成熟 Slave/TcpServer 共享核心,模拟器显式启用 | core/source/table 装配成熟业务状态机与平台网络后端;模拟器首里程碑已验证,未替换旧板端路径,详见下文边界 |
## 成熟核心迁入边界
新入口 `iec104/iec104_core.c` 装配 `iec60870/` 的 Slave、TcpServer 与业务状态机,数据接缝位于 `iec104/iec104_source.c`,标准演示元数据位于 `iec104/iec104_dtu_table.c`。平台网络后端承担 I/O,因此本目录新增部分不能再一概称为零 I/O。来源及兼容补丁见 `iec60870/IMPORT.md`。
- 模拟器以 `--iec104` 显式启用共享核心;旧板端服务仍用原实现,尚未替换或删除旧栈。
- 协议参数暂为独立 RAM 模型,不等于现有 UI 参数真源;新旧同址不能作为语义桥。模拟读写不持久、不驱动物理开出。
- 虚拟设备墙钟不改宿主系统钟;链路与事务超时使用单调时基。
- 模拟器首个里程碑已有同哈希独立 TCP 与黄金回归证据,见设计文档。MCU 替换、旧栈删除、真实 UI 参数绑定仍未完成;构建或模拟器通过不能代替 MCU 资源与硬件验证,也不代表全部门禁通过。
- 设计与精确集合见 `docs/子系统设计/IEC104上行设计说明.md` §0;历史日志、录波继续归现有子系统,不另起示例存储栈。
## 何时使用本目录
当出现**跨接口复用的协议逻辑**(如统一的帧编解码器、协议状态机)时,落到此处,
避免散落到各 task 里。新增后请在本 README 补一行说明。