ginlong_comm_usart.c

源文件路径：midware/inverter/ginlong/ginlong_comm_usart.c 所属模块：midware / inverter / ginlong（锦浪 Solis 逆变器 Modbus-RTU 串口通信 + 固件升级） 代码行数：5221

1. 文件职责

本文件是 EMS 与锦浪（Ginlong/Solis）储能逆变器之间 Modbus-RTU 串口主通道 的完整实现：对上提供 ginlong_inverter_comm() 这一"周期入口"，对下通过 usart2_* 驱动在物理串口上收发 Modbus 报文。

它在数据流中处于"EMS 应用层 ↔ 逆变器设备层"的唯一桥接位置。被 midware/inverter/inverter.c 的逆变器轮询任务驱动：inverter.c:82 上电调 ginlong_comm_init() 做通道初始化，inverter.c:1105/inverter.c:1106 在每轮 GINLONG_TYPE 分支里依次调用 ginlong_inverter_comm()（收发调度）与 ginlong_inverter_data_check()（数据一致性/防超额限幅），inverter.c:314 还会调 ginlong_get_self_test_data() 汇总意大利安规自检结果。

数据方向有两个：一是读，把逆变器输入/保持寄存器解析成 EMS 统一运行数据 g_t_inv_info.t_run_info、安规参数 g_t_inv_info.t_safty_info、型号 g_t_inv_info.t_config_data.u8_inv_model_sub；二是写，把 EMS 调度结果（AC 有功设定、电池保护参数、backup 使能、安规/工作模式/保护点）折算成寄存器值下发。

整个文件由"标志位驱动"：上层（HMI、服务器、并机、BMS、logic 调度）只往 g_t_ginlong_info.t_ginlong_comm_info 里的约 50 个 u8/u16 标志置位，本文件在 ginlong_inverter_comm() 中逐个消费标志、组帧、收发，实现了上下层异步解耦。另有一条独立的固件升级分支（ginlong_upgrade_dsp_handle() / ginlong_upgrade_arm_handle()）。

2. 关键数据结构与宏

2.1 本文件定义的全局对象

2.2 枚举（本文件大量作 switch/比较使用）

2.3 重要宏常量

完整寄存器宏清单（约 70 组 ADDR_*/NUM_*）见 ginlong_comm_usart.h:48-188，本文件只按名称引用，不重新定义。

2.4 本文件内的函数级 static 变量（隐性状态）

3. 函数清单

全部函数共 68 个（其中 static 4 个：ems_send_query_data_to_inv_ginlong、ems_send_ctrl_data_to_ginlong、exchange_safety、exchange_safetysub，另有前置声明 allow_grid_parameter_tuning 于 ginlong_comm_usart.c:37）。

4. 核心逻辑解析

4.1 Modbus-RTU 帧格式与组帧

读请求（0x03/0x04，8 字节） —— ems_send_query_data_to_inv_ginlong()（ginlong_comm_usart.c:273-290）：

[0]  从机地址 = GINLONG_SLAVE_ADDRESS (0x01)
[1]  功能码   = 0x03 或 0x04
[2]  起始地址高  [3] 起始地址低
[4]  寄存器数量高 [5] 寄存器数量低
[6]  CRC16 低字节  [7] CRC16 高字节   // 注释明确 "高位在后面"

CRC 由 GetCrcCode_Modbus()（common/crc.h:17）对前 6 字节计算，低字节在前（ginlong_comm_usart.c:285-287）。

写请求（0x06 单寄存器，8 字节 / 0x10 多寄存器，7+2N+2 字节） —— ems_send_ctrl_data_to_ginlong()（ginlong_comm_usart.c:299-332）：

公共头：[0]=从机地址 [1]=功能码 [2..3]=起始地址
0x06  : [4..5] = 数据（由 memcpy(l_u8_tx_buf+4, tx_buff, 2) 覆盖）  → l_u8_len = 6
0x10  : [4..5] = 寄存器数量 [6] = 字节数(2N) [7..7+2N-1] = 数据      → l_u8_len = 7 + 2N
尾部  : [l_u8_len] = CRC 低字节, [l_u8_len+1] = CRC 高字节

