inverter.c

源文件路径：midware/inverter/inverter.c 所属模块：midware/inverter（逆变器统一抽象层 / 厂商驱动力门面） 代码行数：8097

1. 文件职责

本文件是整个 EMS 固件里逆变器（PCS）的统一抽象层与驱动门面。它自身不实现任何厂商的物理层帧格式（那些在 midware/inverter/<vendor>/ 下），而是持有全局设备表 g_t_inv_info（INVERTER_TABLE_T，实例定义于 inverter.c:39），把下面七块内容按厂商分支统一暴露给上层：

1. 配置数据 g_t_inv_info.t_config_data（持久化到 Flash）；
2. 运行数据 g_t_inv_info.t_run_info；
3. 安规参数总表 g_t_inv_info.t_safty_info；
4. 安规自检过程/结果 g_t_inv_info.t_safty_tset_info[3]；
5. 控制命令 g_t_inv_info.t_control_cmd、控制参数 g_t_inv_info.t_control_parameter；
6. 升级/调试 g_t_inv_info.t_debug_log、AFCI g_t_inv_info.t_afci_info。

对下，它按 get_inverter_type()（inverter.c:1340）的返回值把轮询分发到六家厂商驱动：kelong（科华）、set（盛能杰）、ginlong（锦浪）、alphaess（沃太/贝瓦/贴牌）、goodwe（固德威）、inovance（汇川），分发点在 inverter.c:1074-1136；对上，它向 logic/（调度算法）、hmi/（LCD/按键/LED）、net/（云端/Modbus）、data/（断电续传/故障录波）提供 inverter_read_* / inverter_set_* / inverter_get_* 系列 API。

它还承载机型相关的策略常量表：AC/DC 调节周期、细调幅值、电池电压上下限、PV 启动电压、并网过载系数、调节速率档位、控制精度、通信丢失降级等，全部以「按 type/sub 分支 return 常量」的硬编码形式写在本文件内（如 get_inv_calculation_interval() inverter.c:2310、get_inv_regulator_speed() inverter.c:2635、inverter_read_grid_overload_factor() inverter.c:3664、get_inv_max_bat_volt() inverter.c:2772）。

数据流位置：厂商驱动的 *_inverter_comm() 填充 g_t_inv_info.t_run_info → logic/ 计算目标功率并写回 t_safty_info / t_control_* → 厂商驱动的组帧函数把参数下发到逆变器；本文件既负责轮询与降级，也负责把上层下发的参数落到 t_safty_info 并置位厂商「待下发」脏标志（见 §4.8）。

本文件同时提供三个 uCOS-II 任务的入口：task_inverter（USART/SCI 侧，inverter.c:1045）、task_inverter_can（CAN 侧 + 并机，inverter.c:1199）、task_parallel_sci（并机 SCI，inverter.c:1296），三者均在 user/main.c:189 / 244 / 299 用 OSTaskCreateExt 静态创建。

规模统计：本文件共 313 个函数定义（其中 14 个 static，299 个全局可见），1014 处分条件编译指令（#if/#ifdef/#else/#elif/#endif）。文件自身的全局变量只有 1 个（g_t_inv_info），另有 2 个 extern 引用（inverter.c:40-41）。

2. 关键数据结构与宏

2.1 本文件定义/引用的全局对象

2.2 本文件大量写入/读取的外部全局结构（按厂商分桶）

本文件的「置脏标志」模式依赖以下厂商通信上下文，均为跨模块全局变量（定义在各厂商模块或 data/）：

2.3 本文件消费的关键宏 / 枚举

2.4 文件作用域内的 static 局部变量

本文件没有文件静态变量，但有 30 余个函数内 static，它们承担跨轮次的记忆功能（均在 for(;;) 大循环中每轮被访问）：

3. 函数清单

全部 313 个函数定义（覆盖本文件 100%，无抽样）。作用域列中「static」即文件内私有，「全局」即经 inverter.h 导出。「定义行」为 inverter.c 中的函数头行号。

3.1 初始化、内部处理与任务（20 个）

