Programowanie ESP8266 pozwala szybko zbudować urządzenie połączone z Wi-Fi, od prostego czujnika temperatury po sterownik oświetlenia lub mały serwer WWW. Pokażę, jaki moduł wybrać, jak przygotować Arduino IDE, wgrać pierwszy szkic, bezpiecznie korzystać z GPIO i uniknąć problemów z zasilaniem oraz komunikacją bezprzewodową.

Od czego zacząć pracę z ESP8266

ESP8266 to mikrokontroler z wbudowanym Wi-Fi, pamięcią flash na program i zestawem wejść oraz wyjść cyfrowych. W praktyce nie muszę budować całego układu od podstaw, ponieważ popularne płytki deweloperskie mają już konwerter USB-UART, stabilizator napięcia i przyciski Reset oraz Flash.

Na początek wybrałbym NodeMCU albo Wemos D1 mini. Moduł ESP-01 jest mały i tani, ale ma niewiele wygodnie dostępnych pinów, a jego programowanie często wymaga dodatkowego adaptera USB. D1 mini zajmuje mniej miejsca niż NodeMCU, natomiast NodeMCU zwykle łatwiej znaleźć w wersji z opisanymi wyprowadzeniami.

Sam układ wymaga zasilania w okolicach 3,3 V. Płytkę NodeMCU można zasilać przez USB, ale nie oznacza to, że każdy pin opisany jako 5V toleruje taki poziom logiczny. To częste źródło uszkodzeń przy podłączaniu czujników i modułów przekaźnikowych.

Jak przygotować Arduino IDE i wgrać pierwszy szkic

Najprostsza ścieżka prowadzi przez Arduino IDE oraz pakiet płytek ESP8266 instalowany z menedżera płytek. W ustawieniach IDE dodaję adres pakietu dla platformy ESP8266, instaluję ją, a później wybieram konkretny model w menu Narzędzia. Nazwy mogą się nieco różnić zależnie od wersji IDE i producenta płytki.

1. Instaluję Arduino IDE 2.x.
2. Dodaję pakiet ESP8266 w menedżerze płytek.
3. Wybieram model, na przykład NodeMCU 1.0 albo LOLIN/Wemos D1 mini.
4. Wskazuję właściwy port szeregowy.
5. Wgrywam szkic przyciskiem Upload.

Na pierwsze uruchomienie wystarczy miganie diodą. Numer pinu LED nie jest taki sam na każdej płytce, dlatego zamiast bezrefleksyjnie kopiować przykład, sprawdzam opis płytki albo jej dokumentację. W przypadku wielu płytek NodeMCU dioda jest podłączona do D4, czyli GPIO2, ale logika może być odwrócona: stan niski włącza diodę.

const int LED_PIN = LED_BUILTIN;

void setup() {
  pinMode(LED_PIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_PIN, LOW);
  delay(500);

  digitalWrite(LED_PIN, HIGH);
  delay(500);
}

Jeżeli program się kompiluje, ale nie wgrywa, najpierw sprawdzam port, kabel USB i wybraną płytkę. Tani przewód może służyć wyłącznie do ładowania. Gdy płytka nie przechodzi automatycznie w tryb programowania, pomaga przytrzymanie przycisku Flash podczas resetu lub rozpoczęcia uploadu.

Komunikaty startowe ESP8266 mogą pojawiać się z prędkością 74880 bitów na sekundę, a później program może używać innej szybkości. To normalne, że pierwsze znaki w monitorze portu wyglądają jak przypadkowe symbole, jeśli ustawiona jest standardowa prędkość 9600 albo 115200.

Jak napisać program korzystający z Wi-Fi

Największą zaletą tego mikrokontrolera jest gotowa biblioteka ESP8266WiFi. Dzięki niej mogę połączyć urządzenie z domową siecią, wysłać dane do serwera HTTP, uruchomić prostą stronę konfiguracyjną albo komunikować się przez MQTT, czyli lekki protokół często używany w automatyce domowej.

#include 

const char* ssid = "NAZWA_SIECI";
const char* password = "HASLO_SIECI";

void setup() {
  Serial.begin(115200);
  WiFi.mode(WIFI_STA);
  WiFi.begin(ssid, password);

  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }

  Serial.println();
  Serial.print("Adres IP: ");
  Serial.println(WiFi.localIP());
}

void loop() {
}

W tym przykładzie ESP8266 działa jako klient sieci, czyli pobiera adres IP z routera i oczekuje na połączenie. W realnym projekcie nie zostawiam nieskończonej pętli oczekiwania bez limitu, ponieważ awaria routera lub zmiana hasła mogłaby zatrzymać całe urządzenie. Lepsze rozwiązanie to limit czasu, ponawianie połączenia i tryb konfiguracji.

