/* * 模块名称:IEC104 模拟器生命周期适配 * 作者:STM32F4-Base 项目组 * 说明:共享核心拥有组帧、业务与传输;本模块只装配宿主入口。 */ #include "iec104_sim.h" #include "iec104_core.h" #include "iec104_source.h" #include "IEC104_Net.h" #include "IEC60870_Time.h" #include #include #include #include #include static int s_started; static int s_exit_registered; /* 函数功能:严格解析十进制,不接受符号、空白、后缀或溢出。 */ static int parse_number(const char *text, uint32_t maximum, uint32_t *out) { uint32_t value = 0u; if (text == NULL || *text == '\0') { return -1; } while (*text != '\0') { uint32_t digit; if (*text < '0' || *text > '9') { return -1; } digit = (uint32_t)(*text++ - '0'); if (value > (maximum - digit) / 10u) { return -1; } value = value * 10u + digit; } *out = value; return 0; } /* 函数功能:打印协议模式用法并返回参数错误。 */ static int invalid_usage(void) { fprintf(stderr, "[iec104] usage: --iec104 [--iec104-port 0..65535] [--iec104-headless [--iec104-duration 1..86400]]\n"); fprintf(stderr, "[iec104] protocol mode cannot be combined with golden/selftest flags\n"); return 2; } /* 函数功能:在 main 的早退分支前校验协议选项与黄金模式互斥。 */ int iec104_sim_parse(int argc, char **argv, iec104_sim_options_t *options) { int i, seen_port = 0, seen_duration = 0, incompatible = 0; memset(options, 0, sizeof(*options)); options->port = 2404u; options->duration_s = 60u; for (i = 1; i < argc; ++i) { const char *arg = argv[i]; uint32_t value; if (strcmp(arg, "--iec104") == 0) { if (options->enabled) { return invalid_usage(); } options->enabled = 1; } else if (strcmp(arg, "--iec104-headless") == 0) { if (options->headless) { return invalid_usage(); } options->headless = 1; } else if (strcmp(arg, "--iec104-port") == 0) { if (seen_port++ || ++i >= argc || parse_number(argv[i], 65535u, &value)) { return invalid_usage(); } options->port = (uint16_t)value; } else if (strcmp(arg, "--iec104-duration") == 0) { if (seen_duration++ || ++i >= argc || parse_number(argv[i], 86400u, &value) || value == 0u) { return invalid_usage(); } options->duration_s = value; } else if (strncmp(arg, "--iec104", 8u) == 0) { return invalid_usage(); } else if (strcmp(arg, "--screenshot") == 0 || strcmp(arg, "--keys") == 0 || strcmp(arg, "--standby") == 0 || strcmp(arg, "--rtlive") == 0 || strcmp(arg, "--cfgtest") == 0 || strcmp(arg, "--logtest") == 0 || strcmp(arg, "--noclock") == 0 || strcmp(arg, "--yt-nopump") == 0 || strcmp(arg, "--comm-nopump") == 0 || strcmp(arg, "--wave-empty") == 0 || strcmp(arg, "--wave-bad") == 0) { incompatible = 1; } } if ((!options->enabled && (options->headless || seen_port || seen_duration)) || (options->enabled && incompatible) || (seen_duration && !options->headless)) { return invalid_usage(); } return 0; } /* 函数功能:兜底 SDL 窗口直接 exit 的有界停服清理。 */ static void stop_at_exit(void) { if (s_started && iec104_sim_stop() != 0) { fprintf(stderr, "[iec104] exit cleanup failed\n"); } } /* 函数功能:启动共享核心,核心只初始化一次 source,然后种入设备墙钟。 */ int iec104_sim_start(const iec104_sim_options_t *options) { iec104_core_config_t config; iec104_core_status_t status; time_t now; if (s_started || options == NULL || !options->enabled) { return -1; } if (!s_exit_registered) { if (atexit(stop_at_exit) != 0) { return -1; } s_exit_registered = 1; } config.bind_address = "0.0.0.0"; config.port = options->port; config.common_address = 1u; if (iec104_core_start(&config) != 0) { iec104_core_get_status(&status); fprintf(stderr, "[iec104] START_FAILED error=%d stage=%d native=%d\n", status.last_error, status.last_stage, status.native_error); /* Failed start may retain ownership when platform cleanup fails. */ s_started = status.owns_resources ? 1 : 0; (void)iec104_sim_stop(); return -1; } s_started = 1; now = time(NULL); if (now != (time_t)-1) { iec104_source_clock_seed((uint64_t)now * 1000u, IEC104_Net_Now_Ms()); } iec104_core_get_status(&status); printf("[iec104] READY address=0.0.0.0 port=%u ca=1 mode=%s\n", (unsigned)status.bound_port, options->headless ? "headless" : "window"); fflush(stdout); return 0; } /* 函数功能:执行一次非阻塞协议轮询,无 LVGL 或应用私有 socket。 */ int iec104_sim_poll(void) { return s_started ? iec104_core_poll() : -1; } /* 函数功能:有界停服并分别报告业务完成、写入与 IEC104 确认。 */ int iec104_sim_stop(void) { iec104_core_status_t status; iec104_source_stats_t stats; uint64_t device_ms; if (!s_started) { return 0; } iec104_source_stats(&stats); device_ms = iec104_sim_clock_ms(); if (iec104_core_stop() != 0) { return -1; } iec104_core_get_status(&status); s_started = 0; printf("[iec104] STOP connections=%lu rx_i=%lu written_i=%lu acked_i=%lu gi=%lu commands=%lu simulated_actions=%lu physical_do_actions=%lu parameter_commits=%lu clock_sets=%lu device_time_ms=%llu\n", (unsigned long)status.connections, (unsigned long)status.received_i_frames, (unsigned long)status.written_i_frames, (unsigned long)status.acknowledged_i_frames, (unsigned long)status.gi_completed, (unsigned long)status.commands_completed, (unsigned long)stats.simulated_actions, (unsigned long)stats.physical_do_actions, (unsigned long)stats.parameter_commits, (unsigned long)stats.clock_sets, (unsigned long long)device_ms); fflush(stdout); return 0; } /* 函数功能:查询协议模式是否持有运行核心。 */ int iec104_sim_enabled(void) { return s_started; } /* 函数功能:读取虚拟设备 UTC 毫秒墙钟。 */ uint64_t iec104_sim_clock_ms(void) { return iec104_source_clock_ms(IEC104_Net_Now_Ms()); } /* 函数功能:按协议库唯一时区常量转换 UI 本地域秒。 */ uint64_t iec104_sim_clock_local_s(void) { return iec104_sim_clock_ms() / 1000u + (uint64_t)IEC60870_LOCAL_UTC_OFFSET_MINUTES * 60u; } /* 函数功能:将面板本地域秒写回虚拟设备 UTC 墙钟,不改宿主。 */ int iec104_sim_clock_set(uint32_t epoch_s) { const uint32_t offset_s = (uint32_t)IEC60870_LOCAL_UTC_OFFSET_MINUTES * 60u; if (epoch_s < offset_s) { return -1; } iec104_source_clock_seed((uint64_t)(epoch_s - offset_s) * 1000u, IEC104_Net_Now_Ms()); return 0; } /* 函数功能:同可执行程序和核心内有限时服务,黄金路径不进入。 */ int iec104_sim_run_headless(const iec104_sim_options_t *options) { uint64_t deadline; int result = 0; if (iec104_sim_start(options) != 0) { return 1; } deadline = IEC104_Net_Now_Ms() + (uint64_t)options->duration_s * 1000u; while (IEC104_Net_Now_Ms() < deadline) { if (iec104_sim_poll() != 0) { fprintf(stderr, "[iec104] POLL_FAILED\n"); result = 1; break; } SDL_Delay(5u); } if (iec104_sim_stop() != 0) { result = 1; } return result; }