3.2 机型识别、机型名与显示类型（17 个）

3.3 机型策略常量（27 个）

3.4 运行数据读取（27 个）

3.5 故障 / 告警 / 电量 / 额定 / 版本 / 升级读取（34 个）

3.6 控制命令与一次性动作（14 个）

3.7 模式、安规码与开关类设置（18 个）

3.8 常用标量参数（PF / 无功 / 斜率 / N-N / GFCI）（9 个）

3.9 过欠压 / 过欠频保护定值与恢复值（33 个）

3.10 P-V / Q-V / S-PF / P-PF / P-F 曲线与降载（60 个）

3.11 保护使能、门限与穿越（40 个）

3.12 尾部杂项与查询（14 个）

4. 核心逻辑解析

4.1 三个 uCOS-II 任务与时序

task_inverter 的每轮处理顺序（inverter.c:1052-1189）：

1. 等 PEND_LOGIC_CALCULATE_DONE（20ms 超时，允许空转）；
2. 若 u8_init_flag 为真则清标志并调 inverter_state_init() —— 即厂商驱动初始化是在任务首轮或 set_inverter_init() 之后才执行；
3. （非 OEM_HHE）用故障位 16 上报「机型未识别 / 与编译期机型不一致」：条件为 get_inverter_type() == INVERTER_NULL || INVERTER_TYPE == INVERTER_NULL || (get_inverter_type() != INVERTER_TYPE && INVERTER_TYPE != INVERTER_MAX)（inverter.c:1071）。注意此判断把「编译期机型为 NULL」直接判为异常；
4. 六家厂商分发轮询（详见 §4.2），盛能杰/锦浪/沃太还受 get_passthrough_flag()（透传测试时跳过）与 u8_ate_mode_flag（ATE 模式跳过）门控；
5. 依次执行 13 个内部处理：inverter_lost_handle → italian_self_test_handle → overload_recovery_handle → ground_fault_handle → mpptscan_handle → power_limit_handle → backupbox_detection_handle → sys_shutdown_handle → sys_anti_theft_handle → grid_detection → inverter_pvcharger_info_handle（PV Charger 模块）→ overload_detection_handle → sys_safety_special_deal_handle → inverter_generator_mode_handle；
6. 若本轮等到事件标志，则置 POST_INV_CALCULATE_DONE 并唤醒 CAN 任务，最后延时 80ms。

task_inverter_can 的每轮处理顺序（inverter.c:1205-1286）：等 PEND_INV_CALCULATE_DONE → 各厂商 CAN 侧收发（沃太额外处理 u8_ate_reset_dsp_flag 调 ems_ate_reset_dsp()）→ inverter_lost_handle_can() → parallel_can_comm_handle() → parallel_data_handle() → calculate_gc_chgpower()（油机充电功率）→ 延时 30ms。

4.2 机型识别与「编译期 + 运行期」双重开关

本文件所有厂商分支都是两段式：

#if ((INVERTER_TYPE == INVERTER_MAX) || (INVERTER_TYPE == GINLONG_TYPE))
    if (get_inverter_type() == GINLONG_TYPE) { /* 锦浪 */ }
#endif

外层的 #if 决定该厂商代码是否参与编译（由 inverter.h:172 的 INVERTER_TYPE 决定，INVERTER_MAX(7) 表示全编译），内层 if 决定运行时是否走该分支。运行期机型来自 g_t_inv_info.t_config_data.u8_inv_model（Flash 持久化，可被云端/Modbus/按键改写），因此同一份固件可在多机型间切换（在 INVERTER_TYPE == INVERTER_MAX 时）。

inverter_read_system_modle()（inverter.c:1386-1647）与 inverter_read_inv_type()（inverter.c:1656-1767）是两套并行的字符串查表：前者是「系统/贴牌对外名」（含 ZOE_OEM_*、SUNPOWER_OEM_*、PEIMAR_OEM_*、DIGIEN_OEM_*、BYTE_WATT_OEM_*），后者是「厂商内生机型名」。两者都先看客户自定义覆盖（g_system_custom_info.u8_inv_flag），最后兜底 TYPE_ALPHA_ESS。

