set_comm_usart_s5.c

源文件路径：midware/inverter/set/set_comm_usart_s5.c 所属模块：midware/inverter/set（盛能杰 Senergy S5 / S5-II / M10 逆变器串口通信驱动） 代码行数：6282

1. 文件职责

本文件是 EMS 与盛能杰（Senergy，代码里统一缩写为 senergys5 / SET_TYPE）储能逆变器之间的 USART2 串口应用层协议实现。它把 Modbus RTU 帧的组帧、CRC 校验、收发时序、超时重试全部收敛到本文件，向上对 midware/inverter/inverter.c 的 task_inverter 任务暴露少数几个入口（senergys5_inverter_comm、senergy_model_recognition、senergy_comm_init 等）。

在数据流中它处于「EMS 逻辑层 ↔ 逆变器 DSP」的中间环节：一方面把从逆变器读到的实时运行数据（PV 电压电流、并网功率、电池电流、故障字、降载原因、安规参数、版本号）翻译成 g_t_inv_info 里的统一字段供 logic/hmi/net 使用；另一方面把 EMS 侧的控制意图（开关机、UPS 使能、电池加热、安规码、PV 连接类型、孤岛检测、GFCI、缓升缓降速率、并网法规曲线等）写成寄存器下发。

它由 task_inverter（midware/inverter/inverter.c:1090）在每个调度周期同步调用，不是中断驱动：函数内部自己发帧、自己轮询接收、阻塞式等待，因此整个任务的节奏由本文件决定。固件升级路径上，本文件让位给 set_upgrade_s5.c（senergys5_inverter_comm 里检测到升级标志即只跑升级处理）。

2. 关键数据结构与宏

本文件自身定义/主要使用的类型与宏如下（类型本体多在 set_comm_usart_s5.h 与 midware/inverter/inverter.h）。

本文件的全局对象（第 34~52 行）：

• u8 g_u8_senergys5_inv_recv_buf[256] — 唯一的接收缓冲，全文件共享。
• static SET_HEAT_TABLE_T s_t_heat_data — 电池加热参数变化检测缓存。
• SENERGYS5_COMM_INFO_T s_senergys5_task_tab — 头文件 extern，初始值把波特率自适应表设为 {S5系列,9600}、{M系列,57600}。
• SENERGYS5_INV_DEVICE_INFO_T s_senergys5_device_info_tab、SENERGYS5_INV_CONTROL_INFO_T s_senergys5_control_info_tab、SENERGYS5_ERROR_U s_u_senergys5_error_mapping_table、SENERGYS5_ERROR_U2 s_u_senergys5_error_mapping_table2、SENERGYS5_SYSTEM_SET_ENABLE_FLAG_U s_senergys5_set_info — 均 extern 导出。
• u8 u8_Safety_charge_flag = 1 — 澳规 CEC 默认参数只装载一次的闩锁标志。
• SENERGYS5_QUERY_INV_REGISTER_T senergys_query_inv_register — 服务器透传寄存器通道。

3. 函数清单

4. 核心逻辑解析

4.1 通信帧格式与 CRC

全部走 USART2 上的 Modbus RTU，从机地址固定 0x01，CRC 为 GetCrcCode_Modbus()（common/crc.c），低字节在前、高字节在后。

四种上行帧：

下行的期望应答（各查询函数统一按此解析）：

• 读应答：01 03 BYTECNT DATA... CRC，BYTECNT 必须等于请求寄存器数 ×2，否则丢弃。
• 写单/写多应答：回显 01 06/10 ADDR_H ADDR_L ...，函数用回显地址与请求地址比对。
• 异常应答：功能码 OR 0x80（0x83/0x86/0x90），第 3 字节为异常码，由 senergys5_inv_abnormal_respond_judge() 识别（set_comm_usart_s5.c:969）。

SENERGYS5_MAX_REGISTER_NUM(100) 是单帧寄存器数上限；senergys5_ems_send_set_multi_data_to_inv 里做了三重校验：register_num <= 100、len_buff <= 200、len_buff == register_num*2，任一不满足则 l_u8_len 保持 0，最终发出一条长度 0 的空帧——这是一个可疑点（见第 7 节）。

