MQTT Topic Connections
MQTT topic connections are definitions in the Compass module that connect to MQTT data sources and store real-time sensor data topics as Compass records.
When an MQTT data source added in the Port module is selected, an MQTT topic browser opens in Compass. The desired topic is selected and stored as a Compass record; the saved MQTT connection is then used in the Cartography module to create real-time gauges, trends, or value widgets.
Naming
For MQTT, no query is written in Compass — instead a topic is selected from the broker. That is why the action name in this module is "Topic Selection" / "Edit Topic".
Demo Factory — MQTT publications
The Demo Factory MQTT stream publishes these live topics (connection registered in Port as Demo Fabrika - MQTT):
| Topic | Interval | Payload |
|---|---|---|
fabrika/hat1/sicaklik |
2 s | { ts, value, unit:"°C", makine_id, hat_id } |
fabrika/hat1/basinc |
2 s | { ts, value, unit:"bar", makine_id, hat_id } |
fabrika/hat1/tank_seviye |
5 s | { ts, value, unit:"%", tank_id } (25–85 % oscillation) |
fabrika/hat1/sayac |
1 s | { ts, value } (monotonically increasing production counter) |
Port data source name: Demo Fabrika - MQTT.
To start the same stream in your own environment → Synthetic Data Generation — MQTT
Strengths
| Feature | Description |
|---|---|
| Real-Time Data | Instant sensor readings via WebSocket; no screen refresh needed |
| Low Latency | Sub-second data updates via MQTT pub/sub architecture |
| Topic Browser | Discover all topics on the broker in a tree view |
| Live Payload Preview | The latest message of the selected topic is displayed instantly |
| IoT Compatible | Works directly with MQTT streams from PLCs, sensors, SCADA, and factory devices |
What You Can Do in Pirivision
| Action | Description |
|---|---|
| Instant Value Display | Live display of real-time temperature, pressure, speed, and other sensor readings |
| Alarm Monitoring | Listen live to machine alarm topics |
| Multi-Sensor Tracking | Define a separate topic record per sensor and monitor side-by-side on the same dashboard |
| Live Trend | Visualize incoming MQTT messages as a time series in Cartography |
Requirements
| Requirement | Description |
|---|---|
| MQTT data source in Port | An MQTT broker connection (host, port, protocol) must be added |
| Topic access permission | The broker ACL must allow subscribe permission for the selected topic |
Guides
| Guide | Description |
|---|---|
| MQTT Topic Selection | Selecting an MQTT topic in Compass and creating a record |
| Edit MQTT Topic | Update an existing MQTT topic record |
| Move Compass Record | Move the record to a different folder |
| Duplicate Compass Record | Copy the same record |
| Delete Compass Record | Remove the record |
Next Step
After saving the MQTT topic connection, create a real-time widget using this record in the Cartography module.