充电桩控制和配置
方案概述
充电桩作为逆变器的下属设备接入，以下接口均使用充电桩所属逆变器的 deviceSn；充电桩自身 SN 仅作为设备信息返回。
客户调用充电桩接口分为控制场景和配置场景：
| 场景 | 说明 | 接口 |
|---|---|---|
| 充电桩控制 | 1. 充电桩立即开始充电。 2. 指定充电桩充电模式。 3. 充电桩停止充电或退出当前模式。 | 下发充电模式、退出当前充电模式 |
| 充电桩配置 | 1. 保存预约充电计划， 2. 设置电流、功率和 EVC 限载时的充电桩行为。 | 设置预约充电时间组、设备配置下发 |
充电桩控制
客户在开始充电或切换充电模式前，需要先识别充电桩当前控制模式；停止或退出当前充电模式则无需区分控制模式。
| 充电桩控制模式 | 说明 | 可执行操作 |
|---|---|---|
| 逆变器控制 | 充电桩按当前充电模式或预约计划工作。 | 下发 FAST、GREEN、SCHEDULE。 |
| 独立运行 | EVC 限载（逆变器发生异常）时，充电桩工作模式配置为独立运行。 | 下发开始充电。 |
| 不区分控制模式 | 无需判断当前是逆变器控制还是独立运行，也无需判断是否正在充电。 | 下发停止或退出当前充电模式。 |
逆变器控制
在逆变器控制下传入 deviceSn 和 chargeMode 下发充电模式 。chargeMode可选择的充电模式如下表所示。
| 充电模式 | 说明 |
|---|---|
| FAST（快速/经济模式） | 充电桩以设定的最大充电功率输出。 |
| GREEN（绿色充电模式） | 该模式的主要目的为：最大化使用光伏所发电量进行充电。 1. 若因系统设置电池处于强制放电状态，充电桩则尽量以最大功率消耗光伏及电池的能量。 2. 通常情况下，若系统中电池放电或电网取电，充电桩则以最小充电功率进行充电。 |
| SCHEDULE (预约充电模式) | 按已保存且启用的预约时间组执行 FAST 或 GREEN充电模式。 |
充电进行中不能直接切换 FAST、GREEN 或 SCHEDULE。请先调用 退出当前充电模式，确认退出成功后，再下发新的充电模式。
独立运行
当逆变器异常并触发 EVC 限载时，且已为该异常场景预先设置为独立运行模式及充电功率，可调用 开始充电进行充电。
该模式为兜底方案，不能选择充电模式。
EVC 限载（逆变器异常）时，充电桩设置为独立运行模式，电能仅来源于电网，按设定的功率充电。
停止或退出当前充电模式
在以下场景调用 退出当前充电模式：
- 需要停止正在进行的充电。
- 需要退出预约充电模式。
- 需要从 FAST、GREEN 或 SCHEDULE 切换到另一种充电模式。
退出预约模式不会清空已保存的预约时间组。后续重新选择 SCHEDULE 时，仍可使用已保存的时间组。
控制接口错误码
| 接口 | 错误码 | 触发场景 | 客户处理方式 |
|---|---|---|---|
| 下发充电模式 | error.47101 | 当前充电桩处于独立运行模式，不能下发 FAST、GREEN 或 SCHEDULE。 | 确认设备是否处于 EVC 限载；异常恢复后再下发充电模式。 |
| 下发充电模式 | error.47102 | 当前充电桩状态为非待机状态，不允许切换充电模式。 | 确认充电桩处于待机后重试。 |
| 下发充电模式 | error.47103 | 充电桩正在充电，不能直接切换充电模式。 | 先调用退出当前充电模式，确认成功后再下发新模式。 |
| 下发充电模式 | error.47104 | chargeMode 参数不是 FAST、GREEN 或 SCHEDULE。 | 检查充电模式参数后重新提交。 |
| EVC 限载时开始充电 | error.47701 | 当前未处于 EVC 限载下的独立运行模式。 | 确认设备已触发 EVC 限载，且已配置独立运行策略。 |
| EVC 限载时开始充电 | error.47702 | 当前充电桩状态为非待机状态，不允许切换充电模式。 | 确认充电桩处于待机后重试。 |
| EVC 限载时开始充电 | error.47703 | 充电桩当前已在充电。 | 无需再次发起开始充电；如需停止，调用退出当前充电模式。 |
| EV Charge 接口 | error.47311 | 目标逆变器未接入充电桩。 | 确认 deviceSn 是充电桩所属逆变器，检查设备接线与接入状态。 |
| 控制类接口 | error.70006 | 设备或充电桩离线。 | 恢复通讯后重新读取状态，再执行控制。 |
| 控制类接口 | error.70007 | 调用账户没有设备操作权限。 | 检查 Token 所属账户是否已获得该逆变器授权。 |
| 查询异步控制结果 | error.42003 | recordId 不存在。 | 确认使用的是本次下发接口返回的 recordId。 |
充电桩配置
配置场景用于保存后续生效的充电计划和参数。
预约时间组
预约时间组用于定义 SCHEDULE 模式下的自动充电时段和充电方式。设置时间组不会自动切换到 SCHEDULE，正确流程如下：
- 调用 设置预约充电时间组，保存时间组 1 和时间组 2。
- 需要执行预约计划时，调用 下发充电模式，将 chargeMode 设置为 SCHEDULE。
- 使用返回的 recordId 调用 查询异步控制结果，确认时间组已保存。
仅开放时间组 1、2。每次设置必须同时提交两组，按 timeGroupId 升序传入，不能遗漏或重复。
| 字段 | 必填条件 | 说明 |
|---|---|---|
| timeGroupId | 必填 | 时间组标识，仅支持 1 和 2。 |
| enable | 必填 | 0 禁用；1 启用。 |
| startTime | 启用时必填 | 开始时间，格式 HH:mm。 |
| endTime | 启用时必填 | 结束时间，格式 HH:mm；早于开始时间表示跨天。 |
| chargeMode | 启用时必填 | 时间组内的充电方式，仅支持 FAST 或 GREEN。 |
预约规则：
- 启用时间组时，开始时间、结束时间和充电模式必须同时传入。
- 禁用时间组可只传 timeGroupId 和 enable=0；如传入任一时间或模式字段，三个字段必须同时传入。
- 开始时间和结束时间不能相同，22:00-06:00 表示跨天时段。
- 参与本次校验的时间组按跨天规则展开后不能重叠。
- 时间组设置不受当前充电状态限制，但只会在选择 SCHEDULE 后按计划执行。
使用 查询预约充电时间组 可读取设备当前保存的两组配置。禁用的时间组也会返回已保存的时间和模式，便于页面回显和重新启用。
充电桩配置参数
充电桩配置参数通过通用 设备配置下发 保存，未提交的配置项保持设备当前值。
EVC 限载独立运行适用条件
设置 EVC 限载时的独立运行模式及充电功率前，需要确认逆变器机型和固件版本满足以下条件：
| 机型 | 支持固件版本 |
|---|---|
| MHS 3-8K | V1-0623-0000 |
| MHT 4-20K | V1-0623-0000 |
| MHT 25-50K | V1-0623-0000 |
| M2HS 3-6K | V1-0600-0000 |
| M2HT 25-50K | V1-0600-0000 |
| M2HT 5-10K | 无需判断固件版本 |
| M2HT 10-30K | 无需判断固件版本 |
| M2HT-30K-120-AC | 无需判断固件版本 |
| M2HT-125K-300 | 无需判断固件版本 |
| 参数 | 解释 | 取值范围 | 单位 |
|---|---|---|---|
| chargerMainBreakerCurrentLimit | 主断路器电流限值 | [6, 1000] | A |
| chargerMaxPower | 最大充电功率限制 | 根据充电桩设备型号判断 chargerDeviceType ECA-S07K-BS0：[1.4, 7.0] ECA-S11K-BS0：[4.2, 11.0] ECA-S22K-BS0：[4.2, 22.0] | kW |
| chargerIndependentPower | EVC 限载时独立运行功率 | [最小充电功率, 额定充电功率] | kW |
| chargerInverterAbnormalStrategy | EVC 限载时充电桩运行策略 | 0 独立运行；1 逆变器控制运行 | - |
以上参数通过 sendSettingItemList 提交，value 均使用字符串传参；同一次下发可包含多个参数，未传入的配置项保持设备当前值。
配置下发后，使用 查询配置下发结果 查询各配置项是否执行成功。
配置接口错误码
预约时间组
| 错误码 | 触发场景 | 客户处理方式 |
|---|---|---|
| error.47301 | 时间组配置不完整，例如缺少时间组 1 或 2，或启用时间组缺少开始时间、结束时间或充电模式。 | 每次同时提交时间组 1、2；启用时间组需完整填写三个字段。 |
| error.47302 | 时间组 1 开始时间无效。 | 检查时间是否为 HH:mm，且开始时间不等于结束时间。 |
| error.47308 | 时间组 1 结束时间无效。 | 检查时间是否为 HH:mm，且结束时间不等于开始时间。 |
| error.47309 | 时间组 2 开始时间无效。 | 检查时间是否为 HH:mm，且开始时间不等于结束时间。 |
| error.47310 | 时间组 2 结束时间无效。 | 检查时间是否为 HH:mm，且结束时间不等于开始时间。 |
| error.47303 | 时间组重叠。 | 按跨天规则展开两个时间组后，调整为不重叠时段。 |
| error.47304 | 时间组充电模式无效。 | chargeMode 仅可填写 FAST 或 GREEN。 |
| error.47306 | timeGroupId 无效。 | 仅使用时间组 1 和 2。 |
| error.47307 | timeGroupId 重复。 | 时间组 1、2 各提交一次。 |
| error.47312 | enable 取值无效。 | enable 仅可填写 0 或 1。 |
| error.47313 | 禁用时间组传入了部分可选字段。 | 禁用时只传 timeGroupId 和 enable，或同时传入开始时间、结束时间和充电模式。 |
| error.47311 | 目标逆变器未接入充电桩。 | 确认 deviceSn 是充电桩所属逆变器，检查设备接线与接入状态。 |
| error.70006 | 设备或充电桩离线。 | 恢复通讯后重新提交配置。 |
| error.70007 | 调用账户没有设备操作权限。 | 检查 Token 所属账户是否已获得该逆变器授权。 |
状态、告警与充电记录
充电桩的配置数据随父级逆变器配置数据返回，运行数据随父级逆变器实时、历史或 MQTT 数据返回。字段定义分别参见 逆变器配置数据 和 逆变器遥测数据。
OpenAPI 返回运行采样点，不直接生成充电会话。调用方可按以下口径形成充电记录：
- 按父级逆变器 deviceSn 和 chargerChargeCount 归集同一次充电的数据。
- 首次观察到该计数时，chargerStartMethod=0 不创建记录；其他值可创建待完成记录。
- 持续使用 eChargerSession 更新本次充电量。
- 当 chargerEndReason 为 1、2、4、5、6、7 或 8 时，将该数据包时间作为结束时间，并将该数据包的 eChargerSession 作为最终充电量。
- 未收到有效结束数据前，不应把充电记录标记为已结束。数据中断时可通过历史遥测数据补齐采样点。
告警编码及处理建议参见 告警编码列表。