server.c

源文件路径：net/server.c 所属模块：网络应用层（net） 代码行数：7304

1. 文件职责

net/server.c 是 EMS 与 AlphaESS 云端服务器之间的应用层协议实现主体，负责把 TCP/无线收到的整包报文拆帧、校验、按命令字分发，并把云端下发的"配置、安规参数、控制指令、固件"翻译成对本地全局结构体的读写与对底层驱动的调用。

它处在数据流的下行入口：net/ethernet.c 的接收任务调用 handle_tcp_recv_data()（net/server.c:6280）把一包数据交给本文件，本文件再依次分发给 handle_special_cmd()（控制指令）、handle_check_update()（升级检查）、handle_fw_file_from_server()（固件分片）、deal_get_config_data()（配置下发）、deal_get_safety_config_data()（安规参数下发）、parse_meter_data()（无线表数据）等处理函数。

上行方向本文件只负责置位各类响应标志（g_u8DispatchFlag、g_u8SetConfigFlag、g_u8SyncFlag 等，均定义在 net/ems.c:66-70），由 net/ems.c 的发送流程轮询后组包回传，实现"收-处理-置标志-发"的解耦。

此外本文件还承担远程固件升级的完整客户端流程：轮询选择升级目标（load_current_update_data）、校验云端下发的文件信息（set_file_updating_info/check_server_fw_is_updating）、按偏移拼装固件到 SDRAM/Flash（handle_fw_file_from_server）、结束时计算 MD5 并置状态为完成。

2. 关键数据结构与宏

2.1 本文件定义/持有的全局变量

2.2 宏常量

2.3 结构体与枚举（本文件主要使用的）

3. 函数清单

4. 核心逻辑解析

4.1 报文帧格式与接收（handle_tcp_recv_data，:6280）

帧格式（7 字节头 + 正文 + 2 字节 CRC）：

接收流程：

1. 清零 g_au8NetRecvPack（5KB，:6290）。
2. 按 type 分两条完全对称的分支：type == W5500 走 recv(SOCK_TCP_CLIENT, ...)（:6298），type == WIRELESS 走 wireless_recv(...)（:6353）。两者都是"循环收头直到满 7 字节或超 1 秒"（W5500 正文再超 1 秒、无线正文超 5 秒），未收满直接 return（丢帧，:6311、:6337）。
3. 长度字段做上限保护：l_u32DataLen > sizeof(g_au8NetRecvPack) - 9 时钳到该值（:6316），防止写越界。
4. l_u32PackLen = 7 + dataLen + 2（:6340），并在 (0, sizeof(g_au8NetRecvPack)] 区间内才继续（:6403）。
5. CRC 比对；不匹配仅打印调试信息，不回复（:6407、:7121-7127）。
6. 记录端口 g_stNetSysInfo.u16_skip_port（:6409）；若服务器为私有加密通道且非 APP 连接，对正文做 decrypt() 原地解密（:6410-6416，长度 packLen-9）。
7. 若正文含 "Status":"LoginError" → bIsLogin = FALSE（:6418-6425）。
8. 无线上行未登录时不处理非 0xA4/0xA5 命令（:6427-6433），保证无线电表数据在断云时仍可用。
9. switch(pack[2]) 按命令字分发（:6435）。

关键命令字与动作（:6435-7119）：

4.2 特殊指令分发（handle_special_cmd，:2605）

入口先校验：buf == NULL || !len 直接返回（:2612），然后 json_check(buf+7, len-7-2)（:2615）确保正文是合法 JSON，再从 buf+7 取 "Command" 字段（:2621）做字符串比较分发（约 28 条分支）。只有 SetConfig / UploadInterval / SetBatBrand / 智能化等少数分支不写 g_as8SpecialCmdId，其余分支都会先 get_special_cmd_id_code(buf+7,...) 记录 CmdIndex 供响应回填。

各分支动作要点：

