Chariot MQTT Client

Prerequisites

• Install the Chariot MQTT Server
  • The Chariot MQTT Client does not require a Chariot license or that you run Chariot under its trial timer.

Summary 

The Chariot MQTT Client is a built-in MQTT application that allows you to connect to any number of MQTT Servers simultaneously, subscribe on any topic(s) across the MQTT servers, publish MQTT messages and view/interact with the MQTT topic tree as messages are published. The application allows for full control of MQTT QoS levels and the retain flag. 

The Chariot MQTT Client consists of three tabbed views: 

• The Connections tab where you can create and manage your MQTT server connections.
• The Publish/Subscribe tab where you can subscribe on MQTT topics and produce MQTT messages on any topic with a custom payload. The Device Simulator also provides a quick way to get test messages published. The Messages view will decode plaintext, SparkplugB, Hex and Base64.
• The Topic Tree Viewer tab where you can view all messages across all topics simultaneously across multiple MQTT servers with live decoding of the messages.

Launch the Chariot MQTT Client

To launch the Chariot MQTT Client, first log into the Chariot MQTT server web front-end. Then click on the MQTT Client View under Configuration → MQTT Client on the Chariot left-hand navigation pane.

Add Server Connection

To get started, navigate to the Connections tab and add a server connection by clicking on the Add Connection button. Fill out the Connection configuration (MQTT username, password, address/url, port, client id, etc) and then click the Add button. This can be any MQTT server (e.g., test.mosquitto.org). If you do want to connect to the local Chariot MQTT Server using the Chariot MQTT Client, please be sure to turn on the trial timer so the server will accept incoming connections. See our documentation for default MQTT credentials.

Next, click Connect to connect to the newly added MQTT server. Your current MQTT connection and its state will be displayed in the upper right of the window.

Publish and Subscribe

Next, move to the Publish/Subscribe tab to setup your MQTT subscriptions and publish messages if desired. For example, subscribe on '#' in the Subscribe view - set the topic to '#' and click the Subscribe button. 

Now publish a message using the Publish view and watch it show up decoded in the Messages view.

View the Topic Tree

Lastly, view the complete, live topic tree with all topics and messages visible across all MQTT server connections. Simply navigate the Topic Tree view to find the messages you want by topic. Each topic will show how many messages the Chariot MQTT Client has cached locally. When you select the leaf node / last topic token, the Messages view will automatically be populated with all messages available on that topic. The subscriptions you make in the Publish/Subscribe tab apply in the Topic Tree viewer.