Connection Guide
Step-by-step instructions to connect a GDS test station to CloudUplink and view live data on a dashboard.
Register an Account
Navigate to /register and create a new account. You will need a valid email address and password. After registration you will be directed to the home page.
1
Navigate to Stations
Go to the Stations page from the sidebar. This page lists all registered MQTT client stations for your account.
2
Add a Station
Click Add Station and fill in the details:
Station name (e.g. "Lab A - Triaxial Rig 1")
Laboratory name
PC identifier
Test type (Triaxial, Consolidation, Direct Shear, Permeability, or Cyclic Triaxial)
3
Note the Client ID and Topic
After saving, CloudUplink generates a unique Client ID and an
MQTT Topic in the format gds/station/{"{clientId}"}/data.
Copy both values -- you will need them in the next step.
4
Configure MQTT in GDSLab
In the GDSLab software, open the MQTT configuration and enter:
| Setting | Value |
|---|---|
| Host | localhost |
| Port | 1883 |
| Client ID | {"{from step 4}"} |
| Topic | {"{from step 4}"} |
5
Start a Test
Start a test in GDSLab. Data will be published to the MQTT broker and appear automatically in CloudUplink. You can verify the connection on the Home page where the MQTT broker status and connected client count are shown.
6
Create a Dashboard
Navigate to Create Dashboard and build a custom dashboard. Add tiles (charts, gauges, values) and bind each tile to the data fields being published by your test station.
7
Quick Reference
MQTT Connection
| Host | localhost |
| Port | 1883 |
| Protocol | MQTT v3.1.1 / v5 |
| QoS | 0 |
Key Pages
| Register | /register |
| Stations | /clients |
| Create Dashboard | /dashboards/create |
| MQTT Spec | /docs/mqtt |