4.2 收帧与超时重试机制

有三种收帧原语：

1. senergys5_inv_recv_data()（第 93 行）——非阻塞。仅当 usart2_is_recv_async_data() 为真才读；把 usart2_get_data_len() 上限截到 256，逐字节从异步队列读出，取末两字节做 CRC 比对，不匹配则 *len = 0。没有重发逻辑：帧丢了就靠下一次调度周期重来。
2. senergys5_inv_recv_data_set_inv_satey()（第 150 行）——带超时阻塞。用 OSTimeGet() 差分做超时；未收到数据时 OSTimeDlyHMSM(0,0,0,50) 让出 CPU 50ms，直到 timeout 到点。仅用于写安规码（超时 8000ms，因为 DSP 换安规要重新初始化）。
3. senergys5_restart_eeprom_recv_mdsp()（第 230 行）——带超时阻塞 + 三态返回。超时返回 FALSE，收到帧返回 TRUE，CRC 错仍返回 TRUE 但 *len = 0，让调用方区分「没回」和「回了但坏包」。

发送侧有全局节流：senergys5_inv_write_data()（第 64 行）用函数内 static u32 s_u32_send_pack_tick，若距上次发送 <100ms（SENERGYS5_DAT_PCK_INTERVAL_INV），就 OSTimeDlyHMSM 补足差额。这保证了从机有足够解析和处理时间，但也意味着本任务在通讯繁忙时会被迫延时。

重试机制不在本文件，而在调度层：某个查询成功后清标志位、某个设置成功后清「待下发」位；失败则标志位保持，下一个任务周期重发。唯一的显式计数重试是 DSP 复位/清 EEPROM 路径的 s_l_u8_error_cnt（上限 10 或 3）。

4.3 启动与型号识别状态机

senergys5_inverter_comm()（第 6199 行）是总入口，由 task_inverter 每周期调用（midware/inverter/inverter.c:1090，且要求 get_passthrough_flag() == FALSE）。其顶层分支：

if (升级标志: inv_upgrade / dcdc_start_upgrade)
    → 清故障字、只跑 senergys5_inv_upgrade_handle()，按 master/slave/dcdc 设 run_mode
else
    ├─ 30s 无应答 → s8_dcdc_evocation_cnt++，达 5 次置 comm_lost_flag=TRUE、run_mode=cFaultMode
    ├─ ems_inv_comm_flag == FALSE  → senergys5_query_inv_product_model() + senergys5_control_flag_init()
    ├─ u8_reset_dsp_eeprom == TRUE → G1/G2 各自的清 EEPROM 处理
    └─ 正常：data_check_handle → query_inv_system_function_state
                              → set_inv_system_function_state
                              → query_inv_run_data

型号识别的两条路径在 inverter.c 里分流（midware/inverter/inverter.c:1088-1099）：子型号已是 SUB_S5/SUB_S5_II/SUB_M10 就走 senergys5_inverter_comm()，否则先走 senergy_model_recognition()（第 449 行）。

senergy_model_recognition() 逻辑：

1. 计数 s_u8_get_model_name_cnt，超过 20 次（MODEL_QUERY_TIMEOUT_CNT）判定 DSP 串口失联，置 u8_inverter_comm_lost_flag。
2. 调 senergys5_query_inv_product_model()；成功条件是「型号 == HYBRID_LOAD」或 senergy_comm_status_check()（用升级模块探测 0xA5/0x55 应答）为真。
3. 成功 → 复位计数、查 SN/型号名、senergy_comm_init() + senergy_comm_init_can() 建链。
4. 失败 → usart2_init(adaptive_polling_search[s_u8_query_flag].baudrate) 切换波特率，延时 30ms，s_u8_query_flag ^= 1 在 9600/57600 之间来回切换。

senergys5_query_inv_product_model()（第 3068 行）内部还有一层 5 次确认：只有连续 5 次读到 ON_GRID 或 HYBRID_LOAD，才置 u8_ems_inv_comm_flag = TRUE 并清失联标志，这是抗误判的防抖设计。

