Kurs Home Assistant od Zera

Poznajemy ESP i przygotowujemy warsztat

Poznajemy ESP i przygotowujemy warsztat

Ostatnia aktualizacja treści:

Home Assistant LAB · Moduł 30 · Lekcja 1

Zanim podłączymy pierwszą płytkę, przygotuję z Tobą warsztat i uporządkuję nazwy sprzętu. Pod hasłem „ESP” sklep może oferować mały moduł z ośmioma pinami, płytkę z USB albo całe urządzenie z ekranem. Każde wymaga innego sposobu zasilania i podłączania czujników. Zaczniemy od rozpoznania części, żeby późniejsze instrukcje pasowały do tego, co naprawdę leży na stole.

Chcę, żebyś po tej lekcji potrafił rozpoznać, co kupujesz, przygotować stanowisko i sprawdzić podstawowe połączenia, zanim cokolwiek zasilisz. Nie potrzebujesz znajomości programowania. Potrzebujesz natomiast chwili na obejrzenie części, przeczytanie oznaczeń i zapisanie wyników. Przy kolejnych urządzeniach będziemy wracać do tych samych prostych czynności: odczytać oznaczenie, sprawdzić połączenie, zanotować wynik i dopiero wtedy ruszyć dalej.

Cel lekcji. Przygotujesz stanowisko do pracy z ESP, wybierzesz pierwszą płytkę albo opiszesz tę, którą już masz, sprawdzisz przewody i układ połączeń płytki stykowej oraz sporządzisz kartę urządzenia. Na końcu będziesz wiedział, co masz, czego jeszcze brakuje i jaką drogą przejdziemy od płytki do działającego czujnika w Home Assistant.

Podziel pracę na trzy sesje. W pierwszej poznasz sprzęt i wybierzesz zestaw. W drugiej wykonasz ćwiczenia z miernikiem. W trzeciej uporządkujesz dokumentację oraz zakupy. Na pierwsze spokojne przejście wraz z ćwiczeniami zarezerwuj orientacyjnie 2-3 godziny. Jeśli pierwszy raz bierzesz miernik do ręki, daj sobie dodatkowy wieczór. W spokojnym tempie łatwiej zauważyć, że przewód trafił o jeden otwór za daleko albo że na ekranie zmieniła się jednostka. Możesz przerwać po każdej sesji. Nie ma powodu robić wszystkiego jednym ciągiem.

Jak przejdziemy przez tę lekcję

To warsztat pogłębiający wcześniejszy moduł o ESPHome. Jeśli masz już pierwsze urządzenie w HA, wykorzystaj swoje działające środowisko. Tutaj zaczniemy od rozpoznania sprzętu i pomiarów. Nie trzeba instalować wszystkiego ponownie. Przy pierwszym przejściu wykonaj trzy opisane sesje; porównania dodatkowych rodzin płytek możesz później wykorzystać przy własnych projektach.

Trzy sesje, do których możesz wracać

Sesja Co robisz Kiedy robisz przerwę
1. Sprzęt i plan warsztatu: około 45-60 minut Czytasz rozdziały 1-6, rozpoznajesz płytkę i rozdzielasz zakupy na teraz oraz później. Masz nazwę płytki lub zapisany brak identyfikacji oraz krótką listę części. Nie musisz jeszcze instalować żadnego środowiska.
2. Stół i pomiary: około 45-75 minut Przechodzisz rozdziały 7-11: przygotowujesz miernik, sprawdzasz przewody, płytkę stykową i rezystor. Wyniki są zapisane, układ pozostaje bez zasilania, a miernik jest wyłączony.
3. Dokumentacja i domknięcie pracy: około 30-45 minut Wykonujesz rozdziały 12-15. Pozostałe rozdziały zawierają materiały pomocnicze i źródła. Masz kartę urządzenia, wyniki oraz konkretną następną czynność.

Czasy poszczególnych sesji są przybliżone i mogą dać łącznie więcej niż trzy godziny. Nie dopasowuj pracy do zegarka. Lepiej dokończyć jeden pomiar i zapisać wynik niż przejść dalej z wątpliwym połączeniem.

Najpierw zobacz całą drogę

Element Najprostsze użyteczne wyjaśnienie
Układ ESP Wykonuje program i obsługuje sygnały. Radio może już znajdować się w tym samym układzie.
Moduł Łączy układ z częścią potrzebnych elementów, np. pamięcią i torem antenowym. Radio może być już częścią samego układu ESP; obecność modułu nie oznacza, że dopiero tutaj je dołożono.
Płytka deweloperska Udostępnia wygodne złącza i elementy pomocnicze do pracy z układem lub modułem. To na niej znajdziesz złącza i przyciski, których będziemy używać na stole.
Firmware Program działający w urządzeniu.
ESPHome Narzędzia pozwalające opisać urządzenie i przygotować jego firmware.
Home Assistant Odbiera dane i pozwala powiązać urządzenie z resztą domu.

W projekcie czujnik przekazuje informację do ESP, firmware ją obsługuje, a komunikacja dostarcza wynik do HA. Przy sterowaniu polecenie może płynąć w przeciwną stronę. Do poprawnego wyniku potrzebujemy obu rzeczy: właściwego połączenia i programu, który potrafi obsłużyć podłączony element. Za chwilę rozłożymy te zależności na szczegóły. Nie musisz teraz zapamiętywać całego słownika.

Spis treści lekcji

  1. Co właściwie budujemy
  2. Cztery nazwy, które porządkują cały warsztat
  3. Dlaczego nie kupujemy „dowolnego ESP32”
  4. ESPHome, Arduino IDE, PlatformIO i ESP-IDF: co do czego służy
  5. Zestaw na początek: kupujemy mało, ale świadomie
  6. Zakupy do projektów: plan zamiast jednego wielkiego koszyka
  7. Przygotuj miejsce, w którym łatwo zauważyć pomyłkę
  8. Multimetr: zaczynamy od ciągłości przewodu
  9. Płytka stykowa: sprawdzamy, które otwory są połączone
  10. Pomiar rezystora: wartość i jednostka są równie ważne
  11. Zasilanie: dzisiejsza decyzja brzmi „jeszcze nie podłączam”
  12. Karta urządzenia: dokumentacja, którą naprawdę da się wykorzystać
  13. Diagnostyka dzisiejszego warsztatu według objawu
  14. Jak będziemy dochodzić do kompletnych urządzeń
  15. Kiedy uznaję tę lekcję za ukończoną
  16. Powiązane materiały MarkLabs
  17. Źródła, wersje i status sprawdzenia

1. Co właściwie budujemy

Wyobraź sobie czujnik temperatury w warsztacie. Sam element pomiarowy nie umie pokazać wyniku w Home Assistant. Trzeba go zasilić, odczytać, rozpoznać błąd i przesłać informację dalej. Mikrokontroler wykonuje właśnie taką pracę: obsługuje niewielki zestaw zadań zapisanych w jego oprogramowaniu.

W innym projekcie zamiast temperatury odczytamy stan kontaktronu w skrzynce pocztowej. W kolejnym odbierzemy dane z radaru obecności. Możemy też sterować jasnością oświetlenia albo narysować informacje na ekranie. Zasada pozostaje podobna: wejścia, przetwarzanie, wyjścia i komunikacja. Różnią się wymagania elektryczne, ilość danych, czas reakcji oraz to, co ma się wydarzyć po awarii.

Nie każde urządzenie potrzebuje wszystkich tych elementów. Czujnik może tylko wysyłać pomiary. Sterownik światła powinien dodatkowo obsługiwać lokalny przycisk. Urządzenie bateryjne będzie zasypiało, więc nie możemy oczekiwać od niego stałego połączenia z siecią. Projekt zaczyna się od ustalenia zadania, a dopiero potem dobieramy płytkę.

ESP a komputer z Home Assistant

Home Assistant działa na serwerze: może to być Green, mini PC, Raspberry Pi albo maszyna wirtualna. Tam przechowujesz historię, budujesz dashboardy i łączysz różne urządzenia. Płytka ESP jest inną klasą sprzętu. Uruchamia przygotowany dla niej firmware i zajmuje się swoim fragmentem domu.

Nie instalujemy na zwykłym ESP kompletnego Home Assistant OS. Możemy natomiast zbudować urządzenie, które Home Assistant będzie odczytywał lub którym będzie sterował. Jeżeli mylisz te dwa poziomy, późniejsze pojęcia „instalacja ESPHome” i „wgranie ESPHome” zaczną wyglądać jak jedna czynność. W rzeczywistości dotyczą różnych miejsc.

Dlaczego urządzenie powinno umieć coś zrobić lokalnie

