beautypg.com

5 interfaces, 1 rpc via udp stream, 2 rpc via http – SMA SUNNY WEBBOX RPC User Manual

Page 11: 1 rpc via udp stream 5.2 rpc via http

background image

SMA Solar Technology AG

5  Interfaces

User Manual

SWebBoxRPC-BA-en-14

11

5 Interfaces

The Sunny WebBox provides two different access options which differ in the implementation effort
required and their runtime utilization of resources.

5.1 RPC via UDP Stream

The procedure call is transmitted to port 34268 of the Sunny WebBox in the usable data part of the
UDP protocol. Responses are also sent to port 34268.
UDP transport requires a relatively low implementation effort on the client side and saves runtime
resources. For communication beyond the limits of local networks, the port will normally need to be
opened by the appropriate firewalls.

5.2 RPC via HTTP

Data exchange takes place by means of the Hypertext Transfer Protocol via a TCP/IP connection to
the web server port configured in the Sunny WebBox.

The default setting is port 80.
The URL for all requests is: http://IP address/rpc
The IP address in each case is the currently configured IP address of the Sunny WebBox.
The default setting is 192.168.0.168.
Hence, the default URL is the following: http://192.168.0.168/rpc
The request is transmitted via HTTP POST in the body of the HTTP request as a serialized JSON
object according to the conventions established in Section 4.1.

Both the client-side implementation effort and the resource requirements are relatively high. As a
general rule, communication takes place via the standard port 80, which means that there is no need
to make any changes to active firewalls.