Dane dostępowe nie powinny być wpisywane bezpośrednio do publicznego repozytorium. Przy prototypie można użyć osobnego pliku konfiguracyjnego, a w gotowym urządzeniu lepiej umożliwić konfigurację przez lokalny punkt dostępowy. Pamiętam też, że ESP8266 nie jest dobrym miejscem do przechowywania bardzo wrażliwych sekretów bez dodatkowych zabezpieczeń.

Prosty serwer sterujący wyjściem

ESP8266 może uruchomić mały serwer WWW i reagować na żądania z telefonu. To dobry pierwszy projekt, ponieważ łączy programowanie GPIO, sieć i prosty interfejs użytkownika, a efekt widać niemal natychmiast.

#include 
#include 

const char* ssid = "NAZWA_SIECI";
const char* password = "HASLO_SIECI";

ESP8266WebServer server(80);
const int outputPin = D1;

void handleRoot() {
  String page = "
Sterowanie
";
  page += "Włącz
";
  page += "Wyłącz";
  server.send(200, "text/html", page);
}

void setup() {
  pinMode(outputPin, OUTPUT);
  digitalWrite(outputPin, LOW);

  WiFi.begin(ssid, password);
  while (WiFi.status() != WL_CONNECTED) {
    delay(300);
  }

  server.on("/", handleRoot);
  server.on("/on", []() {
    digitalWrite(outputPin, HIGH);
    server.send(200, "text/plain", "Włączono");
  });
  server.on("/off", []() {
    digitalWrite(outputPin, LOW);
    server.send(200, "text/plain", "Wyłączono");
  });

  server.begin();
}

void loop() {
  server.handleClient();
}

Do sterowania diodą ten przykład jest wystarczający, ale nie podłączam w ten sposób silnika ani większego przekaźnika. GPIO może sterować wejściem tranzystora lub gotowego modułu, lecz obciążenie powinno mieć osobne zasilanie i właściwy stopień wykonawczy. Przy urządzeniu wystawionym poza sieć lokalną dochodzi jeszcze uwierzytelnianie, szyfrowanie i aktualizacje OTA.

GPIO, ADC i pułapki związane z pinami

Opisy na płytce, takie jak D1, D2 czy D5, nie są numerami GPIO. Przykładowo D1 zwykle oznacza GPIO5, D2 to GPIO4, D5 to GPIO14, a D6 to GPIO12. W kodzie mogę używać nazw D1 lub numerów GPIO, ale mieszanie tych oznaczeń bez sprawdzenia mapowania prowadzi do bardzo typowego błędu, czyli sterowania innym pinem niż zamierzony.

Najwięcej ostrożności wymagają piny startowe. GPIO0 powinien być w stanie wysokim podczas normalnego uruchamiania, a zwarty do masy przy starcie wprowadza układ w tryb programowania. GPIO2 również musi mieć właściwy poziom, natomiast GPIO15 jest używany do wyboru trybu startu. Podłączenie przycisku, przekaźnika lub diody do tych linii bez rezystorów może sprawić, że urządzenie będzie wyglądało na uszkodzone.

GPIO16 ma specjalne zastosowanie, ponieważ może wybudzać układ z deep sleep po połączeniu z wejściem reset. Tryb głębokiego uśpienia potrafi mocno ograniczyć zużycie energii, ale urządzenie po wybudzeniu startuje od początku programu. Nie jest to zwykła pauza, tylko pełny cykl uśpienia, resetu i ponownego uruchomienia.

Wejście analogowe również wymaga sprawdzenia konkretnej płytki. Sam ESP8266 ma ograniczony zakres wejścia ADC, a niektóre płytki dodają dzielnik napięcia, dzięki któremu pin A0 obsługuje szerszy zakres. Nie zakładam więc automatycznie, że każde A0 bezpiecznie przyjmie 3,3 V.

Zasilanie decyduje o stabilności projektu

Wiele problemów przypisywanych błędom w kodzie wynika z zasilania. Podczas pracy Wi-Fi pobór prądu zmienia się dynamicznie, a słaby stabilizator, długi przewód lub kiepski kabel USB powodują reset mikrokontrolera. Objawem jest powtarzający się start, komunikat o utracie połączenia albo losowe zawieszanie programu.

Dla płytki z USB wybieram dobre źródło 5 V i stabilny przewód. Przy własnym układzie stosuję regulator 3,3 V z zapasem prądowym oraz kondensatory blisko modułu. Nie zasilam ESP8266 bezpośrednio z przypadkowego wyjścia 3,3 V Arduino, ponieważ jego wydajność może być zbyt mała dla impulsów poboru podczas transmisji.