Przy prostym monitorze temperatury awaria HA może oznaczać brak nowego wykresu. Przy lampie użytkownik nadal powinien móc nacisnąć przycisk. Przy urządzeniu podającym impuls do istniejącej instalacji musimy dodatkowo zadbać o stan po restarcie. Nie będziemy do każdego projektu dodawać wszystkich funkcji awaryjnych. Ustalimy jednak, co jest potrzebne dla jego rzeczywistej roli.

Na karcie urządzenia zapisz więc od początku dwa zdania: „urządzenie ma robić…” oraz „gdy nie działa Home Assistant, urządzenie ma…”. Drugie zdanie często ujawnia ważny problem jeszcze przed zakupem części.

2. Cztery nazwy, które porządkują cały warsztat

Pojęcie Co oznacza Co sprawdzamy
Mikrokontroler, układ, SoC Układ scalony wykonujący program; w rodzinach ESP może zawierać również radio i różne peryferia. Dokładną rodzinę i wariant, a nie samo słowo ESP32.
Moduł Gotowy podzespół zawierający układ i część jego otoczenia, np. pamięć, elementy radiowe i antenę lub złącze antenowe. Oznaczenie modułu, pamięć, antenę i dokumentację producenta.
Płytka deweloperska Płytka, na której umieszczono moduł lub sam układ oraz elementy ułatwiające używanie: zasilanie, złącza, przyciski, czasem USB-UART. Model płytki, rewizję, schemat i opis wyprowadzeń.
Firmware Program zapisany w pamięci urządzenia. Dla jakiego sprzętu powstał, z jakiej konfiguracji i jak można go odtworzyć.

To nie są cztery niezależne produkty, które zawsze trzeba kupić. W płytce deweloperskiej masz już mikrokontroler, często zamknięty w module. Na tej samej płytce mogą być także stabilizator i mostek USB. Kupując kompletną płytkę z modułem, nie zamawiasz osobno drugiego modułu tylko dlatego, że występuje w opisie.

Ćwiczenie: przeczytaj opis płytki zamiast samego tytułu aukcji

Otwórz dokumentację ESP32-DevKitC V4. To nasz punkt odniesienia do nauki rozpoznawania części, nie obietnica, że każda podobna płytka ma identyczne połączenia.

Na zdjęciu i w opisie odnajdź:

  1. Duży moduł z metalową osłoną i jego pełne oznaczenie.
  2. Gniazdo Micro-USB.
  3. Element opisany jako mostek USB-UART.
  4. Przyciski BOOT i EN.
  5. Rzędy wyprowadzeń oraz oznaczenia zasilania.

Zapisz, które elementy znalazłeś w dokumentacji, a które potrafisz rozpoznać na swojej płytce. Jeśli nie masz jeszcze sprzętu, wykonaj ćwiczenie na zdjęciu producenta. Nie zgaduj oznaczenia drobnego układu ze zdjęcia, na którym go nie widać.

Oczekiwany wynik: potrafisz powiedzieć „mam płytkę tego producenta, w tej rewizji, z takim modułem”. Gdy będziesz później szukał pomocy, do takiego opisu dołączysz zdjęcie obu stron. Napis WROOM pomaga rozpoznać moduł, ale nie mówi jeszcze, jak producent połączył USB i zasilanie na całej płytce.

Elementy oficjalnej płytki ESP32-DevKitC V4 opisane w ilustracji producenta

Płytka na ilustracji Espressif: ESP32-DevKitC V4. Na niej możesz przećwiczyć rozpoznawanie elementów, zanim przyjdzie Twoje zamówienie. Angielskie podpisy oznaczają: Module: moduł, USB-to-UART Bridge: mostek USB-UART, Micro USB Port: gniazdo USB, BOOT: przycisk wejścia w odpowiednią sekwencję startową, EN: reset. Wyprowadzenia i dopuszczalne sposoby zasilania odczytaj dodatkowo z tabeli producenta. Nie dopasowuj położenia pinów z tej ilustracji do podobnie wyglądającego klona. Źródło ilustracji i opis płytki: Espressif.

Po rozpoznaniu płytki: wystarczy, że zapiszesz, co potrafisz potwierdzić. Jeśli nie odczytałeś rewizji lub oznaczenia mostka, wpisz ten brak. Nie musisz zgadywać odpowiedzi, żeby kontynuować przygotowanie warsztatu.

3. Dlaczego nie kupujemy „dowolnego ESP32”

Nazwa rodziny nie jest instrukcją podłączenia. Dwie płytki mogą mieć zgodny mikrokontroler, ale różnić się liczbą wyprowadzonych pinów, sposobem zasilania, diodą, szerokością, pamięcią lub USB. Schemat znaleziony w wyszukiwarce może dotyczyć innej wersji.

Podobnie jest z nazwami sprzedawców. „SuperMini”, „DevKit” czy „D1 Mini” bez producenta i rewizji często opisują pewną grupę produktów. Traktuję taką nazwę jako początek poszukiwań. Do podłączenia potrzebuję dokumentacji konkretnego egzemplarza lub rzetelnie ustalonej zgodności.

Nie zakładam też, że brak portu w komputerze dowodzi podróbki. Może chodzić o kabel, wybrany port USB, sterownik, tryb startowy lub uszkodzenie. Ocenę autentyczności i jakości oddzielimy od diagnozy pojedynczej usterki.

Układ, płytka i firmware to trzy osobne sprawdzenia

Pokażę Ci to na konkretnym przykładzie, żeby sama nazwa rodziny nie przesądzała później o zakupie. ESP32-H2 ma własny procesor i może realizować samodzielne urządzenia. Nie jest wyłącznie dodatkiem radiowym do innego ESP. Nie ma jednak wbudowanego Wi-Fi. To zmienia sposób komunikacji i dobór całego rozwiązania. Nie wybierzemy go do ćwiczenia wymagającego zwykłego połączenia Wi-Fi tylko dlatego, że ma „ESP32” w nazwie. Opis ESP32-H2 producenta.

Z drugiej strony radio obecne w układzie nie uruchamia się samo jako gotowa integracja. Potrzebny jest obsługujący je stos i odpowiednia konfiguracja. Wersję ESPHome sprawdzamy dla konkretnego wariantu. Nie przenosimy listy możliwości ESP-IDF ani Arduino wprost do każdego komponentu ESPHome. Bieżąca dokumentacja platformy ESP32 w ESPHome.

W lekcjach 2 i 3 przejdziemy przez rodziny oraz rzeczywiste płytki znacznie dokładniej. Przy pierwszym zakupie trzymam się jednej zasady: przed zakupem muszę znać sprzęt, dokumentację oraz drogę uruchomienia w wybranym środowisku. Nie wybieram największej liczby funkcji z tabeli, jeśli nie potrzebuję ich w projekcie.

4. ESPHome, Arduino IDE, PlatformIO i ESP-IDF: co do czego służy

Te nazwy często pojawiają się obok siebie w poradnikach, choć odnoszą się do różnych rzeczy. Najłatwiej poukładać je według tego, co chcemy właśnie zrobić z urządzeniem. W naszym module podstawową drogą będzie ESPHome, ponieważ chcemy budować urządzenia Smart Home i łączyć je z HA. Pozostałe środowiska wykorzystamy wtedy, gdy rozwiążą konkretny problem.

ESPHome: konfiguracja zamieniana w firmware

Opisujesz urządzenie: jaki jest mikrokontroler, jak się łączy, jakie ma czujniki i co robi lokalnie. Narzędzia ESPHome przetwarzają ten opis i budują firmware. Później zapisujesz go w urządzeniu. Konfiguracja nie jest tylko opisem dashboardu: ma wpływ na rzeczywistą pracę sprzętu.

Trzeba tu odróżnić Device Builder, czyli środowisko przygotowywania urządzenia, od integracji ESPHome w Home Assistant, która komunikuje się z już działającym firmware. Urządzenie nie musi być stale podłączone kablem do serwera, na którym działa Builder. Sam fakt pojawienia się kafelka w Builderze nie dowodzi też, że encje działają w HA. Integracja ESPHome w HA.

W lekcji 7 wykonamy cały proces: wybór sposobu uruchomienia narzędzi, pierwsza konfiguracja, kompilacja, wgrywanie, logi i integracja. Nie musisz teraz instalować kilku programów naraz. Zapisz system swojego komputera oraz sposób instalacji Home Assistant; na ich podstawie wybierzemy właściwą ścieżkę.

Arduino IDE: edytor i prosty obieg własnego programu

Arduino IDE pozwala pisać i budować programy, często nazywane szkicami. Dla ESP potrzebujesz obsługi właściwej platformy, a nie tylko samego edytora. Przykład napisany dla jednej płytki może wymagać zmiany pinów, bibliotek lub ustawień, zanim uruchomisz go na innej.

