1. Présentation du produit / 1. Product Overview

ZLX-ESP32-2 est un produit basé sur ESP32-C5-WROOM-1U-N8R8 Modulaire 2.8 Carte de développement d'écran tactile résistif de pouces avec couleur intégrée LCD、XPT2046 touche,microSD/TF Emplacement pour carte (emplacement pour carte uniquement, non inclus microSD/TF Carte),GPS Interface, sortie audio, détection de tension de batterie, vert LED、BOOT/RESET Interface bouton et antenne externe. Approprié Wi-Fi 6、Bluetooth LE、Zigbee/Thread, interface homme-machine, enregistrement de données et développement d'applications Internet des objets.
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.

Principales caractéristiques / Key Features

• ESP32-C5 32 Peu RISC-V Processeur monocœur, jusqu'à 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(Ressources embarquées du module, pas microSD/TF Carte) / ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (onboard module memory, not a microSD/TF card)

• 2.4 GHz + 5 GHz Double bande 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 pouce 240×320 LCD，ST7789 conduire,BGR Initialisation, désactiver la couleur inversée / 2.8-inch 240×320 LCD, ST7789 driver, BGR initialization, display inversion disabled

• XPT2046 Contrôleur tactile résistif / XPT2046 resistive touch controller

• LCD et TF Partage de carte SPI bus, indépendant CS;Touchez pour utiliser un logiciel autonome SPI / LCD and TF card share SPI with separate CS; touch uses an independent software SPI

• Taille de la planche env. 86 mm × 50 mm / Board size approx. 86 mm × 50 mm

• IPEX1 Interface d'antenne externe ; l'antenne externe doit être correctement connectée avant d'utiliser la fonction sans fil / IPEX1 external antenna connector; connect a suitable external antenna before radio use

Objets applicables / Intended Users

Convient aux développeurs embarqués, aux développeurs IoT, aux créateurs, aux expériences pédagogiques et à la conception de prototypes de produits.
For embedded developers, IoT developers, makers, education/lab use, and product prototyping.

2. Apparence et taille / 2. Appearance and Dimensions

Les dimensions hors tout de la planche sont d'environ 86 mm × 50 mm. Les images recto et verso suivantes sont utilisées pour identifier l'écran, les interfaces et les principaux composants.
The board outline is approximately 86 mm × 50 mm. The images below help identify the display, connectors, and major components.

image 1 Dimensions façade et écran / Figure 1 Board front and display-side dimensions

Annotations d'interface / Connector Identification

image 2 ZLX-ESP32-2 Annotations de l'interface en chinois et en anglais / Figure 2 Bilingual connector identification

3. Spécifications de la carte de développement / 3. Board Specifications

illustrer / Note: La résolution native de l'écran est 240×320;Lorsque le logiciel est réglé sur la rotation horizontale de l'écran, la taille d'affichage logique peut être exprimée comme suit : 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 Paramètres des modules / 4. ESP32-C5-WROOM-1U-N8R8 Module Specifications

Les paramètres clés suivants sont basés sur Espressif officiel 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. Affichage et toucher / 5. Display and Touch

LCD paramètre / LCD Parameters

Paramètres tactiles / Touch Parameters

• Type de contact :4 Contact résistif de fil ; Contrôleur: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.

• Appuyez pour utiliser un logiciel autonome SPI;Le processus de l'outil de détection est marqué comme ne nécessitant pas d'étalonnage. / Touch uses an independent software SPI; the supplied test flow is marked as requiring no calibration.

6. GPIO cartographie / 6. GPIO Mapping

Les mappages suivants proviennent de la version client fournie avec la carte GPIO Feuille de calcul et vérification par rapport au schéma. Utilisation des périphériques embarqués 19 Un ordinaire GPIO；TX0=GPIO11、RX0=GPIO12 Également utilisé pour UART0；N8R8 de GPIO15 édredon PSRAM occupé, donc 21 disponible GPIO Tous assignés ;EN Non compté comme travail 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.

