ZLX-ESP32-2
ESP32-C5 2,8-tums pekskärmsutvecklingskort
1. Produktöversikt
ZLX-ESP32-2 är ett 2,8-tums resistivt touch-utvecklingskort baserat på ESP32-C5-WROOM-1U-N8R8-modulen. Den integrerar en LCD-färgskärm, XPT2046 pekkontroll, microSD/TF-kortplats (endast kortplats, microSD/TF-kort ingår ej), GPS-gränssnitt, ljudutgång, batterispänningsdetektering, grön LED-indikator, BOOT/RESET-knapp och externt antenngränssnitt. Den är lämplig för Wi-Fi 6, Bluetooth LE, Zigbee/Thread, Human Machine Interface (HMI), dataloggning och Internet of Things (IoT) utveckling.
Huvuddrag
- ESP32-C5 32-bitars RISC-V enkelkärnig CPU, upp till 240 MHz
- ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (inbyggt modulminne, inte microSD/TF-kort)
- 2,4 GHz + 5 GHz dual-band Wi-Fi 6 (802.11ax)
- Bluetooth LE、IEEE 802.15.4、Zigbee 3.0、Thread 1.4
- 2,8-tums 240×320 LCD-skärm, ST7789-drivrutinschip, BGR-initiering, skärminverteringsfunktion inaktiverad
- XPT2046 resistiv touchkontroll
- LCD- och TF-kort delar ett SPI-gränssnitt, men CS-gränssnittet är annorlunda; pekfunktionen använder ett oberoende mjukvaru-SPI-gränssnitt.
- Panelens mått är cirka 86 mm x 50 mm
- IPEX1 externt antenngränssnitt; Anslut en lämplig extern antenn innan du använder radion.
målanvändare
Idealisk för inbäddade utvecklare, IoT-utvecklare, tillverkare, utbildning/labbanvändning och produktprototyper.
2. Utseende och storlek
Skivans mått är cirka 86 mm × 50 mm. Följande diagram hjälper till att identifiera displayen, anslutningarna och huvudkomponenterna.
Identifiering av kontaktdon
3. Kretskortspecifikationer
| sak | Specifikation |
|---|---|
| tallrik modell | ZLX-ESP32-2 |
| kärnmodul | ESP32-C5-WROOM-1U-N8R8 |
| Styrelsens storlek | Ca. 86 × 50 mm |
| uppvisa | 2,8-tums TFT LCD-skärm, ST7789-chip, originalupplösning 240×320 |
| färgordning | BGR-initiering |
| Display inverterad | Av/normalt visningsläge |
| röra | Resistiv beröring, XPT2046 |
| microSD/TF-kortplats | SPI-läge; kort ingår ej |
| GPS-gränssnitt | 1,25 mm 4-polig kontakt; UART-signaler på GPIO0/GPIO9 |
| sång- | 2,0 mm 2-stifts högtalare/ljudkontakt; PWM-ljud + förstärkare aktiverad |
| Batteri | 3,7V enkelfas, 1,25 mm dubbelstift; med skyddskrets, rekommenderad kapacitet 1000–3000mAh |
| extern antenn | IPEX1-kontakt; krävs för WROOM-1U trådlös sökväg |
| knapp | återställa, starta |
| index | Grön lysdiod på GPIO26 |
4. ESP32-C5-WROOM-1U-N8R8 modulspecifikationer
Följande nyckelparametrar är baserade på Espressifs officiella ESP32-C5-WROOM-1 / WROOM-1U datablad v1.2.
| sak | Specifikation |
|---|---|
| Inbäddad SoC | ESP32-C5HR8 |
| CPU | 32-bitars RISC-V enkelkärnig processor, upp till 240 MHz |
| läsminne | 320 KB |
| HP SRAM | 384 KB |
| LP SRAM | 16 KB |
| flash | 8 MB Quad SPI |
| PSRAM | 8 MB Quad SPI |
| Wifi | 1T1R, 2,4 GHz + 5 GHz dubbelband; IEEE 802.11ax/ac/b/g/n; upp till 150 Mbps |
| 2,4 GHz frekvens | 2412–2484 MHz |
| 5 GHz frekvens | 5180–5885 MHz (med förbehåll för regionala bestämmelser) |
| Bluetooth | Bluetooth lågenergi; Funktionslistan i Espressif v1.2 visar Bluetooth Core 6.0-certifierad |
| IEEE 802.15.4 | 2.4 GHz OQPSK，250 Kbps |
| Zigbee/Thread | Zigbee 3.0 / Thread 1.4 |
| GPIO | Upp till 22 GPIO är tillgängliga på modulnivå. |
| 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.
- XPT2046 använder oberoende programvara SPI på GPIO3/4/5/23/25.
- För batterispänning, konvertera GPIO1 ADC-avläsningen med ett spänningsdelarförhållande på cirka 2:1 och tillämpa ADC-kalibrering för bättre noggrannhet.
- Tillgängliga 5 GHz Wi-Fi-kanaler och sändningseffekt beror på lokala bestämmelser.
- Beteendet för start/fabriksåterställning definieras av firmware; Undvik oavsiktlig aktivering för att undvika att inställningarna raderas.
Rekommenderad initieringssekvens
- Efter att strömförsörjningen är stabil, initiera systemet och felsök UART.
- Initiera LCD SPI; konfigurera ST7789, BGR, stäng av inversion och aktivera bakgrundsbelysning.
- Initiera XPT2046 touch.
- Om flyttbar lagring krävs, sätt i ett kompatibelt microSD/TF-kort som användaren tillhandahåller, initiera det och se till att LCD_CS/SD_CS-statusen är korrekt.
- Initiera GPS, ljud, LED och batteri ADC efter behov.
- Aktivera Wi-Fi/BLE/802.15.4-radiofunktioner efter behov.
11. Felsökning
| fråga | lösning |
|---|---|
| Visa tom/svart skärm | Kontrollera GPIO6/7/10/13/14, ST7789 drivrutinsval, BGR-inställningar, bakgrundsbelysning GPIO13 och om inversionsfunktionen av misstag aktiveras. |
| fel färg | Kontrollera att grafikbiblioteket är konfigurerat för BGR-färgordning. |
| Inget beröringssvar | Kontrollera GPIO3/4/5/23/25 och XPT2046-initieringen. |
| TF-kortinitiering misslyckades | Kontrollera delad SPI SCK/MOSI/MISO och se till att SD_CS (GPIO27) och LCD_CS (GPIO10) inte är inställda samtidigt. |
| Svag Wi-Fi-signal/inget Wi-Fi | Kontrollera att den externa IPEX1-antennen är ansluten och lämplig för 2,4/5 GHz-bandet. |
| Batteriavläsningen är ungefär hälften | GPIO1 använder en 100k/100k spänningsdelare; multiplicera ADC-sidospänningen med ungefär 2. |
| Ingen GPS-data | Verifiera att GPIO0 tar emot GPS TX, GPIO9 driver GPS RX och verifiera överföringshastighet och effekt. |
12. Nedladdningar och teknisk support
För ZLX-ESP32-2 firmware, filer, uppföljningsdokumentation och relaterad support, besök ZLX ESP32 Development Board Support Center. Innan du börjar blinka firmware, se till att bekräfta att PCB-modellen som visas på webbplatsen exakt matchar din hårdvara.
Ladda ner länk:https://www.zlxchina.xyz/
Datablad för Espressif-modul: ESP32-C5-WROOM-1 / WROOM-1U datablad
referera till
- ZLX ESP32 Development Board Support Center
- Espressif ESP32-C5-WROOM-1 & WROOM-1U Datablad v1.2 (2026-08-12)
13. Säkerhet och drift
- Kontrollera batteriets polaritet innan du ansluter; Anslut inte batterikontakterna omvänt.
- När du ansluter eller kopplar ur IPEX-kontakten, använd vertikal kraft och undvik att bända i sidled för att undvika att skada RF-uttaget.
- Vid användning av utsatta kretskort, vidta skyddsåtgärder mot elektrostatisk urladdning och förhindra kortslutning orsakad av metallföremål.
- 5 GHz-radiobandet, kanalen och sändningseffekten måste följa lokala bestämmelser.
- För TF-kort, GPS, ljud och annan kringutrustning, följ strömförsörjningen och logiknivåerna som anges av den faktiska hårdvaruversionen. Applicera inte logiska nivåer högre än 3,3V på I/O-stiften såvida de inte uttryckligen har verifierats.
14. Dokumentrevisionshistorik
| präst | datum | beskriva | Bas |
|---|---|---|---|
| V1.1 | 2026-08-25 | Reviderade instruktioner för microSD/TF-kort, batteri och GPIO. | Hefei Zhiluxing Information Technology Co., Ltd. |
-Avsluta-