ESPHome ESP8266 stellt physische Verbindung zu Ihrem Gerät her

Technische Daten

• Systemanforderungen: Control4 OS 3.3+

Überview

Integrieren Sie ESPHome-basierte Geräte in Control4. ESPHome ist ein Open-Source-System, das gängige Mikrocontroller wie ESP8266 und ESP32 durch einfache YAML-Konfiguration in Smart-Home-Geräte verwandelt. ESPHome-Geräte können über ein web Browser, Home Assistant oder andere kompatible Plattformen. Dieser Treiber ermöglicht die nahtlose Überwachung und Steuerung von ESPHome-Geräten direkt von Ihrem Control4-System aus.

Systemanforderungen

• Control4 OS 3.3+

Merkmale

• Lokale Netzwerkkommunikation erfordert keine Cloud-Dienste
• Echtzeit-Updates von allen unterstützten Entitäten, die vom Gerät bereitgestellt werden
• Unterstützt verschlüsselte Verbindungen mit dem Geräteverschlüsselungsschlüssel
• Unterstützung der variablen Programmierung

Kompatibilität

Verifizierte Geräte
Dieser Treiber funktioniert grundsätzlich mit jedem ESPHome-Gerät, wir haben ihn jedoch ausführlich mit den folgenden Geräten getestet:

• ratgdo – Konfigurationsanleitung

Wenn Sie diesen Treiber auf einem der oben aufgeführten Produkte ausprobieren und er funktioniert, lassen Sie es uns wissen!

Unterstützte ESPHome-Entitäten

Installationsprogramm einrichten

Pro ESPHome-Gerät ist nur eine Treiberinstanz erforderlich. Mehrere Instanzen dieses Treibers, die mit demselben Gerät verbunden sind, führen zu unerwartetem Verhalten. Sie können jedoch mehrere Instanzen dieses Treibers mit verschiedenen ESPHome-Geräten verbinden.

DriverCentral Cloud-Setup
Wenn Sie bereits über die DriverCentral Cloud-Treiber in Ihrem Projekt installiert ist, können Sie mit der Treiberinstallation fortfahren.

Dieser Treiber nutzt den DriverCentral Cloud-Treiber zur Verwaltung der Lizenzierung und automatischen Updates. Wenn Sie neu bei DriverCentral sind, können Sie sich an deren Cloud Driver-Dokumentation für die Einrichtung.

Treiberinstallation

Die Installation und Einrichtung des Treibers erfolgt ähnlich wie bei den meisten anderen IP-basierten Treibern. Nachfolgend finden Sie eine Übersicht der grundlegenden Schritte.

1. Laden Sie die neueste control4-esphome.zip aus DriverCentral.
2. Extrahieren und installieren Sie die esphome.c4z, esphome_light.c4z, Und esphome_lock.c4z Treiber.
3. Suchen Sie über die Registerkarte „Suchen“ nach dem Treiber „ESPHome“ und fügen Sie ihn Ihrem Projekt hinzu.
4. Wählen Sie den neu hinzugefügten Treiber im Reiter „Systemdesign“ aus. Der Cloud-Status spiegelt den Lizenzstatus wider. Wenn Sie eine Lizenz erworben haben, wird „Lizenz aktiviert“ angezeigt, andernfalls „Testversion läuft“ und die verbleibende Testdauer.
5. Sie können den Lizenzstatus aktualisieren, indem Sie auf der Registerkarte „Systemdesign“ den Treiber „DriverCentral Cloud“ auswählen und die Aktion „Treiber prüfen“ ausführen.
6. Konfigurieren Sie die Geräteeinstellungen mit den Verbindungsinformationen.
7. Nach einigen Augenblicken wird der Treiberstatus „Verbunden“ angezeigt. Sollte die Verbindung fehlschlagen, setzen Sie den Protokollmodus auf „Drucken“ und setzen Sie das Feld „IP-Adresse“ zurück, um die Verbindung wiederherzustellen. Weitere Informationen finden Sie im Lua-Ausgabefenster.
8. Nach der Verbindung erstellt der Treiber automatisch Variablen und Verbindungen für jeden unterstützten Entitätstyp.
9. Um Lichter und/oder Schlösser zu steuern, suchen Sie über die Registerkarte „Suchen“ nach den Treibern „ESPHome Light“ und/oder „ESPHome Lock“. Fügen Sie für jede verfügbare Licht- oder Schloss-Entität in Ihrem Projekt eine Treiberinstanz hinzu. Wählen Sie im Reiter „Verbindungen“ den Treiber „ESPHome“ aus und binden Sie die Licht- oder Schloss-Entitäten an die neu hinzugefügten Treiber.

Treiber-Setup

Treibereigenschaften

Cloud-Einstellungen

• Cloud-Status
  Zeigt den Lizenzstatus der DriverCentral-Cloud an.
• Automatische Updates
  Aktiviert/deaktiviert die automatischen Cloud-Updates von DriverCentral.

Treibereinstellungen

• Treiberstatus (schreibgeschützt)
  Zeigt den aktuellen Status des Treibers an.
