alphaess_comm_usart.c

源文件路径：midware/inverter/alphaess/alphaess_comm_usart.c 所属模块：midware/inverter/alphaess（AlphaESS 逆变器厂商协议：Modbus-RTU 串口通信实现） 代码行数：5724

1. 文件职责

本文件是 AlphaESS 系列储能逆变器与 EMS 主控之间唯一的串口（SCI/UART2，Modbus-RTU 从站）协议实现：把 EMS 侧能量调度与配置结果翻译成 DSP 的寄存器写入，把 DSP 的遥测/故障/告警/安规参数翻译成 g_t_inv_info 与 g_t_alphaess_comm_info 中的结构化字段。它由 midware/inverter/inverter.c:1116-1117 在逆变器任务中每轮调用两个入口：alphaess_inverter_comm_usart() 负责实际收发与状态机推进，alphaess_inverter_data_check() 负责扫描"上层配置 vs 已下发快照"的差异并置位下发标志，两者通过 g_t_alphaess_comm_info 里约 60 个 u8_ems_set_*_flag / u8_ems_get_*_flag 完成"探测—发送—确认"的解耦。同一物理串口（uart2）还被 midware/afci/ 的 AFCI 板通信与升级复用，因此本文件的 alphaess_write_data / alphaess_recv_data 也是 AFCI 模块的物理层；此外 midware/interface/modbus/ 的 SunSpec 从站直接读 g_t_alphaess_comm_info 对外暴露数据。

2. 关键数据结构与宏

3. 函数清单

4. 核心逻辑解析

4.1 物理帧格式（Modbus-RTU）

读请求（send_query_data_to_inv_alphaess，行 451-468）：固定 8 字节。

[0] 从站地址 0x03（硬编码）
[1] 功能码   0x03(读保持) 或 0x04(读输入)
[2..3] 起始寄存器地址 大端
[4..5] 寄存器个数     大端
[6] CRC 低字节
[7] CRC 高字节

写请求（ems_send_ctrl_data_to_inv_alphaess，行 477-510）：

多寄存器(0x10)：[0]=0x03, [1]=0x10, [2..3]=地址, [4..5]=寄存器数, [6]=字节数(2*reg_num),
                [7..7+len-1]=数据, [..]=CRC 低, CRC 高
单寄存器(0x06)：[0]=0x03, [1]=0x06, [2..3]=地址, [4..5]=数据(由 tx_buff 覆盖), CRC 低, CRC 高

注意 0x06 分支（行 498-502）先在第 4-5 字节写寄存器数（行 489-490），随后又用 memcpy(l_u8_tx_buf + 4, tx_buff, 2) 覆盖为数据值——这是 Modbus 0x06 的正确布局，但读代码时容易误判为写错。

私有帧（alphaess_set_bat_ac_out，行 4481-4525）：唯一不走标准 Modbus 写格式的路径。

[0..1] 固定帧头 0x51 0x35
[2..3] ctrlac    允许充放功率（s16，使能关时为 10000）
[4..5] ctrlpch   允许充电功率
[6..7] ctrlpdisch 允许放电功率
[8..11] batpch / batpdisch 电池最大充/放电功率
[12..13] CRC（`GetCrcCode_Modbus` 前 12 字节）

发完即返回（行 4522-4523），不等待应答，是 fire-and-forget。

CRC：全部使用 GetCrcCode_Modbus()（common/crc.c），发送时低字节先、高字节后（行 505-506、463-465）。

4.2 接收校验状态机（alphaess_recv_data，行 285-442）

这是全文件唯一的收帧逻辑，被所有查询/设置函数复用，s_u8_recv_buf 是共享缓冲。

时序：

1. usart2_is_recv_async_data() 判断是否有异步数据；无数据直接 *len = 0 返回（行 296、435-441）。
2. 轮询 usart2_get_data_len() 直到 ≥2 字节，每次 OSTimeDlyHMSM(0,0,0,10) 让出 10 ms；超过 500 tick（500 ms） 放弃并返回长度 0（行 298-307）。
3. 一次性把 l_u16_len 字节读到 buf（行 309-316）。
4. 按帧头分流做 CRC 校验，只有校验通过才 *len = l_u16_len，否则 *len = 0：

注意：本函数不做重试。重试语义分散在各调用方——大多数函数是"每轮调用一次，失败就下一轮再来"，只有少数长帧写函数用静态计数器限次。