4.3 通信丢失降级

• SCI 侧（inverter_lost_handle inverter.c:115-190）：把 u8_inverter_comm_lost_flag 同步到故障位 3；用函数内 static s_u8_pcs_lost_flag 做边沿检测，只在 0→1 跳变的那一轮执行清零动作：PV1~4 电压/电流/功率、电网三相电压/电流/有功/总功率/频率、逆变侧三相有功/总功率/频率、备电三相电压/电流/有功/总功率/频率、电池电压/电流/功率、机温、母线电压、运行 PF 全部置 0，u8_run_mode 置 cFaultMode。丢失期间不做周期性清零（避免打断厂商写值）。
• CAN 侧（inverter_lost_handle_can inverter.c:199-221）：丢失时置故障位 10，并每轮清 C 相电网电压/有功、总功率、电网频率、逆变总功率、逆变频率、电池功率，u8_run_mode 置 cFaultMode；恢复时清故障位 10 并直接 return（不清零，等厂商驱动回填）。

4.4 意大利 CEI021 安规自检（italian_self_test_handle + get_self_test_data）

italian_self_test_handle()（inverter.c:326-469）的触发条件是 t_safty_info.u8_safety == CEI021。

• 锦浪 T10 分支（inverter.c:335-360）：用两层 static 标志 s_u8_safty_test_flag、s_u8_safty_test_flag2 + 计数器 s_u8_cnt：
  1. 当 g_t_ginlong_info.t_ginlong_rundata.u8_inv_system_status == 3（并网运行）且第一个标志为假时，置 u8_set_italy_complete_inspection_enable = TRUE 并锁定第一个标志；
  2. 当 u8_cei_test_full_enable_value != 2（自检未完成）且第二个标志仍为假时，s_u8_cnt++，连续 3 轮（约 240ms）满足后置第二个标志，并同时置「送服务器」「送 APP」两个上报标志。
• 其它机型分支（inverter.c:361-391）：inverter_read_run_mode() == cNormalMode 时 s_u8_cnt++，沃太额外置 u8_ems_get_self_data_flag 和 u8_ems_get_cei_self_checking_data_flag 请求取数据；计数 >3 时锁定标志、清计数、置「送服务器」标志（沃太另置「送 APP」标志）。
• get_self_test_data()（inverter.c:234-317）由上述流程每一轮都调用：把 OVP(2645/200ms)、OVP10(2530/3)、UVP(1955/1500ms)、UVP2(345/200ms)、OFP(5020/100ms)、OFP2(5150/100ms)、UFP(4980/100ms)、UFP2(4750/100ms) 的标准值与时间写进 t_safty_tset_info[0]，再给 [0..2] 三相写入固定的「实际值/实际时间」（OVP 2644/199、OVP10 2529/3、UVP 1956/1490、UVP2 347/198、OFP 5019/99、OFP2 5149/95、UFP 4982/100、UFP2 4751/100），最后把 [0].u_test_res.u16_all 清 0，并按机型转发 senergys5/alphaess/ginlong_get_self_test_data()。
• inverter.c:394-468 是一整段被注释掉的旧版自检状态机（三态 NOT_SELF_INSPECTION / IN_SELF_INSPECTION / SELF_INSPECTION_COMPLETE，依赖 BMS 就绪与 SOC），保留但不再生效。

4.5 澳洲防逆流软/硬限功率状态机（power_limit_handle）

inverter.c:629-746。前置条件：inverter_read_grid_freq() > 4500（>45Hz）且（软限或硬限使能）。

