Welcome to the third edition of MQTT Essentials. A ten-part blog series on the core features and concepts of the MQTT protocol.In this post, well discuss the roles of the MQTT client and broker, and the parameters and options that are available when you connect to a broker.

Last week, weexplained how the publish/subscribe pattern works and how it is applied in MQTT. Heres a quick recap of core concepts: *Publish/Subscribe decouples the client that sends a message (the publisher) from the client or clients that receive the messages (the subscribers).* MQTT uses the topic (subject) of the message to determine which message goes to which client (subscriber). A topic is a hierarchically-structured string that can be used to filter and route messages (moredetails).

Our last post gave you a high-level view of the publish/subscribe model and how it differs from a traditional message queue.This post takes a practical approach and is stuffed with basic knowledge about MQTT: definitions for the terms MQTT client and broker, the basics of an MQTT connection, the Connect message with its parameters, and establishing a connection through the acknowledgement of the broker.

Because MQTT decouples the publisher from the subscriber, client connections are always handled by a broker. Before we get into the details of these connections, lets be clear about what we mean by client and broker.

When we talk about a client, we almost always mean an MQTT client. Both publishers and subscribers are MQTT clients. The publisher and subscriber labels refer to whether the client is currently publishing messages or subscribing to messages (publish and subscribe functionality can also be implemented in the same MQTT client).An MQTT client is any device (from a micro controller up to a full-fledged server) that runs an MQTT library and connects to an MQTT broker over a network.For example, the MQTT client can be a very small, resource-constrained device that connects over a wireless network and has a bare-minimum library. The MQTT client can also be a typical computer running a graphical MQTT client for testing purposes. Basically, any device that speaks MQTT over a TCP/IP stack can be called an MQTT client. The client implementation of the MQTT protocol is very straight forward and streamlined. The ease of implementation is one of the reasons why MQTT is ideally suited for small devices.MQTT client libraries are available for a huge variety of programming languages. For example, Android, Arduino, C, C++, C, Go, iOS, Java, JavaScript, and .You can see a complete list on theMQTT wiki.

The counterpart of the MQTT client is the MQTT broker. The broker is at the heart of any publish/subscribe protocol. Depending on the implementation, a broker can handle up to thousands of concurrently connected MQTT clients.The broker is responsible for receiving all messages, filtering the messages, determining who is subscribed to each message, and sending the message to these subscribed clients.The broker also holds the sessions of all persisted clients, including subscriptions and missed messages (moredetails). Another responsibility of the broker is the authentication and authorization of clients. Usually, the broker is extensible, which facilitates custom authentication, authorization, and integration into backend systems. Integration is particularly important because the broker is frequently the component that is directly exposed on the internet, handles a lot of clients, and needs to pass messages to downstream analyzing and processing systems. As discussed ina previous post, subscribing to all message is not really an option. In brief, the broker is the central hub through which every message must pass. Therefore,it is important that your broker is highly scalable, integratable into backend systems, easy to monitor, and (of course) failure-resistant.HiveMQ meets these requirements by using state-of-the-art event-driven network processing, an open plugin system, and standard monitoring providers.

The MQTT protocol is based on TCP/IP. Both the client and the broker need to have a TCP/IP stack.

The MQTT connection is always between one client and the broker. Clients never connect to each other directly. To initiate a connection,the client sends a CONNECT message to the broker. The broker responds with a CONNACK messageand a status code. Once the connection is established, the broker keeps it open until the client sends a disconnect command or the connection breaks.

In many common use cases, the MQTT client is located behind a router that uses network address translation (NAT) to translate from a private network address (like 192.168.x.x, 10.0.x.x) to a public facing address. As we already mentioned, the MQTT client initiates the connection by sending a CONNECT message to the broker. Because the broker has a public address and keeps the connection open to allow bidirectional sending and receiving of messages (after the initial CONNECT), there is no problem at all with clients that are located behind a NAT,

Now lets look at theMQTT CONNECTcommand message. To initiate a connection, the client sends a command message to the broker. If this CONNECT message is malformed (according to the MQTT specification) or too much time passes between opening a network socket and sending the connect message, the broker closes the connection. This behavior deters malicious clients that can slow the broker down.A good-natured client sends a connect message with the following content(among other things):