Do Arduino IDE sięgniemy na przykład wtedy, gdy producent czujnika udostępni mały program demonstracyjny i zechcemy sprawdzić sam odczyt, zanim połączymy urządzenie z resztą domu. Poznasz wybór płytki i portu, budowanie programu oraz monitor portu szeregowego. Ustalimy też, jak wrócić do ESPHome. Wgranie programu Arduino może zastąpić wcześniejszy firmware: nie jest doinstalowaniem kolejnej aplikacji obok niego. Obsługa ESP32 w Arduino.

PlatformIO: projekt wraz z zależnościami

PlatformIO pomaga opisać środowisko projektu, obsługiwane płytki, framework i biblioteki. Można korzystać z jego narzędzi w edytorze lub z linii poleceń. Nie jest nazwą osobnego rodzaju firmware i nie jest synonimem ESP-IDF. W projekcie PlatformIO można korzystać z określonego frameworka; jego dostępność i wersję trzeba sprawdzić.

Ta ścieżka ma sens przy projektach, które już są w ten sposób przygotowane, albo gdy potrzebujemy kontrolować pliki i zależności. Nie jest warunkiem podłączenia pierwszego termometru do HA. Wyjaśnienie autorów PlatformIO.

ESP-IDF: środowisko producenta ESP32

ESP-IDF to framework Espressif, z narzędziami i bibliotekami do tworzenia oprogramowania dla wspieranych układów ESP32. Przydaje się, gdy sięgamy do przykładów producenta, ustawień systemu lub funkcji nieudostępnionych przez wyższą warstwę. Samodzielna praca z nim wymaga więcej przygotowania niż opis czujnika w ESPHome.

ESPHome również może budować firmware z użyciem ESP-IDF. To nie znaczy, że musisz od razu osobno instalować całe środowisko producenta. W lekcji 10 pokażę małe ćwiczenia w różnych narzędziach, tak abyś widział różnicę w praktyce. Wprowadzenie do ESP-IDF.

Co zapisać teraz

Moja potrzeba Ścieżka na start Czego jeszcze nie robię
Czujnik lub sterownik z integracją HA ESPHome Nie instaluję dodatkowych frameworków bez potrzeby.
Przykład producenta przygotowany jako szkic Arduino IDE z właściwą obsługą ESP Nie zakładam zgodności pinów między płytkami.
Gotowe repozytorium z konfiguracją PlatformIO Odtwarzam opisane środowisko Nie aktualizuję wszystkich zależności przed pierwszym uruchomieniem.
Własny program korzystający bezpośrednio z funkcji Espressif ESP-IDF dla wskazanego układu Nie utożsamiam przykładu dla ESP32-H2 z programem dla ESP8266.

Miejsce na przerwę. Jeśli umiesz rozdzielić płytkę, firmware, Builder i integrację, pierwszy etap jest zakończony. Zanim przejdziesz dalej, zapisz model komputera, system operacyjny, sposób instalacji HA oraz to, czy masz już jakąś płytkę ESP. Nie zapisuj hasła do Wi-Fi w karcie przeznaczonej do wysłania na forum.

Na tym etapie wybierasz drogę, nie instalujesz wszystkich narzędzi. Do głównej ścieżki tego LAB-u potrzebujesz rozumieć rolę ESPHome i HA. Pełne omówienie Arduino IDE, PlatformIO oraz ESP-IDF zostaje w lekcji, abyś miał do czego wrócić. W lekcji 10 zainstalujemy potrzebne narzędzia i uruchomimy małe programy, więc przy tych nazwach możesz teraz dopisać sobie numer lekcji, do której wrócisz. Na dziś zapisz: „zaczynam od ESPHome”, chyba że pracujesz nad konkretnym projektem wymagającym innej drogi.

5. Zestaw na początek: kupujemy mało, ale świadomie

Na dzisiejszy stół

Przygotuj miernik z instrukcją, płytkę stykową, co najmniej trzy przewody i opisany rezystor 1 kΩ. Płytkę ESP możesz na razie rozpoznawać na podstawie dokumentacji. Zestawy do radaru, CO₂, wodomierza i skrzynki zamówisz dopiero przed odpowiednim projektem.

W pierwszych ćwiczeniach nie potrzebujesz kamery, Ethernetu, radia do wodomierza ani zasilacza do sondy poziomu wody. Potrzebujesz zestawu, na którym nauczysz się rozpoznawać części i sprawdzać połączenia. Większe zakupy zrobimy przed odpowiednim projektem, po sprawdzeniu jego wariantu.

Poniższa lista rozdziela to, co jest potrzebne dzisiaj, od przygotowania do kolejnych lekcji. Jeśli dopiero zamawiasz części, dzisiejsze ćwiczenie z dokumentacją wykonasz bez płytki ESP. Do fizycznego ćwiczenia potrzebujesz miernika, płytki stykowej, kilku przewodów i rezystora.

Element Wariant lub wymaganie Ilość Kiedy potrzebny
Multimetr cyfrowy Pomiar rezystancji, test ciągłości, pomiar napięcia stałego; czytelne gniazda i dostępna instrukcja konkretnego modelu. 1 Dzisiaj.
Płytka stykowa Bezlutowa, raster 2,54 mm, ok. 830 pól, bez dołączonego i zasilonego modułu zasilania. Układ połączeń sprawdzimy, nie przyjmiemy go na wiarę. 1 Dzisiaj.
Przewody Zestaw krótkich połączeń męski-męski; później również żeński-męski i żeński-żeński. Końcówki zgodne z goldpinami 2,54 mm. Po kilka sztuk Dzisiaj typ męski-męski.
Rezystor pomiarowy Przewlekany, 1 kΩ, tolerancja 1%, moc znamionowa 0,25 W; opisany w opakowaniu. 2-5 Dzisiaj jedna sztuka.
Drobne rezystory Przewlekane 220 Ω, 1 kΩ, 4,7 kΩ i 10 kΩ, po kilka sztuk; wartości przechowywane osobno. Mały zestaw Kolejne lekcje.
Płytka referencyjna Espressif ESP32-DevKitC V4 w wariancie handlowym ESP32-DevKitC-32E, z modułem ESP32-WROOM-32E i anteną PCB; sprawdź oznaczenie, dokumentację i złącza przed zakupem. 1 Do kolejnych ćwiczeń; dziś wystarczy dokumentacja.
Kabel USB Kabel transmisji danych z końcówką Micro-B pasującą do wskazanej płytki i drugą końcówką do komputera. 1, zapasowy pomocny Pierwsze połączenie w lekcji 6.
Komputer Windows, Linux lub macOS, dostęp do przeglądarki i plików; zapisz dokładną wersję systemu. 1 Dokumentacja teraz, narzędzia później.
Dokumentacja Schemat i instrukcja właściwej płytki oraz instrukcja miernika. Zapis lokalny Dzisiaj.

Dlaczego wybrałem taki wariant płytki jako odniesienie? Ma publiczną dokumentację producenta i łatwo odróżnić znajdujące się na niej elementy. To wygodny punkt startowy do nauki podstaw. Przy wyborze do dalszych projektów będę jednak patrzył na to, czego wymaga urządzenie: ile zajmie pamięci, czy potrzebuje BLE i jak ma być zasilane. Przy rozbudowanym ekranie, bateryjnym czujniku czy Ethernetcie wybierzemy sprzęt odpowiedni do zadania.

Na dzień weryfikacji wariant ESP32-DevKitC-32E występował w ofercie dystrybutora. Stan magazynu i dostawa mogą się zmienić, dlatego nie wiążę lekcji z ceną ani obietnicą dostępności. Przykładowa karta dystrybutora. Przed zakupem sprawdź pełny numer produktu; wariant z inną anteną lub pamięcią nie jest automatycznie tą samą płytką.

Jeśli już masz inną płytkę

Nie wyrzucaj jej i nie kupuj kolejnej tylko po to, żeby zgadzała się fotografia. Zapisz oznaczenia, zrób zdjęcie obu stron i znajdź dokumentację. W lekcjach 2 i 3 ustalisz, do czego się nadaje. Do dzisiejszych ćwiczeń nie podłączamy jej do płytki stykowej, więc nie musisz dopasowywać pinów do przykładu.

Jeżeli korzystasz z zamiennika w późniejszym projekcie, porównuj co najmniej: rodzinę układu, wariant modułu, dostępną pamięć, wyprowadzenia, zasilanie, USB i wsparcie używanych komponentów. Podobny wygląd nie zastępuje tego porównania. Zmiana płytki może być rozsądna, ale musi być świadoma.

Czego jeszcze nie kupować w ciemno

Nie zamawiaj kompletu przypadkowych modułów przekaźnikowych „do Arduino”, zasilacza do szyny DIN, najtańszej sondy TL-136 bez określonego zakresu ani dowolnego modułu radiowego z opisu „868 MHz”. Napięcie sterowania przekaźnika, zakres sondy i właściwości radia będą miały znaczenie dla konkretnego projektu.