• "Update"（:2624）：先清 u8_forceupdt_flag，再按 Parameter1 分派到 8 种目标。是否强制升级由运行模式决定，例如 EMS/AFCI：(inverter_read_run_mode() != cUPS) || l_u8_upgrade_flag == TRUE（:2635、:2678）；INV ARM 还需 inv3_upgradeable_flag()（:2641）；BMS 需 bms_upgradeable_flag() && !bms_get_ready_enable()（:2658）；Meter 用 inverter_read_grid_freq() > 4500（即 50Hz 系统，:2665）；EVC 用充电桩使能（:2672）。"INV" 会连续调用两次：INV1 与 INV2（:2649-2653），且 INV1 返回非 0 时提前返回。
• "Restart"（:2684）：置 g_u8RestartFlag = TRUE。
• "SetConfig"（:2696）：置 g_u8SetConfigFlag = TRUE。
• "Resume"（:2708）：按 Y/M/D/H/F/S 标记从 Parameter1 提取时间，Parameter2 取长度；在 10 条 g_resume_info[] 里查重，不重复且 u32_length == 0 的空槽才写入；置 g_u8_resp_resume_flag = TRUE。
• "RemoteControl"（:2781）：ForcedCharge / ForcedWork / CloseMOS 三种；ForcedWork 会同时清强制充电与电池功率控制标志并 bms_set_mos_enable(TRUE)。
• "SyncTime"（:2821）：置 g_u8SyncFlag 并立即 set_sys_rtc(buf+7)。
• "Dispatch"（:2835）：handle_server_dispatch_command() + g_u8DispatchFlag。
• "Extra"（:2848）：handle_server_extra_command() + g_u8ExtraFlag。
• "PowerFactor"（:2861）/ "EVChargeEN"（:2874）/ "DebugRunInfo"（:2891）/ "UploadSafetyConfig"（:2903）/ "SYSShutDownEN"（:2916）/ "SetChargeEN"（:2929）/ "SendEnergyDataEN"（:2943）/ "ICDCUpdate"（:2956）/ "G100Reboot"（:2971）/ "SYSSelfTest"（:2984）/ "SetBMSActivationTime"（:2997）/ "SetSOCCalibrationg"（:3010）/ "SmartDispatch"（:3024）/ "ExpandICDCUpdate"（:3053）/ "UploadInterval"（:3069）/ "SetBatBrand"（:3080）：分别调用对应处理函数并置响应标志。
• "GetBatLog"（:3038）：整段被 #if 0 屏蔽，当前无效。
• "CanSend"（:3090）：handle_server_can_send_command()。
• "UploadCanLog"（:3103）：防重入——若 s_can_log_ctrl.active != 0 则回一条失败响应并返回；否则解析 Parameter1 的 "ID1,ID2,...,IDN:条数" 格式：先按 : 切出 ID 列表与条数，再按 , 逐个 sscanf("%08lX") 解析为 u32 ID；校验 1 ≤ id_count ≤ MAX_CAN_LOG_ID_COUNT 且 1 ≤ count ≤ MAX_CAN_LOG_COUNT 后 start_can_log_capture() 并回成功。

4.3 扩展参数表（handle_server_parameter_set，:849）

index 采用高字节分组 + 低字节索引编码，l_s32_value = atoi(Parameter2)：

handle_server_extra_command（:1556）在调用它之前先拦截三个特殊 index：

• 65534（:1580）：改写系统 SN并 save_job_post(SYSTEM_BASE_PARA_PAGE) → 延时 1 秒 → system_hard_reset()。OEM_BW 取 16 字节，其它 OEM 只取 15 字节（:1583-1590）。
• 65535（:1596）：改写 MAC，要求 Parameter2 长度恰为 12 个 HEX 字符，逐 2 字符 strtoul 成 6 字节；且 l_u8_buf[0] % 2 == 0（单播地址）才接受，随后落盘 + 延时 1 秒 + 硬复位。
• 65533（:1621）：电池单包 SN 替换，"源SN,目标SN" 且两者都需含 "ALP" 子串，写入 g_t_bat_set_sn_info[] 首个空闲槽（状态置 BMS_SET_SN_IDLE）。

4.4 远程升级状态机（load_current_update_data，:610）

由 net/ems.c 升级流程周期调用（1 秒一步：OSTimeGet() - s_u32TickLoad > SENCOND_1S，:619），并且当前状态 ≤ UPDT_STS_IDLE 才推进（:615，即 UPDATING/OVER 期间冻结）。另含 tick 回绕保护：s_u32TickLoad > OSTimeGet() 时重新对齐（:726）。

状态迁移链：CHECK_NO → CHECK_EMS → CHECK_BMS → CHECK_INV1 → CHECK_INV2 → CHECK_INV3 → CHECK_METER → CHECK_EVC → CHECK_AFCI → CHECK_NO。

• CHECK_NO（:624）：若 check_updt_force_is_none()（8 个设备都无强制升级标志）→ pstCurrUpt = NULL；否则进入 CHECK_EMS。
• CHECK_EMS/BMS/INV1/INV3/METER/EVC/AFCI：统一调 load_current_update_data_setCurrUpt(当前设备, 下一状态, &state)（:577）。
• CHECK_INV2（:667）单独特殊处理：必须 INV1 已置 Get_Status_Is_Updated_From_Server() 才挂接 INV2，否则清 INV2 标志——保证逆变器两台串行升级。

load_current_update_data_setCurrUpt 的判定逻辑（:577）：

