dry_node.h

源文件路径：midware/interface/dry_node/dry_node.h 所属模块：midware/interface/dry_node（干接点接口） 代码行数：211

1. 文件职责

本文件是干接点（Dry Contact / 继电器接口）模块的类型与接口定义中心，为 EMS 定义两路干接点的全部配置结构、枚举与 IO 访问宏。它向外导出两块数据：一是持久化配置表 STDryNodeTab STDryNodeInfo（带 CRC 与 #pragma pack(1)，直接对应 Flash 一个扇区的一份镜像，由 net/ems.c、net/server.c、modbus.c 读写），二是入口函数 dry_node_io_init() 与 Handle_Dry_Node_Logic()。模块的语义是"把储能的 SOC / 馈网功率 / 时间段 / UPS 状态翻译成两路继电器输出"，用于负载投切、SG-Ready 热泵联动、柴油机启停、EPO 复归等外部联动。头文件本身不含逻辑，只有类型、宏和断言。

2. 关键数据结构与宏

STDryNodeTab 字段分组（dry_node.h:135-198）：

3. 函数清单

本文件只含函数声明，无函数定义。

4. 核心逻辑解析

4.1 两代配置表的共存

本头文件同时保留了两套"同一件事"的表示：

• 老版字段（u8StartTime1A/u8EndTime1A，u8 小时粒度，u8ChargeSOC1 百分比，u32SwitchOn1/u32SwitchOff1 瓦特）——供 Dry_Node1_Logic() / Dry_Node2_Logic() 使用。
• 新版字段（u16StartTimeM1A/u16EndTimeM1A，u16 分钟粒度："M" 指 Minute；u8FeedMode1/u16FeedValue1 馈网功率阈值；u8SGEnable1 SG-Ready 使能）——供 Dry_Node_Logic_ii() 流水线使用。

两套字段在同一个 STDryNodeTab 里并排存放，运行时由 dry_node.c:1899 的判据决定走哪一套：

if (STDryNodeInfo.u8FeedMode1 != 0 || STDryNodeInfo.u8FeedMode2 != 0)
    Dry_Node_Logic_ii();     // 新版：馈网/SG-Ready 模式
else {
    Dry_Node1_Logic();       // 老版：时间 / SOC / UPS 模式
    Dry_Node2_Logic();
}

即 u8FeedMode1/2 充当"新老版本仲裁开关"：一旦云端或 Modbus 下发过馈网模式（非 0），就整机切到新版逻辑，老版两个函数不再执行。这是一个典型的"版本遗留"式双实现共存。

4.2 结构体对齐与 Flash 存储约束

STDryNodeTab 与 DRY_NODE_II_TAB_T 都用了 #pragma pack(1)（dry_node.h:91 开启，dry_node.h:202 关闭），保证结构在 RAM 中与 Flash/通讯线上的字节布局一致，可直接 memcpy 到 Flash 或直接按字节发给云端。代价是：

• STDryNodeTab 中 u32SwitchOn1（4 字节）等字段在 pack(1) 下不再自然对齐，GD32F407（Cortex-M4）允许非对齐访问，但没有性能优势；
• STATIC_ASSERT(ASSERT_FLASH_SECTOR_SIZE % sizeof(STDryNodeTab) == 0) 是防止结构体尺寸变化导致 Flash 页布局错乱的关键保护——任何新增字段都可能让这个断言编译失败，这是有意设计。

DRY_NODE_II_TAB_T 末尾的 u16_sys_workmode、u8_bat_soc、s32_meter_actpower_t 是每周期刷新的采集量却被放在 pack(1) 的"表"结构里，命名上带 _tab 后缀但实为运行态工作区，容易被误当成持久化配置。

4.3 宏与硬件的绑定关系

dry_node.h:20-30 的 8 个宏把逻辑层与 hardware/gpio/gpio.h 绑定：

命名上 DI_1_DRY_CONTACT 实际读的是 DO 的输出回读位（而非输入引脚），DI_1_ACCESS_POINT 才是真正的 DI 输入——名字里的 DI/DO 容易混淆。

4.4 声明与实现的不一致

