Awesome Open Source
Awesome Open Source

ESP MQTT JSON Multisensor

This project shows a super easy way to get started with your own DIY Multisensor to use with Home Assistant, a sick, open-source Home Automation platform that can do just about anything.

Bonus, this project requires no soldering and no breadboards - just header wires and the development board!

Video Tutorial -

The code covered in this repository utilizies Home Assistant's MQTT JSON Light Component, MQTT Sensor Component, and a NodeMCU ESP8266 development board.

Supported Features Include

  • DHT22 temperature sensor
  • DHT22 humidity sensor
  • AM312 PIR motion sensor
  • photoresistor or TEMT600 light sensor
  • RGB led with support for color, flash, fade, and transition
  • Over-the-Air (OTA) upload from the ArduinoIDE

OTA Uploading

This code also supports remote uploading to the ESP8266 using Arduino's OTA library. To utilize this, you'll need to first upload the sketch using the traditional USB method. However, if you need to update your code after that, your WIFI-connected ESP chip should show up as an option under Tools -> Port -> Porch at More information on OTA uploading can be found here. Note: You cannot access the serial monitor over WIFI at this point.

Parts List

Amazon Prime (fast shipping)

Aliexpress (long shipping = cheap prices)

Wiring Diagram

alt text

3D Printed Enclosure

In an effort to make the sensor less ugly, I designed an enclosure in 123D Design and uploaded the STL file in case you want to print your own. It's also availible on Thingiverse. I printed mine on a Prusa I3 clone with a layer height of 0.2 mm, 40% infill, and no supports in ESUN PLA and it turned out great.

Alternatively, you can also make your own enclosure by hand using something like Instamorph. It's themoplastic that melts in hot water and then solidifies to hard plastic at room temperature. You can even get pigment packs and take it next level. I, personally, suck at using it, but it's cheap and functional.

Of course, you can use a project box, tupperware, a card board box, or skip the enclosure all together.

alt text


I added a second version of my enclosure that moves the DHT22 sensor outside the case, removes the standoff for the LDR sensor, and adds a pocket for the LED. This should reduce most of the high temperatures being reported by the board and the removal of the standoff allows you to use either the TEMT600 sensor or photoresistor module. A dab of hot glue can help hold everything in place until you can snap the case together.

A few people have reported that the floating PIR sensor issue is back. If it happens, wrap the PIR module in electrical tape, then aluminum foil, and then electrical tape again. Using the tape will make sure you don't short anything out with the foil on either the module or other components in the system.

Home Assistant Service Examples

Besides using the card in Home Assistant's user interface, you can also use the Services tool to control the light using the light.turn_on and light.turn_off services. This will let you play with the parameters you can call later in automations or scripts.

Fade the Light On Over 5 Seconds - light.turn_on


Flash The Light - light.turn_on


Fade the Light Off Over 5 Seconds - light.turn_off


Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
C Plus Plus (258,872
Json (40,103
Sensor (15,763
Led (9,300
Wifi (8,780
Esp (8,347
Mqtt (8,120
Temperature (7,387
Esp8266 (5,125
Home Assistant (4,229
Nodemcu (1,601
Dht (1,585
Ota (965
Humidity (203
Motion Detector (24
Enclosure (22
Multisensor (20
Photoresistor (8
Sensor Node (8