if (get_flag_force_update(currType)) {
    if (check_force_upgradable_flag() == TRUE)      // 当前没有设备正在从服务端升级
        g_stEMSInfo.pstCurrUpt = &(g_stEMSInfo.stUpt[currType]);
    else {
        set_flag_force_update(currType, FALSE);      // 有并发升级，放弃该设备
        if (currType == UPDT_INV1 && Get_Status_Is_Updated_From_Server(UPDT_INV2))
            set_flag_force_update(UPDT_INV2, FALSE);
    }
} else
    *state = nextCheck;                              // 无任务，推进到下一设备

4.5 升级文件信息校验与下载（:2346、:3222、:3318、:3435、:3529、:3675）

指令解析（handle_special_cmd_for_dev，:2346）： 从 Parameter2（INV2 例外地用 Parameter3）中 strstr 定位 mark（如 "EMS"、"uploads/app_update/"），随后找两个 '-' 之间的片段即为版本号，长度须 ≤ MAX_LEN_SOFT_VER-1；非 EVC 设备还要求 URL 长度 > "uploads/app_update/" 长度。满足后： set_status_update_file_info(type,FALSE) → set_flag_force_update(type, isForceUpd) → set_updt_file_mask() → set_ver_from_server() → set_updt_status_current(UPDT_STS_IDLE) → 清 s_s8_updgrademd5 并从 "Description" 取 32 位 MD5（INV2 除外）。Meter 分支还会按 URL 里是否含 "Meter" 区分 FILE_MASK_METER（并取 Parameter3 设升级对象）与 FILE_MASK_BB（固定电网表）。EVC 分支取 Parameter3 设 set_evc_upgrad_flag()。

文件信息校验（set_file_updating_info_for_dev，:3318 + check_server_fw_is_updating_for_dev，:3222）： 逐个解析 UpdateFileMask / FileLen / FileMD5Code / SoftVer / HardVer / FileName / FWType（BMS 另解析 "Platform" → UPGRADE_GD32|UPGRADE_NXP），并用局部 test 记录首个失败码（1..7）。长度必须落在 (sizeMin, sizeMax) 开区间内（:3326），MD5 必须恰为 32 字符（:3338）。全部通过才 check_server_fw_is_updating()。

check_server_fw_is_updating_for_dev 的 4 项一致性判定（:3227-3230）：

strstr(FileMask, 期望掩码)  &&  strstr(来源厂商串, 本地厂商型号)
&& (硬件版本串为 NULL 或 strstr(硬版本, 期望硬版本))
&& (type == UPDT_INV2 || memcmp(MD5, get_local_md5_ems_upt_file(), 32) == 0)

匹配成功 → 清零静态重试计数 s_u8_upgrade_cnt、set_status_update_file_info(type, TRUE)、EMS 另存 save_ems_server_update_info()、clear_curr_offset_file_request(type)、状态置 UPDT_STS_UPDATING（:3231-3237）。失败 → 计数达到 MAX_CNT_REQ_FILE_ERROR(5) 时清空对应 STUpdateTab（INV1/INV2 一起清）、状态置 UPDT_STS_NONE、g_t_upgrade_run_info.u16_upgrade_error.BIT.web_error = 1（:3243-3253）。

设备 → 本地特征值的映射在 check_server_fw_is_updating（:3275）：EMS 用 get_ems_hard_type()/get_ems_hard_version()，逆变器三路用 inverter_read_inv_type()/inverter_read_hw_ver()，BMS 用 bms_read_battery_model()（硬版本传 NULL），Meter 用 get_Meter_Updt_File_Mask()/meter_get_meter_modle(get_meter_updt_object())，EVC 按 get_evc_enable_flag() 二选一型号接口，AFCI 用 get_afci_type()/get_afci_hard_version()。

检查响应（handle_check_update，:3529）：strstr(buf+7,"Success") → 清错误计数、set_file_updating_info(buf,len)、OSSemPost(g_pUpdateSem) 唤醒等待下载的升级任务（配合 net/ems.c:4686 的 OSSemPend(g_pUpdateSem, 3000, &err)）。"Error" → 静态计数 s_s32CntReqFileInfoErr 超 5 次则清空整张 stUpt[]、状态置 UPDT_STS_IDLE、置 web_error。

分片接收（handle_fw_file_from_server，:3675）：五级门禁依次校验 ① UpdateFileMask 存在且与 get_current_point_file_mask() 前 8 字节 memcmp 相等； ② FileOffset == get_current_point_offset_file_updt()； ③ FWType 与本地厂商型号匹配（按掩码判定 7 种设备，:3705-3711）； ④ FileLen ≤ LEN_REQ_FILE(1024)； ⑤ FileData 存在。 全部通过后：hex_ascii_to_bin(FileData, 2*lenPck, g_au8FWBin) → save_fw_to_spi_flash()。随后判断 offset + lenPck >= 总长：

