1. Opis produktu / 1. Product Overview

ZLX-ESP32-2 to model oparty na ESP32-C5-WROOM-1U-N8R8 Moduł 2.8 Rezystancyjna płytka programistyczna z ekranem dotykowym, zintegrowany kolor LCD、XPT2046 Dotyk.microSD/TF Gniazdo karty (tylko gniazdo karty, brak w zestawie) microSD/TF "Cięcie!"GPS Interfejs, wyjście audio, wykrywanie napięcia akumulatora, zielony LED、BOOT/RESET Przycisk i zewnętrzny interfejs anteny. Nadaje się do Wi-Fi 6、Bluetooth LE、Zigbee/Thread, HMI, rejestracja danych i rozwój aplikacji IoT.
ZLX-ESP32-2 is a 2.8-inch resistive-touch development board based on the ESP32-C5-WROOM-1U-N8R8 module. It integrates a color LCD, XPT2046 touch controller, a microSD/TF card slot (slot only; no microSD/TF card is included), GPS interface, audio output, battery-voltage sensing, green LED, BOOT/RESET buttons, and an external-antenna connector. It is suitable for Wi-Fi 6, Bluetooth LE, Zigbee/Thread, HMI, data logging, and IoT development.

Najważniejsze funkcje / Key Features

• ESP32-C5 32 bity RISC-V Procesor jednordzeniowy, do 240 MHz / ESP32-C5 32-bit RISC-V single-core CPU, up to 240 MHz

