浪人
DE | EN
Hörmann Garagentor mit ESPHome und Home Assistant steuern
tech

Hörmann Garagentor mit ESPHome und Home Assistant steuern

Zurück zum Blog
3 Min. Lesezeit

Hörmann Garagentor mit ESPHome und Home Assistant steuern

Einleitung

Wer ein Hörmann Garagentor der Series 4 (z.B. SupraMatic E4, P4 oder H4) besitzt, hat mit dem tynet RS485 Bridge DIY Adapter eine elegante Möglichkeit, das Tor lokal und ohne Cloud in Home Assistant einzubinden. Das kleine ESP32-S3 Board emuliert dabei das Hörmann UAP1-HCP Modul und kommuniziert über den HCP2-Bus direkt mit dem Antrieb.

In diesem Artikel zeige ich, wie ich das Board mit ESPHome geflasht, am SupraMatic E4 angeschlossen und in Home Assistant mit einer schönen Mushroom Card integriert habe.

Was du brauchst

Warum ESPHome statt der Standard-Firmware?

Das Board wird mit einer Arduino-basierten MQTT-Firmware ausgeliefert, die sofort funktioniert. Daneben gibt es aber auch eine ESPHome-basierte Firmware - und die hat für Home Assistant-Nutzer klare Vorteile:

Die ESPHome-Variante nutzt die native Home Assistant API statt MQTT, wodurch kein separater MQTT-Broker nötig ist. Geräte werden automatisch in HA erkannt, Entities sind sofort verfügbar, und OTA-Updates laufen direkt aus dem ESPHome-Dashboard. Wer bereits einen MQTT-Broker betreibt, kann natürlich bei der Standard-Firmware bleiben - beide Optionen sind gleichwertig, es ist eine Frage des persönlichen Setups.

Das Gute: Man kann jederzeit zwischen den Firmwares wechseln.

Schritt 1: ESPHome Firmware flashen

Wichtig: Das Board darf niemals gleichzeitig per USB-C am PC und per RJ12 am Garagentor angeschlossen sein - das kann das Board beschädigen!

hcpdevice beimflashen

ESPHome Gerät anlegen

  1. In Home Assistant → ESPHome Add-on öffnen
  2. “New Device” → “New Device Setup”
  3. Gerätename vergeben, z.B. hoermann-garagentor
  4. Board per USB-C an den PC anschließen
  5. “Connect” klicken - beim Verbinden die BOOT-Taste am Board gedrückt halten, erst loslassen wenn “Connected” erscheint
  6. Basis-Firmware wird geflasht

YAML Konfiguration anpassen

Nach dem ersten Flash die generierte YAML komplett ersetzen. Dabei das Framework auf arduino setzen (das tynet Package benötigt Arduino, nicht esp-idf) und das tynet Package einbinden:

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: "DEIN_API_KEY"

ota:
  - platform: esphome
    password: "DEIN_OTA_PASSWORD"

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

captive_portal:

Secrets ergänzen

Das tynet Package benötigt folgende Einträge in der ESPHome secrets.yaml:

wifi_ssid: "DeinWLAN"
wifi_password: "DeinWLANPasswort"
api_key: "DEIN_API_KEY"
web_username: "admin"
web_password: "tynet.eu"
hcp_wifi_ap_password: "tynet.eu"

Firmware bauen und flashen

  1. Install → Manual download → Factory format (.bin) herunterladen
  2. web.esphome.io öffnen
  3. BOOT-Taste gedrückt halten → Connect → TinyUSB auswählen
  4. Install → .bin Datei auswählen → flashen
  5. USB-C trennen, Board kurz stromlos machen
  6. Nach ~30 Sekunden sollte das Gerät im WLAN erscheinen

Schritt 2: Board am Garagentor anschließen

3dgehaeuse Imgehaeuse Antrieb

Das Board passt optional in ein praktisches 3D-gedrucktes Gehäuse, das sich direkt am Antrieb montieren lässt.

Wichtig laut Hörmann-Anleitung: Das RJ12-Kabel im stromlosen Zustand einstecken:

  1. Stromkabel des Antriebs aus der Steckdose ziehen
  2. RJ12-Kabel in den BUS-Anschluss am SupraMatic stecken
  3. Antrieb wieder an den Strom anschließen

Schritt 3: Bus-Scan am SupraMatic E4

Damit der Antrieb das neue Board erkennt, muss ein Bus-Scan durchgeführt werden:

  1. PRG-Taste länger gedrückt halten bis Display 00 zeigt
  2. Mit Pfeiltasten zu Menü 37 navigieren
  3. PRG-Taste drücken → Untermenü 01 auswählen
  4. PRG-Taste gedrückt halten bis “bS” im Display erscheint, dann loslassen
  5. Warten bis der Scan abgeschlossen ist - bei Erfolg erscheint kurz eine 1, dann springt das Display zurück auf 37

Das Board ist nun am Bus registriert und das Gerät sollte in ESPHome online gehen.

Schritt 4: In Home Assistant einbinden

HA erkennt das neue ESPHome-Gerät automatisch. Unter Einstellungen → Geräte & Dienste erscheint eine Benachrichtigung zum Hinzufügen. Nach der Integration stehen alle Entities direkt zur Verfügung.

Schritt 5: Mushroom Card einrichten

Für eine schöne Darstellung im Dashboard empfehle ich die Mushroom Cards aus HACS.

Installation

  1. HACS öffnen → “Explore & download repositories”
  2. Nach “Mushroom” suchen → von piitaya installieren
  3. HA neu starten

Card hinzufügen

Im Dashboard eine neue Karte hinzufügen und “Mushroom Cover Card” auswählen. Die cover. Entity des Garagentors auswählen - fertig.

mushroomconfig mushroomfinished

Das Ergebnis zeigt den aktuellen Status (Open/Closed), die Position in Prozent sowie Buttons für Auf, Stop, Zu und Lüftungsposition.

webui

Über die integrierte Web-UI des Boards (erreichbar unter http://hoermann-garagentor.local) lässt sich das Tor zusätzlich direkt steuern, ohne Home Assistant.

Fazit

Der tynet RS485 Bridge Adapter ist eine durchdachte und gut dokumentierte Lösung für die lokale Hörmann-Integration. Mit ESPHome läuft alles ohne Cloud, ohne MQTT-Broker und mit nativer Home Assistant Integration. Die Installation hat ein paar Stolpersteine (BOOT-Taste beim Flashen, Framework auf Arduino setzen, die nötigen Secrets für das tynet Package), ist aber gut machbar.

Das 3D-gedruckte Gehäuse ist ein nettes Extra das das Ganze ordentlich abschließt. Wer ein Series 4 Hörmann Tor hat und Home Assistant nutzt, bekommt hier für kleines Geld eine vollwertige lokale Smart-Home Integration.