• 输入：l_s32_feedin_power = -meter_read_actpower(GRID_METER, PHASE_T)（负号把「买电为正」翻成「馈网为正」）；上限阈值 logic_read_max_feedin_power()+100，下限阈值 logic_read_max_feedin_power()-100，且下限不低于 60。
• 迟滞 + 去抖：l_s32_feedin_power > high 且距上次 tick 超过 4000ms → 置 s_u8_feedin_overrun_flag；超限后 l_s32_feedin_power <= low 且持续 5000ms → 解除超限标志。
• 软限功率（u8_inv_software_limit_enable）：超限或电网表通信中断时，距 s_u32_software_limit_tick 超过 8000ms 则置 t_control_parameter.u8_set_inv_softstart = TRUE（请求厂商驱动做软启动/降功率），否则清 FALSE。
• 硬限功率（u8_inv_hardware_limit_enable）：超限或电网表中断时，把 t_run_info.u8_inv_softstop_flag 置 TRUE（软停机），并做边沿保护避免重复置位。
• 条件不满足时统一清 u8_set_inv_softstart、u8_inv_softstop_flag 并刷新两个 tick。

4.6 一键停机 / 按天租赁与启停控制（sys_shutdown_handle）

inverter.c:791-882，两个相互独立的子逻辑：

（1）断网时长累计（u8_sys_shutdown_flag == SYS_SHUTDOWN_STOP_DAYS 时）：g_stEMSInfo.bIsLogin == FALSE（断网）时启动 s_u32_logout_sys_shutdown_time 计时；每满 1 小时 u16_sys_logout_hours++ 并 save_job_post(INVERTER_CONFIG_PAGE)；累计达到 u16_sys_shutdown_days * 24 时钳位到上限并 set_info_status(LEASE_STATUS)。重新上线或非按天租赁时清 s_u8_logout_flag。首次进入断网时若「已累计小时/24 < 停机天数」则先把累计值清零（视为新的租赁周期）。

（2）逆变器启停判定：l_u8_inv_on_off_flag 由 7 个条件的「或」组成——g_t_logic_info.u8_drm_mode == 0（DRM 允许关断）、并机主机 u8_drm_mode == 0、英国 G100 STATE4_LOCK、u8_inv_softstop_flag（软限功率触发）、u8_sys_shutdown_flag == SYS_SHUTDOWN_START、按天租赁累计超期、t_afci_info.u8_afci_self_result_shut_down（AFCI 自检要求停机）。

• 需要停机且当前已开机（u8_start_stop == 2）：沃太 + 一键停机非 0 时改走 inverter_set_bypass_flag(TRUE)（旁路而非直接关机），其余调 inverter_power_off()。
• 允许开机且（u8_start_stop == 1 或处于旁路）：先 inverter_set_bypass_flag(FALSE) 再 inverter_power_on()。

4.7 其它周期性处理

4.8 安规参数下发「三件套」模式

除少数例外，本文件所有 inverter_set_*() 都遵循同一模板（以 inverter_set_grid_ovp1_value() inverter.c:4840-4866 为例）：

void inverter_set_grid_ovp1_value(u16 value)
{
    if (g_t_inv_info.t_safty_info.u8_tor_no_use_flag == TRUE) return;   // 可选：安规屏蔽门控
    g_t_inv_info.t_safty_info.u16_ovp1_value = value;                   // ① 落到安规总表

#if ((INVERTER_TYPE == INVERTER_MAX) || (INVERTER_TYPE == KELONG_TYPE))
    if (get_inverter_type() == KELONG_TYPE)
        g_t_kelong_comm_info.u8_ems_set_inv_grid_protect_arg_flag3 = TRUE;   // ② 置该厂商的「待下发」脏标志
#endif
#if ((INVERTER_TYPE == INVERTER_MAX) || (INVERTER_TYPE == GINLONG_TYPE))
    if (get_inverter_type() == GINLONG_TYPE)
        g_t_ginlong_info.t_ginlong_comm_info.u8_set_ovp_value_flag = TRUE;
#endif
#if ((INVERTER_TYPE == INVERTER_MAX) || (INVERTER_TYPE == ALPHAESS_TYPE))
    if (get_inverter_type() == ALPHAESS_TYPE)
        g_t_alphaess_comm_info.u8_ems_set_inv_safety_arg_flag4 = TRUE;
#endif
}

关键点：

