Control Hörmann doors drives directly via MQTT from Home Assistant

Inspired by https://blog.bouni.de/posts/2018/hoerrmann-uap1/

USE AT YOUR OWN RISK!

This repo contains the pcb files as well as the software to build an interface device which connects Hörmann door drives like the Supramatic E3 to Home Assistant. The interface device emulates an UAP1 to interact with the door drive. Additionally a BME280 can be connected via I2C to measure temperature, humidity and pressure.

Home Assistant dashboard panel

• board: The Eagle schematic and board files
• docs: Documentation
• esp8266: Arduino project. Communication to Home Assistant via wifi and mqtt
• homeassistant: configuration snippet for Home Assistant
• pic16: MPLabX project. Communication with door drive via Hörmann bus

1. Get a pcb
   • Optionally, get BME280 sensor pcb
   • Supply pcb with 24V via pins 2 & 3 of J1
   • Check if 5V and 3.3V are fine
2. Get tools listed below
3. Rename esp8266/config_template.h to esp8266/config.h and adjust to your environment
4. Add esp8266 boards to Arduino IDE
   • Open Preferences window
   • Enter http://arduino.esp8266.com/stable/package_esp8266com_index.json into Additional Board Manager URLs field. You can add multiple URLs, separating them with commas.
   • Open Boards Manager from Tools > Board menu and find esp8266 platform.
   • Click install button.
   • Select NodeMCU 1.0 (ESP-12E Module) as board
5. Add Libraries to Arduino IDE
   • Open Sketch > Include library -> Manage libraries...
   • Install PubSubClient (tested with version 2.8.0)
   • Install PubSubClientTools (tested with version 0.6.0)
   • Install Adafruit Unified Sensor (tested with version 1.1.4)
   • Install Adafruit BME280 Library (tested with version 2.1.2)
6. First flashing of esp8266
   • Get a cheap USB-UART converter (like the ones with a CP210x)
   • Connect the converter to SV3 (RX, TX and GND)
   • Short JP1 (Boot mode)
   • Power up board. If board was powered before reset esp8266 by shorting JP2(Reset) for a short time
7. Flashing pic16
   • Use any Microchip programmer (PICkit3, ICD3, ...)
   • Open MPLabX and click on File -> Open Project
   • Select pic16 subfolder (chip icon)
   • Click Clean an Build Main Project
   • Click Make and Program Device Main Project

• Eagle 7.2.0

• Arduino IDE 1.8.13
• USB-UART converter

• MPLabX v5.25
• XC8 v2.10
• PICkit3