入参校验条件（:309）：register_num <= 100 且 len_buff <= 200 且 len_buff == register_num * 2 三者同时成立才组帧。

收帧与校验 —— ginlong_recv_data()（ginlong_comm_usart.c:201-263）：先确认 usart2_is_recv_async_data() 为真，然后循环等到 usart2_get_data_len() >= 2，超时基准 GINLONG_DAT_PCK_INTERVAL_INV(700 ms) 到点即返回长度 0；随后按帧长度逐字节 usart2_read_data_async() 读入 buf，用帧尾两字节做小端 CRC 拼接与 GetCrcCode_Modbus(buf, len-2) 比对：一致则 *len = l_u16_len，否则 *len = 0。

发送节流 —— ginlong_write_data()（ginlong_comm_usart.c:164-193）：用 static u32 s_u32_send_pack_tick 记录上次发送时刻，若 OSTimeGet() - tick < 700 则 OSTimeDlyHMSM(0,0,0, 700 - elapsed) 阻塞补齐，再 usart2_clear_buffer() → usart2_send_data()。这是整个通道的 1.43 帧/秒硬上限：每轮 ginlong_inverter_comm() 里凡是实际发帧的分支都会各占用一个 700 ms 槽位，因此 u8_ems_inv_comm_flag 建立后每轮只会真正执行 1~2 个请求，其余标志留到下一轮。

响应判定约定：本文件不使用 Modbus 异常码语义，而是每个请求函数自行做"四要素"校验（除写函数外普遍一致）：

(GINLONG_SLAVE_ADDRESS == buf[0]) && (期望功能码 == buf[1]) && (期望字节数 == buf[2]) && (recv_num > 0)

写函数（0x06/0x10）则用 (ADDR_xxx == (buf[2] << 8 | buf[3])) 校验寄存器回显地址。所有成功分支都会做 u32_ems_inv_comm_tick = OSTimeGet()（通信心跳），部分还会清掉对应的 u8_set_*_flag / u8_query_*_flag。

超时与重试：没有显式重试计数，重试由"请求标志未被清掉 + 主循环每轮重新进入该分支"自然形成。少数函数自加退避：set_inv_isolation_limit_value() 连续失败 >10 次后接受逆变器现值并放弃（:4079-4086）；ginlong_query_italy_self_inspection_enable() 未就绪 >3 次后放弃并停掉后续查询（:3769-3774）。

4.2 主状态机：ginlong_inverter_comm() 三段式分支（ginlong_comm_usart.c:4861-5220）

if (is_inverter_firm_download_finished())          // ① 固件下载完成
      → 刷新心跳 / ginlong_data_init() / 清失联标记
      → 按 ginlong_read_upgrade_flag_master()/slave() 置 cUpdateMaster / cUpdateSlave
      → ginlong_upgrade_dsp_handle();  u8_ems_inv_comm_flag = FALSE
else if (Get_Status_Is_Updated_From_Server(UPDT_INV3))   // ② 服务器下发 ARM 升级
      → 刷新心跳 / ginlong_data_init() / 清失联标记 / 置 cUpdateArm
      → u8_ems_inv_comm_flag = FALSE;  ginlong_upgrade_arm_handle()
else                                                 // ③ 正常运行
      ├─ 失联判定：|u32_ems_inv_comm_tick - OSTimeGet()| > 30000 ms
      │     → u8_run_mode = cWaitMode; u8_ems_inv_comm_flag = FALSE;
      │       u8_inverter_comm_lost_flag = TRUE; ginlong_data_init()
      ├─ tick 追平（大数回绕/时钟复位）：tick > OSTimeGet() 时直接改写为当前值
      ├─ u8_ems_inv_comm_flag == FALSE（未建立通信）
      │     → query_inv_product_model(); ginlong_data_init();    // 只做型号识别
      └─ u8_ems_inv_comm_flag == TRUE（正常数据交换）
            → 先按标志位分派 30+ 个"请求型"函数（每个都可能占用 700 ms）
            → 再按 5 个时基 tick 做周期轮询

