Building Your Own Server
In This Guide
This guide explains how to use MQTT-Studio to connect to the Mosquitto broker and subscribe to the real-time UWB location data sent from the GrowSpace Gateway. When you want to integrate the tag and anchor location data with a server or cloud system via the MQTT broker, setting up the MQTT subscription environment as described in this guide will make the data integration process much easier.
⚠️ If you are setting up or configuring the MQTT server (Mosquitto broker) for the first time, please refer to the document below to prepare your server environment. Go to the MQTT Server Setup Guide
However, even before setting up the server, you can configure a test environment using MQTT-Studio. We recommend following the steps in this guide to learn the process of connecting to the broker and subscribing to data. This will help you familiarize yourself with the steps before the server setup.
Creating a Project in MQTT-Studio
Creating a Project
Open MQTT-Studio.
In the left menu, click New Project.
Enter the following details:
Project name
Project name (e.g. growspace-test)
MQTT Broker
IP address of the PC where the Mosquitto broker is installed
Port
Keep the default port 1883
Client ID
Enter a unique, random name (e.g. testclient1)
Username / Password
Enter settings according to the broker configuration, or leave it blank if not required
If connecting within the same network, simply enter the IP address to establish the connection.
For external connections, you will need to configure port forwarding on the router for port 1883.
Once the connection is successfully established, the status in the top right corner will change to CONNECT.
How to Check the IP Address (Windows)
Type
cmdin the Windows search bar and open the Command Prompt.Enter the command
ipconfigand press Enter.
In the output, locate the
IPv4 Addressfield. Example:192.168.0.101
* Use this address(주소) as the IP for the MQTT Broker.
Configuring Gateway Data Subscription
After connecting to the Mosquitto broker, subscribe to the topics in MQTT-Studio to receive location data.
Click the + button in the top-right corner.
Enter and add the following 3 topics:
uwb/gateway/start/#
Gateway Boot Status Information
uwb/gateway/config/#
Configuration data, including settings and measurement intervals
uwb/gateway/devices/#
Real-time location data of tags and anchors
The
#symbol subscribes to all subtopics within the specified path. TheprojectIdincluded in the topic structure is configured based on the API key issued on the GrowSpace Web Configuration page.
Saving the Project
Once the topics are registered, click Save Project in the top-left menu to save the configuration. You can later quickly reconnect with the same settings by selecting Open Project.
Gateway Configuration and Data Transmission
Through the GrowSpace Web Configuration Page, you can configure the GrowSpace Gateway Q1 device to send data to a private Mosquitto broker.
Configuration Steps
Connect the power to the gateway.
Open Google Chrome and navigate to the following web page. https://uwb-gateway.web.app
From the top menu of the page, go to the Gateway Settings section.
Enter the required details in the fields below.
Wi-Fi Name / Password
Enter the 2.4GHz Wi-Fi information (5GHz is not supported)
MQTT IP
Enter the IP address of the PC where the Mosquitto broker is installed
After filling in all the fields, click Save. The gateway will automatically restart and begin sending data to the configured MQTT broker.
Confirm Data Reception in MQTT-Studio
Once the gateway configuration is complete, real-time location data will begin to appear automatically in MQTT-Studio. Below is an example of the actual received message.
swift복사편집Topic: uwb/gateway/devices/project-1234/TAG-001
{
"tagId": "TAG-001",
"x": 12.34,
"y": 56.78,
"z": 1.23,
"timestamp": 1723850283
}Using this data, you can check the tag’s location or integrate it with a real-time monitoring system.
Last updated