Files
STM32F4-Base/IEC60870-Slave/test/iec104_example_energy_meter_test.c
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

453 lines
20 KiB
C

/* 整数电能源回归:直接控制单调时钟与逻辑墙钟,不用Type103跳时替代积分时间。 */
#include "iec104_example_energy_meter.h"
#include <assert.h>
#include <fenv.h>
#include <limits.h>
#include <math.h>
#include <stdio.h>
#include <string.h>
#define STORE_CAPACITY 400U
#define START_UTC UINT64_C(1767196800000)
typedef struct {
IEC60870_EnergyFreezeKind_t kind;
uint32_t index;
size_t size;
uint8_t bytes[IEC60870_ENERGY_FREEZE_WIRE_MAX];
} TestSlot;
typedef struct {
TestSlot slots[STORE_CAPACITY];
size_t count;
unsigned commits;
bool fail;
} TestStore;
static TestStore storage;
static IEC60870_EnergyFreeze_t core;
static const uint32_t points[8] = {0x6401U, 0x6402U, 0x6403U, 0x6404U,
0x6405U, 0x6406U, 0x6407U, 0x6408U};
static const uint8_t indices[8] = {0U, 1U, 2U, 3U, 4U, 5U, 6U, 7U};
static const uint8_t good[8] = {0U};
/**
* 功能:在有界稀疏槽表中按类别和索引读取记录,未写槽返回EMPTY,容量不足返回ERROR。
* 输入参数:context——业务回调的测试上下文;kind——记录或对象类别;index——待访问或核对的条目下标;bytes——报文字节缓冲区;capacity——调用方提供的缓冲容量;size——数据长度或文件大小。
* 输出参数:bytes——写入或读出的数据字节;size——本次数据、文件或 ASDU 的实际长度。
* 返回值:本次核心或后端操作的状态枚举,保留成功、空记录、拒绝及错误等区别。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
static IEC60870_EnergyFreezeResult_t Read(void *context, IEC60870_EnergyFreezeKind_t kind,
uint32_t index, uint8_t *bytes, size_t capacity, size_t *size)
{
TestStore *store = context;
size_t i;
for (i = 0U; i < store->count; ++i) {
if (store->slots[i].kind == kind && store->slots[i].index == index) {
if (store->slots[i].size > capacity) { return IEC60870_ENERGY_FREEZE_ERROR; }
memcpy(bytes, store->slots[i].bytes, store->slots[i].size);
*size = store->slots[i].size;
return IEC60870_ENERGY_FREEZE_OK;
}
}
return IEC60870_ENERGY_FREEZE_EMPTY;
}
/**
* 功能:计数每次提交尝试,覆盖同键槽或追加新槽。
* 输入参数:context——业务回调的测试上下文;kind——记录或对象类别;index——待访问或核对的条目下标;bytes——报文字节缓冲区(只读);size——数据长度或文件大小。
* 输出参数:无。
* 返回值:true 表示本次操作或核对成功;false 表示拒绝、失败或命中注入故障。
* 说明:失败开关、记录超长及槽表满时拒绝写入。
*/
static bool Commit(void *context, IEC60870_EnergyFreezeKind_t kind,
uint32_t index, const uint8_t *bytes, size_t size)
{
TestStore *store = context;
size_t i;
++store->commits;
if (store->fail || size > IEC60870_ENERGY_FREEZE_WIRE_MAX) { return false; }
for (i = 0U; i < store->count; ++i) {
if (store->slots[i].kind == kind && store->slots[i].index == index) { break; }
}
if (i == store->count) {
if (store->count == STORE_CAPACITY) { return false; }
++store->count;
}
store->slots[i].kind = kind;
store->slots[i].index = index;
store->slots[i].size = size;
memcpy(store->slots[i].bytes, bytes, size);
return true;
}
/**
* 功能:清空模拟存储,以三张八点表重建冻结核心,隔离各计量和恢复用例的持久数据。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
static void Reset_Core(void)
{
IEC60870_EnergyFreezeConfig_t config;
IEC60870_EnergyFreezeStore_t store;
memset(&storage, 0, sizeof(storage));
IEC60870_EnergyFreeze_Config_Default(&config);
config.interval_ioas = config.day_ioas = config.flowrev_ioas = points;
config.point_count = config.flowrev_count = 8U;
store.context = &storage;
store.read = Read;
store.commit = Commit;
assert(IEC60870_EnergyFreeze_Init(&core, &config, &store) == IEC60870_ENERGY_FREEZE_OK);
}
/**
* 功能:按先double除1000再转float的约定生成八值输入,用于独立验证恢复后的编码往返。
* 输入参数:registers——八项定点电能寄存器值(只读);values——测试采样值数组。
* 输出参数:values——编码后的八项浮点电能值。
* 返回值:无。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
static void Encode_Registers(const uint64_t registers[8], float values[8])
{
size_t index;
for (index = 0U; index < 8U; ++index) { values[index] = (float)((double)registers[index] / 1000.0); }
}
/**
* 功能:验证以下场景与约束:用明确整数期望核对四象限、完整周期及一天积分,并验证较新查询不会污染历史时刻的纯查询结果。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
static void Test_Exact_Integration(void)
{
ExampleEnergyMeter meter;
uint64_t actual[8], later[8];
static const uint64_t quarters[4][8] = {
{111U, 41U, 41U, 0U, 0U, 0U, 0U, 0U},
{222U, 41U, 41U, 41U, 0U, 41U, 0U, 0U},
{222U, 41U, 41U, 41U, 111U, 82U, 0U, 41U},
{222U, 82U, 41U, 41U, 222U, 82U, 41U, 41U}
};
static const uint64_t nine_cycles[8] = {2000U, 750U, 375U, 375U, 2000U, 750U, 375U, 375U};
static const uint64_t day[8] = {4800000U, 1800000U, 900000U, 900000U,
4800000U, 1800000U, 900000U, 900000U};
unsigned i;
assert(!Example_Energy_Meter_Init(&meter, 2002U, 1234U, START_UTC));
assert(Example_Energy_Meter_Init(&meter, 4000U, 1234U, START_UTC));
for (i = 0U; i < 4U; ++i) {
assert(Example_Energy_Meter_Evaluate_At(&meter, 1234U + 1000U * (i + 1U), actual));
assert(memcmp(actual, quarters[i], sizeof(actual)) == 0);
}
assert(Example_Energy_Meter_Evaluate_At(&meter, 1234U + 36000U, actual));
assert(memcmp(actual, nine_cycles, sizeof(actual)) == 0);
/* 较新的查询不得污染历史查询;同一时刻的输出无需知道此前步长。 */
assert(Example_Energy_Meter_Evaluate_At(&meter, 1234U + 86400000U, later));
assert(Example_Energy_Meter_Evaluate_At(&meter, 2234U, actual));
assert(memcmp(actual, quarters[0], sizeof(actual)) == 0);
assert(!Example_Energy_Meter_Evaluate_At(&meter, 1233U, actual));
assert(Example_Energy_Meter_Init(&meter, 2000U, 0U, START_UTC));
assert(Example_Energy_Meter_Evaluate_At(&meter, 86400000U, actual));
assert(memcmp(actual, day, sizeof(actual)) == 0);
}
/**
* 功能:验证1Wh精确恢复、八值编码固定点、合计对独立原像的约束及累加器上限。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:NaN、负零和超限值须拒绝。
*/
static void Test_Inverse_Recovery(void)
{
uint64_t registers[8] = {1U, 1U, 1U, 0U, 1U, 0U, 0U, 0U}, restored[8], again[8];
float values[8], encoded[8];
size_t index;
Encode_Registers(registers, values);
assert(Example_Energy_Meter_Restore_From_Values(values, restored));
assert(memcmp(registers, restored, sizeof(registers)) == 0);
Encode_Registers(restored, encoded);
assert(memcmp(values, encoded, sizeof(values)) == 0);
assert(Example_Energy_Meter_Restore_From_Values(encoded, again));
assert(memcmp(restored, again, sizeof(restored)) == 0);
/* 六个独立编码相等,合计却不同:新合计迫使Q1取原像上端。 */
memset(registers, 0, sizeof(registers));
registers[2] = 16384002U; registers[6] = 1U; registers[1] = 16384003U;
Encode_Registers(registers, values);
assert(Example_Energy_Meter_Restore_From_Values(values, restored));
assert(restored[2] == 16384002U && restored[6] == 1U && restored[1] == 16384003U);
values[1] = 0.0f;
assert(!Example_Energy_Meter_Restore_From_Values(values, restored));
memset(registers, 0, sizeof(registers));
registers[0] = EXAMPLE_ENERGY_METER_REGISTER_MAX;
registers[2] = registers[6] = EXAMPLE_ENERGY_METER_REGISTER_MAX;
registers[1] = registers[2] + registers[6];
Encode_Registers(registers, values);
assert(Example_Energy_Meter_Restore_From_Values(values, restored));
for (index = 0U; index < 8U; ++index) {
if (index != 1U && index != 5U) { assert(restored[index] <= EXAMPLE_ENERGY_METER_REGISTER_MAX); }
}
Encode_Registers(restored, encoded);
assert(memcmp(values, encoded, sizeof(values)) == 0);
values[0] = (float)((double)UINT64_C(9007199254740991) / 1000.0);
assert(!Example_Energy_Meter_Restore_From_Values(values, restored));
values[0] = NAN;
assert(!Example_Energy_Meter_Restore_From_Values(values, restored));
values[0] = -0.0f;
assert(!Example_Energy_Meter_Restore_From_Values(values, restored));
}
/**
* 功能:验证以下场景与约束:以固定种子生成200000组合法八值,逐组验证恢复后float字节不变及重复恢复的整数固定点。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
static void Test_Recovery_Probe(void)
{
uint32_t random = 0x12345678U;
unsigned iteration;
for (iteration = 0U; iteration < 200000U; ++iteration) {
uint64_t registers[8], restored[8], again[8];
float values[8], encoded[8];
static const uint8_t positions[6] = {0U, 4U, 2U, 6U, 7U, 3U};
size_t i;
memset(registers, 0, sizeof(registers));
for (i = 0U; i < 6U; ++i) {
random = random * 1664525U + 1013904223U;
registers[positions[i]] = ((uint64_t)random * 1000U) % EXAMPLE_ENERGY_METER_REGISTER_MAX;
}
registers[1] = registers[2] + registers[6];
registers[5] = registers[3] + registers[7];
Encode_Registers(registers, values);
assert(Example_Energy_Meter_Restore_From_Values(values, restored));
Encode_Registers(restored, encoded);
assert(memcmp(values, encoded, sizeof(values)) == 0);
assert(Example_Energy_Meter_Restore_From_Values(encoded, again));
assert(memcmp(restored, again, sizeof(restored)) == 0);
}
}
/**
* 功能:验证恢复按全部八个累计量选最大向量而非墙钟先后。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:来源向量互不支配时必须失败并锁存故障。
*/
static void Test_Stored_Recovery(void)
{
ExampleEnergyMeter meter;
uint64_t old[8] = {0U, 16384002U, 16384001U, 0U, 0U, 0U, 1U, 0U};
uint64_t newer[8] = {0U, 16384003U, 16384002U, 0U, 0U, 0U, 1U, 0U};
uint64_t restored[8];
float values[8];
Reset_Core();
Encode_Registers(old, values);
assert(IEC60870_EnergyFreeze_Record_Interval(&core, START_UTC, START_UTC,
values, good, 8U) == IEC60870_ENERGY_FREEZE_OK);
Encode_Registers(newer, values);
/* FLOW时刻早于INTERVAL也必须按八个累计量选基准,不按墙钟顺序选。 */
assert(IEC60870_EnergyFreeze_Append_FlowReverse(&core, START_UTC - 1000U,
indices, values, good, 8U) == IEC60870_ENERGY_FREEZE_OK);
assert(Example_Energy_Meter_Init(&meter, 4000U, 123U, START_UTC));
assert(Example_Energy_Meter_Restore(&meter, &core));
assert(Example_Energy_Meter_Evaluate_At(&meter, 123U, restored));
assert(restored[2] == 16384002U && restored[1] == 16384003U);
Reset_Core();
memset(old, 0, sizeof(old)); old[0] = 1000U;
Encode_Registers(old, values);
assert(IEC60870_EnergyFreeze_Append_FlowReverse(&core, START_UTC,
indices, values, good, 8U) == IEC60870_ENERGY_FREEZE_OK);
memset(old, 0, sizeof(old)); old[1] = old[2] = 1000U;
Encode_Registers(old, values);
assert(IEC60870_EnergyFreeze_Append_FlowReverse(&core, START_UTC + 1U,
indices, values, good, 8U) == IEC60870_ENERGY_FREEZE_OK);
assert(Example_Energy_Meter_Init(&meter, 4000U, 0U, START_UTC));
assert(!Example_Energy_Meter_Restore(&meter, &core));
assert(meter.faulted);
}
/**
* 功能:验证校时切点前后的事件沿用各自分段,较新快照不改变旧事件值。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:UTC回拨暂停冻结但FLOW仍提交。
*/
static void Test_Epochs_And_Rollback(void)
{
ExampleEnergyMeter meter;
IEC60870_EnergyFreezeFlowReverse_t event;
uint64_t utc;
float expected[8];
uint8_t quality[8];
unsigned i;
Reset_Core();
assert(Example_Energy_Meter_Init(&meter, 2000U, 100000U, START_UTC));
assert(Example_Energy_Meter_Set_Epoch(&meter, 110000U, START_UTC + 3610000U));
assert(Example_Energy_Meter_Time_At(&meter, 105000U, &utc) && utc == START_UTC + 5000U);
assert(Example_Energy_Meter_Time_At(&meter, 115000U, &utc) && utc == START_UTC + 3615000U);
assert(Example_Energy_Meter_Snapshot(&meter, 120000U, expected, quality));
for (i = 0U; i < 4U; ++i) { assert(Example_Energy_Meter_Step(&meter, &core, 115000U)); }
assert(IEC60870_EnergyFreeze_Get_FlowReverse(&core, 4U, &event) == IEC60870_ENERGY_FREEZE_OK);
assert(event.occur_utc_ms == START_UTC + 5000U);
assert(Example_Energy_Meter_Snapshot(&meter, 105000U, expected, quality));
assert(memcmp(event.values, expected, sizeof(expected)) == 0);
assert(IEC60870_EnergyFreeze_Get_FlowReverse(&core, 9U, &event) == IEC60870_ENERGY_FREEZE_OK);
assert(event.occur_utc_ms == START_UTC + 3610000U);
Reset_Core();
assert(Example_Energy_Meter_Init(&meter, 2000U, 0U, START_UTC));
assert(Example_Energy_Meter_Step(&meter, &core, 0U));
assert(Example_Energy_Meter_Set_Epoch(&meter, 1000U, START_UTC - 3600000U));
assert(Example_Energy_Meter_Step(&meter, &core, 1000U));
assert(meter.last_result == IEC60870_ENERGY_FREEZE_TIME_REVERSED);
assert(IEC60870_EnergyFreeze_FlowReverse_Count(&core) == 1U);
assert(IEC60870_EnergyFreeze_Get_FlowReverse(&core, 0U, &event) == IEC60870_ENERGY_FREEZE_OK);
assert(event.occur_utc_ms == START_UTC - 3600000U);
}
/**
* 功能:验证以下场景与约束:连续加入20个校时切点,验证16段上限、丢弃最老待发事件的计数及首个保留事件的时间映射。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
static void Test_Epoch_Capacity(void)
{
ExampleEnergyMeter meter;
IEC60870_EnergyFreezeFlowReverse_t event;
unsigned i;
Reset_Core();
assert(Example_Energy_Meter_Init(&meter, 2000U, 0U, START_UTC));
for (i = 1U; i <= 20U; ++i) {
assert(Example_Energy_Meter_Set_Epoch(&meter, i * 1000U, START_UTC + i * 10000U));
}
assert(meter.epoch_count == 16U && meter.flowrev_dropped == 4U && meter.next_flow_index == 5U);
assert(Example_Energy_Meter_Step(&meter, &core, 20000U));
assert(IEC60870_EnergyFreeze_Get_FlowReverse(&core, 0U, &event) == IEC60870_ENERGY_FREEZE_OK);
assert(event.occur_utc_ms == START_UTC + 50000U);
assert(meter.flowrev_dropped == 4U);
}
/**
* 功能:验证以下场景与约束:一次跨越一天形成86400条反转候选,验证只保留最新256条、每轮提交4条且重复Step不重复提交。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
static void Test_Bounded_Backlog(void)
{
ExampleEnergyMeter meter;
IEC60870_EnergyFreezeFlowReverse_t first, last;
float current[8];
uint8_t quality[8];
unsigned i;
Reset_Core();
assert(Example_Energy_Meter_Init(&meter, 2000U, 0U, START_UTC));
assert(Example_Energy_Meter_Snapshot(&meter, 86400000U, current, quality));
for (i = 0U; i < 64U; ++i) {
assert(Example_Energy_Meter_Step(&meter, &core, 86400000U));
assert(IEC60870_EnergyFreeze_FlowReverse_Count(&core) == (i + 1U) * 4U);
}
assert(meter.flowrev_dropped == 86144U && meter.next_flow_index == 86401U);
assert(IEC60870_EnergyFreeze_Get_FlowReverse(&core, 0U, &first) == IEC60870_ENERGY_FREEZE_OK);
assert(IEC60870_EnergyFreeze_Get_FlowReverse(&core, 255U, &last) == IEC60870_ENERGY_FREEZE_OK);
assert(first.occur_utc_ms == START_UTC + 86145000U);
assert(last.occur_utc_ms == START_UTC + 86400000U);
assert(first.values[0] < current[0]);
assert(memcmp(last.values, current, sizeof(current)) == 0);
assert(Example_Energy_Meter_Step(&meter, &core, 86400000U));
assert(IEC60870_EnergyFreeze_FlowReverse_Count(&core) == 256U);
}
/**
* 功能:验证积分溢出保持输出、持久失败闭锁后不再提交,以及非最近舍入模式禁止逆像恢复。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
static void Test_Limits_And_Failure(void)
{
ExampleEnergyMeter meter;
uint64_t values[8], untouched[8];
float encoded[8] = {0.0f};
unsigned commits;
Reset_Core();
assert(Example_Energy_Meter_Init(&meter, 2000U, 0U, START_UTC));
meter.base_accumulators[0] = INT64_MAX;
memset(values, 0x5A, sizeof(values)); memcpy(untouched, values, sizeof(values));
assert(!Example_Energy_Meter_Evaluate_At(&meter, 1U, values));
assert(memcmp(values, untouched, sizeof(values)) == 0);
assert(!Example_Energy_Meter_Evaluate_At(&meter, UINT64_MAX, values));
assert(Example_Energy_Meter_Init(&meter, 2000U, 0U, START_UTC));
storage.fail = true;
assert(!Example_Energy_Meter_Step(&meter, &core, 1000U));
assert(meter.faulted);
commits = storage.commits;
assert(!Example_Energy_Meter_Step(&meter, &core, 1000U) && storage.commits == commits);
assert(fesetround(FE_UPWARD) == 0);
assert(!Example_Energy_Meter_Restore_From_Values(encoded, values));
assert(fesetround(FE_TONEAREST) == 0);
}
/**
* 功能:验证空库恢复保持零基线,最后可表示日的记录也能恢复,未使用的32窗尾部不得造成越界日历失败。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
static void Test_Empty_And_Last_Day(void)
{
ExampleEnergyMeter meter;
uint64_t registers[8];
float values[8] = {0.0f};
uint64_t last_grid = IEC60870_ENERGY_FREEZE_UTC_MAX / 900000U * 900000U;
Reset_Core();
assert(Example_Energy_Meter_Init(&meter, 2000U, 77U, START_UTC));
assert(Example_Energy_Meter_Restore(&meter, &core));
assert(Example_Energy_Meter_Evaluate_At(&meter, 77U, registers));
assert(registers[0] == 0U && registers[1] == 0U);
assert(IEC60870_EnergyFreeze_Record_Interval(&core, last_grid, last_grid,
values, good, 8U) == IEC60870_ENERGY_FREEZE_OK);
assert(Example_Energy_Meter_Init(&meter, 2000U, 77U, last_grid));
assert(Example_Energy_Meter_Restore(&meter, &core));
}
/**
* 功能:执行九组整数计量回归并报告实例/恢复工作区大小,供核对算法语义与宿主资源占用。
* 输入参数:无。
* 输出参数:无。
* 返回值:正常完成返回 0;参数、运行或断言失败以非零状态结束进程。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
int main(void)
{
Test_Exact_Integration();
Test_Inverse_Recovery();
Test_Recovery_Probe();
Test_Stored_Recovery();
Test_Epochs_And_Rollback();
Test_Epoch_Capacity();
Test_Bounded_Backlog();
Test_Limits_And_Failure();
Test_Empty_And_Last_Day();
printf("energy sizes: meter=%lu core=%lu record=%lu flow=%lu restore_heap=%lu\n",
(unsigned long)sizeof(ExampleEnergyMeter), (unsigned long)sizeof(IEC60870_EnergyFreeze_t),
(unsigned long)sizeof(IEC60870_EnergyFreezeRecord_t),
(unsigned long)sizeof(IEC60870_EnergyFreezeFlowReverse_t),
(unsigned long)(3360U * 8U * sizeof(float)));
puts("iec104_example_energy_meter_test: PASS (9 groups)");
return 0;
}