Nie potrzebujesz też teraz akumulatora, ładowarki do niego i płytki reklamowanej jako „ultra low power”. Mały rozmiar nie jest pomiarem poboru energii. Urządzenie skrzynki pocztowej zaprojektujemy jako całość: płytka, wybudzanie, zasilanie, transmisja oraz odbiór zdarzenia.

Kabel USB odłóż do osobnego testu. Jeśli masz kompatybilne, działające urządzenie z tym samym złączem, sprawdź na nim rzeczywisty transfer danych, nie samą ikonę ładowania. Gdy takiego urządzenia nie masz, zapisz „transmisja niepotwierdzona” i sprawdzimy ją przy pierwszym połączeniu. W wątku o niewidocznym ESP32 użytkownik potwierdził przywrócenie połączenia po zmianie kabla. To dobry powód do sprawdzenia własnego przewodu, nie dowód, że każdy brak portu ma tę samą przyczynę.

6. Zakupy do projektów: plan zamiast jednego wielkiego koszyka

Ta tabela pozwala zobaczyć, co będziemy budować. Nie jest jeszcze listą zamiennych podzespołów. Dokładne modele, rewizje, napięcia i konfiguracje ustalimy na podstawie dokumentacji w odpowiedniej lekcji. Nie kupuj na jej podstawie części, których nie potrafisz jeszcze porównać z dokumentacją.

Projekt Główne grupy części Co sprawdzimy przed zakupem
Stacja z ekranem Czujnik środowiskowy, czujnik światła, wyświetlacz i płytka ESP Napięcia, adresy magistrali, rzeczywisty kontroler ekranu i miejsce na połączenia.
Obecność mmWave Konkretny radar, ewentualnie PIR Sposób komunikacji, wersję modułu oraz to, jakie informacje o obecności rzeczywiście udostępnia.
Bluetooth Proxy Płytka z obsługiwanym BLE i odpowiednia konfiguracja Rodzinę układu, antenę, dostępność funkcji oraz ograniczenia aktywnych połączeń.
Oświetlenie niskonapięciowe Taśma, właściwy stopień MOSFET, zasilacz i przewody Prąd, napięcie sterowania, straty, temperaturę oraz połączenia masy.
Monitor CO₂ Sensor rzeczywistego CO₂, sygnalizacja i obudowa Zasadę pomiaru, tryb kalibracji, obsługę w ESPHome i wpływ montażu.
Pilot IR Odbiornik IR, dioda nadawcza i tor sterujący Częstotliwość odbiornika, zgodność protokołu, sterowanie prądem nadajnika.
Poziom wody Sonda 4-20 mA, rezystor pomiarowy, ADS1115 i zasilanie Zakres sondy, jej dokumentację, dopuszczalne napięcia i wymagania pętli.
Skrzynka pocztowa Kontaktron, płytka, bateria i odbiornik Pobór całego urządzenia, sposób wybudzania oraz potwierdzanie transmisji.
Ethernet i NetGuard Płytka Ethernet, elementy stanowiska testowego Schemat PHY i zasilania, sposób programowania oraz odpowiedzialność watchdoga.
RS485 i Modbus Transceiver lub moduł interfejsu, przewody i węzeł testowy Poziomy logiczne, kierunek transmisji, terminację i mapę danych.
Wodomierz wMBus Odpowiednie radio, antena i dostęp do danych licznika Model licznika, tryb transmisji, format telegramu i możliwość uzyskania klucza.
Dzwonek i wejście izolowane Optoizolacja, elementy wejścia i ewentualny przekaźnik Charakter sygnału w danym urządzeniu; najpierw zbudujemy osobne stanowisko niskonapięciowe.
Panel sterujący Płytka, ekran, dotyk lub przyciski Kontroler i rewizję panelu, pamięć, zajęte piny i wsparcie firmware.

Własny monitor CO₂ ma nam pomóc zauważyć potrzebę wietrzenia. Nie zastępuje alarmu tlenku węgla ani czujki gazu. Podobnie warsztat przekaźnikowy nie będzie instrukcją samodzielnego wykonywania instalacji sieciowej. Pracujemy na stanowiskach niskonapięciowych, a integrację z istniejącym urządzeniem dobieramy według jego dokumentacji.

Po planowaniu zakupów: przygotuj tylko części potrzebne dzisiaj. Przy pozostałych projektach możesz wpisać „model do ustalenia przed lekcją”. Nie musisz zamawiać radaru, sondy ani radia, żeby nauczyć się pomiaru przewodu i rezystora.

7. Przygotuj miejsce, w którym łatwo zauważyć pomyłkę

Zwolnij fragment stołu. Pod płytką nie może leżeć metalowa linijka, luźne śrubki ani końcówki odciętych przewodów. Do nauki wybierz stabilną powierzchnię, dobre światło i miejsce, gdzie możesz odłożyć części bez ich pomieszania.

Wydziel trzy obszary: części niepodłączone, układ w trakcie pracy i narzędzia. Zasilacz oraz kabel USB połóż osobno. Dzięki temu odłączenie zasilania jest widoczną czynnością, a nie przypuszczeniem. Jeżeli musisz przerwać pracę, zrób zdjęcie i zapisz, na którym kroku jesteś.

Drobne elementy przechowuj w opisanych przegródkach. Nie wkładaj wszystkich rezystorów do jednego woreczka. Napis „1 kΩ” na pojemniku oszczędzi Ci później zgadywania wartości. Dla płytek zachowaj opakowanie, numer zamówienia i zdjęcie oferty: przy kolejnej partii sprzedawca może dostarczyć inną rewizję.

Jeżeli używasz maty ESD, skonfiguruj ją zgodnie z jej instrukcją. Mata antystatyczna, zwykła mata silikonowa i przewodząca podkładka nie są tym samym. Nie kładź zasilanej płytki na nieznanej powierzchni przewodzącej. Nie improwizuj uziemienia przewodem włożonym do gniazdka.

Lutownicę, odsysacz i stację hot-air zostaw na właściwy etap. Nie potrzebujemy ich w dzisiejszym ćwiczeniu. Gdy zaczniemy lutować, przygotujemy również miejsce na gorący grot, odciąg oparów oraz kontrolę połączeń. Na razie ważniejszy jest porządek i miernik.

Kontrola przed dzisiejszym ćwiczeniem

  • ESP leży osobno, bez kabla i bez przewodów w GPIO.
  • Na płytce stykowej nie ma zasilacza, baterii ani przewodu z innego urządzenia.
  • Znasz model swojego multimetru i masz jego instrukcję.
  • Końcówki pomiarowe są nieuszkodzone.
  • Wiesz, gdzie są gniazda COM oraz napięcia/rezystancji.
  • Nie korzystasz z gniazd prądowych A lub mA.

Jeżeli któryś punkt nie jest spełniony, popraw go przed pomiarem. W pierwszym ćwiczeniu nie ma żadnej korzyści z pośpiechu.

8. Multimetr: zaczynamy od ciągłości przewodu

Przed pomiarem: badany układ jest bez zasilania: nie ma USB, baterii ani zasilacza. Nie mierzymy dziś prądu. Czarny przewód wkładamy do COM, a czerwony do wejścia wskazanego w instrukcji dla Ω i ciągłości. Osobne wejścia A/mA pozostają nieużywane. Jeśli miernik ma współdzielone gniazdo V/Ω/mA, rozstrzyga jego instrukcja oraz właściwy wybór funkcji; sam nadruk mA nie oznacza, że to gniazdo jest zawsze zabronione.

Poglądowy panel miernika: COM i właściwe wejście rezystancji, osobne wejścia prądowe nieużywane

To rysunek poglądowy, nie fotografia konkretnego miernika. Nie wybieraj gniazda po jego pozycji na ilustracji. Odczytaj oznaczenia na swoim modelu i sprawdź instrukcję. Warianty z innym układem gniazd lub wejściem współdzielonym wymagają zastosowania właściwej instrukcji.

Multimetr może mierzyć różne wielkości. Zmiana funkcji pokrętłem nie zawsze wystarcza: znaczenie ma też gniazdo, do którego włożysz przewód. Przy pomiarach prądu urządzenie jest używane inaczej niż przy pomiarze rezystancji. Dzisiaj nie mierzymy prądu i nie przekładamy czerwonego przewodu do wejścia A ani mA.

Dlaczego tak pilnuję wejść? Przy klasycznym pomiarze prądu miernik włącza się szeregowo, w przerwę w obwodzie. Jego tor prądowy ma małą rezystancję. Przyłożenie tak przygotowanych sond bezpośrednio do dwóch zacisków źródła może utworzyć zwarcie, uszkodzić badany układ lub przepalić bezpiecznik miernika. Nie sprawdzamy tego eksperymentalnie. Różnicę poznasz później na przygotowanym stanowisku, po omówieniu ograniczeń przyrządu. Wyjaśnienie w instrukcji producenta Fluke, rozdział Measuring Current.

