Instrukcja i dane produktu

• nauka programowania i elektroniki
• budowa prototypów
• realizacja projektów hobbystycznych i edukacyjnych
• integracja z czujnikami i modułami elektronicznymi
• budowa urządzeń IoT
• lokalne wyświetlanie danych i komunikatów
• testowanie komunikacji WiFi i Bluetooth
• praca w warunkach laboratoryjnych i warsztatowych
• wykorzystanie przez osoby posiadające podstawową wiedzę z zakresu elektroniki

• produkt jest modułem elektronicznym przeznaczonym do prototypowania i integracji z innymi urządzeniami
• używać wyłącznie zgodnie z przeznaczeniem i parametrami technicznymi
• przed podłączeniem sprawdzić napięcie, polaryzację i rozmieszczenie pinów
• nie podłączać napięcia wyższego niż dopuszczalne do pinów GPIO
• podczas montażu i lutowania odłączyć płytkę od zasilania
• chronić przed zwarciem, wilgocią, kondensacją pary wodnej i ładunkami elektrostatycznymi
• nie używać produktu, jeżeli płytka, złącze USB lub elementy elektroniczne są uszkodzone
• nie dotykać płytki przewodzącymi przedmiotami podczas pracy
• zapewnić wentylację i nie zabudowywać układu w sposób powodujący nadmierne nagrzewanie
• przy sterowaniu urządzeniami sieciowymi, silnikami lub większymi obciążeniami stosować odpowiednie układy separujące i zabezpieczające
• produkt nie jest zabawką; przechowywać poza zasięgiem małych dzieci
• końcowe urządzenie zbudowane z użyciem płytki może wymagać dodatkowych zabezpieczeń, badań i oceny zgodności

• piny GPIO pracują z logiką 3,3 V i nie są odporne na bezpośrednie podanie 5 V
• błędne podłączenie zasilania może trwale uszkodzić płytkę
• GPIO4 i GPIO5 są połączone z wbudowanym wyświetlaczem
• wyświetlacz OLED nie jest ekranem dotykowym
• wyświetlacz jest monochromatyczny i prezentuje białe piksele na czarnym tle
• długotrwałe wyświetlanie nieruchomego obrazu przy maksymalnej jasności może powodować nierównomierne zużycie pikseli OLED
• nie zasilać silników, serw ani większych obciążeń bezpośrednio z pinów mikrokontrolera
• nie używać modułu do bezpośredniego sterowania napięciem sieciowym
• złącze micro-USB może ulec uszkodzeniu przy użyciu nadmiernej siły
• przewód przeznaczony wyłącznie do ładowania może nie umożliwiać programowania płytki
• parametry i układ drobnych elementów mogą różnić się pomiędzy partiami produkcyjnymi bez wpływu na podstawową funkcjonalność

specyfikacja

• rodzaj produktu: płytka deweloperska z wyświetlaczem
• mikrokontroler: ESP32
• architektura: 32-bit
• procesor: dwurdzeniowy, do 240 MHz
• pamięć Flash: 4 MB
• pamięć SRAM układu: około 520 kB
• WiFi: 2,4 GHz, IEEE 802.11 b/g/n
• Bluetooth: Bluetooth Classic oraz BLE
• wyświetlacz: OLED monochromatyczny
• kolor pikseli: biały
• przekątna wyświetlacza: 0,96"
• rozdzielczość: 128×64 piksele
• interfejs wyświetlacza: I2C
• adres I2C wyświetlacza: 0x3C
• SDA wyświetlacza: GPIO5
• SCL wyświetlacza: GPIO4
• kontroler wyświetlacza: zgodny z bibliotekami SSD1306
• złącze USB: micro-USB
• konwerter USB–UART: CP2102
• napięcie logiki GPIO: 3,3 V
• wyjścia DAC: 2, GPIO25 i GPIO26
• interfejsy mikrokontrolera: GPIO, ADC, DAC, PWM, UART, SPI, I2C, I2S
• wymiary płytki: około 64 × 27,5 mm
• złącza goldpin: dołączone
• przewód USB w zestawie: nie

Płytkę można zasilać napięciem 5 V przez złącze micro-USB. Układ ESP32 i jego linie GPIO pracują z logiką 3,3 V.

