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。
55 lines
2.6 KiB
C
55 lines
2.6 KiB
C
/* 101/104共用的ASDU公共头解析与参数检查,不包含传输帧接口。 */
|
||
#ifndef IEC60870_CODEC_H
|
||
#define IEC60870_CODEC_H
|
||
|
||
#include "IEC60870_Types.h"
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/* ASDU公共头的解析结果;本模块不解析具体信息对象,调用方按type_id另行处理。 */
|
||
typedef struct {
|
||
uint8_t type_id; /* 类型标识 */
|
||
uint8_t object_count; /* VSQ中的信息对象数量 */
|
||
uint8_t is_sequence; /* VSQ中的SQ标志 */
|
||
uint8_t cause_of_transmission; /* 传送原因,不含标志位 */
|
||
uint8_t is_negative_confirm; /* 传送原因中的P/N标志 */
|
||
uint8_t is_test; /* 传送原因中的TEST标志 */
|
||
uint8_t originator_address; /* 源发地址 */
|
||
uint16_t common_address; /* ASDU公共地址 */
|
||
const uint8_t *information_objects; /* 信息对象区首地址 */
|
||
uint16_t information_objects_len; /* 信息对象区长度 */
|
||
const IEC60870_AppLayerParameters_t *parameters; /* 借用本次解析参数,不可修改。 */
|
||
} IEC60870_AsduInfo_t;
|
||
|
||
/**
|
||
* 功能:校验应用层字段宽度、默认源发地址及ASDU总长上限。
|
||
* 输入参数:parameters——待检查参数,允许NULL。
|
||
* 输出参数:无。
|
||
* 返回值:合法返回1,NULL或非法值返回0。
|
||
* 说明:不修改参数,不替调用方选择101/104的传输配置。
|
||
*/
|
||
extern int IEC60870_AppLayerParameters_Valid(const IEC60870_AppLayerParameters_t *parameters);
|
||
|
||
/**
|
||
* 功能:检查ASDU公共头及已知固定长度对象的最低载荷长度,解析公共头。
|
||
* 输入参数:parameters——非空应用层参数;asdu——ASDU首地址;asdu_len——总长度。
|
||
* 输出参数:asdu_info——解析成功时写入公共头字段和信息对象区位置。
|
||
* 返回值:解析成功返回1,参数或长度非法返回0且不修改asdu_info。
|
||
* 说明:头长为2+sizeOfCOT+sizeOfCA,IOA及最低载荷长度按sizeOfIOA计算。
|
||
* 未知/变长类型及零对象不做载荷检查;不检查多余尾字节、SQ/数量的类型约束、
|
||
* 传送原因、地址或信息对象内容是否合法。接收器在链路受理前调用本函数。
|
||
* information_objects及parameters均为借用,取对象期间报文和参数必须有效且不变。
|
||
*/
|
||
extern int IEC60870_Parse_ASDU_Header(const IEC60870_AppLayerParameters_t *parameters,
|
||
const uint8_t *asdu,
|
||
uint16_t asdu_len,
|
||
IEC60870_AsduInfo_t *asdu_info);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /* IEC60870_CODEC_H */
|