2e9272cc8a
引入成熟 IEC 60870-5-104 子站的只读子集(App/protocol/iec60870,28 个源文件 按原字节复制,UPSTREAM.sha256 记录来源,兼容补丁保留全部断言与容量),在其上 装配单属主共享核心(Start/Poll/Stop/Get_Status),并把标准 DTU 演示点表全量 接入为唯一真源。 - iec104_core:threadless 推进,poll 零等待,通知/交互/COV 扫描全部有界; 生命周期区分失败启动待重试、重复启动拒绝、断线保固化 RAM。 - iec104_dtu_table / iec104_source:标准 DTU 全点表注册,无数据源的点读 0, 遥控只做模拟状态可读回,不触碰实际出口。 - iec104_sim:仅窗口与独立服务模式起真实 TCP,无头黄金模式保持确定性假统计。 - test/host/iec104_dtu:独立真实 TCP 11 项、传输层 10 项、生命周期与借用负例。 验证:lvgl_sim 真实 TCP 11/11、传输 10/10,UI 像素回归未回退;AC5 单 TU 编译 0 错误 0 诊断。板端尚未切换:完整库闭包 RAM 超 92% 门禁净增预算 25730B, 结论为停止转实施,记录在 IEC104_MCU最小可行性验证.md。旧实现与 board 服务 保持原样,未提交 MDK 工程改动,未烧板。
84 lines
4.8 KiB
C
84 lines
4.8 KiB
C
/**
|
||
* 链路模块内部的跨文件协作声明,不属于供业务调用的稳定公开API。
|
||
*
|
||
* “内部”指使用范围限于链路实现,不是C语言的static内部链接。
|
||
* 本文件声明的函数均定义在IEC104_Link.c,供公共链路及角色实现调用,
|
||
* 因此采用外部链接。角色状态组合校验是Link.c中的static函数,不在此声明。
|
||
* 若改为static,必须同时消除跨编译单元调用;仅移动或删除头文件声明无效。
|
||
* 只在一个.c内使用的辅助函数直接定义为static,不应加入本头文件。
|
||
*
|
||
* 校验调用顺序:Role_Valid -> State_Valid -> Link.c内对应角色的static State_Consistent。
|
||
* 最后一级不能反调前两级,否则形成递归。其余辅助函数依赖各自列出的前置条件。
|
||
* 同一连接的检查、编码、状态提交和完成事件由调用方串行化;这里不提供锁或调度。
|
||
* 业务调用方使用Common、Master_StartStop、Slave_StartStop公开头文件,或兼容总头文件IEC104_Link.h。
|
||
* SendManager通过公开的Get_Send_Progress和Is_Initial_State查询,不包含本头文件。
|
||
*/
|
||
#ifndef IEC104_LINK_INTERNAL_H
|
||
#define IEC104_LINK_INTERNAL_H
|
||
|
||
#include "IEC104_Link_Common.h"
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/**
|
||
* 功能:检查公共字段定义域、S状态/快照组合,以及当前角色的启停状态约束。
|
||
* 定义/调用:定义于IEC104_Link.c;公共接口及主站超时查询使用,角色入口经Role_Valid使用。
|
||
* 输入参数:state——待检查对象;允许NULL,返回0。
|
||
* 输出参数:无,不修改state。
|
||
* 返回值:通过检查为1,否则为0;不是IEC104_LinkResult_t事件结果。
|
||
* 说明:不判断TCP连接、FIFO事件身份或本次报文序号;这些由对应处理步骤负责。
|
||
*/
|
||
int IEC104_Link_State_Valid_Internal(const IEC104_LinkState_t *state);
|
||
|
||
/**
|
||
* 功能:完成上述状态检查,并要求本端角色与指定接口相符。
|
||
* 定义/调用:定义于IEC104_Link.c;主站和子站的角色专用入口调用。
|
||
* 输入参数:state——待检查对象;role——入口要求的CONTROLLING或CONTROLLED。
|
||
* 输出参数:无,不修改state。
|
||
* 返回值:状态合法且角色匹配为1;NULL、状态非法或角色不匹配为0。
|
||
* 说明:检查的是本端固定角色,不会设置角色,也不会推进启停过程。
|
||
*/
|
||
int IEC104_Link_Role_Valid_Internal(const IEC104_LinkState_t *state, IEC104_LinkRole_t role);
|
||
|
||
/**
|
||
* 功能:计算已收但尚未由成功发送的I/S帧确认的I帧数。
|
||
* 定义/调用:定义于IEC104_Link.c;公共确认逻辑和子站停止排空使用。
|
||
* 输入参数:state——序号字段有效的链路状态。
|
||
* 输出参数:无,不修改state;不重复执行完整状态校验。
|
||
* 返回值:从acked_nr到vr的循环距离,范围0..32767;0表示无待确认数据。
|
||
* 说明:前置条件:state非NULL,acked_nr和vr为有效15位序号,未确认区间未占满序号环。
|
||
*/
|
||
uint16_t IEC104_Link_Unconfirmed_Rx_Internal(const IEC104_LinkState_t *state);
|
||
|
||
/**
|
||
* 功能:判断当前接收位置已确认,或已由在途S帧的N(R)完整覆盖。
|
||
* 定义/调用:定义于IEC104_Link.c;主站准备STOPDT_ACT及接收STOPDT_CON使用。
|
||
* 输入参数:state——已通过完整合法性检查的链路状态。
|
||
* 输出参数:无,不修改state。
|
||
* 返回值:acked_nr==vr,或在途S帧s_ack_nr==vr时为1,否则为0。
|
||
* 说明:前置条件:state已通过完整状态校验;调用方保证同连接FIFO与事件串行顺序。
|
||
* 返回1不等于S已发送完成,不能据此推进acked_nr;旧V(R)快照不算完整覆盖。
|
||
*/
|
||
int IEC104_Link_Rx_Ack_Covered_Internal(const IEC104_LinkState_t *state);
|
||
|
||
/**
|
||
* 功能:编码一帧S确认并保存它的实际N(R)快照,供普通确认及两端STOPDT复用。
|
||
* 定义/调用:定义于IEC104_Link.c;公共S准备、主站/子站停止准备调用。
|
||
* 输入参数:state——链路状态;response——输出缓冲;receive_number——规划的N(R)。
|
||
* 输出参数:成功写入response,设置s_ack_nr及S_ACK_SEND_PENDING;不更新acked_nr。
|
||
* 返回值:6表示构帧成功,-1表示编码失败且不提交状态;不执行网络发送。
|
||
* 说明:前置条件:state已校验且无S帧在途;response非NULL且至少有IEC104_APCI_LEN字节;
|
||
* receive_number是本次选定的有效15位确认号。容量和是否应确认由调用方判断。
|
||
* 完整发送后才能通过Complete_S_Ack_Send提交确认;本函数不重新读取vr或规划报文。
|
||
*/
|
||
int IEC104_Link_Prepare_S_Ack_Internal(IEC104_LinkState_t *state,
|
||
uint8_t *response, uint16_t receive_number);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* IEC104_LINK_INTERNAL_H */
|