87 lines
3.4 KiB
Markdown
87 lines
3.4 KiB
Markdown
# flowctrl 模块说明
|
||
|
||
> 路径：`app/flowctrl/`
|
||
> 返回主说明：[README](../../README.md)
|
||
|
||
## 1. 模块职责
|
||
|
||
- 实现充电流程控制主逻辑与状态机；
|
||
- 提供流程对外数据接口与控制接口；
|
||
- 处理流程关键保护与异常停机条件。
|
||
|
||
## 2. 关键文件
|
||
|
||
- `flowctrl_task.c/h`
|
||
- `flow_interface.c/h`
|
||
- `insulation_ctrl.c/h`
|
||
- `mdu_swh_ctrl.c/h`
|
||
|
||
## 3. 功能说明
|
||
|
||
- 管理充电开始、运行、停止、故障等流程状态切换；
|
||
- 对接故障模块、BMS、计量模块及外部控制命令；
|
||
- 对外提供流程运行数据和控制入口，供 UI/TCP 等模块调用。
|
||
|
||
## 4. 调度与对外接口
|
||
|
||
该模块由 FreeRTOS 任务 `FlowCtrl` 周期运行（单位：ms），周期来自 `app/app_init/app_init.c`：
|
||
|
||
- `FlowCtrl`：`20ms`（任务入口：`v_flowctrl_task(void *arg)`）
|
||
|
||
对外接口（来自 `flowctrl_task.h`）：
|
||
|
||
- `void v_flowctrl_task_init(void)`：初始化流程状态机/内部缓存
|
||
- `void v_flowctrl_task(void *arg)`：流程控制任务入口
|
||
- `U8_T u8_flowctrl_get_gun_num(void)`：返回枪数量（供上层界面/通信使用）
|
||
|
||
## 5. 维护建议
|
||
|
||
- 流程状态跳转新增分支时需同步检查故障与恢复路径；
|
||
- 对外接口字段建议统一经 `flow_interface` 暴露，减少模块耦合。
|
||
|
||
## 6. 绝缘检查步骤（详细）
|
||
|
||
绝缘检查主流程由 `flowctrl_task.c` 状态机调度，核心计算在 `insulation_ctrl.c`：
|
||
|
||
- 状态入口：`E_FLOW_INSUL_BEFORE`（`v_flow_ctrl_insul_before`）
|
||
- 条件：模块进入工作态，且绝缘电压到位（或欧标 15s 跳过电压到位检查）；
|
||
- 动作：切到 `E_FLOW_INSUL_RUNING`，调用 `v_flow_gun_insulation_data_ctrl(gun,0)` 开始绝缘检测资源控制；
|
||
- 典型日志：`INS V ok...` 或 `15s skip V chk...`。
|
||
|
||
- 检测执行：`E_FLOW_INSUL_RUNING`（`v_flow_ctrl_insul_runing`）
|
||
- 调用：`s8_flow_gun_insulation()` -> `s8_insulation_action()` -> `v_insulation_Calculate()`；
|
||
- 返回：`-1` 检测中，`0` 失败，`1` 正常，`2` 告警；
|
||
- 完成后记录 `u32_insul_Rx/Ry` 与 `u8_insul_ret`，并切到 `E_FLOW_INSUL_OK`；
|
||
- 典型日志：`INS res=%d(0F,1OK,2WARN), R+=..., R-=...`。
|
||
|
||
- 结果收尾：`E_FLOW_INSUL_OK`（`v_flow_ctrl_insul_ok`）
|
||
- 先等待模块停机/母线下降并执行泄放；
|
||
- 再根据 `u8_insul_ret` 判定：
|
||
- `0`：失败，停机故障 `E_FAULT_13042`（绝缘检测失败）；
|
||
- `2`：告警，置 `E_FAULT_13043`（绝缘告警）后允许继续；
|
||
- `1`：通过，进入后续预充/充电流程。
|
||
|
||
`insulation_ctrl.c` 内部两阶段计算要点：
|
||
|
||
- 阶段1（大地继电器闭合后）：
|
||
- 采样 `U+gnd` 与 `U-gnd`；
|
||
- 计算单侧绝缘电阻粗判，若小于阈值直接失败（结果码2）；
|
||
- 阈值规则：`R_min = 100 * (U+gnd + U-gnd)`，`R_max = 500 * (U+gnd + U-gnd)`。
|
||
|
||
- 阶段2（光耦继电器闭合后）：
|
||
- 二次采样并按公式计算 `R+gnd`、`R-gnd`；
|
||
- 判定规则：
|
||
- 任一 `< R_min` => 失败（结果码3）；
|
||
- 任一 `<= R_max` => 告警（结果码4）；
|
||
- 否则 => 正常（结果码5）。
|
||
|
||
调试建议（结合日志）：
|
||
|
||
- 先看 `Th: min/max` 是否与当时 `U+gnd + U-gnd` 一致；
|
||
- 再看 `R+gnd/R-gnd` 是否显著低于 `R_min`（会触发 `13042`）；
|
||
- 若经常走 `15s skip V chk`，优先排查模块电压到位与采样链路。
|
||
|
||
## 7. 关联文档
|
||
|
||
- 主索引：[README](../../README.md)
|