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 */
|