SMA SUNNY WEBBOX RPC - Handbuch (Seite 32)

7 Service-Prozeduren SMA Solar Technology AG
32 SWebBoxRPC-BA-de-14 Bedienungsanleitung
7.7 RPC_SET_PARAMETER
7.7.1 Version 1.0
Setzt Parameterwerte von bis zu 5 Geräten und liefert die im Request übergebene Geräteliste mit den
zugehörigen aktuellen Parameterwerten zurück. Eine Überprüfung, ob jeder Parameterwert
erfolgreich gesetzt werden konnte, ist von der aufrufenden Anwendung vorzunehmen.
Aufbau
RPC={
"version": "1.0",
"proc": "SetParameter",
"id": "ID",
"format": "FORMAT",
"passwd": "PASSWORT",
"params":
{
"DEVICES":
[
{
key,
"channels": [CHANNELS]
}
]
}
}
Als Parameter ist eine Liste mit den Geräteobjekten zu übergeben, deren Pa-rameterwerte geändert
werden sollen. Jedes Geräteobjekt beinhaltet eine Liste mit den Parametern die zu setzen sind.
Das Setzen der Parameter erfolgt synchron. Somit sind die Antwortzeiten von der Anzahl der zu
setzenden Parameter abhängig. Für das nachfolgende Beispiel liegt die Antwortzeit bei
ca. 10 Sekunden.
PASSWORT: Der MD5-kodierte Hashwert des Passwortes für den gewünschten Zugriffslevel.
DEVICES: Ein Array, welches Objekte mit den Geräteschlüsseln der Geräte enthält, sowie ein
Array mit den CHANNELS deren Parameterwerte gesetzt werden sollen.
DEVICE_KEY: Der zugehörige Geräteschlüssel (siehe Kapitel 6.1 „Device-Objekt“, Seite 13).