ToU Mode
ToU 模式详解
运行规则
- 当设置逆变器的工作模式为ToU模式，但未设置任何时间组时，逆变器按照通用模式运行，上行功率以外部参数(逆变器配置-功率控制-上行功率)为准。
- 若设置了时间组，该时间组内以ToU子模式中设置的上行功率运行；未设置的时间段仍按照通用模式运行，上行功率以外部参数(逆变器配置-功率控制-上行功率)为准。
- 当两组时间存在重叠或完全包含时，重叠时段以开始时间较早的设置运行（即先设置的先生效）。建议避免下发重叠的时间组。
- 当ToU模式中设置了上行功率（
exportLimit）后，外部的防逆流设置不再生效；但当外部防逆流开启时，输出控制（软控/硬控）仍然生效。
工作模式（workMode）
格式为高八位#低八位：
| 模式 | 说明 |
|---|---|
| 4#1 | General Mode / 通用模式 |
| 4#2 | Battery Force Charge / 电池强充 |
| 4#3 | Battery Charge / 电池充电 |
| 4#5 | Feed-in Priority / 优先上网 |
| 4#6 | Battery discharge / 电池放电 |
时间组字段
一天共24组（1小时级别,15分钟级别为96组）时间组（timeGroupId：0~23/95），日期通过planId区分：
| 字段 | 解释 | 可选项/取值范围 |
|---|---|---|
| planId | ToU计划ID | 1：今日 2：明日 |
| timeGroupId | ToU时间组ID，共24组 | 0~23/95 |
| timeGroupEnableFlag | 时间组使能标志 | 0：关闭 1：开启 |
| startTime | 开始时间 | 00:00~23:59 |
| endTime | 结束时间 | 00:00~23:59 |
| workMode | 工作模式 | 见「工作模式」 |
| parameters | 子模式参数 | 见「子模式参数」 |
子模式参数（parameters）
备注
参数的换算（增益）由OpenAPI统一处理；工作模式与参数无法对应时，不对应的参数将被直接过滤。
| 参数 | 解释 | 取值范围 | 单位 |
|---|---|---|---|
| exportLimit | 上行功率 | [-1 × 系统额定功率, 5 × 系统额定功率] | kW |
| chargeLimit | 充电功率限值 | 单机 [0, 1000] 主机 [0, 5000] | kW |
| chargeCutoffSoc | 充电截止SOC | [100, 1000] | % |
| noPv | PV发电 | 0：允许PV发电 1：禁止PV发电 | - |
| inverterOutputLimit | 逆变器输出控制 | 单机 [0, 1000] 主机 [0, 5500] | kW |
| dischargeCutoffSOC | 电池放电截止SOC | [100, 1000] | % |
不同工作模式下可设置的参数如下：
| 参数 | 通用模式 4#1 | 电池强充 4#2 | 电池充电 4#3 | 优先上网 4#5 | 电池放电 4#6 |
|---|---|---|---|---|---|
| exportLimit | ✓ | ✓ | ✓ | ✓ | ✓ |
| chargeLimit | - | ✓ | ✓ | - | - |
| chargeCutoffSoc | - | ✓ | ✓ | - | - |
| noPv | - | ✓ | - | - | - |
| inverterOutputLimit | - | - | - | - | ✓ |
| dischargeCutoffSOC | - | - | - | - | ✓ |
下发规则
- 下发工作计划为异步接口：下发成功后返回
recordId，需通过recordId查询执行结果。 - ToU时间组需要一次性下发24/96组（一天的计划），并始终覆盖设备上的已有配置；未使用的槽位请将使能标志（
timeGroupEnableFlag）置为0一并发送。 - 时间组有今日/明日的概念：如果需要设备持续按照某组ToU模式工作，请同时下发两日的数据（共48/192组）。设备端会在跨天时自动将明日计划放到今日执行，不停循环。
- 通过Solinteg云平台（监控平台/OpenAPI平台）下发的时间组会缓存至云端。
- 下发时长与通讯棒版本有关：一代通讯棒(Duocom)约1分钟，二代通讯棒（R2MD）约5秒。建议配合R2MD来使用ToU相关功能。
- 下发超时（设备长时间未响应）的任务将被置为失败，可通过结果查询接口获取。
读取当前配置说明
注意
仅二代通讯棒会上报并支持读取逆变器上的ToU配置，一代通讯棒不支持。因此通过OpenAPI读取配置时，统一返回云端缓存的配置。
一代通讯棒的用户请注意：此时云端配置不可靠，不能真实反映设备的ToU配置。
- 若从未通过监控/OpenAPI设置过ToU，查询结果为空数组。
- 所有接口均需鉴权，且当前用户需拥有该设备的操作权限，否则将返回无权限错误。
相关接口
| 接口 | 说明 |
|---|---|
POST /tou/cmd/send/{deviceSn} | 下发逆变器工作计划，返回recordId |
GET /tou/cmd/status/{taskId} | 根据recordId查询下发结果：SUCCESS（成功）/ SETTING（处理中）/ FAILED（失败） |
GET /tou/query/{deviceSn} | 读取设备当前的ToU时间组（48/192组） |