ToU模式时间组设置
在ToU模式下，客户可以将一天内的控制计划提前下发到逆变器，逆变器会在时间段内按照计划进行工作。
- 逆变器支持存储存储今日和明日的工作计划，并始终按照这两组计划进行循环往复的工作。比如说您需要设备每天都按照一个相同的计划工作，您需要同时下发今日和明日两组计划。（48组 / 196组）。
- 一组计划（今日 或者 明日）至少支持24组控制命令，新款机器及配套固件下可以支持到96组。
- 当设置了ToU模式，未设置任何计划时，逆变器默认以通用模式进行工作。
- 一组计划中，控制命令之间最好不要出现时间段重叠的情况。如果出现，逆变器会执行先设置的命令。
- 由于下发的控制参数较多，下发的时间耗时会比通常的参数配置多。针对R2MD-DuoCom，通常花费5-10秒左右。老款的DuoCom可能会更长一些。
- 请始终保证下发满所有的时间组插槽，即始终覆盖设备上的配置。如果其它槽位没有配置，请将使能位标记为0并下发。
时间组设置
参数说明
| 字段 | 名称 | 有效值 |
|---|---|---|
| planId | 今日计划 Or 明日计划 | 1: 今日计划, 2: 明日计划 |
| timeGroupId | 时间组ID | 0-23 / 0-95 |
| timeGroupEnableFlag | ToU时间组使能标志 | 0: 禁用, 1: 使能 |
| startTime | 开始时间(hh:mm) | 00:00~23:59 |
| endTime | 结束时间(hh:mm) | 00:00~23:59 |
| workMode | 工作模式 | 参考下方“工作模式说明” |
| parameters | 时间组配置参数 | 参考下方“时间组配置参数说明” |
工作模式说明
| 工作模式编码 | 模式名称 | 解释 |
|---|---|---|
| 4#1 | General mode/通用模式 | |
| 4#2 | Battery charge/电池充电 | PV + Grid |
| 4#3 | PV charging/光伏充电 | 仅 PV |
| 4#5 | Feed-in mode/优先上网 | |
| 4#6 | Battery discharge/电池放电 |
时间组配置参数说明
| 字段 | 名称 | 有效值 | 解释 |
|---|---|---|---|
| exportLimit | 上行功率 | [-1 * 系统额定功率， 5 * 系统额定功率] | 上行到电网的功率不能大于该值 |
| chargeLimit | 充电功率限值 | 单机 [0, 1000]; 主机 [0, 5000] | 电池的充电功率不能大于该值 |
| chargeCutoffSoc | 充电截止SOC | [100, 1000] | 电池充电至该SOC值后，停止从电网取电充电，但是PV可以继续给电池充电 |
| noPv | PV发电 | 0：允许PV发电；1：禁止PV发电 | 当设置成1，Pv将无功率输出，电池将全部使用电网的电来进行充电 |
| inverterOutputLimit | 逆变器输出控制 | 单机 [0, 1000]; 主机 [0, 5000] | AC口的最大输出功率不能大于该值 |
| dischargeCutoffSOC | 电池放电截止SOC | [100, 1000] | 电池放电至该SOC值后，停止向电网放电，但是电池可以继续给负载供电 |
各工作模式下有效参数
| 4#1 | 4#2 | 4#3 | 4#5 | 4#6 | |
|---|---|---|---|---|---|
| exportLimit | ✅ | ✅ | ✅ | ✅ | ✅ |
| chargeLimit | ✅ | ✅ | |||
| chargeCutoffSoc | ✅ | ✅ | |||
| noPv | ✅ | ||||
| inverterOutputLimit | ✅ | ||||
| dischargeCutoffSOC | ✅ |
接口调用
curl -X POST https://lb.solinteg-cloud.com/openapi/v2/tou/cmd/send/A11240020184005A \
-H "Content-Type: application/json" \
-H "Token: {{TOKEN}}" \
-d '{
"touTimeGroups": [
{
"planId": 1,
"startTime": "00:00",
"timeGroupEnableFlag": 1,
"timeGroupId": 0,
"workMode": "4#1",
"endTime": "01:00",
"parameters": {
"exportLimit": 1
}
},
{
"planId": 1,
"startTime": "01:00",
"timeGroupEnableFlag": 1,
"timeGroupId": 1,
"workMode": "4#2",
"endTime": "02:00",
"parameters": {
"exportLimit": 1,
"chargeLimit": 2,
"chargeCutoffSOC": 80,
"noPv": 1
}
},
{
"planId": 1,
"startTime": "02:00",
"timeGroupEnableFlag": 1,
"timeGroupId": 2,
"workMode": "4#3",
"endTime": "03:00",
"parameters": {
"exportLimit": 1,
"chargeLimit": 2,
"chargeCutoffSOC": 80
}
},
{
"planId": 1,
"startTime": "03:00",
"timeGroupEnableFlag": 1,
"timeGroupId": 3,
"workMode": "4#5",
"endTime": "04:00",
"parameters": {
"exportLimit": 1
}
},
{
"planId": 1,
"startTime": "04:00",
"timeGroupEnableFlag": 1,
"timeGroupId": 4,
"workMode": "4#6",
"endTime": "05:00",
"parameters": {
"exportLimit": 1,
"inverterOutputLimit": 2,
"dischargeCutoffSOC": 40
}
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 5
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 6
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 7
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 8
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 9
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 10
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 11
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 12
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 13
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 14
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 15
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 16
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 17
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 18
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 19
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 20
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 21
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 22
},
{
"planId": 1,
"timeGroupEnableFlag": 0,
"timeGroupId": 23
}
]
}'
正常响应
返回任务ID, 后续可通过任务ID异步查询执行结果
{
"errorCode": 0,
"info": null,
"body": "ToU_CMD_OPENAPI_7e947d77-bce6-4e43-9002-406790d05fa9",
"successful": true
}
异常响应 ①：设备离线
{
"errorCode": 1,
"info": {
"code": "error.70006",
"description": "Device not online"
},
"body": null,
"successful": false
}
异常响应 ②：无操作权限
{
"errorCode": 1,
"info": {
"code": "You do not have permission for this device.",
"description": "You do not have permission for this device."
},
"body": null,
"successful": false
}
查询时间组下发进度/结果
根据下发时，接口范围的任务ID进行下发结果查询
请求
curl -X GET https://lb.solinteg-cloud.com/openapi/v2/tou/cmd/status/ToU_CMD_OPENAPI_fe83d864-eb50-4460-a5f8-3421d34d5795 \
-H "Content-Type: application/json" \
-H "Token: {{TOKEN}}" \
正常响应①
{
"errorCode": 0,
"info": null,
"body": "SUCCESS",
"successful": true
}
正常响应②
{
"errorCode": 0,
"info": null,
"body": "FAILED",
"successful": true
}
正常响应③
{
"errorCode": 0,
"info": null,
"body": "SETTING",
"successful": true
}