1. Produktübersicht / 1. Product Overview

ZLX-ESP32-2 ist ein Modell, das auf ESP32-C5-WROOM-1U-N8R8 Modul 2.8 Zoll-resistives Touchscreen-Entwicklungsboard, integrierte Farbe LCD、XPT2046 Touch,microSD/TF Kartensteckplatz (nur Kartensteckplatz, nicht im Lieferumfang enthalten) microSD/TF KarteGPS Schnittstelle, Audioausgang, Batteriespannungserkennung, Grün LED、BOOT/RESET Taster und externe Antennenschnittstelle. Geeignet für Wi-Fi 6、Bluetooth LE、Zigbee/Thread, HMI, Datenerfassung und IoT-Anwendungsentwicklung.
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.

Merkmal : / Key Features

• ESP32-C5 32 X RISC-V Single-Core-Prozessor, bis zu 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(Modul Onboard-Ressource, nicht microSD/TF Karte / ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (onboard module memory, not a microSD/TF card)

• 2.4 GHz + 5 GHz Dualband 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 ZOLL 240×320 LCD，ST7789 AntreibenBGR Initialisieren, nicht die umgekehrte Farbe einschalten / 2.8-inch 240×320 LCD, ST7789 driver, BGR initialization, display inversion disabled

• XPT2046 Resistiver Touch-Controller / XPT2046 resistive touch controller

• LCD Und TF Kartenfreigabe SPI Bus, unabhängig CS; Berühren mit eigenständiger Software SPI / LCD and TF card share SPI with separate CS; touch uses an independent software SPI

• Plattengröße ca. 86 mm × 50 mm / Board size approx. 86 mm × 50 mm

• IPEX1 Externe Antennenschnittstelle; Schließen Sie die externe Antenne korrekt an, bevor Sie die drahtlose Funktion verwenden / IPEX1 external antenna connector; connect a suitable external antenna before radio use

Anwendbare Objekte / Intended Users

Geeignet für Embedded-Entwickler, IoT-Entwickler, Hersteller, Lehrversuche und Produktprototyping.
For embedded developers, IoT developers, makers, education/lab use, and product prototyping.

2. Aussehen und Abmessungen / 2. Appearance and Dimensions

Die Außenmaße der Brettkarte betragen ca. 86 mm × 50 mm. Die vorderen und hinteren Bilder unten dienen zur Identifizierung des Bildschirms, der Benutzeroberfläche und des Hauptgeräts.
The board outline is approximately 86 mm × 50 mm. The images below help identify the display, connectors, and major components.

A bb. 1 Vorder- und Bildschirmgrößenschema / Figure 1 Board front and display-side dimensions

Schnittstellenanmerkung / Connector Identification

A bb. 2 ZLX-ESP32-2 Chinesisch-Englisch-Schnittstellen-Callout / Figure 2 Bilingual connector identification

3. Spezifikationen der Entwicklungsplatine / 3. Board Specifications

veranschaulichen / Note: Die native Auflösung des Bildschirms ist 240×320; Wenn die Software auf Querformatdrehung eingestellt ist, kann die logische Anzeigegröße als 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 Modulparameter / 4. ESP32-C5-WROOM-1U-N8R8 Module Specifications

Die folgenden Schlüsselparameter basieren auf Espressif „Aktionsstruktur Transnationale Fachkräfte für Thüringen“ 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. Display & Touch / 5. Display and Touch

LCD Parameter / LCD Parameters

Touch-Parameter / Touch Parameters

• Touch-Typ:4 Line Resistive Touch; Controller: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.

• Berühren mit eigenständiger Software SPI; Der Testwerkzeugfluss wird als kalibrierungsfrei gekennzeichnet. / Touch uses an independent software SPI; the supplied test flow is marked as requiring no calibration.

6. GPIO Entsprechung / 6. GPIO Mapping

Die folgenden Mappings stammen aus der mit dem Board gelieferten Kundenversion GPIO Tabellenkalkulation und schaubildlich geprüft. Verwendung von Onboard-Peripheriegeräten 19 normal GPIO；TX0=GPIO11、RX0=GPIO12 Auch für UART0；N8R8 Von GPIO15 wird PSRAM Belegt, daher 21 verfügbar GPIO Zugewiesen;EN Nicht gezählt 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.

System- und Serial-Port-Signale / System and UART Signals

7. Gemeinsame Beschreibung der Schnittstelle und des Busses / 7. Interface and Bus Sharing

SPI Gemeinsame Überlegungen / SPI Sharing Notes

• LCD Und TF Kartenfreigabe GPIO6(SCK)、GPIO7(MOSI)、GPIO2(MISO), aber separat verwenden GPIO10(LCD_CS) Und 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.

• Nur das Zielgerät CSum zu vermeiden, dass mehrere Geräte gleichzeitig ausgewählt werden, was zu Buskollisionen führt. / Assert only the target device CS at a time to avoid bus contention.

• berühren XPT2046 Eigenständige Software verwenden SPI, nicht mit LCD/TF Lord SPI Uhr und MOSI Geteilt. / The XPT2046 touch controller uses an independent software SPI and does not share the main LCD/TF SCK/MOSI signals.

8. Entsprechende Erkennungsfunktion / 8. Functional Test Mapping

9. Schnittstellen- und elektrische Vorsichtsmaßnahmen / 9. Connector and Electrical Notes

Batterieanschluss / Battery Connector

Bereitgestellt vom Development Board 1.25 mm 2-Pin 3.7 V Einzelbatterie-Schnittstelle. Gemäß der Beobachtungsrichtung des beschrifteten Diagramms ist die linke Seite der Pluspol (+), Minuspol rechts (-). Wenn Batteriestrom benötigt wird, wird Kapazität empfohlen 1000–3000 mAhEinzelstück mit Schutzplatte (Schutzkreis) 3.7 V Lithium-Ionen/Lithium-Polymer-Batterie und bestätigen Sie die Schnittstellenspezifikationen sowie die positiven und negativen Elektroden vor dem Anschließen. Der umgekehrte Anschluss kann das Entwicklungsboard beschädigen.
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 hat im Fachbereich 100 kΩ / 100 kΩ Das Teilspannungsnetz erfasst die Batteriespannung, so dass idealerweise die tatsächliche Batteriespannung etwa ADC Pin-Spannung 2 Zeiten. Diese Funktion wird nur zur Spannungsschätzung verwendet und ist kein Leistungscoulombometer.
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 Anschlüsse / GPS Interface

GPS verwenden GPIO0 Und GPIO9 Als UART SignalGPIO0（GPSTX benannt) als Eingabe in diese Board-Definition, die Verbindung GPS Modul TX；GPIO9（GPSRX benannt) als Ausgang, Anschluss GPS Modul RX。1.25 mm 4-Pin Der Power-Pin des Steckers und die tatsächliche Pin-Sequenz sollten mit der entsprechenden Hardware-Version im Siebdruckverfahren gedruckt werden./Die schematische Darstellung hat Vorrang.
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.

