interface.c

源文件路径：midware/interface/interface.c 所属模块：midware/interface（外部接口层） 代码行数：380

1. 文件职责

本文件是 EMS 主控固件"外部接口层"的任务实现体，承载两个 uCOS-II 任务：task_interface_parse（500 ms 周期）与 task_modbus_rtu（信号量/100 ms 周期）。task_interface_parse 把 DRM 判定（drm_mode_judge()）、干接点逻辑（Handle_Dry_Node_Logic()）、配置参数落盘轮询（query_parameter_save_tags()）和 EPO（紧急停机）状态机（epo_control_handle()）串成一个固定顺序的轮询链，是这几个子模块唯一的驱动者。task_modbus_rtu 则根据运行态把 485 口（USART3）在三种用途之间仲裁——并机方案自适应探测、光伏充电桩/交流充电桩控制、Modbus-RTU 主站收帧，是 485 总线的"总线仲裁者"。它既是数据入口（Modbus 帧 → handle_modbus_ret_recv_data()），也是控制出口（逆变器开关机、充电桩启停），被 user/main.c 创建、被硬件中断（USART3 RECV）通过信号量唤醒。

2. 关键数据结构与宏

本文件不定义新结构体或枚举，只使用外部定义的类型与宏。

3. 函数清单

本文件共 5 个函数（1 个 static，4 个全局），无遗漏。

4. 核心逻辑解析

4.1 任务总览与调度时序

task_interface_parse（midware/interface/interface.c:211-232）：

drm_init();                          // 一次性：DRM 模式复位为 16（无效）
for(;;) {
    drm_mode_judge();                // DRM 电平采集 + 模式判定（内部自带 1 s 节流）
    Handle_Dry_Node_Logic();         // 干接点（EPO 输入 / 柴油机 / 老化 / 馈网控制）
    query_parameter_save_tags();     // 参数保存标志轮询（内部 5 s 节流）
    epo_control_handle();            // EPO 状态机
    OSTimeDlyHMSM(0,0,0,500);        // 固定 500 ms 周期
}

四个子逻辑的执行顺序是固定的且不可重入——因为它们共享 g_t_logic_info、STDryNodeInfo、DRY_NODE0/1 的 DO 输出。注意干接点逻辑 Handle_Dry_Node_Logic() 内部会直接操作 DRY_NODE1 宏（do0_output_on/off），而 DRM 判定会写 g_t_logic_info.u8_drm_mode，二者无锁保护，但都在同一个任务上下文里串行执行，因此不会自我竞争；风险在于其它任务（HMI/Net）对同一批全局量的读改写。

task_modbus_rtu（midware/interface/interface.c:298-379）是一个 4 路优先级分支 的循环：

只有在分支 4（纯 Modbus 从站模式）下才真正走信号量驱动：USART3 接收中断在 hardware/usart3/usart3.c:123 调 OSSemPost(g_t_uart3_rcv_sem)，本任务 OSSemPend 超时 100 ms（midware/interface/interface.c:364），超时后不再强行解析——即"有帧才处理，无帧就空转"。注释明确写着"调整阻塞时间，防止切换到充电桩时任务无法继续执行"，说明 100 ms 超时是为了让任务能感知运行态变化、及时跳出分支 4 去跑充电桩逻辑。

分支 2 / 3 会主动改写波特率并置保存标志（midware/interface/interface.c:320-326、333-339），把 g_t_modbus_config.u8_modbus_baud_rate 强制为 BAUD_RATE_9600，然后 uart3_init(9600) 重配外部 485；同时置 g_t_config_save_flag.u8_set_modbus_config_flag = TRUE，让 query_parameter_save_tags() 在另一个任务里落盘。这是一个跨任务的"写→标记→异步保存"模式。

4.2 EPO（紧急停机）状态机

状态机定义在 epo_control_handle()（midware/interface/interface.c:139-202）：

EPO_IDLE ──(config_enable && signal_status==TRUE)──> EPO_SEND_SHUTDOWN
   │                                                        │
   └──(protect_enable && !signal_status && run_mode==1 && comm_ok)──> EPO_SEND_STARTUP
                                                                    │
EPO_SEND_STARTUP ──(无条件)──> EPO_IDLE ─────────────────────────────┘

