Płytka z wbudowanym OLED pozwala pokazać wynik pomiaru bez otwierania monitora szeregowego. Pierwszą próbę warto ograniczyć do jednego napisu. Dopiero po uruchomieniu ekranu dodawaj WiFi, czujniki i animacje.

Ustal trzy parametry wyświetlacza

Potrzebujesz nazwy sterownika ekranu, jego rozdzielczości i połączenia I2C. Materiał IMZ opisuje wariant SSD1306 128×64 z adresem 0x3C, SDA na GPIO14 i SCL na GPIO12. To ustawienia konkretnego wariantu ze źródła, a nie wszystkich płytek ESP8266 z OLED.

Porównaj je ze schematem lub oznaczeniem swojej płytki. Numer GPIO nie zawsze odpowiada oznaczeniu D nadrukowanemu na PCB. Nie podłączaj dodatkowych modułów do zajętych linii bez sprawdzenia ich adresów i napięć.

Przygotuj środowisko

Dodaj obsługę ESP8266 do Arduino IDE zgodnie z instrukcją projektu ESP8266 Arduino Core. Wybierz profil zgodny z płytką oraz pamięcią flash. W menedżerze bibliotek zainstaluj Adafruit SSD1306 i jej wymagane zależności, w tym Adafruit GFX.

Poniższy szkic zakłada opisany wyżej wariant sprzętowy. Nie wymaga danych WiFi.

#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

constexpr int OLED_SDA = 14;
constexpr int OLED_SCL = 12;
constexpr uint8_t OLED_ADDRESS = 0x3C;
Adafruit_SSD1306 display(128, 64, &Wire, -1);

void setup() {
  Serial.begin(115200);
  Wire.begin(OLED_SDA, OLED_SCL);
  if (!display.begin(SSD1306_SWITCHCAPVCC, OLED_ADDRESS,
                     true, false)) {
    Serial.println("Blad inicjalizacji biblioteki OLED");
    return;
  }
  display.clearDisplay();
  display.setTextSize(2);
  display.setTextColor(SSD1306_WHITE);
  display.setCursor(0, 16);
  display.println("IMZ");
  display.display();
}

void loop() {}

Ostatni argument false w begin() informuje bibliotekę, że magistrala została już zainicjalizowana. display() przesyła przygotowany obraz do ekranu. Znaczenie parametrów opisuje dokumentacja Adafruit SSD1306. Wynik true z inicjalizacji nie jest pełnym testem fizycznej obecności wyświetlacza.

Gdy ekran pozostaje pusty

Najpierw sprawdź, czy program się uruchamia i czy wybrano właściwy port. Potem porównaj piny I2C i adres. Skaner I2C może potwierdzić odpowiedź urządzenia pod adresem, ale nie rozpozna z pewnością typu kontrolera ani rozdzielczości panelu. Wyświetlacz SH1106 wymaga innego sterownika niż SSD1306 mimo podobnego wyglądu.

Jeśli ekran działa, lecz po dodaniu czujnika przestaje odpowiadać, wróć do minimalnego szkicu. Sprawdź napięcia, adresy i rezystory podciągające magistrali. Wejścia ESP8266 nie są przeznaczone do sygnałów 5 V.

Następny krok: własny panel informacji

Zastąp napis wartością pomiaru i pokaż obok jednostkę oraz stan połączenia. Aktualizuj ekran w określonych odstępach zamiast przy każdym obiegu pętli. Przy długim wyświetlaniu zmieniaj zawartość i rozważ wygaszanie, aby ograniczyć nierównomierne zużycie OLED. Przykład został sprawdzony redakcyjnie pod kątem API biblioteki; wymaga próby na zgodnej płytce.