ZLX-ESP32-2
Carte de développement d'écran tactile ESP32-C5 de 2,8 pouces
1. Présentation du produit
ZLX-ESP32-2 est une carte de développement tactile résistif de 2,8 pouces basée sur le module ESP32-C5-WROOM-1U-N8R8. Il intègre un écran LCD couleur, un contrôleur tactile XPT2046, un emplacement pour carte microSD/TF (emplacement pour carte uniquement, carte microSD/TF non incluse), une interface GPS, une sortie audio, une détection de tension de la batterie, un indicateur LED vert, un bouton BOOT/RESET et une interface d'antenne externe. Il convient au Wi-Fi 6, au Bluetooth LE, au Zigbee/Thread, à l'interface homme-machine (IHM), à l'enregistrement de données et au développement de l'Internet des objets (IoT).
Principales caractéristiques
- Processeur monocœur RISC-V 32 bits ESP32-C5, jusqu'à 240 MHz
- ESP32-C5-WROOM-1U-N8R8 : 8 Mo de Flash + 8 Mo de PSRAM (mémoire de module intégrée, pas de carte microSD/TF)
- Wi-Fi 6 bi-bande 2,4 GHz + 5 GHz (802.11ax)
- Bluetooth LE、IEEE 802.15.4、Zigbee 3.0、Thread 1.4
- Écran LCD 2,8 pouces 240 × 320, puce pilote ST7789, initialisation BGR, fonction d'inversion d'affichage désactivée
- Contrôleur tactile résistif XPT2046
- Les cartes LCD et TF partagent une interface SPI, mais l'interface CS est différente ; la fonction tactile utilise une interface SPI logicielle indépendante.
- Les dimensions du panneau sont d'environ 86 mm x 50 mm
- Interface d'antenne externe IPEX1 ; veuillez connecter une antenne externe appropriée avant d'utiliser la radio.
utilisateurs cibles
Idéal pour les développeurs embarqués, les développeurs IoT, les créateurs, l'enseignement/laboratoire et le prototypage de produits.
2. Apparence et taille
Les dimensions de la planche sont d'environ 86 mm × 50 mm. Le schéma suivant permet d'identifier l'écran, les connecteurs et les principaux composants.
Identification du connecteur
3. Spécifications du circuit imprimé
| chose | Spécification |
|---|---|
| modèle de plaque | ZLX-ESP32-2 |
| module de base | ESP32-C5-WROOM-1U-N8R8 |
| Taille du tableau | Env. 86 × 50 mm |
| exposition | Écran LCD TFT de 2,8 pouces, puce ST7789, résolution originale 240 × 320 |
| ordre des couleurs | Initialisation BGR |
| Affichage inversé | Mode d'affichage désactivé/normal |
| touche | Tactile résistif, XPT2046 |
| Emplacement pour carte microSD/TF | Mode SPI ; carte non incluse |
| Interface GPS | Connecteur 1,25 mm à 4 broches ; Signaux UART sur GPIO0/GPIO9 |
| vocal | Connecteur haut-parleur/audio 2,0 mm à 2 broches ; Audio PWM + amplificateur activé |
| Batterie | 3,7 V monophasé, double broche de 1,25 mm ; avec circuit de protection, capacité recommandée 1 000–3 000 mAh |
| antenne externe | connecteur IPEX1 ; requis pour le chemin sans fil WROOM-1U |
| bouton | réinitialiser, démarrer |
| indice | LED verte sur GPIO26 |
4. Spécifications du module ESP32-C5-WROOM-1U-N8R8
Les paramètres clés suivants sont basés sur la fiche technique officielle Espressif ESP32-C5-WROOM-1 / WROOM-1U v1.2.
| chose | Spécification |
|---|---|
| SoC embarqué | ESP32-C5HR8 |
| Processeur | Processeur monocœur RISC-V 32 bits, jusqu'à 240 MHz |
| mémoire en lecture seule | 320 KB |
| HP SRAM | 384 KB |
| LP SRAM | 16 KB |
| éclair | 8 Mo Quad SPI |
| PSRAM | 8 Mo Quad SPI |
| Wi-Fi | 1T1R, 2,4 GHz + 5 GHz double bande ; IEEE 802.11ax/ac/b/g/n ; jusqu'à 150 Mbit/s |
| Fréquence 2,4 GHz | 2412–2484 MHz |
| Fréquence 5 GHz | 5 180–5 885 MHz (sous réserve des réglementations régionales) |
| Bluetooth | Bluetooth basse consommation ; La liste des fonctionnalités d'Espressif v1.2 affiche la certification Bluetooth Core 6.0 |
| IEEE 802.15.4 | 2.4 GHz OQPSK，250 Kbps |
| Zigbee/Thread | Zigbee 3.0 / Thread 1.4 |
| GPIO | Jusqu'à 22 GPIO sont disponibles au niveau du module. |
| Typical Peripherals | GPIO, SPI, UART, I2C, I2S, RMT, LED PWM, USB Serial/JTAG, MCPWM, GDMA, CAN FD, SDIO slave, ADC, temperature sensor, timers, watchdogs, etc. |
| Module Supply | 3.0–3.6 V, typical 3.3 V |
| Recommended Supply Capability | External supply should be capable of at least 0.6 A for the module |
| Ambient Temperature | -40 to +85 °C |
| Module Size | 18.0 × 21.2 × 3.3 mm |
| Antenna | External antenna via connector/module RF path; 50 Ω RF system |
5. Display and Touch
LCD Parameters
| Item | Specification |
|---|---|
| Size | 2.8 inch |
| Driver IC | ST7789 |
| Native resolution | 240 × 320 |
| Landscape logical resolution | 320 × 240 (depending on rotation setting) |
| Color order | BGR |
| Inversion | Disabled / OFF; normal display mode |
| SPI SCK | GPIO6 |
| SPI MOSI | GPIO7 |
| SPI MISO | GPIO2 (shared with TF card; used if required by library/readback) |
| LCD CS | GPIO10 |
| LCD Backlight | GPIO13 |
| LCD DC / RS | GPIO14 |
Touch Parameters
- Touch type: 4-wire resistive; controller: XPT2046.
- DOUT=GPIO3, SCK=GPIO4, DIN=GPIO5.
- CS=GPIO23, IRQ=GPIO25.
- Touch uses an independent software SPI; the supplied test flow is marked as requiring no calibration.
6. GPIO Mapping
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.
| GPIO | Signal | Definition | Direction | Function | Notes |
|---|---|---|---|---|---|
| 0 | GPSTX | GPS UART TX | Input | GPS test | GPS module TX → ESP32-C5 |
| 1 | BAT_ADC | Battery voltage sensing | Input/ADC | Battery test | 100k/100k divider; ADC × 2 ≈ battery voltage |
| 2 | SD_MISO | TF DAT0 / LCD MISO shared | Input | TF card test | Shared SPI MISO |
| 3 | RTP_DOUT | XPT2046 DOUT | Input | Touch test | Touch controller data output |
| 4 | RTP_SCK | XPT2046 SCK | Output | Touch test | Independent software SPI |
| 5 | RTP_DIN | XPT2046 DIN | Output | Touch test | Independent software SPI |
| 6 | LCD_SCK | LCD SCK / TF SCK shared | Output | LCD/TF test | Shared SPI clock |
| 7 | LCD_MOSI | LCD MOSI / TF CMD(MOSI) shared | Output | LCD/TF test | Shared SPI MOSI |
| 8 | AUDIOPWM | Audio PWM | Output | Audio test | Audio output control |
| 9 | GPSRX | GPS UART RX | Output | GPS test | ESP32-C5 TX → GPS module RX |
| 10 | LCDCS | ST7789 CS | Output | Display test | LCD chip select |
| 13 | LCDBL | LCD backlight | Output | Display test | Backlight control |
| 14 | LCD_RS/DC | ST7789 DC | Output | Display test | Data/command select |
| 23 | RTPCS | XPT2046 CS | Output | Touch test | Touch chip select |
| 24 | AMP_EN | Amplifier enable | Output | Audio test | High-level enable per supplied mapping; verify actual hardware revision |
| 25 | RTPIRQ | XPT2046 IRQ | Input | Touch test | Touch interrupt |
| 26 | GREENLED | Green LED | Output | LED test | HIGH = ON, LOW = OFF |
| 27 | SDCS | TF DAT3 / CS | Output | TF card test | TF card SPI chip select |
| 28 | BOOTAUTO | BOOT / auto-start control | Input/Control | Factory restore | BOOT input / factory-restore logic |
System and UART Signals
| Signal | Purpose | Note |
|---|---|---|
| RESET_AUTO / EN | ESP32 reset / enable | System enable/reset; not a GPIO |
| UART0_TX / TX0 / GPIO11 | UART0 transmit | Used; excluded from the 19 peripheral GPIO count |
| UART0_RX / RX0 / GPIO12 | UART0 receive | Used; excluded from the 19 peripheral GPIO count |
7. Interface and Bus Sharing
| Item | GPIO | Description |
|---|---|---|
| LCD + TF Shared SPI | GPIO6 / GPIO7 / GPIO2 | SCK, MOSI, MISO shared; devices separated by independent CS |
| LCD CS | GPIO10 | LCD_CS |
| TF card CS | GPIO27 | SD_CS / DAT3 |
| XPT2046 touch | GPIO3 / 4 / 5 / 23 / 25 | DOUT / SCK / DIN / CS / IRQ |
| GPS UART | GPIO0 / GPIO9 | GPSTX / GPSRX; GPIO0 receives GPS TX, GPIO9 drives GPS RX |
| Battery ADC | GPIO1 | BAT_ADC; 100k/100k divider; C20 100 nF filtering |
| Green LED | GPIO26 | HIGH ON, LOW OFF |
| Audio | GPIO8 / GPIO24 | AUDIOPWM / AMP_EN |
| LCD control | GPIO13 / GPIO14 | Backlight / DC |
SPI Sharing Notes
- LCD and TF card share GPIO6 (SCK), GPIO7 (MOSI), and GPIO2 (MISO), but use GPIO10 (LCD_CS) and GPIO27 (SD_CS) respectively.
- Assert only the target device CS at a time to avoid bus contention.
- The XPT2046 touch controller uses an independent software SPI and does not share the main LCD/TF SCK/MOSI signals.
8. Functional Test Mapping
| Test | GPIO | What is tested | Result / Note |
|---|---|---|---|
| Display | GPIO6, 7, 10, 13, 14, 2 | ST7789 display, 240×320 native / 320×240 landscape; BGR; backlight | Normal / Abnormal |
| Touch | GPIO3, 4, 5, 23, 25 | XPT2046 touch response | Test flow: no calibration |
| TF card | GPIO2, 6, 7, 27 | SPI init, read/write/format | Shares SPI with LCD |
| Audio | GPIO8, 24 | PWM audio and amplifier enable | Continuous playback depends on firmware |
| Wi-Fi | Internal RF | 2.4 GHz / 5 GHz scan | No listed GPIO occupied |
| BLE | Internal RF | BLE scan | No listed GPIO occupied |
| GPS | GPIO0, 9 | GPS UART data | GPSTX / GPSRX |
| LED | GPIO26 | Green LED | HIGH on / LOW off |
| Battery | GPIO1 | ADC measures divided battery voltage | Voltage estimate, not a coulomb counter |
| Factory restore | GPIO28 | BOOT input / restore logic | Behavior is defined by firmware |
9. Connector and Electrical Notes
Battery Connector
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.
Battery Voltage Sensing
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 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.
External Antenna
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 Connector
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. Software Development and Initialization Notes
- 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.
- Use BGR color order; do not enable display inversion (INVON).
- When LCD and TF share SPI, manage LCD_CS (GPIO10) and SD_CS (GPIO27) independently after initialization.
- Le XPT2046 utilise un logiciel indépendant SPI sur GPIO3/4/5/23/25.
- Pour la tension de la batterie, convertissez la lecture GPIO1 ADC en utilisant un rapport de diviseur de tension d'environ 2:1 et appliquez l'étalonnage ADC pour une meilleure précision.
- Les canaux Wi-Fi 5 GHz disponibles et la puissance de transmission dépendent des réglementations locales.
- Le comportement du démarrage/réinitialisation d'usine est défini par le micrologiciel ; veuillez éviter toute activation accidentelle pour éviter d'effacer les paramètres.
Séquence d'initialisation recommandée
- Une fois l'alimentation stable, initialisez le système et déboguez l'UART.
- Initialisez l'écran LCD SPI ; configurez ST7789, BGR, désactivez l'inversion et activez le rétroéclairage.
- Initialisez le XPT2046 tactile.
- Si un stockage amovible est requis, insérez une carte microSD/TF compatible fournie par l'utilisateur, puis initialisez-la et assurez-vous que l'état LCD_CS/SD_CS est correct.
- Initialisez le GPS, l'audio, la LED et l'ADC de la batterie selon vos besoins.
- Activez la fonctionnalité radio Wi-Fi/BLE/802.15.4 selon vos besoins.
11. Dépannage
| question | solution |
|---|---|
| Afficher un écran vide/noir | Vérifiez GPIO6/7/10/13/14, la sélection du pilote ST7789, les paramètres BGR, le rétroéclairage GPIO13 et si la fonction d'inversion est accidentellement activée. |
| mauvaise couleur | Vérifiez que la bibliothèque graphique est configurée pour l'ordre des couleurs BGR. |
| Aucune réponse tactile | Vérifiez l'initialisation GPIO3/4/5/23/25 et XPT2046. |
| L'initialisation de la carte TF a échoué | Vérifiez le SPI SCK/MOSI/MISO partagé et assurez-vous que SD_CS (GPIO27) et LCD_CS (GPIO10) ne sont pas définis en même temps. |
| Signal Wi-Fi faible/pas de Wi-Fi | Vérifiez que l'antenne externe IPEX1 est connectée et adaptée à la bande 2,4/5 GHz. |
| La lecture de la batterie est d'environ la moitié | GPIO1 utilise un diviseur de tension 100k/100k ; multipliez la tension côté ADC par environ 2. |
| Aucune donnée GPS | Vérifiez que GPIO0 reçoit le GPS TX, GPIO9 pilote le GPS RX et vérifiez le débit en bauds et la puissance. |
12. Téléchargements et support technique
Pour le micrologiciel ZLX-ESP32-2, les fichiers, la documentation de suivi et l'assistance associée, veuillez visiter le centre de support de la carte de développement ZLX ESP32. Avant de flasher le firmware, assurez-vous de confirmer que le modèle de PCB affiché sur le site Web correspond exactement à votre matériel.
Lien de téléchargement :https://www.zlxchina.xyz/
Fiche technique du module Espressif : Fiche technique ESP32-C5-WROOM-1 / WROOM-1U
se référer à
- Centre de support de la carte de développement ZLX ESP32
- Espressif ESP32-C5-WROOM-1 & WROOM-1U Fiche technique v1.2 (2026-08-12)
13. Sécurité et fonctionnement
- Veuillez confirmer la polarité de la batterie avant de vous connecter ; ne branchez pas les connecteurs de la batterie à l’envers.
- Lorsque vous branchez ou débranchez le connecteur IPEX, veuillez appliquer une force verticale et éviter de faire levier latéral pour éviter d'endommager la prise RF.
- Lorsque vous utilisez des circuits imprimés exposés, prenez des mesures de protection contre les décharges électrostatiques et évitez les courts-circuits causés par des objets métalliques.
- La bande radio 5 GHz, le canal et la puissance d'émission doivent être conformes aux réglementations locales.
- Pour les cartes TF, GPS, audio et autres périphériques, veuillez suivre les niveaux d'alimentation et logiques spécifiés par la version matérielle réelle. N'appliquez pas de niveaux logiques supérieurs à 3,3 V aux broches d'E/S, sauf vérification explicite.
14. Historique des révisions du document
| prêtre | date | décrire | Base |
|---|---|---|---|
| V1.1 | 2026-08-25 | Instructions révisées pour la carte microSD/TF, la batterie et le GPIO. | Hefei Zhiluxing Information Technology Co., Ltd. |
-Fin-