/esp8266-mqtt-doorbell

Simple yet effective program written in MicroPython to read the status of a reed sensor using an NodeMCU ESP8266 microcontroller and publish it's value to a MQTT broker.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

⚠️ UNMAINTAINED ⚠️

This project is superseded by Franck Nijhof's project as it is a way more accurate way of detecting a doorbell press. I'd definitely recommend to check his project out instead.

Introduction:

When you press a doorbell button, you complete an electrical circuit that allows household electricity to flow through the doorbell's internal electromagnet. The magnetic field generated by the electromagnet is then used to power a mechanism that creates the doorbell sound. By placing the reed sensor next to the 'dumb doorbell' you can sense it's magnetic field and integrate it in your smart home setup. Pretty neat huh?!

Project Goal:

Sending a MQTT payload whenever the door sensor is triggered by the doorbell from the ESP8266 which can be read by Home Assistant. From thereon a notification event should started and notify me through Pushover's API.

Requirements:

  1. ESP8266 (Available at Amazon or Banggood)
  2. Reed Door Sensor / Magnetic Contact Switch (Available at Amazon or Banggood)
  3. Running MQTT broker (like mosquitto)
  4. Home Assistant
  5. Pushover