SN 解读时还会反向修正子型号（第 1913~1927 行）：型号名含 SMILE-M10 → set_inverter_sub(SUB_M10)，含 SMILE-M5 → SUB_S5_II，含 SMILE5-INV → SUB_S5，并调 Set_Setup_Config_Status(FALSE) 让上层重存配置。

4.4 查询调度时序

senergys5_query_inv_system_function_state()（第 5550 行）是「按标志位轮询」的调度器，每周期最多执行一个「一次只做一件事」的查询（因为每次查询都会真实收发一帧，耗时以十毫秒计）。它按顺序检查：SN/型号 → 版本信息 → 系统功能 1 → 系统功能 2 → 系统功能 3 → 开关机状态 → BACKUP 状态 → 电池加热组（加热使能/电压/电流/BMS 校准）→ 法规基本参数 → 法规曲线 → 安规自检。

senergys5_query_inv_run_data()（第 6108 行）是周期节拍器，用 SENERGYS5_TIME_100MS = 100 做单位：

每处都用 else if (tick > OSTimeGet()) tick = OSTimeGet(); 处理 OSTimeGet() 32 位溢出/回绕，把 tick 拉回当前值避免长时间不查询。这个写法在文件里反复出现（例如 6127、6148、6186 行），是全局统一的溢出保护约定。

u32_ems_inv_comm_tick 是通讯存活心跳：几乎每个成功的收发函数末尾都会 s_senergys5_task_tab.u32_ems_inv_comm_tick = OSTimeGet();，而 senergys5_inverter_comm() 在入口处检查它与当前时间的差值是否 >30s。也就是说，「30 秒内至少成功完成一次任意寄存器读写」即视为通讯正常。

4.5 设置调度与「设置 → 回读 → 完成」闭环

senergys5_set_inv_system_function_state()（第 5656 行）是设置侧调度器。设计模式是：每个设置函数在收到合法应答后清掉对应的 s_senergys5_set_info.bit.xxx_flag，并把相关查询标志位置回 TRUE 做回读确认；若该功能组 4 字节状态字全为 0，则把该项的查询标志再置 TRUE。

举例：安规设置（第 5681 行）成功后 u8_safety_change_flag = TRUE，若 s_senergys5_set_info.word.u8_system_function1_all == FALSE 就把 u8_query_inv_system_function_flag = TRUE 触发整组回读。

分组的 4 个字节（SENERGYS5_SYSTEM_SET_ENABLE_FLAG_U 的 word 视图）分别对应：并网法规基本参数、并网法规曲线参数、系统功能 1、系统功能 3 —— 相当于四把「这一组还有几项没写完」的总闸。只有当某组的整个字节为 0，才认为该组已全部下发完毕并触发回读。

G1/G2 分支在设置侧很密集，例如：

• 宽范围使能：G2 → senergys5_g2_set_inv_open_volt_fac()（写 0x2E03）；G1 → senergys5_set_inv_open_volt_fac()（内部指令 0x93）。
• N 线检测：G2 → senergys5_g2_set_inv_n_line_detect_enable()（写 0x2E01）；G1 → senergys5_set_inv_n_line_detect_enable()（ATE 0x12）。
• NPE 短接：G2 → senergy_g2_set_inv_npe_short_enable()（写 0x2157）；G1 → senergys5_set_inv_npe_short_enable()（ATE 0x13）。
• GFCI：G2 → senergys5_g2_set_inv_gfci_enable()（0x512D bit7）；G1 → senergys5_set_inv_gfci_enable()（0x5118）。
• DSP 重启/清 EEPROM：G2 走寄存器方式，G1 走 9 字节厂内专有帧。

u8_set_inv_grid_charge_enable_flag 是一个三态小状态机（第 5980 行 switch）：

这套「先放开、再清零、再按额定值重写」的序列是为了兼容 G1 与 G2 两代逆变器对 AC 功率上限寄存器的不同处理。

4.6 差异检测决策中心：senergys5_data_check_handle