• ESP32-C5-WROOM-1U-N8R8：8 MB Flash + 8 MB PSRAM(Zasób pokładowy modułu, nie microSD/TF "Cięcie!" / ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (onboard module memory, not a microSD/TF card)

• 2.4 GHz + 5 GHz Dwuzakresowy Wi-Fi 6（802.11ax） / 2.4 GHz + 5 GHz dual-band Wi-Fi 6 (802.11ax)

• Bluetooth LE、IEEE 802.15.4、Zigbee 3.0、Thread 1.4 / Bluetooth LE, IEEE 802.15.4, Zigbee 3.0, Thread 1.4

• 2.8 Cale 240×320 LCD，ST7789 SterownikBGR Inicjalizuj, nie włączaj koloru odwrotnego / 2.8-inch 240×320 LCD, ST7789 driver, BGR initialization, display inversion disabled

• XPT2046 Rezystancyjny sterownik dotykowy / XPT2046 resistive touch controller

• LCD i TF Udostępnianie kart SPI Autobus, niezależny CS; Dotknij za pomocą samodzielnego oprogramowania SPI / LCD and TF card share SPI with separate CS; touch uses an independent software SPI

• Rozmiar deski ok. 86 mm × 50 mm / Board size approx. 86 mm × 50 mm

• IPEX1 Interfejs anteny zewnętrznej; podłącz antenę zewnętrzną prawidłowo przed użyciem funkcji bezprzewodowej / IPEX1 external antenna connector; connect a suitable external antenna before radio use

Odpowiednie obiekty / Intended Users

Nadaje się dla programistów osadzonych, programistów IoT, twórców, eksperymentów dydaktycznych i prototypowania produktów.
For embedded developers, IoT developers, makers, education/lab use, and product prototyping.

2. Wygląd i wymiary / 2. Appearance and Dimensions

Zewnętrzne wymiary karty planszowej to ok. 86 mm × 50 mm. Poniższe zdjęcia z przodu i z tyłu służą do identyfikacji ekranu, interfejsu i urządzenia głównego.
The board outline is approximately 86 mm × 50 mm. The images below help identify the display, connectors, and major components.

Graf 1 Schemat rozmiaru przodu i ekranu / Figure 1 Board front and display-side dimensions

Objaśnienie interfejsu / Connector Identification

Graf 2 ZLX-ESP32-2 Objaśnienie interfejsu chińsko-angielskiego / Figure 2 Bilingual connector identification

3. Specyfikacja płyty deweloperskiej / 3. Board Specifications

Komentarz / Note: Natywna rozdzielczość ekranu wynosi 240×320; Gdy oprogramowanie jest ustawione na obrót w poziomie, rozmiar wyświetlacza logicznego można przedstawić jako 320×240。 / The panel native resolution is 240×320; in landscape rotation, the logical display size may be 320×240.

4. ESP32-C5-WROOM-1U-N8R8 Parametry modułu / 4. ESP32-C5-WROOM-1U-N8R8 Module Specifications

Poniższe kluczowe parametry są oparte na Espressif Dz. ESP32-C5-WROOM-1 / WROOM-1U Datasheet v1.2。
The following key parameters are based on Espressif's official ESP32-C5-WROOM-1 / WROOM-1U Datasheet v1.2.

5. Wyświetlacz i dotyk / 5. Display and Touch

LCD Parametry / LCD Parameters

Parametry dotykowe / Touch Parameters

• Typ dotyku:4 Line Resistive Touch; Sterownik:XPT2046。 / Touch type: 4-wire resistive; controller: XPT2046.

• DOUT=GPIO3，SCK=GPIO4，DIN=GPIO5。 / DOUT=GPIO3, SCK=GPIO4, DIN=GPIO5.

• CS=GPIO23，IRQ=GPIO25。 / CS=GPIO23, IRQ=GPIO25.

• Dotknij za pomocą samodzielnego oprogramowania SPI; Przepływ narzędzia testowego jest oznaczony jako wolny od kalibracji. / Touch uses an independent software SPI; the supplied test flow is marked as requiring no calibration.

6. GPIO Mapa / 6. GPIO Mapping

Poniższe odwzorowania pochodzą z wersji klienta dostarczonej z tablicą GPIO arkusz kalkulacyjny i sprawdzone schematycznie. Korzystanie z pokładowych urządzeń peryferyjnych 19 normalny GPIO；TX0=GPIO11、RX0=GPIO12 Również dla UART0；N8R8 . GPIO15 - Jak? Przez... PSRAM Zajęty, dlatego 21 dostępne GPIO Przydzielono;EN Nie zliczono GPIO。
The mapping below is based on the supplied GPIO spreadsheet and cross-checked against the schematic. Board peripherals use 19 GPIOs; TX0=GPIO11 and RX0=GPIO12 are additionally used by UART0; GPIO15 is reserved by PSRAM on N8R8, so all 21 usable GPIOs are allocated; EN is not a GPIO.

Sygnały systemu i portu szeregowego / System and UART Signals

7. Wspólny opis interfejsu i magistrali / 7. Interface and Bus Sharing

SPI Wspólne przemyślenia / SPI Sharing Notes

• LCD i TF Udostępnianie kart GPIO6(SCK)、GPIO7(MOSI)、GPIO2(MISO), ale używaj osobno GPIO10(LCD_CS) i GPIO27(SD_CS)。 / LCD and TF card share GPIO6 (SCK), GPIO7 (MOSI), and GPIO2 (MISO), but use GPIO10 (LCD_CS) and GPIO27 (SD_CS) respectively.

• Tylko urządzenia docelowe CSaby uniknąć jednoczesnego wyboru wielu urządzeń powodujących kolizje autobusów. / Assert only the target device CS at a time to avoid bus contention.

• Dotyk. XPT2046 Używaj samodzielnego oprogramowania SPI, a nie z LCD/TF Lord SPI Zegar i MOSI Udostępnione. / The XPT2046 touch controller uses an independent software SPI and does not share the main LCD/TF SCK/MOSI signals.

8. Odpowiednia funkcja wykrywania / 8. Functional Test Mapping

9. Środki ostrożności dotyczące interfejsu i instalacji elektrycznej / 9. Connector and Electrical Notes

Złącze akumulatora / Battery Connector

Dostarczone przez Radę Rozwoju 1.25 mm 2-Pin 3.7 V Interfejs z pojedynczym akumulatorem. Zgodnie z kierunkiem obserwacji diagramu opatrzonego adnotacją, lewa strona jest biegunem dodatnim (ang.+), biegun ujemny z prawej strony (-). Jeśli wymagane jest zasilanie bateryjne, zalecana jest pojemność 1000–3000 mAhPojedyncza sekcja z płytą ochronną (obwód ochronny) 3.7 V Litowo-jonowy/Akumulator litowo-polimerowy i potwierdź specyfikacje interfejsu oraz elektrody dodatnie i ujemne przed podłączeniem. Odwrotne połączenie może uszkodzić płytę deweloperską.
The board provides a 1.25 mm 2-pin connector for a single-cell 3.7 V battery. In the orientation shown in the labeled image, the left pin is positive (+) and the right pin is negative (-). For battery-powered operation, use a protected single-cell 3.7 V Li-ion/LiPo battery; 1000–3000 mAh is recommended. Verify connector type and polarity before connection. Reverse polarity may damage the board.

GPIO1 /AUTORYZUJĘ. 100 kΩ / 100 kΩ Sieć napięcia częściowego wykrywa napięcie akumulatora, więc najlepiej byłoby, gdyby rzeczywiste napięcie akumulatora wynosiło ok. ADC Napięcie pinu 2 . Ta funkcja służy tylko do szacowania napięcia i nie jest kulombometrem mocy.
GPIO1 senses battery voltage through a 100 kΩ / 100 kΩ divider, so ideally the battery voltage is approximately 2× the ADC pin voltage. This is a voltage estimate only and is not a fuel-gauge/coulomb-counter measurement.

GPS Złącza / GPS Interface

GPS Użyj GPIO0 i GPIO9 Bądż moim przewodnikiem. A w zamian dostaniesz... UART SygnałGPIO0（GPSTX nazwany) jako wejście w tej definicji płyty, łącząc GPS Moduł TX；GPIO9（GPSRX nazwany) jako wyjście, podłączenie GPS Moduł RX。1.25 mm 4-Pin Sworzeń zasilania złącza i rzeczywista sekwencja sworznia powinny być wydrukowane na ekranie z odpowiednią wersją sprzętu./Schemat ideowy ma pierwszeństwo.
GPS uses GPIO0 and GPIO9 as UART signals. In this board mapping, GPIO0 (named GPSTX) is an input connected to the GPS module TX, while GPIO9 (named GPSRX) is an output connected to the GPS module RX. For the 1.25 mm 4-pin connector power pins and exact physical pin order, follow the silkscreen/schematic of the specific hardware revision.