Externe Antenne / External Antenna

ESP32-C5-WROOM-1U ist die externe Antennenversion. On-Board IPEX1 Schnittstelle muss mit verbunden werden 2.4/5 GHz Frequenzbandanpassung, Impedanz ist 50 Ω Antenne. Senden Sie keine hohe Leistung für längere Zeit ohne eine geeignete Antenne.
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-Schnittstelle： / Audio Connector

Audioausgabe durch GPIO8（AUDIOPWM) Generation PWM SignalGPIO24（AMP_EN) Steuerverstärker aktivieren; die Oberseite der Platine ist 2.0 mm 2-Pin Audio/Lautsprecherschnittstelle. Bitte beachten Sie die tatsächlichen Fähigkeiten der Leistungsverstärkerschaltung für verschiedene Last- und Lautstärkeeinstellungen.
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. Softwareentwicklungs- und Initialisierungsberatung / 10. Software Development and Initialization Notes

• Fahrerauswahl anzeigen ST7789, systemeigene Auflösung eingestellt auf 240×320; Querformat kann gedreht werden auf 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.

• Farbsequenzielle Verwendung BGR; Umgekehrte Farbanzeige nicht aktivieren (INVON）。 / Use BGR color order; do not enable display inversion (INVON).

• LCD/TF Geteilt SPI , nach Initialisierung separat verwalten LCD_CS(GPIO10) Und SD_CS(GPIO27)。 / When LCD and TF share SPI, manage LCD_CS (GPIO10) and SD_CS (GPIO27) independently after initialization.

• XPT2046 verwenden GPIO3/4/5/23/25 Eigenständige Software SPI。 / XPT2046 uses an independent software SPI on GPIO3/4/5/23/25.

• Beim Ablesen der Batteriespannung wird die GPIO1 Von ADC Ergebnisse um ca. 2:1 Umwandlung des Partialdruckverhältnisses, kombiniert mit ADC Die Kalibrierung verbessert die Genauigkeit. / 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 Verfügbare Kanäle und Sendeleistung variieren je nach Land/Regionale regulatorische Einschränkungen. / Available 5 GHz Wi-Fi channels and transmit power depend on local regulations.

• BOOT/Die Logik zur Wiederherstellung der Werkseinstellungen wird durch die Firmware bestimmt; Vermeiden Sie eine Fehlauslösung während des Betriebs und das Löschen der Konfiguration. / BOOT/factory-restore behavior is firmware-defined; avoid unintended activation that may clear settings.

Empfohlene Initialisierungssequenz / Suggested Initialization Sequence

1. Initialisieren Sie das System und die serielle Schnittstelle, nachdem die Stromversorgung stabil ist.
After power is stable, initialize the system and debug UART.

2. Initialisierung LCD SPI,aufstellen ST7789、BGR, schalten Sie die invertierte Farbe aus und schalten Sie dann die Hintergrundbeleuchtung ein.
Initialize LCD SPI; configure ST7789, BGR, inversion off, then enable backlight.

3. Initialisierung XPT2046 berühren.
Initialize XPT2046 touch.

4. Wenn Sie die Speicherfunktion nutzen müssen, legen Sie bitte das vom Benutzer vorbereitete kompatible ein microSD/TF Karte einlegen, neu initialisieren und sicherstellen LCD_CS Und SD_CS Der Status ist korrekt.
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. Bei Bedarf initialisieren GPS,Audio,LED,Batterie ADC。
Initialize GPS, audio, LED, and battery ADC as needed.

6. Zuletzt aktiviert Wi-Fi/BLE/802.15.4 Drahtlose Funktionen.
Enable Wi-Fi/BLE/802.15.4 radio functions as required.

11. Behebung häufiger Probleme / 11. Troubleshooting

12. Datendownload und technischer Support / 12. Downloads and Technical Support

ZLX-ESP32-2 Bitte gewähren Sie vorrangigen Zugriff auf die Firmware, Dateien, Folgeinformationen und zugehörigen Support. ZLX ESP32 Support-Center für Entwicklungsplatinenhersteller. Bitte überprüfen Sie, was auf der Seite aufgeführt ist, bevor Sie die Firmware flashen. PCB Das Modell entspricht exakt dem vorliegenden Board.
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.

Datendownload / Downloads: https://www.zlxchina.xyz/

Espressif module datasheet / Technische Daten des Espressif-Moduls: ESP32-C5-WROOM-1 / WROOM-1U Datasheet

Referenzen / References

• ZLX ESP32 Support-Center für Entwicklungsplatinenhersteller / 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. Verwendung und Sicherheitsvorkehrungen / 13. Safety and Handling

• Vor dem Anschließen der Batterie müssen die Plus- und Minuspole überprüft werden. Ein umgekehrter Anschluss ist verboten. / Verify battery polarity before connection; never reverse the battery connector.

• Ein- und ausstecken IPEX Halten Sie den Antennenstecker unter vertikaler Kraft, um ein seitliches Nebeln zu vermeiden, das dazu führt, dass die HF-Basis herunterfällt. / When mating/unmating the IPEX connector, apply force vertically and avoid sideways prying that may damage the RF socket.

• Achten Sie bei Verwendung der unbestückten Platine des Entwicklungsboards auf elektrostatischen Schutz, um Kurzschlüsse durch Metallgegenstände zu vermeiden. / Use ESD precautions with the bare board and prevent metal objects from causing shorts.

• 5 GHz Drahtloses Frequenzband, Kanal und Leistung müssen den Vorschriften in der Einsatzregion entsprechen. / 5 GHz radio band, channels, and transmit power must comply with local regulations.

• TF KarteGPSBitte beachten Sie die aktuelle Hardwareversion für die Stromversorgungsfunktionen und den Pegel von Peripheriegeräten wie Audio und Video. Kontaktieren Sie uns nicht ohne Bestätigung. IO Stift oben angebracht 3.3 V Ebene. / 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. Dokumentversionsdatensatz / 14. Document Revision History

— End / Beenden -