• Treiberversion (schreibgeschützt)
  Zeigt die aktuelle Version des Treibers an.
• Protokollebene [ Schwerwiegend | Fehler | Warnung | Info | Debug | Trace | Ultra ] Legt die Protokollierungsebene fest. Standard ist Info.
• Protokollmodus [ Aus | Drucken | Protokoll | Drucken und Protokollieren ] Legt den Protokollierungsmodus fest. Standard ist Aus.

Geräteeinstellungen

IP-Adresse
Legt die IP-Adresse des Geräts fest (z. B. 192.168.1.30). Domänennamen sind zulässig, solange sie vom Controller in eine erreichbare IP-Adresse aufgelöst werden können. HTTPS wird nicht unterstützt.

Notiz: Wenn Sie eine IP-Adresse verwenden, sollten Sie sicherstellen, dass diese sich nicht ändert, indem Sie eine statische IP zuweisen oder eine DHCP-Reservierung erstellen.

Hafen
Legt den Geräteport fest. Der Standardport für ESPHome-Geräte ist 6053.

• Authentifizierungsmodus [ Keiner | Passwort | Verschlüsselungsschlüssel ]
• Wählt die Authentifizierungsmethode für die Verbindung mit dem ESPHome-Gerät aus.

Keiner: Keine Authentifizierung erforderlich.

Passwort: Verwenden Sie zur Authentifizierung ein Passwort (siehe unten).

Verschlüsselungsschlüssel: Verwenden Sie einen Verschlüsselungsschlüssel für eine sichere Kommunikation (siehe unten).

• Passwort
  Wird nur angezeigt, wenn der Authentifizierungsmodus auf „Passwort“ eingestellt ist. Legt das Gerätepasswort fest. Dieses muss mit dem auf dem ESPHome-Gerät konfigurierten Passwort übereinstimmen.
• Verschlüsselungsschlüssel
  Wird nur angezeigt, wenn der Authentifizierungsmodus auf Verschlüsselungsschlüssel eingestellt ist. Legt den Geräteverschlüsselungsschlüssel für sichere Kommunikation fest. Dieser muss mit dem auf dem ESPHome-Gerät konfigurierten Verschlüsselungsschlüssel übereinstimmen.

Geräteinformationen

• Name (schreibgeschützt)
  Zeigt den Namen des verbundenen ESPHome-Geräts an.
• Modell (schreibgeschützt)
  Zeigt das Modell des angeschlossenen ESPHome-Geräts an.
• Hersteller (schreibgeschützt)
  Zeigt den Hersteller des angeschlossenen ESPHome-Geräts an.
• MAC-Adresse (schreibgeschützt)
  Zeigt die MAC-Adresse des angeschlossenen ESPHome-Geräts an.
• Firmware-Version (schreibgeschützt)
  Zeigt die Firmware-Version des angeschlossenen ESPHome-Geräts an.

Fahreraktionen

Verbindungen und Variablen zurücksetzen

Warnung: Dadurch werden alle Verbindungsbindungen zurückgesetzt und alle mit den Variablen verknüpften Programmierungen gelöscht.

Setzen Sie die Treiberverbindungen und Variablen zurück. Dies ist nützlich, wenn Sie das angeschlossene ESPHome-Gerät ändern oder veraltete Verbindungen oder Variablen vorhanden sind.

ratgdo-Konfigurationshandbuch

Dieses Handbuch enthält Anweisungen zum Konfigurieren des ESPHome-Treibers für die Zusammenarbeit mit Ratgdo-Geräten zur Garagentorsteuerung über Relais in Control4 Composer Pro.

Relais-Controller-Treiber hinzufügen
Fügen Sie Ihrem Control4-Projekt in Composer Pro den gewünschten Relais-Controller-Treiber hinzu.

Eigenschaften des Relais-Controllers
Das ratgdo-Gerät stellt eine „Cover“-Entität in ESPHome bereit, die der Relaiscontroller-Funktionalität in Control4 zugeordnet ist.

Anzahl der Relais
Das ratgdo-Gerät verwendet eine Multi-Relais-Konfiguration zur Steuerung des Garagentors. In Composer Pro sollten Sie die Relaiseinstellungen wie folgt konfigurieren:

• Auf 2 Relais (Öffnen/Schließen) oder 3 Relais (Öffnen/Schließen/Stopp) einstellen
  • Das ratgdo-Gerät verwendet separate Befehle zum Öffnen und Schließen des Garagentors
  • Wenn Ihre Ratgdo-Firmware den Stopp-Befehl unterstützt, konfigurieren Sie drei Relais, um die Stopp-Funktion zu aktivieren. Im Zweifelsfall können Sie die Ratgdo-Verbindungen in Composer Pro überprüfen, um zu sehen, ob das „Stopp-Tür“-Relais verfügbar ist.

Relaiskonfiguration

• Eingestellt auf Impuls
  • ratgdo verwendet kurzzeitige Impulse, um den Garagentoröffner auszulösen, ähnlich wie bei einem Wandknopfdruck

Pulszeit

• Stellen Sie alle Relaisimpulszeiten auf 500 (Standard)
  • Dies ist die Dauer, für die das Relais aktiviert wird

