SMA SUNNY WEBBOX RPC - Handbuch (Seite 12)

5 Schnittstellen SMA Solar Technology AG
12 SWebBoxRPC-BA-de-14 Bedienungsanleitung
5 Schnittstellen
Die Sunny WebBox stellt zwei unterschiedliche Zugriffsmöglichkeiten zur Verfügung, die sich durch
Implementierungsaufwand und Laufzeitressourcenverbrauch voneinander unterscheiden.
5.1 RPC über UDP-Stream
Der Prozeduraufruf wird im Nutzdatenteil des UDP-Protokolls auf Port 34268 an die Sunny WebBox
übertragen. Antworten werden ebenfalls an den Port 34268 gerichtet.
Der UDP-Transport erfordert einen relativ geringen Implementierungsaufwand auf der Client-Seite und
spart Laufzeitressourcen. Für die Kommunikation über die Grenzen lokaler Netzwerke hinweg ist in
der Regel eine Portfreischaltung in den entsprechenden Firewalls erforderlich.
5.2 RPC über HTTP
Der Datenaustausch findet über das Hypertext Transfer Protokoll per TCP/IP-Verbindung auf dem in
der Sunny WebBox konfigurierbaren Webserver-Port statt.
Die Voreinstellung ist Port 80.
Der URL für alle Anfragen lautet: http://IP-Adresse/rpc
IP-Adresse ist dabei die aktuell eingestellte IP-Adresse der Sunny WebBox. Die Voreinstellung
lautet 192.168.0.168.
Damit sieht der Default-URL folgendermaßen aus: http://192.168.0.168/rpc
Der Prozeduraufruf wird per HTTP POST im Rumpf der HTTP-Anfrage als serialisiertes
JSON-Objekt gemäß den in Kapitel 4.1 getroffenen Konventionen übertragen.
Sowohl der clientseitige Implementierungsaufwand, als auch der Ressourcenverbrauch sind relativ
hoch. Im Regelfall erfolgt die Kommunikation über den Standard-Port 80, so dass keine
Veränderungen an etwaigen Firewalls vorgenommen werden müssen.