Przygotuj jeden niepodłączony przewód połączeniowy i otwórz instrukcję miernika na funkcji testu ciągłości. Na części mierników tę funkcję wybiera się dodatkowym przyciskiem. Nie zgaduj po samym symbolu diody, jeśli instrukcja rozdziela oba tryby.

  1. Wyłącz miernik, jeśli jego instrukcja wymaga wyłączenia przy zmianie przewodów.
  2. Czarny przewód włóż do COM.
  3. Czerwony włóż do gniazda wskazanego przez instrukcję dla rezystancji i ciągłości, zwykle oznaczonego m.in. V/Ω.
  4. Wybierz test ciągłości.
  5. Trzymaj sondy oddzielnie. Zapisz wskazanie dla rozwartego obwodu.
  6. Zetknij metalowe końcówki sond. Sprawdź, czy pojawił się sygnał lub niska wartość rezystancji.
  7. Przyłóż sondy do dwóch końców przewodu połączeniowego. Końcówki trzymaj stabilnie, nie dotykając jednocześnie metalowych części palcami.
  8. Delikatnie porusz przewodem przy zakończeniach. Nie wyrywaj go i nie wyginaj ostro.

Oczekiwany wynik: przy zetkniętych sondach i sprawnym przewodzie miernik sygnalizuje połączenie. Po rozdzieleniu sond sygnał znika. Dokładny próg piszczyka oraz symbole zależą od modelu miernika. Wprowadzenie do ciągłości połączeń.

Nie wpisuję w kartę obowiązkowego wyniku „0,00 Ω”. W pomiarze uczestniczą przewody miernika, końcówki i miejsca styku. Dla nas liczy się teraz odróżnienie połączenia od przerwy oraz stabilność wyniku. Jeśli dźwięk zanika przy poruszeniu przewodem, sprawdź go ponownie, a w razie potwierdzenia odłóż do pojemnika „podejrzane”.

Gdy miernik nie piszczy

Najpierw zewrzyj same sondy. Jeżeli nadal nie ma reakcji, problem nie został jeszcze przypisany do badanego przewodu. Sprawdź funkcję, przycisk wyboru, baterię i instrukcję miernika. Nie naprawiaj tego wkładaniem sond do innych gniazd na próbę.

Jeżeli sondy przechodzą test, ale przewód nie, powtórz pomiar na czystych metalowych końcówkach. Porównaj z drugim przewodem. Dzięki temu masz prosty punkt odniesienia. Jeden nieudany pomiar nie oznacza jeszcze, że wszystkie przewody z zestawu są złe.

Jeśli Twój miernik nie ma piszczyka, możesz użyć pomiaru rezystancji zgodnie z instrukcją i obserwować różnicę między rozwarciem a niskim oporem. Dźwięk jest wygodą, nie jedyną metodą rozpoznania połączenia.

Dlaczego ciągłość sprawdzamy bez zasilania

Gdy wybierasz Ω lub brzęczyk, miernik sam podaje niewielkie pobudzenie na badany obwód. Obce napięcie zaburza wynik, a przy nieodpowiednim zakresie może uszkodzić miernik. Najpierw odłączam wszystkie źródła, także USB i akumulator. Jeśli w układzie są kondensatory, czekam na ich rozładowanie zgodnie z dokumentacją; nie zwieram ich śrubokrętem.

Przed przełączeniem na ciągłość sprawdzam napięcie DC między badanymi punktami. Brak wskazania napięcia nie zamienia jednak nieznanej instalacji w bezpieczne stanowisko. Dzisiejsze ćwiczenie dotyczy wyłącznie odłączonej stykówki, przewodów i rezystorów.

9. Płytka stykowa: sprawdzamy, które otwory są połączone

Gdy masz własny moduł zasilania do stykówki

W dzisiejszym ćwiczeniu nie używamy modułu MB-102 ani podobnego zasilacza wtykanego. Jeśli dołożysz go później, najpierw porównaj stronę i rozstaw jego pinów z własną płytką. Oznaczenia plusa i minusa na plastiku nie potwierdzają polaryzacji włożonego modułu. Sprawdź napięcie na pustych szynach przed podłączeniem ESP.

Otwory w płytce stykowej nie są niezależnymi gniazdkami. Pod plastikiem znajdują się metalowe styki. Ich układ decyduje, które końcówki elementów zostaną elektrycznie połączone. Kolorowa linia przy szynie nie jest źródłem napięcia: to tylko oznaczenie.

W popularnym układzie otwory środkowej części są połączone w krótkie grupy, rozdzielone środkową szczeliną. Boczne szyny służą do rozprowadzania połączeń. Ich ciągłość, zwłaszcza w połowie długości, trzeba jednak sprawdzić na swoim egzemplarzu. Budowa płytki stykowej.

Poniższy rysunek pokazuje założenie do sprawdzenia pomiarem, a nie zweryfikowany schemat Twojej płytki. Litery A-J i numer 10 są przykładem oznaczeń. Jeśli Twoja płytka ma inny układ, narysuj jej własną mapę.

Przykładowy fragment środkowej części:

 A10: B10: C10: D10: E10   ||   F10: G10: H10: I10: J10
             jedna grupa      ||             druga grupa
                          szczelina

 A11: B11: C11: D11: E11   ||   F11: G11: H11: I11: J11

Połączenia między grupami i bocznymi szynami NIE są tu dodane.
Zasilanie: ODŁĄCZONE. ESP: NIEPODŁĄCZONY.

Poglądowa mapa grup połączeń płytki stykowej ze środkową szczeliną i przykładowo dzielonymi szynami

Na ilustracji wiersze mają różne kolory wyłącznie po to, żeby odróżnić grupy połączeń. Zielony ani niebieski nie oznacza tu zmierzonego napięcia. Nie wszystkie płytki mają ciągłe szyny boczne: niektóre są celowo podzielone w połowie. Inne konstrukcje mają inny podział. Zapiszesz wynik pomiaru swojego egzemplarza, a nie oczekiwanie z rysunku.

Nie wciskaj grubych sond bezpośrednio w otwory, jeżeli mogą rozgiąć styki. W wybrane punkty włóż dwa krótkie, wcześniej sprawdzone przewody męski-męski. Sondy przykładaj do ich wolnych metalowych końców. Przed włożeniem przewodów upewnij się, że płytka nadal nie ma zasilania.

Próba Punkt pierwszego przewodu Punkt drugiego przewodu Co ustalamy
A A10 E10 Czy wskazane otwory należą do jednej grupy.
B A10 A11 Czy sąsiednie grupy są rozdzielone.
C E10 F10 Czy środkowa szczelina rozdziela połączenia.
D Początek jednej bocznej szyny Koniec tej samej szyny Czy cała szyna jest ciągła.
E Szyna oznaczona plusem Sąsiednia szyna oznaczona minusem Czy szyny są rozdzielone bez dodanej zworki.

W typowym układzie A da połączenie, B i C rozwarcie. Wyniku D nie wpisuj z pamięci: tu właśnie często odkrywamy przerwę w szynie. W E oczekujemy rozdzielenia, o ile niczego nie dołączyliśmy. Jeśli wyniki są inne, sprawdź współrzędne, przewody i dokumentację płytki. Nie dopasowuj opisu do oczekiwanej odpowiedzi.

Dwa małe eksperymenty

Najpierw wybierz dwie rozdzielone grupy. Potwierdź brak połączenia. Dodaj między nimi jeden przewód i powtórz pomiar. Następnie usuń przewód. Zobaczysz, że miernik pokazuje zmianę, którą sam wprowadziłeś. To nasz pierwszy prosty test „przed: po: powrót”.

Drugi eksperyment dotyczy oznaczeń. Narysuj czerwoną szynę na kartce, ale nie podłączaj zasilania. Zapisz obok „brak źródła”. Chcę, żebyś zapamiętał, że kolor i napis 5 V nie tworzą napięcia. Źródło oraz rzeczywiste połączenie zawsze trzeba wskazać osobno.

Nie zrywaj spodniej naklejki płytki tylko po to, żeby zobaczyć styki. Pomiar daje nam potrzebną informację bez uszkadzania mocowania. Jeśli jakiś otwór nie trzyma przewodu albo połączenie jest niestabilne, zaznacz to miejsce i nie używaj go w projekcie.

Miejsce na przerwę. Wyjmij przewody i zostaw płytkę bez zasilania. W karcie zapisz, czy boczne szyny mają przerwę. Jeśli wrócisz jutro, nie będziesz musiał odtwarzać wyniku z pamięci.