通信建立状态机（隐含在 query_inv_product_model() + 主循环之间）： u8_ems_inv_comm_flag = FALSE（ginlong_comm_init() 置） → 每轮只调 query_inv_product_model() → 解析出合法子码后 s_u8_querry_tick++；累计 >5 次（:1213）且子码与 g_t_inv_info.t_config_data.u8_inv_model_sub/硬件版本不一致时，调 set_inverter_sub() + memcpy 版本号 + save_job_post(INVERTER_CONFIG_PAGE) 落盘，然后 u8_inverter_comm_lost_flag = FALSE; u8_ems_inv_comm_flag = TRUE; Set_Setup_Config_Status(FALSE)（:1262-1265）；若子码一致则直接置 u8_ems_inv_comm_flag = TRUE（:1267-1273）。

4.3 子状态机：set_inv_grid_parameter_tuning()（:1679-1819）

三步递进，用 static u8 s_u8_status（SAFETY_RESPONSE_MODE）推进，每步都靠"写 43050 成功"作为迁移条件：

若 allow_grid_parameter_tuning() 为假（非 T10 或安规不在白名单），直接清 u8_change_grid_parameter_tuning_flag（:1812-1815）。此状态机与主循环的门控条件 u8_query_safety_config_flag == FALSE && u8_change_grid_parameter_tuning_flag != FALSE（:4986-4990）耦合——必须先读完 43050-43109 才允许改。

4.4 关键算法与计算公式

(1) 型号识别（query_inv_product_model，:1156-1202）： l_u16_sub_temp = (buf[3] << 8) | buf[4]（33000）→ 与 8 个子码宏比对映射为 SUB_* 枚举；主/从 DSP 版本由 buf[5]&0x0F、buf[6]、buf[7]&0x0F、buf[8] 格式化：snprintf(..., "V%X.%02X", buf[5] & 0x0F, buf[6])；SN 为 memcpy(u8_inv_sn, &buf[11], 15)。

(2) 功率因数与相电流（query_inv_rundata_1，:1412-1428）：

s8_run_pf_value = (s32_inv_actpower_t * 10000) / s32_inv_apparentpower_t / 100     // 限幅 [-100, 100] → -1.00~1.00
s16_grid_cur_x  = (s32_inv_actpower_x * 100) / grid_volt_x                          // 分相功率/电压 → 电流

注意 s32_inv_apparentpower_t 作为被除数，若为 0 会除零。

(3) 安规换算（:1435-1445）：exchange_safety(sub, GINLONG_SAFETY, 33092 原始值) → u8_safety；若结果为 AS4777_2 再调 exchange_safetysub() 取子安规，否则 SAFESUB_DEFAULT。反向写回（set_safety，:4304-4309）用 STANDARD_SAFETY / STANDARD_SAFETYSUB 方向。

(4) PU/QU 曲线精度换算（对称的一对公式）：

(5) 电池功率→电流折算与限幅（ems_send_bms_protect_paramter_to_inv，:2377-2472）：

l_s16_dc_set_current = parallel_read_dc_total_set_bat_power() * 10 / u16_bat_volt
if (current >  u16_dischg_max_rate_cur) current =  u16_dischg_max_rate_cur;
if (current < -u16_chg_max_rate_cur)    current = -u16_chg_max_rate_cur;
若 u8_ems_inv_comm_flag == FALSE → current = 0（通信未建立不下发）
方向字：current > 0 → [8..9] = 0x0001（放电），current < 0 → [8..9] = 0x0000（充电），取绝对值入 [10..11]
零电流特判：若 current == 0 且「充电满功率=0 且 放电满功率≠0 且 距上次非零设定 < 60 s」→ 保底放电流 3（`:2460-2465`）

