Skip to main content

Integrations · MQTT

MQTT

Sensors publish to a broker we run.

What this gives you

What arrivesdetections
What you can sendnothing. This one reports.
What it carriessensors

Connect one

  1. Turn the protocol on. Settings → Integrations → MQTT → enable.
  2. Declare the device. Settings → Assets → ADD, find the product, pick this protocol. You get back a username, a password and a topic, shown once. Put those three on the device.

The address format

This is the form that parses:

TransportFormWhat it meansExample
MQTTmqtt:BROKER:PORT/TOPICA broker and a topic. For an inbound device the broker is ours, so you do not supply it.mqtt:127.0.0.1:1883/ingest/TOKEN/#

When it is working

The sensor appears in Settings → Assets with a live health state, and the Integrations row counts it. On the console, its returns start driving tracks within a few seconds.

If nothing arrives

SymptomWhere to look
Nothing arrives, and the row looks healthyThe device is publishing to the wrong topic. Only the topic issued with the credential is routed; anything else is dropped without an error.
It connects, then dropsTwo things are bound to the same port, or the device and the host disagree about which end dials. See the endpoint forms above.

The protocol itself

This one has no public specification to link to.

Where to go next