首页 / knowledge/故障速查
故障速查
用途：现场报故障时，从这里开始查。 需求号：REQ-001（K7）｜ 源码基准：
V0.11.676（git04e72700）｜ 建立日期：2026-10-15
一、文件怎么用
| 文件 | 什么时候看 |
|---|---|
现场排查SOP.md | ⭐ 先看这个。手上只有一台设备和一个报错，不知道怎么下手时 |
EMS故障分册.md | 报的是 E00xx（EMS 自己的故障），逐个查触发条件、对应函数、排查方向 |
故障码总表.md | 手上有任意一个故障码（E/W/P 开头），想先知道它属于哪个设备、叫什么 |
故障码表.tsv | 机器可读的全量表（336 条），给脚本/网站/飞书智能体用 |
工具/ | 重新提取故障码表的脚本（源码更新后重跑） |
二、最快的一条命令
在 docs/knowledge/代码解析/索引/ 目录下：
node 工具/查找.js -d 故障码 # 全文搜整个知识库
node 工具/查找.js -F 电池加热故障 # 功能 → 函数定位在 故障速查/ 目录下执行 node 工具/生成故障码表.js 可重新提取故障码表。
三、故障码的分区（先记这一条，能省一半时间）
码值本身就标明是谁报的：
| 码值区间 | 谁报的 |
|---|---|
E0001 ~ E0094 | EMS 主控自己判定的（最常见） |
E100000 起 / W110000 起 | 逆变器 |
E200000 起 | 充电桩 |
E60000 起 | BMS 电池（故障） |
W70000 起 | BMS 电池（告警） |
P75000 起 | BMS 电池（保护） |
全量 336 条见 故障码总表.md。
四、这个库覆盖什么、不覆盖什么
覆盖：固件里全部 336 个故障码的码值 ↔ 符号名 ↔ 所属设备（脚本从源码机械提取，可随时重新生成）； EMS 侧 30 个故障位的触发条件、置位函数、排查方向。
不覆盖（别在这里找）：
- LCD 界面上的故障名显示文字。界面代码
hmi/ui/共 77 个文件尚未纳入知识库（见../基准版本.md），
所以本库给的是代码里的符号名（如 EMS_FAULT_BMS_LOST），不是屏幕上显示的那句话。
如果你需要「屏幕上写的这句话对应哪个码」，那要等 K4 批次把界面文档补进来。
- 逆变器/BMS 各厂商私有故障码的详细含义。本库只给出主控怎么映射它们，
具体含义要看对应厂商协议文档。
五、维护规则
- 源码只读不改。
- 源码更新后必须重跑，否则故障码表会过期：
cd 工具 node 生成故障码表.js && node 渲染总表.js - 每次重新生成都要写入
docs/变更日志.md（需求号 REQ-001）。 - 本目录任何新增或修改都要留痕。