Jeżeli wykorzystywany jest pin VIN, należy przed podłączeniem zasilania sprawdzić oznaczenia konkretnej wersji płytki. Dla zgodnego wariantu spotykane jest wejście VIN w zakresie 5–12 V, jednak parametr ten powinien zostać potwierdzony dla sprzedawanej partii.

Nie należy podawać napięcia 5 V bezpośrednio na piny GPIO. Sygnały o wyższym poziomie wymagają zastosowania dzielnika napięcia, konwertera poziomów logicznych lub odpowiedniego układu pośredniczącego.

Wbudowany wyświetlacz OLED

Wyświetlacz jest fabrycznie połączony z mikrokontrolerem i nie wymaga wykonywania dodatkowych połączeń.

W programie Arduino magistralę I2C należy uruchomić w następujący sposób:

Wire.begin(5, 4); // SDA, SCL

Podłączanie dodatkowych modułów

• masę dodatkowego modułu połącz z pinem GND płytki
• urządzenia z logiką 3,3 V można podłączać bezpośrednio do odpowiednich GPIO
• dla urządzeń z logiką 5 V zastosuj konwerter poziomów logicznych
• nie wykorzystuj GPIO4 i GPIO5 do innych funkcji, jeżeli używasz wbudowanego OLED-a
• przed podłączeniem modułu sprawdź jego pobór prądu i napięcie zasilania
• silniki, serwa, przekaźniki i większe obciążenia zasilaj z osobnego, odpowiednio dobranego źródła

Uruchomienie w Arduino IDE

1. Podłącz płytkę do komputera przewodem micro-USB obsługującym transmisję danych.
2. Zainstaluj w Arduino IDE pakiet płytek ESP32 by Espressif Systems.
3. Wybierz płytkę ESP32 Dev Module lub profil zgodny z zastosowanym modułem.
4. Wybierz właściwy port szeregowy.
5. Zainstaluj biblioteki: - Adafruit GFX Library - Adafruit SSD1306
6. Wgraj poniższy program testowy.
7. Po uruchomieniu na ekranie powinien pojawić się napis testowy.

Program testowy OLED

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

constexpr int OLED_WIDTH = 128;
constexpr int OLED_HEIGHT = 64;
constexpr int OLED_SDA = 5;
constexpr int OLED_SCL = 4;
constexpr int OLED_RESET = -1;
constexpr uint8_t OLED_ADDRESS = 0x3C;

Adafruit_SSD1306 display(OLED_WIDTH, OLED_HEIGHT, &Wire, OLED_RESET);

void setup() {
  Serial.begin(115200);

  Wire.begin(OLED_SDA, OLED_SCL);

  if (!display.begin(SSD1306_SWITCHCAPVCC, OLED_ADDRESS)) {
    Serial.println("Nie wykryto wyswietlacza OLED.");
    while (true) {
      delay(1000);
    }
  }

  display.clearDisplay();
  display.setTextColor(SSD1306_WHITE);
  display.setTextSize(1);
  display.setCursor(0, 0);
  display.println("IMZ ESP32 OLED");
  display.println();
  display.println("128x64 I2C");
  display.println("Adres: 0x3C");
  display.println("SDA: GPIO5");
  display.println("SCL: GPIO4");
  display.display();
}

void loop() {
}

Test magistrali I2C

Jeżeli wyświetlacz nie reaguje, można użyć skanera I2C:

#include <Wire.h>

constexpr int OLED_SDA = 5;
constexpr int OLED_SCL = 4;

void setup() {
  Serial.begin(115200);
  Wire.begin(OLED_SDA, OLED_SCL);
  delay(1000);

  Serial.println("Skanowanie magistrali I2C...");

  for (uint8_t address = 1; address < 127; address++) {
    Wire.beginTransmission(address);
    uint8_t error = Wire.endTransmission();

    if (error == 0) {
      Serial.print("Znaleziono urzadzenie: 0x");
      if (address < 16) {
        Serial.print('0');
      }
      Serial.println(address, HEX);
    }
  }
}

void loop() {
}

Prawidłowo działający wyświetlacz powinien zostać wykryty pod adresem 0x3C.

Typowe problemy