4.3 主通信状态机（alphaess_inverter_comm_usart，行 5090-5469）

这是一个"优先级递降 + 门控"的状态机，每轮由逆变器任务调用一次。

阶段 A：设备信息未拿到时（行 5093-5100） u8_query_inv_device_info_flag == TRUE → 只执行 query_inv_device_info_alphaess()；若仍未成功则调用 alphaess_inv_check_sci_baud()（行 5098）。此阶段其余所有命令都不发，是对 DSP 通信参数未知时的必要保护。

alphaess_inv_check_sci_baud()（行 214-253）自限速：距上次探测 <10 s 直接返回；然后 115200 → 9600 → 115200 来回切换并 usart2_init + usart2_clear_buffer。

阶段 B：正常运行（行 5101-5426，else 分支）

按如下优先级依次尝试，每一轮只推进能成功的那些（每个函数内部自带"发一帧 + 收一帧"，所以一轮内实际可能发多帧）：

1. 开机首次参数设置（行 5104-5125）：u8_inv_parameter_init_flag == TRUE 时，且距 u32_query_inv_parameter_init_flag_tick > 3000 tick 才执行 system_start_first_setting()；成功则 query_inv_pe_loss_check_flag()、query_inv_pu_mode_active_response_3tau()、清标志并 ems_set_fault_bit(23, FALSE)；失败则 ems_set_fault_bit(23, TRUE) 并 return（本轮不再发任何其它命令）。距上次 <3000 tick 时也 return。
2. 电池信息下发（行 5127-5131）：u8_startingup_check_bat_flag == FALSE 且 pvcharger_read_bat_work_state() != FALSE 时调 send_bat_info_to_inv()。
3. 电池加热三件套（行 5133-5155）：加热指令、加热电压/电流、加热继电器状态，各自用 u8_bat_heat_*_data_flag == FALSE 作为"待发"标志，成功后置 TRUE。
4. 一批条件触发的单点命令（行 5157-5358），每个都用 if (TRUE == g_t_alphaess_comm_info.u8_ems_set_xxx_flag) 守护：启停、Bypass、ON/OFF、清电量、安规写、首次并网值、OVP/UVP、OFP/UFP、自保护阈值、复位 DSP、告警恢复、油机、Grid-Forming、SN、BB、MPPT、PV-Charger、并机、PE 丢失、功能使能、四档 GFCI、安规有功设置、静态无功支撑、3τ、电池 AC 输出、两倍充电、相序、运行模式、意大利防逆流、PV 容量、最大馈网比例。
5. 周期回读 1 s（行 5202-5216）：OSTimeGet() - u32_query_inv_running_data_tick > 1000 → query_inv_running_data_alphaess() + query_inv_running_data_alphaess_extand1()，成功路径下还会在 u8_afci_heart_flag == TRUE 时执行 set_afci_fac_mode(0)（行 5207-5210）；随后更新时间戳。注意：时间戳更新在 if 内，无论收发是否成功都会推进（不是因为失败才重试）。

行 5213-5216 还有一条 tick 回卷保护：若 u32_query_inv_running_data_tick > OSTimeGet()（时间回绕）则强制同步。

1. 周期回读 10 s（仅奥地利 TOR_ERZEUGER）（行 5415-5424）：(距上次 > 10000 tick && inverter_read_safety() == TOR_ERZEUGER) || u8_ems_get_inv_operation_mode_flag == TRUE → query_inv_operation_mode_alphaess()，带同样的 tick 回卷保护。
2. 常驻守护式回读（行 5360-5413）：u8_ems_get_function_enable_flag → 读功能使能；is_ready_to_query_inv_self_data() → 读安规参数；u8_ems_get_cei_self_checking_data_flag → 读 CEI 自检；u8_ems_get_safety_actpower_setting_flag → 读 43000；u8_ems_get_quiescent_volt_reactpower_support_flag → 读 44000；u8_ems_get_pu_3tau_flag_flag → 读 44034；u8_ems_get_phase_negation_flag → 读 40156；AFCI 使能/报错使能回读；u8_query_afci_device_info_flag → query_afci_software_version() + afci_log_init()。
3. AFCI 通信（行 5336-5340）：仅在"支持 AFCI 且逆变器固件、AFCI 固件都下载完成"时调用 alphaess_afci_comm_function()。

阶段 C：收尾（行 5428-5468）

