About MQTT Dash

MQTT Dash is an Android application. With the app you can create dashboards for your MQTT enabled IoT devices.

Get it from Google Play:
https://play.google.com/store/apps/details?id=net.routix.mqttdash&hl=hu

There is no iOS version of the app, but there are some alternatives: EasyMQTT, Mqter, IoT-Manager and MQTTInspector

Set up a connection

Tap the + sign on the top-right corner of the screen to add a new MQTT broker.

Fill in fields as below:

Name: Display name of the connection, e.g. Home
Address: MQTT broker hostname or IP address
Port: MQTT broker port
Connection encryption: Enable TLS if MQTT broker supports Transport Layer Security. Set secure port of the broker above. You also may leave TLS disabled and communicate with the broker unencrypted.
Self-signed certificate: Leave it disabled unless you run an own MQTT broker with self-signed certificate.
Username: MQTT username on MQTT broker
Password: MQTT password on MQTT broker
Client ID: Leave it unchanged.
Tile size: medium

Tap the save icon on the top-right corner.

Later on you can long-tap the name of this connection to edit or delete it.

Set up widgets automatically

Tap the name of the connection, you’ve just created. The app will connect to the configured MQTT broker. If it reports failure, please fix connection configuration first.

Tap the “up and down arrows” import/export icon on the top of the screen.

Keep Topic unchanged and tap “Subscribe and wait for metrics”.

Open the WebUI configuration interface of your HAUS IoT controller, go to the Remote controllers menu, then click “Publish” to send remote controller configuration.

MQTT Dash receives the configuration instantly and populates widgets.

Note: If you use a special MQTT broker, imposing limits on topic names, you might not use the default metrics/exchange topic. It is quite common for free online MQTT brokers, that you are forced to use a certain prefix (usually your username) for your topics. In such cases adjust the topic name on both ends accordingly.

Add or configure widgets manually

Tap the name of the connection, you’ve just created. The app will connect to the configured MQTT broker. If it reports failure, please fix connection configuration first.

Tap the + sign on the top-right corner of the screen to add a new widget.

Select widget type:

Text: Good for displaying temperature and other status info.
Switch/button: Good for switching on/off a light, open a gate, etc.
Range/progress: Good for dim a light, setting a timer, etc.
Multi choice: Good for select an operation mode of a device, etc.

For all types, you set up a:

Name: Display name of the widget, e.g. Device status or Temperature.
Topic (sub): Subscribing to an MQTT topic, in which a remote device publishes some value.
Topic (pub): Publishing a value set by the widget to your devices in an MQTT topic.

For MQTT topics and values please consult MQTT Interface Description and Parameter Description documents of your devices.

You can reorganize the widgets by dragging them, but you can prevent doing this accidentally by closing the lock icon on the top of the screen.

Later on you can long-tap the widget to edit or delete it.