Files
STM32F4-Base/IEC60870-Slave/test/iec60870_firmware_update_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

601 lines
30 KiB
C

/* 三槽升级核心单测:元数据提交前/后失败、平台副作用不确定及重启恢复。
* storage 模拟可跨 Init 保留的介质,update 模拟可丢失的运行状态;本文件验证
* 核心对后端契约的使用,不模拟文件系统双 bank,也不替代真实介质掉电试验。 */
#include "IEC60870_FirmwareUpdate.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)
#define IMAGE_CAPACITY 1024U
#define OK IEC60870_FIRMWARE_UPDATE_OK
#define ERROR IEC60870_FIRMWARE_UPDATE_ERROR
#define INVALID IEC60870_FIRMWARE_UPDATE_INVALID
#define REJECTED IEC60870_FIRMWARE_UPDATE_REJECTED
#define STABLE IEC60870_FIRMWARE_UPDATE_STABLE
#define RECEIVING IEC60870_FIRMWARE_UPDATE_RECEIVING
#define VERIFIED IEC60870_FIRMWARE_UPDATE_VERIFIED
#define AUTHORIZED IEC60870_FIRMWARE_UPDATE_AUTHORIZED
#define INSTALLING IEC60870_FIRMWARE_UPDATE_INSTALLING
#define TRIAL IEC60870_FIRMWARE_UPDATE_TRIAL
#define ROLLING_BACK IEC60870_FIRMWARE_UPDATE_ROLLING_BACK
/* 故障开关由每个场景显式设置和清除;Recover 保留此结构,Empty 才清空介质。
* installed_* 单独记录安装副作用,不能从核心的 current 角色反推是否安装过。 */
typedef struct {
uint8_t metadata[IEC60870_FIRMWARE_UPDATE_WIRE_SIZE];
size_t metadata_size;
uint8_t images[3][IMAGE_CAPACITY];
uint32_t sizes[3];
unsigned commits, begins, installs; /* 回调次数也用于断言闭锁后没有再次触碰介质。 */
unsigned fail_commit_at; /* 绝对提交调用序号;零表示不注入提交故障。 */
int commit_mode; /* 1不落盘;2已落盘但返回false。 */
bool fail_metadata_read, fail_begin, fail_write, fail_sync;
int fail_read_slot, fail_install; /* 读槽-1表示正常;安装1在副作用前失败,2在其后失败。 */
uint32_t reject_version, installed_version;
uint8_t installed_slot;
uint64_t installed_transaction;
} Store;
static Store storage;
static IEC60870_FirmwareUpdate_t update;
/**
* 功能:测试侧计算负载和故意改写后的元数据 CRC,不调用被测模块的内部函数。
* 输入参数:bytes——报文字节缓冲区(只读);length——字节长度。
* 输出参数:无。
* 返回值:独立计算得到的 32 位校验摘要。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
static uint32_t Crc(const uint8_t *bytes, size_t length)
{
uint32_t crc = UINT32_MAX;
size_t i;
unsigned bit;
for (i = 0U; i < length; ++i) {
crc ^= bytes[i];
for (bit = 0U; bit < 8U; ++bit) {
crc = (crc >> 1) ^ ((crc & 1U) != 0U ? UINT32_C(0xedb88320) : 0U);
}
}
return ~crc;
}
/**
* 功能:直接改持久字节,用于制造“CRC正确、结构非法”的记录,而非只测试校验和。
* 输入参数:bytes——报文字节缓冲区;value——测试对象值或原始位模式;length——字节长度。
* 输出参数:bytes——写入或读出的数据字节。
* 返回值:无。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
static void Put(uint8_t *bytes, uint64_t value, size_t length)
{
size_t i;
for (i = 0U; i < length; ++i) { bytes[i] = (uint8_t)(value >> (8U * i)); }
}
/**
* 功能:从测试介质读取已提交元数据,分别返回空介质、读失败和有效记录。
* 输入参数:context——业务回调的测试上下文;bytes——报文字节缓冲区;capacity——调用方提供的缓冲容量;size——数据长度或文件大小。
* 输出参数:bytes——写入或读出的数据字节;size——本次数据、文件或 ASDU 的实际长度。
* 返回值:本次核心或后端操作的状态枚举,保留成功、空记录、拒绝及错误等区别。
* 说明:无提交与读故障分开返回;长度由夹具控制,以覆盖半条记录及规范化检查。
*/
static IEC60870_FirmwareUpdateResult_t Metadata_Read(void *context,
uint8_t *bytes, size_t capacity, size_t *size)
{
Store *store = context;
if (store->fail_metadata_read) { return ERROR; }
if (store->metadata_size == 0U) { return IEC60870_FIRMWARE_UPDATE_EMPTY; }
CHECK(capacity >= store->metadata_size);
memcpy(bytes, store->metadata, store->metadata_size); *size = store->metadata_size;
return OK;
}
/**
* 功能:一个原子记录的两种失败边界:完全未替换,或已替换却返回失败。
* 输入参数:context——业务回调的测试上下文;bytes——报文字节缓冲区(只读);size——数据长度或文件大小。
* 输出参数:无。
* 返回值:true 表示本次操作或核对成功;false 表示拒绝、失败或命中注入故障。
* 说明:调用方必须对两者都闭锁,不能用 false 决定下一次启动应看到哪一版。
*/
static bool Metadata_Commit(void *context, const uint8_t *bytes, size_t size)
{
Store *store = context;
bool fail = ++store->commits == store->fail_commit_at;
CHECK(size == sizeof(store->metadata));
if (fail && store->commit_mode == 1) { return false; }
memcpy(store->metadata, bytes, size); store->metadata_size = size;
return !fail;
}
/**
* 功能:夹具按声明长度提供可读区。
* 输入参数:context——业务回调的测试上下文;slot——记录或映像槽号;size——数据长度或文件大小。
* 输出参数:无。
* 返回值:true 表示本次操作或核对成功;false 表示拒绝、失败或命中注入故障。
* 说明:正常清槽立即完成,故障模式在改变槽内容前退出。
*/
static bool Image_Begin(void *context, uint8_t slot, uint32_t size)
{
Store *store = context;
CHECK(slot < 3U && size <= IMAGE_CAPACITY);
++store->begins;
if (store->fail_begin) { return false; }
memset(store->images[slot], 0, sizeof(store->images[slot])); store->sizes[slot] = size;
return true;
}
/**
* 功能:故意在字节已写入后报错,验证核心不据此推进可继续接收的偏移。
* 输入参数:context——业务回调的测试上下文;slot——记录或映像槽号;offset——文件、记录或缓冲区偏移;bytes——报文字节缓冲区(只读);length——字节长度。
* 输出参数:无。
* 返回值:true 表示本次操作或核对成功;false 表示拒绝、失败或命中注入故障。
* 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。
*/
static bool Image_Write(void *context, uint8_t slot, uint32_t offset,
const uint8_t *bytes, size_t length)
{
Store *store = context;
CHECK(slot < 3U && offset <= store->sizes[slot] && length <= store->sizes[slot] - offset);
memcpy(store->images[slot] + offset, bytes, length);
return !store->fail_write;
}
/**
* 功能:从指定映像槽和偏移复制测试字节,支持截断与指定槽读取失败。
* 输入参数:context——业务回调的测试上下文;slot——记录或映像槽号;offset——文件、记录或缓冲区偏移;bytes——报文字节缓冲区;length——字节长度。
* 输出参数:bytes——写入或读出的数据字节。
* 返回值:true 表示本次操作或核对成功;false 表示拒绝、失败或命中注入故障。
* 说明:缩短 sizes 可模拟丢失/截断;fail_read_slot 则模拟长度仍在但无法读取。
*/
static bool Image_Read(void *context, uint8_t slot, uint32_t offset, uint8_t *bytes, size_t length)
{
Store *store = context;
if ((int)slot == store->fail_read_slot || offset > store->sizes[slot] ||
length > store->sizes[slot] - offset) { return false; }
memcpy(bytes, store->images[slot] + offset, length);
return true;
}
/**
* 功能:内存无真实刷新过程,开关只模拟后端无法确认持久完成这一返回语义。
* 输入参数:context——业务回调的测试上下文;slot——记录或映像槽号。
* 输出参数:无。
* 返回值:true 表示本次操作或核对成功;false 表示拒绝、失败或命中注入故障。
* 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。
*/
static bool Image_Sync(void *context, uint8_t slot)
{
Store *store = context;
CHECK(slot < 3U);
return !store->fail_sync;
}
/**
* 功能:允许只读查询状态,检查核心先落安装意图再调用平台。
* 输入参数:context——业务回调的测试上下文;slot——记录或映像槽号;descriptor——映像版本、长度及校验描述(只读);transaction——安装事务标识。
* 输出参数:无。
* 返回值:true 表示本次操作或核对成功;false 表示拒绝、失败或命中注入故障。
* 说明:稳定启动也允许修复目标。
* 副作用记录保留到 Recover 之后,以断言重试沿用原事务和槽,不擅自换版本。
*/
static bool Install(void *context, uint8_t slot,
const IEC60870_FirmwareUpdateDescriptor_t *descriptor, uint64_t transaction)
{
Store *store = context;
IEC60870_FirmwareUpdateStatus_t status;
CHECK(IEC60870_FirmwareUpdate_Get_Status(&update, &status));
CHECK(status.state == STABLE || status.state == INSTALLING || status.state == ROLLING_BACK);
CHECK(Crc(store->images[slot], descriptor->size) == descriptor->crc);
++store->installs;
if (store->fail_install == 1) { return false; }
store->installed_slot = slot; store->installed_version = descriptor->version;
store->installed_transaction = transaction;
return store->fail_install != 2;
}
/**
* 功能:模拟产品许可拒绝,区别于 I/O 失败。
* 输入参数:context——业务回调的测试上下文;slot——记录或映像槽号;descriptor——映像版本、长度及校验描述(只读)。
* 输出参数:无。
* 返回值:true 表示测试产品规则允许该映像;false 表示版本被业务策略拒绝。
* 说明:它不是本测试对签名或机型验证的实现。
*/
static bool Validate(void *context, uint8_t slot, const IEC60870_FirmwareUpdateDescriptor_t *descriptor)
{
Store *store = context;
CHECK(slot < 3U);
return descriptor->version != store->reject_version;
}
/**
* 功能:只重建核心,不清介质或故障开关。
* 输入参数:无。
* 输出参数:无。
* 返回值:本次核心或后端操作的状态枚举,保留成功、空记录、拒绝及错误等区别。
* 说明:调用场景决定何时解除外部故障。
*/
static IEC60870_FirmwareUpdateResult_t Recover(void)
{
IEC60870_FirmwareUpdateStore_t store = {
&storage, Metadata_Read, Metadata_Commit, Image_Begin, Image_Write,
Image_Read, Image_Sync, Install, Validate
};
return IEC60870_FirmwareUpdate_Init(&update, &store, IMAGE_CAPACITY);
}
/**
* 功能:同版本和长度生成相同字节,不同版本可供安装副作用和角色轮转断言区分。
* 输入参数:version——测试映像版本号;size——数据长度或文件大小;bytes——报文字节缓冲区。
* 输出参数:bytes——写入或读出的数据字节。
* 返回值:与生成负载对应的版本、长度及校验描述。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
static IEC60870_FirmwareUpdateDescriptor_t Payload(uint32_t version, uint32_t size, uint8_t *bytes)
{
IEC60870_FirmwareUpdateDescriptor_t descriptor;
uint32_t i;
for (i = 0U; i < size; ++i) { bytes[i] = (uint8_t)(i * 17U + version * 31U); }
descriptor.version = version; descriptor.size = size; descriptor.crc = Crc(bytes, size);
return descriptor;
}
/**
* 功能:每组独立前提:从未提交的介质,只初始化,不隐式制造基线或执行安装。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。
*/
static void Empty(void)
{
memset(&storage, 0, sizeof(storage)); storage.fail_read_slot = -1;
CHECK(Recover() == OK);
}
/**
* 功能:真实写入701字节旧映像再登记角色。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:后续回退都必须读到这份负载。
*/
static void Fresh(void)
{
IEC60870_FirmwareUpdateDescriptor_t descriptor;
Empty();
descriptor = Payload(1U, 701U, storage.images[0]); storage.sizes[0] = descriptor.size;
CHECK(IEC60870_FirmwareUpdate_Provision(&update, 0U, &descriptor) == OK);
}
/**
* 功能:非整块长度及不对齐分段使读回复验经过多个256字节块和最后不足一块的尾部。
* 输入参数:version——测试映像版本号。
* 输出参数:无。
* 返回值:无。
* 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。
*/
static void Receive(uint32_t version)
{
uint8_t bytes[803];
IEC60870_FirmwareUpdateDescriptor_t descriptor = Payload(version, sizeof(bytes), bytes);
CHECK(IEC60870_FirmwareUpdate_Begin(&update, &descriptor) == OK);
CHECK(IEC60870_FirmwareUpdate_Write(&update, 0U, bytes, 317U) == OK);
CHECK(IEC60870_FirmwareUpdate_Write(&update, 317U, bytes + 317U, sizeof(bytes) - 317U) == OK);
}
/**
* 功能:前提停在已验证、尚未授权阶段,便于分别测试启动丢弃与授权持久化。
* 输入参数:version——测试映像版本号。
* 输出参数:无。
* 返回值:无。
* 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。
*/
static void Verified(uint32_t version)
{
Receive(version);
CHECK(IEC60870_FirmwareUpdate_Finish(&update) == OK);
}
/**
* 功能:安装成功但故意不 Confirm,保留 current 为旧版供下一次启动回退检查。
* 输入参数:version——测试映像版本号。
* 输出参数:无。
* 返回值:无。
* 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。
*/
static void Trial(uint32_t version)
{
IEC60870_FirmwareUpdateDescriptor_t boot;
Verified(version);
CHECK(IEC60870_FirmwareUpdate_Authorize(&update) == OK);
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == OK && boot.version == version);
CHECK(update.status.state == TRIAL);
}
/**
* 功能:参数错误必须无副作用。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:无基线启动保持输出,Init别名恢复不触发安装,
* 错误基线的CRC拒绝不闭锁,修正描述后仍可完成首次登记。
*/
static void Inputs_And_Provision(void)
{
IEC60870_FirmwareUpdate_t before;
IEC60870_FirmwareUpdateStatus_t status, unchanged;
IEC60870_FirmwareUpdateDescriptor_t descriptor, boot = {9U, 9U, 9U};
IEC60870_FirmwareUpdateStore_t bad;
uint8_t byte = 1U;
Empty();
CHECK(update.status.state == IEC60870_FIRMWARE_UPDATE_STATE_EMPTY);
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == IEC60870_FIRMWARE_UPDATE_EMPTY && boot.version == 9U);
CHECK(IEC60870_FirmwareUpdate_Abort(&update) == OK && storage.commits == 0U);
CHECK(IEC60870_FirmwareUpdate_Write(&update, 0U, &byte, 1U) == INVALID);
CHECK(IEC60870_FirmwareUpdate_Confirm(&update) == INVALID);
descriptor = Payload(1U, 701U, storage.images[0]); storage.sizes[0] = descriptor.size;
before = update; bad = update.store; bad.metadata_read = NULL;
CHECK(IEC60870_FirmwareUpdate_Init(&update, &bad, IMAGE_CAPACITY) == INVALID);
CHECK(memcmp(&update, &before, sizeof(update)) == 0);
CHECK(IEC60870_FirmwareUpdate_Init(&update, &update.store, 0U) == INVALID);
CHECK(IEC60870_FirmwareUpdate_Provision(&update, 3U, &descriptor) == INVALID);
descriptor.version = 0U;
CHECK(IEC60870_FirmwareUpdate_Provision(&update, 0U, &descriptor) == INVALID);
descriptor.version = 1U; descriptor.crc ^= 1U;
CHECK(IEC60870_FirmwareUpdate_Provision(&update, 0U, &descriptor) == REJECTED && !update.status.faulted);
descriptor.crc ^= 1U;
CHECK(IEC60870_FirmwareUpdate_Provision(&update, 0U, &descriptor) == OK);
CHECK(IEC60870_FirmwareUpdate_Provision(&update, 0U, &descriptor) == INVALID);
CHECK(IEC60870_FirmwareUpdate_Init(&update, &update.store, IMAGE_CAPACITY) == OK);
CHECK(update.status.state == STABLE && storage.installs == 0U);
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == OK && boot.version == 1U);
memset(&status, 0xa5, sizeof(status)); unchanged = status;
CHECK(!IEC60870_FirmwareUpdate_Get_Status(NULL, &status));
CHECK(memcmp(&status, &unchanged, sizeof(status)) == 0);
CHECK(IEC60870_FirmwareUpdate_Get_Status(&update, &status) && status.current_slot == 0U);
CHECK(storage.metadata_size == 60U && memcmp(storage.metadata, "FWU1", 4U) == 0);
}
/**
* 功能:连续确认建立 current/backup 后,未确认的下一版重启须回退且保留更早备份。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:再次成功升级才轮转角色,并把已释放槽的元数据描述规范化为全零。
*/
static void Rotation_And_Trial_Rollback(void)
{
IEC60870_FirmwareUpdateDescriptor_t boot;
uint8_t current, backup;
Fresh(); Trial(2U);
CHECK(update.status.current_slot == 0U && update.status.backup_slot == 255U && update.status.candidate_slot == 1U);
CHECK(IEC60870_FirmwareUpdate_Abort(&update) == INVALID);
CHECK(IEC60870_FirmwareUpdate_Confirm(&update) == OK);
CHECK(update.status.current_slot == 1U && update.status.backup_slot == 0U);
current = update.status.current_slot; backup = update.status.backup_slot;
Trial(3U);
CHECK(update.status.candidate_slot == 2U);
CHECK(Recover() == OK && update.status.state == TRIAL);
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == OK && boot.version == 2U);
CHECK(update.status.state == STABLE && update.status.current_slot == current && update.status.backup_slot == backup);
CHECK(Crc(storage.images[backup], storage.sizes[backup]) == update.status.images[backup].crc);
Trial(4U); CHECK(IEC60870_FirmwareUpdate_Confirm(&update) == OK);
CHECK(update.status.current_slot == 2U && update.status.backup_slot == 1U);
CHECK(update.status.images[0].size == 0U);
}
/**
* 功能:接收偏移、孤立文件、CRC及策略拒绝分别覆盖:未授权重启不能续写或安装。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:坏候选可撤销/回退,而坏 current/backup 必须在重用槽或安装之前闭锁。
*/
static void Orphans_And_Validation(void)
{
IEC60870_FirmwareUpdateDescriptor_t boot, descriptor;
uint8_t bytes[19], slot;
unsigned begins;
Fresh(); descriptor = Payload(2U, sizeof(bytes), bytes);
CHECK(IEC60870_FirmwareUpdate_Begin(&update, &descriptor) == OK);
CHECK(IEC60870_FirmwareUpdate_Finish(&update) == INVALID);
CHECK(IEC60870_FirmwareUpdate_Write(&update, 1U, bytes, 1U) == INVALID);
CHECK(IEC60870_FirmwareUpdate_Write(&update, 0U, NULL, 1U) == INVALID);
CHECK(IEC60870_FirmwareUpdate_Write(&update, 0U, bytes, 0U) == INVALID);
CHECK(IEC60870_FirmwareUpdate_Write(&update, 0U, bytes, sizeof(bytes) + 1U) == INVALID);
CHECK(Recover() == OK && update.status.state == RECEIVING);
CHECK(IEC60870_FirmwareUpdate_Write(&update, 0U, bytes, sizeof(bytes)) == INVALID);
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == OK && boot.version == 1U);
Verified(2U); CHECK(Recover() == OK);
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == OK && boot.version == 1U);
Receive(2U); slot = update.status.candidate_slot; storage.images[slot][31] ^= 1U;
CHECK(IEC60870_FirmwareUpdate_Finish(&update) == REJECTED && !update.status.faulted);
CHECK(IEC60870_FirmwareUpdate_Authorize(&update) == INVALID);
CHECK(IEC60870_FirmwareUpdate_Abort(&update) == OK);
storage.reject_version = 3U; Receive(3U);
CHECK(IEC60870_FirmwareUpdate_Finish(&update) == REJECTED);
CHECK(IEC60870_FirmwareUpdate_Abort(&update) == OK); storage.reject_version = 0U;
Verified(2U); CHECK(IEC60870_FirmwareUpdate_Authorize(&update) == OK);
storage.images[update.status.candidate_slot][10] ^= 1U;
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == OK && boot.version == 1U && update.status.state == STABLE);
Trial(2U); CHECK(IEC60870_FirmwareUpdate_Confirm(&update) == OK);
storage.images[update.status.backup_slot][0] ^= 1U; begins = storage.begins;
CHECK(IEC60870_FirmwareUpdate_Begin(&update, &descriptor) == ERROR && update.status.faulted);
CHECK(storage.begins == begins);
Fresh(); storage.images[0][0] ^= 1U;
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == ERROR && storage.installs == 0U);
}
/**
* 功能:对10个持久状态边界分别注入“不落盘”和“已落盘但失败”,不根据返回码猜新版。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:phase 0..4为基线、接收、验证、取消、授权;5/6为安装意图/试运行提交;
* 7/8为回退意图/回退完成提交;9为确认轮转。恢复后的映像由实际提交事实决定。
*/
static void Every_Metadata_Boundary(void)
{
unsigned phase, mode;
for (phase = 0U; phase < 10U; ++phase) {
for (mode = 1U; mode <= 2U; ++mode) {
IEC60870_FirmwareUpdateDescriptor_t descriptor, boot = {77U, 77U, 77U};
IEC60870_FirmwareUpdateResult_t result = INVALID;
uint8_t bytes[31];
unsigned before;
if (phase == 0U) {
Empty(); descriptor = Payload(1U, 701U, storage.images[0]); storage.sizes[0] = descriptor.size;
} else { Fresh(); descriptor = Payload(2U, sizeof(bytes), bytes); }
if (phase == 2U) { Receive(2U); }
if (phase == 3U || phase == 4U) { Verified(2U); }
if (phase == 5U || phase == 6U) { Verified(2U); CHECK(IEC60870_FirmwareUpdate_Authorize(&update) == OK); }
if (phase >= 7U) { Trial(2U); }
storage.commit_mode = (int)mode;
storage.fail_commit_at = storage.commits + ((phase == 6U || phase == 8U) ? 2U : 1U);
switch (phase) {
case 0U: result = IEC60870_FirmwareUpdate_Provision(&update, 0U, &descriptor); break;
case 1U: result = IEC60870_FirmwareUpdate_Begin(&update, &descriptor); break;
case 2U: result = IEC60870_FirmwareUpdate_Finish(&update); break;
case 3U: result = IEC60870_FirmwareUpdate_Abort(&update); break;
case 4U: result = IEC60870_FirmwareUpdate_Authorize(&update); break;
case 9U: result = IEC60870_FirmwareUpdate_Confirm(&update); break;
default: result = IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot); break;
}
CHECK(result == ERROR && update.status.faulted && boot.version == 77U);
before = storage.commits;
CHECK(IEC60870_FirmwareUpdate_Abort(&update) == ERROR && storage.commits == before);
storage.fail_commit_at = 0U;
CHECK(Recover() == OK && !update.status.faulted);
result = IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot);
if (phase == 0U && mode == 1U) {
CHECK(result == IEC60870_FIRMWARE_UPDATE_EMPTY && boot.version == 77U);
} else {
/* 授权或确认已经落盘会保留新版;安装完成但TRIAL提交已落盘时,
* 下一启动应回退,因为没有健康确认。只落INSTALLING则继续同任务。 */
bool candidate = (phase == 4U && mode == 2U) || phase == 5U ||
(phase == 6U && mode == 1U) || (phase == 9U && mode == 2U);
CHECK(result == OK && boot.version == (candidate ? 2U : 1U));
if (update.status.state == TRIAL) { CHECK(IEC60870_FirmwareUpdate_Confirm(&update) == OK); }
CHECK(update.status.state == STABLE);
}
}
}
}
/**
* 功能:后端失败不能推进易失接收进度。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:接收阶段读失败闭锁,与安装前坏候选的回退
* 决策分开测试。安装前后失败都需重新Init,重试不得分配新的事务号。
*/
static void Platform_Failures(void)
{
IEC60870_FirmwareUpdateDescriptor_t descriptor, boot;
uint8_t bytes[33], slot;
uint64_t transaction;
unsigned mode;
Fresh(); descriptor = Payload(2U, sizeof(bytes), bytes); storage.fail_begin = true;
CHECK(IEC60870_FirmwareUpdate_Begin(&update, &descriptor) == ERROR && update.status.state == RECEIVING);
storage.fail_begin = false; CHECK(Recover() == OK);
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == OK && boot.version == 1U);
CHECK(IEC60870_FirmwareUpdate_Begin(&update, &descriptor) == OK); storage.fail_write = true;
CHECK(IEC60870_FirmwareUpdate_Write(&update, 0U, bytes, sizeof(bytes)) == ERROR && update.status.received_size == 0U);
storage.fail_write = false; CHECK(Recover() == OK); CHECK(IEC60870_FirmwareUpdate_Abort(&update) == OK);
Receive(2U); storage.fail_sync = true;
CHECK(IEC60870_FirmwareUpdate_Finish(&update) == ERROR && update.status.faulted);
storage.fail_sync = false; CHECK(Recover() == OK); CHECK(IEC60870_FirmwareUpdate_Abort(&update) == OK);
Receive(2U); storage.fail_read_slot = update.status.candidate_slot;
CHECK(IEC60870_FirmwareUpdate_Finish(&update) == ERROR && update.status.faulted);
storage.fail_read_slot = -1; CHECK(Recover() == OK); CHECK(IEC60870_FirmwareUpdate_Abort(&update) == OK);
/* 安装前丢失、截断或读不了候选时,仍能使用刚刚复验过的旧映像完成回退。 */
for (mode = 0U; mode < 3U; ++mode) {
Fresh(); Verified(2U); CHECK(IEC60870_FirmwareUpdate_Authorize(&update) == OK);
slot = update.status.candidate_slot;
if (mode == 0U) { storage.sizes[slot] = 0U; }
else if (mode == 1U) { --storage.sizes[slot]; }
else { storage.fail_read_slot = slot; }
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == OK && boot.version == 1U);
CHECK(update.status.state == STABLE && !update.status.faulted && storage.installed_slot == 0U);
CHECK(update.status.candidate_slot == IEC60870_FIRMWARE_UPDATE_NO_SLOT);
}
for (mode = 1U; mode <= 2U; ++mode) {
Fresh(); Verified(2U); CHECK(IEC60870_FirmwareUpdate_Authorize(&update) == OK);
slot = update.status.candidate_slot; transaction = update.status.transaction_id;
storage.fail_install = (int)mode;
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == ERROR && update.status.state == INSTALLING);
storage.fail_install = 0; CHECK(Recover() == OK);
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == OK && boot.version == 2U);
CHECK(storage.installed_slot == slot && storage.installed_transaction == transaction);
CHECK(Recover() == OK); storage.fail_install = (int)mode;
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == ERROR && update.status.state == ROLLING_BACK);
storage.fail_install = 0; CHECK(Recover() == OK);
CHECK(IEC60870_FirmwareUpdate_Prepare_Boot(&update, &boot) == OK && boot.version == 1U);
CHECK(update.status.state == STABLE && storage.installed_transaction == transaction);
}
}
/**
* 功能:多数非法记录重新计算CRC,确保检查的是格式版本、保留位及角色约束。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:事务号耗尽则是正常准入失败:仍可查询/启动旧版,不写介质、不置faulted。
*/
static void Metadata_Corruption_And_Exhaustion(void)
{
uint8_t valid[IEC60870_FIRMWARE_UPDATE_WIRE_SIZE], bytes[21];
IEC60870_FirmwareUpdateDescriptor_t descriptor;
unsigned variant, commits;
Fresh(); memcpy(valid, storage.metadata, sizeof(valid));
for (variant = 0U; variant < 11U; ++variant) {
memcpy(storage.metadata, valid, sizeof(valid)); storage.metadata_size = sizeof(valid);
switch (variant) {
case 0U: storage.metadata[0] = 'X'; break;
case 1U: storage.metadata[4] = 2U; break;
case 2U: storage.metadata[5] = 8U; break;
case 3U: storage.metadata[9] = 1U; break;
case 4U: storage.metadata[7] = 0U; break;
case 5U: storage.metadata[8] = 1U; break;
case 6U: Put(storage.metadata + 12U, 0U, 8U); break;
case 7U: Put(storage.metadata + 20U, 0U, 4U); break;
case 8U: Put(storage.metadata + 24U, IMAGE_CAPACITY + 1U, 4U); break;
case 9U: Put(storage.metadata + 32U, 1U, 4U); break;
default: --storage.metadata_size; break;
}
Put(storage.metadata + 56U, Crc(storage.metadata, 56U), 4U);
CHECK(Recover() == ERROR && !update.initialized);
}
memcpy(storage.metadata, valid, sizeof(valid)); storage.metadata_size = sizeof(valid);
storage.metadata[56] ^= 1U; CHECK(Recover() == ERROR);
memcpy(storage.metadata, valid, sizeof(valid)); storage.fail_metadata_read = true;
CHECK(Recover() == ERROR); storage.fail_metadata_read = false;
Put(storage.metadata + 12U, UINT64_MAX, 8U);
Put(storage.metadata + 56U, Crc(storage.metadata, 56U), 4U);
CHECK(Recover() == OK);
descriptor = Payload(2U, sizeof(bytes), bytes); commits = storage.commits;
CHECK(IEC60870_FirmwareUpdate_Begin(&update, &descriptor) == ERROR && !update.status.faulted);
CHECK(storage.commits == commits && update.status.transaction_id == UINT64_MAX);
}
/**
* 功能:运行升级映像轮换、试运行回退、逐元数据提交故障及损坏/序号耗尽用例。
* 输入参数:无。
* 输出参数:无。
* 返回值:正常完成返回 0;参数、运行或断言失败以非零状态结束进程。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
int main(void)
{
Inputs_And_Provision(); Rotation_And_Trial_Rollback(); Orphans_And_Validation();
Every_Metadata_Boundary(); Platform_Failures(); Metadata_Corruption_And_Exhaustion();
puts("FirmwareUpdate core: 6 groups passed");
return 0;
}