ZLX-ESP32-2

ESP32-C5 2.8-inch Touch Display Development Board

Čínská a anglická uživatelská příručka / Bilingual User Manual

Model / model: ZLX-ESP32-2
Module / modul: ESP32-C5-WROOM-1U-N8R8
Document Version / Verze dokumentu: V1.1 | 2026-08-25

1. Přehled produktů / 1. Product Overview

ZLX-ESP32-2 je produkt založený na ESP32-C5-WROOM-1U-N8R8 Modulární 2.8 palcová odporová vývojová deska s dotykovou obrazovkou s integrovanou barvou LCD、XPT2046 dotek,microSD/TF Slot pro kartu (pouze slot pro kartu, není součástí dodávky microSD/TF Karta),GPS Rozhraní, audio výstup, detekce napětí baterie, zelená LED、BOOT/RESET Tlačítko a rozhraní externí antény. Vhodný Wi-Fi 6、Bluetooth LE、Zigbee/Thread, rozhraní člověk-stroj, záznam dat a vývoj aplikací Internet of Things.
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.

Hlavní rysy / Key Features

• ESP32-C5 32 Bit RISC-V Jednojádrový procesor, až 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(Palubní zdroje modulu, ne microSD/TF Karta) / ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (onboard module memory, not a microSD/TF card)

• 2.4 GHz + 5 GHz Duální pásmo 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 palec 240×320 LCD，ST7789 řídit,BGR Inicializace, deaktivace inverzní barvy / 2.8-inch 240×320 LCD, ST7789 driver, BGR initialization, display inversion disabled

• XPT2046 Dotykový odporový ovladač / XPT2046 resistive touch controller

• LCD a TF Sdílení karet SPI autobus, nezávislý CS;Dotkněte se pro použití samostatného softwaru SPI / LCD and TF card share SPI with separate CS; touch uses an independent software SPI

• Velikost desky cca. 86 mm × 50 mm / Board size approx. 86 mm × 50 mm

• IPEX1 Rozhraní externí antény; před použitím bezdrátové funkce musí být správně připojena externí anténa / IPEX1 external antenna connector; connect a suitable external antenna before radio use

Použitelné objekty / Intended Users

Vhodné pro embedded vývojáře, IoT vývojáře, výrobce, výukové experimenty a návrh prototypů produktů.
For embedded developers, IoT developers, makers, education/lab use, and product prototyping.

2. Vzhled a velikost / 2. Appearance and Dimensions

Celkové rozměry desky jsou přibližně 86 mm × 50 mm. Následující přední a zadní obrázky slouží k identifikaci obrazovky, rozhraní a hlavních součástí.
The board outline is approximately 86 mm × 50 mm. The images below help identify the display, connectors, and major components.

obrázek 1 Rozměry přední části a obrazovky / Figure 1 Board front and display-side dimensions

Anotace rozhraní / Connector Identification

obrázek 2 ZLX-ESP32-2 Čínské a anglické anotace rozhraní / Figure 2 Bilingual connector identification

3. Specifikace vývojové desky / 3. Board Specifications

ilustrovat / Note: Nativní rozlišení obrazovky je 240×320;Když je software nastaven na horizontální otáčení obrazovky, logická velikost zobrazení může být vyjádřena 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 modulu / 4. ESP32-C5-WROOM-1U-N8R8 Module Specifications

Následující klíčové parametry jsou založeny na Espressif oficiální 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. Displej a dotyk / 5. Display and Touch

LCD parametr / LCD Parameters

Dotykové parametry / Touch Parameters

• Typ dotyku:4 Wire Resistive Touch; Ovladač: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.

• Dotkněte se pro použití samostatného softwaru SPI;Proces detekčního nástroje je označen jako nevyžadující kalibraci. / Touch uses an independent software SPI; the supplied test flow is marked as requiring no calibration.

6. GPIO mapování / 6. GPIO Mapping

