Files
STM32F4-Base/App/iec60870/104
wandering1 b142ca5531 merge: 合入网络单调时钟归位与 owner-only 守卫(含 104 文档合并解冲突)
合入 dsh-204f318c-38b4 的 4 个提交:单调时钟搬回时间模块、owner-only 入口补
机器守卫、两份网络文档与 sys_clock 设计文档同步、以及角色文件的 TDD 纪律。

冲突共 10 个文件,分两类处理:

一、纯数字/机器快照 8 个(RAM 台账 2 篇、ram_baseline.tsv、size_attestation.json、
iec104_netmcu 的 4 个 results 产物):一律取 master 侧,随后在 master 用本轮权威
构建重新回填,不手工搬数字。这些文件的数值只在特定构建下有意义,跨树搬运必然
制造假账。

二、含真实语义的 2 个,逐块人工合并:
- docs/网络/IEC104_Net适配契约.md:两侧各改了同一处。取 master 的目录路径
  (App/iec60870/104/,master 已把 104 收编为自有代码)叠加本分支的内容改动
  (行号锚点改函数名、net_mono_now_ms 迁出说明、owner 四入口)。同时修掉一处
  本分支带入的旧路径 App/protocol/iec104/iec104_net_mcu.c。
- test/host/iec104_netmcu/MATRIX.md:同样取 master 路径 + 本分支的时钟替身说明。

合并后校验:net-handle 扫 495 个文件 0 违规、selftest 42 条断言 PASS;
net_mono_now_ms 全仓 0 命中;sys_clock_mono_ms 声明在位;net_socket.c 四处
owner 守卫齐;104 适配层已改调通用时钟。
2026-11-19 10:42:25 +08:00
..

104/ — APCI 传输层与协议状态机

本目录负责 104 协议的传输面:把字节流切成 APDU 帧、维护 k/w 发送窗口与超时, 并把解析出的事件交给 business/ 的业务状态机。要改「帧怎么收发、连接怎么管」在这一层; 要改「某类请求怎么应答」去 business/。

本目录同时承载平台适配与装配(小写 iec104_* 前缀,见 §3),因为一个目标只能链接一个 Net 后端,装配代码与它服务的传输层放在一起才能一眼看清这条唯一链路的全貌。

1. 文件分工

文件组 职责
IEC104_Codec.c APDU 帧编解码:I/S/U 帧格式、长度字段、APCI 头部
IEC104_Link.c · IEC104_Link_Slave_StartStop.c 链路状态机:STARTDT/STOPDT/TESTFR 与从站启停
IEC104_Connection.c 单条连接的收发状态、序号维护
IEC104_Receiver.c 接收侧组帧与校验,产出待处理事件
IEC104_SendBuffer.c · IEC104_SendManager.c 发送缓冲与发送调度(含部分发送处理、优先级车道)
IEC104_AsduQueue.c ASDU 队列:HIGH/NORMAL 两级,跨重连保留语义见该文件注释
IEC104_TcpServer.c · IEC104_TcpServer_Config.h 非阻塞 TCP 服务:连接身份、事件环、SOE 容量
IEC104_Slave.c · IEC104_Slave.h 从站主体:对外统一入口(启动、轮询、状态查询)
IEC104_Net.h · IEC104_Net_Windows.c Net 后端 ABI 与主机(模拟器)实现
iec104_dtu_profile.h 标准 DTU 点表数据本体(五张 static const 表,由 iec104_dtu_table.c 包含进产品)

2. 关键约束

一个目标只能链接一个 Net 后端。 IEC104_Net.h 定义一套 ABI,板端由 iec104_net_mcu.c(经 CH395F)实现,模拟器由 IEC104_Net_Windows.c 实现。 同时链接两份会重复定义符号,或者更隐蔽地链到错的那份——两条路径的阻塞语义完全不同, 后者不会报错,只会让时序对不上。板端后端的句柄规则(LISTEN/CLIENT 双槽、代次不变式) 见 docs/网络/IEC104_Net适配契约.md。

