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

150 lines
7.7 KiB
C

/* 召唤种类规则单测:直接调用无状态规则,验证限定词解析、数据COT和允许的数据类型。
* 使用独立请求字节,不经过网络,也不执行应用的冻结或复位动作。 */
/*
* 文件内导航(搜索方括号标记;Suite:Rules):
* 总召Type100与计数量Type101的无状态规则测试;本文件无网络夹具,也不执行冻结复位动作。
* [COMMON/BASE] 公共基础:依赖、编译选项与断言入口
* [RULES/DECODE] 种类规则:IOA、QOI/QCC及FRZ字段解码
* [RULES/QUALIFIERS] 种类规则:限定词边界与数据COT映射
* [RULES/TYPES] 种类规则:数据类型、SQ、数据COT和冻结模式白名单
* [ENTRY/MAIN] 测试入口:三组无状态规则
* 公共辅助、业务专属辅助和用例按分区阅读;RUN/CASE标记用于细分执行组。
*/
/* ============================================================================
* [COMMON/BASE] 公共基础:依赖、编译选项与断言入口
* ============================================================================ */
#include "../104/business/IEC104_Interrogation_Internal.h"
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#define CHECK(x) do { if (!(x)) { fprintf(stderr, "%s:%d: %s\n", __FILE__, __LINE__, #x); exit(1); } } while (0)
/* ============================================================================
* [RULES/DECODE] 种类规则:IOA、QOI/QCC及FRZ字段解码
* ============================================================================ */
/**
* 功能:验证以下场景与约束:QCC同时包含RQT和FRZ。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:用非零IOA确认解析保留原值,业务合法性由后续校验决定。
*/
static void test_decode(void)
{
static const uint8_t qcc[] = {0x05, 0x45, 0x85, 0xc5, 0x01, 0x3f};
IEC60870_AppLayerParameters_t parameters = {1, 1, 2, 0, 2, 3, 249};
unsigned i, test;
for (i = 0; i < sizeof(qcc); ++i) {
for (test = 0; test < 2; ++test) {
uint8_t bytes[] = {101, 1, 6, 0x5a, 1, 0, 0x34, 0x12, 0, 0};
IEC60870_AsduInfo_t info;
uint32_t ioa = 0;
uint8_t qualifier = 0, freeze = 0;
/* TEST只标识测试请求,不放宽QCC或改变FRZ;副作用隔离由有状态执行入口保证。 */
bytes[2] |= test != 0U ? 0x80U : 0U; bytes[9] = qcc[i];
CHECK(IEC60870_Asdu_Parse(&parameters, bytes, sizeof(bytes), &info) == IEC60870_ASDU_OK);
CHECK(info.is_test == test && IEC104_COUNTER_INTERROGATION_RULES.decode(&info, &ioa, &qualifier, &freeze));
CHECK(ioa == 0x1234 && qualifier == (qcc[i] & 0x3f) && freeze == (qcc[i] >> 6));
CHECK(IEC104_COUNTER_INTERROGATION_RULES.qualifier_valid(qualifier) == (qualifier >= 1U && qualifier <= 5U));
}
}
{
uint8_t bytes[] = {100, 1, 6, 0, 1, 0, 0, 0, 0, 36};
IEC60870_AsduInfo_t info;
uint32_t ioa = 1;
uint8_t qualifier = 0, freeze = 3;
CHECK(IEC60870_Asdu_Parse(&parameters, bytes, sizeof(bytes), &info) == IEC60870_ASDU_OK);
CHECK(IEC104_GENERAL_INTERROGATION_RULES.decode(&info, &ioa, &qualifier, &freeze));
CHECK(ioa == 0 && qualifier == 36 && freeze == 0);
}
}
/* ============================================================================
* [RULES/QUALIFIERS] 种类规则:限定词边界与数据COT映射
* ============================================================================ */
/**
* 功能:遍历完整字节范围验证限定词边界,并检查总请求及四个分组的数据COT映射。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:检查不满足时由 CHECK 立即报告失败,不继续本用例。
*/
static void test_qualifiers(void)
{
unsigned q;
CHECK(IEC104_GENERAL_INTERROGATION_RULES.type_id == 100);
CHECK(IEC104_GENERAL_INTERROGATION_RULES.has_deactivation);
CHECK(IEC104_COUNTER_INTERROGATION_RULES.type_id == 101);
CHECK(!IEC104_COUNTER_INTERROGATION_RULES.has_deactivation);
for (q = 0; q < 256; ++q) {
CHECK(IEC104_GENERAL_INTERROGATION_RULES.qualifier_valid((uint8_t)q) == (q >= 20 && q <= 36));
CHECK(IEC104_COUNTER_INTERROGATION_RULES.qualifier_valid((uint8_t)q) == (q >= 1 && q <= 5));
}
for (q = 20; q <= 36; ++q) { CHECK(IEC104_GENERAL_INTERROGATION_RULES.data_cause((uint8_t)q) == q); }
CHECK(IEC104_COUNTER_INTERROGATION_RULES.data_cause(1) == 38);
CHECK(IEC104_COUNTER_INTERROGATION_RULES.data_cause(2) == 39);
CHECK(IEC104_COUNTER_INTERROGATION_RULES.data_cause(3) == 40);
CHECK(IEC104_COUNTER_INTERROGATION_RULES.data_cause(4) == 41);
/* 计数量总请求是RQT=5,却映射到COT=37,不能直接照搬总召的“限定词即数据COT”。 */
CHECK(IEC104_COUNTER_INTERROGATION_RULES.data_cause(5) == 37);
}
/* ============================================================================
* [RULES/TYPES] 种类规则:数据类型、SQ、数据COT和冻结模式白名单
* ============================================================================ */
/**
* 功能:验证以下场景与约束:交叉验证Type/SQ/COT/FRZ:保留Type15/37规则,Type206/207读取只接受COT=37。
* 输入参数:无。
* 输出参数:无。
* 返回值:无。
* 说明:总召允许九种监视类型及110..112参数;参数SQ由完整ASDU解析独立检查。
*/
static void test_types(void)
{
static const uint8_t types[] = {1, 3, 5, 7, 9, 11, 13, 15, 16, 20, 21, 37, 100, 101,
110, 111, 112, 113, 206, 207, 208, 255};
unsigned i, sq, freeze, cause;
for (i = 0; i < sizeof(types); ++i) {
for (sq = 0; sq < 2; ++sq) {
for (freeze = 0; freeze < 4; ++freeze) {
IEC60870_AsduInfo_t info;
memset(&info, 0, sizeof(info)); info.type_id = types[i]; info.is_sequence = (uint8_t)sq;
/* 冻结/复位无数据;扩展类型不因合法分组RQT而获得COT=38..41准入。 */
for (cause = 0; cause < 64; ++cause) {
bool expected = freeze == 0 && (types[i] == 15 || (types[i] == 37 && sq == 0) ||
((types[i] == 206 || types[i] == 207) && cause == 37));
info.cause_of_transmission = (uint8_t)cause;
CHECK(IEC104_COUNTER_INTERROGATION_RULES.data_allowed(&info, (uint8_t)freeze) == expected);
}
if (freeze == 0) {
bool general = types[i] == 1 || types[i] == 3 || types[i] == 5 || types[i] == 7 ||
types[i] == 9 || types[i] == 11 || types[i] == 13 || types[i] == 20 || types[i] == 21 ||
(types[i] >= 110 && types[i] <= 112);
CHECK(IEC104_GENERAL_INTERROGATION_RULES.data_allowed(&info, 0) == general);
}
}
}
}
}
/* ============================================================================
* [ENTRY/MAIN] 测试入口:三组无状态规则
* ============================================================================ */
/**
* 功能:测试入口:三组无状态规则
* 输入参数:无。
* 输出参数:无。
* 返回值:正常完成返回 0;参数、运行或断言失败以非零状态结束进程。
* 说明:本辅助入口用于构造或核对上述测试场景,相关状态保存在当前测试夹具中。
*/
int main(void)
{
test_decode(); test_qualifiers(); test_types();
printf("interrogation rules: 3 groups passed; request=%zu event=%zu station=%zu\n",
sizeof(IEC104_InterrogationRequest_t), sizeof(IEC104_InterrogationEvent_t),
sizeof(IEC104_InterrogationStationState_t));
return 0;
}