Po próbach płytki stykowej: wiesz, które otwory są połączone, gdzie jest szczelina i czy boczna szyna ma przerwę. Te trzy informacje zapisz przed wyjęciem przewodów. Jeżeli pomiar nie pasuje do przykładu, wróć do współrzędnych i przewodów; nie dodawaj zasilania, żeby „zobaczyć, co będzie”.

10. Pomiar rezystora: wartość i jednostka są równie ważne

Miernik z automatycznym zakresem

W trybie auto-range miernik sam wybiera zakres i może zmienić przedrostek jednostki. Czytaj liczbę razem z symbolem: 0,998 kΩ to 998 Ω, a 0,998 MΩ to 998000 Ω. Sama pozycja przecinka nie rozstrzyga wartości. Jeśli wskazanie przeskakuje między zakresami, najpierw ustabilizuj kontakt sond.

Weź rezystor 1 kΩ opisany w opakowaniu. Wyjmij go z płytki i odłącz od pozostałych elementów. Nie mierzymy go w działającym układzie. Omomierz sam wykorzystuje niewielki sygnał pomiarowy, dlatego obce zasilanie zakłóca pomiar i może być niebezpieczne dla przyrządu. Zasady pomiaru rezystancji.

  1. Pozostaw czarny przewód w COM i czerwony we właściwym gnieździe V/Ω.
  2. Wybierz pomiar Ω. Jeśli miernik ma zakresy ręczne, wybierz zakres obejmujący 1 kΩ, zgodnie z instrukcją.
  3. Przyłóż jedną sondę do jednej końcówki rezystora, drugą do drugiej.
  4. Poczekaj na stabilny wynik i odczytaj również jednostkę.
  5. Zamień sondy miejscami i powtórz pomiar.
  6. Zapisz wartość, jednostkę i zakres miernika.

Zapis jednostki: przedrostek „k” oznacza tysiąc, więc 1 kΩ = 1000 Ω. Wartość 0,998 kΩ odpowiada 998 Ω. To przykład przeliczenia, nie wynik mojego pomiaru. Zanim ocenisz odchyłkę, zapisz całe wskazanie wraz z Ω, kΩ albo MΩ.

Rezystor nie ma polaryzacji, więc sama zamiana sond nie powinna istotnie zmienić jego oporu. Wskazanie około 1,00 kΩ i około 1000 Ω opisuje tę samą wielkość. Wskazanie 1,00 MΩ oznacza już coś innego. Jeżeli wynik nie pasuje do wartości elementu, najpierw sprawdź jednostkę, zakres i kontakt sond.

Dla oznaczonego rezystora 1 kΩ z tolerancją 1% sam przedział wynikający z tolerancji elementu wynosi 990-1010 Ω. To nie jest automatycznie przedział zaliczenia całego pomiaru: miernik ma własną dokładność i rozdzielczość. Do oceny wyniku potrzebna jest jego instrukcja. Nie odrzucaj elementu tylko dlatego, że wskazanie nie jest dokładnie równe 1000.

Praktyczna kontrola jest prosta: jeśli widzisz wynik w okolicy jednego kilooma, rozumiesz jednostkę i potrafisz powtórzyć pomiar, ćwiczenie spełnia cel. Jeżeli wartość jest dziesięć razy większa lub mniejsza, nie maskuj tego korektą programową. Ustal, czy wziąłeś właściwy element.

Opcjonalne sprawdzenie połączenia z rezystorem

Jeżeli masz ochotę na jeszcze jedną próbę, umieść rezystor między dwiema wcześniej sprawdzonymi, rozdzielonymi grupami płytki stykowej. Zmierz opór z dwóch wolnych punktów tych grup. Potem przełóż obie końcówki rezystora do tej samej grupy i powtórz pomiar.

W pierwszym przypadku droga pomiarowa powinna prowadzić przez rezystor. W drugim metalowy styk płytki łączy obie jego końcówki i tworzy obejście. Dzięki temu zobaczysz, dlaczego element może być fizycznie włożony do płytki, a mimo to nie pełnić swojej roli w obwodzie. Nadal nie ma tu zasilania ani ESP.

Po ćwiczeniu odłóż rezystor do opisanego pojemnika. Wyłącz miernik. Przed następnym użyciem ponownie sprawdzisz ustawienie i gniazda; nie zakładaj, że od ostatniego pomiaru nikt ich nie zmienił.

11. Zasilanie: dzisiejsza decyzja brzmi „jeszcze nie podłączam”

W lekcji 4 będziemy mierzyć napięcia, dobierać zasilanie i analizować spadki pod obciążeniem. Dzisiaj ustalamy sposób przygotowania do tej pracy. Nie próbuj sprawdzać wszystkich wejść zasilania płytki metodą podłączania kolejnych przewodów.

Na karcie ESP32-DevKitC V4 producent wymienia Micro-USB, wejście 5 V/GND i wejście 3V3/GND jako wzajemnie wykluczające się sposoby zasilania. To konkretna właściwość tej płytki. Nie zmieniam jej w regułę o wszystkich urządzeniach z USB ani nie zakładam, że inny devkit ma układ wyboru źródła. Instrukcja zasilania DevKitC V4.

Podobnie oznaczenie 5 V przy wejściu nie oznacza, że wszystkie sygnały na płytce są pięciowoltowe. Napięcie zasilania płytki i poziom sygnału GPIO to różne informacje. W lekcji 5 sprawdzimy dopasowanie poziomów oraz sposób sterowania elementami, których nie wolno zasilać bezpośrednio z wyjścia mikrokontrolera.

Nie dodaję dziś schematu zasilania dla nieznanego klona. W karcie zapisz „zasilanie nieustalone”, jeśli nie masz dokumentacji. Dzięki temu przed uruchomieniem od razu zobaczysz, do czego trzeba wrócić. W karcie możesz dopisać źródło, w którym zamierzasz to sprawdzić: instrukcję producenta, schemat albo odpowiedź sprzedawcy. Podobne zdjęcie z aukcji zostaw jako wskazówkę do dalszych poszukiwań.

Trzy różne rzeczy nazywane „zasilaczem”

Ładowarka USB, regulowany zasilacz laboratoryjny i mały moduł do szyn płytki stykowej pełnią różne role. Ładowarka ma określone tryby wyjściowe, zasilacz laboratoryjny zwykle pozwala ustawiać napięcie i ograniczenie prądu, a moduł do breadboardu dopiero przetwarza lub rozprowadza dostarczone mu zasilanie. Zakresy, zabezpieczenia i sposób ustawiania sprawdzasz dla konkretnego produktu.

Nie zakładaj, że złącze USB lub napis „do ESP” gwarantuje właściwe napięcie na wybranym pinie. Zewnętrzny moduł zasilający również ma dokumentację, wejście, wyjścia i ograniczenia. W tej lekcji żadnego z tych źródeł nie dołączamy. W lekcji 4 przejdziemy pomiary i dobór krok po kroku.

Po pomiarach: wyłącz miernik, zapisz wartość z jednostką i odłóż podejrzane przewody osobno. Nie ma jeszcze podstaw do zaznaczenia „ESP działa”: sprawdziłeś elementy stanowiska, nie firmware ani komunikację urządzenia.

12. Karta urządzenia: dokumentacja, którą naprawdę da się wykorzystać

Każde urządzenie dostanie własny katalog. Nie musisz w tym celu zakładać specjalnego programu ani tworzyć rozbudowanego archiwum. Wystarczy kilka plików, które pozwolą Ci wrócić do projektu po miesiącu i rozpoznać jego części.

lab30/
  01-warsztat/
    karta-urzadzenia.md
    karta-testow.csv
    lista-czesci.csv
    dokumentacja-producenta/
    zdjecia/

Utwórz te katalogi w miejscu, z którego wykonujesz kopię danych. Nazwy możesz przepisać ręcznie w swoim menedżerze plików. Nie wymagają żadnego specjalnego programu. Pliki tekstowe zapisuj jako UTF-8, żeby zachować polskie znaki.

W karcie zapisz producenta płytki, model, rewizję, oznaczenie modułu, źródło zakupu, datę i link do dokumentacji. Dodaj zdjęcie przodu oraz tyłu. Dla nowej płytki wpisz stan firmware „nieustalony”, dopóki go nie rozpoznamy. Dioda świecąca po podłączeniu nie mówi nam, kto zbudował program i jakie ma on ustawienia.

Osobno zapisz status sprawdzenia:

  • dokumentacja: znaleziona i pasująca / niepotwierdzona;
  • oględziny: wykonane / niewykonane;
  • pomiary: jakie i z jakim wynikiem;
  • walidacja konfiguracji: niewykonana, dopóki jej faktycznie nie wykonasz;
  • kompilacja: niewykonana, dopóki nie zbudujesz firmware;
  • test na sprzęcie: niewykonany, dopóki urządzenie nie przejdzie próby.