非阻塞 I/O 与部分发送是这一层的前提。 Slave/TcpServer 假定 Net 后端从不在调用内 阻塞,因而发送必须能返回「已写一部分」,由 SendManager 记住偏移下轮续写。 板端网络层是「两段式等待 + netTask 单属主」模型,与本假设的接缝 → docs/网络/Net层阻塞模型架构设计.md。

SOE 容量是 RAM 预算决策:IEC104_TcpServer_Config.h 把 IEC104_TCP_SOE_CAPACITY 设为 128U(上游为 256),理由与合规依据见 ../README.md §3.2。

点表 profile(iec104_dtu_profile.h)

这份头文件由 iec104_dtu_table.c #include 后编译进产品,是实打实的产品代码 (不是示例、不受构建排除)。改它等于改点表,三条约束:

  • 它是「标准 DTU 演示表」,不等于现场点表。 按 IEC 60870-5-104 标准 DTU 的典型配置 编排,用于跑通协议栈与主站对点工具,不代表现场实际接线。新旧通信地址相同不代表 语义相同;当前哪些点真接了硬件来源,见 docs/子系统设计/IEC104上行设计说明.md 的平台接缝章节。
  • 改点数要同步别处。 遥信总数的事实来源是 iec104_dtu_table.h 的 IEC104_DTU_SP_COUNT(59)/ IEC104_DTU_DP_COUNT(16),遥测为 IEC104_DTU_ME_COUNT(30)。产品 UI 视图行数 UI_DATA_YX_N 是另一个数(语义不同、 数值本就不等);改动前读 Drivers/BSP/UI/ui_data.h 的 yx_dp 字段注释与 App/app/ui_data_feed.c 的 feed_yx_dp()——那里有一条一次性 DBG_ERROR 盯着这个差异。
  • 它是 const 数据,进 Flash。 五张表(dtu_signals / dtu_measurements / dtu_energy / dtu_commands / dtu_parameters)都是 static const,只被一个编译单元 包含,不占静态 RAM,但体积直接影响 Flash 预算。

3. 装配与平台层(小写 iec104_*)

这五个模块是本项目的自有代码,不是协议主体的一部分:

文件 职责 不能据此推断
iec104_core.c iec104_core_start/poll/stop 生命周期与事件循环,串行驱动上面整套状态机 PC 运行不证明 CH395F、RTOS 或板端监听生命周期正确
iec104_source.c 数据源、模拟动作、参数 RAM、虚拟设备墙钟;iec104_source_bind() 是可选平台接缝 接口存在不等于已绑定 UI、保护或标定真源
iec104_net_mcu.c CH395F 的 Net 后端实现(板端唯一后端) 不经板端台架验证过
iec104_dtu_table.c 标准 DTU 点表与元数据(含 SP/DP/ME 分段与参数表) 新旧通信地址相同不代表语义相同
iec104_comm.c /config.ini 的 [comm] 段:本站公共地址/端口号的 RAM 副本、工厂默认、getter 合法带自愈与 setter 守卫;键表口径见 docs/子系统设计/网络配置说明.md 落盘属主是配置引擎(App/cfg/),本模块只提供 iec104_comm_store_save() 与脏位

调用必须由同一事件循环属主串行执行,源回调必须短且不阻塞。当前属主是 netTask: App/task/iec104_serv.c 在 1 ms 循环里调 iec104_serv_net_tick(),不另建 104 任务。

4. 日志与诊断

本目录的协议主体遵循零日志输出惯例(不 printf、不直写串口),状态通过 IEC104_Slave_Get_Status() 与各模块 status 结构暴露,由上层(App/task/iec104_serv.c) 决定怎么记录。理由:协议层不知道自己运行在哪个任务上下文,直写日志会引入不可重入与 栈深度不可控。要加诊断信息,请扩状态结构而不是往协议层塞日志宏。

5. 相关文档

  • 完整协议栈与目录总览 → ../README.md
  • 板端设计与落地结论 → docs/子系统设计/IEC104上行设计说明.md
  • 点表与 UI 视图的语义差异 → docs/UI设计/UI_数据供给设计.md
  • Net 适配契约 → docs/网络/IEC104_Net适配契约.md
  • 阻塞模型与 netTask 调用边界 → docs/网络/Net层阻塞模型架构设计.md