(6) 防超额限幅（ginlong_inverter_data_check，:4571-4698）：四路参数取"电池能力与逆变器能力中的较小/较保守者"：

放电截止电压 = max(电池放电截止电压, config.u16_dischg_cut_rate_volt)（T10 强制 2000，其余强制 440）
充电截止电压 = min(电池充电截止电压, config.u16_chg_cut_rate_volt)（T10 强制 2880，其余强制 550；S5/B5 直接取 config）
放电最大电流 = min(电池放电电流, config.u16_dischg_max_rate_cur)
充电最大电流 = min(pvcharger_read_bat_max_charge_current(), config.u16_chg_max_rate_cur)
若 SOC <= logic_read_ups_reserve_soc()*10 且 cNormalMode → 放电最大电流归零

结果只在四值与 t_run_info 现值不一致时才写入。

(7) 失联/心跳：u32_ems_inv_comm_tick 是唯一心跳源，由每一个成功解析的响应刷新；>30 s 未刷新即判定失联（:4890）。同时多处做 if (tick > OSTimeGet()) tick = OSTimeGet(); 的"倒挂修正"（:4898、:5174、:5184 等），说明设计上预期 OSTimeGet() 可能回绕。

4.5 定时/调度时序

ginlong_write_data() 的 700 ms 节流是唯一的物理时间约束，主循环里所有轮询周期的真实分辨率都以它为颗粒（单位 ms）：

另有阻塞式延时：ginlong_write_data 的发送节流 OSTimeDlyHMSM(0,0,0,n)、query_inv_product_model() 入口 OSTimeDlyHMSM(0,0,1,500)（1.5 s，:1132）、ginlong_restart() 的 500 ms（:1112）、set_safety() 成功后的 5 s（:4327）。这些都在逆变器轮询任务上下文里同步阻塞，会拖慢同任务内其他调度。

任务/同步机制：本文件不使用信号量或消息邮箱，全部同步都基于 uCOS-II 的全局节拍 OSTimeGet() + OSTimeDlyHMSM() 轮询；跨任务通信完全靠共享全局变量（标志位 + 数据缓存）。因此没有任何互斥保护。

4.6 关键全局变量的读写关系

4.7 典型业务流程：下发一个 AC 有功设定

1. 上层置 u8_change_grid_parameter_tuning_flag（或 ginlong_data_init() 因 allow_grid_parameter_tuning() 为真而置，:139-144）。
2. 主循环先执行 query_safety_regulations_info() 把 u8_query_safety_config_flag 清掉（:1878）。
3. 下一轮进入 set_inv_grid_parameter_tuning()，读 t_safty_info.s32_... 各值 → 越界保护（无功 >6000 归 0、有功 >11000 归 0、功率因数绝对值不在 [800,1000] 归 1000，:1734-1747）→ 组 5 寄存器 0x10 帧发 43050。
4. 校验回显地址 ADDR_SET_WORK_MODE 后推进状态机并刷新心跳。
5. ginlong_inverter_data_check() 发现 t_safty_info.u16_inv_ac_power_setting != 10000 且开了三相不平衡且机型为 T10 时，直接调 set_inv_ac_actpower(10000) 并把 u8_query_safety_config_flag 重新置 TRUE（:4783-4787），形成"设置后必须回读校验"的闭环。

5. 对外接口

5.1 本文件导出、供外部调用的函数（头文件正式声明 4 个：ginlong_comm_usart.h:930-933）

5.2 本文件导出但未在头文件声明的 64 个全局函数