第 5068 行的 senergys5_data_check_handle() 是本文件逻辑最密的部分，它把「配置值」与「从机回读值」逐项比对，把差异转成 s_senergys5_set_info 的置位：

1. 电池保护重算：s_u8_bat_model/s_u8_bat_num 变化或 u8_set_init_flag 为真 → 重跑 senergy_bat_protection_init() 并标记存 flash。
2. u16_reset_cnt 自增（上限 65500，防止溢出）。这个计数被 senergys5_get_error_waring_apping_table1/4 当作「开机 500 拍内屏蔽电池/母线告警」的时间窗。
3. 安规自检一次性初始化：u8_set_init_flag 为真 → senergy_rate_power_init() + senergy_safety_parameters_init()。
4. 能量统计：调 pv_total_pahse_pv_energy_statistics() 与 inv_total_pahse_inv_energy_statistics()；u8_clean_energy 为真则清零累计值。
5. 开关机：前提是未复位、开关机查询与设置标志均为 FALSE、未在清 EEPROM。先读 EPO 状态，与 s_u8_last_epo_state 比对，状态跳变才触发开关机（避免每拍重复下发）；再看 u8_start_stop == 1/2 与当前开关机状态是否矛盾。
6. 之后依次判：安规码、PV 连接类型、孤岛检查、宽范围/过度欠频曲线、NPE、NN、有功电压曲线使能、无功模式。
7. 澳规 CEC 默认值：u8_safety_change_flag 为真时，澳规置 actpower/reactpower_control_enable=TRUE、safty_mode=4、uvp_restore=2160 并重算速率功率；非澳规则全部清零。
8. 最后按 l_u8_save_flash_flag 决定是否 save_job_post(INVERTER_CONFIG_PAGE)。

4.7 能量统计算法

pv_total_pahse_pv_energy_statistics()（第 1710 行）与 inv_total_pahse_inv_energy_statistics()（第 1791 行）结构对称，后者只是功率源换成 s32_inv_actpower_t 且充放方向语义相反：

1. 若距上次采样 > 5000ms，认为采样中断，功率按 0 处理并更新 tick 后直接返回
2. 计算时间差 l_u32_time_differe：
   OSTimeGet() >= tick  → 差值
   否则（32 位回绕）    → (0xFFFFFFFF - tick) + OSTimeGet()
3. 累加 ms 级能量：accum += |P| * dt
4. 累计时间 s_u32Time_sum += dt
5. 当 s_u32Time_sum >= 60000ms（1 分钟）：
     量纲换算：accum / (s_u32Time_sum * 60)  → 得到 0.01kWh 单位
     余数保留回 accum（避免截断损失）
     累加到 u32_pv_total_phase_energy_input / u32_inv_total_phase_energy_output
     s_u32Time_sum 清零
6. 对外暴露给 g_t_inv_info.t_run_info.u32_energy_pv_input / u32_energy_inv_output（除 10 换算成 0.1kWh）

/ 60 这个除以 60 的常数来自量纲：P(W) * dt(ms) = mJ，mJ / (60000ms) = mW，再考虑 0.01kWh 单位需要 /3600…实际上这里是把 W·ms 直接换算成 0.01kWh 的经验系数，属于魔法数字（见第 7 节）。

4.8 故障码映射

逆变器故障字有 4 个 64 位字（SENERGYS5_ERROR_U）+ 1 个 16 位字（SENERGYS5_ERROR_U2），EMS 侧的 g_t_inv_info.t_run_info.u_fault_code / u_warning_code / u_fault_extend1_code 是另一套位定义，两者没有按位对齐，必须逐位搬：

• table1：word0/word1 → 输出直流过流、并网继电器、远程关机、过温、GFCI、PV 反接、系统类型错、风扇异常、母线欠压/过压、内部通讯错、软件不兼容、存储错、Boost/逆变异常。
• table2：word2 大部分 + word1 部分 → 市电丢失、频率/电压异常、PV 过压/欠压、绝缘、漏流、AFCI、功率限制、内部电源、10min 过压。
• table3：word3 中段 → EEPROM 读写失败、ISO 告警、输出功率受限、logger 丢失。
• table4：word3+word4 → 电池丢失/OVP/UVP/放电过流、N-L 反接、EPS 过压/短路/过载、内部通讯（EMS↔Master、Master↔DCDC）、DCDC 异常。
• table6：SENERGYS5_ERROR_U2.u8_nn_short_error → u8_n_n_reverse_lost。

