wandering1
0f7b5a87fb
登记簿、文档与代码注释里的存量字母加数字编号（N-x / S-x / T-x / E-x / A-x / 卡号） 一律改写为语义短语，净删 2,028 处引用；删除基线与待确认、并行分道方案、排期详述、 采集保护收尾 4 篇（内容已并入 docs/任务规划/README 与登记簿）。 门禁机器与三张账同批重打：check_ids.py 新增变更记录行豁免与第二根护栏 undecidable_total_ceiling；check_test_traceability.py 只加 stdout/stderr UTF-8 reconfigure（TC_RE 未动）；check_cubemx_survival.py 的 --write 固定 newline=LF； id_registry / id_aliases（+19 条 retired-to-phrase）/ id_known_backlog 重打。 test/ 56 个文件同步 TC 标签语义化，其中 18 个 TU 改了 CHECK / printf 里的标签文字， 是本批唯一改变构建产物的文件集合。 为什么合成一笔、不拆四笔（实测撞闸，非偏好）：pre-commit 跑钩子前会 stash 未 staged 部分，拆开后中间提交必然是「新规则 + 旧语料」——实跑可判定 85.15% < 基线 86.00%、 不可判定 1,453 > 上限 1,166，编号门禁直接拦下。编号识别面与它描述的语料只能同码移动。 实跑基线（工作区全量）：754 文件 / 8,230 处编号字面量 / 可判定 7,079 = 86.01% （基线 86.0%，容差 0.1pp）/ 不可判定绝对数 1,151（上限 1,166）/ 校验 1-6 错误级 0 / 告警 = 悬空 2（App/algo/freq.c 的 S2，属 §4.4 同号不同义）+ 孤儿 50。 基线从 84.0 抬到 86.0 的理由见 docs/门禁说明/id-check.md §7.6：本批真删了 2,028 处 引用，可判定面随真实内容上升，不是把分母做小。同批新增排除 docs/硬件平台/ 语料，使 识别面少 264 处——芯片手册位号与网表料号不属编号空间（registry 有 excluded_paths_note）。 ⚠ 余量只剩 0.11pp（约 10 处）与绝对数 15 处：把「可判定的引用」改成散文会立刻撞第二 根护栏。另遗留一项：id_aliases 里 retired 的 N / S / T / A 别名没有 scope（U1~U5 有）， 今后有人新写一个 A-4，校验 3 不会响，只能靠人，建议下批补 scope。 固件不变证据：115 个 .c/.h 剥注释并归一字符串后与 HEAD 逐字节全等，残留代码差异 0； App / Src / Drivers 的字符串字面量零改动。@build 0 错误 0 警告；40/40 主机套件、2,889 断言全通过；覆盖率 line 89.2% / func 92.6%；pre-commit 48 钩子 --all-files 全绿； check_doc_links --all 通过（176 文档，章节引用无法判定 0）；逐字节卫生核过：14 个带 BOM 文件与 HEAD 一致、0 个 CR、0 个 U+FFFD，字符串字面量纯 ASCII。 .cubemx_survival_baseline.json 的 watchdog-module 哈希 56bf27 变 2bb051 属合法： Src/freertos.c 的 USER CODE 区内只有注释文字随编号改写，代码未变。 同批带上体积同码凭证与 RAM 台账行（@build 之后盖戳）：RW_IRAM1 79,008 B / 60.3%， RW_CCM 57,376 B / 87.9%，阈值 92%。
132 lines
6.9 KiB
C
132 lines
6.9 KiB
C
/*
|
||
* 模块名称：IEC 60870-5-104 ASDU 编解码（应用层，纯逻辑）
|
||
* 模块功能：104 规约应用服务数据单元（ASDU）的类型/传送原因常量、组帧与解析。
|
||
* **零 I/O、零平台依赖**（仅 stdint.h）→ 主机侧 L0.5 可离线单测
|
||
* （分层约束：协议解析与硬件 I/O 分离）。
|
||
* 口径来源：docs/算法/继电保护功能复现规划.md §1.5（B0 产品定义）——
|
||
* 公共地址 2 字节、传送原因 2 字节、信息体地址 IOA **3 字节**（101 为 2 字节）；
|
||
* 遥测上送**短浮点** M_ME_NC_1（系数 = 1）；遥信双点上双点、其余单点；
|
||
* 遥控**双点命令**（选择 82H / 执行 02H，即 QDC 的 S 位 + 值 2）。
|
||
* 帧结构（本层只管 ASDU，APCI 6 字节头归 iec104_link）：
|
||
* [type 1B][vsq 1B][cot 2B][ca 2B]( [ioa 3B][元素...] )*n
|
||
* 多信息体地址对象（SQ=0）每对象带独立 IOA；顺序对象（SQ=1）单 IOA + n 元素。
|
||
* 创建日期：2026-10-12（B4，W1 功能主线，登记簿见 docs/任务规划/）
|
||
*/
|
||
#ifndef IEC104_ASDU_H
|
||
#define IEC104_ASDU_H
|
||
|
||
#include <stdint.h>
|
||
|
||
/* ---------------- 类型标识（DL/T 634.5104，仅定义本期子集） ---------------- */
|
||
#define IEC104_T_M_SP_NA_1 1U /* 单点遥信 SIQ */
|
||
#define IEC104_T_M_DP_NA_1 3U /* 双点遥信 DIQ */
|
||
#define IEC104_T_M_SP_TB_1 30U /* 单点遥信+CP56时标 SIQ+7B（B9 SOE 自发） */
|
||
#define IEC104_T_M_ME_NC_1 13U /* 遥测短浮点 float+QDS（§1.5 口径） */
|
||
#define IEC104_T_C_SE_NC_1 50U /* 定值写（短浮点）float+QDS */
|
||
#define IEC104_T_C_DC_NA_1 52U /* 双点遥控 QDC（82H 选 / 02H 执行） */
|
||
#define IEC104_T_C_IC_NA_1 100U /* 总召 RQT */
|
||
#define IEC104_T_C_RD_NA_1 102U /* 读单个测量值 IOA only */
|
||
#define IEC104_T_C_CS_NA_1 103U /* 时钟同步 CP56Time2a */
|
||
#define IEC104_T_C_TS_NA_1 104U /* 试验 FBP 2B */
|
||
#define IEC104_T_C_RP_NA_1 105U /* 进程复位 RPA 1B */
|
||
|
||
/* ---------------- 传送原因 COT（低字节 6bit；高字节 T|PN|RBT/…） ---------- */
|
||
#define IEC104_COT_PERIODIC 1U /* 周期/循环 */
|
||
#define IEC104_COT_BG_SCAN 2U /* 背景扫描（总召响应） */
|
||
#define IEC104_COT_SPONT 3U /* 突发（cos） */
|
||
#define IEC104_COT_INIT 4U /* 初始化（总召 + RBT=1 时用） */
|
||
#define IEC104_COT_REQ 5U /* 请求（C_RD 响应） */
|
||
#define IEC104_COT_ACT 6U /* 激活 */
|
||
#define IEC104_COT_ACTCON 7U /* 激活确认 */
|
||
#define IEC104_COT_ACTTERM 8U /* 激活终止 */
|
||
#define IEC104_COT_DEACT 9U /* deactivate */
|
||
#define IEC104_COT_DEACTCON 10U /* 停止激活确认 */
|
||
#define IEC104_COT_UNK_COT 12U /* 未知传送原因 */
|
||
#define IEC104_COT_UNK_CA 13U /* 未知公共地址 */
|
||
#define IEC104_COT_UNK_IOA 14U /* 未知信息体地址（+EVI） */
|
||
#define IEC104_COT_BIT_T 0x80U /* COT 高字节 bit7：试验 */
|
||
#define IEC104_COT_BIT_PN 0x40U /* COT 高字节 bit6：否定确认 */
|
||
#define IEC104_COT_BIT_RBT 0x10U /* COT 高字节 bit4：请求链路仿真（总召初始化） */
|
||
|
||
/* ---------------- VSQ ---------------- */
|
||
#define IEC104_VSQ_SQ 0x80U /* 1 = 顺序地址（单 IOA + n 元素） */
|
||
#define IEC104_VSQ_N(n) ((uint8_t)((n) & 0x7FU))
|
||
|
||
/* ---------------- 遥信/遥测品质描述位（本期只用溢出/异常/非当前） --------- */
|
||
#define IEC104_QDS_OV 0x01U
|
||
#define IEC104_QDS_BL 0x10U /* blocked（闭锁） */
|
||
#define IEC104_QDS_NT 0x20U /* not top（暂态品质，遥测未就绪用） */
|
||
#define IEC104_QDS_IV 0x80U /* invalid（无效，通道不可用用） */
|
||
#define IEC104_DIQ_IV 0x80U
|
||
#define IEC104_SIQ_IV 0x80U
|
||
|
||
/* ---------------- 双点值（DIQ/QDC 低 2bit） ---------------- */
|
||
#define IEC104_DPC_DONTCARE 0U
|
||
#define IEC104_DPC_OFF 1U
|
||
#define IEC104_DPC_ON 2U
|
||
#define IEC104_QDC_S 0x80U /* 1 = 选择，0 = 执行（§1.5：82H/02H） */
|
||
|
||
/* ---------------- 总召 RQT ---------------- */
|
||
#define IEC104_RQT_GROUP1 20U /* 总查询（组 1） */
|
||
|
||
/* ---------------- ASDU 头（解析产物） ---------------- */
|
||
typedef struct {
|
||
uint8_t type; /* 类型标识 */
|
||
uint8_t vsq; /* 可变结构限定词 */
|
||
uint8_t cot; /* 传送原因低 6bit */
|
||
uint8_t cot_hi; /* COT 首字节的高位标志（T=0x80 / PN=0x40 / RBT=0x10 原样保留） */
|
||
uint8_t oa; /* 源发站地址（第 2 COT 字节；bit7 = EVI） */
|
||
uint16_t ca; /* 公共地址（链路地址 = ASDU 公共地址，2B） */
|
||
const uint8_t *obj; /* 信息体区首址（指向调用方缓冲，生命周期同 on_rx） */
|
||
uint16_t obj_len; /* 信息体区长度 */
|
||
} iec104_asdu_hdr_t;
|
||
|
||
/*
|
||
* 函数功能：解析 ASDU 头（不解析信息体——各命令的体解析在 iec104_link 内做）
|
||
* 入口参数：buf - ASDU 首址（不含 APCI）；len - ASDU 长度
|
||
* hdr - 输出头
|
||
* 返 回 值：0 成功 / -1 参数或长度错（len < 6）
|
||
* 函数说明：纯只读，不改动 buf。
|
||
*/
|
||
int iec104_asdu_parse_hdr(const uint8_t *buf, uint16_t len, iec104_asdu_hdr_t *hdr);
|
||
|
||
/*
|
||
* 函数功能：写 ASDU 头
|
||
* 入口参数：buf - 目标缓冲（容量须 ≥ 6）；type/vsq/cot/cot_hi/ca 见常量
|
||
* 返 回 值：固定 6（已写字节数）
|
||
*/
|
||
uint16_t iec104_asdu_put_hdr(uint8_t *buf, uint8_t type, uint8_t vsq,
|
||
uint8_t cot, uint8_t cot_hi, uint16_t ca);
|
||
|
||
/* ---------------- 小工具（IOA 3B 小端 / IEEE 短浮点小端） ---------------- */
|
||
|
||
/* IOA（3 字节小端）写入 */
|
||
void iec104_put_ioa(uint8_t *buf, uint32_t ioa);
|
||
/* IOA（3 字节小端）读取 */
|
||
uint32_t iec104_get_ioa(const uint8_t *buf);
|
||
/* IEEE754 float 按 104 小端写入（memcpy 位模式，不做字节序假设） */
|
||
void iec104_put_float(uint8_t *buf, float v);
|
||
/* IEEE754 float 按 104 小端读取 */
|
||
float iec104_get_float(const uint8_t *buf);
|
||
|
||
/* ---------------- CP56Time2a（C_CS 时钟同步用） ---------------- */
|
||
|
||
/*
|
||
* 函数功能：解析 CP56Time2a（7 字节）为 epoch 毫秒
|
||
* 入口参数：buf - 7B 首址；epoch_ms - 输出（UTC 毫秒）
|
||
* 返 回 值：0 成功 / -1 参数错 / -2 IV 位置起（时间无效，调用方应拒绝）
|
||
* 函数说明：年字段仅 7bit（0..127，基准 2000）；月/日/时/分按 1.. 语义；
|
||
* 不处理 SU（夏令时）位——忽略。
|
||
*/
|
||
int iec104_cp56_to_epoch_ms(const uint8_t *buf, uint64_t *epoch_ms);
|
||
|
||
/*
|
||
* 函数功能：epoch 毫秒 → CP56Time2a（7 字节，UTC 分解）
|
||
* 入口参数：epoch_ms - UTC 毫秒；buf - 目标 7B
|
||
* 返 回 值：固定 7
|
||
* 函数说明：epoch_ms < 2000-01-01 时钳到 2000（年字段下限）；IV 清 0。
|
||
*/
|
||
uint16_t iec104_epoch_ms_to_cp56(uint64_t epoch_ms, uint8_t *buf);
|
||
|
||
#endif /* IEC104_ASDU_H */
|