• 未结束：OSSemPost(g_pUpdateSem) + increase_current_offset_file_updt(lenPck)；
• 结束：按设备调用 calculate_ems_flash_md5() 或 calculate_dev_FW_Flash_MD5(type, sdram 基址, 下载区枚举)，然后 set_current_point_flag_force_updt(STOP_FORCE_UPDT)、set_current_point_updt_file_info(FALSE)、set_updt_status_current(UPDT_STS_IDLE)。

落盘分派（save_fw_to_spi_flash，:3642）：UPDT_EMS → save_fw_to_flash()（写 Flash）；UPDT_INV2 → save_fw_to_sdram(..., g_u8_fw_sdram2)；其余 6 类 → save_fw_to_sdram(..., g_u8_fw_sdram1)。save_fw_to_sdram/save_fw_to_flash（:3583/:3607）只在 Len < 1024（补齐 0xFF 后按 1024 写）或 Len == 1024 时动作，其它长度静默丢弃。

4.6 配置下发解析（deal_get_config_data，:4082）

这是全文件最大的函数之一（:4082-5206，约 1120 行），针对约 300 个 JSON 字段。结构上有 5 种解析模式：

1. 前置校验（:4107-4126）：解析 "SN" 与本地 15 字节比对，不一致置 l_u8SNErrorFlag；解析 "ZipCode" 判空。仅当 type == CMD_SET_CONFIG 或 CMD_SET_CONFIG_EXTEND1（APP 直连）时允许 ZipCode 为空，否则直接 return 不处理任何配置。
2. const 表驱动：
   • g_json_simple_map[]（:3942-4025，约 90 项）——json_get_value + atoi + json_store_by_size() 按宽度写入，覆盖 SetMode、SetPhase、干节点 1/2 的 30 余个字段、GridPowerLimit、PapInvLimit、SOC 校准参数、各使能位等；
   • g_json_time_map[]（:4027-4037，8 项）——输入为"当日分钟数"，< 1440 时拆成 hours = v/60、minutes = v%60（:4233-4247）。
   • parse_bool_field()（:4042）处理 true/false 形态的布尔字段（Generator、BackUpBox、GridCharge、CtrDis）。
3. sscanf 数组块（固定长度 CSV，起点用 strstr 定位）：
   • "EV1" 10 项（:4296）：单桩配置，含两组时段的分钟数→时分换算，末位校正（相数 0→3，最大电流 0→160）；
   • "EVC%d"（i=1..MAX_EVC_II_NUM）20 项（:4344）：EVC-II 四路配置，三组时段各做分钟→时分换算，并为相数/电流做缺省回填（:4385-4392）；
   • "TIMEChaDis%d" 1..14 与 15..28 各 10 项（:4406、:4433）：两套充放电时段表，分别落 t_config_extend1_data/t_config_extend2_data，并同步到运行副本 g_t_time_control_run；含 3 个缺省回填公式——放电功率为 0 取额定放电功率、放电截止 SOC 不得低于 UPS 保留 SOC、充电电网功率为 0 取额定充电功率；
   • "TIMEfeedin%d" 1..6 共 5 项（:4462）：强制馈电时段；
   • "DryTime1"/"DryTime2" 各 4 项（:4831/:4843）：干节点时段（分钟数）；
   • "PeShValue" 11 项（:4992）：峰谷电价与 4 组峰/谷时段；
   • "CsipAus" 15 项（:5135）：南澳 CSIP 的 DER 控制参数（导出限值、斜坡、持续时间等），带显式 (u8)(s32)(u16)(u32) 宽度转换。
4. 字符串切割块："BMSActivationtime" 12 组 YYYY-MM-DD（:4908，按 , 递进切分，长度不为 10 时回填 1/1/1）；"SOCCALTime" 单个日期（:4974）；"WifiPWD"（:4884，需系统功能位允许，空串回填 AT_DEFAULT_PWD，变化时 net_init()）；"EVCGunLockEN" 按 bit 拆到 4 路枪锁（:4332）；"FeedinK1..K4" 循环（:5081，值 ≤100 才写）；"InstallDate"（:5103）。
5. 带副作用/带范围检查的单字段：网络类（IPMethod/LocalIP/SubnetMask/Gateway → 置 u8_set_net_para_flag）、Modbus（ModbusAddress/ModbusBaudrate → 波特率变化立即 uart3_init(9600/115200/256000)）、CT 类（CTRate/GridMeterCTE/PVMeterCTRate/PVMeterCTE/InstallMeterOption/Meter_CT_Select）、相序取反逐相位（GridMeterN_L1..L3、PVMeterN_L1..L3）、安规相关特殊字段（PapInvEN 仅澳规 AS4777 可设、OutsideNpeEN 仅 NC2022、GfciEN/PrepayMeterEN 仅 NRS097_2_1、AcOutBat 仅 TOR_ERZEUGER，后者在安规解析里）、以及大量直接调用驱动接口的字段（inverter_set_three_unbalance_mode、bms_set_self_lock_enable、meter_set_ct_sampling、epo_set_config_enable、modbus_sunspec_en_set+sunspec_modbus_data_init、meter_set_chnt_wireless_module_regional_freq_bands 等）。

