c0cef2fca0
IEC 60870 是标准族(含 104/101),原 App/protocol/ 把它拆成
iec60870/(vendor 核心)+ iec104/(我方适配)两棵同级树,多一层且
看不出「104 只维护一个」。现按标准族收口:
App/protocol/iec60870 -> App/iec60870
App/protocol/iec104 -> App/iec60870/104_port
App/protocol/{README.md,.gitkeep} 删除
App/protocol/iec104/iec104_asdu.h 删除(零 include / 零注册的孤儿)
vendor 子树(104/ common/ examples/)逐字节未改:91 个 R100 重命名、
git diff --cached -M 后 0 insertions / 0 deletions,另按字节直比 89/89
一致;UPSTREAM.sha256 差异集仍等于既有 17 项受控差异,非篡改。
适配层只改注释里的路径字样,无逻辑行。
门禁配套:
- coding-standard 的 exclude 不能写祖先 App/iec60870/——rename_ref 机械
改出的祖先形态会把 2,191 行适配层一起豁免掉。改为三条精确前缀
common/ 104/ examples/,适配层 11/11 回到受检;vendor 直调脚本仍报
88 处违规而钩子 Skipped,证明确实由 exclude 生效而非空跑。
- check_registration 的 KNOWN_GAPS 键与理由文本同步到新路径。
验证:Keil 0 errors 0 warnings(Code=367464 RO-data=48492
RW-data=2288 ZI-data=173544),构建日志与 .d 依赖证明 5 个适配 .o
真被编入;模拟器 0 警告并跑通 iec104-tcp 13/13 真实 TCP 回环;
pre-commit 25 Passed / 0 Failed;doc-links 30 处问题全在
IEC60870-Slave/ 供应商快照,我方文档零新增。
顺带删掉仓根误入库且零引用的 _all_hook.txt 与 _scope.txt。
80 lines
4.5 KiB
C
80 lines
4.5 KiB
C
/*
|
||
* 模块名称:IEC 60870-5-104 被控站服务(对外接口)
|
||
* 模块功能:声明 IEC104 服务的 netTask 驱动入口与对外只读契约;协议实现在
|
||
* App/iec60870/104_port/ 与 App/iec60870/,由 netTask 单属主
|
||
* 在 1 ms 循环内调用 iec104_serv_net_tick() 驱动 threadless 核心;
|
||
* iec104Task 已退役,其任务体声明/创建点已全部删除。
|
||
* 创建日期:2026-10-12(B4)
|
||
*/
|
||
#ifndef IEC104_SERV_H
|
||
#define IEC104_SERV_H
|
||
|
||
#include <stdint.h> /* uint32_t(观测计数声明):头文件自含——2026-10-27 /keil-build 实测
|
||
* 本头此前全靠包含者先带 stdint,feed 换 include 即断链报 #20 */
|
||
/* 监听端口的宏出口已删除(道G task-9 收口 task-8 交接痕):运行期真源 =
|
||
* [comm] 段 getter(App/iec60870/104_port/iec104_comm.h 的 iec104_comm_port(),
|
||
* 工厂默认 IEC104_COMM_DEF_PORT = 2404 = DL/T 634.5104 标准端口)。 */
|
||
|
||
/*
|
||
* 函数功能:netTask 内唯一的 104 推进入口(每轮一次,零阻塞)
|
||
* 入口参数:无
|
||
* 返回值:无
|
||
* 限定条件:**仅 netTask 上下文调用**(在 net_task.c 主循环 net_process_messages()
|
||
* 之后、osDelay(1) 之前);内部含 task_wd_beat(TASK_WD_IEC104)。
|
||
* 函数说明:驱动 threadless iec104_core 的 start/poll/stop,不做任何阻塞等待。
|
||
*/
|
||
void iec104_serv_net_tick(void);
|
||
|
||
/*
|
||
* 104 只读观测计数(道G task-12):四个数都是**上电以来**、跨重连不清零,语义各自
|
||
* 独立、不得互相换算:
|
||
* conn_up = 主站接入次数(core 统计的 TCP 接入事件次数)
|
||
* apdu_tx = I 帧写帧数(**只含 I 帧,不含 S/U 帧**;在 ACK 与收尾记录交付时
|
||
* 观察,可能滞后于实际写入)
|
||
* tx_fail = 以发送类故障结束的会话次数(不是字节失败数/短写次数)
|
||
* rx_bytes = 收到的**字节**数(不是帧数:帧边界在传输层重组,本层看不见)
|
||
* 四个字段**跨重连单调、不归零**(core 下次 start 会清零其源计数,服务层做
|
||
* 跨 start 搬运累计,对外永不倒退)。
|
||
* ⚠ 与旧的 iec104Task 控制量(活性分频 / 发送连败 / 拆链标记)无关:那些会被
|
||
* 复位、只有 8 位,为"要不要拆链"服务,拿来当统计必错。
|
||
* 到顶饱和在 0xFFFFFFF0,不回绕(回绕成个位数会被读成"刚上电")。
|
||
* 页面这一栏要写「本次开机以来」,与运行时长同一类,别让人读成终身值。
|
||
*/
|
||
typedef struct {
|
||
uint32_t conn_up;
|
||
uint32_t apdu_tx;
|
||
uint32_t tx_fail;
|
||
uint32_t rx_bytes;
|
||
} iec104_serv_stats_t;
|
||
|
||
/*
|
||
* 函数功能:读 104 观测计数(纯拷字段)
|
||
* 入口参数:p_out - 输出缓冲;NULL 时无害返回 iec104_serv_stats_t *
|
||
* 返 回 值:无 void
|
||
* 限定条件:**任意上下文可读**——不取锁、不读时刻、不碰 socket、不阻塞(照
|
||
* adc_cal_get_stats() / boot_stats_get() 的形态:观测口一旦去抢总线或等锁,
|
||
* 观测就成了故障的一部分)
|
||
* 函数说明:写者 = netTask(iec104_serv_net_tick),读者 = uiTask/喂数据侧;
|
||
* u32 单字读写原子,跨字段**不保证同一瞬间**——四枚之间没有"合起来
|
||
* 才成立"的判据,混窗对显示无害。
|
||
* 本函数无任何清零能力(能清零的统计口不是统计口)。
|
||
*/
|
||
void iec104_serv_get_stats(iec104_serv_stats_t *p_out);
|
||
|
||
/*
|
||
* 函数功能:读 104 链路是否处于 RUN 态(STARTDT 数据传输已启动)
|
||
* 返 回 值:1 = core.status.active(connected && status_valid && data_transfer_started);
|
||
* 0 = 其它(未连接/未启动/未就绪)
|
||
* 限定条件:**任意上下文可读**——单字节镜像读,不取锁、不碰 socket、不阻塞
|
||
* (与 iec104_serv_get_stats 同一形态与同一读者群)。
|
||
* 函数说明:写者 = netTask(iec104_serv_net_tick 从 core.status.active 镜像),
|
||
* 读者按需采样;单字节读写在 Cortex-M4 上原子,最多读到"晚一拍"的
|
||
* 状态,无撕裂风险。
|
||
* 消费点 = 屏板状态灯 ID 3(App/algo/sb_led_map.h 的通信灯)。
|
||
* ⚠ 别拿它换算 conn_up:RUN 是电平,conn_up 是累计边沿,语义不可互换
|
||
* (同文件统计注释里的"不得互相换算"纪律)。
|
||
*/
|
||
uint8_t iec104_serv_link_run(void);
|
||
|
||
#endif /* IEC104_SERV_H */
|