Files
STM32F4-Base/IEC60870-Slave/common/IEC60870_FaultEvent.h
T
STF bdcc8b6500
CI / L0 静态门禁 (pre-commit) (push) Failing after 7m46s
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 21s
添加遥控、参数装载、文件传输等业务
2026-11-16 22:19:17 -08:00

147 lines
8.6 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.
/*
* Type42故障事件信息:扩展格式的完整ASDU编解码,101/104共用。
* 此处内部字段采用已确认的接收端格式约定,不是基础IEC 101/104对保留编号42的定义。
* 公共头之后是两组数量/类型和记录,无普通信息对象的外层IOA。
* 遥信数量N、遥信类型、遥测数量M、遥测类型四个字段各占1字节,其中只有N/M是数量。
* 每组共用一个内部类型;两类IOA均使用同一链路宽度L,类型字段本身不是一条普通ASDU。
* 输入快照、输出缓冲和解析视图均由调用方持有;不分配内存、不读取系统时间。
*/
#ifndef IEC60870_FAULT_EVENT_H
#define IEC60870_FAULT_EVENT_H
#include "IEC60870_Asdu.h"
#ifdef __cplusplus
extern "C" {
#endif
/* 同一报文的遥信类型统一为1/3/30/31;四种类型均带CP56,不按类型省略时标。
* value是完整SIQ/DIQ:单点只允许0xF1中的位,双点只允许0xF3中的位。
* 位掩码校验允许状态和合法品质同时存在,调用方不能把value误当成单独的0/1或0..3。
* 接收端对完整状态字节的显示判断可能与状态位解释不同;本层不为界面显示抹去品质位。
* 双点状态按原始两位码保留,不根据接收端显示文字重映射状态。
* timestamp表示已冻结的日历时间及IV/SU;它不是可原样回显的七字节时标副本。 */
typedef struct {
uint32_t ioa;
uint8_t value;
IEC60870_CP56Time2a_t timestamp;
} IEC60870_FaultEventSignal_t;
/* 类型13读取short_float;9/11读取unsigned_value原始16位码。
* 此扩展格式将2字节测量值按无符号原码处理,本接口不做有符号转换、归一化或倍率换算。
* 因此需传负值时优先使用类型13;把负整数转成uint16_t只会保留补码,不能保留负值语义。
* 测量值后没有QDS,报文里也没有独立遥测时标;应用必须传入故障时刻的值。 */
typedef struct {
uint32_t ioa;
union {
uint16_t unsigned_value;
float short_float;
} value;
} IEC60870_FaultEventMeasurement_t;
/* 两组数量均为0..255;非零数量要求对应数组非NULL。
* 数量使用size_t保留调用方原值,编码前检查255上限,不通过截窄接受更大的数组。
* N=0或M=0不省略对应数量/类型字段,两组都空仍保留这4字节;内部类型仍须合法。
* 公共编码层允许任一组为空,不检查电气量种类、点表、重复地址或故障业务完整性。
* 业务上送入口另外要求故障遥信及八项必要电气量。
* 数组只在Encode调用期间借用;等待重试的调用方必须保留同一份冻结快照。 */
typedef struct {
uint8_t signal_type;
uint8_t measurement_type;
const IEC60870_FaultEventSignal_t *signals;
size_t signal_count;
const IEC60870_FaultEventMeasurement_t *measurements;
size_t measurement_count;
} IEC60870_FaultEvent_t;
/* Parse成功建立的只读借用视图;调用方不得修改其字段。
* parameters和asdu须在取记录期间保持有效且内容不变;Getter输出按值复制。
* 数量取自报文体,独立于VSQ;header不将VSQ解释为记录个数。
* Getter重新校验报文是失败原子性的保障,不授权调用方修改借用输入,也不能检测悬空指针。
* 报文缓冲需复用时,应先完成取值或自行保存原文,再为新原文重新Parse。 */
typedef struct {
IEC60870_AsduHeader_t header;
const IEC60870_AppLayerParameters_t *parameters;
const uint8_t *asdu;
uint16_t length;
uint8_t signal_type;
uint8_t signal_count;
uint8_t measurement_type;
uint8_t measurement_count;
} IEC60870_FaultEventView_t;
/**
* 功能:初始化调用方持有的故障快照描述,不申请或释放数组。
* 输入参数:event——可写描述,允许NULL;原有数组指针不会被释放。
* 输出参数:event——默认遥信30、遥测13,其余成员清零。
* 返回值:无;NULL时不操作。
* 说明:默认短浮点便于保存有符号电气量,避免2字节负值原码被按无符号数解释。
* 初始化不创建时标或点表,也不表示已具备业务上送要求的遥信和八项测量。
*/
void IEC60870_FaultEvent_Init(IEC60870_FaultEvent_t *event);
/**
* 功能:预检完整故障快照后编码一条ASDU,不含APCI,不自动拆分。
* 输入参数:parameters——合法链路参数,两类地址均按sizeOfIOA低字节在前编码。
* header——COT=3、P/N=0,TEST为0/1;CA仅检查宽度,不检查站注册或业务地址范围。
* event——两组冻结记录,类型和数量即使在数组为空时仍须合法。
* capacity——out实际可写字节数;总长还受maxSizeOfASDU限制。
* 输出参数:out/out_length——仅OK时写入完整原文及包含公共头的总长。
* 返回值:OK成功;非法字段/指针返回ERROR;内容合法但容量不足返回FULL。
* 前提:调用期间所有输入保持有效且不变;输入与输出、两个输出之间均不得重叠。
* 说明:先完整检查字段,再检查容量;同一输入兼有字段错误与容量不足时返回ERROR。
* VSQ固定0x01作为占位,不表示内部遥信或遥测数量;无独立遥信地址宽度。
* 短浮点仅接受有限binary32;CP56保留日历及IV/SU,不取当前时间、不换算时区。
* CP56在has_weekday=1时按日期生成星期,否则星期填0;GEN固定为0,其余保留位清零。
* 编解码保留时间语义,不能原样回显收到的七字节时标。
* 本专用入口不走Asdu_Add_InformationObject,也不创建普通对象函数表。
*/
IEC60870_AsduResult_t IEC60870_FaultEvent_Encode(
const IEC60870_AppLayerParameters_t *parameters,
const IEC60870_AsduHeader_t *header, const IEC60870_FaultEvent_t *event,
uint8_t *out, uint16_t capacity, uint16_t *out_length);
/**
* 功能:校验完整Type42原文及每条记录,建立供逐项读取的借用视图。
* 输入参数:parameters——对应原文的链路参数;asdu/length——不含APCI的完整ASDU及总长。
* 输出参数:view——全部校验成功后写入公共头、两组数量/类型及借用引用;失败不变。
* 返回值:OK成功;非法参数、类型、内容或长度一律返回ERROR,不返回半份解析结果。
* 前提:输出不与输入重叠;输入存储在Parse及后续Getter期间保持有效且不变。
* 说明:仅接受Type42、COT=3/P/N=0及明确支持的内部类型,TEST保留;VSQ的数值和SQ被忽略。
* 按两组计数核对精确总长,既拒绝截短,也拒绝额外尾字节,不用前缀成功掩盖后半帧错误。
* 普通Asdu_Parse仍只解析普通对象布局,Type42须调用本入口。
*/
IEC60870_AsduResult_t IEC60870_FaultEvent_Parse(
const IEC60870_AppLayerParameters_t *parameters,
const uint8_t *asdu, uint16_t length, IEC60870_FaultEventView_t *view);
/**
* 功能:按值取出指定遥信及其CP56日历,不再借用单条记录。
* 输入参数:view——Parse建立的有效视图;index——从0开始,须小于遥信数量N。
* 输出参数:signal——完整地址、SIQ/DIQ和时标;失败保持不变。
* 返回值:OK成功;NULL、越界或借用原文校验失败返回ERROR。
* 前提:输出不与view、parameters或原文重叠;原文/参数寿命和不可变要求仍适用。
* 说明:重验整帧后才输出该记录;不读取系统时间,也不改变视图。
* CP56解析输出为日历语义,星期重新推导且不保存GEN,不能代替原始七字节时标。
*/
IEC60870_AsduResult_t IEC60870_FaultEvent_Get_Signal(
const IEC60870_FaultEventView_t *view, size_t index,
IEC60870_FaultEventSignal_t *signal);
/**
* 功能:按值取出指定遥测;类型13输出float,9/11输出uint16_t原码。
* 输入参数:view——Parse建立的有效视图;index——从0开始,须小于遥测数量M。
* 输出参数:measurement——完整地址及所选类型的值成员;失败保持不变。
* 返回值:OK成功;NULL、越界或借用原文校验失败返回ERROR。
* 前提:输出不与view、parameters或原文重叠;输入存储仍须有效且不变。
* 说明:重验整帧不表示允许并发修改原文;本函数不缩放数值,也不补造QDS或接收时刻。
*/
IEC60870_AsduResult_t IEC60870_FaultEvent_Get_Measurement(
const IEC60870_FaultEventView_t *view, size_t index,
IEC60870_FaultEventMeasurement_t *measurement);
#ifdef __cplusplus
}
#endif
#endif /* IEC60870_FAULT_EVENT_H */