Kurs Home Assistant od Zera

BoneIO ESP Cover: pierwsze uruchomienie na 24 V, Ethernet, OLED, ESPHome i przygotowanie R01

BoneIO ESP Cover: pierwsze uruchomienie na 24 V, Ethernet, OLED, ESPHome i przygotowanie R01

Ostatnia aktualizacja treści:

Uruchom boneIO ESP Cover na 24 V i Ethernet bez silników. Zapisz konfigurację, dodaj ESPHome i sprawdź logi, OLED oraz mapę wejść.

Home Assistant LAB · Dom w praktyce · Rolety zewnętrzne · Lekcja 11

boneIO ESP Cover: pierwsze uruchomienie na 24 V, Ethernet, OLED, ESPHome i przygotowanie R01

BoneIO uruchamiam najpierw wyłącznie na 24 V i Ethernet. Odczytuję adres z OLED, wykonuję kopię konfiguracji i adoptuję urządzenie do ESPHome. Bez podłączonych silników mogę bezpiecznie sprawdzić dostępność, logi, aktualizację oraz mapę wejść i wyjść.

Dlaczego ten etap jest ważny

Pierwsze uruchomienie boneIO odbywa się bez aktywnego toru silnikowego. Najpierw ma być pewne 24 V, sieć, IP, panel, ESPHome i wejścia. Dopiero stabilny sterownik dostaje prawo do sterowania prawdziwą roletą.

W pełnej lekcji zrobisz to krok po kroku

Przed pierwszym włączeniem: sześć rzeczy do sprawdzenia

To ostatnie sprawdzenie jest celowe. Podczas pierwszego kontaktu z panelem może być kuszące kliknięcie Cover 01. Bez fazy na COM przekaźnik może się przełączyć, ale nie wyśle 230 V na przewody napędu. Najpierw poznajemy zachowanie sterownika, później dokładamy energię wykonawczą.

OLED jest pierwszym narzędziem diagnostycznym

boneIO ma wbudowany ekran OLED. Producent wykorzystuje go do pokazania najważniejszych informacji o stanie urządzenia, między innymi adresu IP, stanu połączenia i obciążenia procesora. Obok ekranu znajduje się przycisk, którym przełączamy widoki. Jeżeli OLED nie pokazuje IP, nie zgadujemy adresu. Otwieramy panel routera lub serwera DHCP i szukamy nowego klienta boneIO/ESPHome po nazwie i MAC. Brak adresu zwykle oznacza problem z linkiem Ethernet, DHCP albo segmentacją sieci, a nie problem z silnikiem, którego jeszcze nawet nie podłączyliśmy.

Aktualizacja firmware: kiedy i jak

Producent zaznacza, że urządzenie przychodzi z preinstalowanym ESPHome, ale jego wersja może być starsza. Najlepszy moment na aktualizację jest właśnie teraz, gdy nie mamy jeszcze aktywnych obwodów 230 V na wyjściach Cover. Na dzień przygotowania tej lekcji oficjalne repozytorium boneIO publikuje jako najnowsze wydanie firmware 2026.5.3 (b1) z 15 czerwca 2026. W paczce znajdują się osobne warianty ESP Cover v0.5/v0.6 i v0.7. Kursant nie powinien jednak traktować numeru z lekcji jako wiecznego. Zawsze sprawdzamy aktualną stronę producenta przed wgraniem oprogramowania.

Robimy kopię YAML przed pierwszą własną zmianą

ESPHome jest świetne, dopóki wiemy, co zmieniliśmy. Dlatego po adopcji nie zaczynamy od kasowania sekcji. Otwieramy Edit, kopiujemy pełną konfigurację i zapisujemy ją lokalnie jako plik bazowy. Jeżeli chcesz mieć także czystą konfigurację producenta niezależną od aktualnego urządzenia, oficjalny instalator boneIO pozwala wybrać płytkę i pobrać YAML dla danego firmware. Zachowaj plik dokładnie dla swojej rewizji sprzętowej.

Pierwsza zmiana: friendly_name sterownika

W sekcji substitutions producent wskazuje przede wszystkim zmianę czytelnej nazwy. Nie przebudowujemy identyfikacji sprzętowej. W naszym projekcie przyjmujemy nazwę widoczną dla człowieka: Nie kopiuj tego dwuwierszowego fragmentu w ciemno zamiast całej istniejącej sekcji substitutions. Zmieniasz wyłącznie wartość friendly_name w konfiguracji wygenerowanej dla Twojej rewizji płytki. Pozostałe pola zostają takie, jakie dostarczył producent.

Wgrywamy konfigurację po Ethernet

Skoro boneIO jest już adoptowane, działa w sieci i konfiguracja przechodzi walidację, możemy wykonać instalację OTA z ESPHome Device Builder. Nie używamy USB-C do każdej zwykłej zmiany YAML. USB pozostaje planem serwisowym, gdy urządzenie nie może przyjąć aktualizacji po sieci.