• EPO_IDLE 分支（midware/interface/interface.c:157-179）：先判 epo_read_config_enable()；配置使能后再读 epo_read_signal_status()。若信号有效（紧急停机输入触发）→ ems_set_fault_bit(24, TRUE) 置 24 号故障位、epo_set_protect_enable(TRUE) 置保护使能、迁移到 EPO_SEND_SHUTDOWN。若信号无效但 epo_read_protect_enable() 为真（说明此前进过停机保护），且此时逆变器运行模式 g_t_inv_info.t_run_info.u8_alphaess_run_mode == 1 且 inverter_read_comm_flag() 通讯正常 → 迁移到 EPO_SEND_STARTUP 自动恢复。
• EPO_SEND_SHUTDOWN 分支（midware/interface/interface.c:180-190）：没有出口（不改变状态），因此每 500 ms 会重复执行：inverter_shutdown() 发逆变器关机命令 → OSTimeDlyHMSM(0,0,0,500) 阻塞 500 ms → bms_set_shutdown(TRUE) → 若柴油机使能则强制 g_t_logic_info.u8_generator_on = FALSE。即只要 EPO 信号还在，就一直周期性重复下关机指令，属于"持续压制"而非"单次触发"设计。注意该状态下的额外 500 ms 延时会让 task_interface_parse 的实际周期变为 1000 ms。
• EPO_SEND_STARTUP 分支（midware/interface/interface.c:191-197）：inverter_startup() → 清 24 号故障位 → epo_set_protect_enable(FALSE) → 回 EPO_IDLE。注释"电池需手动开启"说明 BMS 侧不自动解除关机（bms_set_shutdown(TRUE) 没有对应的 FALSE 调用）。
• default 分支：状态越界时兜底回 EPO_IDLE。

上电宽限期（midware/interface/interface.c:142-153）：在 (INVERTER_TYPE == ALPHAESS_TYPE) 编译条件下，用 static bool s_b_first 记录首帧 tick，前 30 s（30 * 1000）直接 return，让系统状态（尤其 inverter_read_comm_flag()）稳定后再启用 EPO 判定。在本快照工程中 INVERTER_TYPE 被定义为 INVERTER_NULL（midware/inverter/inverter.h:172），因此该宽限期代码不参与编译，s_u32_tick_cond_start 也会成为未使用变量。

4.3 参数保存标志轮询

query_parameter_save_tags()（midware/interface/interface.c:46-130）是一个"标志→Flash 页"的转换表，节流逻辑先用 abs(s_u32_query_tick - OSTimeGet()) < 5000 判断，即至少间隔 5 s 才扫描一次。扫描表：

每个分支都是"先清标志、再投递任务"的顺序（如 midware/interface/interface.c:57-61），这样即使 save_job_post() 的队列满（返回失败），标志也不会被重复消费导致无限重试——但代价是这次配置变更会永久丢失。g_t_config_save_flag 的实际写者散布在各处：midware/interface/modbus/modbus.c（Modbus 写寄存器时大量置位，例如 modbus.c:5358 置 u8_set_ct_config_flag）、midware/ethernt/ethernet.c:1177、midware/ethernt/wireless/wifi/e_linker_wifi.c:341、以及本文件自身（interface.c:325、interface.c:338）等。

注意 u8_set_time_flag 是结构体中唯一没有被本函数处理的标志位。

4.4 并机通讯方案自适应

parallel_precept_change()（midware/interface/interface.c:239-291）由 task_modbus_rtu 在分支 1 调用，逻辑分四种情况：

1. 已经是 USART3 方案 → 直接返回，不做任何切换（把 USART3 当作并机的最终优选方案）。
2. 1 小时强制超时：abs(OSTimeGet() - u32_precept_change_recv_tick) >= 3600000（1 h）时，无条件置 u8_run_machine_precept = PARA_COM_TYPE_CAN 并置 u8_precept_change_recv_tick_flag = TRUE。这是"探测 1 h 仍未确定就用 CAN"的兜底。
3. 光伏充电桩非单机模式（pvcharger_read_machine_mode() != PVCHARGR_SINGLE_E）→ 直接锁 CAN。
4. 未配置方案 + 不依赖通讯卡：若 u8_comm_success_flag == TRUE（已通）→ 把运行时方案固化进配置；否则按 u8_parallel_mode（主机/从机）选择 PARALLEL_MSTER_CHECK_TIME（15 s）或 PARALLEL_SLAVE_CHECK_TIME（30 s）作为切换节拍，在 PARA_COM_TYPE_UART4 与 PARA_COM_TYPE_USART3 之间乒乓切换，并每轮把 u8_comm_success_flag = FALSE。
5. 未配置方案 + 依赖通讯卡 → 直接锁 CAN，等 u8_comm_success_flag 置位后固化。

这段代码本质是"开机把并机口当两个串口轮流试，谁通了就用谁"，而 CAN 是所有探测失败的兜底。它只改 g_t_parallel_total_machine_network.u8_run_machine_precept（运行时方案），通过 parallel_set_config_machine_precept() 落到配置。

4.5 Sunspec 分支

task_modbus_rtu 启动时若 g_t_modbus_config.u8_sunspec_en == TRUE，先 sunspec_modbus_data_init()（midware/interface/interface.c:302-305）。运行中在分支 4 收到 Modbus 帧后，若 Sunspec 使能且 sunspec_refresh_flag_get() != 0，刷新 Sunspec 数据模型（interface.c:369-371）。Sunspec 的具体实现位于 midware/interface/modbus/sunspec_business.c（sunspec_modbus_data_init 在 sunspec_business.c:1043，sunspec_modbus_data_refresh 在 sunspec_business.c:1173）。