收尾（:5179-5206）：置电网表检测标志；按系统模式（AC/HYBRID）决定 PV 表检测标志；GCRatePercent == 0 时补 80；最后连续投递 15 个 Flash 保存任务（SYSTEM_BASE / LOGIC / METER / BATTERY / INVERTER / DRY_NODE / EVC_CONFIG / EVC_SETTING / EVC_II_SETTING1..4 / LOGIC_CONFIG2..4 / MODBUS_CONFIG），由 save_job_post() 通知断电续传存储任务落盘。

4.7 安规参数解析（deal_get_safety_config_data，:5219）

结构与上一函数类似但全部走 inverter_set_* 接口、不写 Flash（安规参数由逆变器侧持久化）。:5219-6100 共处理 97 个字段。

• 入口 SN 校验（:5225-5229）："SN" 存在且与本地前 15 字节不一致则整包丢弃（注意与配置函数不同：SN 字段缺失时不拦）。
• 数值转换有两类：atoi() 直接取整（用于使能位、枚举、次数），parse_fixed(buf, scale)（logic/math_tools.c:56）把小数串按 scale 放大为整数，scale=10 表示保留 1 位小数、100 表示 2 位小数、1 表示只取整数部分。典型：OVP1_Value 用 parse_fixed(...,10)（:5233），OVP1_Time 用 atoi 后再 /10（:5242-5243，把"0.1s 单位"转成"秒"），UnFreqDerStart 用 scale=100（:6050）。
• 字段分组覆盖：过/欠压 3 段 + 10 分钟段 + 恢复值；过/欠频 3 段 + 恢复值；频率变化率；并网等待/重连/爬坡；ISO/漏电流（DCI）检测与阈值、GFCI 4 档阈值；孤岛/零线/LN 突变/AFCI/PV 电流/直流电压/波形检测使能；UPS 电压保护、N-PE 短路、备电频率；有功/无功下垂控制（3Tau、P-U 与 Q-U 曲线 4 点、Q 点对应 PF）；频率下垂（过频/欠频各起点、百分比、Pn）；低压穿越 FRTEnable；PELoss；VolDrop；Pref 模式；AcOutBat（仅 TOR_ERZEUGER 生效，:6075）与 PowerBatAc（parse_fixed(...,100)，:6082）；末尾 "Preference" 设过频优先模式（:6091）。

4.8 无线电表数据解析（parse_meter_data，:6108）

json_get_value(buf, "grid meter" | "pv meter", str) 取出一条 CSV 字符串，再用一条 35 字段的 sscanf 格式串（:6143）解析：

%d,            // 链路状态
%16[^,],%19[^,],%8[^,],%8[^,]   // 型号、SN、硬件版本、软件版本
%u,%u,%u,%u     // 刷新周期、总正向电能、总反向电能、Q(L)、Q(C)
%u,%u           // 总有功、总无功
%hu,%hu,%hu     // 三相电压
%hd,%hd,%hd     // 三相电流
%d,%d,%d        // 三相有功
%d,%d,%d        // 三相无功
%hu             // 频率
%hd,%hd,%hd,%hd // 总/三相功率因数
%u,%u,%u,%u,%u,%u // 三相正/反向电能

解析后若该表配置了整体取反（u8_grid_meter_negate/u8_pv_meter_negate，:6185），用局部宏 NEGATE(x) (x = -(x)) 对三相电流、有功、无功、功率因数取反，并交换正反向电能（:6196-6199）。

链路在线（meter_link_sta == 1）时：SN 变化或首次发现 → Set_Setup_Config_Status(FALSE) + meter_set_saveConfigFlag() 触发上报；刷新软/硬件版本与型号字符串；置 u8_found = TRUE、清 u8_comm_lost_err、记录 u32_get_data_last_time = OSTimeGet()。离线则调 wireless_meter_handle_lost()。函数开头固定置 u8_wireless_meter_flag = 1 与 meter_set_meter_or_ct(meter, METER_SAMPLING)。

4.9 CAN 自定义帧与 CAN 日志采集（:7132、:7219、:7300）

