Files
STM32F4-Base/App/protocol/iec60870/104/IEC104_Link_Slave_StartStop.h
T
wandering1 2e9272cc8a feat(iec104): 在模拟器跑通共享协议核心与标准DTU点表
引入成熟 IEC 60870-5-104 子站的只读子集(App/protocol/iec60870,28 个源文件
按原字节复制,UPSTREAM.sha256 记录来源,兼容补丁保留全部断言与容量),在其上
装配单属主共享核心(Start/Poll/Stop/Get_Status),并把标准 DTU 演示点表全量
接入为唯一真源。

- iec104_core:threadless 推进,poll 零等待,通知/交互/COV 扫描全部有界;
  生命周期区分失败启动待重试、重复启动拒绝、断线保固化 RAM。
- iec104_dtu_table / iec104_source:标准 DTU 全点表注册,无数据源的点读 0,
  遥控只做模拟状态可读回,不触碰实际出口。
- iec104_sim:仅窗口与独立服务模式起真实 TCP,无头黄金模式保持确定性假统计。
- test/host/iec104_dtu:独立真实 TCP 11 项、传输层 10 项、生命周期与借用负例。

验证:lvgl_sim 真实 TCP 11/11、传输 10/10,UI 像素回归未回退;AC5 单 TU
编译 0 错误 0 诊断。板端尚未切换:完整库闭包 RAM 超 92% 门禁净增预算 25730B,
结论为停止转实施,记录在 IEC104_MCU最小可行性验证.md。旧实现与 board 服务
保持原样,未提交 MDK 工程改动,未烧板。
2026-11-17 20:48:00 +08:00

96 lines
4.7 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 被控站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 */