Some information included in a CONNECT message is probably more interesting to implementers of an MQTT library rather than to users of that library. For all the details, have a look at theMQTT 3.1.1 specification.

The client identifier (ClientId)identifies each MQTT clientthat connects to an MQTT broker. The broker uses the ClientID to identify the client and the current state of the client.Therefore, this ID should be unique per client and broker. In MQTT 3.1.1 (the current standard), you can send an empty ClientId, if you dont need a state to be held by the broker. The empty ClientID results in a connection without any state. In this case, the clean session flag must be set to true or the broker will reject the connection.

The clean session flag tells the broker whether the client wants to establish a persistent session or not. In a persistent session (CleanSession = false), the broker stores all subscriptions for the client and all missed messages for the client that subscribed with aQuality of Service (QoS)level 1 or 2. If the session is not persistent (CleanSession = true), the broker does not store anything for the client and purges all information from any previous persistent session.

MQTT can send auser name and password for client authentication and authorization. However, if this information isnt encrypted or hashed (either by implementation or TLS), the password is sent in plain text. We highly recommend the use of user names and passwords together with a secure transport. Brokers like HiveMQ can authenticate clients with an SSL certificate, so no username and password is needed.

The last will message is part of the Last Will and Testament (LWT) feature of MQTT.This message notifies other clients when a client disconnects ungracefully.When a client connects, it can provide the broker with a last will in the form of an MQTT message and topic within the CONNECT message. If the client disconnects ungracefully, the broker sends the LWT message on behalf of the client. You can learn more about LWT inpart 9of this series.

The keep alive isa time interval in secondsthat the client specifies and communicates to the broker when the connection established. This interval defines the longest period of time that the broker and client can endure without sending a message.The client commits to sending regular PING Request messages to the broker. The broker responds with a PING response. This method allows both sides to determine if the other one is still available. Seepart 10of this series for detailed information about the MQTT keep alive functionality.

Basically, that is all the information that is all you need to connect to an MQTT broker from an MQTT client. Individual libraries often have additional options that you can configure. For example, the way that queued messages are stored in a specific implementation.

When a broker receives a CONNECT message, it is obligated to respond with a CONNACK message.

The CONNACK message contains two data entries:

Thesession present flag tells the client whether the broker already has a persistent session available from previous interactions with the client. When a client connects with Clean Session set to true, the session present flag is always false because there is no session available. If a client connects with Clean Session set to false, there are two possibilities: If session information is available for the client Id. and the broker has stored session information, the session present flag is true. Otherwise, if the broker does not have any session information for the client ID, the session present flag is false. This flag was added in MQTT 3.1.1 to help clients determine whether they need to subscribe to topics or if the topics are still stored in a persistent session.

The second flag in theCONNACKmessage is the connect acknowledge flag. This flag containsa return code that tells the client whether the connection attempt was successful..

For a more detailed explanation of each of these codes, see theMQTT specification.

You might be wondering how MQTT keeps a connection open even when no messages are being sent, or how you know when a connection is lost. Dont worry, we devote a whole issue of the essentials series to these topics later on.

Thats the end of part three in our MQTT Essentials series. We hope you learned at least one new thing about MQTT and that you will join us again next week for our post onpublishing, subscribing, and unsubscribing in MQTT.

To get the next part of this series as soon as it is released, enter your email in the subscription form below. If you prefer RSS, you can subscribe to ourRSS feed here.

We love writing about MQTT, IoT protocols and architecture in general. Our experts are here to help, so reach out to us if we can help!

updates about MQTT and HiveMQ directly to your inbox

By clicking the Subscribe button you give your consent to the use of your data according to ourPrivacy Policy.

You can with draw this consent at anytime with future effect.

By clicking the Subscribe button you give your consent to the use of your data according to ourPrivacy Policy. You can withdraw this consent at any time with future effect.

Sign up for our newsletter to keep up with the latest news about HiveMQ and MQTT in general.

By clicking the Subscribe button you give your consent to the use of your data according to ourPrivacy Policy. You can withdraw this consent at any time with future effect.

Bavaria, GermanyFollow us on© 2019 dc-square GmbH