Nie zastępuj tego jednym polem „działa”. Poprawny plik YAML może nie pasować do fizycznego połączenia. Udana kompilacja nie dowodzi też, że czujnik poda właściwy wynik. Tak samo pomiar przewodu nie jest testem działania całego urządzenia.

Przykład wypełnienia: tak może wyglądać Twoja pierwsza karta

Przykładowo wypełniona karta. Przygotowałem ją, żebyś widział, jak zapisać oznaczenia i braki w dokumentacji. Wpisy oraz wyniki w obu tabelach są przykładowe: nie pochodzą z pomiaru urządzenia.

Pole Przykładowy wpis
Data i cel 27.10.2026; przygotowanie pierwszego urządzenia do pomiaru temperatury w warsztacie.
Płytka i wariant Espressif ESP32-DevKitC V4, wariant handlowy ESP32-DevKitC-32E.
Moduł ESP32-WROOM-32E: oznaczenie przepisane w tym przykładzie z osłony.
Rewizja PCB Jeszcze niepotwierdzona. Potrzebne czytelne zdjęcie obu stron.
USB i dokumentacja Micro-USB; instrukcja DevKitC V4 zapisana w katalogu projektu. Zgodność poszczególnych połączeń do ponownego sprawdzenia przed zasileniem.
Zakup Sklep i numer zamówienia zapisane tylko w prywatnej kopii.
Firmware Nieustalony; nie kasowano pamięci i niczego nie wgrywano.
Zasilanie Niepodłączone. Zapisano wymaganie sprawdzenia sposobu zasilania przed uruchomieniem.
Stan warsztatu Płytka stykowa i trzy przewody opisane; jeden przewód odłożony jako podejrzany.
Konfiguracja / kompilacja / ESP Niewykonane / niewykonana / test urządzenia niewykonany.
Następna czynność Rozpoznać rewizję i przejść przegląd płytek w lekcji 2.

Nie musisz wypełnić każdego pola od razu. Wpis „brak informacji” jest użyteczny, jeśli obok zapiszesz, jak tę informację uzyskasz. Dzięki temu po przerwie nie zaczniesz od początku.

Przykład karty testów z wynikiem innym niż oczekiwany

Poniższe wyniki są fikcyjne i służą nauce zapisu. Nie przepisuj ich do swojej karty. Własne wiersze uzupełnisz dopiero po pomiarze.

Próba Przykładowy zapis wyniku Co z nim robię
Sondy rozdzielone i zetknięte Rozdzielone: OL; zetknięte: sygnał. Test miernika wykonany. Symbol OL zależy od modelu.
Przewód 1 Stabilny sygnał przy delikatnym ruchu. Zostaje w zestawie ćwiczeniowym.
Przewód 2 Sygnał zanika przy jednej końcówce, powtórzono na innych sondach styku. Odkładam i oznaczam; nie dokładam go do niepewnego układu.
A10-E10 / A10-A11 Połączenie / rozwarcie. Zapisuję mapę konkretnej płytki.
Początek-koniec bocznej szyny Rozwarcie; każda połowa sprawdzona oddzielnie ma ciągłość. Zaznaczam przerwę na zdjęciu. Nie traktuję jej automatycznie jako uszkodzenia.
Rezystor Przykładowo 0,998 kΩ; odnotowany model i zakres miernika. Przeliczam: 998 Ω. Ocenę dokładności odnoszę do instrukcji przyrządu.
Test ESP w HA Niewykonany. Nie wpisuję PASS tylko dlatego, że przewody są sprawne.

Kartę urządzenia i wyniki pomiarów zapisuj we własnym notatniku lub arkuszu według pól opisanych w lekcji. Kiedy pomiar wyjdzie inaczej niż w przykładzie, dopisz warunki i sprawdzone połączenia. Taka uwaga jest cenniejsza niż poprawianie tabeli pod oczekiwaną odpowiedź.

Czego nie wpisywać do karty wysyłanej publicznie

Nie umieszczaj hasła do Wi-Fi, klucza API, tokenów i haseł do panelu. Przy zgłoszeniu na forum przygotujemy kopię bez sekretów. Możesz podać model płytki, wersję firmware, opis połączenia oraz log błędu. To zwykle dużo bardziej przydatne niż zdjęcie całego ekranu z widocznymi danymi dostępowymi.

Adresy i identyfikatory zapisujemy jako rzeczywiste dopiero po uruchomieniu. W tej lekcji nie tworzę żadnego entity_id w Twoim HA. Jeżeli później zobaczysz nazwę przykładową, zostanie tak oznaczona. Dla własnego urządzenia odczytasz rzeczywistą nazwę z systemu.

13. Diagnostyka dzisiejszego warsztatu według objawu

Objaw Najpierw sprawdź Następny krok
Miernik nie reaguje na zetknięcie sond Funkcję, gniazda, przewody i baterię zgodnie z instrukcją Nie oceniaj jeszcze badanego elementu; najpierw uruchom sam test miernika.
Wynik przewodu zmienia się przy poruszeniu Kontakt końcówek i zakończenia przewodu Porównaj z drugim przewodem, a podejrzany oznacz i odłóż.
Nie ma połączenia między otworami uznanymi za wspólne Współrzędne, poprawność obu przewodów i rzeczywisty układ styków Sprawdź sąsiednie otwory i narysuj mapę pomiarów.
Jest połączenie przez środkową szczelinę Pozostawioną zworkę, elementy i położenie przewodów Opróżnij płytkę i powtórz próbę na samej płytce.
Jedna połowa bocznej szyny nie łączy się z drugą Przerwę konstrukcyjną Zapisz ją. Zworkę dodamy dopiero w konkretnym układzie wymagającym takiego połączenia.
Rezystor 1 kΩ ma dziwny wynik Jednostkę, zakres, kontakt i to, czy jest odłączony od innych elementów Zmierz drugą opisaną sztukę; nie uznawaj od razu miernika za uszkodzony.
Płytka ESP nie pasuje szerokością do breadboardu Rzeczywiste wymiary i dostępność otworów przy pinach Użyj przewodów lub właściwej podstawki; nie wciskaj na siłę i nie wyginaj pinów.
Zdjęcie w sklepie różni się od dostarczonej płytki Producenta, rewizję i oznaczenia Zatrzymaj dopasowywanie schematu; wyjaśnij wariant ze sprzedawcą.
Nie masz potrzebnego narzędzia Listę „dzisiaj” i „później” Wykonaj część dokumentacyjną, a pomiar oznacz jako niewykonany. Nie wpisuj przewidywanego wyniku jako wyniku testu.

W kolejnych lekcjach dojdą komunikaty z portu szeregowego i logi ESPHome. Dzisiaj ich nie oczekujemy: nie zasilaliśmy ani nie programowaliśmy ESP. Brak logów nie jest więc usterką tego ćwiczenia.

Dwie grupy problemów warto zapamiętać na później. Dokumentacja esptool opisuje m.in. zły port, zajęty port, tryb startowy i zasilanie jako oddzielne przyczyny trudności z wgrywaniem. W historycznym zgłoszeniu ESPHome użytkownicy porównywali zaś wpływ zasilania oraz konfiguracji przy jednoczesnym Wi-Fi i BLE. Nie wynika z tego jedna recepta dla wszystkich płytek. Wynika potrzeba zapisywania warunków próby i zmieniania jednego elementu naraz. esptool: diagnostyka, zgłoszenie ESPHome #5754.

Kabel zasila, ale komputer nie widzi płytki

Świecąca dioda potwierdza dopływ energii, nie transmisję USB. Kabel do ładowania może nie mieć toru danych. Porównuję ten sam port i tę samą płytkę z kablem, którym przed chwilą przesłałem dane do sprawnego urządzenia. Potem zmieniam port, nadal z tym samym sprawdzonym kablem. Zapisuję zmianę na liście urządzeń, zamiast oceniać kabel po grubości lub wyglądzie wtyczki.

14. Jak będziemy dochodzić do kompletnych urządzeń

Najpierw poznamy rodziny i płytki. Później przygotujemy zasilanie, GPIO i USB, a następnie przejdziemy pełne uruchomienie ESPHome. Zanim zaczniemy duże projekty, nauczymy się czytać konfigurację i sprawdzać magistrale. Ta kolejność ma ułatwić diagnozę: będziesz wiedział, którą warstwę właśnie testujesz.

Przy każdym projekcie przejdziemy od listy części i tabeli połączeń do uruchamiania etapami. Najpierw zasilanie i komunikacja, potem pojedynczy podzespół, następnie pozostałe funkcje. Pełna konfiguracja będzie punktem odniesienia, ale wyjaśnię również, które fragmenty odpowiadają za konkretne zachowanie.

