ESPHome ESP8266 łączy się fizycznie z urządzeniem

Specyfikacje

• Wymagania systemowe: Control4 OS 3.3+

Nadview

Zintegruj urządzenia oparte na ESPHome z Control4. ESPHome to system open source, który przekształca popularne mikrokontrolery, takie jak ESP8266 i ESP32, w inteligentne urządzenia domowe poprzez prostą konfigurację YAML. Urządzenia ESPHome można konfigurować, monitorować i sterować za pomocą web Przeglądarka internetowa, Home Assistant lub inne kompatybilne platformy. Ten sterownik umożliwia płynne monitorowanie i sterowanie urządzeniami ESPHome bezpośrednio z systemu Control4.

Wymagania systemowe

• Control4 OS 3.3+

Cechy

• Komunikacja w sieci lokalnej nie wymagająca usług w chmurze
• Aktualizacje w czasie rzeczywistym ze wszystkich obsługiwanych jednostek udostępnianych przez urządzenie
• Obsługuje szyfrowane połączenia przy użyciu klucza szyfrującego urządzenia
• Wsparcie programowania zmiennych

Zgodność

Zweryfikowane urządzenia
Ten sterownik będzie zasadniczo działał z dowolnym urządzeniem ESPHome, ale przeprowadziliśmy szczegółowe testy z następującymi urządzeniami:

• ratgdo – Przewodnik po konfiguracji

Jeśli wypróbujesz ten sterownik na którymś z produktów wymienionych powyżej i zadziała, daj nam znać!

Obsługiwane jednostki ESPHome

Instalacja instalatora

Do każdego urządzenia ESPHome wymagana jest tylko jedna instancja sterownika. Wiele instancji tego sterownika podłączonych do tego samego urządzenia będzie działać w nieoczekiwany sposób. Można jednak mieć wiele instancji tego sterownika podłączonych do różnych urządzeń ESPHome.

Konfiguracja chmury DriverCentral
Jeśli już masz Sterownik w chmurze DriverCentral Po zainstalowaniu sterownika w projekcie możesz kontynuować instalację.

Ten sterownik korzysta ze sterownika w chmurze DriverCentral do zarządzania licencjami i automatycznymi aktualizacjami. Jeśli dopiero zaczynasz korzystać z DriverCentral, zapoznaj się z ich informacjami. Dokumentacja Cloud Driver za jego konfigurację.

Instalacja sterownika

Instalacja i konfiguracja sterownika przebiega podobnie jak w przypadku większości innych sterowników opartych na protokole IP. Poniżej znajduje się opis podstawowych kroków, dla ułatwienia.

1. Pobierz najnowszą wersję control4-esphome.zip z DriverCentral.
2. Wypakuj i zainstaluj esphome.c4z, esphome_light.c4z, I esphome_lock.c4z kierowcy.
3. Użyj zakładki „Szukaj”, aby znaleźć sterownik „ESPHome” i dodać go do swojego projektu.
4. Wybierz nowo dodany sterownik na karcie „Projekt systemu”. Zauważysz, że status chmury odzwierciedla stan licencji. Jeśli zakupiłeś licencję, pojawi się komunikat „Licencja aktywowana”, w przeciwnym razie „Test w toku” i pozostały czas trwania okresu próbnego.
5. Status licencji można odświeżyć, wybierając sterownik „DriverCentral Cloud” na karcie „Projekt systemu” i wykonując czynność „Sprawdź sterowniki”.
6. Skonfiguruj Ustawienia urządzenia z informacjami o połączeniu.
7. Po chwili stan sterownika wyświetli komunikat „Połączono”. Jeśli sterownik nie nawiąże połączenia, ustaw właściwość Tryb logowania na „Drukuj” i zresetuj pole Adres IP, aby ponownie nawiązać połączenie. Następnie sprawdź okno wyjściowe Lua, aby uzyskać więcej informacji.
8. Po nawiązaniu połączenia sterownik automatycznie utworzy zmienne i połączenia dla każdego obsługiwanego typu jednostki.
9. Aby sterować oświetleniem i/lub zamkami, skorzystaj z zakładki „Szukaj”, aby znaleźć sterownik „ESPHome Light” i/lub „ESPHome Lock”. Dodaj jedną instancję sterownika dla każdego widocznego elementu oświetlenia lub zamka w projekcie. Na karcie „Połączenia” wybierz sterownik „ESPHome” i powiąż elementy oświetlenia lub zamka z nowo dodanymi sterownikami.

Konfiguracja sterownika

Właściwości sterownika

Ustawienia chmury

• Status chmury
  Wyświetla status licencji w chmurze DriverCentral.
• Aktualizacje automatyczne
  Włącza/wyłącza automatyczne aktualizacje w chmurze DriverCentral.

Ustawienia sterownika

• Status kierowcy (tylko do odczytu)
  Wyświetla aktualny status kierowcy.
• Wersja sterownika (tylko do odczytu)
  Wyświetla aktualną wersję sterownika.
