Jeedom + MQTT: associate a connected object DIY with the Dashboard

With the ESP8266 modules or an Arduino, it is very easy to build your own connected objects (DIY IoT) and integrate them into a home automation server with the MQTT protocol (with Mosquitto for example). Jeedom, the home automation server entirely in French, allows you to easily integrate your connected objects. In this article we will learn how to install the Mosquitto Broker to communicate on an existing Jeedom server and connect a first object to it and display it on the Dashboard.

Install the Mosquitto Broker on Jeedom

We will not go into the details of the operation of MQTT and Mosquitto. I refer you to this previous article which explains how to install and take over the Broker MQTT Mosquitto. Jeedom running on a classic Raspbian Linux distribution, it is very easy to install MQTT. I have a preference for Mosquitto but you can install others (see the article on a selection of Brokers online).

Open the Terminal add execute sudo apt-get install mosquitto

Then we install mosquitto-clients which allows to subscribe, publish and manage the users to secure your broker. It is optional but it can always be used to be able to verify that one receives many messages coming from the devices that have been developed.

sudo apt-get install mosquitto-clients

It is done. At the end of the installation, Mosquitto is operational.

If you have realized the temperature probe based on an ESP8266 Wemos D1 mini (presented here), plug it in and run the following command to check that you receive the temperature and humidity messages.

mosquitto_sub -h localhost -t sensor/# -v

Small translation of the order for those who discover MQTT. We subscribe (mosquitto_sub) to the broker (-h) localhost (or the ip address of the broker) to the topic (-t) sensor / # (# all sub-topic) -v the value).

Subscription is stopped with Ctrl + C

jeedom mqtt mosquitto test subscribe

Add the MQTT plugin to Jeedom

Now that we receive data from the DHT22 temperature probe using the ESP8266, let’s see how to integrate the measurements into Jeedom.

Go to Plugins -> Manage plugins then Go to Market

jeedom gestion plugins

Search the keyword MQTT or go to the section Home automation protocol

jeedom market ajout plugin mqtt

Open the plugin of the plugin -> Install stable

At the end of the installation, press OK.

Go back to the list of plugins and press Activate (green next to Action) to activate the plugin. It will take a few more minutes for Jeedom to finish installing the dependencies (or tap Relaunch to start the installation immediately). You can follow the installation process by pressing View log

jeedom activer plugin

Create new object

If you know Jeedom, you can skip this step.

Before you can display the values measured by the probe, you must already create an object to which the probe will be associated.

To create an object, go to Tools -> Objects and then Add

jeedom creer nouveau objets

Give it the name of “kitchen” for example. You can give it a color, an icon (the names are in English). It is also possible to create an object tree by specifying a parent. If you’re new to Jeedom, there’s no parent available.

jeedom editer objet

Combining the temperature sensor with the kitchen object

Go back to Plugins -> Home automation protocol -> MQTT

jeedom mqtt nouveau equipement disponible

Jeedom is very powerful, it automatically detects the Topics available on Mosquito and automatically creates new equipment.

  • Click on the sensor device to edit it.
  • Give it a name, for example DHT22
  • A parent object, Cooking in this example
  • A category. Let’s say Heating for a temperature probe
  • Activate and make visible
  • In the Information block, choose the Temperature and Humidity category
  • Save the equipment

jeedom configuration equipement mqtt mosquitto

Finally, change the topic names. It is possible to choose whether or not to display each topic. You can test the correct data reception.

History of measures

Another small refinement to own its own home automation server, one can record the measures and the past actions. Small bug (of the version used for the article certainly), the button historiser disappears after a backup of the equipment. It is enough to leave and return on the card of the latter to make it visible.

Turn on Histo to keep measurements.

jeedom historiser valeur mqtt

To view the graphs, go to Analysis -> History

Choose the measurements to display on the graph.

View the Dashboard

Cool, more than just see what it looks like. Go to Home -> Dashboard

jeedom dashboard

At the top of the screen is a category filter (the bottom of each Widget and colored in a different color, eg blue for heating).

Then we find our Kitchen item with the previously created DHT22 equipment.

jeedom dashboard cuisine dht22

Here, I hope this little tutorial will help you. The MQTT plugin is really very simple to use. Little regrets, however. It is not possible (in the version of 13/04/2016) to assign a unit to the Topic, nor to associate the equipment with a Widget to customize the display in the Dashboard.

Subscribe to the weekly newsletter

No spam and no other use will be made of your email. You can unsubscribe anytime.


We will be happy to hear your thoughts

Leave a Reply

DIY Projects