❮ Controller wählen Verbindung: BLE (Bluetooth)

BLE-Öffnungscontroller

Wählen Sie ein fertiges Modul oder bauen Sie den Controller aus ein paar Teilen, stellen Sie ein paar Parameter ein und spielen Sie das fertige Programm direkt aus dem Browser auf.

Was die Firmware tut

Ein Telefon — das des Besitzers oder das eines Gastes mit gültigem Schlüssel — sendet den Befehl Öffnen direkt über Bluetooth, sobald Sie in der Nähe des Controllers sind. Der Controller schließt für kurze Zeit ein Kontaktpaar des Antriebs (standardmäßig eine Sekunde), genau wie eine gewöhnliche Taste, und öffnet es wieder; Strom schaltet er nicht. Für bistabile Antriebe und Schlösser lässt sich weiter unten ein Modus mit getrenntem Öffnen und Schließen und mit Positionsverfolgung aktivieren. Geöffnet wird per Fingertipp in der App; automatisches Öffnen bei Annäherung ist ebenfalls möglich.

Was drinsteckt

Die Verbindung zwischen Telefon und Controller ist ordentlich verschlüsselt — sie lässt sich weder fälschen noch abfangen. Es gibt nichts einzustellen, der Schutz ist bereits eingebaut. Zwischen zwei Öffnungen schläft der Controller und verbraucht fast keinen Strom.

1. Platine auswählen

Entscheiden Sie zuerst, worauf Sie bauen: Nehmen Sie ein fertiges Modul, bei dem Controller und Relais bereits zusammengelötet sind, oder bauen Sie ihn aus Einzelteilen (eine eigene ESP32-Platine plus Relaismodul). Tippen Sie auf Ihr Board, und wir zeigen die Verdrahtung, während die passenden Einstellungen unten ins Formular wandern. Ganz zum Schluss spielen Sie das fertige Programm — auch Firmware genannt — in den Controller.

Controller-Platinen

ESP32 mit Relais auf einer Platine

Fertige Platinen, auf denen ESP32 und Relais bereits zusammengelötet sind — ein separates Modul ist nicht nötig.

Fertige WLAN-Relais (Programm ersetzen)

Wenn Sie ein sauberes Werksgehäuse und ein zertifiziertes Relais möchten, nehmen Sie ein fertiges Gerät und spielen statt seines eigenen unser Programm auf. Innen steckt weiterhin ein gewöhnliches Relais: ein Kontaktpaar, das für einen Moment schließt und die Öffnen-Taste drückt. Ein solches Gerät braucht kein eigenes WLAN — Entrixy spricht direkt mit dem Telefon.

Was Sie sonst noch brauchen

Diese Bilder sind nicht anklickbar — sie zeigen nur, wie die Bauteile aussehen.

Relaismodul Nötig, wenn die Platine kein Relais hat. Drei Leitungen gehen zum ESP32: Steuerung, Versorgung und Masse (GND). Der Relaisausgang geht an den Antrieb

Programmiergerät mit Sockel In diesen Sockel steckt man ein nacktes ESP32- oder ESP32-S3-Modul, um das Programm aufzuspielen

USB-UART-Adapter Damit spielt man das Programm auf Relaisplatinen und auf Shelly auf — er wird an ein paar Pins angeschlossen

Smarte Steckdosen und WLAN-Schalter taugen hier nicht. Athom Plug, Shelly Plus Plug S und ähnliche Geräte schalten Netzspannung auf einen Verbraucher — sie haben keinen potentialfreien NO/COM-Ausgang, nur eine Steckdose. Für einen Torantrieb brauchen Sie ein Relais Plus 1 oder Plus 1PM oder eine selbstgebaute Platine mit Relaismodul.

Prüfen Sie vor dem Aufspielen des Programms auf ein fertiges Gerät, welcher Pin welcher ist. Hersteller verschieben die Pins von Zeit zu Zeit auch innerhalb desselben Modells. Wir haben die Schemata aus offenen Quellen genommen und an eigenen Exemplaren geprüft — Ihres kann leicht abweichen. Richten Sie sich nach den Beschriftungen auf der Platine selbst.

2. Platine

Platine welches ESP32-Modell — es bestimmt die verfügbaren Pins

Sie wissen nicht, welchen Chip Sie haben? Schließen Sie die Platine per USB-Kabel an den Rechner an (ein nacktes Modul über ein Programmiergerät) und drücken Sie die Schaltfläche — der Browser erkennt den Chip und wählt ihn oben in der Liste aus. Funktioniert am Desktop in Chrome oder Edge.