值得注意的是 table1/table4 里的软件屏蔽：bms_get_ready_enable() == TRUE 或 u16_reset_cnt < 500 时，直接把 u8_dc_link_uvp（母线欠压）、u8_bat_ovp/uvp/lost 清 0，防止上电瞬间 BMS 尚未就绪时的误报。

u8_ground_current_detect（G2 的 0x512D）特殊：(value >> 7) & 0x01 == 0 表示检测使能（第 2624 行），与 G1 的 0x5118 语义相反，写回时也必须按位取反（第 5470~5477 行用 &= ~(1<<7) / |= (1<<7) 操作）。

4.9 安规码双向映射

两代逆变器对安规的编号完全不同，因此本文件维护一对互逆映射：

• senergys5_get_safety_type_inv_to_server(u16 input)（第 1363 行）：逆变器寄存器值 → EMS 安规枚举。输入是 0x5101 读到的 u16_regulation_code，输出 g_t_inv_info.t_safty_info.u8_safety/u8_safesub。澳规系列（4777.2/.3、NZ、SA、Vector）需要结合 g_t_inv_info.t_config_data.u8_safety/u8_safesub 做二次细分（因为同一寄存器值可能对应多个子安规）。
• senergys5_get_safety_type_server_to_inv(u8 u8_safety, u8 u8_safesub)（第 1589 行）：EMS 安规枚举 → 逆变器寄存器值，是上一函数的逆向。

映射完成后有两个副作用：若与 t_config_data 不一致则同步并 save_job_post(INVERTER_CONFIG_PAGE)；若与函数内 static 缓存的上次值不同，则置位法规参数、法规曲线、系统功能 2/3 四个回读标志（第 1574~1580 行）。

4.10 开关机、EPO 与复位

• 开关机下发：senergys5_set_inv_on_off_state() 写 0x6001，成功返回 TRUE 并置位查询标志。
• EPO（急停）：senergys5_query_epo_state() 读 inverter_get_shutdown_sta()，INV_SHUTDOWN → TRUE。data_check_handle 只在 EPO 状态跳变时下发开关机。
• 用户开关机：g_t_inv_info.t_control_cmd.u8_start_stop == 1 要求关机、== 2 要求开机，与 u8_inv_on_off_state 矛盾时置位设置标志。
• DSP 复位：G1 用 senergys5_restart_dsp_handle()，报文是两条裸 9 字节帧 01 80 08 ...，期望应答固定 01 80 08 F1 C6 74，用 strcmp 逐字节比较（注意：g_u8_senergys5_inv_recv_buf 是二进制数据，用 strcmp 比较存在遇 0 截断风险，见第 7 节）。复位前必须先发关机并延时 500ms，注释里写明原因是「防止市电反冲母线电容导致逆变管炸」。
• 复位在 cCheckMode（检查/待机）下被拒绝，G1 直接 return 并计数（>150 次放弃），G2 在待机态才真正执行 0x2E06。

4.11 uCOS-II 协作方式

本文件不使用任何信号量、消息邮箱或互斥量，完全依赖两点：

1. 任务串行执行 —— 只有 task_inverter 调用这些函数，天然串行。
2. OSTimeDlyHMSM() 主动让出 CPU —— 出现在 senergys5_inv_write_data()（补足帧间隔）、senergys5_inv_recv_data_set_inv_satey()/senergys5_restart_eeprom_recv_mdsp()（收帧等待）、以及所有复位/清 EEPROM 路径的固定延时（500ms / 1000ms / 10000ms）。

时间基准统一为 OSTimeGet()（uCOS-II 系统 tick）。所有周期性判断都写成 (OSTimeGet() - tick) > 周期 并配 else if (tick > OSTimeGet()) tick = OSTimeGet(); 做溢出保护。

