73 lines
2.7 KiB
C
73 lines
2.7 KiB
C
/* IEC 60870-5-104旧单路接收入口；包含Codec以兼容原有编解码调用方。 */
|
|
#ifndef IEC104_H
|
|
#define IEC104_H
|
|
|
|
#include "IEC104_Codec.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* 接收状态机的三个阶段。 */
|
|
typedef enum {
|
|
RX_SYNC = 0, /* 等待起始字节 0x68 */
|
|
RX_LEN, /* 等待长度域 */
|
|
RX_BODY /* 按目标长度接收控制域和 ASDU */
|
|
} IEC104_RxStage_t;
|
|
|
|
/* 逐字节接收结果；负值表示已经完成错误分类。 */
|
|
typedef enum {
|
|
IEC104_RX_INTERNAL_ERROR = -3, /* 接收器内部状态异常 */
|
|
IEC104_RX_SEQUENCE_ERROR = -2, /* I/S帧序号非法，应断开当前连接 */
|
|
IEC104_RX_FRAME_ERROR = -1, /* 长度或APCI格式非法 */
|
|
IEC104_RX_IN_PROGRESS = 0, /* 当前APDU尚未收齐 */
|
|
IEC104_RX_FRAME_READY = 1 /* 完整APDU通过APCI检查及适用的I/S序号检查；未校验ASDU内容 */
|
|
} IEC104_RxResult_t;
|
|
|
|
/* 单路字节流接收器的全部解析状态。 */
|
|
typedef struct {
|
|
uint8_t buf[IEC104_MAX_APDU_LEN]; /* 当前APDU的接收缓冲区 */
|
|
uint16_t len; /* 已经收到的字节数 */
|
|
uint16_t expected_len; /* 根据长度域计算出的完整APDU长度 */
|
|
IEC104_RxStage_t stage; /* 当前状态机阶段 */
|
|
} IEC104_RxParser_t;
|
|
|
|
/**
|
|
* 功能：向IEC-104接收状态机递入一个字节。
|
|
* 输入参数：byte——当前收到的一个字节。
|
|
* 输出参数：无。
|
|
* 返回值：返回IEC104_RxResult_t；序号错误要求调用方停止处理并断开当前连接。
|
|
* 说明：该旧单路兼容入口只返回接收结果，不向调用方输出完整报文或ASDU内容。
|
|
* 不分派STARTDT/STOPDT U帧，因此预设已启动
|
|
* 数据传输，只对I/S帧执行序号检查。完整连接应使用独立的
|
|
* IEC104_LinkState_t并显式处理启停流程。
|
|
*/
|
|
extern IEC104_RxResult_t IEC104_Rx_Feed_Byte(uint8_t byte);
|
|
|
|
/**
|
|
* 功能：丢弃当前未完成APDU并复位接收进度。
|
|
* 输入参数：无。
|
|
* 输出参数：无。
|
|
* 返回值：无。
|
|
* 说明：只重置内部接收阶段和长度，不清零接收缓冲区，不修改链路序号状态。
|
|
*/
|
|
extern void IEC104_Rx_Reset(void);
|
|
|
|
/**
|
|
* 功能：复位旧单路兼容入口的I/S序号状态。
|
|
* 输入参数：无。
|
|
* 输出参数：无。
|
|
* 返回值：无。
|
|
* 说明：清零I/S序号并恢复兼容路径的STARTED预设，不改变当前
|
|
* APDU接收进度；仅应在旧会话已经结束时调用。
|
|
* 仅影响IEC104_Rx_Feed_Byte的私有全局状态；外部独立的IEC104_LinkState_t
|
|
* 应使用IEC104_Link_State_Reset复位，后者恢复STOPPED。
|
|
*/
|
|
extern void IEC104_Legacy_Link_Reset(void);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* IEC104_H */
|