ZLX-ESP32-2
Vývojová deska ESP32-C5 s 2,8palcovým dotykovým displejem
1. Přehled produktu
ZLX-ESP32-2 je 2,8palcová odporová dotyková vývojová deska založená na modulu ESP32-C5-WROOM-1U-N8R8. Integruje barevný LCD displej, dotykový ovladač XPT2046, slot pro kartu microSD/TF (pouze slot pro kartu, karta microSD/TF není součástí dodávky), rozhraní GPS, audio výstup, detekci napětí baterie, zelený LED indikátor, tlačítko BOOT/RESET a rozhraní pro externí anténu. Je vhodný pro Wi-Fi 6, Bluetooth LE, Zigbee/Thread, Human Machine Interface (HMI), protokolování dat a vývoj internetu věcí (IoT).
Hlavní rysy
- ESP32-C5 32bitový RISC-V jednojádrový CPU, až 240 MHz
- ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (paměť modulu na desce, ne karta microSD/TF)
- 2,4 GHz + 5 GHz dvoupásmová Wi-Fi 6 (802.11ax)
- Bluetooth LE、IEEE 802.15.4、Zigbee 3.0、Thread 1.4
- 2,8palcový 240×320 LCD displej, ovladač ST7789 čip, inicializace BGR, deaktivována funkce inverze displeje
- XPT2046 odporový dotykový ovladač
- LCD a TF karta sdílejí rozhraní SPI, ale rozhraní CS je jiné; dotyková funkce využívá nezávislé softwarové rozhraní SPI.
- Rozměry panelu jsou přibližně 86 mm x 50 mm
- externí anténní rozhraní IPEX1; před použitím rádia připojte vhodnou externí anténu.
cílových uživatelů
Ideální pro embedded vývojáře, vývojáře IoT, tvůrce, použití ve vzdělávání/laboratořích a prototypování produktů.
2. Vzhled a velikost
Rozměry desky jsou přibližně 86 mm × 50 mm. Následující diagram pomáhá identifikovat displej, konektory a hlavní součásti.
Identifikace konektoru
3. Specifikace desky plošných spojů
| věc | Specifikace |
|---|---|
| deskový model | ZLX-ESP32-2 |
| jádrový modul | ESP32-C5-WROOM-1U-N8R8 |
| Velikost desky | Přibl. 86 × 50 mm |
| exponát | 2,8palcový TFT LCD displej, čip ST7789, původní rozlišení 240×320 |
| pořadí barev | Inicializace BGR |
| Displej převrácený | Vypnuto/normální režim zobrazení |
| dotek | Odporový dotyk, XPT2046 |
| Slot na microSD/TF kartu | režim SPI; karta není součástí dodávky |
| rozhraní GPS | 1,25 mm 4pinový konektor; Signály UART na GPIO0/GPIO9 |
| hlasitý | 2,0mm 2pinový reproduktorový/audio konektor; PWM audio + zesilovač povolen |
| Baterie | 3,7V jednofázový, 1,25mm dvojitý kolík; s ochranným obvodem, doporučená kapacita 1000–3000mAh |
| externí anténa | konektor IPEX1; vyžadováno pro bezdrátovou cestu WROOM-1U |
| tlačítko | reset, start |
| index | Zelená LED na GPIO26 |
4. Specifikace modulu ESP32-C5-WROOM-1U-N8R8
Následující klíčové parametry vycházejí z oficiálního listu Espressif ESP32-C5-WROOM-1 / WROOM-1U v1.2.
| věc | Specifikace |
|---|---|
| Vestavěný SoC | ESP32-C5HR8 |
| CPU | 32bitový jednojádrový procesor RISC-V, až 240 MHz |
| paměť pouze pro čtení | 320 KB |
| HP SRAM | 384 KB |
| LP SRAM | 16 KB |
| blikat | 8 MB Quad SPI |
| PSRAM | 8 MB Quad SPI |
| Wifi | 1T1R, 2,4 GHz + 5 GHz dvoupásmový; IEEE 802.11ax/ac/b/g/n; až 150 Mbps |
| Frekvence 2,4 GHz | 2412–2484 MHz |
| frekvence 5 GHz | 5180–5885 MHz (v souladu s regionálními předpisy) |
| Bluetooth | Bluetooth Low Energy; Seznam funkcí Espressif v1.2 obsahuje certifikaci Bluetooth Core 6.0 |
| IEEE 802.15.4 | 2.4 GHz OQPSK，250 Kbps |
| Zigbee/Thread | Zigbee 3.0 / Thread 1.4 |
| GPIO | Na úrovni modulu je k dispozici až 22 GPIO. |
| 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 používá nezávislé softwarové SPI na GPIO3/4/5/23/25.
- Pro napětí baterie převeďte odečet GPIO1 ADC pomocí poměru děliče napětí přibližně 2:1 a použijte kalibraci ADC pro lepší přesnost.
- Dostupné kanály Wi-Fi 5 GHz a vysílací výkon závisí na místních předpisech.
- Chování boot/factory reset je definováno firmwarem; vyvarujte se prosím náhodné aktivace, aby nedošlo k vymazání nastavení.
Doporučená inicializační sekvence
- Jakmile je napájení stabilní, inicializujte systém a odlaďte UART.
- Inicializovat LCD SPI; nakonfigurujte ST7789, BGR, vypněte inverzi a povolte podsvícení.
- Inicializujte dotykový XPT2046.
- Pokud je vyžadováno vyměnitelné úložiště, vložte kompatibilní kartu microSD/TF dodanou uživatelem, inicializujte ji a ujistěte se, že stav LCD_CS/SD_CS je správný.
- Inicializujte GPS, audio, LED a ADC baterie podle potřeby.
- Podle potřeby povolte funkci rádia Wi-Fi/BLE/802.15.4.
11. Odstraňování problémů
| otázka | řešení |
|---|---|
| Zobrazit prázdnou/černou obrazovku | Zkontrolujte GPIO6/7/10/13/14, výběr ovladače ST7789, nastavení BGR, podsvícení GPIO13 a zda není náhodou povolena funkce inverze. |
| špatná barva | Ověřte, zda je grafická knihovna nakonfigurována pro pořadí barev BGR. |
| Žádná odezva na dotyk | Zkontrolujte inicializaci GPIO3/4/5/23/25 a XPT2046. |
| Inicializace karty TF se nezdařila | Zkontrolujte sdílené SPI SCK/MOSI/MISO a ujistěte se, že SD_CS (GPIO27) a LCD_CS (GPIO10) nejsou nastaveny současně. |
| Slabý signál Wi-Fi/žádné Wi-Fi | Ověřte, zda je připojena externí anténa IPEX1 a zda je vhodná pro pásmo 2,4/5 GHz. |
| Čtení baterie je asi poloviční | GPIO1 používá dělič napětí 100k/100k; vynásobte napětí na straně ADC přibližně 2. |
| Žádná data GPS | Ověřte, že GPIO0 přijímá GPS TX, GPIO9 řídí GPS RX a ověřte přenosovou rychlost a výkon. |
12. Stahování a technická podpora
Firmware ZLX-ESP32-2, soubory, následnou dokumentaci a související podporu naleznete v centru podpory vývojové desky ZLX ESP32. Před flashováním firmwaru se ujistěte, že model PCB zobrazený na webu přesně odpovídá vašemu hardwaru.
Odkaz ke stažení:https://www.zlxchina.xyz/
Datový list modulu Espressif: Datový list ESP32-C5-WROOM-1 / WROOM-1U
odkazovat
- Centrum podpory vývojové desky ZLX ESP32
- Espressif ESP32-C5-WROOM-1 & WROOM-1U Datasheet v1.2 (2026-08-12)
13. Bezpečnost a provoz
- Před připojením zkontrolujte polaritu baterie; nepřipojujte konektory baterie obráceně.
- Při zapojování nebo odpojování konektoru IPEX použijte vertikální sílu a vyhněte se bočnímu páčení, aby nedošlo k poškození RF zásuvky.
- Při použití nechráněných desek plošných spojů proveďte ochranná opatření proti elektrostatickému výboji a zabraňte zkratům způsobeným kovovými předměty.
- Rádiové pásmo 5 GHz, kanál a vysílací výkon musí splňovat místní předpisy.
- U karet TF, GPS, audio a dalších periferií prosím dodržujte úrovně napájení a logiky specifikované aktuální verzí hardwaru. Neaplikujte logické úrovně vyšší než 3,3 V na I/O piny, pokud to není výslovně ověřeno.
14. Historie revizí dokumentu
| kněz | datum | popsat | Báze |
|---|---|---|---|
| V1.1 | 2026-08-25 | Revidované pokyny pro microSD/TF kartu, baterii a GPIO. | Hefei Zhiluxing Information Technology Co., Ltd. |
-Konec-