Následující mapování pochází ze zákaznické verze dodávané s deskou GPIO Tabulka a porovnáno se schématem. Palubní použití periferií 19 Obyčejný GPIO；TX0=GPIO11、RX0=GPIO12 Používá se také pro UART0；N8R8 z GPIO15 deka PSRAM obsazeno tedy 21 k dispozici GPIO Všichni přidělení;EN Nepočítá se jako práce 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.

Systémové signály a signály sériového portu / System and UART Signals

7. Pokyny pro sdílení rozhraní a sběrnice / 7. Interface and Bus Sharing

SPI Úvahy o sdílení / SPI Sharing Notes

• LCD a TF Sdílení karet GPIO6(SCK)、GPIO7(MOSI)、GPIO2(MISO), ale pomocí resp GPIO10(LCD_CS) a 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.

• Současně povolte pouze cílové zařízení CS, aby se zabránilo konfliktům sběrnic způsobeným tím, že je vybráno více zařízení současně. / Assert only the target device CS at a time to avoid bus contention.

• dotek XPT2046 Používejte samostatný software SPI, ne s LCD/TF Pán SPI hodiny a MOSI sdílené. / The XPT2046 touch controller uses an independent software SPI and does not share the main LCD/TF SCK/MOSI signals.

8. Korespondence detekční funkce / 8. Functional Test Mapping

9. Rozhraní a elektrické úvahy / 9. Connector and Electrical Notes

Rozhraní baterie / Battery Connector

Vývojová deska zajištěna 1.25 mm 2-Pin 3.7 V Rozhraní s jednou baterií. Podle směru pohledu na vyznačeném diagramu je levá strana kladná elektroda (+), pravá strana je záporný pól (-). Pokud je vyžadováno napájení z baterie, doporučuje se použít kapacitu 1000–3000 mAh, jednodílná s ochrannou deskou (ochranný obvod) 3.7 V Lithium iont/Lithium-polymerová baterie a před připojením ověřte specifikace rozhraní a kladné a záporné póly. Opačné zapojení může poškodit vývojovou desku.
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 přihrávka 100 kΩ / 100 kΩ Síť děliče napětí detekuje napětí baterie, takže za ideálních okolností je skutečné napětí baterie přibližně ADC napětí na pinu 2 časy. Tato funkce slouží pouze pro odhad napětí, nikoli pro coulombmetr paliva.
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 rozhraní / GPS Interface

GPS použití GPIO0 a GPIO9 jako UART Signál.GPIO0（GPSTX Named) jako vstup v této definici desky, připojte GPS modul TX；GPIO9（GPSRX pojmenovaný) jako výstup, připojit GPS modul RX。1.25 mm 4-Pin Napájecí kolíky a aktuální pořadí kolíků konektoru naleznete v příslušné verzi hardwaru./Převažuje schématický diagram.
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.

externí anténa / External Antenna

ESP32-C5-WROOM-1U Jedná se o verzi s externí anténou. rada IPEX1 Rozhraní je třeba propojit 2.4/5 GHz Přizpůsobení frekvenčního pásma a impedance jsou 50 Ω anténa. Bez připojené vhodné antény nevysílejte delší dobu vysokým výkonem.
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.

audio rozhraní / Audio Connector

Zvukový výstup zajišťuje GPIO8（AUDIOPWM)produkce PWM Signál,GPIO24（AMP_EN) ovládá aktivaci výkonového zesilovače; horní část desky je 2.0 mm 2-Pin Zvuk/Rozhraní reproduktoru. Informace o různých nastaveních zátěže a hlasitosti naleznete ve skutečných možnostech obvodu výkonového zesilovače.
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. Poradenství při vývoji a inicializaci softwaru / 10. Software Development and Initialization Notes

• Výběr ovladače displeje ST7789, nativní rozlišení je nastaveno na 240×320;Horizontální obrazovku lze otočit 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.

