Commit Graph

12 Commits

Author SHA1 Message Date
wandering1 a40d52a116 fix(iec104): 三个 transport 夹具补 32 位时刻转换,修复 /WX 下编译失败
上一提交把 104 的毫秒时刻从 uint64 收到 uint32(各 API 形参已是
uint32_t now_ms),夹具没同步:三个夹具在 MSVC /W3 /WX 下触发
C4244「从 uint64_t 转换到 uint32_t,可能丢失数据」,被 /WX 升级为
C2220 后整体 build failed。因这三个夹具只被手工/文档路径调用
(test/host/iec104_dtu/run_transport_test.py 与 vendor 快照自带的
build.ps1),pre-commit 与 CI 都不编译它们,所以红了整整两天没被发现。

修法:在 15 个调用点把实参写成 (uint32_t)fake.now,与上一提交在
iec104_idle_transport_test 第 96 行立下的 (uint32_t) 先例一致。

为什么不改夹具时钟的类型:fake.now 定义在 21 个 TU 共用的
iec104_tcp_fixture.h,其中 iec104_periodic_scan_test 用
fake.now = UINT64_MAX - N 构造 64 位回绕、iec104_spontaneous_test 用
fake.now = UINT64_MAX 取边界。改类型会破坏这些用例的语义;而产品侧
时钟源 IEC104_Net_Now_Ms() 本身仍是 uint64,窄化只该发生在形参边界。

值域安全性(非形式检查):三夹具里 fake.now 的所有赋值逐函数提取,
最坏上界 4,020,150 ms,余量约为 UINT32_MAX 的千分之一;三处
UINT64_MAX 命中分别作用于 ticket 与 next_frame_serial,与时刻无关。
另按参数位置审计了 60 个 TU 的 16 个 now_ms 调用点,
三个目标文件内 15 处即全部调用点,无宏、函数指针或条件分支旁路。

实测:
  run_transport_test.py 10/10 run_rc=0(修复前 3 条 build failed)
  10 份 build.log 全部 warnings=0 errors=0
  pre-commit 暂存口径通过 0 失败
改动仅限三个夹具的实参转换,无期望值、断言、控制流或注释改动。
2026-11-19 13:12:07 +08:00
wandering1 f23d30111d perf(iec104): TcpServer 时间戳降到 32 位、控制帧槽 8→4,省 296 B RAM
单连接子站的 TcpServer 结构体(server_pool[1])原来 7656 B,其中大量
绝对时刻用 64 位存,纯属浪费。按两条线索瘦身:

一、毫秒时间戳 64→32 位
   涉及 SendBuffer 发送槽状态、SendManager I 帧记录、Connection 的六个
   时刻字段、TcpServer 的两个重试时刻与 ack 观察槽。这些字段只用于
   「记下时刻、稍后相减求是否超时」,改成 32 位后按无符号差值 / 有符号
   差值判断,49.7 天回绕天然正确,不必再做回绕扩展。
   有两处原本是大小比较,一并改成差值判据,否则回绕瞬间会误判时钟倒退:
     - IEC104_Connection 的 Check_Time 判单调性
     - Dispatch_Received_Frame 判活动时刻是否更新
   两个重试时刻用 0 表示「未暂停」,赋值后补一条抬到 1ms 的兜底,避免
   恰好回绕成 0 被当成未暂停。
   取时刻的入口收敛到 TcpServer 里一个静态函数,出口截断成 32 位;
   对外 ABI 未变:Now_Ms 仍取 64 位单调毫秒供 CP56/UTC 时基使用,
   查询 ack 时刻的出参仍是 64 位,测试夹具的哨兵语义不受影响。

二、控制帧槽 IEC104_TCP_CONTROL_CAPACITY 8→4
   S/U 帧 FIFO 在单连接子站里实际深度是个位数,8 是通用多连接库的默认
   值。取模与队满判断全部走运行期容量,无硬编码,改默认值即可。

实测(权威构建,同一台机器前后对比):
  server_pool          7656 -> 7360 B(-296)
  iec104_tcpserver.o ZI 7656 -> 7360
  RW_IRAM1            118416 -> 118120 B(90.3% -> 90.1%)
  ER_IROM1            414232 B 不变