• Brak portu szeregowego: sprawdź przewód USB i zainstaluj sterownik CP210x.
• Program nie wgrywa się: przytrzymaj przycisk BOOT podczas rozpoczęcia wgrywania, jeżeli wymaga tego dana wersja płytki.
• OLED pozostaje czarny: sprawdź adres 0x3C, rozdzielczość 128×64 oraz kolejność Wire.begin(5, 4).
• Obraz jest przesunięty lub zniekształcony: upewnij się, że wybrano właściwą bibliotekę i konfigurację kontrolera wyświetlacza.
• Wyświetlacz przestaje działać po podłączeniu czujnika: sprawdź, czy czujnik nie wykorzystuje GPIO4, GPIO5 lub tego samego adresu I2C.
• Płytka resetuje się przy sterowaniu obciążeniem: zastosuj osobne zasilanie dla silnika, serwa, przekaźnika lub taśmy LED i połącz masy układów.

• Arduino IDE
• PlatformIO
• ESP-IDF
• MicroPython
• biblioteka Adafruit SSD1306
• biblioteka Adafruit GFX
• biblioteki zgodne z OLED 128×64 I2C i adresem 0x3C
• systemy Windows, Linux i macOS
• czujniki i moduły z interfejsem I2C, SPI, UART lub sygnałami cyfrowymi
• urządzenia z logiką 3,3 V
• systemy komunikujące się przez WiFi, Bluetooth, HTTP, WebSocket lub MQTT

Ważne informacje o kompatybilności

• ekran zajmuje piny GPIO4 i GPIO5
• dodatkowe urządzenie I2C może pracować na tej samej magistrali, jeżeli ma inny adres
• urządzenia z logiką 5 V mogą wymagać konwertera poziomów logicznych
• nie każdy pin ESP32 może pełnić każdą funkcję
• część pinów ma znaczenie podczas uruchamiania mikrokontrolera
• podczas korzystania z WiFi część kanałów ADC może mieć ograniczenia charakterystyczne dla ESP32
• profil płytki w środowisku programistycznym może wymagać dopasowania do konkretnej partii

• 1 × płytka deweloperska ESP32 z wbudowanym białym wyświetlaczem OLED 0,96"
• listwy goldpin: 2
• przewód micro-USB: brak

• mikrokontroler ESP32
• łączność WiFi 2,4 GHz
• Bluetooth Classic oraz Bluetooth Low Energy
• wbudowany biały wyświetlacz OLED 0,96"
• rozdzielczość OLED 128×64 piksele
• komunikacja z OLED-em przez I2C
• adres wyświetlacza I2C 0x3C
• pin OLED SDA: GPIO5
• pin OLED SCL: GPIO4
• programowanie i zasilanie przez micro-USB
• konwerter USB–UART ułatwiający programowanie
• wyprowadzone piny GPIO
• logika sygnałów 3,3 V
• możliwość programowania w Arduino IDE, PlatformIO, ESP-IDF i MicroPython
• możliwość wyświetlania tekstu, ikon, grafik i prostych wykresów

• ESP32 i komunikacja bezprzewodowa
  Układ umożliwia tworzenie urządzeń komunikujących się z siecią lokalną, serwerem internetowym, aplikacją mobilną lub innymi urządzeniami Bluetooth.

• OLED wbudowany na płytce
  Ekran nie wymaga dodatkowych przewodów ani osobnego modułu. Pozwala od razu prezentować dane pomiarowe, stan połączenia, adres IP, komunikaty diagnostyczne lub elementy menu.

• Białe piksele na czarnym tle
  Monochromatyczny panel zapewnia wysoki kontrast i czytelny obraz. Nie jest to ekran kolorowy ani ekran dotykowy.

• Interfejs I2C
  Do obsługi wyświetlacza wykorzystywane są dwie linie sygnałowe. W kodzie należy jawnie ustawić GPIO5 jako SDA i GPIO4 jako SCL.

• Adres 0x3C
  Typowy adres pozwala korzystać z popularnych bibliotek przeznaczonych do wyświetlaczy OLED 128×64.

• Programowanie przez USB
  Złącze micro-USB może służyć do wgrywania programu, komunikacji szeregowej oraz zasilania płytki podczas prototypowania.

