MQTT — Message Queue Telemetry Transport

What is MQTT

  • A message protocol with “a small code footprint and on-the-wire footprint” .
  • MQTT is a publish-subscribe-based messaging protocol.
  • On top of TCP/IP.
  • Requires a broker (e.g. mosquito, hivemq, azure IO Hub).
  • ISO standard (ISO/IEC PRF 20922).
  • A message bus for: unreliable, high latency, low bandwidth
  • Payload with a plain byte array.


  • The protocol uses a publish/subscribe architecture in contrast to HTTP with its request/response paradigm.
  • Publish/Subscribe is event-driven and enables messages to be pushed to clients.
  • The central communication point is the MQTT broker, it is in charge of dispatching all messages between the senders and the rightful receivers.
  • Each client that publishes a message to the broker, includes a topic into the message. The topic is the routing information for the broker.
  • Each client that wants to receive messages subscribes to a certain topic and the broker delivers all messages with the matching topic to the client.
  • Therefore the clients don’t have to know each other, they only communicate over the topic.
  • This architecture enables highly scale-able solutions without dependencies between the data producers and the data consumers.

… and what is with REST?

  • HTTP/REST is useful to handle documents and resources.
  • MQTT is useful to handle messages.
  • HTTP/REST can be complex and is not always the best solution for simple messages.
  • The MQTT packet size is 2 byte + payload .
  • MQTT supports 1-to-1, 1-to-many and many-to-many messages.
  • Request and response vs publisher and subscriber.


The difference to HTTP is that a client doesn’t have to pull the information it needs, but the broker pushes the information to the client, in the case there is something new.

Therefore each MQTT client has a permanently open TCP connection to the broker. If this connection is interrupted by any circumstances, the MQTT broker can buffer all messages and send them to the client when it is back online.

As mentioned before the central concept in MQTT to dispatch messages are topics. A topic is a simple string that can have more hierarchy levels, which are separated by a slash.

A sample topic for sending temperature data of the living room could be house/living-room/temperature.

On one hand the client can subscribe to the exact topic or on the other hand use a wildcard. The subscription to house/+/temperature would result in all message send to the previously mention topic house/living-room/temperature as well as any topic with an arbitrary value in the place of living room, for example house/kitchen/temperature

The plus sign is a single level wild card and only allows arbitrary values for one hierarchy. If you need to subscribe to more than one level, for example to the entire subtree, there is also a multilevel wildcard (#). It allows to subscribe to all underlying hierarchy levels. For example house/# is subscribing to all topics beginning with house.


PUBLISH to home/livingroom/light/1 message


  • SSL/TLS support
  • Username/Password
  • Encrypt payload (data/payload agnostic)
  • IOT security should not be underestimated!
  • SSL/TLS is a must-have

Broker and Clients

  • Mosquitto
  • HivenMQ
  • Azure IOT Hub
  • MQTT.fx
  • Eclipse Paho
  • MQTTnet

Code Sample

I have build a sample .NET Core console application to test the library. Following are code screenshots, which are self explanatory and you can download the code from git if needed.

Solution contains 3 projects as follows and all of the projects have a reference to MQTTnet.


Both, Publisher and Subscriber connects to Broker.


Here is the code for SimulatePublish method:



Following is screenshot of running the solution.


This was a very basic introduction to MQTT and its usage. To keep the discussion simple, I kept the code to very minimal. Publisher/Subscriber pattern is very powerful and allows us to create decoupled application easily and use of MQTTNet library make it very easy to implement this pattern in our applications. You can download the sample from my git repository on the source code link below. Also I will suggest to check the links in reference for more insight. Till next time, Happy Coding.

Git Repository Link

>>git clone


Originally published at on February 12, 2020.




Software Solutions Team Lead | Cloud Architect | Solutions Architect

Love podcasts or audiobooks? Learn on the go with our new app.

Recommended from Medium

Live Webinar: Your app’s complete security guide on Back4app!

How to Setup Docker in Jenkins on Mac

The Truth On Trump’s Recent Firing Of My Father

Salesforce — Sr. Enterprise Architect — Domain

GitLab’s IPO and the Enterprise Wave

How to Create Fitness App that thrives in the Market

The ‘image’ attribute has no file associated with it

How to Embed Kotlin Playground on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store


Software Solutions Team Lead | Cloud Architect | Solutions Architect

More from Medium

This is a blog post for my video

Release the limits of Github Actions with self-hosted runners

What is JWT and how to use it for authorization, securely?

AWS IoT With .NET Core (MQTT)