ZLX-ESP32-2
Płytka rozwojowa wyświetlacza dotykowego ESP32-C5 o przekątnej 2,8 cala
1. Przegląd produktu
ZLX-ESP32-2 to 2,8-calowa rezystancyjna płytka rozwojowa z ekranem dotykowym oparta na module ESP32-C5-WROOM-1U-N8R8. Zawiera kolorowy wyświetlacz LCD, kontroler dotykowy XPT2046, gniazdo kart microSD/TF (tylko gniazdo kart, karta microSD/TF nie jest dołączona), interfejs GPS, wyjście audio, wykrywanie napięcia akumulatora, zielony wskaźnik LED, przycisk BOOT/RESET i interfejs anteny zewnętrznej. Nadaje się do Wi-Fi 6, Bluetooth LE, Zigbee/Thread, interfejsu człowiek-maszyna (HMI), rejestrowania danych i rozwoju Internetu rzeczy (IoT).
Najważniejsze funkcje
- ESP32-C5 32-bitowy, jednordzeniowy procesor RISC-V, do 240 MHz
- ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (pamięć modułu wbudowanego, nie karta microSD/TF)
- Dwuzakresowy Wi-Fi 6 2,4 GHz + 5 GHz (802.11ax)
- Bluetooth LE、IEEE 802.15.4、Zigbee 3.0、Thread 1.4
- Wyświetlacz LCD 2,8 cala 240×320, układ sterownika ST7789, inicjalizacja BGR, wyłączona funkcja inwersji wyświetlacza
- Rezystancyjny kontroler dotykowy XPT2046
- Karta LCD i TF mają wspólny interfejs SPI, ale interfejs CS jest inny; funkcja dotykowa wykorzystuje niezależny interfejs programowy SPI.
- Wymiary panelu wynoszą około 86 mm x 50 mm
- Interfejs anteny zewnętrznej IPEX1; przed użyciem radia należy podłączyć odpowiednią antenę zewnętrzną.
docelowych użytkowników
Idealny dla programistów osadzonych, programistów IoT, twórców, zastosowań edukacyjnych/laboratoryjnych i prototypowania produktów.
2. Wygląd i rozmiar
Wymiary deski wynoszą około 86 mm × 50 mm. Poniższy diagram pomaga zidentyfikować wyświetlacz, złącza i główne komponenty.
Identyfikacja złącza
3. Specyfikacje płytek drukowanych
| rzecz | Specyfikacja |
|---|---|
| model płyty | ZLX-ESP32-2 |
| moduł podstawowy | ESP32-C5-WROOM-1U-N8R8 |
| Rozmiar deski | Około. 86 × 50 mm |
| wystawa | Wyświetlacz TFT LCD 2,8 cala, chip ST7789, oryginalna rozdzielczość 240×320 |
| Kolejność kolorów | Inicjalizacja BGR |
| Wyświetlacz odwrócony | Wyłączony/normalny tryb wyświetlania |
| dotykać | Dotyk rezystancyjny, XPT2046 |
| Gniazdo kart microSD/TF | tryb SPI; karta nie jest dołączona |
| Interfejs GPS | Złącze 4-pinowe 1,25 mm; Sygnały UART na GPIO0/GPIO9 |
| wokal | 2-pinowe złącze głośnika/audio 2,0 mm; Włączony dźwięk PWM + wzmacniacz |
| Bateria | Jednofazowe 3,7 V, podwójny pin 1,25 mm; z obwodem zabezpieczającym, zalecana pojemność 1000–3000mAh |
| Antena zewnętrzna | złącze IPEX1; wymagane dla ścieżki bezprzewodowej WROOM-1U |
| przycisk | zresetuj, zacznij |
| indeks | Zielona dioda na GPIO26 |
4. Specyfikacja modułu ESP32-C5-WROOM-1U-N8R8
Poniższe kluczowe parametry oparte są na oficjalnym arkuszu danych Espressif ESP32-C5-WROOM-1 / WROOM-1U v1.2.
| rzecz | Specyfikacja |
|---|---|
| Wbudowany układ SoC | ESP32-C5HR8 |
| Procesor | 32-bitowy, jednordzeniowy procesor RISC-V, do 240 MHz |
| ROM | 320 KB |
| HP SRAM | 384 KB |
| LP SRAM | 16 KB |
| Lampa błyskowa | 8MB poczwórny SPI |
| PSRAM | 8MB poczwórny SPI |
| Wi-Fi | 1T1R, 2,4 GHz + 5 GHz dwuzakresowy; IEEE 802.11ax/ac/b/g/n; do 150Mbps |
| Częstotliwość 2,4 GHz | 2412–2484 MHz |
| Częstotliwość 5 GHz | 5180–5885 MHz (z zastrzeżeniem przepisów regionalnych) |
| Bluetooth | Niska energia Bluetooth; Lista funkcji Espressif v1.2 zawiera certyfikat Bluetooth Core 6.0 |
| IEEE 802.15.4 | 2.4 GHz OQPSK，250 Kbps |
| Zigbee/Thread | Zigbee 3.0 / Thread 1.4 |
| GPIO | Na poziomie modułu dostępnych jest do 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 wykorzystuje niezależne oprogramowanie SPI na GPIO3/4/5/23/25.
- W przypadku napięcia akumulatora przelicz odczyt ADC GPIO1 przy użyciu współczynnika dzielnika napięcia wynoszącego około 2:1 i zastosuj kalibrację ADC w celu uzyskania większej dokładności.
- Dostępne kanały Wi-Fi 5 GHz i moc nadawania zależą od lokalnych przepisów.
- Zachowanie podczas uruchamiania/resetowania do ustawień fabrycznych jest określone przez oprogramowanie sprzętowe; należy unikać przypadkowej aktywacji, aby uniknąć wyczyszczenia ustawień.
Zalecana sekwencja inicjalizacji
- Po ustabilizowaniu się zasilania zainicjuj system i debuguj UART.
- Zainicjuj LCD SPI; skonfiguruj ST7789, BGR, wyłącz inwersję i włącz podświetlenie.
- Zainicjuj dotyk XPT2046.
- Jeśli wymagana jest pamięć wymienna, włóż kompatybilną kartę microSD/TF dostarczoną przez użytkownika, a następnie zainicjuj ją i upewnij się, że stan LCD_CS/SD_CS jest prawidłowy.
- W razie potrzeby zainicjuj GPS, audio, LED i akumulatorowy ADC.
- W razie potrzeby włącz funkcję Wi-Fi/BLE/802.15.4.
11. Rozwiązywanie problemów
| Sytuacja trudna | rozwiązanie |
|---|---|
| Pokaż pusty/czarny ekran | Sprawdź GPIO6/7/10/13/14, wybór sterownika ST7789, ustawienia BGR, podświetlenie GPIO13 i czy funkcja inwersji nie została przypadkowo włączona. |
| zły kolor | Sprawdź, czy biblioteka graficzna jest skonfigurowana pod kątem kolejności kolorów BGR. |
| Brak reakcji na dotyk | Sprawdź inicjalizację GPIO3/4/5/23/25 i XPT2046. |
| Inicjalizacja karty TF nie powiodła się | Sprawdź współdzielone SPI SCK/MOSI/MISO i upewnij się, że SD_CS (GPIO27) i LCD_CS (GPIO10) nie są ustawione w tym samym czasie. |
| Słaby sygnał Wi-Fi/brak Wi-Fi | Sprawdź, czy antena zewnętrzna IPEX1 jest podłączona i odpowiednia dla pasma 2,4/5 GHz. |
| Odczyt baterii wynosi około połowy | GPIO1 wykorzystuje dzielnik napięcia 100k/100k; pomnóż napięcie po stronie ADC przez około 2. |
| Brak danych GPS | Sprawdź, czy GPIO0 odbiera GPS TX, GPIO9 steruje GPS RX i sprawdź szybkość transmisji i moc. |
12. Pliki do pobrania i wsparcie techniczne
Aby uzyskać informacje o oprogramowaniu sprzętowym, plikach, dodatkowej dokumentacji i powiązanym wsparciu dla ZLX-ESP32-2, odwiedź Centrum wsparcia płyty rozwojowej ZLX ESP32. Przed wgraniem oprogramowania układowego upewnij się, że model PCB pokazany na stronie jest dokładnie zgodny z Twoim sprzętem.
Pobierz link:https://www.zlxchina.xyz/
Karta danych modułu Espressif: Karta danych ESP32-C5-WROOM-1 / WROOM-1U
odnieść się do
- Centrum wsparcia płyty rozwojowej ZLX ESP32
- Espressif ESP32-C5-WROOM-1 i WROOM-1U Arkusz danych v1.2 (2026-08-12)
13. Bezpieczeństwo i obsługa
- Przed podłączeniem sprawdź polaryzację baterii; nie podłączaj odwrotnie złączy akumulatora.
- Podczas podłączania lub odłączania złącza IPEX należy zastosować siłę pionową i unikać podważania z boku, aby uniknąć uszkodzenia gniazda RF.
- Podczas korzystania z odsłoniętych płytek drukowanych należy podjąć środki zabezpieczające przed wyładowaniami elektrostatycznymi i zapobiec zwarciom spowodowanym przez metalowe przedmioty.
- Pasmo radiowe 5 GHz, kanał i moc nadawania muszą być zgodne z lokalnymi przepisami.
- W przypadku kart TF, GPS, urządzeń audio i innych urządzeń peryferyjnych należy przestrzegać poziomów zasilania i logiki określonych przez rzeczywistą wersję sprzętu. Nie należy stosować poziomów logicznych wyższych niż 3,3 V do styków we/wy, chyba że zostanie to wyraźnie zweryfikowane.
14. Historia rewizji dokumentu
| kapłan | Czas | opisać | Opierać |
|---|---|---|---|
| V1.1 | 2026-08-25 | Poprawione instrukcje dotyczące kart microSD/TF, baterii i GPIO. | Hefei Zhiluxing Information Technology Co., Ltd. |
-Koniec-