Relais umkehren

• Stellen Sie alle Eigenschaften des Invertierungsrelais auf NEIN (Standard)

Kontakt Debounce

• Stellen Sie alle Kontaktentprellzeiten auf 250 (Standard)
  • Dies hilft, ein falsches Flattern der Garagentor-Zustandssensoren zu verhindern

Kontakt umkehren

• Setzen Sie alle invertierten Kontakteigenschaften auf NEIN (Standard)

ExampEigenschaften
Als Referenz ist hier ein BeispielampDatei der Relais-Controller-Eigenschaften in Composer Pro:

Relais-Controller-Anschlüsse

Relais

• Offen: Verbinden Sie sich mit dem „Open Door“-Relais des Ratgdo
• Schließen: Verbinden Sie sich mit dem „Tür schließen“-Relais des Ratgdo
• Stop: Verbinden Sie sich mit dem „Stopp-Tür“-Relais des Ratgdo, falls verfügbar

Kontaktsensoren

• Geschlossener Kontakt: Verbinden Sie sich mit dem „Tür geschlossen“-Kontakt des Ratgdo
• Geöffneter Kontakt: Verbinden Sie sich mit dem „Tür offen“-Kontakt des Ratgdo

Example Anschlüsse
Als Referenz ist hier ein BeispielampAbbildung, wie die Verbindungen in Composer Pro aussehen sollten:

Programmierung
Sie können in Control4 Programme erstellen, um:

• Öffnen/Schließen des Garagentors basierend auf Ereignissen
• Überwachen Sie den Zustand des Garagentors
• Benachrichtigungen für Statusänderungen von Garagentoren einrichten
• Erstellen Sie benutzerdefinierte Schaltflächen auf Touchscreens und Fernbedienungen

Example: Erstellen einer noch offenen Warnung

Verwenden der Eigenschaft „Still Open Time“ des Relais-Controller-Treibers:

1. Stellen Sie die „Still Open Time“ auf die gewünschte Dauer ein (z. B. 10 Minuten).
2. Erstellen Sie eine Programmierregel, die ausgelöst wird, wenn das Ereignis „Noch offen“ ausgelöst wird
3. Fügen Sie Aktionen hinzu, um Benachrichtigungen zu senden oder andere Aufgaben auszuführen

Zusätzliche Entitäten
Abhängig von Ihrem Ratgdo-Gerät, der Firmware und dessen Funktionen kann der ESPHome-Treiber zusätzliche Entitäten bereitstellen. Diese können als zusätzliche Verbindungen oder Treibervariablen vorliegen.

Weitere Informationen zu bestimmten Entitäten finden Sie in der Dokumentation von ratgdo: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Entwicklerinformationen
Copyright © 2025 Finite Labs LLC
Alle hierin enthaltenen Informationen sind und bleiben Eigentum von Finite Labs LLC und seinen Lieferanten, falls vorhanden. Die hierin enthaltenen geistigen und technischen Konzepte sind Eigentum von
Finite Labs LLC und seine Lieferanten können durch US-amerikanische und ausländische Patente, Patentanmeldungen und Urheberrechte geschützt sein. Die Verbreitung dieser Informationen oder die Vervielfältigung dieser Materialien ist ohne vorherige schriftliche Genehmigung von Finite Labs LLC strengstens untersagt. Aktuelle Informationen finden Sie unter https://drivercentral.io/platforms/control4-drivers/utility/esphome

Unterstützung
Wenn Sie Fragen oder Probleme bei der Integration dieses Treibers mit Control4 oder ESPHome haben, können Sie uns unter folgender Adresse kontaktieren: driver-support@finitelabs.com oder rufen Sie uns an oder schreiben Sie uns eine SMS unter +1 949-371-5805.

Änderungsprotokoll

v20250715 – 2025

• Behoben: Fehler behoben, der dazu führte, dass Entitäten beim Verbinden nicht erkannt wurden

v20250714 – 2025

• Hinzugefügt: Unterstützung für verschlüsselte Verbindungen mithilfe der Geräteverschlüsselung hinzugefügt

v20250619 – 2025

• Hinzugefügt : Ratgdo-spezifische Dokumentation hinzugefügt

v20250606 – 2025

• Hinzugefügt :Erstveröffentlichung

Häufig gestellte Fragen

Welche Geräte sind mit diesem Treiber kompatibel?

Dieser Treiber ist mit jedem ESPHome-Gerät kompatibel und wurde auf Ratgdo-Geräten umfassend getestet. Wenn Sie ihn auf einem anderen Gerät ausprobieren und er funktioniert, informieren Sie uns bitte zur Überprüfung.

Dokumente / Ressourcen

ESPHome ESP8266 stellt physische Verbindung zu Ihrem Gerät her [pdf] Benutzerhandbuch ESP8266, ESP32, ESP8266 Physische Verbindung zu Ihrem Gerät, ESP8266, Physische Verbindung zu Ihrem Gerät, Verbindung zu Ihrem Gerät, zu Ihrem Gerät, Ihrem Gerät

Verweise

• Bedienungsanleitung