147 lines
8.6 KiB
C
147 lines
8.6 KiB
C
/*
|
||
* 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 */
|