2e9272cc8a
引入成熟 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 工程改动,未烧板。
94 lines
5.2 KiB
C
94 lines
5.2 KiB
C
/* 信息对象与ASDU的内部协作,不作为业务API。
|
||
* ASDU使用类型描述计算布局;具体对象通过只读函数表编码;解码按Type ID另行分派。
|
||
* 字节辅助函数不读写连接状态,也不依赖结构体对齐或主机字节序。 */
|
||
#ifndef IEC60870_INFORMATION_OBJECTS_INTERNAL_H
|
||
#define IEC60870_INFORMATION_OBJECTS_INTERNAL_H
|
||
|
||
#include "IEC60870_InformationObjects.h"
|
||
|
||
/* 单个文件段LOS最多255字节,另有4字节文件段头和最多3字节IOA。
|
||
* 即使对象可表示更长载荷,ASDU容器仍按配置的总长上限返回FULL。 */
|
||
#define IEC60870_OBJECT_MAX_PAYLOAD 259U
|
||
#define IEC60870_OBJECT_MAX_ENCODED (IEC60870_OBJECT_MAX_PAYLOAD + 3U)
|
||
|
||
/* 每个类型独立的只读编码函数表;解码仍由Type ID选择具体类型的解析函数。
|
||
* encode仅写临时载荷,公共入口验证后原子提交;变长类型提供两个长度回调。 */
|
||
typedef struct IEC60870_InformationObjectVTable {
|
||
uint8_t type_id; /* 线上类型标识;同时用于核对对象基类身份。 */
|
||
uint16_t payload_size; /* 固定类型的精确长度;变长类型的最低长度,不含IOA。 */
|
||
uint8_t single_object; /* 1表示仅允许一个对象;SQ约束由supports_sequence独立决定。 */
|
||
size_t object_size; /* 具体C结构的sizeof,用于输出存储检查,与线上长度无关。 */
|
||
int (*encode)(const IEC60870_InformationObject_t *object, uint8_t *payload); /* 写临时载荷,1成功/0字段非法。 */
|
||
uint8_t supports_sequence; /* 1允许SQ=1;参数类型仅支持SQ=0、一个对象。 */
|
||
uint16_t (*get_payload_size)(const IEC60870_InformationObject_t *object); /* NULL为固定长度。 */
|
||
uint16_t (*get_payload_size_from_buffer)(const uint8_t *payload, uint16_t length); /* 变长载荷精确长度;0非法。 */
|
||
} IEC60870_InformationObjectVTable;
|
||
|
||
/**
|
||
* 功能:未支持的Type ID返回NULL;地址和长度校验由使用方在读报文前完成。
|
||
* 输入参数:type_id——报文或已初始化对象中的类型标识。
|
||
* 输出参数:无。
|
||
* 返回值:支持时返回静态描述表指针,未知类型返回NULL。
|
||
* 说明:表中保存载荷长度、对象存储尺寸、单对象限制和编码函数;不解析值字段。
|
||
*/
|
||
const IEC60870_InformationObjectVTable *IEC60870_InformationObject_Get_Descriptor(uint8_t type_id);
|
||
|
||
/**
|
||
* 功能:按Type ID调用具体Get_From_Buffer;object==NULL时仅验证,不输出。
|
||
* 输入参数:type_id——需要解析的具体类型。 ioa——已还原的地址,0..0xFFFFFF。 payload——不含IOA的载荷;只有0字节载荷的读命令允许NULL。 length——载荷字节数,
|
||
* 须精确匹配该类型。 object_size——非空object的可用字节数,至少为该具体结构的sizeof。
|
||
* 输出参数:object——匹配具体类型的输出存储;NULL表示仅校验,不输出对象。
|
||
* 返回值:OK为成功,UNSUPPORTED为未知类型,ERROR为地址、长度、字段或存储尺寸非法。
|
||
* 说明:object_size是调用方实际提供的容量,必须至少为所选具体类型的sizeof; 非空object必须对应该具体结构,尺寸足够不能替代类型匹配。失败不修改输出。
|
||
*/
|
||
IEC60870_AsduResult_t IEC60870_InformationObject_Decode(uint8_t type_id, uint32_t ioa,
|
||
const uint8_t *payload, uint16_t length, void *object, size_t object_size);
|
||
|
||
/**
|
||
* 功能:从低字节在前的字节序列读取无符号值。
|
||
* 输入参数:data——至少length字节的有效输入,调用方先完成边界检查。
|
||
* length——1..4,用于1/2/3字节地址或2/4字节数值。
|
||
* 输出参数:无。
|
||
* 返回值:按位拼接的uint32_t,未使用高位为0。
|
||
* 说明:逐字节读,允许未对齐输入;不检查指针或范围。
|
||
*/
|
||
static inline uint32_t IEC60870_Object_Read_LE(const uint8_t *data, unsigned int length)
|
||
{
|
||
uint32_t value = 0;
|
||
unsigned int i;
|
||
for (i = 0; i < length; ++i) {
|
||
value |= (uint32_t)data[i] << (8U * i);
|
||
}
|
||
return value;
|
||
}
|
||
|
||
/**
|
||
* 功能:将数值低length字节按低字节在前写入报文。
|
||
* 输入参数:value——待写数值;需要保留的高位是否越界由调用方预先检查。
|
||
* length——1..4;只写指定字节数,不写尾部填充。
|
||
* 输出参数:data——至少length字节的可写区域。
|
||
* 返回值:无。
|
||
* 说明:逐字节写,不要求对齐;IOA必须先按所选宽度校验,防止被静默截断。
|
||
*/
|
||
static inline void IEC60870_Object_Write_LE(uint8_t *data, uint32_t value, unsigned int length)
|
||
{
|
||
unsigned int i;
|
||
for (i = 0; i < length; ++i) {
|
||
data[i] = (uint8_t)(value >> (8U * i));
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 功能:计算所选IOA字段宽度能够表示的最大地址。
|
||
* 输入参数:parameters——非空且已通过AppLayerParameters_Valid校验,sizeOfIOA为1..3。
|
||
* 输出参数:无。
|
||
* 返回值:分别为0xFF、0xFFFF或0xFFFFFF。
|
||
* 说明:位移最多24位;本函数不检查参数,非法宽度不得传入。
|
||
*/
|
||
static inline uint32_t IEC60870_Object_Max_IOA(const IEC60870_AppLayerParameters_t *parameters)
|
||
{
|
||
return (UINT32_C(1) << (8U * (unsigned int)parameters->sizeOfIOA)) - 1U;
|
||
}
|
||
|
||
#endif /* IEC60870_INFORMATION_OBJECTS_INTERNAL_H */
|