system_config.c

源文件路径：data/system_config/system_config.c 所属模块：data/system_config（系统配置持久化：出厂值初始化、上电恢复、异步保存调度） 代码行数：3379

1. 文件职责

本文件是 EMS 全部配置数据的"落盘与还原中枢"，负责三件事：

一是出厂值初始化。24 个 *_info_init() 函数把每一类配置（系统基础信息、逻辑配置及三个时间控制扩展、电表、电池及电池扩展、逆变器、CT 配置与 CT 电量、能量统计、干接点、网络、Modbus、EVC 一代/二代、自定义配置与其备份、系统备份）填成出厂默认值、算好 Modbus CRC16 后整块写进内部 Flash 的 EEPROM 模拟区（页 4071~4095，每页 4 KB）。

二是上电恢复。system_info_restore()（system_config.c:2371）在 system/board_init/board_init.c:250 被调用，逐页读取并校验 CRC，成功则灌进对应的 RAM 全局变量，失败则回退调用同页的 *_init() 出厂值；同时处理跨页的兼容修补（老版本字段迁移）和"Flash 备份页 4095 与 4071/4077/4075 互救"逻辑。

三是异步保存调度。它创建 uCOS-II 消息队列 SaveJob_Q 与内存分区 SaveJobMsgBuffer（save_job_init，:2602），对外提供 save_job_post(page) 投递"某页需要保存"的任务（带去重位图），由 data/data.c 的 task_system_data 任务调用 system_config_data_save()（:2894）从队列取任务并真正写 Flash，写前重算 CRC，写后清业务侧的"配置已改"标志并更新 EEPROM 读/写故障标志。

