浪人
DE | EN
Control Hörmann Garage Doors with ESPHome and Home Assistant
tech

Control Hörmann Garage Doors with ESPHome and Home Assistant

Back to Blog
4 min read

Control Hörmann Garage Doors with ESPHome and Home Assistant

Introduction

If you own a Hörmann Series 4 garage door (e.g., SupraMatic E4, P4, or H4), the tynet RS485 Bridge DIY Adapter offers an elegant way to integrate your door into Home Assistant locally without the cloud. This small ESP32-S3 board emulates the Hörmann UAP1-HCP module and communicates directly with the drive via the HCP2 bus.

In this article, I’ll show you how I flashed the board with ESPHome, connected it to the SupraMatic E4, and integrated it into Home Assistant with a beautiful Mushroom Card.

What You Need

Why ESPHome Instead of the Standard Firmware?

The board comes with an Arduino-based MQTT firmware that works out of the box. However, there’s also an ESPHome-based firmware available - and for Home Assistant users, it has clear advantages:

The ESPHome variant uses the native Home Assistant API instead of MQTT, eliminating the need for a separate MQTT broker. Devices are automatically discovered in HA, entities are immediately available, and OTA updates run directly from the ESPHome dashboard. If you’re already running an MQTT broker, you can stick with the standard firmware - both options are equally valid, it’s a matter of your setup preferences.

The best part: you can switch between firmware versions anytime.

Step 1: Flash ESPHome Firmware

Important: The board must never be connected simultaneously via USB-C to your PC and via RJ12 to the garage door - this can damage the board!

hcpdevice beimflashen

Create ESPHome Device

  1. In Home Assistant → open ESPHome Add-on
  2. “New Device” → “New Device Setup”
  3. Assign a device name, e.g., hoermann-garagentor
  4. Connect the board to your PC via USB-C
  5. Click “Connect” - hold the BOOT button on the board while connecting, release only when “Connected” appears
  6. Base firmware is flashed

Customize YAML Configuration

After the first flash, replace the generated YAML entirely. Set the framework to arduino (the tynet package requires Arduino, not esp-idf) and include the tynet package:

esphome:
  name: hoermann-garagentor
  friendly_name: hoermann-garagentor

packages:
  tynet.hcpbridge_e4: github://Tysonpower/HCPBridgeMqtt_tynet/esphome.yaml@main

esp32:
  board: esp32-s3-devkitc-1
  framework:
    type: arduino

api:
  encryption:
    key: "YOUR_API_KEY"

ota:
  - platform: esphome
    password: "YOUR_OTA_PASSWORD"

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  ap:
    ssid: "Hoermann-Garagentor"
    password: "fallback-password"

captive_portal:

Add Secrets

The tynet package requires the following entries in ESPHome’s secrets.yaml:

wifi_ssid: "YourWLAN"
wifi_password: "YourWLANPassword"
api_key: "YOUR_API_KEY"
web_username: "admin"
web_password: "tynet.eu"
hcp_wifi_ap_password: "tynet.eu"

Build and Flash Firmware

  1. Install → Manual download → Factory format (.bin) download
  2. Open web.esphome.io
  3. Hold BOOT button → Connect → select TinyUSB
  4. Install → select .bin file → flash
  5. Disconnect USB-C, power cycle the board
  6. After ~30 seconds, the device should appear in your WiFi network

Step 2: Connect Board to Garage Door

3dgehaeuse Imgehaeuse Antrieb

The board optionally fits into a handy 3D-printed enclosure that can be mounted directly on the drive.

Important per Hörmann instructions: Insert the RJ12 cable while the power is off:

  1. Unplug the drive’s power cable
  2. Insert the RJ12 cable into the BUS connector on the SupraMatic
  3. Plug the drive back in

Step 3: Bus Scan on SupraMatic E4

To make the drive recognize the new board, perform a bus scan:

  1. Hold the PRG button until the display shows 00
  2. Navigate to Menu 37 using the arrow buttons
  3. Press PRG → select Submenu 01
  4. Hold PRG until “bS” appears in the display, then release
  5. Wait for the scan to complete - on success, a 1 briefly appears, then the display returns to 37

The board is now registered on the bus and the device should come online in ESPHome.

Step 4: Add to Home Assistant

HA automatically recognizes the new ESPHome device. A notification to add it appears under Settings → Devices & Services. After integration, all entities are immediately available.

Step 5: Set Up Mushroom Card

For a beautiful dashboard display, I recommend the Mushroom Cards from HACS.

Installation

  1. Open HACS → “Explore & download repositories”
  2. Search for “Mushroom” → install by piitaya
  3. Restart HA

Add Card

Add a new card to your dashboard and select “Mushroom Cover Card”. Select the cover. entity of your garage door - done.

mushroomconfig mushroomfinished

The result displays the current status (Open/Closed), position as a percentage, and buttons for open, stop, close, and ventilation position.

webui

You can also control the door directly via the board’s integrated web UI (accessible at http://hoermann-garagentor.local) without Home Assistant.

Conclusion

The tynet RS485 Bridge Adapter is a well-thought-out and well-documented solution for local Hörmann integration. With ESPHome, everything runs without the cloud, without an MQTT broker, and with native Home Assistant integration. Installation has a few pitfalls (holding BOOT while flashing, setting the framework to Arduino, adding the necessary secrets for the tynet package), but it’s definitely doable.

The 3D-printed enclosure is a nice extra that ties everything together neatly. If you have a Series 4 Hörmann door and use Home Assistant, you get a full-featured local smart home integration for a small cost.