ginlong_data_init、ginlong_write_data、ginlong_recv_data、deal_system_mode、deal_inv_fault、inv_on_off_command、ginlong_restart、query_inv_product_model、set_inv_rtc_time、query_inv_rundata_1、query_inv_rundata_2、query_safety_test_data、query_safety_regulations_info、query_ems_send_bms_protect_paramter_to_inv、query_safety_regulations_info_2、query_inv_freq_load_shed_mode、query_inv_mppt_switch、query_low_voltage_cross、query_inv_pu_mode_active_response_3tau、ems_send_bms_protect_paramter_to_inv、set_inv_three_unbalance_mode、set_inv_igfollow、set_inv_freq_load_shed_mode、set_inv_power_change_slpoe_limit、set_inv_fault_recover_protect_value、set_inv_reconnect_time、set_inv_safety_config_data、set_inv_pu_v3_value、set_inv_pu_v4_value、set_inv_qu_v1_value、set_inv_qu_v2_value、set_inv_qu_v3_value、set_inv_qu_v4_value、set_inv_freq_derating_protect_value、set_inv_freq_derating_protect_rate_value、set_inv_pu_3tau_value、send_inv_mppt_start_stop_switch、ginlong_set_bit0_scan_enalbe、ginlong_set_ovp_value、ginlong_set_ofp_value、ginlong_set_inv_ovp10min_value、ginlong_set_inv_zero_current_voltage、ginlong_query_inv_zero_current_voltage、set_low_voltage_cross_mode、set_low_voltage_cross_mode_2、set_inv_italy_self_inspection、ginlong_query_italy_self_inspection_enable、query_italy_self_inspection_results、query_italy_self_inspection_value1、query_italy_self_inspection_value2、set_inv_isolation_limit_value、set_inv_ac_actpower、clean_energy_statistics、clean_overload_flag、set_safety、deal_bat_upgrade、set_inv_backup_bat_enable、ginlong_query_inv_on_off_status。

（实测工程内对上述函数的跨文件调用只有 ginlong_comm_usart.c 自身；grep -rn 未在 ginlong_comm_usart.c 之外找到调用点，因此这批函数实质是"外部可见但仅内部使用"的死接口，详见第 7 节。）

5.3 本文件导出的全局变量

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

6. 依赖关系

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

ginlong_comm_usart.h        本通道的类型、宏、extern g_t_ginlong_info
ginlong_upgrade.h           DSP / ARM 固件升级流程与升级标志查询
inverter.h                  g_t_inv_info、机型枚举 SUB_*、运行模式枚举 c*Mode、逆变器读写访问器
bms.h                       bms_get_ready_enable（判定能否进 cNormalMode）
meter.h                     电表（include 链）
usart2.h                    物理串口收发（实测头文件在 hardware/usart2/usart2.h）
crc.h                       GetCrcCode_Modbus（Modbus CRC16）
data.h / system_config.h    g_t_config_data、SYSTEM_DATETIME、save_job_post 掉电保存
logic.h                     logic_read_ups_reserve_soc / logic_read_dc_set_power
inv_download.h / bms_download.h / ems.h / system_aux.h   升级与系统辅助

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

7. 备注与风险点

7.1 缓冲区越界风险（高）

1. ginlong_recv_data() 无长度上界校验（ginlong_comm_usart.c:214-232）。l_u16_len = usart2_get_data_len() 最大可达 USART2_BUFFER_LEN(512)（hardware/usart2/usart2.h:6），而目标缓冲 g_u8_inv_recv_buf 只有 256 字节，循环 *(buf + l_u16_index) = data 没有任何 if (index >= sizeof(buf)) break。若逆变器返回超长帧或串口粘包/噪声导致长度异常，会越过全局缓冲越界写，破坏相邻全局变量。
2. ems_send_ctrl_data_to_ginlong() 的发送缓冲上界不足（:301、:309）。栈上缓冲为 u8 l_u8_tx_buf[128]，但校验只要求 len_buff <= GINLONG_MAX_REGISTER_NUM * 2(=200)，此时 memcpy(l_u8_tx_buf + 7, tx_buff, len_buff) 会写到下标 206，越界 79 字节。当前调用点最大 NUM_INV_SAFETY_MODE_SET1=21（42 字节）尚在 128 内，但接口本身不设防。GINLONG_MAX_REGISTER_NUM(100) 与缓冲(128) 之间存在明显不一致。