1. 参数值本身不做单位换算、不做范围校验（唯一例外见下），调用者（logic/、hmi/、net/）负责保证量纲与合法性；
2. 脏标志由各厂商模块在自己的通信任务里清零并组帧下发，本文件不跟踪「已下发」；
3. 每家厂商的标志名各不相同（科华用 u8_ems_set_inv_*，锦浪用 t_ginlong_comm_info.u8_set_*，沃太用 u8_ems_set_*，汇川统一用 u64_sci_flag.bit.*，盛能杰用 s_senergys5_set_info.bit.*），新增厂商需逐函数补齐 5~6 个分支，极易漏项；
4. 少数带门的例外：u8_tor_no_use_flag == TRUE 时全部 OVP/UVP/OFP/UFP 定值与孤岛检测直接丢弃（inverter.c:4843、4870、4953、4979、5173、5199、5281、5307、5333、5359、5441、5467、5493、5519、6000、6155、7373）——该标志由 sys_safety_special_deal_handle() 对奥地利列名场景置位；
5. 少数带钳位的例外：盛能杰 P-V 点 1/2 电压钳位到 [800,1200]（inverter.c:5689、5728）；澳规下 Q-V 与 P-V 点 3/4 电压钳位到 [1020,1110]（inverter.c:5760、5826、5966、6019、6070、6121）；inverter_set_power_change_slope_limit() 丢弃 < 1000 的入参（inverter.c:4661）；
6. 少数带落盘的例外：inverter_write_safety（4342）、inverter_set_islanding_check_enable（4428）、inverter_set_n_n_short（4740）、handle_cloud_set_gfci（559）、sys_shutdown_handle（817/830）会 save_job_post(INVERTER_CONFIG_PAGE)；而 inverter_write_safesub（4365）不落盘。

4.9 P-V / Q-V 曲线点与沃太 3/4 点 ↔ 1/2 点映射

沃太在「单相机型」或「澳规（AS4777 系列）」下只暴露 2 个曲线点，需要把上层的第 3、4 点重映射到 t_safty_info 里的 s16_ov_p_v_mode_v1/v2；三相机型则在非澳规下使用 s16_ov_p_v_mode_v3/v4：

• 写侧 inverter_set_p_v_mode_v3()（inverter.c:5771-5784）：if (单相 || AS4777) → s16_ov_p_v_mode_v1 = 值; else → s16_ov_p_v_mode_v3 = 值;
• 写侧 inverter_set_p_v_mode_v4()（inverter.c:5838-5851）：同理映射到 s16_ov_p_v_mode_v2 / s16_ov_p_v_mode_v4。
• 读侧 inverter_read_p_v_mode_v3/v4()（inverter.c:7820、7848）做逆映射，保证「读回与写入一致」。
• 另一处特殊映射：inverter_set_p_pf_mode_p2()（inverter.c:6447-6453）在「沃太 + TOR_ERZEUGER」时把值写到 u16_p_pf_mode_p4，否则写 u16_p_pf_mode_p2。

4.10 全局变量读写清单（按访问目的）

5. 对外接口

5.1 本文件导出的接口

本文件共 313 个函数中 299 个为全局可见（14 个函数为 static，不导出）。全局函数按用途分为 11 类，均由 midware/inverter/inverter.h 声明：

5.2 本文件导出的全局变量

只有 1 个：INVERTER_TABLE_T g_t_inv_info（inverter.c:39）。它被全工程 40+ 个 .c 文件直接读写，涉及目录： data/fault_warn_log、data/system_config、data/resume_data/flash、logic、hmi、hmi/ui、net、midware/afci、midware/auxiliary、midware/bms、midware/bms/alpha、midware/debug、midware/interface、midware/interface/dry_node、midware/interface/modbus、midware/interface/drm、midware/meter、midware/ethernt/wireless、midware/inverter（本文件）、midware/inverter/{alphaess,ginlong,goodwe,inovance,kelong,set}、midware/inverter/parallel_comm、system/board_init。

5.3 本文件调用的外部函数（主要）

6. 依赖关系