被谁驱动：初始化/恢复由 board_init 与 data.c 的复位流程驱动；保存由全工程 131 处 save_job_post 调用点（hmi/key.c、net/server.c、logic/logic.c、midware/* 等）驱动，最终由 task_system_data 每 500 ms 拉一次队列执行。

2. 关键数据结构与宏

3. 函数清单

合计 59 个函数（其中 static inline 2 个，static 28 个，全局 29 个）。

4. 核心逻辑解析

4.1 保存任务机制（队列 + 内存分区 + 原子去重位图）

同步对象：save_job_init()（:2602）用 OSQCreate(SaveJobMsgGrp, MESSAGES_SIZE) 建队列、OSMemCreate(SaveJobMsgMem, MESSAGES_SIZE, sizeof(SAVE_JOB_T), &err) 建内存分区，两者都以失败仅打印不返回错误的宽松方式处理；随后 OSEventNameSet / OSMemNameSet 设置调试名。该函数由 data/data.c:257 在任务启动时调用一次。

投递路径 save_job_post(u16 msg)（:2688）：

1. g_u8_msg_id = msg - SYSTEM_STARTE_PAGE，把页号换算成 0..24 的位号。
2. 越界检查 + 去重：(g_u8_msg_id > MESSAGES_SIZE) || (atomic_check_and_set_bit(...) != 0) 即返回 0。位已被置说明该页已有排队中的任务，直接丢弃这次请求——这是"同一页最多一个待保存任务"的合并策略。
3. OSMemGet 取报文块，失败则 atomic_clear_bit 回退位图并返回 0。
4. 填 page_id / page / tim_s = OSTimeGet()，OSQPost 入队。队列满（OS_ERR_Q_FULL）时回退位图；成功则返回 1。

重试次数限制：atomic_check_and_set_bit 内部 l_u16_retry = 1000，__STREXW 失败最多重试 1000 次，返回 2 表示"重试用尽"。三个返回码（0 成功、1 已置位、2 重试失败）在 save_job_post 里被统一当成非零即失败处理（:2695）。

取用路径 save_job_pend(void *msg)（:2740）：OSQPend(SaveJob_Q, 1, &err) 超时仅 1 个 tick（OS_TICKS_PER_SEC=1000，即 1 ms），因此是"准非阻塞"轮询；成功时把 page 写到调用者的 u16 变量、算出 tim = OSTimeGet() - tim_s 作为耗时统计、原子清位图、OSMemPut 归还内存块。

主循环 system_config_data_save()（:2894）：

• 定时动作：if ((OSTimeGet() - s_u32_energy_tick) > 720 * 1000) 即每 720 s（12 分钟）调用一次 save_energy_data()，同时处理 tick 回绕（s_u32_energy_tick > OSTimeGet() 时重置基准）。
• 备份刷新：get_backup_data_refresh_flag() 为真 → 投递 SYSTEM_DATA_BACKUP_PAGE；g_system_custom_info 与备份镜像 memcmp 不等 → 投递 STSTEM_CUSTOM_CONFIG_BACKUP_PAGE。
• while (save_job_pend(&page)) 循环按 page 分派到 21 个 case，每个 case 的公共套路是：（1）把运行时统计值同步进待写结构体（如 METER/CT_ENERGY 页把分相电量抄进 config 结构、ENERGY_INFO 页先调 enenrgy_count_handle() 刷新统计）；（2）重算 u16_crc_code = GetCrcCode_Modbus(..., size - 2)；（3）最多写 3 次 feeprom_write()，成功即 break；（4）清业务侧"配置已改"状态位（Set_Setup_Config_Status(FALSE) / Set_Setup_Config_Extend1/2_Status(FALSE)）；（5）按结果更新 EEPROM 软件写故障标志 set_eeprom_fault_flag(get_eeprom_software_write_fault_flag(), page, !l_u8_res)。
• SYSTEM_BASE_PARA_PAGE 分支额外做两件事：OEM 不是 OEM_BW 时把 s8_sn[15] 清零（:2935）；从 LCD 取回密码与语言覆盖（:2937-2938）。
• NET_PARA_PAGE 分支把 IP 模式/地址/掩码/网关回写 LCD_RTDB（:3078-3100）。
• STSTEM_CUSTOM_CONFIG_PAGE、STSTEM_CUSTOM_CONFIG_BACKUP_PAGE 用 feeprom_init_write()（先擦扇区再写，覆盖语义）而不是 feeprom_write()（追加槽位语义），因为自定义配置页需要"整页唯一副本"。
• default 分支把 l_u8_save_flag = FALSE。
• 掉电保护：每处理完一页，若 l_u8_save_flag == TRUE 且 gpio_input_bit_get(GPIOG, GPIO_PIN_10) == SET（掉电预警仍有效），立刻 W5500_Power_OFF() + wifi_power_off()，把外部模块的电源让给 Flash 写操作（:3367-3371）。
• 单次调用处理上限：if (l_u16_save_cnt++ >= 6) break;（:3373），即一次最多处理 7 页，避免长时间占用系统数据任务。

4.2 上电恢复状态机（system_info_restore）

system_info_restore()（:2371）是一段顺序执行的"逐页恢复 → 失败回退"链表，无显式状态变量，但用 4 个标志位记录"哪些页是从坏数据回退的"，供后续备份修复使用：l_u8_sn_read_eeprom_flag、l_u8_net_read_eeprom_flag、l_u8_inv_read_eeprom_flag、l_u8_custom_read_eeprom_flag（初值均为 TRUE）。

迁移条件（按页号升序）：

三个跨页修复规则是本函数的"精华"：

1. 自定义配置互救（:2509-2526）：若 4088 页读失败（l_u8_custom_read_eeprom_flag == FALSE）但 4090 页备份读成功，就用备份内容重建 g_system_custom_info 并写回 4088 页。
2. 系统备份反哺三页（:2528-2591）：只有 4095 页读成功时才生效——SN 读失败则用备份里的 SN 补进 4071 页并写回（用 feeprom_write，因为 4071 页里还有当前 RAM 的其它字段，不能整页覆盖）；逆变器型号丢失则 set_inverter_type(备份型号) 后重写 4075 页；网络页读失败则把 MAC/IP 方法/服务器点/IP/掩码/网关全量补进 IP_Address 并写回 4077 页。
3. Flash 故障上报：4095 页也坏了就置 bit13，让上层出 EMS_FAULT_FLASH_FAULT 告警。

单个 *_restore 的统一实现骨架（以 system_sn_restore（:1128）为例）：

for (i = 0; i < 3; i++) {
    l_u8_res = feeprom_read(&l_t_buf, PAGE, size);
    if (l_u8_res == TRUE) {
        l_u16_crc = GetCrcCode_Modbus(&l_t_buf, size - 2);
        if (l_u16_crc == l_t_buf.u16_crc_code) {
            memcpy(目标全局变量, &l_t_buf, size);
            ...（兼容修补）...
            set_eeprom_fault_flag(读故障标志, PAGE, FALSE);
            return TRUE;
        }
    }
}
set_eeprom_fault_flag(读故障标志, PAGE, TRUE);
return FALSE;

关键点：最多试 3 次（应对 feeprom_read 内部偶发读失败），每次都是独立读同一地址——因为 feeprom_read 只在读取失败时才可能触发一次"槽位回卷"的擦写，所以重试有实际意义。

4.3 恢复期的字段兼容修补（老版本数据迁移）

恢复函数不只是拷贝，还内嵌了大量"历史版本补丁"：

这些修补保证"老设备升级固件后配置不炸"，但也意味着恢复函数的返回值语义被复用：modbus 的 break 是为了强制重初始化，而不是真的读失败。

4.4 出厂值初始化的写入策略与故障记账

所有 *_init() 的骨架一致：

1. memset(&目标结构体, 0, sizeof)（个别函数如 system_custom_backup_info_init/system_backup_info_init 走赋值而非清零）。
2. 填 u16_head = CONFIG_INFO_HEAD。
3. 填默认业务值（例：logic_config_info_init 设 u8_system_mode = DC_SYSTEM_MODE、u8_max_feedin_percent = 100、Charger_Cut_SOC = 100、UPS_Reserve_SOC = 10、GCRatePercent = 80、storage_grid_breaker_specs = 32、u8_ongrid_low_soc = 25、u8_offgrid_low_soc = 50、s32_grid_power_limit = 69000、馈网百分比 100/60/30/0，见 :303-318；PV_Capacity_Storage 取逆变器额定放电功率 inverter_read_rated_dc_discharge_power）。
4. u16_crc_code = GetCrcCode_Modbus(..., size - 2)。
5. 最多 3 次 feeprom_init_write()（擦扇区 + 写，覆盖语义），成功即 break。
6. set_eeprom_fault_flag(get_eeprom_software_write_fault_flag(), PAGE, !l_u8_res) 记账。

注意 net_ip_method_init（:698）的记账写法与其它函数不同：它写的是 if (l_u8_res == FALSE) set_eeprom_fault_flag(..., TRUE);，即失败才置位，成功时不清位——与其它页的 !l_u8_res 语义不对称（成功时清位）。

另外 *_init() 里对 l_u8_res 的判据有两套：大部分用 == TRUE，而 system_custom_info_init、system_custom_backup_info_init、system_backup_info_init 三处用 == FLASH_OK（:1028、:1061、:1116）。已核对定义：FLASH_ERR = 0, FLASH_OK = 1, FLASH_BSY = 2（hardware/flash/flash.h:105-110），TRUE = !FALSE = 1（system/sys/chip.h:64），两者数值相同，因此当前行为一致；但混用写法在枚举顺序被改动时会静默失效。

4.5 特殊初始化函数的额外副作用

• logic_config_info_init：会根据编译宏给 g_t_inv_info.t_config_data.u8_nn_short_detect_state 赋 NN_SET_FOLLOW（INVERTER_TYPE == ALPHAESS_TYPE）或 NN_SET_CLOSE（:320-324）——初始化一个页的同时改了另一页的内存结构。
• inverter_config_info_init：先把当前型号存进 l_u8_temp_model，清零整页后再 set_inverter_type(l_u8_temp_model) 恢复型号，随后 inverter_write_safety(AS4777_2) 写默认安全法规、u8_inv_igfollow_enable = TRUE、u16_sys_shutdown_days = 7（:567-575）。
• modbus_config_info_init：末尾调用 sunspec_modbus_data_init()（:762）初始化 Sunspec 数据模型。
• bat_config_info_restore：恢复后把电池配置同步进运行信息（u16_soft_ver、u8_type、u8_num、u8_dod、u16_cell_rate_volt、u16_cell_rate_capacity、u8_series_para_state、充放电截止单体电压、memcpy(t_run_info.s_type_splice, ..., 31)）（:1478-1487）。
• bat_extend_config_info_restore：循环 12 次把每节电池的单体软件版本/平台类型/SN 同步进 t_run_info（:1534-1540）。
• logic_config_extend1/2_info_restore：恢复后把 14 段时间控制 memcpy 进 g_t_time_control_run.logic_time_charge_dicharge_control1/2（:1271、:1320）。
• meter_config_info_restore 与 ct_energy_info_restore：恢复后把 4 项分相累计电量从 config 结构抄进运行结构（:1415-1418、:1633-1636）。

4.6 备份刷新检测（get_backup_data_refresh_flag）

get_backup_data_refresh_flag()（:2780）逐项比较 4095 页镜像与当前运行值，任何一项不同即返回 TRUE 并触发一次备份页写入：

1. s8_sn[16] 与 g_t_system_base_info.s8_sn；
2. u8_mac[6] 与 IP_Address.u8_mac_addr；
3. u8_inv_type 与 get_inverter_type()；
4. u8_server_point 与 IP_Address.u8_server_point；
5. u8_ip_method 与 IP_Address.IPmethod；
6. 且仅当 IP_Address.IPmethod == IP_METHOD_MANUAL 时才比较 IP/网关/掩码 12 个 u16（DHCP 模式下这些字段无效，跳过比较以避免无意义的反复备份写）。

这一函数与 system_config_data_save() 中的备份写动作构成"变更即备份"闭环：任何 SN/MAC/IP/型号变化都会在 500 ms 内被投递保存一次。

4.7 与 uCOS-II 的配合汇总

5. 对外接口

导出的函数（system_config.h:808-836 声明，除 net_info_init 原型写在 .c 内部）：

导出的全局变量：SaveJob_Q、SaveJobMsgGrp、SaveJobMsgBuffer、SaveJobMsgMem（未在头文件声明，仅本文件使用）、g_t_system_base_info、g_system_custom_info、g_system_function_info、g_system_msg_page_id。

本文件调用的外部函数/变量（按 include 分组，:13-34）：

• feeprom.h：feeprom_read、feeprom_write、feeprom_init_write。
• crc.h：GetCrcCode_Modbus。
• flash.h：FLASH_OK、扇区尺寸宏。
• data.h：ems_set_fault_bit、EMS_FAULT_FLASH_FAULT（以 bit13 字面量使用）。
• fault_warn_log.h：set_eeprom_fault_flag、get_eeprom_software_read_fault_flag、get_eeprom_software_write_fault_flag。
• ems.h：Set_Setup_Config_Status、Set_Setup_Config_Extend1_Status、Set_Setup_Config_Extend2_Status。
• ethernet.h：IP_Address、IP_METHOD_AUTO（:77）、IP_METHOD_MANUAL、AT_DEFAULT_PWD（:22）、服务器点枚举 FORMAL_ENCRYPTION_SERVER / OEM_ZOE_FORMAL_SERVER / OEM_BYTEWATT_FORMAL_SERVER / OEM_BYTEWATT_TEST_SERVER（:147-162）、IP_ADDR_TAB_T。
• ems.h：WIRELESS（net/ems.h:82，取值 0x02，赋给 IP_Address.u8_network_type）。
• lcd.h：LCD_RTDB（密码、语言、IP 显示、LCD_RTDB.u8_language）。
• logic.h：g_t_logic_info、g_t_time_control_run、DC_SYSTEM_MODE、ALL_DISABLE、RESERVE_SOC_DISABLE、LOGIC_CONFIG_TAB_T 及三个扩展表类型。
• meter.h：g_t_meter、METER_CONFIG_TAB_T。
• bms.h：g_t_bat_info、BATTERY_CONFIG_TAB_T、BATTERY_EXTEND_CONFIG_TAB_T。
• inverter.h：g_t_inv_info、INVERTER_CONFIG_TAB_T、VERSION_INV_HARD、get_inverter_type、set_inverter_type、inverter_write_safety、AS4777_2、inverter_read_rated_dc_charge_power、inverter_read_rated_dc_discharge_power、INVERTER_TYPE/ALPHAESS_TYPE/INVERTER_MAX 等编译宏。
• system_aux.h：g_t_energy_info、ENERGY_COUNT_INFO_T、enenrgy_count_handle。
• ct.h：g_t_ct、CT_CONFIG_TABLE_T、CT_ENERGY_SAVE_TABLE_T。
• modbus.h：g_t_modbus_config、MODBUS_CONFIG_INFO_T、ADDR_MODBUS（modbus.h:19，=0x55）、ADDR_SUNSPEC_MODBUS（modbus.h:20，=0x01）、BAUD_RATE_9600（modbus.h:1385，=0）。
• sunspec_business.h：sunspec_modbus_data_init。
• evc.h / evc_ii.h：g_t_evc_config_table、g_t_evc_setting_info、g_t_evc_ii_single_config[4]、各表类型、EVC_SLOW。
• dry_node.h：STDryNodeInfo、STDryNodeTab。
• gpio.h：gpio_input_bit_get(GPIOG, GPIO_PIN_10)、W5500_Power_OFF、wifi_power_off。
• debug.h：ShowData、STATIC_ASSERT。
• key.h：INSTALLER_PASSWORD、USER_PASSWORD（用户/安装商密码常量）、AT_DEFAULT_PWD。
• uCOS-II：OSQCreate、OSQPost、OSQPend、OSMemCreate、OSMemGet、OSMemPut、OSEventNameSet、OSMemNameSet、OSTimeGet、OS_ERR_*。
• Cortex-M 内核指令：__LDREXW、__STREXW、__CLREX。

6. 依赖关系

• 依赖（include 列表，system_config.c:13-34）：system_config.h、dry_node.h、feeprom.h、crc.h、ems.h、data.h、ethernet.h、lcd.h、logic.h、meter.h、bms.h、inverter.h、system_aux.h、flash.h、ct.h、modbus.h、sunspec_business.h、evc.h、evc_ii.h、debug.h、key.h、fault_warn_log.h。可以说它直接耦合了工程中几乎所有业务模块的配置结构体。
• 被依赖：system/board_init/board_init.c、data/data.c、data/resume_data/flash/flash_data_store.c、hmi/key.c、logic/logic.c、net/server.c、net/ems.c、midware/*（凡调用 save_job_post 或使用四个导出全局变量者）。

7. 备注与风险点

1. net_info_init 的 static 声明与非 static 定义冲突：:54 声明 static void net_info_init(void);，而 :130 定义 void net_info_init(void)，同时 system_config.h:831 又给出非 static 的原型。这是一个真实的语言层面矛盾（严格编译器会报错），说明该函数原本设计为私有、后来被提升为公开接口，但旧声明忘了删。修改时需同时动两处。
2. save_job_post 的越界判断是 > 而不是 >=：:2695 写 (g_u8_msg_id > MESSAGES_SIZE)。合法位号是 0..24，MESSAGES_SIZE=25，因此 g_u8_msg_id == 25 会通过检查并去置位位 25——虽然位 25 仍在 32 位联合体内（不会越界），但它是一个没有对应页面的保留位。若调用者传入 SYSTEM_STARTE_PAGE + 25，就会产生永远无法被 save_job_pend 清掉的悬挂位，最终导致该位后续再也不会被设置。建议改为 >=。
3. l_u16_save_cnt 未在每轮调用时复位：它在 system_config_data_save() 内定义为局部变量并初值 0（:2901），每次调用重新初始化，行为正确；但其累加判断 >= 6 位于循环末尾，实际最多处理 7 页，与注释"每页 10 ms"一起暗示了单次调用耗时上限约 70 ms，属于隐式时间预算。
4. 掉电时在页间关闭网络电源：:3367 依据 PG10 电平关闭 W5500/WiFi 电源，但 system_config_data_save() 也在正常运行态（task_system_data 超时分支）被调用。若因某种原因 PG10 长期为高而系统并未真正掉电，W5500/WiFi 会被反复关断，只能靠 data/data.c:281 的 W5500_Power_ON()/wifi_power_on() 在同轮末恢复——依赖"每轮必然执行到恢复语句"，若中途 Sys_Soft_Reset()（ems_reset_handle）触发则不复电。
5. l_u8_res 可能未初始化使用：SYSTEM_BASE_PARA_PAGE、LOGIC_CONFIG_PAGE 等 case 中，l_u8_res 每次循环都被 feeprom_write 赋值，无问题；但 system_custom_info_init（:1025-1030）、system_custom_backup_info_init（:1058-1063）、system_backup_info_init（:1113-1118）三处循环结束后 未使用 l_u8_res 记账，即这三页的写失败不会被记录到 EEPROM 故障标志，与其它页不一致。
6. TRUE 与 FLASH_OK 混用（本次核对后确认数值等价，属风格问题）：system_custom_info_init:1028、system_custom_backup_info_init:1061、system_backup_info_init:1116 以及 system_info_restore:2250/2296/2342 用 == FLASH_OK 判写成功，其余全部用 == TRUE。已核对定义：hardware/flash/flash.h:107-110 的枚举是 FLASH_ERR = 0, FLASH_OK, FLASH_BSY，即 FLASH_OK == 1；system/sys/chip.h:64 的 TRUE = !FALSE = 1。因此当前行为一致，不构成缺陷，但仍建议统一写法，避免以后有人改枚举顺序时静默失效。
7. net_ip_method_init 的故障标志语义不对称：:718-719 只在失败时置位，成功时不清位；而其它页是 set_eeprom_fault_flag(..., !l_u8_res) 双向记账。结果是网络页写成功后，之前的软件写故障位不会被清除，EEPROM 故障告警可能"粘住"。
8. clear_eeprom_fault_temp 与 set_eeprom_fault_flag 的范围不一致：data/data.c:192-201 循环 i < 32 而合法页范围只到 4095（位 24），后 7 次迭代被 set_eeprom_fault_flag 的 addr > SYSTEM_DATA_BACKUP_PAGE 保护静默丢弃（本文件未参与，但同属该机制）。
9. atomic_check_and_set_bit 的 return 2 未被区分：:2657 返回 2 表示 STREX 重试 1000 次仍失败（说明有极高并发的独占竞争），但 save_job_post 把 2 与 1 一样当作"已有任务"静默丢弃，可能造成该页长期不被保存而无人知晓（无日志、无故障标志）。
10. system_info_restore 依赖 IP_Address 已具备部分初值：net_info_init 在清零前先备份 IP_Address.u8_mac_addr 与 u8_server_point（:141-149），要求调用时该结构体里已经有 MAC（通常来自硬件/其它页）。若上电流程顺序变化导致 IP_Address 全 0，会写出一张全 0 MAC 的网卡配置，且因为 CRC 正确、head 正确，后续不会再被修复。
11. STSTEM_CUSTOM_CONFIG_PAGE 的 case 未做写失败记账：:3254-3266 只 break，没有 set_eeprom_fault_flag；同属 default 之外却缺少统一善后，属于不一致。
12. sys_info_restore 中 l_u8_custom_read_eeprom_flag 的双重语义：它先被赋成 system_custom_info_restore() 的返回值（TRUE 表示读成功，:2509），而 :2512 又用 == FALSE 表示"读失败需要从备份恢复"，与前三页的 read_eeprom_flag（TRUE 表示读成功，FALSE 后用来触发修复）语义相反，容易误读。
13. DEBUG_SYSTEM_CONFIG 关闭时 ShowData、printf 全部被条件编译剔除，但 system_sn_restore 中 l_u16_crc 变量在关闭调试时只在 CRC 比较处使用（:1155），不会产生未使用告警；而 dry_node_info_init:677 的调试打印引用了 g_t_evc_config_table.u16_crc_code（EVC 结构），属于复制粘贴留下的错误调试信息。
14. evc_ii_single_config_info1_init 的调试打印索引写错：:869-870 打印与 ShowData 用的是 g_t_evc_ii_single_config[1]，而该函数初始化的是 [0]（:861-866）。仅在 DEBUG_SYSTEM_CONFIG == 1 时可见，但会误导调试。
15. 魔法数字密集：ems_set_fault_bit(13, TRUE)（:2530）、720 * 1000（:2905）、l_u16_save_cnt >= 6（:3373）、32/80/10000/31 等默认值均无具名常量；memcpy(..., 31)（:1487）与 s_type_splice 数组长度的耦合也不明显。