• Nie podawaj 5 V na GPIO.
• Silniki, taśmy LED i przekaźniki zasilaj z osobnego źródła.
• Połącz masy wszystkich części układu.
• Dodaj kondensator filtrujący blisko modułu, jeśli występują resety.
• Nie oceniaj stabilności wyłącznie po tym, że program działa bez włączonego Wi-Fi.

W projektach bateryjnych warto użyć deep sleep, pomiaru napięcia i budzenia w określonych odstępach. To działa świetnie dla czujnika wysyłającego pomiar co kilka minut, ale gorzej dla urządzenia, które ma natychmiast reagować na żądanie z sieci. Tutaj kompromisem może być light sleep albo pozostawienie aktywnego połączenia kosztem krótszego czasu pracy.

Arduino IDE, PlatformIO czy własne SDK

Arduino IDE jest najlepsze, gdy chcę szybko uruchomić czujnik, diodę, serwer lub prostą automatykę. Ma niski próg wejścia, ogromny wybór bibliotek i dużo przykładów. Jego słabszą stroną jest mniej wygodne zarządzanie większym projektem, zależnościami i konfiguracją różnych środowisk.

PlatformIO daje lepszą organizację kodu, automatyczne zarządzanie bibliotekami i wygodniejszą pracę w edytorze Visual Studio Code. Sięgam po nie, gdy projekt ma kilka modułów, testy, osobne konfiguracje oraz kontrolę wersji. Dla pierwszego migania diodą nie widzę jednak powodu, aby komplikować sobie start.

Bezpośrednie SDK producenta ma sens przy optymalizacji pamięci, nietypowym sprzęcie lub projekcie, w którym liczy się pełna kontrola nad uruchamianiem układu. Początkujący zwykle więcej zyskuje, wybierając dobrze opisany core Arduino, niż próbując od razu opanować najniższy poziom.

Najczęstsze błędy podczas pracy z ESP8266

Program wgrywa się, ale płytka nie startuje

Najpierw sprawdzam piny GPIO0, GPIO2 i GPIO15 oraz elementy podłączone do nich podczas resetu. Potem weryfikuję ustawienia pamięci flash i model płytki. Nie zmieniam trybu flashowania na chybił trafił, ponieważ niekompatybilna konfiguracja może uniemożliwić start programu.

Po uruchomieniu Wi-Fi pojawiają się resety

W takim przypadku podejrzewam przede wszystkim zasilanie, regulator i przewód USB. Dopiero gdy sprzęt jest pewny, sprawdzam blokujące pętle, zbyt duże obiekty typu String oraz błędy w obsłudze pamięci. Monitor portu szeregowego często pokazuje, czy reset nastąpił po błędzie programu, czy po spadku napięcia.

Urządzenie nie łączy się z routerem

Sprawdzam nazwę sieci, hasło, zasięg oraz to, czy router udostępnia sieć 2,4 GHz. ESP8266 nie obsługuje sieci 5 GHz, więc połączenie z routerem obsługującym wyłącznie ten zakres nie zadziała. Warto też dodać timeout i komunikat diagnostyczny zamiast czekać bez końca.

Przeczytaj również: STM32CubeIDE - Twój pierwszy projekt bez frustracji?

Program zajmuje zbyt dużo pamięci

Ograniczam duże teksty, usuwam niepotrzebne biblioteki i przenoszę stałe dane do pamięci flash za pomocą mechanizmów dostępnych w core Arduino. Przy rozbudowanym interfejsie WWW rozważam zapis plików w systemie flash zamiast budowania ogromnego łańcucha znaków w RAM.

Dobry pierwszy projekt ma jasny zakres

Na początek polecam termometr Wi-Fi, monitor wilgotności gleby albo sterownik jednej diody. Taki projekt pozwala przećwiczyć odczyt czujnika, połączenie z siecią, wysyłanie danych i obsługę błędów, bez dokładania od razu aplikacji mobilnej, chmury i skomplikowanego interfejsu.

Sam dzielę kod na małe funkcje: osobno obsługa Wi-Fi, osobno odczyt pomiarów, osobno komunikacja i osobno sterowanie wyjściami. Dzięki temu łatwiej znaleźć problem, a późniejsza zmiana czujnika nie wymaga przepisywania całego programu. W projektach, które mają działać miesiącami, ważniejsze od efektownego demo są watchdog, kontrola czasu oczekiwania i bezpieczny stan wyjść po restarcie.

ESP8266 nadal jest bardzo dobrym wyborem do niedrogich urządzeń IoT, szczególnie gdy wystarcza Wi-Fi 2,4 GHz i niewielka liczba peryferiów. Do nowych projektów wymagających Bluetooth, większej pamięci lub większej liczby funkcji warto rozważyć ESP32, ale do prostego czujnika sieciowego dobrze przygotowany ESP8266 pozostaje szybki, tani i łatwy do uruchomienia.