/* 整数电能源回归:直接控制单调时钟与逻辑墙钟,不用Type103跳时替代积分时间。 */ #include "iec104_example_energy_meter.h" #include #include #include #include #include #include #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; }