Before introduction and use, readers can visit our GitHub or website to understand and get the information of latest version. MQTTX is undergoing rapid development and iterations, and the latest version will help improve the using experience.
Please download the right version from GitHub Releases and install it for use.
If there is a network problem resulting in a slow network speed or a jam in the GitHub download process, you can also go to the EMQ website to select the right version that matches your requirement and install it for use.
MQTT Broker Preparation
- If you don't have an MQTT broker deployed locally, you can use the public MQTT service provided by EMQX Cloud for quick testing:
Broker Address: broker.emqx.io
Broker TCP Port: 1883
Broker SSL Port: 8883
If you plan to deploy MQTT Broker locally, we recommend that you download EMQX for installation and use. EMQX is a fully open source, highly available, low latency, million-level distributed IoT MQTT 5.0 message server.
Quickly install EMQX by using Docker:
docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8883:8883 -p 8084:8084 -p 18083:18083 emqx/emqx
After MQTT Broker is ready, enter the main program page and click the "+" in the menu bar on the left. If there is no data on the page, you can also click the
New Connection button on the right to quickly configure a new client connection.
After entering the
New Connection page, you need to configure or fill in the relevant information relevant to the client connection. The reader can configure all settings that define the Broker connection here, such as
Clean Session, .etc.
When configuring the
Portare already filled in by default. You can also modify it yourself based on the actual
Brokerinformation. Click the refresh button on the right of Client ID to quickly generate a new
User authentication information
If your broker has enabled user authentication, you can fill in the information of
passwordin the configuration item.
When you need to enable SSL / TLS authentication, you only need to set the SSL / TLS in the configuration to
true, and provide two methods of
If you select
Self signed, you can configure the certificate. Click the folder button on the far right and select the certificates that has been generated. For one-way connection,you just need to select your
CA File. For two-way authentication, you also need to choose to configure
Client Certificate Fileand
Client key file.
In advanced configuration, you can configure
MQTT Versionand other information.
In advanced configuration, you can select the protocol version of MQTT. Both MQTT v3.1.1 and MQTT v5.0 are supported and the default is v3.1.1. If you choose v5.0, you can also configure
Session Expiry Interval,
In the configuration card under the advanced configuration, you can configure the will message. The values of
Last-Will-Retainare filled with 0 and
Falseby default. You only need to fill the value of
Last-Will-Payloadto complete the configuration of the will message.
After the connection is successfully created, you can enter the main interface of the connection. Click the fold button next to the connection name at the top to expand and display several basic information about the configuration and Quickly modify the common configuration of the connection. When modifying, you need to disconnect. After clicking the connection again, the modification will take effect. In the disconnected state, you can also click the configuration button on the right to modify more connection configurations.
After the connection is established, you can simply enter
Payload in the input boxes at the bottom of the connection main page, and then click the button in the lower right corner to send a test message. macOS users can use the
command + enter shortcut to quickly send messages, and other users can use the
control + enter shortcut for that.
New Subscription button in the lower left corner to quickly subscribe to a topic. After the topic is successfully subscribed, it will start accepting messages immediately.
Topic is assigned a color mark at random. You can also open the color picker to customize the color of the mark. You can hide the subscription list to show more space by clicking the rightmost button at the top of the subscription list.
When hovering over a card in the
Topic list, click the red button in the upper right corner to quickly unsubscribe.
Let's create a new test connection for the message publishing test. Fill in the
Topic information you just subscribed to in the lower right corner of the page, input the content of the Payload, and click the send button on the far right to send a message to the connected client that subscribed to the
If the sending client also subscribes to the same
topic, the client will immediately receive the message after sending successfully. Note that in the message box, the right column is the sent message, and the left column is the received message.
You need to click the settings button at the bottom of the left menu bar, or use shortcut keys to jump to the settings page. MacOS users can use
command +,shortcut keys. Other users can use
control +,shortcut keys. The current supported setting includes language, whether to automatically check for updates and topic selection .
Drop-down menu on the message page
Through the button of
Published in the upper right corner of the message bar, it can filter out all messages, received messages, and published messages.
Click the action bar button at the top and select the
Search by Topic item to open the function of searching and filtering messages by
Topic. Shortcut key can be used for that. MacOS users can use the command + f shortcut key. Other users can use the control + f shortcut key.
Clear Histroy item to quickly clear all sent and received messages in the current connection.
Delete Connection items to quickly disconnect and delete the current connection.
Check for updates
ibutton on the left bottom to display the
Aboutpage to learn about the version of MQTTX and related information of EMQX . Click
Check for Updatesto check if there are newer versions.
The above is a brief overview of how to use MQTTX. Readers can use MQTTX entirety through the manual on GitHub.
This project is based on the Apache 2.0 open source protocol. In the process of using, you can go to GitHub issues to submit issues, discuss opinions or submit PR to us. We will carefully review and respond to all questions.