3. Schlossart

Die Hauptentscheidung: Sie legt fest, wie sich das Relais verhält. Impuls: ein einzelner Öffnen-Impuls. Bistabil: zwei Positionen, Öffnen und Schließen auf getrennten Pins; der Zustand wird gespeichert und in der App angezeigt.

Schlosstyp

Bistabiler Modus: Der Controller merkt sich die aktuelle Position (offen oder geschlossen) und schaltet sie bei jeder Auslösung um. Die Position ist am Objektsymbol in der App zu sehen, für Besitzer wie für Gast. Der Pin für den Befehl Schließen wird unten im Abschnitt Pins festgelegt.

4. Pins und Polarität

Relais und Schloss

Pin des Öffnungsrelais (PIN_RELAY) Die GPIO-Nummer, an der der Steuereingang des Relaismoduls hängt. Die Relaiskontakte (NO/COM) gehen an die Klemmen der Öffnen-Taste Ihres Antriebs — der Controller schließt sie kurz und ahmt so einen Druck nach. Im bistabilen Modus ist das der Pin fürs Öffnen. Wichtig: Die Massen (GND) von Controller und Relaismodul müssen verbunden sein — ohne gemeinsame Masse arbeitet das Relais nicht.

Pegel während des Impulses

Ruhepegel (zwischen den Impulsen)

Ein HIGH-Impuls passt zu direkten Transistorschaltern; ein LOW-Impuls (Impuls = LOW, Ruhe = HIGH) passt zu den meisten fertigen Relaismodulen und zu Shelly. Der Ruhepegel ist üblicherweise das Gegenteil des Impulses.

Impulslänge, ms Wie viele Millisekunden der Kontakt pro Auslösung geschlossen bleibt. Für eine Öffnen-Taste sind 500–2000 ms üblich. Zu kurz, und der Antrieb reagiert womöglich nicht; zu lang, und es gibt unnötige Erwärmung und Stromverbrauch.

Anzeigen

Öffnungs-LED (PIN_OPEN_LED) Der Pin einer externen Anzeige-LED. Sie leuchtet für die Dauer des Öffnungsimpulses. Hat Ihre Schaltung keine solche LED, tragen Sie -1 ein.

Polarität der Öffnungs-LED Wie die LED verdrahtet ist. Active-LOW heißt: Kathode an den Pin, Anode über einen Widerstand an die Versorgung — die übliche Variante. Active-HIGH ist umgekehrt.

Status-LED (eingebaut) Der Pin der eingebauten Anzeige-LED der Platine. Er hängt vom Modell ab: beim ESP32-S3 meist GPIO48, beim ESP32-C3 GPIO8, beim klassischen ESP32 (WROOM) GPIO2. Der Vorgabewert richtet sich nach dem oben gewählten Chip und lässt sich ändern. Tragen Sie -1 ein, wenn es keine solche LED gibt.

Polarität der Status-LED Sie leuchtet je nach Platine bei hohem oder niedrigem Pegel. Die meisten DevKits sind active-HIGH.

Kopplungstaste

Pin der Kopplungstaste (PIN_PAIR_BTN) Der Pin einer physischen Taste auf der Platine. Solange der Controller nicht gekoppelt ist, startet ein kurzer Druck die Kopplung mit einem Telefon. Ein langer Druck setzt die Kopplung auf den Auslieferungszustand zurück. Auf den meisten Platinen ist das die eingebaute BOOT-Taste, GPIO0.

Haltedauer für das Zurücksetzen, ms Wie viele Millisekunden die Taste gehalten werden muss, damit das Zurücksetzen der Kopplung auslöst. Zum Schutz vor Versehen sind das üblicherweise 5000 ms, also fünf Sekunden.

Diagnose

Debug-Ausgabe (UART) Ein technisches Protokoll auf die serielle Schnittstelle, nur beim Debuggen nötig. Beim ESP32-S3 belegt die Schnittstelle GPIO43 und GPIO44. Im Normalbetrieb schaltet man sie besser ab: Es wird kein Protokoll geschrieben, und die beiden Pins stehen für das Relais frei.

5. Stromversorgung und Akkusparen

