首页 / knowledge/代码解析/索引/功能索引
midware-device（电表 / CT / 备电盒 / 油机 / 充电桩 / AFCI / BMS）功能反查索引
本页目录1. 电表：任务调度与型号识别2. 电表：电参量读取、量纲换算与电能3. 电表：通信丢失、故障上报与清表4. 电表：相序自适应与单相接反5. 电表：正泰无线电表模组6. 电表：升级入口与 MID 三相表7. CT 交流采样通道8. 备电盒（BackupBox）负载投切9. 油机（柴油发电机组）采集10. 电表 / 备电盒固件升级11. 一代充电桩（EVC / SMILE-EVCT11）12. 二代充电桩（EVC-II，最多 4 桩并机）13. 充电桩固件升级14. AFCI：常规通信、自检与故障日志15. AFCI：OTA 升级16. BMS 电池：数据汇聚与业务17. BMS 电池：加热18. BMS 电池：CAN 协议与下行指令19. BMS 电池：CAN 固件升级文件清单核对midware/meter（12）midware/bms（6）midware/evc（6）midware/afci（4）
覆盖源文件：28 个。文档本体见
docs/knowledge/代码解析/midware/。 用法：在「想找的功能」列里搜关键词，即可定位到源文件。本索引覆盖
midware/meter（12）、midware/bms（6）、midware/evc（6）、midware/afci（4）。 表中「入口函数或符号」均取自对应分析文档，可在docs/knowledge/代码解析/索引/函数索引.tsv复核。
1. 电表：任务调度与型号识别
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 电表任务在哪里？电表轮询周期是多少 | task_meter（主延时 300ms，PV 分支 +100ms） | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电网侧 / PV 侧 / 三相 MID 表分别挂在哪条 485 上 | task_meter、USART1（GRID/PV/无线电表）、USART3（MID 三相表） | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表自动探测识别流程 / 怎么认型号 | meter_detect、grid_meter_find、pv_meter_find、mid_meter_find、grid_meter_detect、pv_meter_detect、mid_meter_detect | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 系统一共支持哪些电表型号 | METER_TYPE_E、meter_get_meter_modle、meter_get_meter_type_now、meter_get_meter_type_old | midware/meter/meter.h（实现在 meter.c） | ../../midware/meter/meter.h.md |
| 各型号电表在 485 总线上的 Modbus 从站地址表 | GRID_*_METER_ADDR、PV_*_METER_ADDR、PV_GRIDFORMING_EN_METER_ADDR、MID_3PH_METER_ADDR | midware/meter/meter.h | ../../midware/meter/meter.h.md |
| Modbus RTU 读帧（0x03）/ 写单寄存器（0x06）/ 写多寄存器（0x10）格式与 CRC | meter_write_data、meter_recv_data、mid_meter_write_data、mid_meter_recv_data、GetCrcCode_Modbus | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 大端 4 字节怎么转 float（电表浮点电参量） | be_to_float、bytes_to_float_be、bytes_to_double | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表探测轮询表长度（GRID 7 项 / PV 8 项 / MID 1 项） | GRID_SUPPORT_METER_NUMBER、PV_SUPPORT_METER_NUMBER、MID_SUPPORT_METER_NUMBER | midware/meter/meter.h | ../../midware/meter/meter.h.md |
| 未找到电表时的重新探测间隔是多久 | METER_DETECT_INTERVAL_TIME（1000ms） | midware/meter/meter.h | ../../midware/meter/meter.h.md |
| 485 收发缓冲多大？为什么 GRID/PV/无线共用一块 | METER_RECV_BUFFER_SIZE（256）、g_u8_recv_buf | midware/meter/meter.h | ../../midware/meter/meter.h.md |
| BackupBox 与 ADL3000/ADL400 响应怎么区分 | BACKUPBOX_ID（0x00AB） | midware/meter/meter.h | ../../midware/meter/meter.h.md |
| 固件升级期间为什么 PV 电表读不到数据（485 总线让给升级） | task_meter（GRID 为 BB 且 BB 未运行时跳过 PV） | midware/meter/meter.c | ../../midware/meter/meter.c.md |
2. 电表：电参量读取、量纲换算与电能
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 电参量（电压/电流/功率/因数/频率）怎么读，读接口在哪 | meter_read_voltage、meter_read_current、meter_read_actpower、meter_read_reactpower、meter_read_factor、meter_read_frequent | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 视在功率怎么算（是不是电表原始值） | meter_read_apparent（软件 U×I/1000 反算） | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 正向（买电）/ 反向（卖电）电能怎么读 | meter_read_einput、meter_read_eoutput | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表数据的单位 / 量纲约定（0.1V、0.01A、0.001kW…） | METER_DATA_T | midware/meter/meter.h | ../../midware/meter/meter.h.md |
| 三相分相与「总」的索引怎么表示 | METER_PHASE_E、PHASE_A/PHASE_B/PHASE_C/PHASE_T、MAX_PHASE | midware/meter/meter.h | ../../midware/meter/meter.h.md |
| 各厂商电表寄存器映射与量纲换算表（ADL400 / ADL3000 / ADL400N / ALPHA / ACR10R / SM60A / AGF200） | meter_read_data_for_ADL400、meter_read_data_for_ADL3000、meter_read_data_for_ADL400N、meter_read_data_for_ALPHA、meter_read_data_for_ACR10R、meter_read_data_for_SM60A、meter_read_data_for_AGF200 | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| MID 三相表浮点电参量怎么解析 | mid_meter_parse_data | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表数据是「高频电参量 + 低频电能」怎么实现的（com_switch 轮询调度） | grid_meter_read_data、pv_meter_read_data、mid_meter_read_data、METER_DATA_TEMP.com_switch | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电能三次取中值抗误码（表决）在哪 | midvalue | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表不给总电能时 EMS 怎么自己算总电能 | grid_total_pahse_grid_energy_statistics、grid_total_pahse_pv_energy_statistics | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电流/功率按 CT 倍率缩放 | meter_read_data_3ct | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 功率方向取反（电流/有功/无功/因数整体取负） | meter_set_meter_negate、meter_get_meter_negate、meter_read_data_negate | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 某位置是「CT 还是电表」怎么设置 | meter_set_meter_or_ct、meter_get_meter_or_ct | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表侧是否带 CT / CT 倍率设置 | meter_set_meter_ct_enable、meter_get_meter_ct_enable、meter_set_meter_ct_rate、meter_get_meter_ct_rate | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 直接接 CT 时的倍率设置 | meter_set_ct_rate、meter_get_ct_rate | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 采样来源（电表 / CT / P1）由云端位掩码设置 | meter_set_ct_sampling、METER_SAMPLING_TYPE_E（CT_SAMPLING/METER_SAMPLING/P1_SAMPLING） | midware/meter/meter.c、midware/meter/meter.h | ../../midware/meter/meter.c.md |
| P1（SMILE-P1-WB01）无线通道数据怎么注入电表表 | meter_set_run_data、meter_set_refresh_flag、meter_read_P1_refresh_time、meter_set_P1_lose_flag、meter_get_P1_lose_flag | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| P1 与 WIFI 配对故障位怎么置 | meter_set_grid_wifi_P1_fault | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表 SN / 软件版本 / 硬件版本怎么取 | meter_read_meter_sn、meter_read_software_version、meter_read_hard_version | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表连接状态怎么读 / 怎么改 | meter_read_connect_status、meter_set_connect_status | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表电能上报使能开关 | get_energy_data_enable、u8_energy_data_enable | midware/meter/meter.c、midware/meter/meter.h | ../../midware/meter/meter.c.md |
| 电表配置（型号/CT/取反/自算电能标志）掉电保存到哪一页 | METER_CONFIG_TAB_T、METER_CONFIG_PAGE、meter_config_handle、meter_set_saveConfigFlag | midware/meter/meter.h（实现在 meter.c） | ../../midware/meter/meter.h.md |
| 电表运行表都有哪些字段（丢失计数/清表标志/刷新标志/BB 身份） | METER_RUN_TABLE_T | midware/meter/meter.h | ../../midware/meter/meter.h.md |
电表子系统总表（全局 g_t_meter）结构 | METER_TABLE_T、g_t_meter | midware/meter/meter.h | ../../midware/meter/meter.h.md |
3. 电表：通信丢失、故障上报与清表
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 电表通信超时判多久算丢失 | METER_LOST_MAX_CNT（15）、u8_lost_cnt | midware/meter/meter.h | ../../midware/meter/meter.h.md |
| 限功率场景为什么丢表判得更快（阈值降到 3） | grid_meter_read_data（读 g_t_inv_info.t_config_data 软/硬件限功率使能） | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表丢失后置哪个 EMS 故障位 | meter_fault_handle（GRID→bit4，PV→bit5，MID→bit29） | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 哪些工况下丢表不上报故障（离网 / UPS / 频率过低） | grid_meter_read_data、get_offgrid_mode_grid_state、inverter_read_run_mode | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 无损探测（不依赖 485 收帧）的丢失判定：连续多少次探测失败 | grid_meter_detect、pv_meter_detect、mid_meter_detect（30 次） | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 无线电表判丢失是多久 | WIRELESS_METER_LOST_TIME（10s）、wireless_meter_handle、wireless_meter_handle_lost、wireless_meter_is_all_lost | midware/meter/meter.h、midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 清空电表运行数据（保留配置） | meter_run_data_clear、meter_clear_run_data_flag | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表恢复出厂 / 清表怎么触发，各型号命令字是什么 | meter_set_clear_flag、meter_clear、grid_meter_clear、pv_meter_clear、agf200_grid_meter_clear、adl400n_grid_meter_clear、agf200_pv_meter_clear | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| MID 三相表清电能（0x10 写 0x0002，重试 3 次） | mid_meter_clear、mid_meter_send_clear_data | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 外部置位 GRID 清数据 / 通信状态 / 硬件版本（P1 通道用） | meter_set_clear_grid_data、meter_set_grid_com_sta、meter_set_grid_hw_ver | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表配置变化怎么通知云端重新上传配置 | Set_Setup_Config_Status、Set_Setup_Config_Extend2_Status、meter_config_handle | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表故障位 / 保护 / 告警位域联合体定义 | METER_SINGLE_NEGATE_U、BB_FAULT_U、METER_CONTROL_TABLE_T、METER_ADJUST_STATE_U | midware/meter/meter.h | ../../midware/meter/meter.h.md |
4. 电表：相序自适应与单相接反
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 相序自适应（正泰 DTS）总入口在哪，开关配置项是什么 | meter_query_triphase_sequnece_adjust_scheme、u8_meter_triphase_sequnece_flag（1 开 / 2 关） | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 正泰相序自适应主状态机（先 GRID 后 PV，各 30s 超时） | chint_adjust_state_machine | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 相序自适应命令下发（含 3 次重试，单回路 vs 双回路地址区别） | set_meter_triphase_sequnece_adjust_mark、set_meter_phase_sequnece_adjust_mark | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 怎么判断相序自适应是否已完成（读哪个寄存器） | meter_query_grid_adjust_ready（0x0128）、meter_query_pv_adjust_ready（0x8128）、METER_ADJUST_STATE_U、GRID_ADJUST_READY_MASK、BOTH_ADJUST_READY_MASK | midware/meter/meter.c、midware/meter/meter.h | ../../midware/meter/meter.c.md |
| 单相接反查询（读 0x0127 / 0x8127）与状态字解析 | grid_meter_query_dts_special_command、pv_meter_query_dts_special_command | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 单相接反配置下发（写 0x0127 / 0x8127） | grid_meter_set_single_negate、pv_meter_set_single_negate | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 单相接反校准的控制逻辑（实际值 ≠ 配置值时下发或重查） | meter_control_single_negate_handle | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 怎么区分正泰 / 安科瑞厂商（决定走哪套相序逻辑） | meter_get_meter_type、is_chint_meter_type、METER_TYPE_CH_*、METER_TYPE_AC_ADL400、Chint、Acrel | midware/meter/meter.c、midware/meter/meter.h | ../../midware/meter/meter.c.md |
| 正泰电表最低支持版本门槛 | MIN_VERSION_CH_DTSU666（"V127"）、MIN_VERSION_CH_DTSU666iDW | midware/meter/meter.h | ../../midware/meter/meter.h.md |
5. 电表：正泰无线电表模组
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 正泰无线模组总入口 / 何时自动使能 | chnt_wireless_moudle_check（型号字符串含 "iDW" 自动使能） | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 无线模组读状态机（AP + STA1 + STA2 汇总） | chnt_wireless_detect、chnt_wireless_config_info、get_chnt_wireless_module_info | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 无线模组写状态机（逐节点下发频段） | set_chnt_wireless_moudle_info、set_chnt_wireless_config_info、chnt_wireless_moudle_info_check | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 无线模组命令栈 / 节点地址 / 寄存器地址表 | CHNT_WIRELESS_STACK、g_code_stack、MAX_CODES、CHNT_WIRELESS_AP_ADDR、CHNT_WIRELESS_INFO_ADDR、CHNT_MOUDLE_INFO_ADDR | midware/meter/meter.h | ../../midware/meter/meter.h.md |
| 无线模组频段 / 使能 / 绑定码设置 | meter_set_chnt_wireless_module_regional_freq_bands、meter_get_chnt_wireless_module_regional_freq_bands、meter_set_chnt_wireless_module_enable、meter_get_chnt_wireless_module_enable、meter_set_chnt_wireless_bound | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 无线模组信息表（SN/型号/版本/RSSI/丢失计数） | CHNT_WIRELESS_INFO_TABLE_T、clear_chnt_wireless_moudle_info | midware/meter/meter.h、midware/meter/meter.c | ../../midware/meter/meter.h.md |
| 无线模组探测节拍 | CHNT_WIRELESS_DETECT_INTERVAL_TIME（1000ms）、chnt_wireless_moudle_handle | midware/meter/meter.h、midware/meter/meter.c | ../../midware/meter/meter.c.md |
6. 电表：升级入口与 MID 三相表
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 电表（含 BB / 无线）升级是在哪里被触发和分派的 | task_meter（查 Get_Status_Is_Updated_From_Server(UPDT_Meter)）、get_meter_updt_object、IsUpgradeMeter | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 电表升级进度百分比怎么取 | GetPercentUpgradeMeter、get_percent_upgrade_meter | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| 哪些型号不支持升级（BB10K/23K、ALPHA 双回路直接放弃） | task_meter（PV_METER 分支） | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| MID 三相表初始化 / 使能开关（上电默认关闭） | mid_meter_table_init、u8_mid_meter_function_enable | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| GRID / PV 运行表初始化与探测标志 | grid_meter_table_init、pv_meter_table_init、meter_table_init | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| gridforming 使能时 PV 侧电表地址要改成 0x0B | meter_get_pv_meter_addr_change_flag | midware/meter/meter.c | ../../midware/meter/meter.c.md |
7. CT 交流采样通道
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| CT 采样链路初始化（TIM1 + ADC2 + DMA1_CH0 + TIM2/EXTI） | ct_sampling_init | midware/meter/ct.c | ../../midware/meter/ct.c.md |
| CT 采样任务在哪 / 采样频率与每批点数 | task_sampling（TIM1 100Hz，每批 250 点 × 4 通道） | midware/meter/ct.c | ../../midware/meter/ct.c.md |
| ADC DMA 传输完成中断回调 | adc_regular_data_recv | midware/meter/ct.c | ../../midware/meter/ct.c.md |
| 电网频率怎么测（方波下降沿捕获） | grid_freq_sampling_handle、ct_read_frequent | midware/meter/ct.c | ../../midware/meter/ct.c.md |
| CT 电压 / 电流 / 有功读接口 | ct_read_voltage、ct_read_current、ct_read_actpower | midware/meter/ct.c | ../../midware/meter/ct.c.md |
| CT 无功 / 功率因数接口（当前是恒返回 0 的桩函数） | ct_read_reactpower、ct_read_factor | midware/meter/ct.c | ../../midware/meter/ct.c.md |
| CT 电量累计与读取 | grid_ct_energy_statistics、pv_ct_energy_statistics、ct_read_einput、ct_read_eoutput | midware/meter/ct.c | ../../midware/meter/ct.c.md |
| CT 电量清零并落盘 | ct_energy_clear、CT_ENERGY_PAGE、CT_ENERGY_SAVE_TABLE_T | midware/meter/ct.c、midware/meter/ct.h | ../../midware/meter/ct.c.md |
| CT 滑动平均滤波 / 分段线性校准 / 死区 / 限幅 | grid_active_power_filter、grid_active_curr_filter、cal_grid_vol、pv_active_power_filter、pv_active_curr_filter | midware/meter/ct.c | ../../midware/meter/ct.c.md |
| CT 校准表 / 滤波深度 / 缓冲尺寸等编译期常量 | CT_CONFIG_TABLE_T、CT_TABLE_T、g_t_ct | midware/meter/ct.h | ../../midware/meter/ct.h.md |
| CT 电网波形曲线录制（本地 + 上报服务器两条通道） | GRID_SAMPLING_CURVE_T、GRID_SERVER_SAMPLING_CURVE_T、g_grid_sampling_curve_t、g_server_grid_sampling_curve_t | midware/meter/ct.h | ../../midware/meter/ct.h.md |
| CT 采样值怎么回灌进电表运行表（谁调用 ct_handle） | ct_handle | midware/meter/meter.c | ../../midware/meter/meter.c.md |
| CT 采样异常怎么判（fault bit 18） | task_sampling | midware/meter/ct.c | ../../midware/meter/ct.c.md |
| 并离网切换时 CT 中值（DC 偏置）要重新收敛 | task_sampling | midware/meter/ct.c | ../../midware/meter/ct.c.md |
8. 备电盒（BackupBox）负载投切
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 备电盒分相负载投切决策在哪里做 | bb_load_manage | midware/meter/backupbox.c | ../../midware/meter/backupbox.c.md |
| 单相机型负载管理（SOC 门限切相） | single_phase_bb_load_manage、bb_grid_connected_handle、bb_grid_disconnected_handle | midware/meter/backupbox.c | ../../midware/meter/backupbox.c.md |
| 三相机型负载管理（按 1/3 额定放电功率切相） | triphase_bb_load_manage、bb_on_grid_handle、bb_off_grid_handle | midware/meter/backupbox.c | ../../midware/meter/backupbox.c.md |
| 三相开关状态怎么下发（Modbus 0x10 写 0x0020，重试 3 次） | change_state_bb_lx | midware/meter/backupbox.c | ../../midware/meter/backupbox.c.md |
| 备电盒配置（分相优先级 / 各相 SOC 门限）与运行表定义 | BACKUP_BOX_CONFIG_T、BACKUP_BOX_RUN_T | midware/meter/backupbox.h | ../../midware/meter/backupbox.h.md |
| 备电盒诊断量（继电器/过温/N 线故障/过载电流/差流）寄存器地址与结构 | BB_DEBUGE_T、BACKUPBOX_*（0x0025~0x0073） | midware/meter/meter.h | ../../midware/meter/meter.h.md |
| 备电盒型号识别（5K / 10K / 23K） | BACKUPBOX_5K、BACKUPBOX_10K、BACKUPBOX_23K、BACKUPBOX_ID | midware/meter/meter.h | ../../midware/meter/meter.h.md |
| 备电盒 SN / 软件版本 / 硬件版本读取 | meter_read_bb_sn、meter_read_bb_software_version、VERSION_BB_HARD | midware/meter/meter.c | ../../midware/meter/meter.c.md |
9. 油机（柴油发电机组）采集
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 油机（柴油发电机）数据采集在哪 / 谁驱动 | genset_comm_handle | midware/meter/diesel_generator.c | ../../midware/meter/diesel_generator.c.md |
| 油机 Modbus 从站地址与轮询节拍 | GENSET_ADDR（0x63/99）、500ms 节拍、send_query_genset_command | midware/meter/diesel_generator.c | ../../midware/meter/diesel_generator.c.md |
| 油机读哪几页寄存器（Page 4/5/7/154） | ems_query_genset_page4_command、ems_query_genset_page5_command、ems_query_genset_page7_command、ems_query_genset_page154_command | midware/meter/diesel_generator.c | ../../midware/meter/diesel_generator.c.md |
| 油机页号 / 寄存器号 / 个数常量 | DG_PAGE_4_A0_33_REG_NUM 等 | midware/meter/diesel_generator.h | ../../midware/meter/diesel_generator.h.md |
| 油机通信丢失判多久 / 清零 | 15s 门限、genset_run_data_clear | midware/meter/diesel_generator.c | ../../midware/meter/diesel_generator.c.md |
| 油机使能开关与运行数据总表 | u8_genset_enable_flag、GENSET_RUN_TABLE_T、g_t_diesel_gen | midware/meter/diesel_generator.h | ../../midware/meter/diesel_generator.h.md |
| 油机数据上报云端（谁读 g_t_diesel_gen） | g_t_diesel_gen、net/ems.c 的 CMD_SEND_GENSET_DATA | midware/meter/diesel_generator.h | ../../midware/meter/diesel_generator.h.md |
10. 电表 / 备电盒固件升级
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 电表固件升级主状态机（进 Boot → 握手 → 擦除 → 分块写 → 退出） | meter_upgrade_handle | midware/meter/meter_upgrade.c | ../../midware/meter/meter_upgrade.c.md |
| 电表升级协议帧格式与命令码 | meter_upgrade_send_code、meter_upgrade_send_data、meter_upgrade_recv_data、meter_upgrade_send_cmd、命令字 0x23 | midware/meter/meter_upgrade.c | ../../midware/meter/meter_upgrade.c.md |
| 电表升级分包粒度（250 字节）与重试门限 | meter_upgrade_send_data、METERR_UPGRADE 上下文、err_cnt | midware/meter/meter_upgrade.c | ../../midware/meter/meter_upgrade.c.md |
| 电表升级进度与断点偏移 | get_percent_upgrade_meter、get_upgrade_file_offset_meter | midware/meter/meter_upgrade.c | ../../midware/meter/meter_upgrade.c.md |
| 正泰无线多节点升级（地址栈 LIFO 串行升级） | chnt_wireless_add_update_code、chnt_wireless_add_pop_code | midware/meter/meter_upgrade.c | ../../midware/meter/meter_upgrade.c.md |
| 电表升级状态枚举 / 上下文结构体定义 | METER_UPGRADE_T | midware/meter/meter_upgrade.h | ../../midware/meter/meter_upgrade.h.md |
| BackupBox 固件升级主状态机（复位 → PSLAVER → 波特率 → 擦除 → 写 → 校验 → 写关键字） | bb_update | midware/meter/bb_update.c | ../../midware/meter/bb_update.c.md |
| BB 升级 HEX（S19）解析与拼包 | parse_bb_hex_content | midware/meter/bb_update.c | ../../midware/meter/bb_update.c.md |
| BB 升级应答判定与帧格式 | deal_bb_update_data、bb_send_data | midware/meter/bb_update.c | ../../midware/meter/bb_update.c.md |
| BB 升级总超时（60 秒强制重来） | bb_update | midware/meter/bb_update.c | ../../midware/meter/bb_update.c.md |
| BB 升级进度与已传偏移 | GetPercentUpgradeBB、GetUpgradeFileOffsetBB | midware/meter/bb_update.c | ../../midware/meter/bb_update.c.md |
| BB 升级协议常量 / 状态与帧类型枚举 / 上下文结构体 | BB_STATE、BB_INSTRUCTIONS、BB_UPDATE_CONTENT、BB_CHECK | midware/meter/bb_update.h | ../../midware/meter/bb_update.h.md |
| BB 升级期间为什么要停掉其他电表查询 | task_meter | midware/meter/meter.c | ../../midware/meter/meter.c.md |
11. 一代充电桩（EVC / SMILE-EVCT11）
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 一代充电桩驱动入口与调度节拍（100ms 调用、1s 读、10s 控） | evc_control | midware/evc/evc.c | ../../midware/evc/evc.c.md |
| 一代桩 Modbus RTU 收发与超时重试 | evc_master_send_cmd、evc_master_recv_data | midware/evc/evc.c | ../../midware/evc/evc.c.md |
| 一代桩寄存器映射（读 0x0100 设备信息 / 读 0x9100 运行信息 / 写 0x0100 设定功率） | get_evc_id_info、get_evc_run_info、send_cmd_evc | midware/evc/evc.c | ../../midware/evc/evc.c.md |
| 一代桩「剩余可充总功率」怎么算 | evc_calculated_total_power | midware/evc/evc.c | ../../midware/evc/evc.c.md |
| 一代桩单桩设定功率计算与条件充电延时 | evc_calculate_single_station_power | midware/evc/evc.c | ../../midware/evc/evc.c.md |
| 一代桩充电时间段（两段时段）判定 | evc_charge_time | midware/evc/evc.c | ../../midware/evc/evc.c.md |
| 一代桩电量清零 | set_evc_energy、clear_evc_energy、get_evc_energy_total | midware/evc/evc.c | ../../midware/evc/evc.c.md |
| 一代桩充停指令 / 充电模式上报 | set_evc_charge_flag、get_evc_chargemodel | midware/evc/evc.c | ../../midware/evc/evc.c.md |
| 一代桩使能 / 型号 / 功率读取 | get_evc_enable_flag、get_evc_type、get_evc_power_total | midware/evc/evc.c | ../../midware/evc/evc.c.md |
| 一代桩配置表 / 运行表 / 公共收发缓冲定义 | evc.h（g_t_evc_run_info、g_t_evc_setting_info、g_evc_send_buf、g_evc_recv_buf、EVC_BUF_LEN） | midware/evc/evc.h | ../../midware/evc/evc.h.md |
| 一代桩与二代桩怎么二选一（互斥） | get_evc_enable_flag/get_evc_ii_enable_flag（midware/interface/interface.c 分派） | midware/evc/evc.c、midware/evc/evc_ii.c | ../../midware/evc/evc.c.md |
12. 二代充电桩（EVC-II，最多 4 桩并机）
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 二代充电桩驱动入口与调度节拍 | evc_ii_control | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
| 二代桩 AES 加密通讯（协商私钥、收发加解密） | evc_ii_aes_encrypt、get_evc_ii_pravite_key、evc_ii_master_send_cmd、evc_ii_master_recv_data | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
| 二代桩寄存器映射（读设备信息 / 读运行信息 / 写设定功率） | get_evc_ii_id_info、get_evc_ii_run_info、send_cmd_evc_ii | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
| 二代桩充停状态机（云指令 / 刷卡两阶段确认 / 定时充停） | evc_ii_update_charge_control_state、evc_ii_want_charge、set_evc_ii_charge_flag | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
| 二代桩多桩功率分配（启动功率预留 + 动态均分） | evc_ii_distribute_power | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
| 二代桩 EV 总可用功率计算 | evc_ii_calculated_total_power | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
| 二代桩系统级限流（16A / 32A 对应的三相总功率） | evc_ii_apply_system_power_limit | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
| 二代桩单桩功率落地（并机模式 vs 独立模式） | evc_ii_parallel_calculate_single_station_power、evc_ii_calculate_single_station_power | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
| 二代桩单桩功率上下限裁剪与硬件上限 | evc_ii_set_power_total_limit、evc_ii_get_max_allowed_power、evc_ii_prepare_power_limit | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
二代桩充电策略选择（按 u8_charge_tactics）与三段时段 | evc_ii_get_evc_data、evc_ii_charge_time、evc_ii_get_sys_data | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
| 二代桩枪锁（电子锁）状态与使能 | get_evc_ii_gun_lock_flag、get_evc_ii_gun_lock_ctrl | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
| 二代桩电量清零 | set_evc_ii_energy、clear_evc_ii_energy、get_evc_ii_energy_total | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
| 二代桩使能 / 型号 / 功率读取 / 充电模式上报 | get_evc_ii_enable_flag、get_evc_ii_type、get_evc_ii_power_total、get_evc_ii_chargemodel | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
| 二代桩「最多 4 桩」数组与故障位域定义 | MAX_EVC_II_NUM、g_t_evc_ii_run_info、g_t_evc_ii_single_config | midware/evc/evc_ii.h | ../../midware/evc/evc_ii.h.md |
| 二代桩通讯丢失与运行数据清理 | evc_ii_control | midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md |
13. 充电桩固件升级
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 充电桩（一/二代）固件升级主状态机 | evc_upgrad_handle | midware/evc/evc_upgrade.c | ../../midware/evc/evc_upgrade.c.md |
| 充电桩升级帧格式与 CRC16-IBM 校验 | evc_upgrade_send_cmd、evc_upgrade_recv_data | midware/evc/evc_upgrade.c | ../../midware/evc/evc_upgrade.c.md |
| 充电桩升级命令帧（写 Flash / 跳转应用） | evc_upgrade_send_code、evc_upgrade_send_data、evc_upgrade_send_key_word | midware/evc/evc_upgrade.c | ../../midware/evc/evc_upgrade.c.md |
| 充电桩升级 HEX 解析与 224 字节分包 | parse_evc_hex_content、EVC_MAX_PRG_LENGTH | midware/evc/evc_upgrade.c | ../../midware/evc/evc_upgrade.c.md |
| 云端特殊命令选哪几台桩升级 / 是否正在升级 | set_evc_upgrad_flag、get_evc_upgrad_flag、is_upgrade_evc | midware/evc/evc_upgrade.c | ../../midware/evc/evc_upgrade.c.md |
| 充电桩升级进度与断点续传偏移 | get_percent_upgrade_evc、get_upgrade_file_offset_evc | midware/evc/evc_upgrade.c | ../../midware/evc/evc_upgrade.c.md |
| 充电桩升级状态枚举 / 命令码 / 上下文结构体 | EVC_UPGRADE_T | midware/evc/evc_upgrade.h | ../../midware/evc/evc_upgrade.h.md |
| 升级期间为什么充电桩轮询被让出（串口 3 独占） | is_upgrade_evc（midware/interface/interface.c 分派） | midware/evc/evc_upgrade.c | ../../midware/evc/evc_upgrade.c.md |
14. AFCI：常规通信、自检与故障日志
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| AFCI（电弧故障检测）常规通信在哪 / 谁驱动 | afci_comm.c（alphaess_afci_comm_function 周期驱动）、send_query_data_to_afci、ems_send_ctrl_data_to_afci、alphaess_afci_recv_data | midware/afci/afci_comm.c | ../../midware/afci/afci_comm.c.md |
| AFCI 软版本读取与机型相关的版本字节重排 | query_afci_software_version、parse_afci_version_data、get_version_sort_map、inverter_read_ver_afci | midware/afci/afci_comm.c | ../../midware/afci/afci_comm.c.md |
| AFCI 自检（工厂模式进/退、通道使能、结果回读） | set_afci_fac_mode、send_afci_self_check_enable、query_afci_self_check_status、afci_self_check_handle | midware/afci/afci_comm.c | ../../midware/afci/afci_comm.c.md |
| AFCI 告警清除与告警查询 | send_afci_clear_warning_message、query_afci_warning_message | midware/afci/afci_comm.c | ../../midware/afci/afci_comm.c.md |
| AFCI 软重启 | set_afci_soft_reboot | midware/afci/afci_comm.c | ../../midware/afci/afci_comm.c.md |
| AFCI 故障日志分帧拉取 / 清除 / 上传收尾 | afci_fault_log_data_handle、query_afci_log_data、send_clear_afci_log_data、set_afci_log_data_upload_send_status、afci_log_init | midware/afci/afci_comm.c | ../../midware/afci/afci_comm.c.md |
| AFCI 从站地址 / 寄存器地址 / 机型版本常量 | 地址与寄存器宏、VERSION_AFCI_HARD、AFCI_TYPE_BYTE_WATT_* | midware/afci/afci_comm.h | ../../midware/afci/afci_comm.h.md |
| AFCI 日志上传状态块定义 | AFCI_LOG_DATA_TABLE、g_t_afci_log_tab | midware/afci/afci_comm.h | ../../midware/afci/afci_comm.h.md |
| AFCI 自检成功后清哪个故障位、失败置哪个故障位 | afci_self_check_handle（bit27） | midware/afci/afci_comm.c | ../../midware/afci/afci_comm.c.md |
15. AFCI：OTA 升级
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| AFCI 固件 OTA 升级主状态机（5 态） | afci_upgrade_handle | midware/afci/afci_upgrade.c | ../../midware/afci/afci_upgrade.c.md |
| AFCI 进入升级模式（写寄存器 0x0023） | send_ems_send_afci_start_cmd | midware/afci/afci_upgrade.c | ../../midware/afci/afci_upgrade.c.md |
| AFCI OTA 自定义帧协议（从站地址 0xF8，握手/数据/结束帧） | send_afci_upgrade_handshake、send_ems_send_afci_upgrade_data、send_ems_send_afci_upgrade_end | midware/afci/afci_upgrade.c | ../../midware/afci/afci_upgrade.c.md |
| AFCI 升级应答判定与超时 | alphaess_afci_com_reply | midware/afci/afci_upgrade.c | ../../midware/afci/afci_upgrade.c.md |
| AFCI 升级失败的重试 / 软重启 / 放弃层次 | afci_upgrade_handle | midware/afci/afci_upgrade.c | ../../midware/afci/afci_upgrade.c.md |
| AFCI 升级进度与偏移、是否正在升级 | get_percent_upgrade_afci、get_upgrade_file_offset_afci、is_upgrade_afci | midware/afci/afci_upgrade.c | ../../midware/afci/afci_upgrade.c.md |
| AFCI 升级协议常量（0xF8 / 包长 128 / 命令字）与状态枚举 | AFCI_UPGRADE_SATE_E、AFCI_UPGRADE_TABLE_T、TIME_ELAPSED | midware/afci/afci_upgrade.h | ../../midware/afci/afci_upgrade.h.md |
| AFCI 升级什么时候被启动（固件下载完成的判据） | is_afci_firm_download_finished（alphaess_comm_usart.c 驱动） | midware/afci/afci_upgrade.c | ../../midware/afci/afci_upgrade.c.md |
16. BMS 电池：数据汇聚与业务
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 电池任务在哪 / 周期多少 / 一轮都干什么 | task_bms（100ms） | midware/bms/bms.c | ../../midware/bms/bms.c.md |
电池数据总表（g_t_bat_info）结构与配置/运行分离 | BATTERY_TABLE_T、BATTERY_CONFIG_TAB_T、BMS_RUN_TABLE_T | midware/bms/bms.h | ../../midware/bms/bms.h.md |
| 电池通信丢失怎么判 / 丢失后数据怎么清 | bms_comm_detect、bms_lost_handle、bms_master_lost_handle、get_master_battery_lost | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池在线状态 / 重启 / 关机 | bms_get_connect_state、bms_reset、bms_set_shutdown | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| SOC / 总压 / 总流 / 温度 / 总功率读取 | bms_read_total_soc、bms_read_total_volt、bms_read_total_cur、bms_read_temp、bms_read_total_power | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 单台电池 SOC / 电流 / SOH / 循环次数 / 运行小时 | bms_read_single_soc、bms_read_single_cur、bms_read_single_soh、bms_read_single_single_cycle、bms_read_single_single_runhrs | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 充放电最大功率 / 最大倍率电流（含升级与混装异常归零） | bms_read_max_charge_power、bms_read_max_dischg_power、bms_read_chg_max_rate_cur、bms_read_dischg_max_rate_cur | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 充放电使能状态字怎么翻译（强充优先） | handle_bat_status_flag、bms_read_status_flag、u16_status_flag | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池保护码 / 故障码 / 告警码合并读取 | bms_read_protection_code、bms_read_fault_code、bms_read_protection_extend2_code、bms_read_fault_code_by_id、bms_read_warning_code_by_id、bms_is_fault_code_valid | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 最高/最低单体电压与温度打包读取 | bms_read_cell_min_volt_info、bms_read_cell_max_volt_info、bms_read_low_temper_info、bms_read_high_temper_info | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池型号 / 容量 / DoD / 充放电截止电压的映射 | handle_battery_model、handle_battery_cell_capacity、handle_battery_dod、handle_bat_chg_cut_rate_volt、handle_bat_dischg_cut_rate_volt、bms_read_battery_capacity | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池平台类型（48V / 高压 / NXP / GD32）怎么判 | get_bms_hardware_platform、bms_get_platform、get_platform_string | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池混装（新老电池 / 不同容量）识别与异常检测 | bms_MIX_battery、bms_read_mixed_installation_flag、get_bat_mixed_installation_num_error_flag、bms_get_store_MIX_type、bms_read_battery_cell_model | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池台数 / 产品号 / 版本字符串配置读取 | bms_get_store_num、bms_get_store_type、bms_get_store_ver、bms_read_num | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池配置与扩展信息变更后落盘 | fresh_and_save_bat_info、fresh_and_save_bat_extend_info、BATTERY_CONFIG_PAGE | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| MOS 干接点控制与闭合重试（30 分钟周期） | bat_mos_control、bat_mos_control_hhe_oem、bms_set_mos_enable、bms_set_mos_open_enable | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 并机 SN 改写状态机（6 槽位、每槽 200ms、5 次重发） | bat_set_sn_handle | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池自锁配置与清除 | bat_self_lock_handle、bms_set_self_lock_enable、bms_get_self_lock_enable、bms_set_self_lock_clear | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 逆变器失联强制电池关机 | force_bat_shutdown_handle | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 低 SOC 事件上报云端 | bat_low_soc_detect | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池校时（每天 1 点） | BMS_time_cmd_handle | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池充放电电量清零 / 与 BMS 同步 | bms_clear_energy、send_battery_energy_cmd | midware/bms/bms.c、midware/bms/alpha/battery_comm.c | ../../midware/bms/bms.c.md |
| 电池激活时间写入（本地 / 云端两路） | handle_bat_set_activation_time、handle_bat_activate_time_info、send_battery_activate_time_cmd | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池 A / B 簇运行模式与旁路状态 | bms_read_a_cluster_mode、bms_read_b_cluster_mode、bms_read_a_cluster_status、bms_read_b_cluster_status、bms_is_a_cluster_valid、bms_is_b_cluster_valid、bms_read_a_cluster_id | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 云 BMS 分钟级单体明细（哪些机型支持） | get_bms_cell_data_support | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 自定义 CAN 帧下发队列 | can_send_queue_add、can_send_queue_clear、can_send_queue_start、can_send_task、can_send_custom_frame | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池使能配置位（系统中未接电池的旁路） | bms_set_ready_enable、bms_get_ready_enable | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池数据字典（字段表）与故障/保护/告警位域联合体 | BMS_RUN_TABLE_T、BATTERY_CONFIG_TAB_T | midware/bms/bms.h | ../../midware/bms/bms.h.md |
17. BMS 电池：加热
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 电池加热总入口 / 怎么在「逆变器加热」和「自加热」之间选 | bat_heat_handle（bat_heat 能力位择路） | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 逆变器给电池加热的状态机（NORMAL / INV_HEAT / INV_HEAT_FAULT） | bat_inv_heat_deal | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 电池自加热状态机（发 0xBB 进加热） | bat_self_heat_deal、bat_self_heat_data_inti | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 加热进入的三步流程（停电池功率 → 发逆变器指令 → 发 BMS 0xAA） | bat_heat_into_1_step、bat_heat_into_2_step、bat_heat_into_sta_check | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 加热正常退出三步（停逆变器 → 发 0x55 → 等继电器断开） | bat_heat_drop_out、bat_heat_exit_check | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 加热能否执行的判据（欠压强充 / 用户使能 / 离网 / 系统升级） | bat_heat_execute_check、bat_new_heat_execute_check、bat_heat_inv_ongrid_check、bat_heat_inv_state_check、bat_heat_low_vol_state_check、bat_charge_demand_check | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 加热故障判定（加热膜故障 / 电流电压异常 / 15 分钟不升温） | bat_heat_fault_check、bat_heat_vol_current_check、bat_heat_hardware_fault_check、bms_read_heat_fault_code、bms_read_over_temperature_code | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 加热故障退出与恢复（10 分钟后最多 3 次恢复） | bat_heat_fault_drop_out、bat_heat_fault_fsm_deal、bat_heat_into_fault_deal | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 无加热请求时的收尾（清指令、清故障、放开电池功率） | bat_heat_no_request_deal、get_bat_heat_forbid_power_flag | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| BMS 上报的加热请求 / 自加热能力 / 加热台数怎么预存 | handle_bat_heat_prestore_info、handle_bat_heat_soc_info、u8_bat_soc_low_flag | midware/bms/bms.c | ../../midware/bms/bms.c.md |
| 加热数据初始化（SOC 阈值 / 升温阈值 / 等待时间） | bat_heat_data_inti | midware/bms/bms.c | ../../midware/bms/bms.c.md |
18. BMS 电池：CAN 协议与下行指令
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| BMS CAN 上行帧解析入口（按 CAN ID 分派） | alpha_bms_package_parser | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| 电池 CAN 协议全部扩展帧 ID / 命令字宏表（寄存器映射） | BMS_ID_* 系列宏 | midware/bms/alpha/battery_comm.h | ../../midware/bms/alpha/battery_comm.h.md |
| CAN 标准帧 / 扩展帧发送与节流（1 tick 间隔） | can_send_standard_pack、can_send_exten_pack | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
CAN 握手应答（0x0CF200A0） | Battery_Ack | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| 电池重启 / 关机指令下发（区分 48V+GD32 与其它平台） | send_battery_restart_cmd、send_battery_shutdown_cmd | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| 电池周期配置 1 / 配置 2（绝缘故障码、SOC 显示上下限、电池电压、加热指令） | send_battery_set_code_1_cmd、send_battery_set_code_2_cmd、send_battery_cmd | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| 电池品牌 / 产地下发 | send_battery_set_brand_cmd | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
并机 SN 分包下发（每次 6 字节，0x18FFA2F4） | send_battery_set_code_c_cmd | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
电池自锁配置下行（0x18FFA2F5） | send_battery_set_code_d_cmd | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| EMS 统计电量同步给 BMS | send_battery_energy_cmd | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| 给 BMS 校时 | send_battery_set_real_time_cmd | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| 单台电池单体电压 / 温度极值解析（含采样点号） | get_single_cell_volt、get_single_cell_temper | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| 单台电池告警 / 保护 / 扩展保护码解析 | get_battery_alarm_code、get_battery_warning_code、get_battery_protection_extend1_code | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| 电池激活时间解析与合法性校验 | get_battery_activate_time | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| 云 BMS 单体电压 / 温度明细的分包组装 | get_single_cell_volt_info、get_single_cell_temper_info | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| 欧盟电池法自信息帧解析（容量吞吐 / 效率 / 循环 / 日期） | get_bms_self_info | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| 单体欠压保护 / 告警、电池通信丢失的位或汇总 | get_battery_cell_low_vol_protection、get_battery_cell_low_vol_warning、get_battery_comm_lost | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
| 单台最大充放电功率的型号修正 | alpha_bms_package_parser | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
电池日志查询（被 #if 0 关闭，不参与编译） | send_battery_query_log_cmd、bat_log_handle | midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md |
19. BMS 电池：CAN 固件升级
| 想找的功能（关键词 / 用户可能的问法） | 入口函数或符号 | 源文件 | 文档 |
|---|---|---|---|
| 电池 CAN 固件升级主状态机（谁驱动、几态） | households_batter_upgrade_handle | midware/bms/alpha/battery_upgrade.c | ../../midware/bms/alpha/battery_upgrade.c.md |
| 电池升级进度 / 已解析文件偏移 | GetPercentUpgradeBMS、Get_Idx_Updt_BMS_Loacl | midware/bms/alpha/battery_upgrade.c | ../../midware/bms/alpha/battery_upgrade.c.md |
| 电池进 Bootloader（区分 48V+GD32 与其它平台） | send_enter_boot_code | midware/bms/alpha/battery_upgrade.c | ../../midware/bms/alpha/battery_upgrade.c.md |
| 电池升级「烧写地址+长度」帧与「数据」帧 | send_addr_code、send_data_code | midware/bms/alpha/battery_upgrade.c | ../../midware/bms/alpha/battery_upgrade.c.md |
| 电池升级结束帧与 60 秒超时 | send_over_updata_code | midware/bms/alpha/battery_upgrade.c | ../../midware/bms/alpha/battery_upgrade.c.md |
| 电池升级固件是 S1 还是 S3 记录（文件类型判定） | check_bms_upgrade_file | midware/bms/alpha/battery_upgrade.c | ../../midware/bms/alpha/battery_upgrade.c.md |
| 电池升级 CAN 发送底层包装 | CAN_Send_Msg | midware/bms/alpha/battery_upgrade.c | ../../midware/bms/alpha/battery_upgrade.c.md |
| 电池升级对外接口只有哪三个（黑盒） | households_batter_upgrade_handle、GetPercentUpgradeBMS、Get_Idx_Updt_BMS_Loacl | midware/bms/alpha/battery_upgrade.h | ../../midware/bms/alpha/battery_upgrade.h.md |
文件清单核对
本范围共 28 个源文件，全部已在表中出现：
midware/meter（12）
| 源文件 | 文档 | 状态 |
|---|---|---|
midware/meter/meter.c | ../../midware/meter/meter.c.md | 已在表中出现（第 1~6、10 节） |
midware/meter/meter.h | ../../midware/meter/meter.h.md | 已在表中出现（第 1~6 节，配套头文件） |
midware/meter/ct.c | ../../midware/meter/ct.c.md | 已在表中出现（第 7 节） |
midware/meter/ct.h | ../../midware/meter/ct.h.md | 已在表中出现（第 7 节，配套头文件） |
midware/meter/backupbox.c | ../../midware/meter/backupbox.c.md | 已在表中出现（第 8 节） |
midware/meter/backupbox.h | ../../midware/meter/backupbox.h.md | 已在表中出现（第 8 节，配套头文件） |
midware/meter/bb_update.c | ../../midware/meter/bb_update.c.md | 已在表中出现（第 10 节） |
midware/meter/bb_update.h | ../../midware/meter/bb_update.h.md | 已在表中出现（第 10 节，配套头文件） |
midware/meter/diesel_generator.c | ../../midware/meter/diesel_generator.c.md | 已在表中出现（第 9 节） |
midware/meter/diesel_generator.h | ../../midware/meter/diesel_generator.h.md | 已在表中出现（第 9 节，配套头文件） |
midware/meter/meter_upgrade.c | ../../midware/meter/meter_upgrade.c.md | 已在表中出现（第 10 节） |
midware/meter/meter_upgrade.h | ../../midware/meter/meter_upgrade.h.md | 已在表中出现（第 10 节，配套头文件） |
midware/bms（6）
| 源文件 | 文档 | 状态 |
|---|---|---|
midware/bms/bms.c | ../../midware/bms/bms.c.md | 已在表中出现（第 16、17 节） |
midware/bms/bms.h | ../../midware/bms/bms.h.md | 已在表中出现（第 16 节，配套头文件） |
midware/bms/alpha/battery_comm.c | ../../midware/bms/alpha/battery_comm.c.md | 已在表中出现（第 18 节） |
midware/bms/alpha/battery_comm.h | ../../midware/bms/alpha/battery_comm.h.md | 已在表中出现（第 18 节，配套头文件） |
midware/bms/alpha/battery_upgrade.c | ../../midware/bms/alpha/battery_upgrade.c.md | 已在表中出现（第 19 节） |
midware/bms/alpha/battery_upgrade.h | ../../midware/bms/alpha/battery_upgrade.h.md | 已在表中出现（第 19 节，配套头文件） |
midware/evc（6）
| 源文件 | 文档 | 状态 |
|---|---|---|
midware/evc/evc.c | ../../midware/evc/evc.c.md | 已在表中出现（第 11 节） |
midware/evc/evc.h | ../../midware/evc/evc.h.md | 已在表中出现（第 11 节，配套头文件） |
midware/evc/evc_ii.c | ../../midware/evc/evc_ii.c.md | 已在表中出现（第 12 节） |
midware/evc/evc_ii.h | ../../midware/evc/evc_ii.h.md | 已在表中出现（第 12 节，配套头文件） |
midware/evc/evc_upgrade.c | ../../midware/evc/evc_upgrade.c.md | 已在表中出现（第 13 节） |
midware/evc/evc_upgrade.h | ../../midware/evc/evc_upgrade.h.md | 已在表中出现（第 13 节，配套头文件） |
midware/afci（4）
| 源文件 | 文档 | 状态 |
|---|---|---|
midware/afci/afci_comm.c | ../../midware/afci/afci_comm.c.md | 已在表中出现（第 14 节） |
midware/afci/afci_comm.h | ../../midware/afci/afci_comm.h.md | 已在表中出现（第 14 节，配套头文件） |
midware/afci/afci_upgrade.c | ../../midware/afci/afci_upgrade.c.md | 已在表中出现（第 15 节） |
midware/afci/afci_upgrade.h | ../../midware/afci/afci_upgrade.h.md | 已在表中出现（第 15 节，配套头文件） |
合计 12 + 6 + 6 + 4 = 28 个源文件，逐一覆盖。