601 lines
30 KiB
C
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;
|
|
}
|