General information

The S2 radio system is used by many Boomerang 2 systems. The S2GW gateway enables an easy migration from B2 to B3 system where performs all the functions of S2 radio network handles in B2 and delivers the readings from the network to B3 server as POST messages.

More information about the S2 system can be found in T-S2 Radio System Manual.

The S2GW gateway is an SBC (Raspberry Pi or Banana Pi) board with an additional S2GW HAT board that provides a serial port used for communication with S2 PC Node. There is a dedicated S2GW application running under Linux that performs all the gateway functions.

S2GW gateway communicates with Boomerang 3 server over network.

One S2GW gateway can handle a single S2 radio network or a single S3 node.

An example infrastructure is shown below:

The S2GW gateway configuration is stored in nodeservers.xml file on SD card which can be edited if configuration needs to be modified as described in chapter Edit S2GW config.

Data are sent to B3 server in XML format via a POST. The B3 server needs to acknowledge the received POST by sending a POST back reply confirming the reception.

The S2GW gateway obtains the S2 radio network configuration from B3 server.

The server also informs S2GW about changes of parameters such as sensors’ log intervals or transmission paths. B3 server also provides UTC time and date.

Note that B3 server informs S2GW about configuration changes:

• immediately after the S2GW has sent POST to the server, sending the configuration in the confirmation,

• if S2GW has no measuring nodes or the measuring period is longer than 15 minutes then S2GW asks B3 for configuration every 15 minutes so changing the configuration in S2GW may take some time.

All messages sent from or to S2GW are stored in a log file on SD card. The communication can also be observed using UDPListen as described in UDP listen log contents.