> For the complete documentation index, see [llms.txt](https://freegrow-1.gitbook.io/product-docs-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://freegrow-1.gitbook.io/product-docs-en/en-creator-kit-q1/uwb-creator-kit-q1-complete-setup-and-usage-guide/installation-guide/gateway-setup-and-data-monitoring-optional.md).

# Gateway Setup and Data Monitoring (Optional)

{% hint style="danger" %}
This guide is for Gateway-based system configuration.
\
If you're using the Creator Kit Q1 and have set up a Listener-based test environment, please refer to the[ Listener manual](https://freegrow-1.gitbook.io/product-docs-en/en-creator-kit-q1/uwb-creator-kit-q1-complete-setup-and-usage-guide/installation-guide/listener-setup-and-data-check-optional) as well.
{% endhint %}

### In this guide

We explain how to set up the GrowSpace UWB Gateway to collect data from tags and anchors, and how to connect it to a server or cloud using MQTT.\
If you need to send real-time location data to an external system, you can use the Gateway to build the full setup.

***

### What is a Gateway?

A gateway is a device that collects distance data between UWB devices (tags and anchors) and sends it to a server using the MQTT protocol.\
It performs a similar role to the GrowSpace Listener but supports LAN and Wi-Fi connections, enabling stable communication even in larger areas.

{% hint style="info" %}
We recommend using a gateway instead of a listener when working with large spaces, cloud integration, or mobile app connectivity.
{% endhint %}

{% embed url="<https://youtu.be/UBLq2WL9A58>" %}

***

### Operation Status via LED Indicators

| LED  | Color                                   | Function          | Status Indicator                                         |
| ---- | --------------------------------------- | ----------------- | -------------------------------------------------------- |
| LED1 | <mark style="color:green;">Green</mark> | Power Supply      | Always on                                                |
| LED2 | <mark style="color:green;">Green</mark> | Data Transmission | Blinks while sending data                                |
| LED3 | <mark style="color:red;">Red</mark>     | Error             | Blinks when settings are missing or network error occurs |

{% hint style="info" %}
If **LED3 (red) keeps blinking**, it usually means there is a problem with **MQTT or Wi-Fi configuration**.\
→ Please check if the network or MQTT settings are missing or incorrect.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>LED 1. Green</strong></td><td><a href="/files/WeJNB3TgJtcJ1BPCQ2eu">/files/WeJNB3TgJtcJ1BPCQ2eu</a></td></tr><tr><td><strong>LED 2. Green</strong></td><td><a href="/files/ctUTLa5B7HKnGSHO62Pp">/files/ctUTLa5B7HKnGSHO62Pp</a></td></tr><tr><td><strong>LED 3. Red</strong></td><td><a href="/files/no7hlxYWORMFH87nw6m3">/files/no7hlxYWORMFH87nw6m3</a></td></tr></tbody></table>

***

### Accessing the Web Configuration Tool

The GrowSpace Gateway can be set up easily through a web browser, without any additional software installation.\
All configuration steps are done using the dedicated **GrowSpace Web Console**.

#### How to Access the Web Configuration Tool

* Open Google Chrome.

> Make sure to use **Google Chrome**. Other browsers like Edge, Safari, or Firefox may not properly recognize serial devices.

* Open the [**GrowSpace Web Console**](https://grow-space.io/software/).
* **Click** the **“Gateway Setup Program”** on the right side.

<figure><img src="/files/8QhCWdj1yoSyL3h7Km6C" alt=""><figcaption></figcaption></figure>

* When the setup screen appears, you’ll be asked to enter an **API Key**:
  * If this is your first time, click **\[Generate API Key]** to create a new one.
  * If you already have a key, paste it into the field to proceed.

{% hint style="warning" %}
The API key is used for device authentication and saving settings.\
Do **not share** or expose it publicly.
{% endhint %}

<figure><img src="/files/8VDu3Ml0heenMQ9N5Xlt" alt=""><figcaption></figcaption></figure>

***

### Generating an API Key

To use the gateway with MQTT, an API key is required.\
Follow these steps to create one:

* On the main screen or from the top menu, click **\[Generate API Key]**.
* Enter your **company name** or **project name**.\
  This name is for your own reference, so feel free to choose any label..

<figure><img src="/files/EdbHinlbEpiqDGzDWYWL" alt=""><figcaption></figcaption></figure>

* Your new **API key** will be generated and shown on the screen.
* **Copy and save** the key in a secure place.

{% hint style="danger" %}
**Important:** For security reasons, you **won’t be able to view the key again** after closing the window.\
It **cannot be recovered**, <mark style="color:$primary;">**so please save it in a memo app or password manager immediately.**</mark>
{% endhint %}

***

### Configuration Screen Overview

After logging in with your API key, you can access the following features:

<figure><img src="/files/Pj1ersCIvE6xdyTmhm1Q" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="246">Item</th><th>Description</th></tr></thead><tbody><tr><td><ol><li>Device List (Left)</li></ol></td><td>Shows the list of connected tags and anchors</td></tr><tr><td><ol start="2"><li>Grid View</li></ol></td><td>Displays the real-time layout of device positions</td></tr><tr><td><ol start="3"><li>Motion Filter</li></ol></td><td>Adjusting the filter strength for tag movement <br>(<strong>Very Strong > Strong > Moderate > Soft > No filter</strong>).</td></tr><tr><td><ol start="4"><li>Image Upload</li></ol></td><td>Upload a floor plan image to visualize tag positions on the map</td></tr><tr><td><ol start="5"><li>Gateway Settings</li></ol></td><td>Enter and save MQTT server info, port, Wi-Fi SSID/password</td></tr></tbody></table>

***

### Configuring the Gateway

After generating your API key, you need to enter the MQTT and network settings into the gateway.\
This step allows the gateway to communicate with the server and begin sending location data.

#### Configuration Steps

* Open the Web Console and click **\[Gateway Settings]** from the top menu.
* Connect the gateway to your PC via USB, then select the correct COM port and click **\[Connect]**.
* Fill in **all required fields** in the \[Gateway Setup Screen Overview], including.
* After entering all details, click **\[Save]**.
* The gateway will automatically restart, and the new settings will be applied.

#### Important Notes During Setup

* If there is any incorrect information in the input, the connection will fail, and **Gateway LED3 (red)** will keep blinking.
* In this case, please refer to the section [**“When Gateway LED3 (red) keeps blinking”**](#example-installation-scenarios) and check the logs.
* Before saving, **double-check all input fields** to ensure they are correct.
* After completing the configuration, make sure to verify that data is being received normally via the **Web Console or server logs**.

***

### Gateway Setup Screen Overview

The gateway setup screen lets you enter the required information for **MQTT integration** and **network connection**, enabling the gateway to function as a real-time data transmission device.

#### 1. **API Key**

<figure><img src="/files/LXXxIbxjYAsDxOuinCx4" alt=""><figcaption></figcaption></figure>

* This is a unique key used to identify and authenticate the gateway device.
* It is automatically loaded from the API key issued on the GrowSpace setup page and cannot be modified.

{% hint style="danger" %}
**Important:** Without a valid API key, the gateway will not transmit any data.
{% endhint %}

#### 2. **Pan Id**

* A network group identifier for communication between Tag, Anchor, and Gateway.
* All devices must use the same PAN ID to work together properly.
* Enter as a 4-digit hexadecimal value (e.g., `0000`, `00A1`).\\

{% hint style="warning" %}
**When using an Ethernet connection:** Skip items 3 and 4, and go directly to step 5 (MQTT IP) for configuration.
{% endhint %}

#### 3. **Wifi name (SSID)**

* Enter the name (SSID) of the Wi-Fi network the gateway will connect to.
* <mark style="color:red;">**Must use a 2.4GHz Wi-Fi network (5GHz is not supported).**</mark>

#### 4. **Wifi password**

* Enter the password for the Wi-Fi network you entered above.
* If the password is incorrect, the Wi-Fi connection will fail and **LED3 (red)** will keep blinking.

#### 5. **MQTT IP**

* Enter the IP address or domain of the MQTT server.
* If you're using the default GrowSpace broker, select **"Use default settings"** to apply the values automatically.
* If you’re using your own MQTT broker, manually enter the server’s IP address or domain.

#### 6. **MQTT Id**

* This is the **MQTT Broker Login ID**.
* If you're using the **GrowSpace default broker**, it can be set automatically.
* If you're using an **external MQTT broker**, you must enter the user ID you created manually.

#### 7. **MQTT password**

* This is the **password for the MQTT broker login**.
* It must be entered together with the **MQTT ID** for successful authentication.
* If the password is incorrect, the connection will fail.

***

### Example Installation Scenarios

Press the **Log Check** button in the gateway settings to view the logs and identify the error details.

<div><figure><img src="/files/muNbAh37s3FwSDIrEVH8" alt=""><figcaption></figcaption></figure> <figure><img src="/files/XphcdunQlePXqSXXptWQ" alt=""><figcaption></figcaption></figure></div>

{% hint style="danger" %}
**Note:** Log checking is only available for gateway devices purchased **after September 1, 2025**.
{% endhint %}

***

### Example Installation Scenarios

To ensure optimal performance, install the gateway according to the following guidelines:

<figure><img src="/files/KrRPZr5bRv5Xbk7mrX2q" alt=""><figcaption></figcaption></figure>

* **Space Size**: For example, 100m (width) × 60m (length)
* **Anchor Placement**: Install anchors evenly along the walls, spaced 15–20 meters apart
* **Gateway Position**:
  * Place near existing network equipment
  * Choose a wall-side location for easy power connection
  * Avoid the center of the space—edge placement is better for maintenance access

***

### Basic Operation Flow

When the gateway is powered on, it follows the process below:

**1.** Power On → Boot Begins

Once the gateway is connected to power, it starts booting automatically.\
You can confirm normal operation when <mark style="color:green;">**LED2 (green)**</mark> and <mark style="color:red;">**LED3 (red)**</mark> blink in sequence.

{% hint style="info" %}
If the LEDs do not light up or there is no response, please check the power adapter and cable connection.
{% endhint %}

**2.** Automatic Device Connection

If the tags and anchors are already configured, the gateway will automatically detect and connect to them as soon as it powers on.\
It will then immediately begin collecting distance data. There is no need to manually connect or configure the devices..

**3.** Network Connection Attempt

The gateway first tries to connect via **LAN** (wired internet). If LAN is not available, it automatically switches to Wi-Fi.

{% hint style="danger" %}
Only 2.4GHz Wi-Fi is supported. 5GHz networks are not compatible.
{% endhint %}

**4.** Sending Data to the Server (MQTT Broker)

If MQTT server details are pre-configured, the gateway will automatically start sending real-time location data from connected tags and anchors.\
If MQTT settings are missing or Wi-Fi fails to connect, LED3 (red) will keep blinking to indicate an error..

{% hint style="info" %}
In this case, access the Web Console again to check and update the network and MQTT settings.
{% endhint %}

***

### Gateway Configuration Checklist

After completing the gateway setup, please check each item below to ensure that data transmission is working properly:

* [ ] Check if **LED1 (green)** is steadily lit after power is connected
* [ ] If **LED3 (red)** is blinking, recheck **MQTT settings** or **Wi-Fi connection**
* [ ] &#x20;Confirm that the **MQTT server connection** is successfully established
* [ ] &#x20;Verify that **tag location data** is being sent to the server properly
* [ ] &#x20;Use the **Web Console** or **server logs** to confirm real-time data reception