文档索引
说明文档统一放在 docs/,源码分别位于根目录的 104/、common/、examples/ 和 test/。目录总览及快速构建入口见项目 README。本文中的文档链接相对于当前文件;文档内的构建命令均从项目根目录执行。
推荐阅读顺序
专用示例的点表、定值、运行与恢复见 DTU 配置演示,验证入口见 DTU 测试。
软件升级分为211协议会话、通用安装核心和具体介质后端。下表按需要定位说明;同一事实以对应专题为准,测试执行记录集中保存,不从流程图推断目标硬件已经验收。
| 阅读目的 | 文档入口 |
|---|---|
| 模块分工、三个槽与持久状态 | 安装设计、状态与角色 |
| C接口、借用寿命与错误返回 | 公共核心声明、宿主适配声明、门面调用契约 |
| 介质布局和原子提交 | 60字节核心元数据、文件与双bank |
| 启动恢复、候选失败与试运行回退 | 恢复判据、启动接线 |
| END、ACK、持久授权与安装确认如何衔接 | 协议与应用边界、授权交接时序 |
| 打包、首次种子、再次启动及主站操作 | 持久模式示例 |
| 资源和目标设备适配 | 缓冲与同步预算、Bootloader及新应用确认 |
| 测试场景、命令和已执行结果 | 升级安装专项 |
附录C运行日志入口:类型、XML与持久恢复、核心API、独立开关及调阅、日志专项验证。
附录B历史记录入口:核心、持久化与XML、启动及Type210调阅、循环、断点恢复及真实TCP测试。
附录B冻结电能入口:记录与窗口、封存及恢复、energy.store布局、FRZ/FLOWREV下载快照、整数模拟源与八值恢复。专项命令为./scripts/build.ps1 -Test -Suite EnergyFreeze。
接入与排障:时间网格及日界、返回值与状态变化、存储回调契约、提交中断与恢复边界、丢失检测限制、主循环调用顺序、设计验证入口。
发送业务先后顺序及接入方式见12级业务优先级设计,包括等级分类、严格模式配置、业务收集轮和事务顺序约束。
Type42故障事件的入口:扩展格式与公共编解码、故障快照发布、发布API、公共API。
连续故障录波的入口:模块职责与数据流、采样状态与冻结寿命、CFG/DAT布局、真实终端接入要求、模拟保存及下载、主站文件服务兼容性、测试与验收范围。
Type211软件升级的入口:报文与会话、引用转移、ACK与授权、调度与计数、应用所有权、API、接入、示例、验证。
周期/背景扫描的入口:设计与边界、API 第29节、事件循环接入、命令行示例、测试与实测状态。
参数应用的入口:处理路径、门限数值示例、地址映射与范围、装载与读回验收、单点周期启停。
Type200–203远程参数的入口:线格式与确认、预置及失败恢复、事件循环接入、示例点表与开关、测试与验收边界。
Type210文件服务的入口:报文与配置、状态与队列、BUSY事件保留、写入与COMMIT、资源所有权、调度诊断、调用流程、文件服务示例、验证记录。
- 模块说明与接入示例:公共 ASDU、子站统一入口及模块依赖。
- 各业务模块设计架构:按业务进入对应的独立文档,分别阅读内部结构、状态机、关键函数链及接口契约;跨模块关系补充见业务层总览。
- 子站示例说明:先按快速开始构建、指定CA并用主站读取一个点,再查命令参数、点表及各业务接入;突发、周期和文件读数据须完成本轮启动同步。部署前评估两种召唤的整体期限,示例初始值与库默认值分开。
- 完整调用流程:从应用入口到协议收发的调用关系。
- API 接口汇总:按文件查阅接口。
- 测试说明:测试源码与Suite对应表、全量/分模块命令、覆盖范围与历史验证记录。构建依赖和容量矩阵统一由
scripts/build.ps1维护。
2026-11-15两项链路修复统一入口:条款、行为与接入影响。接收N(S)与TESTFR的详细规则集中在Link设计,测试事实分别保存在各阶段验证记录中。
从旧Try或Ordered版本升级时,先读通用应答迁移说明,再按凭证接入示例处理成功/WAIT和交接状态。通用应答专项列出行为与测试函数的对应关系。旧有序应答修复记录保留历史事实,不能作为当前发送契约。
按接入问题查细节
下列章节给出具体输入、状态推进、检查步骤或源码推演;现有测试定位随章节列出,实际运行结果仍统一记录在测试文档。
| 接入或排障问题 | 详细入口 |
|---|---|
| 为什么重复或跳号N(S)仍受理,哪些N(R)必须拒绝 | 接收规则与报文例子 · N(S)验证记录 |
| 主站发过TESTFR后终端还会主动测试吗,STOP/重连和旧接口如何处理 | 探测规则与时序例子 · 底层接口迁移 · TESTFR验证记录 |
| 总召外为何只发带时标遥信,示例与通用库默认值有什么区别 | 实施细则策略设计 · 各路径时标矩阵 |
| 发送WAIT期间发生校时或点值变化,SOE、遥控返回与Read各用哪次快照 | SOE入队冻结 · Read当前快照 · 遥控返回信息 |
| 旧主站点表与INI怎样迁移,十六进制地址对应哪个十进制节名 | 表8地址与集中宏 · 参数点号迁移 |
| QRP2清除默认遥信后是否还会发送无时标副本 | 形态继承与清除边界 |
| 运行日志按哪个来源去重,校时回拨或日志落盘失败怎样处理 | 日志触发及应用接线 · 核心API |
| ULOG的txt/text差异、设备ID与三阶段持久提交怎样实现 | 日志格式选择 · 双bank与快照 |
| 日志返回ERROR后能否继续读写,目录生成失败是否需要重开存储 | 核心状态转换 · 分层失败处理 |
| 日志对象能否复制,目录缓存和下载句柄分别由谁关闭 | 宿主接口与资源寿命 |
| 参数生效、远程固化、升级结果和校时分别在哪个阶段影响日志 | 标准参数 · 远程参数 · 软件升级 · 校时 |
| 严格调度、故障快照、录波与历史保存怎样接进同一个循环 | 完整流程:采集、持久化与文件调阅 |
| SOE发送被覆盖或重试,历史记录是否变化;复位后哪些数据保留 | 业务层:实时发送与历史职责 · 示例存储生命周期 |
| 日槽怎样覆盖、24:00归哪一天、校时回拨后如何恢复 | 历史时间规则 |
| 写入中断后选哪个副本,存量点表变更为什么不能直接加载 | 恢复矩阵 · 失败与迁移 |
| 读目录后又发生新事件,文件大小和内容怎样保持一致 | 历史快照生命周期 |
| 真实采集、异步设备结果如何交回协议循环,什么时候释放context | 业务层:外部输入与资源所有权 |
| 一直WAIT、有ACK仍停发、FINISHED后设备还在动作 | 完整流程:按现象定位等待 |
| START已完成,但突发、周期或文件读数据仍在等待;重连后怎样恢复补发 | 完整流程:启动补发协调 · 示例联调 |
| TCP半帧、粘包、consumed=0以及完整帧尚未交付 | 接收器:逐字节分片推演 |
| 序号从32767回绕后,哪些ACK有效 | Link:本地完成位置与ACK数值表 |
| I帧只写出3字节就收到STOP,后来又收到START | Connection:部分写入与启停交错 |
| socket句柄复用、旧就绪通知迟到,或没有新输入时不再推进 | TcpServer:token与本地续跑 |
| 队列为空仍不能发送,reserve究竟预留什么 | 发送模块:窗口与记录槽的算例 |
| 总召首站失败后,定向撤销未来站和广播撤销有什么区别 | Interrogation:报文及事件台账 |
| 冻结/复位已经执行,但主站没有收到确认,如何恢复读取 | CounterInterrogation:确认漏收与重发 |
| 206/207放在哪个模块,QDS怎样编码,当前值与冻结值如何读取 | CounterInterrogation:短浮点电能量设计 · 读取快照时间线 |
| 冻结电能怎样跨重启恢复,校时回拨和延迟FLOW是否改变旧事件值 | 八值原像恢复与分段墙钟 · 持久与临时资源 |
| 遥控已FINISHED,迟到的物理结果还能交给谁 | Command:设备与事务寿命时间线 |
| 同点连续Read在WAIT期间值或品质改变,最终返回哪一次值 | Read:取值、提交与到期时间线 |
| 远程预置失败或本地Cancel后,新预置仍被拒绝,撤销SN不同会清理哪一批 | RemoteParameter:预置会话与恢复 |
| 202正常帧WAIT为何重新取值,固定负末帧为何不再读取 | RemoteParameter:分帧读取与固定中止 |
| 远程参数faulted后换代或STOP为何不能恢复,退出时何时释放暂存 | RemoteParameter:期限与故障 · 接入与退出 |
| QRP1确认获ACK后又STOP,何时仍允许复位 | SystemCommand:ACK原文、截止和先后顺序 |
| 校时动作成功或失败,但确认结果不同,何时更新业务时间基准 | ClockSynchronization:动作与确认诊断 |
| Type103读时的IV与失败有何区别,读后校时会不会改变等待中的回复 | ClockSynchronization:报文与品质分层 · 读写时间线 · 状态排查 |
| UTC秒、本地日历、CP24短时标与单调时间怎样转换 | Time:输入时间域与跨小时例子 |
| 突发Publish成功,主站仍少报或重报,覆盖计数怎样解释 | Spontaneous:前缀、双形态与覆盖诊断 |
| 扫描部分点停发、lookup报错、换表成功后仍未恢复 | PeriodicScan:故障定位与Resume |
全量清单
| 分类 | 文档 | 内容 |
|---|---|---|
| 104 | 模块说明与接入示例 | 模块职责、依赖与使用示例 |
| 104 | 基础设计 | APCI 编解码、流式接收及整体结构 |
| 104 | 链路设计 | 序号、窗口、超时、启停与 TESTFR |
| 104 | 发送模块设计 | ASDU队列、发送缓冲、优先级与公平调度 |
| 104 | 业务优先级设计 | 12级分类、严格收集轮、候选仲裁、事务顺序与兼容模式 |
| 104 | 通用应答发送变更记录 | 移除屏障与排空门控、通用交接凭证及验证证据 |
| 104 | 连接层设计 | 单连接收发协调与生命周期 |
| 104 | TCP 服务设计 | 网络适配、事件循环及容量配置 |
| 104 | 业务层设计架构 | 业务文件地图、状态归属、请求/发布框架、事件循环、完成契约及扩展边界 |
| 104 | 总召设计 | 站总召、分组、撤销、超时与业务事件 |
| 104 | 计数量设计 | 读取、冻结、复位、动作执行及双实例接入 |
| 104 | 时钟同步设计 | Type103校时与COT5读时、显式回调、滞留补偿、快照及FIFO回复 |
| 104 | 读命令设计 | Type102、单点当前值、同步lookup、请求FIFO、HIGH余量及提交前期限 |
| 104 | 系统命令设计 | 104/107回显、70轮次、105按时ACK后复位授权及本CA事件清除 |
| 104 | 参数装载设计 | 110–113、运行值确认、显式动作FIFO、暂存/同址/专用QPA及ACK两阶段扩展;示例应用测量链 |
| 104 | 远程参数设计 | 200–203、区号、TLV分帧读取、预置/固化/撤销、失败恢复与固定FIFO |
| 104 | 文件服务设计 | 210、目录快照、IDLE读数据、写数据环/BUSY、COMMIT预留确认与恰一次收尾 |
| 104 | 软件升级设计 | 211、会话/引用、ACK与生命周期、调度计数、设备owner及模拟激活 |
| 104 | 遥控设计 | Type 45–51/58–64、按CA/IOA配置模式、动作前时效与HIGH容量检查、返回信息、完成/交接/ENDED清理期限及FINISHED |
| 104 | 突发上送设计 | 普通14类/23个Type监视信息、Type42故障快照专用发布、双报与CP56、NORMAL覆盖统计及应用顺序协调 |
| 104 | 周期/背景扫描设计 | IDLE直发、组与点级网格、SQ阈值、在线配置、整表替换及存储/栈实测 |
| 104 | 完整调用流程 | 各层调用顺序与业务流程 |
| 104 | API 接口汇总 | 104 及其依赖的公共接口 |
| 公共 | 时间工具设计 | CP16/CP24/CP56、日历转换与时钟接口 |
| 公共 | 故障事件信息设计 | Type42扩展格式、共享地址宽度、完整ASDU编解码、故障快照与第6级上送 |
| 公共 | 故障录波与COMTRADE设计 | 模块位置、窗口与迟触发容量、冻结寿命、CFG/DAT布局、保存与发布时序、产品接入 |
| 公共 | 历史记录与文件设计 | 点表过滤、循环槽与时间、核心API、持久布局、双副本恢复、XML快照及迁移边界 |
| 公共 | 运行日志与文件设计 | 附录C的11类事实、1024条循环、CRC与恢复、XML字段、独立存储、发生时标及快照 |
| 示例 | 子站示例说明 | 编译运行、命令参数、点表、业务接入、周期/背景开关及系统命令联调边界 |
| 测试 | 测试说明与验证记录 | 公共模块、104 及真实 TCP 回环测试 |