自定义 CAN 帧下发（handle_server_can_send_command，:7132）：先 can_send_queue_clear()；解析 Parameter1（形如 ID:DATA:TYPE|ID:DATA:TYPE|...），用 strtok_r 按 | 切帧，每帧 sscanf("%[^:]:%[^:]:%s") 得 ID(HEX 字符串)、DATA(必须 16 个 HEX 字符 = 8 字节)、TYPE；数据逐 2 字符 strtoul 转字节后 can_send_queue_add(can_id, data, type)；全部解析完若队列非空则 can_send_queue_start()。相关接口声明在 midware/bms/bms.h:1240-1242。

CAN 日志采集（start_can_log_capture，:7219）：参数三重校验（1 ≤ id_count ≤ MAX_CAN_LOG_ID_COUNT、1 ≤ target_count ≤ MAX_CAN_LOG_COUNT）；首次调用按 SDRAM_CAN_LOG_BUF_ADDR 基址为每个 ID 划分 MAX_CAN_LOG_COUNT * sizeof(CAN_LOG_RAW_ITEM_T) 的缓冲区并存入 s_can_log_raw_buffers[]；若已有任务（active != 0）强制终止并清空全部缓存区；随后重置控制块（active=1、total_count 取云端条数、start_tick=OSTimeGet()、current_pack_seq=1、各 ID 计数清零）、拷贝 cmd_id（长度须 <32）。is_can_log_capturing() 供 net/ems.c:7016 等采集与上报流程查询状态。

4.10 与 uCOS-II 任务/信号量/时钟的配合

4.11 其他关键处理函数

• set_sys_rtc（:743）：Parameter1 为 Unix 秒、Parameter3 为时区偏移秒；LocalTime = secTime + TimeZoneSecond 后 localtime() 转换，年份做 tm_year - NOW_BASE_YEAR + TIME_BASE_YEAR 基准换算（RTC 芯片 2000 年基准差异），最后 Set_RTC()。
• handle_server_dispatch_command（:790）：Parameter1=使能，Parameter2 通过 parse_dispatch_para() 依次尝试解析 8/7/4 个功率点（任一成功即算收到），Parameter3=运行时长且下限强制 90 秒（:826-829）；三个参数任一到齐即 set_dispatch_parameter() 并唤醒 logic 任务。
• handle_special_icdcupdate_cmd（:1993）：MD5 输入顺序为 SN + 地址 + 端口1 (+端口2) + 加密1 (+加密2)，其中端口/加密在 u8_expand_icdcupdate_flag == TRUE 时按 | 切分为两路；MD5Final 后 sprintf("%02X") 逐字节转 32 字符大写 HEX 与云端下发的 Description 比对，一致才更新 IP_Address 的跳过端口/加密/地址并 net_init()。
• check_need_response_updt_devcie（:134）：固定顺序 INV1→INV2→INV3→BMS→Meter→EMS→EVC→AFCI，返回第一个命中项并立即清其响应标志，每次调用只取一个。
• handle_server_smart_dispatch_command（:1891）：b_recv_flag 初值 TRUE，Parameter1 或 Parameter2 任一缺失/解析不为 4 项则 &= FALSE，最终失败时会主动关闭智能化控制并落盘（:1945-1946）。

5. 对外接口

5.1 本文件导出（供外部调用）

头文件（server.h）中声明的 37 个函数 + 第 3 节标注"全局"但未在头文件声明的函数（见 server.h.md 第 3 节注）。主要消费者：

• net/ems.c：调用 load_current_update_data()、check_need_response_updt_devcie()、get_updt_dev_type_curr()、is_goto_get_update_file_status()、is_goto_update_check_status()、get_current_point_file_mask()/file_len/offset、get_updt_status_current()/set_updt_status_current()、get_system_sn()、get_ems_hard_type()、get_ems_hard_version()、get_local_md5_ems_upt_file()、system_hard_reset()、handle_tcp_recv_data()（由 midware/ethernt/ethernet.c:653/:899 直接调用）。
• midware/ethernt/ethernet.c：handle_tcp_recv_data(W5500)（:653）、handle_tcp_recv_data(WIRELESS)（:899），并提供 g_pUpdateSem（:996）。
• 各 *_download.c / 升级流程：通过 server.h 的访问器读取当前升级点信息，回写 save_fw_to_spi_flash 相关状态。

导出的全局变量：g_au8NetRecvPack、g_au8FWBuf、g_au8FWBin、g_u8_fw_sdram1、g_u8_fw_sdram2（extern 声明在 server.h:256-259）、g_u8_can_send_done_flag、s_can_log_ctrl、s_can_log_raw_buffers（后三者无 extern 声明，靠隐式外部链接跨文件引用）。

5.2 本文件调用的外部函数/变量（按模块）

6. 依赖关系