验证:Keil 0 错 0 警;模拟器构建通过;真实 TCP 回环 13/13;单测
iec104_comm 50/50、iec104_serv 50/50、soe 32/32、netmcu 13/13 + 2/2、
iec104_dtu 7/7;覆盖率 89.3% 无回退;pre-commit 12 项通过 0 失败;
内存台账 --check 一致、--gate 通过。
2026-11-19 00:31:41 +08:00
wandering1 11f7c07b3d docs(iec60870): 4 篇文档首行改一级标题,删两处变更记录节
4 篇 common/ 设计文档原以 <a id="..."></a> 空锚点开头,一级标题在第 2 或
第 3 行,不符合 docs/文档规范.md §5.1「文档首行为 # 标题」。已删掉文档级
锚点行,让一级标题回到首行;11 处指向这些锚点的跨文档链接同步去掉
#anchor 后缀(同文档本就只有一个一级主题,去掉后缀仍指向文件顶部)。

删除两处「变更记录」节(规范 §5.1:一律不设该节,改动过程查 git log):
- 104/IEC104_设计架构.md:删「## 八、变更记录」8 行表;原第九、第十节
  前移为第八、第九节,其下 9.1~9.6 子节号同步重排,全文无 10.x 残留。
- 104/IEC104_Link_设计架构.md:删「### 9.2 变更记录」42 行表;「## 九、
  设计决策与变更记录」改名「## 九、设计决策」,9.1 保留。

验证:check_doc_links.py --all --sections-strict RC=0(308 篇全过,问题 0);
mermaid 预检 10 文件 18 块新发 0;pre_commit 6 Passed / 0 Failed;
6 文件 BOM=False / CR=0 / U+FFFD=0。纯文档改动,未碰代码与构建。
2026-11-18 22:57:58 +08:00
wandering1 b7a23d9f85 docs(iec60870): 把 104 协议库文档从供应商快照迁入项目文档库
IEC60870-Slave/docs 下 36 篇(约 2.8 MB)整体迁到 docs/iec60870/,
git 历史随 rename 保留:104/ 24 篇、common/ 7 篇、examples/ 3 篇、
test/ 1 篇、顶层 README.md 导航 1 篇。

源码链接改指项目代码(用户裁定:IEC60870-Slave 将来要删,那里不是
项目源码):
- 187 条链接按文件名唯一匹配改成 App/iec60870/... 的相对路径
- 364 条在项目里没有同名文件,退化成行内代码,不再当链接
- md 之间的相对链接 1289 条原样保留(目录结构未变)

7 篇讲本项目未实现模块的文档(文件服务、软件升级、冻结电能、故障
录波、历史记录、运行日志、持久化升级)在原一级标题后加统一标注,
说明 App/iec60870 里没有对应实现,只作能力参照。

另外修掉 8 处把外部 DL/T 634.5104-2009 实施细则的章节号当成本仓自
引用的误报,以及 7 处指向供应商快照内测试文件的路径。IEC60870-Slave/
README.md 里 52 处 docs/ 链接同步改到新位置。

docs/README.md 登记:目录树加 iec60870/ 一行,新增 5.3 节列全 36 篇
的一句话索引,并说明它与子系统设计/IEC104上行设计说明.md 的分工
(前者讲协议库内部怎么实现,后者讲板端怎么接)。

验证:doc-links 由 30 处问题降到 0(308 个文档全过,脚本零改动);
mermaid 57 块围栏新发 0 处;全量 pre-commit 6 Passed / 0 Failed;
36 篇文件名合规、无 BOM、无 CRLF、无 U+FFFD。纯文档改动,不涉及代码
与构建。
2026-11-18 22:49:55 +08:00
wandering1 90cc9a7d99 feat(iec104): 把 104 骨架完整迁到 MCU 板端并在台架跑通总召
把 IEC104 从模拟器端整体搬到板端:协议栈原先由独立 iec104Task 驱动,
现在改为 netTask 单 owner 的 threadless 驱动,退役独立任务。

