set_device_parameter
Set a Virtual Power Plant (VPP) parameter on a Growatt device to adjust inverter settings like discharge cut-off SOC or time schedules, enabling remote control of solar installation behavior via the ShineServer API.
Instructions
Write a VPP (Virtual Power Plant) parameter on a device. Changes state on Growatt's side.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"device_sn": "<device_sn>",
"device_type": "<device_type>",
"set_type": "<set_type>",
"value": "<value>"
},
"name": "set_device_parameter"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | Yes | Parameter value. Time schedules take a JSON array such as [{"percentage":0,"startTime":120,"endTime":179}]. | |
| plant_id | No | Plant ID, as returned by get_plants. Empty means all plants. | |
| set_type | Yes | VPP parameter name, e.g. "set_param_1" or "set_param_23" (discharge cut-off SOC). | |
| device_sn | Yes | Device serial number. | |
| device_type | Yes | Device type such as "min", "sph", "spa", "max", "inv", "wit", "tlx". get_devices returns it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |