> For the complete documentation index, see [llms.txt](https://help.boomerang3.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.boomerang3.com/s2gw-installation-manual/quick_installation/s2gw_setup/s2gw-configuration.md).

# 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](/s2gw-installation-manual/advanced_use/edit-s2gw-config.md).

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”.

![](/files/2ltfs6QoYfiLNLseIZnX)

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

![](/files/AfOFLHlYHvt0DWdzWLv8)

6. Open boot:\ICU folder in Explorer. There shall be only s2gw\_config.xml file there.

![](/files/ghgAf8zdc0aavvwK95wz)

7. 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.

<table><thead><tr><th width="208.33333333333331">Name</th><th width="409">Description</th><th>Default value</th></tr></thead><tbody><tr><td>NumberOfResends</td><td>Maximum number of trials to establish radio connection to the node. Do not change.</td><td>8</td></tr><tr><td>MinimalDelay</td><td>Minimal time delay between communication attempts in seconds. Do not change.</td><td>5</td></tr><tr><td>Factor</td><td>Coefficient used to calculate time delay between consecutive attempts. Do not change.</td><td>1.2</td></tr><tr><td>B3MacAddress</td><td><p>Gateway’s identifier that must be the same as the one entered in Boomerang 3 gateway settings.</p><p>If set to “default” then the physical S2GW MAC address is used.</p><p>Can be set manually if needed.</p><p>The format is <em>hh:hh:hh:hh:hh:hh</em> where h are hex digits from 0 to F..</p></td><td>default</td></tr><tr><td>URL</td><td><p>S2GW send the posts to this B3 webpage address. Enter API URL from gateway definition in B3.</p><p><strong>This is normally the only parameter that shall be set.</strong></p></td><td></td></tr><tr><td>UseProxy</td><td>true/false</td><td>false</td></tr><tr><td>ProxyServerAddress</td><td>Proxy server address, enter if “UseProxy” is set to “true”.</td><td></td></tr><tr><td>SettingsInterval</td><td>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.</td><td>15</td></tr></tbody></table>

## **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

<pre><code>&#x3C;?xml version="1.0" encoding="utf-8"?>
&#x3C;S2GWConfig>
        &#x3C;NumberOfResends>8&#x3C;/NumberOfResends>
        &#x3C;MinimalDelay>5&#x3C;/MinimalDelay>
        &#x3C;Factor>1.2&#x3C;/Factor>
        &#x3C;B3MacAddress><a data-footnote-ref href="#user-content-fn-1">default</a>&#x3C;/B3MacAddress>
        &#x3C;URL>https://www.boomerang3.com/Receiver/S2&#x3C;/URL>
        &#x3C;UseProxy>false&#x3C;/UseProxy>
        &#x3C;ProxyServerAddress>http:\\&#x3C;/ProxyServerAddress>
        &#x3C;SettingsInterval>15&#x3C;/SettingsInterval>
&#x3C;/S2GWConfig>
</code></pre>

### **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>
```

8. Save s2gw\_config.xml file.
9. Insert SD card into S2GW socket.
10. Check that S2GW is connected to S2 PC node and network.
11. Connect power to S2GW and S2 PC node.
12. S2GW shall boot up and start to operate.
13. 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.
14. Afterwards S2GW will start asking the S2 radio nodes for readings and post the measurements to B3.

[^1]:


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.boomerang3.com/s2gw-installation-manual/quick_installation/s2gw_setup/s2gw-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.