因为收帧原语是非阻塞的（除两处阻塞变体外），一次完整的「发帧 + 收帧」跨两个调度周期，这也是为什么所有设置函数都需要靠标志位在下一周期重试。

4.12 服务器透传寄存器通道

senergys5_query_inv_register_data()（第 6006 行）是给云端/上位机预留的任意寄存器读写通道（senergys_query_inv_register，定义在 midware/inverter/inverter.h:1930，由 net/server.c:1500 及附近代码写入，net/ems.c:802 读回）。

• u8_modbus_flag == 1：标准 Modbus 读，取 u8_send_data[0..5] 组帧 + 自算 CRC，收帧后校验 BYTECNT == register_num*2，回填 u8_rend_data[0..7]。
• u8_modbus_flag == 2：非标准 Modbus，只发 5 字节（不含寄存器数量），收帧后自行重算 CRC（第 6079 行）再比对，同样回填 8 字节。

两种路径都清 u8_start_en = 0 表示本次透传完成。该通道与常规轮询共用 g_u8_senergys5_inv_recv_buf 和 senergys5_inv_write_data() 节流，因此会和实时数据轮询互相抢用串口。

5. 对外接口

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

函数（头文件 set_comm_usart_s5.h:821-829 声明）：

全局变量（头文件 set_comm_usart_s5.h:814-819 声明为 extern）：

其它未在头文件导出的文件级全局：g_u8_senergys5_inv_recv_buf[256]、u8_Safety_charge_flag、senergys_query_inv_register（后者在 midware/inverter/inverter.h:1930 声明）。

注意：头文件 set_comm_usart_s5.h:824 声明了 void senergys5_data_init(void);，但全工程（含本文件）没有任何定义。这是一个悬空声明，从未被调用。

5.2 本文件依赖的外部函数/变量

6. 依赖关系

依赖（本文件 include，第 13~29 行）： inverter.h、bms.h、meter.h、logic.h、set_comm_usart_s5.h、set_upgrade_s5.h、server.h、inv_download.h、ems.h、data.h、system_config.h、crc.h、usart2.h、system_aux.h、set_comm_can.h、math.h、ate.h。

被依赖（谁会用到它）：

• midware/inverter/inverter.c —— 唯一的驱动方，也是 g_t_inv_info 各字段的主要消费方。
• midware/inverter/set/set_comm_can.c —— 读 s_senergys5_device_info_tab / s_senergys5_control_info_tab 做 CAN 侧一致性处理，并实现 senergy_comm_init_can()。
• midware/inverter/set/set_upgrade_s5.c —— 升级前调 senergys5_query_inv_update_versions_info() 校验版本。
• net/ems.c、net/server.c —— 通过 senergys_query_inv_register 透传读写逆变器寄存器。
• 头文件 set_comm_usart_s5.h 也被 set_comm_can.c 直接 include。

7. 备注与风险点