Periode des Advertising-Zyklus, ms Wie oft der Controller aufwacht und auf Sendung geht — der volle Zyklus aus Advertising plus Schlaf. Ein kleinerer Wert bedeutet, dass das Telefon das Gerät schneller findet, die Batterien aber rascher leer werden. Ein größerer spart Strom auf Kosten einer etwas langsameren Reaktion.

Länge des Advertising-Fensters, ms Wie viele Millisekunden der Controller in einem Zyklus aktiv sendet, bevor er schlafen geht. Das muss lang genug sein, damit ein Telefon das Gerät erwischt und sich verbindet — üblich sind 1500–2000 ms.

Verbindung halten, ms Hat sich ein Telefon verbunden, bleibt der Controller so viele Millisekunden länger wach, um den Befehl entgegenzunehmen und zu antworten.

Kopplungsfenster, ms Wie lange der Controller im Kopplungsmodus auf ein Telefon wartet, bevor er schlafen geht. Neunzig Sekunden reichen auch für langsame Telefone.

Schlaf zwischen den Zyklen, s Wie viele Sekunden der Controller zwischen zwei Advertising-Zyklen schläft. 0 heißt: gar kein Schlaf, für Netz- oder USB-Betrieb. Auf Batterien liegt der Sweet Spot bei 10–20 Sekunden: Zwei AA-Zellen halten Monate.

6. Externe Uhr (optional)

Ein kleines Uhrenmodul (DS3231, DS1307 oder PCF8563) mit eigener Knopfzelle hält die Zeit jahrelang genau. Ohne ein solches Modul läuft die interne Uhr des Controllers merklich davon, um etwa 5 % pro Stunde. Genaue Zeit ist nur wichtig, wenn Sie Gästen zeitlich begrenzte Schlüssel ausstellen — sonst überspringen Sie diesen Abschnitt.

Typ der externen RTC

Diese Konfiguration speichern

Kurzer Name Zum Beispiel „Schranke im Hof“ oder „Tor am Landhaus“. Sind Sie angemeldet, wandert sie in Ihr Konto und steht auf jedem Gerät zur Verfügung. Sonst wird sie in diesem Browser gespeichert, damit Sie nicht alles erneut einstellen müssen.

Programm bauen und aufspielen

Der Server baut das Programm (die Firmware) genau für Ihre Einstellungen. Sie können die Datei herunterladen oder sie direkt aus dem Browser in den Controller spielen.

Kopplung mit der App behalten (Firmware aktualisieren, ohne Einstellungen zu löschen)

Wenn Sie hineinsehen, von Hand nachbessern, .ino herunterladen oder einen Link teilen möchten, drücken Sie „Im Editor öffnen“. Es ist derselbe Quelltext, den der Server zu .bin.

Als Nächstes: den Controller in der App koppeln

Nach dem Aufspielen wartet der Controller 90 Sekunden im Kopplungsmodus auf einen Besitzer. Öffnen Sie die Entrixy-App in der Rolle Besitzer → Objekt hinzufügen → BLE — der Controller erscheint in der Liste, wählen Sie ihn aus. Erscheint er nicht, drücken Sie die Kopplungstaste auf der Platine, die LED beginnt zu blinken und die Liste aktualisiert sich. Die App tauscht die Schlüssel aus, und der Controller gehört Ihnen. Einzelheiten stehen in der Anleitung, Abschnitt „Kopplung“.

Relais an den Antrieb anschließen

Sie nutzen zwei Kontakte am Relais: NO (Schließer) und COM (gemeinsam). Diese beiden Leitungen gehen an die Klemmen „Öffnen-Taste“ auf der Steuerplatine Ihres Antriebs.

Antrieb	Wohin NO/COM anschließen
BFT (Phobos, Deimos, Ares)	Klemmen `START` oder `OPEN` (im Schaltplan meist mit 21–22 nummeriert)
CAME (BX, ATI, BK)	Klemmen `2–7` (öffnen), oder PED für eine Gehtür
NICE (Robus, Run, Spin)	Klemmen `1–3` (Schritt für Schritt)
FAAC (740, 844, 391)	Klemmen `OPEN A` (vollständig öffnen)
DoorHan (Sliding, Arm)	Klemmen `CMD` + `GND`
Schranke	Die Säule mit der Öffnen-Taste — parallel zu deren Kontakten
Sprechanlage (Cyfral, Vizit, Eltis)	Das Relais parallel zur Türöffnertaste am Hörer oder direkt an die Klemmen des Magnetschlosses

