448 lines
24 KiB
C
448 lines
24 KiB
C
/*
|
|
* COMTRADE 1999 编码器:CFG 逐字符输出 ASCII,DAT 逐字段输出小端字节。
|
|
* 不直接写 C 结构体,避免结构体填充、宿主字节序和指针对文件格式的影响。
|
|
*/
|
|
#include "IEC60870_Comtrade.h"
|
|
|
|
#include <string.h>
|
|
|
|
/* bytes=NULL 时仅计数;同一套输出逻辑用于容量测算和实际生成。 */
|
|
typedef struct {
|
|
char *bytes;
|
|
size_t length;
|
|
} ComtradeText;
|
|
|
|
/* 此顺序同时约束 CFG 通道表与 DAT 模拟量,采样接入方须按语义填充帧。 */
|
|
static const char *const analog_names[8] = {"Ua", "Ub", "Uc", "U0", "Ia", "Ib", "Ic", "I0"};
|
|
static const char *const analog_phases[8] = {"A", "B", "C", "N", "A", "B", "C", "N"};
|
|
|
|
/**
|
|
* 功能:最底层输出不检查容量;上层先以 bytes=NULL 完整计数,再校验容量并复用同一路径。
|
|
* 输入参数:text——文本计数/输出状态;bytes为NULL时只累计长度;value——待输出的单个字符。
|
|
* 输出参数:text——累计字符数及非NULL目标缓冲中的文本。
|
|
* 返回值:无。
|
|
* 说明:length 包含所有已输出字符,只有显式传入 NUL 时才计入字符串结束符。
|
|
*/
|
|
static void Text_Char(ComtradeText *text, char value)
|
|
{
|
|
if (text->bytes != NULL) { text->bytes[text->length] = value; }
|
|
++text->length;
|
|
}
|
|
|
|
/**
|
|
* 功能:写入已经过元数据校验的文本,不复制源字符串末尾的 NUL。
|
|
* 输入参数:text——文本计数/输出状态;bytes为NULL时只累计长度;value——待校验或输出的文本。
|
|
* 输出参数:text——累计字符数及非NULL目标缓冲中的文本。
|
|
* 返回值:无。
|
|
* 说明:文本目标容量由上层预先计数并检查,此辅助入口不扩容。
|
|
*/
|
|
static void Text_String(ComtradeText *text, const char *value)
|
|
{
|
|
while (*value != '\0') { Text_Char(text, *value++); }
|
|
}
|
|
|
|
/**
|
|
* 功能:width 是最少位数,前补零但不截断较长数字;不依赖 printf 或本机区域设置。
|
|
* 输入参数:text——文本计数/输出状态;bytes为NULL时只累计长度;value——待处理数值;width——十进制文本最少位数。
|
|
* 输出参数:text——累计字符数及非NULL目标缓冲中的文本。
|
|
* 返回值:无。
|
|
* 说明:文本目标容量由上层预先计数并检查,此辅助入口不扩容。
|
|
*/
|
|
static void Text_Unsigned(ComtradeText *text, uint32_t value, unsigned width)
|
|
{
|
|
char digits[10];
|
|
unsigned count = 0U;
|
|
do { digits[count++] = (char)('0' + value % 10U); value /= 10U; } while (value != 0U);
|
|
while (width > count) { Text_Char(text, '0'); --width; }
|
|
while (count != 0U) { Text_Char(text, digits[--count]); }
|
|
}
|
|
|
|
/**
|
|
* 功能:拒绝逗号和控制字符,防止一个名称意外增加 CFG 字段或行;也拒绝非 ASCII。
|
|
* 输入参数:value——待校验或输出的文本。
|
|
* 输出参数:无。
|
|
* 返回值:true表示非空且满足CFG文本字符限制,false表示NULL、空串或非法字符。
|
|
* 说明:只根据传入数据计算或判定,不改写输入对象。
|
|
*/
|
|
static bool Text_Valid(const char *value)
|
|
{
|
|
size_t i;
|
|
if (value == NULL || value[0] == '\0') { return false; }
|
|
for (i = 0U; i <= IEC60870_COMTRADE_TEXT_MAX; ++i) {
|
|
unsigned char c = (unsigned char)value[i];
|
|
if (c == 0U) { return true; }
|
|
if (c < 32U || c > 126U || c == (unsigned char)',') { return false; }
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* 功能:只检查十进制文本,不调用 strtod 或做浮点转换,避免区域设置和舍入影响。
|
|
* 输入参数:value——待校验或输出的文本;nonzero——是否要求尾数非零;positive——是否要求正值。
|
|
* 输出参数:无。
|
|
* 返回值:true表示十进制文本及非零/正值要求均满足,false表示任一条件不满足。
|
|
* 说明:尾数含非零数字就表示非零系数,与指数无关,不因浮点下溢被误判为零。 nonzero 用于比例系数,positive 用于一次/二次变比;允许带符号的小数和指数。
|
|
*/
|
|
static bool Number_Valid(const char *value, bool nonzero, bool positive)
|
|
{
|
|
size_t i = 0U, length = 0U;
|
|
unsigned digits = 0U, exponent = 0U;
|
|
bool negative = false, nonzero_digit = false;
|
|
if (value == NULL) { return false; }
|
|
while (length <= IEC60870_COMTRADE_NUMBER_MAX && value[length] != '\0') { ++length; }
|
|
if (length == 0U || length > IEC60870_COMTRADE_NUMBER_MAX) { return false; }
|
|
if (value[i] == '+' || value[i] == '-') { negative = value[i] == '-'; ++i; }
|
|
while (i < length && value[i] >= '0' && value[i] <= '9') {
|
|
nonzero_digit = nonzero_digit || value[i] != '0'; ++digits; ++i;
|
|
}
|
|
if (i < length && value[i] == '.') {
|
|
++i;
|
|
while (i < length && value[i] >= '0' && value[i] <= '9') {
|
|
nonzero_digit = nonzero_digit || value[i] != '0'; ++digits; ++i;
|
|
}
|
|
}
|
|
if (digits == 0U || (nonzero && !nonzero_digit) || (positive && (negative || !nonzero_digit))) { return false; }
|
|
if (i < length && (value[i] == 'e' || value[i] == 'E')) {
|
|
++i; digits = 0U;
|
|
if (i < length && (value[i] == '+' || value[i] == '-')) { ++i; }
|
|
while (i < length && value[i] >= '0' && value[i] <= '9') {
|
|
exponent = exponent * 10U + (unsigned)(value[i] - '0');
|
|
if (exponent > 99U) { return false; }
|
|
++digits; ++i;
|
|
}
|
|
if (digits == 0U) { return false; }
|
|
}
|
|
return i == length;
|
|
}
|
|
|
|
/**
|
|
* 功能:CP56 按项目的 UTC+8 标准时间解释,拒绝无效位和夏令时位。
|
|
* 输入参数:trigger——触发日历。
|
|
* 输出参数:utc_seconds——UTC纪元秒。
|
|
* 返回值:true表示触发日历有效且UTC秒转换成功,false表示时标或转换非法。
|
|
* 说明:借助公共时间模块校验日期,后续用 UTC 秒进行跨日、跨月的时间减法。
|
|
*/
|
|
static bool Trigger_Valid(const IEC60870_CP56Time2a_t *trigger, uint32_t *utc_seconds)
|
|
{
|
|
return trigger != NULL && trigger->is_invalid == 0U && trigger->is_summer_time == 0U &&
|
|
IEC60870_Time_CP56_To_Seconds(trigger, IEC60870_LOCAL_UTC_OFFSET_MINUTES, utc_seconds) != 0;
|
|
}
|
|
|
|
/**
|
|
* 功能:每个点直接从索引求相对首点的微秒,避免逐点累加舍入误差。
|
|
* 输入参数:index——零基索引;rate——采样率,单位Hz。
|
|
* 输出参数:无。
|
|
* 返回值:从首样点到指定样点的微秒数,按采样率四舍五入。
|
|
* 说明:先用 64 位乘法,再四舍五入到整数微秒;CFG 回推首点也复用此规则。
|
|
*/
|
|
static uint64_t Sample_Microseconds(size_t index, uint32_t rate)
|
|
{
|
|
return ((uint64_t)index * UINT64_C(1000000) + rate / 2U) / rate;
|
|
}
|
|
|
|
/**
|
|
* 功能:CFG 和 DAT 共用格式边界检查;本层只接受已经冻结的完整录波。
|
|
* 输入参数:recorder——冻结录波源。
|
|
* 输出参数:info——已读取的录波信息;后续格式检查失败时也可能已填写;record_bytes——单条DAT记录字节数;total_bytes——完整DAT字节数。
|
|
* 返回值:true表示录波已完整冻结且DAT长度/时标边界合法,false表示任一检查失败。
|
|
* 说明:先取得录波快照,再检查每帧宽度、总长度及微秒时标上界;内部输出在失败时不得使用。
|
|
*/
|
|
static bool Record_Info(const IEC60870_FaultRecorder_t *recorder,
|
|
IEC60870_FaultRecorderInfo_t *info, uint32_t *record_bytes, uint32_t *total_bytes)
|
|
{
|
|
uint32_t width;
|
|
if (!IEC60870_FaultRecorder_Get_Info(recorder, info) ||
|
|
info->state != IEC60870_FAULT_RECORDER_READY || info->frame_count == 0U ||
|
|
info->frame_count > UINT32_MAX || info->trigger_index >= info->frame_count ||
|
|
info->digital_count == 0U || info->digital_count > IEC60870_FAULT_RECORDER_MAX_DIGITAL ||
|
|
info->sample_rate_hz == 0U || info->sample_rate_hz > 1000000U) { return false; }
|
|
/* 点号 4 + 时标 4 + 模拟量 8*2,再加每 16 路遥信的 2 字节。
|
|
* 0xffffffff 是缺测时标,不能当作正常点的偏移;文件大小也限 uint32。 */
|
|
width = 24U + 2U * ((info->digital_count + 15U) / 16U);
|
|
if (info->frame_count > UINT32_MAX / width ||
|
|
Sample_Microseconds(info->frame_count - 1U, info->sample_rate_hz) >= UINT32_MAX) { return false; }
|
|
*record_bytes = width;
|
|
*total_bytes = (uint32_t)info->frame_count * width;
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 功能:校验全部借用字符串、通道系数和触发日历,同时回推首样点时刻。
|
|
* 输入参数:config——配置及调用期间借用的元数据;info——录波信息快照。
|
|
* 输出参数:start——首样点日历预检暂存,失败后不应使用;start_microseconds——首样点毫秒之后的0..999微秒余数。
|
|
* 返回值:true表示元数据合法且首点时标计算成功,false表示任一检查失败。
|
|
* 说明:start/start_microseconds 是内部预检暂存,公开调用在预检成功后才写用户输出。
|
|
*/
|
|
static bool Metadata_Valid(const IEC60870_ComtradeConfig_t *config,
|
|
const IEC60870_FaultRecorderInfo_t *info, IEC60870_WallTime_t *start,
|
|
uint16_t *start_microseconds)
|
|
{
|
|
uint32_t seconds;
|
|
uint64_t trigger_us, start_us, offset;
|
|
unsigned i;
|
|
if (config == NULL || !Text_Valid(config->station) || !Text_Valid(config->device) ||
|
|
config->trigger_microseconds > 999U || !Trigger_Valid(&config->trigger_time, &seconds)) { return false; }
|
|
for (i = 0U; i < 8U; ++i) {
|
|
const IEC60870_ComtradeAnalog_t *analog = &config->analog[i];
|
|
if (!Number_Valid(analog->multiplier, true, false) || !Number_Valid(analog->offset, false, false) ||
|
|
!Number_Valid(analog->primary, true, true) || !Number_Valid(analog->secondary, true, true) ||
|
|
(analog->primary_or_secondary != 'P' && analog->primary_or_secondary != 'S')) { return false; }
|
|
}
|
|
for (i = 0U; i < info->digital_count; ++i) {
|
|
if ((config->digital_names != NULL && !Text_Valid(config->digital_names[i])) ||
|
|
(config->digital_normal != NULL && config->digital_normal[i] > 1U)) { return false; }
|
|
}
|
|
/* 触发点必须落在冻结记录的 trigger_index 上。先以绝对微秒回推首点,
|
|
* 再转回本地日期,处理跨秒/跨日及闰年的借位,不手工减 CP56 字段。 */
|
|
trigger_us = (uint64_t)seconds * UINT64_C(1000000) +
|
|
(uint64_t)config->trigger_time.time.ms * 1000U + config->trigger_microseconds;
|
|
offset = Sample_Microseconds(info->trigger_index, info->sample_rate_hz);
|
|
if (offset > trigger_us) { return false; }
|
|
start_us = trigger_us - offset;
|
|
if (!IEC60870_Time_Seconds_To_Local((uint32_t)(start_us / UINT64_C(1000000)),
|
|
(uint16_t)((start_us / 1000U) % 1000U), start) || start->year < IEC60870_CP56_MIN_YEAR) { return false; }
|
|
*start_microseconds = (uint16_t)(start_us % 1000U);
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 功能:CFG 日期行为 dd/mm/yyyy,hh:mm:ss.ssssss,毫秒与亚毫秒余数合成六位小数。
|
|
* 输入参数:text——文本计数/输出状态;bytes为NULL时只累计长度;time——待检查的UTC毫秒或日历值;micros——毫秒之后的0..999微秒余数。
|
|
* 输出参数:text——累计字符数及非NULL目标缓冲中的文本。
|
|
* 返回值:无。
|
|
* 说明:由调用方提供已校验日历;本函数不读取系统时钟或时区。
|
|
*/
|
|
static void Text_Time(ComtradeText *text, const IEC60870_WallTime_t *time, uint16_t micros)
|
|
{
|
|
Text_Unsigned(text, time->day, 2U); Text_Char(text, '/');
|
|
Text_Unsigned(text, time->month, 2U); Text_Char(text, '/');
|
|
Text_Unsigned(text, time->year, 4U); Text_Char(text, ',');
|
|
Text_Unsigned(text, time->hour, 2U); Text_Char(text, ':');
|
|
Text_Unsigned(text, time->minute, 2U); Text_Char(text, ':');
|
|
Text_Unsigned(text, time->second, 2U); Text_Char(text, '.');
|
|
Text_Unsigned(text, (uint32_t)time->ms * 1000U + micros, 6U); Text_String(text, "\r\n");
|
|
}
|
|
|
|
/**
|
|
* 功能:只接收已校验且调用期间不变的元数据;所有行固定 CRLF,不使用本机文本模式。
|
|
* 输入参数:text——文本计数/输出状态;bytes为NULL时只累计长度;config——配置及调用期间借用的元数据;info——录波信息快照;start——首点或窗口起点;
|
|
* micros——毫秒之后的0..999微秒余数。
|
|
* 输出参数:text——累计字符数及非NULL目标缓冲中的文本。
|
|
* 返回值:无。
|
|
* 说明:仅输出 1999 版字段,时间口径由应用约定,不能在末尾追加新版时区字段。
|
|
*/
|
|
static void Build_Text(ComtradeText *text, const IEC60870_ComtradeConfig_t *config,
|
|
const IEC60870_FaultRecorderInfo_t *info, const IEC60870_WallTime_t *start, uint16_t micros)
|
|
{
|
|
unsigned i;
|
|
Text_String(text, config->station); Text_Char(text, ',');
|
|
Text_String(text, config->device); Text_String(text, ",1999\r\n");
|
|
Text_Unsigned(text, 8U + info->digital_count, 0U); Text_String(text, ",8A,");
|
|
Text_Unsigned(text, info->digital_count, 0U); Text_String(text, "D\r\n");
|
|
for (i = 0U; i < 8U; ++i) {
|
|
const IEC60870_ComtradeAnalog_t *analog = &config->analog[i];
|
|
Text_Unsigned(text, i + 1U, 0U); Text_Char(text, ',');
|
|
Text_String(text, analog_names[i]); Text_Char(text, ','); Text_String(text, analog_phases[i]);
|
|
Text_String(text, i < 4U ? ",,V," : ",,A,");
|
|
Text_String(text, analog->multiplier); Text_Char(text, ','); Text_String(text, analog->offset);
|
|
/* 通道时差为 0;有效整数范围排除 -32768,保留其缺测语义。 */
|
|
Text_String(text, ",0,-32767,32767,"); Text_String(text, analog->primary); Text_Char(text, ',');
|
|
Text_String(text, analog->secondary); Text_Char(text, ',');
|
|
Text_Char(text, analog->primary_or_secondary); Text_String(text, "\r\n");
|
|
}
|
|
for (i = 0U; i < info->digital_count; ++i) {
|
|
Text_Unsigned(text, i + 1U, 0U); Text_Char(text, ',');
|
|
if (config->digital_names != NULL) { Text_String(text, config->digital_names[i]); }
|
|
else { Text_Char(text, 'D'); Text_Unsigned(text, i + 1U, 0U); }
|
|
Text_String(text, ",,,");
|
|
Text_Char(text, config->digital_normal != NULL && config->digital_normal[i] != 0U ? '1' : '0');
|
|
Text_String(text, "\r\n");
|
|
}
|
|
/* 一段固定采样率;末点号等于帧数,时标单位为微秒,倍率固定为 1。 */
|
|
Text_Unsigned(text, info->nominal_frequency_hz, 0U); Text_String(text, "\r\n1\r\n");
|
|
Text_Unsigned(text, info->sample_rate_hz, 0U); Text_Char(text, ',');
|
|
Text_Unsigned(text, (uint32_t)info->frame_count, 0U); Text_String(text, "\r\n");
|
|
Text_Time(text, start, micros); Text_Time(text, &config->trigger_time.time, config->trigger_microseconds);
|
|
Text_String(text, "BINARY\r\n1\r\n");
|
|
}
|
|
|
|
/**
|
|
* 功能:默认值只建立可填写的元数据模板;无有效触发时刻时不能据此生成可发布文件。
|
|
* 输入参数:无。
|
|
* 输出参数:config——写入默认配置;NULL时不操作。
|
|
* 返回值:无。
|
|
* 说明:仅填写配置,不分配存储或初始化模块实例。
|
|
*/
|
|
void IEC60870_Comtrade_Config_Default(IEC60870_ComtradeConfig_t *config)
|
|
{
|
|
unsigned i;
|
|
if (config == NULL) { return; }
|
|
memset(config, 0, sizeof(*config));
|
|
config->station = "DTU"; config->device = "FAULT_RECORDER";
|
|
config->trigger_time.is_invalid = 1U;
|
|
for (i = 0U; i < 8U; ++i) {
|
|
config->analog[i].multiplier = "1"; config->analog[i].offset = "0";
|
|
config->analog[i].primary = "1"; config->analog[i].secondary = "1";
|
|
config->analog[i].primary_or_secondary = 'P';
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 功能:先验证冻结窗口与元数据,再完成计数/输出两遍;容量查询也执行完整语义校验。
|
|
* 输入参数:recorder——冻结录波源;config——配置及调用期间借用的元数据;capacity——缓冲可用容量。
|
|
* 输出参数:buffer——可选CFG缓冲;容量足够且预检通过后写入文本和终止NUL;length——成功写入不含NUL的CFG长度。
|
|
* 返回值:true表示CFG长度查询或完整生成成功;false表示输入、格式边界或容量校验失败。
|
|
* 说明:调用者必须保持输入不可变,才能保证两遍长度一致及失败时输出不变。
|
|
*/
|
|
bool IEC60870_Comtrade_Build_CFG(const IEC60870_FaultRecorder_t *recorder,
|
|
const IEC60870_ComtradeConfig_t *config, char *buffer, size_t capacity, size_t *length)
|
|
{
|
|
IEC60870_FaultRecorderInfo_t info;
|
|
IEC60870_WallTime_t start;
|
|
uint32_t width, size;
|
|
uint16_t micros;
|
|
ComtradeText text = {NULL, 0U};
|
|
if (length == NULL || (buffer == NULL && capacity != 0U) ||
|
|
!Record_Info(recorder, &info, &width, &size) || !Metadata_Valid(config, &info, &start, µs)) { return false; }
|
|
/* 第一遍只计数,容量不足时尚未写入调用方缓冲。
|
|
* 第二遍才实际生成;调用方须保证两遍之间录波和元数据不会被修改。 */
|
|
Build_Text(&text, config, &info, &start, micros);
|
|
if (buffer == NULL) { *length = text.length; return true; }
|
|
if (capacity <= text.length) { return false; }
|
|
text.bytes = buffer; text.length = 0U;
|
|
Build_Text(&text, config, &info, &start, micros);
|
|
/* NUL 方便内存中查看;它不计入文件长度,也不能随 CFG 写到磁盘。 */
|
|
buffer[text.length] = '\0'; *length = text.length;
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 功能:DAT 长度只由冻结帧数和数字通道数决定,计算时一并检查文件长度和时标上界。
|
|
* 输入参数:recorder——冻结录波源。
|
|
* 输出参数:size——非NULL长度输出;成功写入DAT总字节数,失败保持原值。
|
|
* 返回值:true表示DAT长度已计算;false表示录波未就绪、格式边界或输出指针非法。
|
|
* 说明:仅读取冻结录波信息,不生成DAT正文或移动读取位置。
|
|
*/
|
|
bool IEC60870_Comtrade_Data_Size(const IEC60870_FaultRecorder_t *recorder, uint32_t *size)
|
|
{
|
|
IEC60870_FaultRecorderInfo_t info;
|
|
uint32_t width, total;
|
|
if (size == NULL || !Record_Info(recorder, &info, &width, &total)) { return false; }
|
|
*size = total;
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 功能:显式小端输出,既不依赖 CPU 字节序,也不要求输出地址四字节对齐。
|
|
* 输入参数:value——待处理数值。
|
|
* 输出参数:bytes——编码或复制结果的目标字节区。
|
|
* 返回值:无。
|
|
* 说明:调用方保证目标区域容量足够;逐字节编码不要求地址对齐。
|
|
*/
|
|
static void Write32(uint8_t *bytes, uint32_t value)
|
|
{
|
|
unsigned i;
|
|
for (i = 0U; i < 4U; ++i) { bytes[i] = (uint8_t)(value >> (i * 8U)); }
|
|
}
|
|
|
|
/**
|
|
* 功能:一次只编码一条采样记录;index 是冻结文件中的零基索引,不是采集序号。
|
|
* 输入参数:recorder——冻结录波源;info——录波信息快照;index——零基索引。
|
|
* 输出参数:bytes——编码或复制结果的目标字节区。
|
|
* 返回值:true表示已编码完整DAT采样记录,false表示冻结帧读取失败。
|
|
* 说明:文件内点号从 1 开始,时标从 0 开始,通道顺序与 CFG 一致。
|
|
*/
|
|
static bool Build_Record(const IEC60870_FaultRecorder_t *recorder,
|
|
const IEC60870_FaultRecorderInfo_t *info, size_t index, uint8_t *bytes)
|
|
{
|
|
IEC60870_FaultRecorderFrame_t frame;
|
|
unsigned i, words = (info->digital_count + 15U) / 16U;
|
|
if (!IEC60870_FaultRecorder_Get_Frame(recorder, index, &frame)) { return false; }
|
|
Write32(bytes, (uint32_t)index + 1U);
|
|
Write32(bytes + 4U, (uint32_t)Sample_Microseconds(index, info->sample_rate_hz));
|
|
for (i = 0U; i < 8U; ++i) {
|
|
/* 有符号值转成 uint16 后取低/高字节,保留负数及 -32768 缺测编码。 */
|
|
uint16_t value = (uint16_t)frame.analog[i];
|
|
bytes[8U + i * 2U] = (uint8_t)value; bytes[9U + i * 2U] = (uint8_t)(value >> 8U);
|
|
}
|
|
for (i = 0U; i < words; ++i) {
|
|
uint16_t value = frame.digital[i];
|
|
unsigned remaining = info->digital_count - i * 16U;
|
|
/* 遥信 1 从首字 bit0 起,末字超过实际通道数的位必须为 0。 */
|
|
if (remaining < 16U) { value &= (uint16_t)((1UL << remaining) - 1UL); }
|
|
bytes[24U + i * 2U] = (uint8_t)value; bytes[25U + i * 2U] = (uint8_t)(value >> 8U);
|
|
}
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 功能:从冻结源重建所需字节切片,不保留调用间游标;因此乱序读取和重传均可复用。
|
|
* 输入参数:recorder——冻结录波源;offset——文件或映像内的字节偏移;length——字节数。
|
|
* 输出参数:buffer——编码或复制结果的目标字节区。
|
|
* 返回值:true表示请求字节范围已复制;false表示录波、范围或目标缓冲无效。
|
|
* 说明:读取期间源记录不得 Release,否则无法维持同偏移字节一致的文件契约。
|
|
*/
|
|
bool IEC60870_Comtrade_Read_DAT(const IEC60870_FaultRecorder_t *recorder,
|
|
uint32_t offset, uint8_t *buffer, size_t length)
|
|
{
|
|
IEC60870_FaultRecorderInfo_t info;
|
|
uint32_t width, total;
|
|
size_t copied = 0U;
|
|
uint8_t bytes[24U + 2U * IEC60870_FAULT_RECORDER_DIGITAL_WORDS];
|
|
if ((buffer == NULL && length != 0U) || !Record_Info(recorder, &info, &width, &total) ||
|
|
offset > total || length > (size_t)(total - offset)) { return false; }
|
|
/* 以“所在帧 + 帧内偏移”切片,支持网络分段边界落在任意字段内部。
|
|
* 仅使用一帧的小缓冲,无须保存第二份完整 DAT;冻结源保证重读相同。
|
|
* 整个范围已在写输出前检查,EOF 处零长度读取会直接成功。 */
|
|
while (copied < length) {
|
|
size_t index = offset / width;
|
|
size_t within = offset % width;
|
|
size_t amount = width - within;
|
|
if (amount > length - copied) { amount = length - copied; }
|
|
if (!Build_Record(recorder, &info, index, bytes)) { return false; }
|
|
memcpy(buffer + copied, bytes + within, amount);
|
|
copied += amount; offset += (uint32_t)amount;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 功能:用同一触发时间、间隔号和序号为 CFG/DAT 构造配对名称;不产生目录或持久化副作用。
|
|
* 输入参数:bay——间隔编号;sequence——顺序号;trigger_time——触发日历;data_file——true生成DAT名称,false生成CFG名称;capacity——缓冲可用容量。
|
|
* 输出参数:buffer——编码或复制结果的目标字节区。
|
|
* 返回值:true表示文件名已完整生成;false表示参数非法或容量不足,输出不变。
|
|
* 说明:调用方管理序号和同名文件冲突;本函数不自动递增序号。
|
|
*/
|
|
bool IEC60870_Comtrade_File_Name(uint8_t bay, uint16_t sequence,
|
|
const IEC60870_CP56Time2a_t *trigger_time, bool data_file, char *buffer, size_t capacity)
|
|
{
|
|
uint32_t seconds;
|
|
ComtradeText text;
|
|
const IEC60870_WallTime_t *time;
|
|
if (bay == 0U || bay > 99U || sequence == 0U || sequence > 9999U || buffer == NULL ||
|
|
capacity < IEC60870_COMTRADE_FILENAME_CAPACITY || !Trigger_Valid(trigger_time, &seconds)) { return false; }
|
|
/* 固定宽度字段保证 CFG/DAT 同名配对;仅使用触发时刻,不读取当前时钟。
|
|
* 此处不创建目录、不检查磁盘重名,也不自动推进序号。 */
|
|
time = &trigger_time->time; text.bytes = buffer; text.length = 0U;
|
|
Text_String(&text, "BAY"); Text_Unsigned(&text, bay, 2U); Text_Char(&text, '_');
|
|
Text_Unsigned(&text, sequence, 4U); Text_Char(&text, '_');
|
|
Text_Unsigned(&text, time->year, 4U); Text_Unsigned(&text, time->month, 2U); Text_Unsigned(&text, time->day, 2U);
|
|
Text_Char(&text, '_'); Text_Unsigned(&text, time->hour, 2U); Text_Unsigned(&text, time->minute, 2U);
|
|
Text_Unsigned(&text, time->second, 2U); Text_Char(&text, '_'); Text_Unsigned(&text, time->ms, 3U);
|
|
Text_String(&text, data_file ? ".dat" : ".cfg"); Text_Char(&text, '\0');
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 功能:只计算合法四位序号的下一值;回绕不代表旧同名文件已经安全回收。
|
|
* 输入参数:sequence——顺序号。
|
|
* 输出参数:无。
|
|
* 返回值:1..9999循环序号的下一值;9999回到1,0或大于9999的非法输入返回0。
|
|
* 说明:只根据传入数据计算或判定,不改写输入对象。
|
|
*/
|
|
uint16_t IEC60870_Comtrade_Next_Sequence(uint16_t sequence)
|
|
{
|
|
if (sequence == 0U || sequence > 9999U) { return 0U; }
|
|
return sequence == 9999U ? 1U : (uint16_t)(sequence + 1U);
|
|
}
|