WebsiteKOR

Gateway Setup and Data Monitoring (Optional)

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

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.

We recommend using a gateway instead of a listener when working with large spaces, cloud integration, or mobile app connectivity.

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 LED2 (green) and LED3 (red) blink in sequence.

If the LEDs do not light up or there is no response, please check the power adapter and cable connection.

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.

Only 2.4GHz Wi-Fi is supported. 5GHz networks are not compatible.

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

In this case, access the Web Console again to check and update the network and MQTT settings.

Operation Status via LED Indicators

LED
Color
Function
Status Indicator

LED1

Green

Power Supply

Always on

LED2

Green

Data Transmission

Blinks while sending data

LED3

Red

Error

Blinks when settings are missing or network error occurs

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.

Cover

LED 1. Green

Cover

LED 2. Green

Cover

LED 3. Red

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.

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

The API key is used for device authentication and saving settings. Do not share or expose it publicly.

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

  • Your new API key will be generated and shown on the screen.

  • Copy and save the key in a secure place.

Important: For security reasons, you won’t be able to view the key again after closing the window. It cannot be recovered, so please save it in a memo app or password manager immediately.

Configuration Screen Overview

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

Item
Description

  1. Device List (Left)

Shows the list of connected tags and anchors

  1. Grid View

Displays the real-time layout of device positions

  1. Motion Filter

Adjusts the filter strength for tag movement (closer to 1 = stronger smoothing)

  1. Image Upload

Upload a floor plan image to visualize tag positions on the map

  1. Gateway Settings

Enter and save MQTT server info, port, Wi-Fi SSID/password

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 any field is missing or entered incorrectly, the connection will fail, and LED3 (red) will keep blinking.

  • Double-check all fields before clicking [Save].

  • After setup, confirm that data is being received properly through 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

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

Important: Without a valid API key, the gateway will not transmit any data.

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

3. Wifi name (SSID)

  • Enter the name (SSID) of the Wi-Fi network the gateway will connect to.

  • Must use a 2.4GHz Wi-Fi network (5GHz is not supported).

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

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

  • 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

Gateway Configuration Checklist

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

PreviousListener Setup and Data Check (Optional)NextAdvanced Guide for Tag

Last updated