• Obsługa wielu środowisk
  Płytka może być używana zarówno z prostymi projektami Arduino, jak i z bardziej rozbudowanymi aplikacjami opartymi na ESP-IDF, FreeRTOS lub MicroPython.

• Piny współdzielone z ekranem
  GPIO4 i GPIO5 nie powinny być używane do sterowania innymi urządzeniami, jeżeli w projekcie ma działać wbudowany OLED.

zastosowanie

• urządzenia Internetu Rzeczy
• sterowniki automatyki domowej
• bezprzewodowe stacje pomiarowe
• termometry, higrometry i mierniki środowiskowe
• rejestratory danych
• zegary i timery
• wyświetlacze parametrów sieciowych
• monitory stanu urządzeń
• panele sterowania
• liczniki impulsów i czasu pracy
• sterowniki oświetlenia
• systemy powiadomień
• prototypy współpracujące z Home Assistant, MQTT lub własnym serwerem
• nauka programowania mikrokontrolerów ESP32
• projekty szkolne, studenckie i hobbystyczne

Czy wyświetlacz jest już podłączony do ESP32?
Tak. OLED jest wbudowany na płytce i połączony z mikrokontrolerem. Nie trzeba wykonywać dodatkowego okablowania.

Jakie piny obsługują wyświetlacz?
Linia SDA jest podłączona do GPIO5, a linia SCL do GPIO4.

Jaki jest adres I2C wyświetlacza?
Wyświetlacz odpowiada pod adresem 0x3C.

Czy ekran jest kolorowy?
Nie. Jest to ekran monochromatyczny wyświetlający białe piksele na czarnym tle.

Czy ekran jest dotykowy?
Nie. OLED służy wyłącznie do wyświetlania informacji.

Czy można korzystać z GPIO4 i GPIO5 do innych zadań?
Technicznie piny są współdzielone, ale ich użycie przez inne urządzenie może zakłócić pracę OLED-a. Najbezpieczniej pozostawić je wyłącznie dla wyświetlacza.

Czy do magistrali OLED można podłączyć kolejny czujnik I2C?
Tak, jeżeli czujnik pracuje z logiką 3,3 V i ma adres inny niż 0x3C.

Czy płytkę można programować w Arduino IDE?
Tak. Najczęściej wystarczy wybrać profil ESP32 Dev Module i właściwy port szeregowy.

Czy potrzebny jest osobny programator?
Nie. Płytka ma konwerter USB–UART i może być programowana przez micro-USB.

Dlaczego komputer nie wykrywa płytki?
Najczęstsze przyczyny to przewód USB bez linii danych, brak sterownika CP210x, uszkodzone złącze albo niewłaściwy port.

Czy można zasilać płytkę napięciem 5 V?
Tak, przez złącze micro-USB. Napięcia 5 V nie wolno jednak podawać bezpośrednio na GPIO.

Czy można wyświetlać własne grafiki?
Tak. Biblioteki OLED umożliwiają wyświetlanie tekstu, ikon i monochromatycznych bitmap 128×64.

Czy płytka współpracuje z MicroPythonem?
Tak. Należy zainstalować odpowiedni firmware ESP32 i skonfigurować I2C z SDA na GPIO5 oraz SCL na GPIO4.

Czy moduł nadaje się dla początkujących?
Tak, szczególnie do nauki ESP32 i tworzenia projektów z lokalnym wyświetlaczem. Wymagana jest jednak podstawowa znajomość napięć i poprawnego podłączania elektroniki.

• bezpośrednie sterowanie urządzeniami zasilanymi napięciem sieciowym
• zastosowania medyczne i podtrzymujące życie
• systemy bezpieczeństwa, od których zależy zdrowie lub życie
• sterowanie pojazdami bez dodatkowych zabezpieczeń i certyfikowanych układów
• zastosowania lotnicze, wojskowe i przemysłowe wymagające certyfikowanych komponentów
• praca na zewnątrz bez odpowiedniej obudowy
• praca w środowisku mokrym, zapylonym, wybuchowym lub agresywnym chemicznie
• podłączanie sygnałów 5 V bez odpowiedniego dopasowania poziomów logicznych
• zasilanie obciążeń przekraczających możliwości stabilizatora i złącza USB
• użycie jako gotowe urządzenie końcowe bez przeprowadzenia wymaganej oceny ryzyka i zgodności