Die genauen Bezeichnungen finden Sie im Handbuch Ihrer Steuerplatine. Ist die Platine bereits verdrahtet und in Betrieb, suchen Sie die beiden Leitungen von der Säule mit der Öffnen-Taste und schließen Sie NO/COM des Relais parallel dazu an.

Aufspielen mit esptool (falls es über den Browser nicht klappte)

Laden Sie .bin oben herunter.
Installieren Sie esptool: pip install esptool
Schließen Sie den ESP per USB an.
Spielen Sie sie auf: esptool.py --chip auto --port /dev/ttyUSB0 write_flash 0x0 entrixy-ble.bin
Unter Windows heißt der Port meist COM3 oder COM4.

Zugang zum UART bei fertigen WLAN-Relais

Fertige Geräte (Shelly Plus 1, Plus 1PM) haben kein externes USB. Sie müssen das Gehäuse öffnen und sich mit einem USB-UART-Adapter an die UART-Pins des ESP32 anschließen — CP2102, CH340 oder FTDI, ganz gleich welcher.

Allgemeine Verdrahtung

USB-UART-Adapter	ESP32 auf der Platine
GND	GND
3.3V	3V3 (nur wenn Sie über den Adapter versorgen wollen; sonst lassen Sie das Gerät an seiner eigenen Versorgung)
TX	RX
RX	TX
—	EN (RESET) — kurz auf GND, um in den Bootloader zu starten
—	GPIO0 — beim Einschalten auf GND, um in den Bootloader zu gelangen

Legen Sie keine Netzspannung an die Netzklemmen des Geräts, solange der USB-Adapter angeschlossen ist. Versorgen Sie es entweder über die 3,3 V des Adapters oder lassen Sie die Netzversorgung vollständig getrennt. Andernfalls können die Massen von USB und Netz auf unterschiedlichem Potential liegen, und der USB-Port Ihres Rechners wird zerstört.

Pinbelegung nach Modell

Gerät	Wo der UART sitzt	In den Bootloader gelangen
Shelly Plus 1 / Plus 1PM	Im Gehäuse neben dem ESP32-Modul. Die Pads sind beschriftet mit `3V3 GND TX RX GPIO0`. Nehmen Sie die vordere Abdeckung ab (zwei oder drei Clips); die Platine liegt obenauf.	GPIO0 auf GND legen und EN kurz auf GND ziehen

Steht Ihr Modell hier nicht:

templates.blakadder.com — eine offene Datenbank mit Tasmota-Vorlagen samt GPIOs für jedes Modell. Auf unsere Einstellungen übertragen: Relay1 → der Relais-Pin, Button1 → der Tasten-Pin, Led1 → die Status-LED.
devices.esphome.io — das ESPHome-Verzeichnis.
Ist das Modell nirgends zu finden, greifen Sie zum Multimeter: Klingeln Sie die Relaisspule bis zu einem GPIO des ESP32 durch. Das ist Ihr PIN_RELAY.

BLE funktioniert nur auf dem ESP32. Für einen ESP8266 (Wemos D1, NodeMCU) oder ein fertiges WLAN-Relais nutzen Sie den Internet-Konfigurator — dort läuft die Verbindung über das Internet.

Wenn Sie das Programm lieber nicht selbst aufspielen

Drei Wege, die das umgehen:

Selbst bauen — nehmen Sie eine ESP32-DevKit-Platine (etwa 5 $) und ein beliebiges 3,3-V-Relaismodul (etwa 2 $). Eine Abzweigdose dient als Gehäuse. An den Antrieb wird es wie ein industrielles Relais angeschlossen. Das ist der empfohlene Weg für die meisten Selbstbaufälle.
Ein Internetgerät — spielen Sie einem fertigen WLAN-Relais mit potentialfreiem Kontakt (Shelly Plus 1) unser Programm im Internet-Konfiguratorauf, oder Sie belassen die eigene Firmware und öffnen es über ein Webhook. Am Antrieb werden WLAN und Netzstrom benötigt.
Fertige Firmware ab Werk — Tasmota oder ESPHome. In der App legen Sie ein Webhook-Objekt mit der Adresse des Geräts an. Das passt, wenn Sie unser Programm gar nicht erst auf das Gerät spielen möchten.

Warten Sie nach dem Druck auf die Schaltfläche einen Moment — die Datei ist meist in weniger als einer Minute fertig. Sobald das Programm gebaut ist, erscheint eine Schaltfläche zum Herunterladen.