1. strcmp 比较二进制帧（第 4373、4383、4489、4500 行）：strcmp((char *)g_u8_senergys5_inv_recv_buf, (char *)l_u8_restart_recvbuf)。接收缓冲是二进制，且首字节 0x01 之后是一串 0x80 0x08 ...。strcmp 遇到 \0 会提前结束；本例中固定应答 01 80 08 F1 C6 74 不含 0x00，暂时可工作，但一旦应答里有 0 字节就会出错。应改用 memcmp 并带长度。
2. 长度 0 的空帧被发出：senergys5_ems_send_set_multi_data_to_inv（第 539 行）在参数校验失败时 l_u8_len 保持 0，随后仍调用 senergys5_inv_write_data(l_u8_tx_buf, 0)。虽然 usart2_send_data 传 0 长度大概率无副作用，但会白白占用 100ms 的帧间隔并刷新发送 tick。
3. l_u8_tx_buf 未完全初始化：同上函数中，若 func_code 既非 0x10 也非 0x06，l_u8_len 为 0，而 l_u8_tx_buf[4]/[5] 已写入但 [6..] 未初始化，配合上一条的空帧发送属于未定义内容路径（当前不会真的发送数据，风险低）。
4. u8_set_inv_grid_charge_enable_flag 是三态而非布尔，命名以 _flag 结尾但取值 0/1/2/3，容易被后续维护者当成布尔量误用。
5. senergy_bat_protection_init 的电流表是两套并行 switch（bms_read_num()==1 与 else 分支），同一电池型号在两套表里数值不同（如 SMILE_BAT_5P 为 650 vs 1020），且 ALPHA_SMILE_M_BAT_13_9P* 的注释写「最大放电电流 115A，待接入 M10 后 208A」——注释与数值不符（值为 2300 即 230A）。这是明显的版本遗留代码。
6. SENERGYS5_INV_RATED_POWER_5_5KW、_6KW、_10KW 定义了但未被使用；senergy_rate_power_init 里 SUB_S5_II 恒取 5kW，SUB_M10 澳规取 9999W 否则 10kW，5.5/6kW 档位形同虚设。
7. 能量统计的 / (s_u32Time_sum * 60) 系数缺乏说明（第 1759、1760、1764、1765、1840、1841、1845、1846 行）。s_u32Time_sum 已是毫秒累计，s_u32_input_temp 的单位是 W·ms，因此 W·ms / (ms * 60) 得到的是「平均功率 / 60」，量纲上等价于「1 分钟窗口内的 Wh 数」。但后续 += (s_u32_input / 10) 再 % 10 存留、对外又 /10 暴露，整条换算链与结构体注释声明的 0.01kWh 单位对不上（按 1 分钟 Wh 累加，累计值应对应 0.1Wh 而非 0.01kWh）。这段系数来自移植代码，没有任何注释解释 60、10 这两个常数的量纲来源，属于需要重新标定的魔法数字。此外若 s_u32Time_sum 恰为 0 会除零，虽然进入该分支意味着 s_u32Time_sum >= 60000 因而实际不触发，但缺少显式保护。
8. 两个能量统计函数各有一半是死代码：pv_total_pahse_pv_energy_statistics 累加了 s_u32_input 并写入 PV 总量，但 s_u32_output（PV 反向功率）的累加行被注释掉（第 1766 行）且永远只是 % 10 后丢弃；inv_total_pahse_inv_energy_statistics 恰好相反——s_u32_input（逆变侧反向）的累加行被注释掉（第 1842 行），只有 s_u32_output 生效。结果是 PV 函数只统计功率为正的方向、逆变函数只统计功率为正的方向，u32_inv_total_phase_energy_input 之类的反向电量永远为 0。这是有意简化还是遗漏无法从代码判断，但注释掉的代码应清理。
9. senergys5_query_inv_real_time_data1 的 PV 功率过滤阈值 50 与 7500 是硬编码魔法数字（第 3242~3258 行），低于 50W 归零、高于 7500W 归零。7500W 对 M10（额定 10kW、PV 可到 15kW）可能过严，会把正常的大功率 PV 归零。
10. senergys5_query_inv_regulation_curve 的 *10/23 与 *23/10 换算（第 2503、2504、2522、2523、3762~3772 行）是 P-V 曲线寄存器的定点换算系数，23 这个魔数无任何注释说明其来源（推测对应 230V 基准）。
11. 曲线写入的数次 (x /10 *23 >> 8) 存在运算顺序隐患：先除后乘再右移，中间结果可能溢出 16 位（u16_p_v_mode_v* 最大到 1130，/10*23 = 2599，不溢出；但语义上更应写成 (u32) 运算再截断）。
12. G2 分支中的 s_senergys5_task_tab.u8_query_inv_heat_mode_state_flag 查询被注释掉（第 2931 行），导致电池加热状态的查询只在设置路径（senergys5_set_inv_bat_heat_mode_enable 成功后）被触发一次，且 senergys5_query_inv_system_function_state 里每 1s 才真正执行一次 senergys5_query_inv_bat_heat_mode_state()，其余 2 个查询（电压/电流）与 BMS 校准查询每拍都发——三帧共用一个 1s 节拍但只有一帧受限时，会导致加热电压/电流查询频率远高于状态查询。
13. G1/G2 成对函数的命名前缀混用：同一个语义的两代实现，前缀在 senergys5_ / senergy_ / senergyg2_ / senergyG2_ 之间不一致 —— 例如 senergys5_set_inv_npe_short_enable(G1, 4231) 对 senergy_g2_set_inv_npe_short_enable(G2, 4276)；senergys5_restart_dsp_handle(G1, 4320) 对 senergyg2_restart_dsp_handle(G2, 4410)；senergys5_restart_dsp_eeprom_handle(G1, 4458) 对 senergyG2_restart_dsp_eeprom_handle(G2, 4521)。g2 与 G2 两种大小写同时存在，检索时极易漏项。
14. 调试代码用 printf 输出大量中间量，且 #if (SENERGYS5_INV_DEBUG == 1) 包裹（第 3268~3312 行整块）。其中第 3305 行的 if((get_inverter_sub() == SUB_S5_II) && (get_inverter_sub() != SUB_M10)) return; 是冗余条件：因为 SUB_S5_II 与 SUB_M10 是两个不同枚举值，该表达式等价于单纯的 get_inverter_sub() == SUB_S5_II，第二个子条件是恒真的废话。实际效果只是 S5_II 机型跳过打印后 3 行调试信息。
15. u16_inv_ac_max_active_power 是 u16 而 u32_nominal_ac_active_power 是 u32，在 senergys5_query_inv_versions_info 里直接比较（第 2087 行）；若从机上报的额定有功功率超过 65535W，比较必然失败。对 10kW 机型没问题，但类型不一致是隐患。
16. 无互斥保护：g_u8_senergys5_inv_recv_buf 是文件级共享缓冲，被常规轮询和服务器透传通道共用。若 net/server.c 在其它任务上下文改 senergys_query_inv_register（u8_read_flag/u8_start_en），与本任务的读取之间没有临界区保护，存在竞态。
17. senergys5_inv_write_data 里的 OSTimeDlyHMSM 会阻塞整个 task_inverter：当两帧间隔不足 100ms 时（例如查询与设置在同一周期先后发帧），任务会被强制延时，可能影响同任务内 CAN 侧或并机处理的时间响应。此外该函数的 abs(OSTimeGet() - s_u32_send_pack_tick) 在 tick 回绕时不正确（abs 作用于 32 位无符号相减的结果，回绕时的负差值会得到错误量级）。
18. SENERGYS5_NUM_EPS_ENABLE(0x01) 被当作通用「期望 1 个寄存器」常量复用于电池加热状态、加热电压、加热电流、BMS 校准四处长度校验（第 2924、2971、3010、3051 行）。当前这四处确实都只读 1 个寄存器，因此结果正确，但用错了语义（应各自用 SENERGYS5_NUM_BAT_HEATING_ENABLE 等），一旦将来某个寄存器数量改变就会静默失效。
19. senergys5_query_inv_system_function3 中把 u16 赋值给 u8 变量（第 2739 行 g_t_inv_info.t_run_info.u8_inv_bypass_enable = (u16)(...)），存在高位截断。
20. senergys5_set_inv_satey_code 的括号与換行极具误导性（第 4650~4654 行）：if( (A || B) && C && D ) 虽然括号配平，但后半个条件另起一行、缩进与整体不齐，容易误读为独立的第二个判断。
21. 一批调试宏在头文件中全部为 0，但 .c 里保留了 #if ((SENERGYS5_INV_DEBUG == 1) || (SENERGYS5_INV_SYSTEM_FUNCTION == 1)) 的双条件写法，说明历史上曾被临时置 1 调试过，属未清理的遗留开关。
22. senergys5_get_workmode_mapping 把 SHUTDOWN_MODE 映射为 cWaitMode（第 1042~1043 行），与 INITIAL_MODE 相同；而 30s 通讯丢失走的是 cFaultMode。停机态与初始态在 EMS 逻辑层不可区分，可能影响上层对逆变器状态的判断。