驱动与后端:
- 新增 iec104_net_mcu.c/.h,实现 IEC104_Net.h 的 11 个 ABI 函数,
  用槽表加单调句柄映射 net_socket 的单 fd 模型;CLIENT 拆除只走
  net_drop_conn_locked,绝不 net_close 监听 fd。
- net_socket 增 5 个 owner-only 接口(net_accept_locked、
  net_drop_conn_locked、net_pending_bytes、net_send_try、
  net_mono_now_ms)。
- iec104_serv.c 重写为 iec104_serv_net_tick(),在 netTask 1ms 主循环
  里驱动 core;无 osDelay/阻塞调用,喂狗是第一句。
- Src/freertos.c 删除 iec104Task 三件套,对应栈水位探针表项同步删除。

内存:目标板 192KB SRAM 装不下 vendor 默认容量档,按实测裁剪到
skeleton 档(TCP 缓冲、业务池、SOE 256->128、值槽密集化),
RW_IRAM1 118,408 B / 90.3%,留 2,178 B 余量。

台架修复(只在真硬件暴露):
- SNTP s_ctx.fd 零初始化后为 0,而 net fd 0 是合法槽位下标,
  首次代次变化时误 net_close(0) 关掉 ftpTask 的监听槽,导致 104
  连接被 FTP 的 220 banner 抢走;改为显式 .fd = -1。
- Accept 幂等:单 fd 模型下 vendor 每轮重试 Accept 会拿到同一 fd,
  后端改为会话在役时返 WOULD_BLOCK,Close 不再清槽。

验证:
- Keil 全量重建 0 error 0 warning,uvprojx 零抖动。
- 模拟器真实 TCP 13/13、transport 10/10。
- netmcu 后端单测 13/13(新增 N12)。
- 台架 serial-boot-test required 全中;板端 2404 总召 129 帧收到
  59 遥信(53 有源、全 IV)+ 16 双点 + 30 遥测(PT1 三相非零、
  UN/频率/温度按未标定置 IV)、遥控选择执行全否定、校时 COT 7。
- 期间顺带修正 UI 漂移自检文案、.serialtest required 陈旧项、
  coding-standard 对 vendor 与外部 ABI 名字的排除口径。
2026-11-18 10:29:18 +08:00
wandering1 f84855a559 chore(iec60870): 把 .build 构建产物移出索引
IEC60870-Slave/.gitignore 已声明 /.build/,但 524 个产物文件先入库,
忽略规则对已跟踪文件不生效。本次仅从索引移除,本地文件保留。
2026-11-17 16:21:23 +08:00
STF 5c7c860fc6 删除旧数据
CI / L0 静态门禁 (pre-commit) (push) Failing after 42s
CI / L0.5 主机侧单测 (MSVC) (push) Failing after 42s
2026-11-16 22:36:57 -08:00
STF bdcc8b6500 添加遥控、参数装载、文件传输等业务
CI / L0 静态门禁 (pre-commit) (push) Failing after 7m46s
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 21s
2026-11-16 22:19:17 -08:00
STF e1b0434774 补充遥调业务代码
CI / L0 静态门禁 (pre-commit) (push) Failing after 45s
CI / L0.5 主机侧单测 (MSVC) (push) Failing after 43s
2026-11-01 00:38:09 -07:00
STF cd42b4d61d 添加遥控业务代码
CI / L0 静态门禁 (pre-commit) (push) Failing after 2m51s
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 18s
2026-10-30 20:03:19 -07:00
STF 7596f3371a 补充总召唤的广播地址,电度召唤+时钟同步业务的实现
CI / L0 静态门禁 (pre-commit) (push) Failing after 44s
CI / L0.5 主机侧单测 (MSVC) (push) Failing after 42s
2026-10-29 03:20:19 -07:00
STF 4c55544f05 通信协议代码
CI / L0 静态门禁 (pre-commit) (push) Failing after 45s
CI / L0.5 主机侧单测 (MSVC) (push) Failing after 42s
2026-10-26 08:31:48 -04:00