322 lines
16 KiB
C
322 lines
16 KiB
C
/* Independent COMTRADE text/byte expectations, including unaligned file reads. */
|
|
#include "../common/IEC60870_Comtrade.h"
|
|
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
|
|
#define CHECK(expression) do { if (!(expression)) { \
|
|
fprintf(stderr, "FAIL line %d: %s\n", __LINE__, #expression); exit(1); } } while (0)
|
|
|
|
static IEC60870_FaultRecorder_t recorder;
|
|
static IEC60870_FaultRecorderFrame_t frames[1200];
|
|
static unsigned checks;
|
|
|
|
/**
|
|
* 功能:独立按小端字节解码DAT序号和微秒时标,不依赖宿主对齐或编码器内部函数。
|
|
* 输入参数:bytes——报文字节缓冲区(只读)。
|
|
* 输出参数:无。
|
|
* 返回值:四个小端字节还原的无符号 32 位值。
|
|
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
|
|
*/
|
|
static uint32_t Read32(const uint8_t *bytes)
|
|
{
|
|
return (uint32_t)bytes[0] | (uint32_t)bytes[1] << 8U |
|
|
(uint32_t)bytes[2] << 16U | (uint32_t)bytes[3] << 24U;
|
|
}
|
|
|
|
/**
|
|
* 功能:按指定采样率和数字量数采集一份完成录波,序号400触发。
|
|
* 输入参数:digital_count——开关量通道数量;rate——录波采样率。
|
|
* 输出参数:无。
|
|
* 返回值:无。
|
|
* 说明:模拟值随序号变化并包含INT16_MIN缺测标记,数字量全置位以检验尾字掩码。
|
|
*/
|
|
static void Prepare(uint16_t digital_count, uint32_t rate)
|
|
{
|
|
IEC60870_FaultRecorderConfig_t config;
|
|
IEC60870_FaultRecorderFrame_t sample;
|
|
IEC60870_FaultRecorderResult_t result;
|
|
size_t count;
|
|
uint64_t sequence;
|
|
unsigned channel;
|
|
IEC60870_FaultRecorder_Config_Default(&config);
|
|
config.digital_count = digital_count; config.sample_rate_hz = rate;
|
|
CHECK(IEC60870_FaultRecorder_Required_Capacity(&config, &count));
|
|
CHECK(count <= sizeof(frames) / sizeof(frames[0]));
|
|
CHECK(IEC60870_FaultRecorder_Init(&recorder, &config, frames, sizeof(frames) / sizeof(frames[0])));
|
|
for (sequence = 0U; sequence <= 400U + (uint64_t)((rate * 8U + 49U) / 50U); ++sequence) {
|
|
for (channel = 0U; channel < 8U; ++channel) {
|
|
sample.analog[channel] = (int16_t)((int)(sequence % 400U) - 200 + (int)channel * 7);
|
|
}
|
|
if (sequence == 123U) { sample.analog[0] = INT16_MIN; }
|
|
for (channel = 0U; channel < 4U; ++channel) { sample.digital[channel] = UINT16_MAX; }
|
|
result = IEC60870_FaultRecorder_Push(&recorder, sequence, &sample);
|
|
CHECK(result == IEC60870_FAULT_RECORDER_OK || result == IEC60870_FAULT_RECORDER_COMPLETE);
|
|
if (sequence == 400U) { CHECK(IEC60870_FaultRecorder_Trigger(&recorder, sequence) == IEC60870_FAULT_RECORDER_OK); }
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 功能:构造固定有效触发日历及123微秒余数,便于直接核对CFG日期、时标和文件名。
|
|
* 输入参数:无。
|
|
* 输出参数:无。
|
|
* 返回值:本组测试使用的配置值副本。
|
|
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
|
|
*/
|
|
static IEC60870_ComtradeConfig_t Metadata(void)
|
|
{
|
|
IEC60870_ComtradeConfig_t config;
|
|
IEC60870_Comtrade_Config_Default(&config);
|
|
config.trigger_time.is_invalid = 0U;
|
|
config.trigger_time.time.year = 2014U;
|
|
config.trigger_time.time.month = 11U; config.trigger_time.time.day = 14U;
|
|
config.trigger_time.time.hour = 19U; config.trigger_time.time.minute = 21U;
|
|
config.trigger_time.time.second = 35U; config.trigger_time.time.ms = 830U;
|
|
config.trigger_microseconds = 123U;
|
|
return config;
|
|
}
|
|
|
|
/**
|
|
* 功能:验证CFG长度探测、NUL容量边界及失败输出不变,逐项核对通道标度、采样数量、两类时标和ASCII/CRLF格式。
|
|
* 输入参数:无。
|
|
* 输出参数:无。
|
|
* 返回值:无。
|
|
* 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。
|
|
*/
|
|
static void Test_CFG(void)
|
|
{
|
|
IEC60870_ComtradeConfig_t config = Metadata();
|
|
char text[8000];
|
|
size_t needed = 0U, length = 99U, i, lines = 0U;
|
|
Prepare(16U, 4000U);
|
|
config.analog[0].multiplier = "0.001";
|
|
config.analog[0].offset = "-2.5";
|
|
config.analog[0].primary = "10000";
|
|
config.analog[0].secondary = "100";
|
|
config.analog[0].primary_or_secondary = 'S';
|
|
CHECK(IEC60870_Comtrade_Build_CFG(&recorder, &config, NULL, 0U, &needed));
|
|
memset(text, 'X', sizeof(text));
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, needed, &length));
|
|
CHECK(text[0] == 'X' && length == 99U);
|
|
CHECK(IEC60870_Comtrade_Build_CFG(&recorder, &config, text, needed + 1U, &length));
|
|
CHECK(length == needed && strlen(text) == length && text[length + 1U] == 'X');
|
|
CHECK(strncmp(text, "DTU,FAULT_RECORDER,1999\r\n24,8A,16D\r\n", 35U) == 0);
|
|
CHECK(strstr(text, "1,Ua,A,,V,0.001,-2.5,0,-32767,32767,10000,100,S\r\n") != NULL);
|
|
CHECK(strstr(text, "4,U0,N,,V,1,0,0,-32767,32767,1,1,P\r\n") != NULL);
|
|
CHECK(strstr(text, "8,I0,N,,A,1,0,0,-32767,32767,1,1,P\r\n") != NULL);
|
|
CHECK(strstr(text, "16,D16,,,0\r\n50\r\n1\r\n4000,961\r\n") != NULL);
|
|
CHECK(strstr(text, "14/11/2014,19:21:35.750123\r\n14/11/2014,19:21:35.830123\r\nBINARY\r\n1\r\n") != NULL);
|
|
for (i = 0U; i < length; ++i) {
|
|
CHECK((unsigned char)text[i] < 128U);
|
|
if (text[i] == '\n') { CHECK(i != 0U && text[i - 1U] == '\r'); ++lines; }
|
|
if (text[i] == '\r') { CHECK(i + 1U < length && text[i + 1U] == '\n'); }
|
|
}
|
|
CHECK(lines == 33U);
|
|
++checks;
|
|
}
|
|
|
|
/**
|
|
* 功能:验证以下场景与约束:以独立字节期望核对DAT序号、微秒时标、负模拟量及缺测标记,
|
|
* 任意分片和非记录对齐读取须与整文件一致,越界读不得改写输出。
|
|
* 输入参数:无。
|
|
* 输出参数:无。
|
|
* 返回值:无。
|
|
* 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。
|
|
*/
|
|
static void Test_DAT(void)
|
|
{
|
|
uint8_t whole[24986], piece[228];
|
|
uint32_t size = 0U, offset;
|
|
size_t amount;
|
|
Prepare(16U, 4000U);
|
|
CHECK(IEC60870_Comtrade_Data_Size(&recorder, &size) && size == sizeof(whole));
|
|
CHECK(IEC60870_Comtrade_Read_DAT(&recorder, 0U, whole, size));
|
|
CHECK(Read32(whole) == 1U && Read32(whole + 4U) == 0U);
|
|
CHECK(whole[8] == 0x88U && whole[9] == 0xffU); /* First sequence 80: Ua=-120. */
|
|
CHECK(whole[22] == 0xb9U && whole[23] == 0xffU); /* I0=-71. */
|
|
CHECK(whole[24] == 0xffU && whole[25] == 0xffU);
|
|
CHECK(Read32(whole + 26U) == 2U && Read32(whole + 30U) == 250U);
|
|
CHECK(whole[43U * 26U + 8U] == 0U && whole[43U * 26U + 9U] == 0x80U); /* Missing marker preserved. */
|
|
CHECK(Read32(whole + 320U * 26U + 4U) == 80000U);
|
|
CHECK(Read32(whole + 960U * 26U) == 961U && Read32(whole + 960U * 26U + 4U) == 240000U);
|
|
for (offset = 0U; offset < size; offset += (uint32_t)amount) {
|
|
amount = size - offset < sizeof(piece) ? size - offset : sizeof(piece);
|
|
CHECK(IEC60870_Comtrade_Read_DAT(&recorder, offset, piece, amount));
|
|
CHECK(memcmp(piece, whole + offset, amount) == 0);
|
|
}
|
|
for (offset = 1U; offset < 80U; ++offset) {
|
|
CHECK(IEC60870_Comtrade_Read_DAT(&recorder, offset, piece, 59U));
|
|
CHECK(memcmp(piece, whole + offset, 59U) == 0);
|
|
}
|
|
memset(piece, 0x5a, sizeof(piece));
|
|
CHECK(!IEC60870_Comtrade_Read_DAT(&recorder, size - 1U, piece, 2U) && piece[0] == 0x5aU);
|
|
CHECK(!IEC60870_Comtrade_Read_DAT(&recorder, UINT32_MAX, piece, 1U));
|
|
CHECK(!IEC60870_Comtrade_Read_DAT(&recorder, 0U, NULL, 1U));
|
|
CHECK(IEC60870_Comtrade_Read_DAT(&recorder, size, NULL, 0U));
|
|
CHECK(!IEC60870_Comtrade_Read_DAT(&recorder, size + 1U, NULL, 0U));
|
|
++checks;
|
|
}
|
|
|
|
/**
|
|
* 功能:遍历1..64位的关键字边界,验证DAT记录宽度、总长度及末个数字量字未用高位清零。
|
|
* 输入参数:无。
|
|
* 输出参数:无。
|
|
* 返回值:无。
|
|
* 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。
|
|
*/
|
|
static void Test_Digital_Counts(void)
|
|
{
|
|
uint8_t bytes[32];
|
|
uint32_t size;
|
|
uint16_t counts[] = {1U, 16U, 17U, 31U, 32U, 33U, 64U};
|
|
unsigned i;
|
|
for (i = 0U; i < sizeof(counts) / sizeof(counts[0]); ++i) {
|
|
unsigned words = (counts[i] + 15U) / 16U;
|
|
unsigned remaining = counts[i] % 16U;
|
|
unsigned width = 24U + words * 2U;
|
|
uint16_t mask = remaining == 0U ? UINT16_MAX : (uint16_t)((1U << remaining) - 1U);
|
|
Prepare(counts[i], 4000U);
|
|
CHECK(IEC60870_Comtrade_Data_Size(&recorder, &size) && size == width * 961U);
|
|
CHECK(IEC60870_Comtrade_Read_DAT(&recorder, 0U, bytes, width));
|
|
CHECK(bytes[width - 2U] == (uint8_t)mask && bytes[width - 1U] == (uint8_t)(mask >> 8U));
|
|
}
|
|
++checks;
|
|
}
|
|
|
|
/**
|
|
* 功能:验证前触发时标跨闰日、平年和年界的借位,拒绝越过2000年下界。
|
|
* 输入参数:无。
|
|
* 输出参数:无。
|
|
* 返回值:无。
|
|
* 说明:4001Hz下核对样本取整及微秒时标。
|
|
*/
|
|
static void Test_Times(void)
|
|
{
|
|
IEC60870_ComtradeConfig_t config = Metadata();
|
|
char text[8000];
|
|
size_t length;
|
|
uint8_t bytes[8];
|
|
Prepare(16U, 4000U);
|
|
config.trigger_time.time.year = 2024U; config.trigger_time.time.month = 3U; config.trigger_time.time.day = 1U;
|
|
config.trigger_time.time.hour = 0U; config.trigger_time.time.minute = 0U; config.trigger_time.time.second = 0U;
|
|
config.trigger_time.time.ms = 30U; config.trigger_microseconds = 7U;
|
|
CHECK(IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
CHECK(strstr(text, "29/02/2024,23:59:59.950007\r\n01/03/2024,00:00:00.030007") != NULL);
|
|
config.trigger_time.time.year = 2023U;
|
|
CHECK(IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
CHECK(strstr(text, "28/02/2023,23:59:59.950007\r\n") != NULL);
|
|
config.trigger_time.time.month = 1U;
|
|
CHECK(IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
CHECK(strstr(text, "31/12/2022,23:59:59.950007\r\n") != NULL);
|
|
config.trigger_time.time.year = 2000U;
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
Prepare(16U, 4001U); config = Metadata();
|
|
CHECK(IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
CHECK(strstr(text, "4001,963\r\n14/11/2014,19:21:35.749893\r\n") != NULL);
|
|
CHECK(IEC60870_Comtrade_Read_DAT(&recorder, 321U * 26U, bytes, sizeof(bytes)));
|
|
CHECK(Read32(bytes + 4U) == 80230U);
|
|
++checks;
|
|
}
|
|
|
|
/**
|
|
* 功能:验证非法文本、数字格式、比例参数、数字量常态及无效时标均被拒绝且不发布输出,
|
|
* 合法科学计数法仍可用,录波Release后不得继续生成CFG或读取DAT。
|
|
* 输入参数:无。
|
|
* 输出参数:无。
|
|
* 返回值:无。
|
|
* 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。
|
|
*/
|
|
static void Test_Invalid_Metadata(void)
|
|
{
|
|
IEC60870_ComtradeConfig_t config = Metadata();
|
|
char text[8000];
|
|
size_t length = 12345U;
|
|
const char *bad_numbers[] = {"", " ", "NaN", "inf", "1,2", "1\n2", "1e", ".", "1e100", "12345678901234"};
|
|
const char *names[16];
|
|
uint8_t normal[16] = {0};
|
|
unsigned i;
|
|
Prepare(16U, 4000U); memset(text, 'Z', sizeof(text));
|
|
config.station = "DTU,OTHER";
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
CHECK(text[0] == 'Z' && length == 12345U);
|
|
config = Metadata(); config.device = "\x80";
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
for (i = 0U; i < sizeof(bad_numbers) / sizeof(bad_numbers[0]); ++i) {
|
|
config = Metadata(); config.analog[0].multiplier = bad_numbers[i];
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
}
|
|
config = Metadata(); config.analog[0].multiplier = "0e9";
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
config = Metadata(); config.analog[0].secondary = "-1";
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
config = Metadata(); config.analog[0].primary_or_secondary = 'X';
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
for (i = 0U; i < 16U; ++i) { names[i] = "BREAKER"; }
|
|
config = Metadata(); config.digital_names = names; config.digital_normal = normal;
|
|
names[15] = "TRIP"; normal[15] = 1U;
|
|
CHECK(IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
CHECK(strstr(text, "16,TRIP,,,1\r\n") != NULL);
|
|
normal[15] = 2U;
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
normal[15] = 1U; names[15] = "BAD\nNAME";
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
config = Metadata(); config.trigger_time.is_invalid = 1U;
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
config = Metadata(); config.trigger_time.is_summer_time = 1U;
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
config = Metadata(); config.trigger_microseconds = 1000U;
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
config = Metadata(); config.trigger_time.time.month = 2U; config.trigger_time.time.day = 30U;
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
config = Metadata(); config.analog[1].multiplier = "-1.25e-3"; config.analog[1].offset = "+.5";
|
|
CHECK(IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
CHECK(IEC60870_FaultRecorder_Release(&recorder));
|
|
CHECK(!IEC60870_Comtrade_Build_CFG(&recorder, &config, text, sizeof(text), &length));
|
|
CHECK(!IEC60870_Comtrade_Read_DAT(&recorder, 0U, NULL, 0U));
|
|
++checks;
|
|
}
|
|
|
|
/**
|
|
* 功能:核对CFG/DAT规范文件名、间隔/序号范围及缓冲边界,验证9999回绕到1而非法序号不推进。
|
|
* 输入参数:无。
|
|
* 输出参数:无。
|
|
* 返回值:无。
|
|
* 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。
|
|
*/
|
|
static void Test_Names(void)
|
|
{
|
|
IEC60870_ComtradeConfig_t config = Metadata();
|
|
char name[IEC60870_COMTRADE_FILENAME_CAPACITY + 1U];
|
|
memset(name, 'Q', sizeof(name));
|
|
CHECK(IEC60870_Comtrade_File_Name(8U, 10U, &config.trigger_time, false, name, sizeof(name) - 1U));
|
|
CHECK(strcmp(name, "BAY08_0010_20141114_192135_830.cfg") == 0 && name[35] == 'Q');
|
|
CHECK(IEC60870_Comtrade_File_Name(8U, 10U, &config.trigger_time, true, name, sizeof(name)));
|
|
CHECK(strcmp(name, "BAY08_0010_20141114_192135_830.dat") == 0);
|
|
memset(name, 'Q', sizeof(name));
|
|
CHECK(!IEC60870_Comtrade_File_Name(0U, 10U, &config.trigger_time, true, name, sizeof(name)));
|
|
CHECK(!IEC60870_Comtrade_File_Name(100U, 10U, &config.trigger_time, true, name, sizeof(name)));
|
|
CHECK(!IEC60870_Comtrade_File_Name(1U, 0U, &config.trigger_time, true, name, sizeof(name)));
|
|
CHECK(!IEC60870_Comtrade_File_Name(1U, 10000U, &config.trigger_time, true, name, sizeof(name)));
|
|
CHECK(!IEC60870_Comtrade_File_Name(1U, 1U, &config.trigger_time, true, name, 34U));
|
|
CHECK(name[0] == 'Q');
|
|
CHECK(IEC60870_Comtrade_Next_Sequence(9999U) == 1U);
|
|
CHECK(IEC60870_Comtrade_Next_Sequence(1U) == 2U);
|
|
CHECK(IEC60870_Comtrade_Next_Sequence(0U) == 0U && IEC60870_Comtrade_Next_Sequence(10000U) == 0U);
|
|
++checks;
|
|
}
|
|
|
|
/**
|
|
* 功能:执行六组COMTRADE文本、字节和边界回归,全部断言通过后报告组数。
|
|
* 输入参数:无。
|
|
* 输出参数:无。
|
|
* 返回值:正常完成返回 0;参数、运行或断言失败以非零状态结束进程。
|
|
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
|
|
*/
|
|
int main(void)
|
|
{
|
|
Test_CFG(); Test_DAT(); Test_Digital_Counts(); Test_Times(); Test_Invalid_Metadata(); Test_Names();
|
|
printf("COMTRADE: %u groups passed\n", checks);
|
|
return 0;
|
|
}
|