Antena zewnętrzna / External Antenna

ESP32-C5-WROOM-1U to wersja z anteną zewnętrzną. IPEX1 Interfejs musi być połączony z 2.4/5 GHz Dopasowanie pasma częstotliwości, impedancja wynosi 50 Ω antena. Nie przesyłaj dużej mocy przez długi czas bez podłączonej odpowiedniej anteny.
ESP32-C5-WROOM-1U is the external-antenna variant. Connect a suitable 2.4/5 GHz, 50-ohm antenna to the IPEX1 connector. Avoid prolonged high-power transmission without a proper antenna attached.

Interfejs audio / Audio Connector

Wyjście audio GPIO8（AUDIOPWM) Generation PWM SygnałGPIO24（AMP_EN) wzmacniacz sterujący włączony; górna część płyty jest 2.0 mm 2-Pin Audio/Interfejs głośnika. Różne ustawienia obciążenia i głośności zależą od rzeczywistej pojemności obwodu wzmacniacza mocy.
Audio output uses GPIO8 (AUDIOPWM) for the PWM signal and GPIO24 (AMP_EN) for amplifier enable. The top connector is a 2.0 mm 2-pin audio/speaker connector. Use loads and volume settings within the capability of the actual amplifier circuit.

10. Porady dotyczące rozwoju i inicjalizacji oprogramowania / 10. Software Development and Initialization Notes

• Pokaż wybór sterownika ST7789, rozdzielczość natywna ustawiona na 240×320; krajobraz można obrócić do 320×240。 / Select ST7789 as the display driver and use 240×320 as the native resolution; set rotation for 320×240 landscape as supported by your graphics library.