• 配置落盘：s_u8_config_save_flag == TRUE → 清标志并 save_job_post(INVERTER_CONFIG_PAGE)（行 5428-5432）。
• 固件升级优先：is_inverter_firm_download_finished() 为真时刷新 u32_ems_inv_comm_tick 并调 alphaess_upgrade_handle()（行 5434-5442）；AFCI 升级同理（行 5444-5448）。升级完成后正常通信被跳过，避免与升级帧争抢 uart2。
• 通信丢失检测（行 5450-5463）：l_u32_ugrade_finish_tick 在"距升级完成 <120 s"时为 90000，否则 0；当 abs(u32_ems_inv_comm_tick - OSTimeGet()) > 30*1000 + l_u32_ugrade_finish_tick 时置 u8_inverter_comm_lost_flag = TRUE 并调用 alphaess_comm_init() 重新初始化。
• 升级状态上报 HMI：u8_upgrade_status != 0 → set_info_status(INV_UPGRADE_LOG)（行 5465-5468）。

4.4 变化检测器（alphaess_inverter_data_check，行 5530-5723）

本函数从不发帧，只比较"快照 vs 目标"，置位标志后立即结束；下一轮主状态机才真正发送。这是本文件最重要的设计约定。

关键逻辑：

4.5 数据解析与映射

query_inv_device_info_alphaess（行 1014-1225） —— 只在开机时执行一次（成功后清 u8_query_inv_device_info_flag）：

• 帧合法性：buf[0]==0x03 && buf[1]==0x04 && buf[2]==73*2（行 1026-1029）。
• 死循环保护：若 DSP 主/从版本字节 buf[135]/buf[136] 都为 0，说明从机还没起，保持标志为 TRUE 下轮再读（行 1034-1037）。
• 机型映射：(buf[3]<<8)|buf[4] 按 ALPHAESS_BW_G3_* 枚举 switch 成 SUB_S5…SUB_T15（行 1041-1114）。
• SN：memcpy(u8_inv_sn, &buf[7], 16)；若首位是空格、含 "11111111111111"、或（BW OEM 且与本机 SN 不同）则置 u8_ems_set_inv_sn_flag 要求重写 SN（行 1117-1124）。
• 安规：(buf[55]<<8)|buf[56] → parse_alphaess_inv_safety()（行 1127）。
• 额定功率：buf[57..58]（AC 充/放）、buf[59..60]（DC 放）、buf[73..74]（DC 充）；DC 充为 0 时用 DC 放补齐（行 1129-1136）。
• 版本号：DSP 主/从用同一个 buf[129..136] + buf[138] 拼成 "V%c%c%c%c%c%c%c%c%c"（行 1141-1149）——两处代码完全一样，实际未区分主从；硬件版本按板型取常量 VERSION_INV_HARD 或 buf[99..102]（行 1151-1158）。
• 协议版本：buf[139] 起为 Modbus 版本、buf[145] 起为 CAN 版本；strncmp(modbus_ver,"V1.00",5) > 0 时置 g_t_logic_info.u8_bat_adapt_inv_flag = TRUE，即"逆变器支持电池自适应"（行 1167-1177）。
• 变化落盘：额定功率/硬件版本/机型任一变化则回写 t_config_data 并置 s_u8_config_save_flag（行 1183-1197）。
• 首次成功时记录 u32_query_inv_parameter_init_flag_tick（行 1199-1203），后续 system_start_first_setting() 的 3000 tick 延时基准。
• 成功后置 u8_query_afci_device_info_flag = TRUE 并 Set_Setup_Config_Status(FALSE)（行 1205-1206）。

query_inv_running_data_alphaess（行 1234-1482） —— 1 s 周期的主遥测通道，长度校验 buf[2]==115*2：

• 大量 (buf[i]<<8)|buf[i+1]（u16）与 (buf[i]<<24)|…|buf[i+3]（u32/s32）大端解析，写入 t_alphaess_run_info。后半段改用 buf[n+32] 的常量折叠写法（行 1314-1356），n+32 与前半段的行号偏移不同，是维护陷阱。
• 故障/告警 4 字节的字节序是倒装的（行 1340-1343）：

u32_err1_all = (buf[161+32]<<24)|(buf[162+32]<<16)|(buf[159+32]<<8)|(buf[160+32])，即 DSP 按"高字在前"发送。