• dry_node_io_init() 只在本头文件声明（dry_node.h:208），全工程没有任何 .c 文件实现它，也没有任何地方调用它（grep 全工程仅命中该声明）。属于死声明。
• 头文件声明了 Handle_Dry_Node_Logic，也声明了 extern STDryNodeTab STDryNodeInfo，但没有导出 dry_node.c 中实际存在的其它函数：Get_Dry_Node_Status、Get_Week_By_Date、Judge_By_Time、Dry_Node1_Logic、Dry_Node2_Logic、update_dry_node_data、check_dry_node_mode、judge_by_week_time、deal_dry_node_mode、deal_dry_node_tick、driver_dry_node、handle_outside_npe_function、Dry_Node_Logic_ii，以及两个全局变量 g_t_dry_node_ii_info1 / g_t_dry_node_ii_info2。这些符号全部是隐式全局（无 static、无原型），无跨文件引用。

5. 对外接口

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

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

6. 依赖关系

依赖（本文件 include）

dry_node.h:13-15：chip.h、gpio.h、debug.h。ASSERT_FLASH_SECTOR_SIZE 与 STATIC_ASSERT 都由 debug.h 提供，不需要 system_config.h。

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

全工程共 10 个文件 include dry_node.h：

7. 备注与风险点

1. dry_node_io_init() 是死声明：只声明、无实现、无调用（dry_node.h:208），应删除或补实现，否则调用者会拿到链接错误。
2. DRY_NODE_II_MODE_E 有 3 个枚举值形同虚设（dry_node.h:67-69）：DRY_NODE_UPS_MODE 与 DRY_NODE_SGREADY_MODE 在 dry_node.c 中从未被赋给 u8_cur_dry_node_mode，是纯设计残留；DRY_NODE_NONE_MODE 仅在 dry_node.c:1278（干接点未使能时）被赋值，但 deal_dry_node_mode()（dry_node.c:1406-1526）与 deal_dry_node_tick()（dry_node.c:1548-1654）都没有为它写 case，一律落到 default 分支强制 NODE_DONE_OPEN，因此它的行为与"未知模式"完全相同，None 语义没有独立实现。
3. 命名不一致：STDryNodeTab（老式匈牙利/裸命名）与 DRY_NODE_II_TAB_T（下划线全大写）两种风格并存；DRY_NODE_STATUS_MAX（无 _E 后缀）与其它 ..._E 后缀枚举混杂；u8_modbus_dry1/2 是全表唯一使用小写下划线风格的字段。
4. pack(1) 下的非对齐多字节字段：STDryNodeTab 在 pack(1) 下 u32SwitchOn1、u16FeedValue1 等字段的偏移完全由前序 u8 数量决定，任何字段增删都会移动后续所有字段，与 Flash 中已存数据、net/server.c 的字段表、Modbus 寄存器映射三处产生联动破坏。STATIC_ASSERT 只保护了"总尺寸整除扇区"，不保护字段偏移，缺少版本号/字段偏移固化机制。
5. u8Status1/2、u32DelayTick1/2、u32DurationTick1/2、u32PauseTick1/2、u8RelayDone1/2 是运行态却存在持久化表里：这些字段会被写入 Flash 并在下电恢复时读回，而 tick 值是 OSTimeGet() 的绝对 tick，重启后 tick 归零，恢复出来的 u32DelayTick1 会变成"未来时间"，导致首次判断时 OSTimeGet() - u32DelayTick1 出现巨大的无符号差值回绕——dry_node.c:1573/1603/1632 有专门回绕分支处理，但依旧依赖正确性，属于高风险设计。
6. u8_reserve[28] 手算预留：预留区长度 28 是为凑 Flash 扇区整除而人工计算的结果（dry_node.h:197），一旦增删字段必须重新手算，建议改为编译期按剩余空间推导。
7. DEBUG_DRY_NODE 是"分支编号打印"式调试：dry_node.c 全文件共 52 × 2 处 printf("Dry_Node1_Logic...N")，一旦打开会让 500 ms 周期的任务严重超时，不宜在生产构建中启用。
8. STDryNodeTab 的 u16_head / u16_crc_code 无版本/长度字段：Flash 格式升级时无法识别旧版布局，只能靠 CRC 失败后整表复位。