• Použité pořadí barev BGR;Nepovolujte zobrazení inverzních barev (INVON）。 / Use BGR color order; do not enable display inversion (INVON).

• LCD/TF podíl SPI když, spravováno samostatně po inicializaci LCD_CS(GPIO10) a SD_CS(GPIO27)。 / When LCD and TF share SPI, manage LCD_CS (GPIO10) and SD_CS (GPIO27) independently after initialization.

• XPT2046 použití GPIO3/4/5/23/25 nezávislý software SPI。 / XPT2046 uses an independent software SPI on GPIO3/4/5/23/25.

• Při odečítání napětí baterie je GPIO1 z ADC Výsledky o cca. 2:1 Převod parciálního tlaku v kombinaci s ADC Kalibrace zlepšuje přesnost. / 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 Dostupné kanály a vysílací výkon se liší v závislosti na zemi/Regionální regulační omezení. / Available 5 GHz Wi-Fi channels and transmit power depend on local regulations.

• BOOT/Logika obnovení továrního nastavení je určena firmwarem; zabraňte špatnému sepnutí během provozu a způsobení vymazání konfigurace. / BOOT/factory-restore behavior is firmware-defined; avoid unintended activation that may clear settings.

Doporučená inicializační sekvence / Suggested Initialization Sequence

1. Inicializujte systém a sériový port po stabilním napájení.
After power is stable, initialize the system and debug UART.

2. inicializace LCD SPI,nastavit ST7789、BGR, vypněte inverzní barvu a poté zapněte podsvícení.
Initialize LCD SPI; configure ST7789, BGR, inversion off, then enable backlight.

3. inicializace XPT2046 dotek.
Initialize XPT2046 touch.

4. Pokud potřebujete použít funkci úložiště, vložte prosím uživatelsky připravený kompatibilní microSD/TF kartu, znovu inicializovat a zajistit LCD_CS a SD_CS Stav je správný.
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. Inicializovat na vyžádání GPS,audio,LED,Baterie ADC。
Initialize GPS, audio, LED, and battery ADC as needed.

6. Naposledy povoleno Wi-Fi/BLE/802.15.4 Bezdrátové možnosti.
Enable Wi-Fi/BLE/802.15.4 radio functions as required.

11. Odstraňování běžných problémů / 11. Troubleshooting

12. Stahování dat a technická podpora / 12. Downloads and Technical Support

ZLX-ESP32-2 Udělte prosím přednostní přístup k firmwaru, souborům, následným informacím a související podpoře. ZLX ESP32 Centrum podpory pro vývojáře vývojových rad. Před flashováním firmwaru potvrďte, co je uvedeno na stránce. PCB Model je úplně stejný jako deska v ruce.
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.

Stahování dat / Downloads: https://www.zlxchina.xyz/

Espressif module datasheet / Specifikace modulu Espressif: ESP32-C5-WROOM-1 / WROOM-1U Datasheet

Reference / References

• ZLX ESP32 Centrum podpory pro vývojáře vývojových rad / 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. Použití a bezpečnostní opatření / 13. Safety and Handling

• Kladný a záporný pól musí být potvrzen před připojením baterie a opačné připojení je zakázáno. / Verify battery polarity before connection; never reverse the battery connector.

• Zapojte a odpojte IPEX Při připojování antény držte svislou sílu, abyste zabránili bočnímu páčení, které by mohlo způsobit pád RF základny. / When mating/unmating the IPEX connector, apply force vertically and avoid sideways prying that may damage the RF socket.

• Při použití holé desky vývojové desky věnujte pozornost elektrostatické ochraně, aby nedošlo ke zkratu způsobenému kovovými předměty. / Use ESD precautions with the bare board and prevent metal objects from causing shorts.

• 5 GHz Bezdrátové frekvenční pásmo, kanál a napájení musí odpovídat předpisům v oblasti použití. / 5 GHz radio band, channels, and transmit power must comply with local regulations.

• TF Karta,GPSPro možnosti napájení a úrovně periferií, jako je audio a video, se řiďte aktuální verzí hardwaru. Bez potvrzení nás nekontaktujte. IO špendlík aplikovaný výše 3.3 V úroveň. / 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. Záznam verze dokumentu / 14. Document Revision History

— End / Dokončit -