Adding an MQTT Device¶
An MQTT Device represents a single publisher on your MQTT broker — for example, an IIoT sensor or an edge gateway publishing telemetry. All MQTT parameters (payload fields) you want to read from that device are added as children of this device.
Before you begin¶
- A Workspace must already exist for the device to be assigned to.
- You need the topic the device publishes to, and — if multiple devices share the same topic — a field in the payload (the identifier) and its expected value (the identifier value) that uniquely identifies this device's messages.
- You need Engineer access to create devices.
Steps¶
1. Open the Devices section¶
In the left sidebar, go to Digital Twin → Devices.
2. Click Create MQTT Device¶
Click the + button and select Create MQTT Device. The creation form opens.
3. Fill in the device details¶
| Field | Description |
|---|---|
| Workspace | The workspace this device belongs to |
| Name | A descriptive name for this device (e.g. Warehouse Temp Sensor 3) |
| Topic | The MQTT topic this device publishes to (e.g. plant1/sensors/temp3) |
| Identifier | The field name in the payload used to identify which device a message belongs to, when multiple devices share the same topic |
| Identifier Value | The expected value of that field for this specific device |
| Description | Notes about this device |
4. Save¶
Click Create. The device is created and appears in the Devices list.
What happens next¶
The Enture edge device at your facility receives the new device configuration within approximately 30 seconds and begins matching incoming messages on the configured topic against this device's identifier.
You can now add parameters to this device — see Adding MQTT Parameters.
Updating an MQTT Device¶
- Navigate to Digital Twin → Devices and find the device.
- Open the device and click Edit.
- Update the fields and click Update.
The edge device applies the new settings within approximately 30 seconds.