• Sekwencyjne użycie koloru BGR; Nie włączaj kolorowego wyświetlacza wstecznego (INVON）。 / Use BGR color order; do not enable display inversion (INVON).

• LCD/TF Udostępnione SPI , zarządzaj osobno po inicjalizacji LCD_CS(GPIO10) i SD_CS(GPIO27)。 / When LCD and TF share SPI, manage LCD_CS (GPIO10) and SD_CS (GPIO27) independently after initialization.

• XPT2046 Użyj GPIO3/4/5/23/25 Samodzielne oprogramowanie SPI。 / XPT2046 uses an independent software SPI on GPIO3/4/5/23/25.

• Podczas odczytu napięcia akumulatora, GPIO1 . ADC Wynik wg ok. 2:1 Współczynnik ciśnienia cząstkowego jest przekształcany i łączony z ADC Kalibracja poprawia dokładność. / For battery voltage, convert the GPIO1 ADC reading using the approximately 2:1 divider ratio and apply ADC calibration for better accuracy.

• Wi-Fi 5 GHz Dostępne kanały i moc przesyłowa w zależności od kraju/Regionalne ograniczenia regulacyjne. / Available 5 GHz Wi-Fi channels and transmit power depend on local regulations.

• BOOT/Przywracanie logiki fabrycznej jest określane przez oprogramowanie sprzętowe; unikaj błędnego wyzwalania podczas pracy i powodowania skasowania konfiguracji. / BOOT/factory-restore behavior is firmware-defined; avoid unintended activation that may clear settings.

Zalecana kolejność inicjowania / Suggested Initialization Sequence

1. Zainicjalizuj system i port szeregowy po ustabilizowaniu zasilania.
After power is stable, initialize the system and debug UART.

2. Inicjalizacja LCD SPIUstawienia. ST7789、BGR, wyłącz kolor odwrotny i włącz podświetlenie.
Initialize LCD SPI; configure ST7789, BGR, inversion off, then enable backlight.

3. Inicjalizacja XPT2046 Dotyk.
Initialize XPT2046 touch.

4. Aby skorzystać z funkcji przechowywania, najpierw włóż kompatybilność należącą do użytkownika microSD/TF , ponownie zainicjuj i upewnij się, LCD_CS i SD_CS Status jest prawidłowy.
If removable storage is required, insert a compatible user-supplied microSD/TF card, then initialize it and ensure correct LCD_CS/SD_CS states.

5. Inicjuj na żądanie GPSAudioLEDAkumulatory. ADC。
Initialize GPS, audio, LED, and battery ADC as needed.

6. Ostatnio włączone Wi-Fi/BLE/802.15.4 Możliwości łączności bezprzewodowej.
Enable Wi-Fi/BLE/802.15.4 radio functions as required.

11. Częste pytania - rozwiązywanie problemów / 11. Troubleshooting

12. Pobieranie danych i wsparcie techniczne / 12. Downloads and Technical Support

ZLX-ESP32-2 Oprogramowanie układowe, dokumentacja, informacje uzupełniające i wsparcie dla priorytetowego dostępu ZLX ESP32 Centrum wsparcia dla twórców płyt deweloperskich. Potwierdź wymienione na stronie przed mignięciem oprogramowania sprzętowego PCB Model jest dokładnie taki sam jak deska w dłoni.
For ZLX-ESP32-2 firmware, files, future documentation, and related support, use the ZLX ESP32 development-board support center. Before flashing firmware, confirm the PCB model shown on the website exactly matches your hardware.

Pobieranie danych / Downloads: https://www.zlxchina.xyz/

Espressif module datasheet / Specyfikacje modułu Lexin: ESP32-C5-WROOM-1 / WROOM-1U Datasheet

Bibliografia / References

• ZLX ESP32 Centrum wsparcia dla twórców tablic / ZLX ESP32 Development Board Support Center — https://www.zlxchina.xyz/

• Espressif ESP32-C5-WROOM-1 & WROOM-1U Datasheet v1.2 (2026-08-12) / Espressif ESP32-C5-WROOM-1 & WROOM-1U Datasheet v1.2 (2026-08-12) — https://espressif.com/documentation/esp32-c5-wroom-1_wroom-1u_datasheet_en.pdf

13. Środki ostrożności dotyczące użytkowania i bezpieczeństwa / 13. Safety and Handling

• Przed podłączeniem akumulatora należy sprawdzić elektrody dodatnie i ujemne, a odwrotne podłączenie jest zabronione. / Verify battery polarity before connection; never reverse the battery connector.

• Podłącz i odłącz IPEX Utrzymuj złącze anteny pod wpływem siły pionowej, aby uniknąć podważenia bocznego powodującego odpadnięcie podstawy RF. / When mating/unmating the IPEX connector, apply force vertically and avoid sideways prying that may damage the RF socket.

• Podczas korzystania z płyty deweloperskiej należy zwrócić uwagę na ochronę elektrostatyczną, aby uniknąć zwarcia spowodowanego metalowymi przedmiotami. / Use ESD precautions with the bare board and prevent metal objects from causing shorts.

• 5 GHz Bezprzewodowe pasma, kanały i zasilanie muszą być zgodne z lokalnymi przepisami. / 5 GHz radio band, channels, and transmit power must comply with local regulations.

• TF "Cięcie!"GPSPojemność zasilania i poziom urządzeń peryferyjnych, takich jak audio, powinny być zgodne z rzeczywistą wersją sprzętu. Nie wysyłaj IO PIN zastosowany wyżej niż 3.3 V Poziom. / For TF, GPS, audio, and other peripherals, follow the actual hardware revision for supply and logic levels. Do not apply logic levels above 3.3 V to IO pins unless explicitly verified.

14. Historia wersji dokumentu / 14. Document Revision History

— End / zamknięty