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