• 单位换算与转发（行 1358-1426）：PV 电压 /10（1 V）、PV 电流 /10（0.1 A）、功率 1:1；电网电流由"备电侧电流 − 逆变侧电流"导出（仅 u16_grid_freq > 4500 即 45 Hz 时才计算，否则置 0，行 1403-1414）；电池电压/电流 /10；机内温度 /10；母线电压 /10；功率因数用 PF_001_TO_01 宏换算。
• 最后调用 parse_inv_err_msg_alphaess() 与 parse_inv_warning_msg_alphaess()。

parse_inv_err_msg_alphaess（行 716-788） —— 纯位对位搬运，约 50 行赋值。两个特殊点：

• GFCI 屏蔽：u8_gfci_shield_flag == TRUE 时先清掉 u32_inv_fault1.bit.u8_gfci 再搬运（行 738-742），告警侧同理（行 824-828）。
• 电网丢失故障抑制：对 SUB_S5/S3_6/S6/S8/S10 机型直接清 u8_grid_loss_fault（行 778-782）；其它机型在三相电压同时 <15 或同时 >15 时也清（行 783-787）。这是用"电压一致性"过滤误报。
• 注意 u8_output_overload 被赋值两次（行 726 来自 u32_inv_fault1.bit.u8_over_load，行 773 又来自 u32_inv_warning1.bit.u8_over_load），后者覆盖前者。
• 行 814 有一行被注释掉的 u8_grid_loss_alarm 映射，说明电网告警已被有意废弃。

parse_inv_warning_msg_alphaess（行 797-875） —— 同样逐位搬运。开头（行 799-806）在 g_t_bat_info.t_config_data.u8_ready == TRUE（系统未接电池）时把 u8_bat_open/u8_bat_high/u8_bat_low 清 0，其中 u8_bat_low 被赋了两次（应是 u8_bat_under 之类的另一个位被写错，见第 7 节）。

query_inv_cei_self_checking_data_alphaess（行 2108-2291） —— 本文件唯一使用"表驱动"的解析：

for phase in 0..2:                       // 三相
    base = phase_base[phase]             // 3 / 27 / 51
    for i in cei_map[]:                  // 7 组保护项
        value = BE16(buf + base + value_offset)
        time  = BE16(buf + base + time_offset)
        res   = BE16(buf + base + res_offset)
        switch (type) 分别写入 t_phase_safty_info[phase] 与 u_cei_test_res[phase].bit
for phase in 0..2:                       // OVP10min 单独处理
    off = 147 + phase*6                  // L1:147, L2:153, L3:159
    time = BE16(buf+off+2) / 1000

三相共占 3×24 = 72 字节（3..74），OVP10min 段从 147 起，加 3×6 = 18 字节到 164，落在 165 字节响应（1+1+1+162+2）之内。

意大利自检判定：

• query_inv_running_data_alphaess 里的 u16_cei_ovtrv/uvtrv/oftrv/uftrv 四个返回值（行 1348-1351）供 alphaess_get_single_phase_self_test_data() 使用：四者全部非零时 u_test_res = 0（通过），否则 0xFFFF（行 926-936）。
• alphaess_get_self_test_data() 则以三相 u_cei_test_res[i].u16_all == 0x5555 为通过条件（行 948-957），并把三相机 t_phase_safty_info[i] 的阈值/时间逐项搬到 t_safty_tset_info[i]（行 959-1004）。

4.6 写操作的确认与重试策略

绝大多数写函数是同一模板：

组帧 → alphaess_write_data(...) → alphaess_recv_data(...) → 检查
    if (len > 0 && buf[0] == 0x03 && buf[1] == 0x10) { 清标志; 更新时间戳; return TRUE; }
    else { return FALSE; }   // 下轮由主状态机重发

有 6 个函数额外引入了"失败 N 次即放弃并当作成功"的静态计数器（ALPHAESS_SEND_ERROR_COUNT_MAX = 3）：

4.7 安规双向映射

回读方向（parse_alphaess_inv_safety，行 519-707）：DSP 的 ALPHAESS_* 码 → EMS 的 u8_safety + u8_safesub。三个国家需要二次判断以区分子标准：

• ALPHAESS_UNE_217002：若当前配置是 NTS_Type_A 或 UNE217002 则保持原样，否则回落 RD1699（行 573-589）。
• ALPHAESS_VDE_0126：配置为 VDE0126_GR 时保持，否则 VDE0126_50HZ（行 601-612）。
• 末尾（行 693-706）若解析结果与配置不一致，回写配置、置三个回读标志与 s_u8_config_save_flag，并 OSTimeDlyHMSM(0,0,1,0) 阻塞 1 s 后再置 u8_ems_get_self_data_flag——这是全文件仅有的几处主动 delay 之一。