7.2 组帧缺陷

1. 入参校验失败时仍会发帧（:309-331）。若 register_num/len_buff 不满足条件，if 块整体跳过，l_u8_len 保持 0，函数仍执行 ginlong_write_data(l_u8_tx_buf, 0, ...) —— 发出一帧"长度 0"的垃圾数据（内容为未初始化的栈缓冲）。应改为直接 return。
2. 函数名拼写与语义不符：ems_send_bms_protect_paramter_to_inv（paramter 拼写错误，:2369）、ginlong_set_bit0_scan_enalbe（enalbe，:3338）、set_inv_power_change_slpoe_limit（slpoe，:2727）、query_inv_pu_mode_active_response_3tau vs ADDR_INV_PU_MODE_ACTIVE_RESPONSE_3TAU 命名不一致。宏名 u16_ongrid_fault 单复数混用。
3. ginlong_set_ofp_value() 拷贝粘贴错误（:3469-3480）：43098–43105 的 8 个寄存器本应分别写 ofp1/ufp1 的保护点与时间共 4 组，但代码把 u16_ofp1_value/u16_ofp1_time 写了两遍（[0..3] 与 [4..7]），u16_ofp2_value/u16_ofp2_time 完全没用上，随后 [8..15] 又写 ufp1。从 ginlong_set_ovp_value()（:3412-3427，ovp1/ovp2/uvp1/uvp2 四组各一）的对称结构看，这里应为 ofp1/ofp2/ufp1/ufp2，属实际功能缺陷（二级过频点无法设置）。

7.3 数据解析缺陷

1. query_italy_self_inspection_value1() / value2() 的字节偏移错位（:3859、:3926）：u16_ufp1_value = (buf[23] << 8) | buf[23] —— 高字节与低字节用了同一个下标 23，应为 buf[23] 与 buf[24]。同类写法在 query_italy_self_inspection_value1（:3859）与 value2 的 L2（:3926）各出现一次，而 L3 段（:3944）却是正确的 buf[63]/buf[64]，说明是拷贝后漏改。
2. u16_pu_mode_*_time 系列的运算优先级错误（:1902、:1904、:1907 等）：(u16)((buf[89] << 8) | buf[90] *10) —— *10 只作用于 buf[90]，而 :1900、:1901 却是 ((buf[85] << 8) | buf[86]) * 10。同一批寄存器里两种写法混用，时间值会差 10 倍或产生错值。
3. query_safety_regulations_info() 中 u16_ovp10min_time 被整行注释掉（:1920、:1951、:2005），但 ginlong_set_inv_ovp10min_value()（:3513）仍在比较 t_safty_info.u16_ovp10min_time == t_ginlong_safety_info.u16_ovp10min_time 决定是否下发 —— 该字段从未被赋值（恒为初值），导致下发判断失去意义。
4. .h 中 s16_qu_mode_lag_reactpower_value 被声明为 u16（ginlong_comm_usart.h:750），而代码按有符号负数使用（set_inv_safety_config_data 写入 -4360）。类型与语义不符，依赖隐式截断。
5. inv_on_off_command() 的 u8 l_u8_tx_buf[3] 只填 2 字节（:1062、:1075-1076），实际只用前 2 个，属冗余但无害。
6. set_inv_grid_parameter_tuning() 寄存器数量与注释矛盾：写 ADDR_SET_WORK_MODE(43050) 共 NUM_SET_WORK_MODE(5) 个寄存器，但注释写 "解析数据 43117"（:1771），是从电池保护参数处拷贝来的残留注释。

7.4 并发与实时性