• Poziom dziennika [ Krytyczny | Błąd | Ostrzeżenie | Informacje | Debugowanie | Ślad | Ultra ] Ustawia poziom rejestrowania. Domyślnie jest to Informacje.
• Tryb rejestrowania [Wył. | Drukuj | Rejestruj | Drukuj i rejestruj] Ustawia tryb rejestrowania. Domyślnie jest to Wyłączony.

Ustawienia urządzenia

Adres IP
Ustawia adres IP urządzenia (np. 192.168.1.30). Nazwy domen są dozwolone, pod warunkiem że kontroler może je rozwiązać na dostępny adres IP. Protokół HTTPS nie jest obsługiwany.

Notatka: Jeśli używasz adresu IP, upewnij się, że nie ulegnie on zmianie, przypisując mu statyczny adres IP lub tworząc rezerwację DHCP.

Port
Ustawia port urządzenia. Domyślny port dla urządzeń ESPHome to 6053.

• Tryb uwierzytelniania [Brak | Hasło | Klucz szyfrowania]
• Wybiera metodę uwierzytelniania w celu połączenia z urządzeniem ESPHome.

Nic: Uwierzytelnienie nie jest wymagane.

Hasło: Użyj hasła w celu uwierzytelnienia (patrz poniżej).

Klucz szyfrowania: Aby zapewnić bezpieczną komunikację, użyj klucza szyfrującego (patrz poniżej).

• Hasło
  Wyświetlane tylko wtedy, gdy tryb uwierzytelniania jest ustawiony na hasło. Ustawia hasło urządzenia. Musi ono być zgodne z hasłem skonfigurowanym na urządzeniu ESPHome.
• Klucz szyfrowania
  Wyświetlane tylko wtedy, gdy tryb uwierzytelniania jest ustawiony na klucz szyfrowania. Ustawia klucz szyfrowania urządzenia w celu zapewnienia bezpiecznej komunikacji. Musi on być zgodny z kluczem szyfrowania skonfigurowanym na urządzeniu ESPHome.

Informacje o urządzeniu

• Nazwa (tylko do odczytu)
  Wyświetla nazwę podłączonego urządzenia ESPHome.
• Model (tylko do odczytu)
  Wyświetla model podłączonego urządzenia ESPHome.
• Producent (tylko do odczytu)
  Wyświetla producenta podłączonego urządzenia ESPHome.
• Adres MAC (tylko do odczytu)
  Wyświetla adres MAC podłączonego urządzenia ESPHome.
• Wersja oprogramowania sprzętowego (tylko do odczytu)
  Wyświetla wersję oprogramowania sprzętowego podłączonego urządzenia ESPHome.

Działania kierowcy

Zresetuj połączenia i zmienne

Ostrzeżenie: Spowoduje to zresetowanie wszystkich powiązań połączeń i usunięcie wszelkiego programowania związanego ze zmiennymi.

Zresetuj połączenia i zmienne sterownika. Jest to przydatne, jeśli zmienisz podłączone urządzenie ESPHome lub jeśli połączenia lub zmienne są nieaktualne.

Przewodnik konfiguracji ratgdo

W tym przewodniku znajdziesz instrukcje dotyczące konfiguracji sterownika ESPHome do współpracy z urządzeniami ratgdo w celu sterowania bramą garażową za pośrednictwem przekaźników w programie Control4 Composer Pro.

Dodaj sterownik kontrolera przekaźnika
Dodaj wybrany sterownik przekaźnika do projektu Control4 w Composer Pro.

Właściwości kontrolera przekaźnika
Urządzenie ratgdo udostępnia encję „Cover” w ESPHome, która jest mapowana na funkcjonalność kontrolera przekaźnika w Control4.

Liczba przekaźników
Urządzenie ratgdo wykorzystuje konfigurację wieloprzekaźnikową do sterowania bramą garażową. W Composer Pro należy skonfigurować ustawienia przekaźników w następujący sposób:

• Zestaw z 2 przekaźnikami (otwieranie/zamykanie) lub 3 przekaźnikami (otwieranie/zamykanie/zatrzymywanie)
  • Urządzenie ratgdo wykorzystuje oddzielne polecenia do otwierania i zamykania bramy garażowej
  • Jeśli oprogramowanie układowe ratgdo obsługuje polecenie „stop”, skonfiguruj 3 przekaźniki, aby włączyć funkcję zatrzymania. W razie wątpliwości sprawdź połączenia ratgdo w Composer Pro, aby sprawdzić, czy przekaźnik „Stop Door” jest dostępny.

Konfiguracja przekaźnika

• Zabierać się do pracy Puls
  • ratgdo wykorzystuje chwilowe impulsy do uruchomienia otwieracza bramy garażowej, podobnie jak naciśnięcie przycisku na ścianie

Czas impulsu

• Ustaw wszystkie czasy impulsów przekaźnika na 500 (domyślny)
  • To jest czas, przez jaki przekaźnik będzie aktywny