下发方向（alphaess_inverter_safety_set，行 3490-3676）：反向映射，AS4777_2 需按 u8_safesub 分 A/B/C/NZ，其余一对一。若 EMS 侧安规码不在支持表内（default），则不发送，只把 u8_ems_set_inv_safety_arg_flag1 清掉并回写配置。写成功后一次性置位 u8_query_inv_device_info_flag、u8_inv_parameter_init_flag、u8_ems_get_function_enable_flag、u8_ems_get_safety_actpower_setting_flag、u8_ems_get_quiescent_volt_reactpower_support_flag 并刷新两个时间戳（行 3657-3665），即 改安规后强制全量重读。

4.8 定时/调度时序与 uCOS-II 配合

• 时间基准：OSTimeGet() 返回 uCOS-II tick；从 > 1000 表示 1 s 的用法看，OS_TICKS_PER_SEC 为 1000，即 tick = 1 ms。
• 主要时间常量：设备信息波特率探测 10 s（行 216）、参数初始化延时 3 s（行 5106）、运行数据回读 1 s（行 5202）、运行模式回读 10 s（行 5415）、通信丢失 30 s + 升级后宽限 90 s（行 5450-5459）、升级完成窗口 120 s（行 5450）、AFCI 告警自动清除 10 s（行 5491）、AFCI 升级后回读 50 s（行 5074）、接收等待 500 ms（行 301）。
• 没有使用信号量或消息邮箱：本文件与任务间的同步完全依赖 g_t_alphaess_comm_info 里的标志位。所有收发都在调用者（逆变器任务）上下文内同步完成，因此 alphaess_recv_data 里的 OSTimeDlyHMSM 会阻塞整个逆变器任务——最坏情况 500 ms。
• 两处主动 delay：parse_alphaess_inv_safety 末尾 1 s（行 705）、set_inv_start_stop 成功后 2 s（行 2551）、alphaess_recv_data 等待循环内每次 10 ms。这些 delay 会让同一任务内的其它逆变器处理（例如 inverter.c 里同轮调用的其它厂商分支）被推迟。
• tick 回卷保护：行 5213-5216 与 5421-5424 显式处理 u32_*_tick > OSTimeGet() 的情况，但 u32_ems_inv_comm_tick（行 5459）与 u32_query_inv_parameter_init_flag_tick（行 5106）等其它比较点没有同样的保护。

4.9 关键全局变量的读写与触发

4.10 AFCI 分支

AFCI（电弧故障检测）板与逆变器共用 uart2，因此其协议也由本文件承载物理层：

• alphaess_afci_comm_function（行 5045-5081）：依次处理使能下发、故障使能下发、自检（afci_self_check_condition() 四条件同时满足才 afci_self_check_handle()）、告警清除、u8_ems_set_inv_afci_log_flag 触发 afci_fault_log_data_handle()、升级后 50 s 回读软件版本。
• afci_self_check_condition（行 4996-5009）：u8_afci_self_check_flag && u8_quary_afci_enable && u8_afci_fault_enable && u8_config_data.u8_afci_enable && AFCI_RUN_MODE_ALLOW(u8_run_mode)。
• alphaess_afci_data_check（行 5478-5520）：监测 u32_inv_warning2.bit.u8_afci_wraning 跳变；持续 10 s 仍为 TRUE 则置 u8_afci_clear_warning_info_flag 自动清除（行 5484-5494）。配置使能与 DSP 回读使能不一致时置两个下发标志（行 5496-5506）。检测到 u32_inv_fault2.bit.u8_afci_fault 且已使能、且未处理过，则置 u8_ems_set_inv_afci_log_flag 记录日志（行 5509-5514）——注释明确说明"拉弧报错后逆变器停机且不会自清除，需售后上门重启"。

5. 对外接口

5.1 本文件导出的函数（非 static）

5.2 本文件导出的全局变量

5.3 本文件调用的外部函数与变量

6. 依赖关系

依赖（include 列表，行 13-32）

alphaess_comm_usart.h（自身）、alphaess_comm_can.h、alphaess_upgrade.h、inverter.h、bms.h、meter.h、usart2.h、data.h、logic.h、generator.h、system_config.h、wireless_driver.h、ems.h、inv_download.h、bms_download.h、crc.h、board_init.h、afci_comm.h、afci_download.h、afci_upgrade.h。