Nie wszystkie urządzenia musisz budować. Warto przejść wspólne podstawy, a projekty dobierać do swojego domu. Jeśli nie masz zbiornika, sonda poziomu wody nie jest obowiązkowym zakupem. Nadal możesz przeczytać, jak sprawdzamy błędy pomiaru i połączenia. Nie oznaczaj jednak takiej lektury jako fizycznego uruchomienia sondy.

W końcowej części przeniesiemy urządzenie z eksperymentalnego układu do trwałego montażu. Dopiero wtedy będziemy oceniać złącza, obudowę, odciążenie przewodów, antenę i możliwość serwisu. Płytka, która działała przez chwilę na stole, nie jest jeszcze ukończonym urządzeniem do pozostawienia przy zbiorniku lub nad sufitem.

Ostatnia lekcja będzie odbiorem: odłączony czujnik, utrata HA, utrata sieci, zanik zasilania i powrót do normalnej pracy. Nie będziemy celowo zwierać zasilacza ani powodować niebezpiecznych uszkodzeń. Testujemy zachowanie urządzenia w kontrolowanych warunkach.

15. Kiedy uznaję tę lekcję za ukończoną

Dwa wyniki tej samej lekcji

Jeśli pracujesz na dokumentacji, kończysz z rozpoznaną płytką i listą braków. Jeśli masz części, dodatkowym wynikiem są własne pomiary przewodów, stykówki i rezystora. W karcie zaznacz, którą część wykonałeś. Czasy z tabeli sesji dają łącznie około 120-180 minut; do tego może dojść przygotowanie stanowiska.

Zanim przejdziemy do przeglądu płytek, zerknij jeszcze na stół i swoje notatki. Powinieneś mieć kilka sprawdzonych przewodów, opisaną płytkę stykową i zapis pomiaru rezystora. Poniższa tabela pomoże Ci zobaczyć, co już zrobiłeś, a do czego wrócisz po uzupełnieniu części.

Co mam przygotowane Gdzie znajdę tę informację
Rozróżniam układ, moduł, płytkę i firmware Cztery krótkie opisy własnymi słowami.
Mam punkt odniesienia dla płytki Pełne oznaczenie i link do dokumentacji albo jawny wpis „wariant jeszcze nieustalony”.
Umiem przygotować miernik do dzisiejszego pomiaru Wskazane właściwe gniazda i funkcja; bez używania wejścia prądowego.
Sprawdziłem przewody Wynik testu sond i co najmniej trzech przewodów.
Znam połączenia swojej płytki stykowej Mapa lub tabela prób A-E z rzeczywistymi wynikami.
Rozumiem pomiar rezystancji Wynik rezystora z jednostką i informacją o zakresie.
Mam kartę urządzenia i listę braków Pliki w katalogu projektu oraz zdjęcia, jeśli mam sprzęt.
Wiem, czego jeszcze nie sprawdziłem Osobno zapisane statusy konfiguracji, kompilacji i testów ESP.

Jeżeli nie masz części, możesz zakończyć część przygotowawczą, ale próby fizyczne pozostaw jako „do wykonania”. To nie błąd. Ważne, żeby karta nie przedstawiała zaplanowanego ćwiczenia jako wykonanego.

Ćwiczenie samodzielne

Wybierz jeden prosty pomysł na urządzenie do swojego domu. Na razie nie projektuj elektroniki. Opisz: co ma odczytywać, co ma sygnalizować lub sterować, gdzie będzie zamontowane, z czego będzie zasilane i co zrobi bez HA. Następnie wskaż trzy rzeczy, które musisz jeszcze sprawdzić w dokumentacji.

Przykład sposobu myślenia: „Chcę wiedzieć, czy w skrzynce jest nowa korespondencja. Nie wiem jeszcze, czy radio dosięgnie do domu, jak długo będzie działać bateria i jak potwierdzę dostarczenie zdarzenia”. Z tak zapisanym pomysłem łatwiej później porównać płytki. Od razu zobaczysz, czy mniejszy rozmiar naprawdę Ci pomaga, czy ważniejsze okażą się zasilanie, antena i miejsce na złącza. Wracając do tej notatki przy lekcji 18, porównasz swoje pierwsze założenia z gotowym rozwiązaniem.

Na następną sesję zostaw uporządkowany stół, odłączone zasilanie, sprawdzone przewody i kartę wyników. W lekcji 2 przyjrzymy się ESP8266 oraz klasycznemu ESP32 już na konkretnych płytkach. Nie musisz teraz podejmować wszystkich decyzji na cały moduł.

Na zakończenie tej sesji: zostaw w karcie jedną konkretną następną czynność. Może to być zakup miernika, ponowny pomiar podejrzanego przewodu albo odczyt oznaczenia płytki. Nie musisz niczego zgadywać ani wykonywać wszystkich projektów, aby przejść tę ścieżkę we własnym tempie.

16. Powiązane materiały MarkLabs

Te materiały pomagają rozszerzyć temat. Nie zastępują dokumentacji konkretnej płytki; informacje o rewizjach i firmware sprawdzamy ponownie w odpowiedniej lekcji.

Jeżeli chcesz wrócić tylko do konkretnej czynności, zachowaj własną kartę przy urządzeniu. Przy następnej sesji wystarczy zajrzeć do oznaczeń płytki, mapy breadboardu i ostatniego wyniku pomiaru, zamiast ponownie rozpoznawać wszystkie części.

17. Źródła, wersje i status sprawdzenia

Wersja lekcji: 1.2. Dokumentację sprawdziłem 27.10.2026. Korzystałem z dokumentacji ESPHome 2026.10.0 oraz integracji Home Assistant opisanej dla wersji 2026.10.4. Dla PlatformIO korzystam z dokumentacji kanału stable, oznaczonej v6.2; dla Arduino z dokumentacji IDE 2 i pakietu Arduino-ESP32, bez instalacji konkretnej wersji w tej lekcji. Dla ESP-IDF sprawdzone wprowadzenie kanału stable dla ESP32-H2 było oznaczone v6.1. Wersje te opisują wykorzystaną dokumentację, nie oprogramowanie wgrane do Twojego urządzenia ani zestaw przetestowany na sprzęcie.

W tej lekcji nie uruchamiamy firmware. Do jej ukończenia wystarczą opisane ćwiczenia, tabele i własne notatki: oznaczenie płytki, lista części oraz wyniki prób. Pierwszą konfigurację firmware wykonamy w osobnym warsztacie.

Rodzaj sprawdzenia materiału Status
Dokumentacja układu, płytki i narzędzi Sprawdzona w zakresie lekcji, z ograniczeniami opisanymi w tekście.
Treść i ilustracje Przy czytaniu na telefonie przewijaj szerokie tabele poziomo. Ilustrację otwórz w pełnym rozmiarze, jeśli oznaczenia są zbyt małe.
Walidacja konfiguracji ESPHome Nie dotyczy: brak firmware w tej lekcji.
Kompilacja firmware Nie dotyczy: nie wykonywano.
Test na fizycznym sprzęcie autora Nie wykonano dla tej wersji materiału. Opisane wyniki są oczekiwaniami do sprawdzenia przez kursanta, nie deklaracją wykonanego testu.

Dokumentacja podstawowa:

  1. Espressif: ESP32-DevKitC V4, budowa i zasilanie.
  2. Espressif: ESP32-H2: możliwości układu.
  3. ESPHome: platforma ESP32 i warianty.
  4. ESPHome: rozpoczęcie pracy.
  5. Home Assistant: integracja ESPHome.
  6. Espressif: Arduino-ESP32: instalacja obsługi platformy.
  7. Arduino: IDE 2: budowanie i wgrywanie szkicu.
  8. PlatformIO: rola środowiska.
  9. Espressif: ESP-IDF: rozpoczęcie pracy.
  10. Espressif: esptool: diagnostyka połączenia.
  11. Adafruit: budowa płytki stykowej.
  12. Adafruit: pomiar ciągłości.
  13. Adafruit: pomiar rezystancji.

Dokumentacja do uzupełnionego zagadnienia

Sprawdzam dokumentację dla użytej wersji i konkretnej płytki: Pomiary multimetrem.

Co dalej z Home Assistant?

Jeśli chcesz pójść dalej, w kursie „Smart Home od Zera” pokażę Ci krok po kroku, jak skonfigurować Home Assistant, zbudować pierwsze automatyzacje i wykorzystać je we własnych projektach.

Lekcje
369
Moduły
29
Pełny dostęp
39 zł

Jedna opłata za dostęp do całego kursu. Bez abonamentu.

Skończyłeś tę lekcję?

💬 Tematy do tej lekcjiCałe forum

Poniżej są wyłącznie tematy powiązane z tą lekcją. Pełna treść i odpowiedzi znajdują się na forum MarkLabs.

Nie ma jeszcze tematów do tej lekcji.

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