• 依赖（include）：time.h、board_init.h、socket.h、ethernet.h、ems.h、server.h、upd_download.h、ems_download.h、bms_download.h、inv_download.h、meter_download.h、data.h、json.h、md5.h、dry_node.h、key.h、bms.h、inverter.h、meter.h、logic.h、dispatch.h、pcf8563.h、flash.h、flash_data_store.h、lcd.h、sdram.h、usart3.h、crc.h、system_config.h、modbus.h、system_aux.h、fault_warn_log.h、simple_encryption.h、convert.h、evc.h、evc_ii.h、evc_download.h、evc_upgrade.h、ct.h、battery_comm.h、afci_download.h、afci_comm.h、inovance_comm_usart.h、sunspec_business.h、inttypes.h、math_tools.h（net/server.c:13-60）。它几乎横跨了 midware/、logic/、data/、hmi/、common/ 全部应用层目录。

• 被依赖：
  • midware/ethernt/ethernet.c：接收任务调用 handle_tcp_recv_data()（:653、:899）。
  • net/ems.c：升级流程调用本文件大量访问器（load_current_update_data、get_current_point_* 等），并使用 g_pUpdateSem（:4686、:4709）配合 handle_check_update/handle_fw_file_from_server 的信号量。
  • net/*_download.c（ems_download.c、bms_download.c、inv_download.c、meter_download.c、evc_download.c、afci_download.c、upd_download.c）：依赖 server.h 的 STUpdateTab 与 FILE_MASK_*、ENUpdateType，并在 Save_Data_To_FW_Area_InSdram/save_data_to_fw_area_inFlash 中消费 g_u8_fw_sdram1/2。
  • hmi/ 与 logic/ 通过 server.h 中的访问器读取升级状态（本文件不主动回调它们）。

7. 备注与风险点

1. store_system_set_data() 返回未初始化变量（net/server.c:3910-3915）：函数体只有 u8 res; 与 return res;，没有任何计算，返回值是栈垃圾。当前看 grep 未发现调用点，属死代码，但若被启用会直接产生不确定行为。
2. handle_server_sys_shutdown_command() 可能使用未初始化局部变量（:2239）：u8_temp、u16_temp_days 仅在 json_get_value 成功时赋值，随后无条件参与 :2264-2265 的比较与写入。若云端漏发 Parameter1 或 Parameter2，会写入随机值到 u8_sys_shutdown_flag/u16_sys_shutdown_days 并触发配置落盘——可能导致非预期停机配置。
3. handle_set_upload_interval() 同类问题（:2512）：l_u8_msg_id、l_u16_upload_interval 未初始化即传入 set_upload_interval()。
4. strstr() 返回值未判空即传给 sscanf（deal_get_config_data）：:4178（EmsLanguage）、:4296（"EV1"）、:4347（"EVC%d" 循环）、:4409/:4436（"TIMEChaDis%d"）、:4465（"TIMEfeedin%d"）、:4831/:4843（DryTime）、:4992（PeShValue）、:5103（InstallDate）、:5135（CsipAus）。云端配置报文中只要缺失其中任一字段，strstr 返回 NULL，sscanf(NULL, ...) 在多数 C 库下是直接访问 0 地址导致 HardFault。本函数又在 CMD_SET_CONFIG（APP 直连下发）路径上高频执行，属最高优先级风险。
5. handle_tcp_recv_data() 的 l_u32PackLen 可能未初始化（:6286 声明，仅在 type == W5500 或 type == WIRELESS 分支赋值）：若传入其它 type 值，:6403 的 (l_u32PackLen > 0) && (...) 判断读到栈垃圾，理论上可能进入 CRC 校验分支。当前调用点只传 W5500/WIRELESS，但缺少 default 保护。
6. handle_special_cmd() 的长度下溢（:2615）：json_check((char *)(buf + 7), len - 7 - 2) 中 len 为 u32，若报文长度 < 9（理论上被接收侧长度校验拦住），len - 9 会下溢成极大值。
7. CRC 校验失败无任何响应或计数（:7121-7127）：调试关闭时静默丢包，现场排查只能靠抓包。同样，所有 recv 超时、l_u32PackLen 越界都只 return，无重试、无错误计数。
8. check_server_fw_is_updating_for_dev() 的静态计数器 s_u8_upgrade_cnt 是全局共享的（:3224）：不区分设备类型。若 EMS 与 BMS 交替失败，计数会相互累加，可能在累计 5 次后清掉"本来还能成功"的设备的升级表。
9. check_server_fw_is_updating_for_dev() 失败分支故意不清 s_u8_upgrade_cnt（:3254-3256）只在未达上限时自增，达到上限才清零；结合上一条，属于设计如此但边界行为较隐蔽。
10. 掩码用 strstr 子串匹配而非位掩码运算（:3227、:3449、:3705、:3744）：见 server.h.md 风险点，"00001004" 会同时命中 INV1 与 METER，且判定顺序决定了实际归属，容易产生错误升级目标。
11. handle_fw_file_from_server() 的 test 变量赋值后未被使用（:3677 起多处 test = n; 后直接 return;），属遗留代码；同时 save_fw_to_sdram/save_fw_to_flash 对 Len > 1024 静默不写，而调用点已在上游限制 ≤1024，是"双重保护但无错误上报"。
12. get_current_point_file_mask() 返回 static 缓冲（:276-293）：static char fileMask[10] 在多任务环境（接收任务 + 升级任务）中非重入；同名现象出现在 get_current_point_version_force_updt()（:383）与 get_system_sn()（:416）。当前调用点都在接收任务上下文，暂未暴露竞态，但属于脆弱设计。
13. handle_server_set_bms_activate_time_command() 用 memcmp(..., 32) 比较 s_single_sn_splice（:2169）：该字段的实际可用长度取决于结构体定义，memcmp 按 32 字节比较会把结束符之后的填充字节一并纳入比较；时间字符串解析固定按 +8/+5/+0 偏移取子串（:2175-2180），隐含输入必须是 YYYY-MM-DD 且长度恰好 10，无长度校验。
14. CAN_LOG_CTRL_T、CAN_LOG_RAW_ITEM_T、MAX_CAN_LOG_ID_COUNT、MAX_CAN_LOG_COUNT、SPECIAL_CMD_CAN_SEND、SPECIAL_CMD_UPLOAD_CAN_LOG_STR 在本工程中找不到任何定义（已对全仓库含被忽略文件执行 grep -rn，仅 net/server.c:80、net/server.c:7266、net/ems.c 多处为使用）。SDRAM_CAN_LOG_BUF_ADDR 则定义在 hardware/sdram/sdram.h:68，注释标注长度仅 32KB，而分配算法要求 MAX_CAN_LOG_ID_COUNT * MAX_CAN_LOG_COUNT * sizeof(CAN_LOG_RAW_ITEM_T)（:7243）——若这两个常量按"12 个 ID × 若干条"的量级，极可能超出 32KB 而踩到相邻 SDRAM 段。这是本次分析发现的最严重的未决问题：要么该模块头文件未纳入本快照，要么代码处于不可编译状态，务必向代码维护者确认。
15. handle_server_can_send_command() 中 l_s8_param 拷贝长度（:7149）：memcpy(l_s8_param, g_au8FWBuf, sizeof(l_s8_param) - 1) 固定拷 255 字节，而源 g_au8FWBuf 为 2KB、目标 256 字节，长度本身安全，但若云端在 Parameter1 中不含 \0，strtok_r 之后的 printf("%s") 读到的是 l_s8_param 中已截断的内容，行为可预期；此处无害但依赖 sizeof 一致性，改动 l_s8_param 尺寸时需同步核查。
16. handle_server_power_factor_command() 的无功值处理不对称（:1706-1739）：flag=1/2 时只调用 inverter_set_fix_reactpower_value(0)，注释写的是"Set QU"/"Set cos phi(P)"，实际未按注释设置对应参数，疑似功能未完成。
17. handle_server_parameter_set() 中 l_u8_server_temp_switchover 缓冲仅 2 字节（:852）：用于接收 strtok 出来的切换位字符串，snprintf(...,2,"%s",...) 会截断为 1 字符 + 结束符，超过 1 位数字的输入被静默截断；l_u8_server_temp_switchover_tim[5] 同类（最长 4 字符，但校验允许到 250，恰好够用）。
18. deal_get_config_data() 的 for (i = 0; i < MAX_EVC_II_NUM; i++) 循环内 sprintf(l_u8_buf, "\"EVC%d\"", i+1)（:4344-4347）：l_u8_buf 只有 64 字节，索引最大 4，安全；但同函数 :4408/:4435 的 sprintf 到 64 字节缓冲写入 "TIMEChaDis28"（12 字符），也安全。整体无明显溢出，但全部依赖固定小索引范围。
19. deal_get_safety_config_data() 的 SN 校验方向与配置函数相反（:5225-5229）：SN 字段缺失时不返回（放行），仅"存在且不匹配"才丢弃，与 deal_get_config_data 的严格策略不一致，存在被构造报文绕过的空间。
20. handle_server_set_bms_activate_time_command() 在 i == 0 与 i > 0 两条分支里对同一逻辑重复实现（:2156-2193），且当 memcmp 命中但 Parameter2 缺失时直接 return，不置任何错误标志，云端无法感知失败。

（其余为调试打印、#if 0 屏蔽段（:3026、:3040-3050、:1475-1482、:1255）、被注释掉的 net_init()（:1103）等版本遗留代码，属清理项而非缺陷。）