S2GW configuration

The gateway functions are performed by S2GW application running under Linux.

The application must know the Boomerang server address it shall communicate with.

To define it, it is necessary to edit a text file on the SD card installed in S2GW. It can be done as described below, with SD card placed in a card reader or remotelyas described in Edit S2GW config.

1. Disconnect power from S2GW.

2. Remove the SD card from S2GW.

3. Connect the SD card to a card reader.

4. There are 2 partitions on the SD card and only one of them is readable by Windows. Windows will propose to format the other one, do not do it and click “Cancel”.

1. Look for “boot” partition (drive K: in example). Please note that the drive letter may be different in your case.

1. Open boot:\ICU folder in Explorer. There shall be only s2gw_config.xml file there.

1. Open s2gw_config.xml file with text editor (e.g. Notepad).

<?xml version="1.0" encoding="utf-8"?>
<S2GWConfig>
        <NumberOfResends>8</NumberOfResends>
        <MinimalDelay>5</MinimalDelay>
        <Factor>1.2</Factor>
        <B3MacAddress>default</B3MacAddress>
        <URL>http://192.168.61.156:80/Receiver/S2</URL>
        <UseProxy>false</UseProxy>
        <ProxyServerAddress>http:\\</ProxyServerAddress>
        <SettingsInterval>15</SettingsInterval>
</S2GWConfig>

There are the following parameters defining the operation of S2GW.

Name	Description	Default value
NumberOfResends	Maximum number of trials to establish radio connection to the node. Do not change.	8
MinimalDelay	Minimal time delay between communication attempts in seconds. Do not change.	5
Factor	Coefficient used to calculate time delay between consecutive attempts. Do not change.	1.2
B3MacAddress	Gateway’s identifier that must be the same as the one entered in Boomerang 3 gateway settings. If set to “default” then the physical S2GW MAC address is used. Can be set manually if needed. The format is hh:hh:hh:hh:hh:hh where h are hex digits from 0 to F..	default
URL	S2GW send the posts to this B3 webpage address. Enter API URL from gateway definition in B3. This is normally the only parameter that shall be set.
UseProxy	true/false	false
ProxyServerAddress	Proxy server address, enter if “UseProxy” is set to “true”.
SettingsInterval	This value is the interval, S2GW uses, when it asks B3 server to refresh the radio configuration. The value is given in minutes. B3 from its side, informs S2GW about any change in the radio config, which initiates configuration refresh in S2GW. This method is used as an additional precaution to keep the S2GW settings up to date.	15

Examples of config files

Recommended method when physical S2GW MAC is used

B3 server address (URL) is https://www.boomerang3.com/

The physical S2 gateway MAC address is used in B3

<?xml version="1.0" encoding="utf-8"?>
<S2GWConfig>
        <NumberOfResends>8</NumberOfResends>
        <MinimalDelay>5</MinimalDelay>
        <Factor>1.2</Factor>
        <B3MacAddress>default</B3MacAddress>
        <URL>https://www.boomerang3.com/Receiver/S2</URL>
        <UseProxy>false</UseProxy>
        <ProxyServerAddress>http:\\</ProxyServerAddress>
        <SettingsInterval>15</SettingsInterval>
</S2GWConfig>

When S2GW MAC is defined manually

B3 server address (URL) is https://www.boomerang3.com/

S2GW MAC address is set in B3 as 11:11:11:11:11:15

<?xml version="1.0" encoding="utf-8"?>
<S2GWConfig>
        <NumberOfResends>8</NumberOfResends>
        <MinimalDelay>5</MinimalDelay>
        <Factor>1.2</Factor>
        <B3MacAddress>11:11:11:11:11:15</B3MacAddress>
        <URL>https://www.boomerang3.com/Receiver/S2</URL>
        <UseProxy>false</UseProxy>
        <ProxyServerAddress>http:\\</ProxyServerAddress>
        <SettingsInterval>15</SettingsInterval>
</S2GWConfig>

1. Save s2gw_config.xml file.

2. Insert SD card into S2GW socket.

3. Check that S2GW is connected to S2 PC node and network.

4. Connect power to S2GW and S2 PC node.

5. S2GW shall boot up and start to operate.

6. After the gateway and its measuring points are defined in B3, the gateway will read the S2 radio network configuration from B3. The radio network configuration in S2GW will also be updated in case of any changes in B3. The update delay may be as long as SettingsInterval parameter if the gateway sends readings less frequently. You may power cycle or reboot the gateway to enforce the configuration update.

7. Afterwards S2GW will start asking the S2 radio nodes for readings and post the measurements to B3.