Signaux du système et du port série / System and UART Signals

7. Instructions pour l'interface et le partage de bus / 7. Interface and Bus Sharing

SPI Partager des considérations / SPI Sharing Notes

• LCD et TF Partage de carte GPIO6(SCK)、GPIO7(MOSI)、GPIO2(MISO), mais en utilisant respectivement GPIO10(LCD_CS) et 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.

• Activer uniquement l'appareil cible en même temps CS, pour éviter les conflits de bus provoqués par la sélection simultanée de plusieurs appareils. / Assert only the target device CS at a time to avoid bus contention.

• touche XPT2046 Utiliser un logiciel autonome SPI, pas avec LCD/TF Seigneur SPI horloge et MOSI commun. / The XPT2046 touch controller uses an independent software SPI and does not share the main LCD/TF SCK/MOSI signals.

8. Correspondance de la fonction de détection / 8. Functional Test Mapping

9. Considérations relatives à l'interface et à l'électricité / 9. Connector and Electrical Notes

Interface batterie / Battery Connector

Carte de développement fournie 1.25 mm 2-Pin 3.7 V Interface de batterie unique. Selon la direction de visualisation du diagramme marqué, le côté gauche est l'électrode positive (+), le côté droit est le pôle négatif (-). Si l'alimentation par batterie est requise, il est recommandé d'utiliser la capacité 1000–3000 mAh, section unique avec panneau de protection (circuit de protection) 3.7 V Lithium-ion/Batterie au lithium polymère, et confirmez les spécifications de l'interface et les pôles positifs et négatifs avant de vous connecter. Une connexion inversée peut endommager la carte de développement.
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 passer 100 kΩ / 100 kΩ Le réseau diviseur de tension détecte la tension de la batterie, donc dans des circonstances idéales, la tension réelle de la batterie est d'environ ADC tension des broches 2 fois. Cette fonction est uniquement destinée à l'estimation de la tension, pas à un coulombomètre de carburant.
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 interface / GPS Interface

GPS utiliser GPIO0 et GPIO9 comme UART Signal.GPIO0（GPSTX nommé) comme entrée dans cette définition de carte, connectez-vous GPS module TX；GPIO9（GPSRX nommé) en sortie, connectez-vous GPS module RX。1.25 mm 4-Pin Veuillez vous référer à la version matérielle correspondante pour les broches d'alimentation et la séquence réelle des broches du connecteur./Le diagramme schématique prévaudra.
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.

antenne externe / External Antenna

ESP32-C5-WROOM-1U Il s'agit de la version avec antenne externe. conseil IPEX1 L'interface doit être connectée à 2.4/5 GHz L'adaptation de bande de fréquence et l'impédance sont 50 Ω antenne. N'émettez pas à puissance élevée pendant une période prolongée sans qu'une antenne appropriée soit connectée.
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.

interface audio / Audio Connector

La sortie audio est fournie par GPIO8（AUDIOPWM)produire PWM Signal,GPIO24（AMP_EN) contrôle la validation de l'amplificateur de puissance ; le haut du tableau est 2.0 mm 2-Pin Audio/Interface haut-parleur. Veuillez vous référer aux capacités réelles du circuit de l'amplificateur de puissance pour différents réglages de charge et de volume.
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. Conseils en développement et initialisation de logiciels / 10. Software Development and Initialization Notes

• Sélection du pilote d'affichage ST7789, la résolution native est définie sur 240×320;L'écran horizontal peut être tourné vers 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.

• Ordre des couleurs utilisé BGR;Ne pas activer l'affichage des couleurs inversées (INVON）。 / Use BGR color order; do not enable display inversion (INVON).

• LCD/TF partager SPI quand, géré séparément après initialisation LCD_CS(GPIO10) et SD_CS(GPIO27)。 / When LCD and TF share SPI, manage LCD_CS (GPIO10) and SD_CS (GPIO27) independently after initialization.