4.6 全局变量读写一览

5. 对外接口

本文件导出的函数与全局变量：

本文件未导出任何全局变量（/**** Globales ****/ 段为空）。

本文件调用的外部函数/变量：

6. 依赖关系

依赖（本文件 include 或使用的外部模块）

interface.c:13-29 依次 include：interface.h、includes.h、drm.h、dry_node.h、modbus.h、main.h、system_config.h、inverter.h、evc.h、evc_ii.h、evc_download.h、evc_upgrade.h、usart3.h、logic.h、bms.h、data.h、sunspec_business.h。

即依赖 DRM、干接点、Modbus/Sunspec、系统配置存储、逆变器抽象层、两代充电桩驱动与升级、USART3 驱动、逻辑层、BMS、数据层。

被依赖（哪些文件会用到它）

• user/main.c:24 include interface.h 并创建两个任务 —— 这是唯一的外部使用者。
• 无其它 .c 文件引用本文件的函数。

7. 备注与风险点

1. 文件头注释错误：midware/interface/interface.c:2 写的是 @file :bms.c，是从 BMS 文件复制后未改，检索时会造成困扰。
2. query_parameter_save_tags / parallel_precept_change 缺 static 也无声明：属于隐式全局符号，链接期无原型校验，若将来有重名函数不会被立即发现。建议加 static（当前无跨文件引用）或补声明。
3. abs(s_u32_query_tick - OSTimeGet()) 使用有符号差值判断 5000 tick（midware/interface/interface.c:50）：s_u32_query_tick 未初始化时为 0，首次上电若 OSTimeGet() 大于 5000 会立即执行一次（可接受）。但用 abs() 处理 u32 差值在 tick 回卷边界（约 49.7 天）附近行为依赖实现，属于潜在边界问题。同样的写法出现在 interface.c:244、262（这里差值最大 1 h，无实际风险）和 drm.c:77。
4. EPO_SEND_SHUTDOWN 无出口状态：只要 EPO 信号保持，每轮都会 inverter_shutdown() + bms_set_shutdown(TRUE)，并以 OSTimeDlyHMSM(0,0,0,500) 在任务内额外阻塞 500 ms，把 task_interface_parse 的实际周期从 500 ms 拉到约 1000 ms。这会连带减慢 DRM 判定（内部 1 s 节流）与干接点响应，属于耦合副作用。
5. bms_set_shutdown(TRUE) 没有配对恢复：EPO_SEND_STARTUP 只调 inverter_startup() 并清故障位，BMS 关机状态保持，代码注释也承认"电池需手动开启"，属于有意设计但易被误读为 bug。
6. 分支 4 依赖 100 ms 信号量超时：OSSemPend(..., 100, &err) 调用后未清除信号量计数残留，若一帧数据触发多次 OSSemPost（hardware/usart3/usart3.c:123 在中断里 Post），可能出现"多 Post 单 Pend"导致下一轮 Pend 立即返回而缓冲区里没有新帧。handle_modbus_ret_recv_data() 内部应有长度/CRC 校验兜底（在 modbus.c:8389），但本文件层无法保证。
7. 波特率被强制改写：分支 2/3 一旦进入就把 u8_modbus_baud_rate 改成 9600 并触发落盘（interface.c:320-326、333-339），意味着用户通过 HMI/云端设置的其它波特率在接入充电桩时会被静默覆盖并持久化，退出充电桩模式后不会自动还原。
8. #if (INVERTER_TYPE == ALPHAESS_TYPE) 在本快照中不成立：midware/inverter/inverter.h:172 将 INVERTER_TYPE 定义为 INVERTER_NULL(0)，故 interface.c:142-153 的 30 s 上电宽限期与 s_u32_tick_cond_start 变量均被条件编译剔除；同样 dry_node.c 中多处 INVERTER_TYPE == ALPHAESS_TYPE 的运行时比较恒为假（见 dry_node.c 文档）。分析/调试时不能按"已启用 ALPHAESS 机型"来理解这些分支。
9. 并机 1 h 兜底阈值是魔法数字：3600000 直接写在 interface.c:244，未定义具名宏；PARALLEL_MSTER_CHECK_TIME / PARALLEL_SLAVE_CHECK_TIME 有宏但单位靠注释说明。
10. 任务内共享变量无保护：g_t_parallel_total_machine_network 同时被本文件的 parallel_precept_change() 与 midware/inverter/parallel.c、parallel_comm/* 读写，且跨任务/中断（CAN/SCI 接收），本文件未使用任何临界区或互斥量，存在读改写竞态风险。