Files
STM32F4-Base/App/iec60870/common/IEC60870_Slave.c
T
wandering1 c0cef2fca0 refactor(app): 去掉 App/protocol 层,104 迁入 App/iec60870/104_port
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。
2026-11-18 14:15:10 +08:00

54 lines
2.4 KiB
C

/* 共用发送入口只做接口分派;101/104分别提供其实际处理函数。 */
#include "IEC60870_Slave.h"
/**
* 功能:将普通ASDU发送请求分派给对应协议。
* 输入参数:self——连接接口;asdu——待提交ASDU。
* 输出参数:由接入实现记录提交结果。
* 返回值:接入函数的布尔结果;连接或函数指针为空时返回false。
* 说明:ASDU合法性由接入实现检查,便于同一次调用记录准确的失败原因。
*/
bool IEC60870_MasterConnection_Send_ASDU(IEC60870_MasterConnection_t *self, IEC60870_Asdu_t *asdu)
{
return self != NULL && self->send_asdu != NULL && self->send_asdu(self, asdu);
}
/**
* 功能:将激活确认请求分派给对应协议。
* 输入参数:self——连接接口;asdu——可修改ASDU;negative——否定标志。
* 输出参数:由接入实现修改ASDU并记录提交结果。
* 返回值:接入函数的布尔结果;连接或函数指针为空时返回false。
* 说明:共用入口不依赖TCP或串口,不保存请求或执行重试。
*/
bool IEC60870_MasterConnection_Send_ACT_CON(IEC60870_MasterConnection_t *self,
IEC60870_Asdu_t *asdu, bool negative)
{
return self != NULL && self->send_act_con != NULL && self->send_act_con(self, asdu, negative);
}
/**
* 功能:将激活终止请求分派给对应协议。
* 输入参数:self——连接接口;asdu——可修改ASDU。
* 输出参数:由接入实现修改ASDU并记录提交结果。
* 返回值:接入函数的布尔结果;连接或函数指针为空时返回false。
* 说明:本入口不判断业务是否完成,调用时机由业务决定。
*/
bool IEC60870_MasterConnection_Send_ACT_TERM(IEC60870_MasterConnection_t *self, IEC60870_Asdu_t *asdu)
{
return self != NULL && self->send_act_term != NULL && self->send_act_term(self, asdu);
}
/**
* 功能:通过协议接入获取应用层参数。
* 输入参数:self——连接接口。
* 输出参数:无。
* 返回值:接入提供的只读参数指针;连接或函数指针为空时返回NULL。
* 说明:不创建默认参数,不改变连接状态,也不延长参数的生命周期。
*/
const IEC60870_AppLayerParameters_t *IEC60870_MasterConnection_Get_Application_Layer_Parameters(
IEC60870_MasterConnection_t *self)
{
if (self == NULL || self->get_application_layer_parameters == NULL) { return NULL; }
return self->get_application_layer_parameters(self);
}