/* 召唤种类规则单测:直接调用无状态规则,验证限定词解析、数据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 #include #include #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(¶meters, 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(¶meters, 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; }