ZLX-ESP32-2
Papan pengembangan layar sentuh ESP32-C5 2,8 inci
1. Ikhtisar Produk
ZLX-ESP32-2 adalah papan pengembangan sentuh resistif 2,8 inci berdasarkan modul ESP32-C5-WROOM-1U-N8R8. Ini mengintegrasikan layar LCD berwarna, pengontrol sentuh XPT2046, slot kartu microSD/TF (hanya slot kartu, kartu microSD/TF tidak termasuk), antarmuka GPS, output audio, deteksi tegangan baterai, indikator LED hijau, tombol BOOT/RESET, dan antarmuka antena eksternal. Cocok untuk Wi-Fi 6, Bluetooth LE, Zigbee/Thread, Human Machine Interface (HMI), pencatatan data, dan pengembangan Internet of Things (IoT).
Fitur utama
- CPU inti tunggal ESP32-C5 32-bit RISC-V, hingga 240 MHz
- ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (memori modul terpasang, bukan kartu microSD/TF)
- Wi-Fi 6 pita ganda 2,4GHz + 5GHz (802.11ax)
- Bluetooth LE、IEEE 802.15.4、Zigbee 3.0、Thread 1.4
- Layar LCD 2,8 inci 240×320, chip driver ST7789, inisialisasi BGR, fungsi inversi tampilan dinonaktifkan
- Pengontrol sentuh resistif XPT2046
- LCD dan kartu TF berbagi antarmuka SPI, tetapi antarmuka CS berbeda; fungsi sentuh menggunakan antarmuka SPI perangkat lunak independen.
- Dimensi panel kira-kira 86mm x 50mm
- Antarmuka antena eksternal IPEX1; harap sambungkan antena eksternal yang sesuai sebelum menggunakan radio.
pengguna sasaran
Ideal untuk pengembang tertanam, pengembang IoT, pembuat, penggunaan pendidikan/lab, dan pembuatan prototipe produk.
2. Penampilan dan ukuran
Dimensi papan kira-kira 86 mm × 50 mm. Diagram berikut membantu mengidentifikasi layar, konektor, dan komponen utama.
Identifikasi konektor
3. Spesifikasi papan sirkuit
| benda | Spesifikasi |
|---|---|
| model piring | ZLX-ESP32-2 |
| modul inti | ESP32-C5-WROOM-1U-N8R8 |
| Ukuran papan | Kira-kira. 86×50mm |
| pameran | Layar LCD TFT 2,8 inci, chip ST7789, resolusi asli 240×320 |
| urutan warna | Inisialisasi BGR |
| Tampilan terbalik | Mode tampilan mati/normal |
| menyentuh | Sentuhan resistif, XPT2046 |
| slot kartu microSD/TF | Modus SPI; kartu tidak termasuk |
| Antarmuka GPS | konektor 4-pin 1,25 mm; Sinyal UART pada GPIO0/GPIO9 |
| vokal | Konektor speaker/audio 2-pin 2,0 mm; Audio PWM + penguat diaktifkan |
| Baterai | Fase tunggal 3.7V, pin ganda 1.25mm; dengan sirkuit perlindungan, kapasitas yang disarankan 1000–3000mAh |
| antena eksternal | konektor IPEX1; diperlukan untuk jalur nirkabel WROOM-1U |
| tombol | atur ulang, mulai |
| indeks | LED hijau pada GPIO26 |
4. Spesifikasi modul ESP32-C5-WROOM-1U-N8R8
Parameter utama berikut didasarkan pada lembar data resmi Espressif ESP32-C5-WROOM-1 / WROOM-1U v1.2.
| benda | Spesifikasi |
|---|---|
| SoC yang tertanam | ESP32-C5HR8 |
| CPU | Prosesor inti tunggal RISC-V 32-bit, hingga 240 MHz |
| memori hanya baca | 320 KB |
| HP SRAM | 384 KB |
| LP SRAM | 16 KB |
| kilatan | 8 MB Quad SPI |
| PSRAM | 8 MB Quad SPI |
| Wi-Fi | 1T1R, pita ganda 2,4GHz + 5GHz; IEEE 802.11ax/ac/b/g/n; hingga 150Mbps |
| Frekuensi 2,4Ghz | 2412–2484 MHz |
| frekuensi 5Ghz | 5180–5885 MHz (sesuai peraturan daerah) |
| Bluetooth | Bluetooth Hemat Energi; Daftar fitur Espressif v1.2 menunjukkan sertifikasi Bluetooth Core 6.0 |
| IEEE 802.15.4 | 2.4 GHz OQPSK，250 Kbps |
| Zigbee/Thread | Zigbee 3.0 / Thread 1.4 |
| GPIO | Hingga 22 GPIO tersedia di tingkat modul. |
| 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 menggunakan perangkat lunak independen SPI pada GPIO3/4/5/23/25.
- Untuk tegangan baterai, ubah pembacaan ADC GPIO1 menggunakan rasio pembagi tegangan sekitar 2:1 dan terapkan kalibrasi ADC untuk akurasi yang lebih baik.
- Tersedia saluran Wi-Fi 5 GHz dan daya pancar bergantung pada peraturan setempat.
- Perilaku boot/reset pabrik ditentukan oleh firmware; harap hindari aktivasi yang tidak disengaja untuk menghindari penghapusan pengaturan.
Urutan inisialisasi yang disarankan
- Setelah catu daya stabil, inisialisasi sistem dan debug UART.
- Inisialisasi LCD SPI; konfigurasikan ST7789, BGR, matikan inversi, dan aktifkan lampu latar.
- Inisialisasi sentuhan XPT2046.
- Jika penyimpanan yang dapat dilepas diperlukan, masukkan kartu microSD/TF kompatibel yang disediakan pengguna, lalu inisialisasi dan pastikan status LCD_CS/SD_CS sudah benar.
- Inisialisasi GPS, audio, LED, dan ADC baterai sesuai kebutuhan.
- Aktifkan fungsionalitas radio Wi-Fi/BLE/802.15.4 sesuai kebutuhan.
11. Pemecahan masalah
| pertanyaan | larutan |
|---|---|
| Tampilkan layar kosong/hitam | Periksa GPIO6/7/10/13/14, pemilihan driver ST7789, pengaturan BGR, lampu latar GPIO13, dan apakah fitur inversi diaktifkan secara tidak sengaja. |
| warna yang salah | Verifikasi bahwa perpustakaan grafis dikonfigurasi untuk urutan warna BGR. |
| Tidak ada respons sentuhan | Periksa inisialisasi GPIO3/4/5/23/25 dan XPT2046. |
| Inisialisasi kartu TF gagal | Periksa SPI SCK/MOSI/MISO yang dibagikan dan pastikan SD_CS (GPIO27) dan LCD_CS (GPIO10) tidak disetel secara bersamaan. |
| Sinyal Wi-Fi lemah/tidak ada Wi-Fi | Pastikan antena eksternal IPEX1 tersambung dan cocok untuk pita 2.4/5 GHz. |
| Pembacaan baterai sekitar setengahnya | GPIO1 menggunakan pembagi tegangan 100k/100k; kalikan tegangan samping ADC dengan kira-kira 2. |
| Tidak ada data GPS | Verifikasi bahwa GPIO0 menerima GPS TX, GPIO9 menggerakkan GPS RX, dan memverifikasi baud rate dan daya. |
12. Download dan dukungan teknis
Untuk firmware ZLX-ESP32-2, file, dokumentasi tindak lanjut, dan dukungan terkait, silakan kunjungi Pusat Dukungan Papan Pengembangan ZLX ESP32. Sebelum menginstal firmware, pastikan untuk memastikan bahwa model PCB yang ditampilkan di situs web sama persis dengan perangkat keras Anda.
Tautan unduhan:https://www.zlxchina.xyz/
Lembar data modul espressif: lembar data ESP32-C5-WROOM-1 / WROOM-1U
lihat
- Pusat Dukungan Papan Pengembangan ZLX ESP32
- Lembar Data Espressif ESP32-C5-WROOM-1 & WROOM-1U v1.2 (12-08-2026)
13. Keselamatan dan Pengoperasian
- Harap konfirmasi polaritas baterai sebelum menghubungkan; jangan sambungkan konektor baterai secara terbalik.
- Saat mencolokkan atau mencabut konektor IPEX, berikan gaya vertikal dan hindari mencungkil ke samping untuk menghindari kerusakan pada soket RF.
- Saat menggunakan papan sirkuit terbuka, lakukan tindakan perlindungan terhadap pelepasan muatan listrik statis dan cegah korsleting yang disebabkan oleh benda logam.
- Pita radio 5 GHz, saluran dan daya pancarnya harus mematuhi peraturan setempat.
- Untuk kartu TF, GPS, audio, dan periferal lainnya, ikuti tingkat catu daya dan logika yang ditentukan oleh versi perangkat keras sebenarnya. Jangan menerapkan level logika yang lebih tinggi dari 3,3V ke pin I/O kecuali diverifikasi secara eksplisit.
14. Riwayat revisi dokumen
| pendeta | tanggal | menggambarkan | Basis |
|---|---|---|---|
| V1.1 | 2026-08-25 | Revisi kartu microSD/TF, baterai dan instruksi GPIO. | Hefei Zhiluxing Teknologi Informasi Co., Ltd. |
-Akhir-