Przekaźnik odwrócony

• Ustaw wszystkie właściwości przekaźnika odwróconego na NIE (domyślny)

Skontaktuj się z Debounce

• Ustaw wszystkie czasy odrzucania kontaktów na 250 (domyślny)
  • Pomaga to zapobiegać fałszywemu trzepotaniu czujników stanu drzwi garażowych

Odwróć kontakt

• Ustaw wszystkie właściwości odwróconego kontaktu na NIE (domyślny)

ExampWłaściwości
Dla porównania, oto byłyampwłaściwości kontrolera przekaźnikowego w Composer Pro:

Połączenia sterownika przekaźnika

Przekaźniki

• Otwarte: Podłącz się do przekaźnika „Otwórz drzwi” ratgdo
• Zamknąć: Podłącz do przekaźnika „Zamknij drzwi” ratgdo
• Zatrzymać: Jeśli jest dostępny, podłącz do przekaźnika „Stop Door” ratgdo

Czujniki kontaktowe

• Zamknięty kontakt: Połącz się z kontaktem „Drzwi zamknięte” ratgdo
• Otwarty kontakt: Połącz się z kontaktem „Otwarcie drzwi” ratgdo

Example Połączenia
Dla porównania, oto byłyampjak powinny wyglądać połączenia w Composer Pro:

Programowanie
W Control4 możesz tworzyć programy, które:

• Otwieranie/zamykanie drzwi garażowych w zależności od zdarzeń
• Monitoruj stan bramy garażowej
• Skonfiguruj powiadomienia o zmianach statusu bramy garażowej
• Twórz niestandardowe przyciski na ekranach dotykowych i pilotach

Example: Tworzenie alertu „Nadal otwarte”

Korzystanie z właściwości „Czas nadal otwarty” ze sterownika kontrolera przekaźnika:

1. Ustaw „Czas otwarcia” na żądany czas (np. 10 minut)
2. Utwórz regułę programowania, która zostanie uruchomiona po wystąpieniu zdarzenia „Nadal otwarte”
3. Dodaj akcje, aby wysyłać powiadomienia lub wykonywać inne zadania

Dodatkowe podmioty
W zależności od urządzenia ratgdo, oprogramowania układowego i jego możliwości, sterownik ESPHome może udostępniać dodatkowe encje. Mogą one występować jako dodatkowe połączenia lub zmienne sterownika.

Więcej informacji na temat poszczególnych jednostek można znaleźć w dokumentacji ratgdo: https://ratgdo.github.io/esphome-ratgdo/webui_documentation.html

Informacje dla deweloperów
Prawa autorskie © 2025 Finite Labs LLC
Wszystkie informacje zawarte w niniejszym dokumencie są i pozostają własnością Finite Labs LLC i jej ewentualnych dostawców. Zawarte w niniejszym dokumencie koncepcje intelektualne i techniczne są własnością
Finite Labs LLC i jej dostawcy mogą być objęci patentami amerykańskimi i zagranicznymi, patentami w toku, a także są chronieni tajemnicą handlową lub prawem autorskim. Rozpowszechnianie tych informacji lub powielanie tych materiałów jest surowo zabronione bez uprzedniej pisemnej zgody Finite Labs LLC. Aby uzyskać najnowsze informacje, odwiedź stronę: https://drivercentral.io/platforms/control4-drivers/utility/esphome

Wsparcie
Jeśli masz jakiekolwiek pytania lub problemy z integracją tego sterownika z Control4 lub ESPHome, możesz się z nami skontaktować pod adresem driver-support@finitelabs.com lub zadzwoń/wyślij SMS pod numer +1 949-371-5805.

Dziennik zmian

v20250715 – 2025-07-14

• Naprawił: Naprawiono błąd powodujący, że jednostki nie były wykrywane podczas łączenia

v20250714 – 2025-07-14

• W dodatku: Dodano obsługę szyfrowanych połączeń z wykorzystaniem szyfrowania urządzenia

v20250619 – 2025-06-19

• W dodatku :Dodano dokumentację specyficzną dla ratgdo

v20250606 – 2025-06-06

• W dodatku :Wydanie pierwsze

Często zadawane pytania

Jakie urządzenia są kompatybilne z tym sterownikiem?

Ten sterownik jest kompatybilny z każdym urządzeniem ESPHome, co zostało szczegółowo przetestowane na urządzeniach ratgdo. Jeśli wypróbujesz go na innym urządzeniu i zadziała, prosimy o kontakt w celu weryfikacji.

Dokumenty / Zasoby

ESPHome ESP8266 łączy się fizycznie z urządzeniem [plik PDF] Instrukcja użytkownika ESP8266, ESP32, ESP8266 łączy się fizycznie z Twoim urządzeniem, ESP8266, łączy się fizycznie z Twoim urządzeniem, łączenie się z Twoim urządzeniem, do Twojego urządzenia, Twoje urządzenie

Odniesienia

• Instrukcja obsługi