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 工程改动,未烧板。
96 lines
4.7 KiB
C
96 lines
4.7 KiB
C
/*
|
||
* 被控站STARTDT/STOPDT:受理时改变传输状态,发送完成只校验CON结果。
|
||
* 本层不执行socket I/O、不维护发送队列、不计时;所有调用必须串行。
|
||
*/
|
||
#ifndef IEC104_LINK_SLAVE_STARTSTOP_H
|
||
#define IEC104_LINK_SLAVE_STARTSTOP_H
|
||
#include "IEC104_Link_Common.h"
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/**
|
||
* 功能:每个合法STARTDT_ACT生成6字节CON,立即置STARTED/IDLE,可结束停止等待。
|
||
* 输入参数:state——当前状态。
|
||
* apci——APCI控制头。
|
||
* response——应答。
|
||
* capacity——存储容量。
|
||
* 输出参数:state——当前状态的更新结果。
|
||
* response——应答的更新结果。
|
||
* 返回值:按处理分支返回IEC104_LINK_RESULT_FATAL、IEC104_LINK_RESULT_OK。
|
||
* 说明:先预留发送空间再调用,OK后按FIFO提交;提交失败须断链,不能回滚后重放。
|
||
* 不暂存相反请求、不撤回已排队CON、不重置序号;非法输入FATAL且不修改输出。
|
||
*/
|
||
extern IEC104_LinkResult_t IEC104_Link_Handle_Startdt_Act(
|
||
IEC104_LinkState_t *state, const IEC104_ApciInfo_t *apci,
|
||
uint8_t *response, uint16_t capacity);
|
||
|
||
/**
|
||
* 功能:恰好6字节为OK,否则FATAL;完成不修改当前启停状态。
|
||
* 输入参数:state——当前状态。
|
||
* sent_len——字节长度。
|
||
* 输出参数:无。
|
||
* 返回值:返回IEC104_Link_Role_Valid_Internal(state, IEC104_ROLE_CONTROLLED) && sent_len == IEC104_APCI_LEN ? IEC104_LINK_RESULT_OK : IEC104_LINK_RESULT_FATAL的结果。
|
||
* 说明:完成不能重新激活链路。
|
||
*/
|
||
extern IEC104_LinkResult_t IEC104_Link_Complete_Startdt_Con_Send(
|
||
IEC104_LinkState_t *state, int sent_len);
|
||
|
||
/**
|
||
* 功能:合法STOP立即置STOPPED/STOP_DRAINING,返回OK,不生成报文。
|
||
* 输入参数:state——当前状态。
|
||
* apci——APCI控制头。
|
||
* 输出参数:state——当前状态的更新结果。
|
||
* 返回值:按处理分支返回IEC104_LINK_RESULT_FATAL、IEC104_LINK_RESULT_IGNORED、IEC104_LINK_RESULT_OK。
|
||
* 说明:既有START_CON仍按FIFO完成;不等待它、不暂存STOP、不因启停交错断链。
|
||
* 排空中的重复STOP返回IGNORED且不延长期限;STOPPED/IDLE再次STOP会重新应答。
|
||
* 非法输入返回FATAL且不修改状态。
|
||
*/
|
||
extern IEC104_LinkResult_t IEC104_Link_Handle_Stopdt_Act(
|
||
IEC104_LinkState_t *state, const IEC104_ApciInfo_t *apci);
|
||
|
||
/**
|
||
* 功能:只读查询:1可生成S或STOP_CON,0无义务或等待,-1非法。
|
||
* 输入参数:state——当前状态。
|
||
* 输出参数:无。
|
||
* 返回值: 返回1表示可准备必要的S确认或STOPDT_CON,0表示尚不可准备,-1表示状态或角色非法。
|
||
* 说明:返回1表示可准备必要的S确认或STOPDT_CON,0表示尚不可准备,-1表示状态或角色非法。
|
||
*/
|
||
extern int IEC104_Link_Can_Prepare_Stopdt_Response(const IEC104_LinkState_t *state);
|
||
|
||
/**
|
||
* 功能:先确认已收到的数据,再等待本端已预留I帧获ACK,不发送新的业务I帧。
|
||
* 输入参数:state——当前状态。
|
||
* response——应答。
|
||
* capacity——存储容量。
|
||
* tx——IEC104_StopdtTx_t *所指数据。
|
||
* 输出参数:state——当前状态的更新结果。
|
||
* response——应答的更新结果。
|
||
* tx——IEC104_StopdtTx_t *所指数据的更新结果。
|
||
* 返回值:按处理分支返回IEC104_STOPDT_PREPARE_ERROR、readiness、IEC104_STOPDT_FRAME_READY。
|
||
* 说明:已排队且覆盖V(R)的S允许STOP_CON紧随排队,发送及完成顺序由FIFO保证。
|
||
* FRAME_READY写response和tx;生成STOP_CON即结束排空,保持STOPPED。
|
||
* 后到START可结束未生成CON的排空;已生成的CON仍须按序完成。
|
||
* WAIT_SEND等既有S,WAIT_PEER_ACK等I帧确认,NOT_ACTIVE表示无停止义务。
|
||
*/
|
||
extern IEC104_StopdtPrepareResult_t IEC104_Link_Prepare_Stopdt_Response(
|
||
IEC104_LinkState_t *state, uint8_t *response, uint16_t capacity,
|
||
IEC104_StopdtTx_t *tx);
|
||
|
||
/**
|
||
* 功能:恰好6字节为OK,否则FATAL;旧STOP_CON完成不覆盖后到START的状态。
|
||
* 输入参数:state——当前状态。
|
||
* sent_len——字节长度。
|
||
* 输出参数:无。
|
||
* 返回值:返回IEC104_Link_Role_Valid_Internal(state, IEC104_ROLE_CONTROLLED) && sent_len == IEC104_APCI_LEN ? IEC104_LINK_RESULT_OK : IEC104_LINK_RESULT_FATAL的结果。
|
||
* 说明:内部调用:IEC104_Link_Role_Valid_Internal。
|
||
*/
|
||
extern IEC104_LinkResult_t IEC104_Link_Complete_Stopdt_Con_Send(
|
||
IEC104_LinkState_t *state, int sent_len);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif /* IEC104_LINK_SLAVE_STARTSTOP_H */
|