包含的头文件（inverter.c:16-37）：

被依赖方向：

user/main.c ──创建──> task_inverter / task_inverter_can / task_parallel_sci
                            │
                            ├─> midware/inverter/{kelong,set,ginlong,alphaess,goodwe,inovance}/*_comm*.c
                            │        （轮询收发 + 机型识别 + 升级状态，写 t_run_info）
                            ├─> midware/inverter/parallel_comm/*   （并机）
                            ├─> midware/meter/*                    （电网表 / 备电箱识别）
                            ├─> midware/afci、generator、bms、csip_aus、ate
                            └─> data/（save_job_post）、ems/（故障位）
logic/* ──读运行数据/机型策略常量──> inverter.c ──写 t_safty_info/t_control_*──> 厂商驱动下发
net/*、hmi/*、hmi/ui/*、midware/interface/{modbus,dry_node,drm}/* ──读/写──> inverter.c

7. 备注与风险点

7.1 编译期宏与本快照的构建配置（重要）

• 本文件所有厂商分支都包在 #if ((INVERTER_TYPE == INVERTER_MAX) || (INVERTER_TYPE == XXX_TYPE)) 里。本快照 inverter.h:172 定义为 #define INVERTER_TYPE (INVERTER_NULL) 即 0；user/EMS_3_0.uvprojx 的 <Define> 只有 USE_STDPERIPH_DRIVER, GD32F407，全工程再无第二处定义（grep -rnE "define[ \t]+INVERTER_TYPE" 仅命中该行）。因此按本快照默认配置：所有厂商 #if 分支均不参与编译，task_inverter 不会调用任何厂商收发函数，纯靠 #if 提供分支的函数（如 inverter_get_pv_start_volt() 2104、inverter_get_max_bat_volt() 2772、inverter_read_system_modle() 1386）会直接落到兜底 return。分析任一厂商行为时必须以「INVERTER_TYPE 被改为对应机型码或 INVERTER_MAX(7)」为前提。若要一份固件支持全部厂商，应把该行改为 INVERTER_MAX。
• 同理，inverter.h:175-182 的 INV_DC_CTRL / INV_AC_CTRL 在 INVERTER_NULL 下两个都没有被定义，任何 #ifdef INV_DC_CTRL / INV_AC_CTRL 的地方都会走空分支。

7.2 读函数带副作用

• get_inverter_type()（1340-1348）与 get_inverter_sub()（1369-1377）在返回值越界时直接改写 g_t_inv_info.t_config_data。它们被全工程高频调用（含中断/其他任务上下文），属于「读取即写 Flash 影子数据」的设计，若此时恰好有其它任务在组帧下发配置，可能出现读到中间态。建议越界时只返回兜底值，不写回。
• inverter_read_sn/ver_master/ver_slave/ver_arm（3744/3756/3768/3780）在返回前写 [...][sizeof-1] = 0，即修改被读对象。虽然意图是保证字符串终止，但对 const 语义不友好，且若缓冲区恰好被厂商驱动正在写（DMA/中断），有破坏数据的窗口。

7.3 状态机与一次性标志的健壮性

• italian_self_test_handle()（326）的 static 标志 s_u8_safty_test_flag、s_u8_safty_test_flag2、s_u8_cnt 在整个函数体内没有任何「安规已不是 CEI021 则复位」的路径（旧版实现在被注释掉的 394-403 里才有这段复位逻辑）。安规切换或机型切换后标志不会自清，「送服务器/送 APP」标志可能不再产生。另外锦浪 T10 与其它机型共用同一个函数级 s_u8_safty_test_flag，机型切换时两套语义会互相污染。
• get_self_test_data() 在 CEI021 下每轮任务（≈80ms）都被完整重算：既白耗 CPU，又把 t_safty_tset_info[0].u_test_res.u16_all 反复清 0。若厂商驱动在两次调用之间刚写入自检结果位，会被立刻抹掉。
• overload_recovery_handle()（478）：只要输出过载故障位保持为真，就每小时无条件 inverter_reset()（沃太除外），永不止息。对持续性硬件过载，这会形成周期性复位风暴，且没有任何重试上限或告警升级。
• power_limit_handle()（629）依赖 abs(OSTimeGet() - tick) 计算间隔，用 abs()（int 版）处理 u32 差值，在 OSTimeGet() 回绕附近行为依赖隐式符号转换，虽有多处 tick 刷新兜底，仍建议显式做无符号差。
• sys_anti_theft_handle()（918）：配置为「已设防盗」时每轮都 inverter_shutdown()；如果配置读到一半（Flash 重载）出现假值，可能造成反复停机。

7.4 空实现 / 无效实现 / 命名与实现不符

7.5 潜在编译期问题

• sys_shutdown_handle() 的调试打印（inverter.c:879）引用了 s_u8_inv_stop_days，该标识符在本函数作用域内并未声明（函数内只有 s_u8_logout_flag、s_u32_logout_sys_shutdown_time）。当前 DEBUG_INVERTER == 0 使其不参与编译，但一旦打开调试开关就会编译失败。
• inverter_get_reactpower_control_mode()（7160）等函数访问 safty_mode_u.BIT.* 位域，位域布局依赖编译器与 #pragma pack；本文件在 t_safty_info / t_config_data 之间来回整体赋值 safty_mode_u.u16_value（4458），若两处位域定义顺序不一致会造成错位。
• 全文件含 1014 处条件编译指令，#if 嵌套最深达 3 层，可读性与「改一处漏一处」风险较高；新增厂商机型时，本文件内至少 200 个函数需要逐个人工补齐分支。

7.6 安全与一致性风险

1. 无范围校验：约 190 个安规参数 setter 直接把外部（云端/Modbus）传入的值写进 t_safty_info 并置脏标志，仅 6 处做钳位/丢弃（5689、5728、5760、5826、5966、6019、6070、6121、4661）。恶意或错误的上位机指令可把过压/过频保护定值设成任意值，需要在上游 net/ 或 logic/ 侧补校验。
2. 跨模块直接写全局：本文件不通过 setter，直接写 s_senergys5_set_info / s_senergys5_task_tab（盛能杰）与 g_t_ginlong_info、g_t_kelong_comm_info 等的内部字段（共 300+ 处），破坏了模块封装，且这些字段的并发访问没有任何锁保护。
3. u8_tor_no_use_flag 是隐式全局门控：一旦被 sys_safety_special_deal_handle() 置真，所有 OVP/UVP/OFP/UFP 定值、孤岛检测设定会被静默丢弃（return 而非拒绝），上层无法感知下发失败。
4. 落盘不一致：inverter_write_safety 落盘、inverter_write_safesub 不落盘；inverter_set_islanding_check_enable、inverter_set_n_n_short 落盘，而大多数使能类 setter 不落盘。掉电后哪些参数保留取决于调用点，需逐个核对，容易产生「现场行为与配置页面不一致」的投诉。
5. 事件标志超时被当作正常：task_inverter 的 OSFlagPend 超时为 20ms，os_flag 未匹配时本轮仍会继续跑完所有处理并再次延时 80ms；task_inverter_can 的 OSFlagPend 带 OS_FLAG_CONSUME，若 task_inverter 因异常路径未 OSFlagPost，CAN 侧会连续超时但不会报错，通信丢失只能靠 inverter_lost_handle_can() 兜底。

7.7 文档维护提示

• 本文件共 313 个函数，其中约 250 个是「一个赋值 + 若干脏标志」的模板函数。后续若统一改造为「表驱动 + 回调」，可把本文件体积压缩一个数量级；在改造前，新增参数必须同时更新：t_safty_info 字段、本文件的 setter、6 家厂商的组帧函数与脏标志、net/ 云端寄存器映射、hmi/ 页面与 Modbus 表。
• 与本文档配套的 inverter.h.md（docs/knowledge/代码解析/midware/inverter/inverter.h.md）给出全部结构体/枚举的逐字段说明，类型细节以该文档为准；本文档只覆盖 inverter.c 的实现行为。