Restart bez Home Assistant

Jeszcze zanim podłączymy silnik, sprawdzamy jedną z najważniejszych właściwości architektury. Zatrzymaj Home Assistant albo ESPHome API na tyle, na ile możesz to zrobić bez wpływu na inne funkcje domu. boneIO nie powinno z tego powodu wchodzić w cykliczne restarty, ponieważ pozostawiliśmy reboot_timeout: 0s.

Pełna wersja zawiera
  • Pierwszy start bez aktywnego 230 V na wyjściach
  • OLED, IP, panel WWW i kopia konfiguracji
  • IN01/IN02 oraz Cover 01 przygotowane przed silnikiem
  • Przed pierwszym włączeniem: sześć rzeczy do sprawdzenia
  • Podłączamy 24 V DC do boneIO
  • Ethernet podłączamy przed startem
  • OLED jest pierwszym narzędziem diagnostycznym
  • Rezerwacja DHCP zanim zaczniemy edytować ESPHome
  • Pierwsze wejście do panelu WWW
  • Sprawdzamy rewizję sprzętową przed aktualizacją firmware
  • Aktualizacja firmware: kiedy i jak
  • Instalujemy ESPHome Device Builder w Home Assistant
  • Adoptujemy boneIO, ale rozumiemy warunek mDNS
  • Robimy kopię YAML przed pierwszą własną zmianą
  • Których sekcji YAML na razie nie ruszamy
  • Ważne: api reboot_timeout pozostaje 0s
Jak pracujemy w pełnej wersji

Nie przeskakujemy od teorii prosto do gotowego efektu. Zaczynamy od Pierwszy start bez aktywnego 230 V na wyjściach, następnie porządkujemy OLED, IP, panel WWW i kopia konfiguracji i dopiero później przechodzimy do IN01/IN02 oraz Cover 01 przygotowane przed silnikiem. W praktycznym systemie rolet kolejność ma znaczenie: błąd z początku konfiguracji może wyglądać jak problem Home Assistant dopiero kilka etapów później. Dlatego materiał pokazuje nie tylko co ustawić, ale również po czym rozpoznać poprawny rezultat i kiedy zatrzymać się przed następnym krokiem.

Pełna lekcja łączy wykonanie z diagnostyką. Po drodze wracamy do takich punktów jak Przed pierwszym włączeniem: sześć rzeczy do sprawdzenia oraz Podłączamy 24 V DC do boneIO. Nie zakładamy, że identyczne ustawienie będzie poprawne w każdym domu. Tam, gdzie wynik zależy od napędu, instalacji, kierunku elewacji, czasu ruchu lub zachowania domowników, dostajesz procedurę pomiaru i strojenia zamiast jednej „magicznej” liczby do skopiowania.

Na końcu etap musi dać się zweryfikować. Jeśli wynik jest inny niż opisany, pełna wersja prowadzi przez sprawdzenie przyczyny przed dołożeniem kolejnej warstwy. Dzięki temu następne lekcje opierają się na sprawdzonym fundamencie, a nie na przypadkowo działającej konfiguracji, która psuje się przy pierwszym restarcie, zmianie pogody albo użyciu fizycznego przycisku.

Efekt po zakończeniu lekcji

boneIO startuje stabilnie z 24 V DC, ma działający Ethernet i rezerwację DHCP, OLED pokazuje prawidłowe informacje, panel webowy działa po lokalnym IP, konfiguracja jest zabezpieczona kopią, a ESPHome Device Builder zna urządzenie. IN01 i IN02 reagują na przycisk lub testowe zwarcie do GND. Cover 01 jest nazwany jako R01, ale nadal nie steruje prawdziwym silnikiem 230 V.

Chcesz zbudować ten etap razem z kursem?

Ta lekcja jest częścią kursu Smart Home od Zera na platformie MarkLabs E-Learning. Pełna wersja prowadzi przez konfigurację, testy, diagnostykę i przypadki awaryjne bez zostawiania Cię z poleceniem „skonfiguruj to sam”.

Kup dostęp do kursu: 39 zł
Dożywotni dostęp | Wszystkie lekcje | Bez subskrypcji
Zobacz pełny kurs na marklabs.pl/e-learning/
🔒

Pełna treść dostępna po zakupie kursu

Za symboliczne 39 zł zyskujesz dostęp do 200+ stron praktycznej wiedzy o Home Assistant — wszystkich lekcji, przykładów i aktualizacji.

  • Dożywotni dostęp do całego kursu
  • Nowe lekcje bez dodatkowych opłat
  • Bez reklam i bez abonamentu

Nikt nie jest nieomylny. Coś nie gra w tej lekcji? Zgłoś błąd