被依赖

• midware/inverter/inverter.c（主调用方，行 1116-1117、308、89）
• midware/inverter/alphaess/alphaess_upgrade.c（行 533、582 调 alphaess_comm_init）
• midware/afci/afci_comm.c、midware/afci/afci_upgrade.c（复用 uart2 物理层）
• alphaess_comm_usart.h 的消费者：alphaess_comm_can.c、midware/interface/modbus/*
• 所有读取 g_t_alphaess_comm_info 的模块（HMI、Modbus 从站、云端上报）

7. 备注与风险点

缓冲区越界风险（高）

1. alphaess_recv_data 中读应答分支（行 381-382）用 buf[buf[2]+4]、buf[buf[2]+3] 计算 CRC 位置，完全信任对方报文的字节数字段 buf[2]，既不检查 buf[2] 是否与请求的寄存器数一致，也不检查 l_u16_len 是否足够。s_u8_recv_buf 为 256 字节，若 DSP 或总线噪声导致 buf[2] 被读成较大值，会越界读。升级分支（行 322、327）同样在未验证 l_u16_len ≥ 8/6 的情况下直接读 buf[7]/buf[5]。
2. alphaess_set_bat_ac_out（行 4504-4520）在 l_u8_tx_buf[128] 中拼 14 字节，安全；但 ems_send_ctrl_data_to_inv_alphaess 的 l_u8_tx_buf[128] 在 len_buff == 200（ALPHAESS_MAX_REGISTER_NUM*2）时理论上会写入 7 + 200 = 207 > 128。当前无调用方传 >102 字节，但长度检查只校验 len_buff <= 100*2，未校验缓冲区本身尺寸，属于潜在溢出。
3. query_inv_cei_self_checking_data_alphaess 依赖响应长度校验 buf[2] == 81*2 = 162，之后最高访问 147 + 2*6 + 5 = 164，而有效数据区到 buf[164]（共 165 字节），刚好不越界——但这是隐性耦合，若 phase_base 或 off 公式调整会立即越界。

逻辑可疑/错误

1. 表达式优先级错误（行 2641、2647）：u16_rev_machine_rate = ((s_u8_recv_buf[3] << 8) | (s_u8_recv_buf[4]) * 6); — 按 C 优先级等价于 (buf[3] << 8) | (buf[4] * 6)，而非注释意图的 ((buf[3]<<8)|buf[4]) * 6。行 2687、2663 也有同类 (...)) * 6 但括号位置正确的写法，说明此处就是漏括号。
2. 重复赋值/错位赋值：
   • parse_inv_err_msg_alphaess 行 726 与 773 都把 u8_output_overload 写同一个位，前者被覆盖。
   • parse_inv_warning_msg_alphaess 行 804-805 连续两行都写 u8_bat_low，明显是把另一个位写错。
3. query_inv_operation_mode_alphaess 的长度校验用了别的宏（行 4627）：s_u8_recv_buf[2] == ALPHAESS_NUM_SET_PHASE_NEGATION * 2，应为 ALPHAESS_NUM_INV_MODE_CMD * 2。当前两者数值都为 2 才没出问题。
4. DSP 主/从版本号取的是同一段字节（行 1141-1149），u8_master_ver 与 u8_slave_ver 内容必然相同，从机版本实际未单独解析。
5. "失败 3 次即当成功"的语义（见 4.6 节）：query_inv_afci_fault_enable / query_inv_afci_enable 在计数超限时仍然执行 buf[3..4] 赋值（行 4878、4924），而 buf 此时可能仍是上一帧残留内容或是全零，会把错误值写进 g_t_inv_info.t_run_info。这是几条最容易产生静默错误数据的分支。
6. alphaess_get_single_phase_self_test_data 的判定方向值得复核（行 926-936）：四个 CEI 返回值全部非零才判"通过（0）"。同时又没有把它与 0x5555 的位图判定统一，且该函数无任何调用方，属死代码。
7. l_u8_error_num 计数器在部分函数里被 static 修饰在函数体内（行 2761、4246、4767、4813、4859、4905），每个函数一份实例，若某次成功后未清零就跨场景复用会串味。目前所有分支都在成功路径清零，尚可。
8. alphaess_afci_data_check 的状态机不对称（行 5515-5518）：else if ((fault == FALSE) && (u8_ems_set_inv_afci_log_flag == FALSE)) 才复位 l_u8_afci_temp_error_handle，而 u8_ems_set_inv_afci_log_flag 的清除在 afci_fault_log_data_handle() 内部（本文件外），若那条链路不执行，l_u8_afci_temp_error_handle 会永久保持 TRUE，后续拉弧故障不再记日志。

魔法数字与约定

1. 关键魔法数：升级功能码 0x41/0x42/0x43（行 318-348）、send_query_data_to_inv_alphaess 里硬编码的 0x03（行 456）、alphaess_overload_recovery 的 0x0d（行 4040）、alphaess_set_bat_ac_out 的帧头 0x51 0x35 与"禁止时写 10000"（行 4504、4493）、奥地利零电流电压 1840/115（行 2018-2022）、A 相电压阈值 15（行 783-784）、电网频率阈值 4500/4000（行 1403、5538）、u_cei_test_res == 0x5555（行 948-950）、曲线上报缩放 23/10 与 *10/23（行 3892-3899、4307-4320）、*6//6 的功率比例换算（行 2641、2768、2825）。
2. set_inv_start_stop 的映射（行 2530-2538）：s_u8_temp_work_mode 为 1 → 命令 1、为 2 → 命令 0。EMS 侧"2 = 运行、1 = 停机"与 DSP 侧"1 = 运行、0 = 停机"是反的，只靠这段 switch 桥接；s_u8_temp_work_mode 初值 0x02（行 37）意味着上电默认下发"运行"。误改这里的常量会直接导致逆变器反向动作。
3. u16_ems_change_para_state_time = (bHours << 8) | bMinutes（行 4672）——只记录"时:分"，跨天不可区分，且精度只到分钟。

其它

1. phase_base 未加 static（行 42），污染全局命名空间；cei_map/s_u8_recv_buf/s_u8_config_save_flag/s_u8_temp_work_mode 都加了 static，此处不一致。
2. 大量非 static 函数无头文件声明（见 5.1 节表格）。这在 C89/C90 下会导致"隐式声明"或直接被误当作外部符号；当前它们只在本文件内被调用，应改为 static 或补声明。
3. alphaess_get_single_phase_self_test_data（行 884）完全未被引用；ALPHAESS_ADDR_REG_QUERY_INV_RUNNING_DATA_PARALLEL、ALPHAESS_ADDR_REG_SET_INV_FIRST_ONGRID_TIME、ALPHAESS_ADDR_REG_CLEAR_INV_FAULT 也未被本文件使用，属历史遗留。
4. 三处主动阻塞：parse_alphaess_inv_safety 末尾 1 s（行 705）、set_inv_start_stop 成功后 2 s（行 2551）、alphaess_recv_data 等待循环（最长 500 ms）。这些 delay 发生在逆变器任务上下文，会推迟同任务内的其它工作；1 s 的 delay 在安规解析路径上尤其值得关注（每次安规回读不一致都会打满 1 s）。
5. alphaess_set_italian_anti_backflow 的调试打印被写死为 #if 1（行 3425、3432），无论 DEBUG_ALPHAESS_INV 如何配置都会向串口输出，属于遗留的临时调试代码。
6. 行 1376-1401 有一大段被注释掉的 "CAN 协议兼容" 赋值块，行 1259、1272-1273、1752-1753、1762-1763、2014、2334-2335、2370-2371、5553-5559 也有多处注释代码，说明该文件在 SCI 与 CAN 两套协议之间做过多次切换，阅读时需注意哪些是活跃路径。
7. 两处除法未做零保护：200/(((u16)(...))/100)（行 2667、2688）与 2000/u16_p_f_over_freq_derating_rate、2000/u16_p_f_under_freq_derating_rate（行 2829-2830、2878-2879）。若 DSP 回读的降载率为 0（未配置或回读失败但长度校验通过），在 Cortex-M4 上整型除零要么产生 UsageFault、要么返回 0 导致下发 l_u8_tx_buf[34..35] = 0，两种情况都不可接受。
8. 抗干扰能力：alphaess_recv_data 的 1 s 周期回读（行 5202）不论成败都推进时间戳，因此单次丢帧不会立即重试，而是等下一个 1 s 周期；query_inv_device_info_alphaess 反而是"不成功就一直重发并阻塞在波特率探测上"，两条路径的重试策略不一致。