1. 全程无互斥。所有状态都放在全局变量里由逆变器轮询任务单线程读写，但 g_t_ginlong_info.* 被 HMI/服务器/并机任务直接读写。u16 及以上的标志（如 u16_query_mppt_start_stop_flag、u16_set_mppt_start_stop_flag）在多任务环境下存在读改写竞态。
2. 同步阻塞拖慢轮询：ginlong_write_data() 内的 OSTimeDlyHMSM（最多 700 ms/帧）、ginlong_restart() 的 500 ms、set_safety() 的 5 s、query_inv_product_model() 的 1.5 s，全部在逆变器轮询任务里同步阻塞。set_safety() 一次阻塞 5 s，期间同任务的其他调度（含 900 ms 的电池保护参数下发）全部停摆。
3. query_inv_product_model() 的 s_u8_querry_tick 只增不清零的边界：若型号一直不匹配，s_u8_querry_tick 会持续累加（u8 上限 255），但两个出口分支都会 s_u8_querry_tick = 0，实际不会溢出；不过"型号不匹配但子码非 0"时会在 :1267 直接进入 u8_ems_inv_comm_flag = TRUE，跳过配置落盘，可能让 u8_inv_model_sub 保持旧值。

7.5 死代码与遗留

1. 超长注释代码块：ems_send_three_ac_actpower_to_inv() 整函数被注释（:4158-4224，约 67 行）；ginlong_inverter_data_check() 中弱电网 98% 充电限制逻辑（:4590-4598）、S5 低 SOC 保护（:4666-4686）与其配套的 u8_backup_set 修正（:4770-4774）也被注释，但 s_u8_soc_low_backup_disable_flag 变量声明保留（:4563）。
2. 主循环里的空转分支：:5168-5173 的 u32_query_safety_regulation_data_tick 5 分钟分支只是重置 tick 和标志，并不调用任何查询函数（真正的安规查询由 u8_query_safety_config_flag 驱动），属遗留的无效调度。
3. ginlong_query_inv_zero_current_voltage() 在主循环被注释（:5112-5115），导致 set_inv_zero_current_mode_flag 置位后置出的 u8_query_zero_current_mode_flag（:3577）永远无人消费。但 ginlong_set_inv_zero_current_voltage() 本身仍在循环里（:4981-4984），所以"设置"通、"回读校验"不通。
4. deal_bat_upgrade() 重复调用 ginlong_recv_data()（:4413）：函数末尾又执行一次接收（用于读取 inv_on_off_command() 的响应），但该响应已在 :4352 被读过，第二次读到的内容不确定；且 l_u16_inv_recv_num 被复用，语义混乱。
5. 头文件声明不完整：ginlong_comm_usart.h 只声明 4 个函数（:930-933），其余 64 个全局函数靠隐式声明或调用方自行 extern。本文件内 ems_send_query_data_to_inv_ginlong 等 4 个 static 函数有正确的 static 声明，但 allow_grid_parameter_tuning 还需在 :37 手工前置声明（因为 ginlong_data_init() 在前、定义在后）。
6. 大量魔法数字：200/2880（T10 截止电压）、440/550（其他机型）、8000/500（零电流电压）、0x5A/0xA5（FRT 开关）、0xAA/0x55（清过载）、0xBE/0xDE（开关机）、2300/4999（backup 电压/频率）、4360/-4360/-950/-900（TOR 安规无功/功率因数）、阈值 6000/11000/800/1000、15（力充电 SOC 门限）等均无宏或注释说明来源。
7. s_u8_safety_change 初值 5（:4567）：用 5 而非合法安规码作为"未初始化"哨兵值，与 inverter_read_safety() 首次比较时必然不等，会在第一次进入 u8_ems_inv_comm_flag 分支时无条件置 u8_set_bit0_scan_enalbe = TRUE（:4816-4820）——属有意为之的"首次强制同步"，但用魔数表达，可读性差。
8. s32_inv_apparentpower_t 作除数无零保护（:1412），逆变器视在功率为 0 时（如待机）会产生除零异常（Cortex-M4 上整数除零默认返回 0 或触发 UsageFault，取决于编译器运行时）。