• XPT2046 utiliser GPIO3/4/5/23/25 logiciel indépendant SPI。 / XPT2046 uses an independent software SPI on GPIO3/4/5/23/25.

• Lors de la lecture de la tension de la batterie, le GPIO1 de ADC Résultats d'env. 2:1 Conversion partielle du rapport de pression, combinée à ADC L'étalonnage améliore la précision. / 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 Les canaux disponibles et la puissance d'émission varient selon le pays/Restrictions réglementaires régionales. / Available 5 GHz Wi-Fi channels and transmit power depend on local regulations.

• BOOT/La logique de restauration d'usine est déterminée par le micrologiciel ; éviter les erreurs de déclenchement pendant le fonctionnement et provoquer l'effacement de la configuration. / BOOT/factory-restore behavior is firmware-defined; avoid unintended activation that may clear settings.

Séquence d'initialisation recommandée / Suggested Initialization Sequence

1. Initialisez le système et le port série une fois que l'alimentation est stable.
After power is stable, initialize the system and debug UART.

2. initialisation LCD SPI,installation ST7789、BGR, désactivez la couleur inverse, puis activez le rétroéclairage.
Initialize LCD SPI; configure ST7789, BGR, inversion off, then enable backlight.

3. initialisation XPT2046 touche.
Initialize XPT2046 touch.

4. Si vous devez utiliser la fonction de stockage, veuillez insérer le fichier compatible préparé par l'utilisateur. microSD/TF carte, réinitialisez-la et assurez-vous LCD_CS et SD_CS Le statut est correct.
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. Initialiser à la demande GPS,audio,LED,Batterie ADC。
Initialize GPS, audio, LED, and battery ADC as needed.

6. Dernière activation Wi-Fi/BLE/802.15.4 Capacités sans fil.
Enable Wi-Fi/BLE/802.15.4 radio functions as required.

11. Dépannage des problèmes courants / 11. Troubleshooting

12. Téléchargement de données et support technique / 12. Downloads and Technical Support

ZLX-ESP32-2 Veuillez donner un accès prioritaire au micrologiciel, aux fichiers, aux informations de suivi et au support associé. ZLX ESP32 Centre d'assistance pour les créateurs de cartes de développement. Veuillez confirmer ce qui est répertorié sur la page avant de flasher le firmware. PCB Le modèle est exactement le même que la planche en main.
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.

Téléchargement de données / Downloads: https://www.zlxchina.xyz/

Espressif module datasheet / Spécifications du module Expressif: ESP32-C5-WROOM-1 / WROOM-1U Datasheet

Références / References

• ZLX ESP32 Centre d'assistance pour les créateurs de cartes de développement / 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. Précautions d'utilisation et de sécurité / 13. Safety and Handling

• Les pôles positifs et négatifs doivent être confirmés avant de connecter la batterie, et la connexion inversée est interdite. / Verify battery polarity before connection; never reverse the battery connector.

• Brancher et débrancher IPEX Maintenez la force verticale lors de la connexion de l'antenne pour éviter les leviers latéraux qui pourraient faire tomber la base RF. / When mating/unmating the IPEX connector, apply force vertically and avoid sideways prying that may damage the RF socket.

• Lorsque vous utilisez la carte nue de la carte de développement, faites attention à la protection électrostatique pour éviter les courts-circuits causés par des objets métalliques. / Use ESD precautions with the bare board and prevent metal objects from causing shorts.

• 5 GHz La bande de fréquences, le canal et la puissance sans fil doivent être conformes aux réglementations en vigueur dans la région d'utilisation. / 5 GHz radio band, channels, and transmit power must comply with local regulations.

• TF Carte,GPSVeuillez suivre la version réelle du matériel pour connaître les capacités d'alimentation et les niveaux des périphériques tels que l'audio et la vidéo. Ne nous contactez pas sans confirmation. IO épingle appliquée ci-dessus 3.3 V niveau. / 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. Enregistrement de la version du document / 14. Document Revision History

— End / Finition -