ZLX-ESP32-2
ESP32-C5 2,8 inç dokunmatik ekran geliştirme kartı
1. Ürüne Genel Bakış
ZLX-ESP32-2, ESP32-C5-WROOM-1U-N8R8 modülünü temel alan 2,8 inç dirençli dokunmatik geliştirme kartıdır. Renkli LCD ekran, XPT2046 dokunmatik kontrol cihazı, microSD/TF kart yuvası (yalnızca kart yuvası, microSD/TF kartı dahil değildir), GPS arayüzü, ses çıkışı, pil voltajı algılama, yeşil LED göstergesi, ÖNYÜKLEME/SIFIRLAMA düğmesi ve harici anten arayüzünü entegre eder. Wi-Fi 6, Bluetooth LE, Zigbee/Thread, İnsan Makine Arayüzü (HMI), veri kaydı ve Nesnelerin İnterneti (IoT) geliştirme için uygundur.
Ana özellikler
- ESP32-C5 32 bit RISC-V tek çekirdekli CPU, 240 MHz'e kadar
- ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (yerleşik modül belleği, microSD/TF kartı değil)
- 2,4 GHz + 5 GHz çift bantlı Wi-Fi 6 (802.11ax)
- Bluetooth LE、IEEE 802.15.4、Zigbee 3.0、Thread 1.4
- 2,8 inç 240×320 LCD ekran, ST7789 sürücü çipi, BGR başlatma, ekranı ters çevirme işlevi devre dışı
- XPT2046 dirençli dokunmatik kontrol cihazı
- LCD ve TF kartı bir SPI arayüzünü paylaşır, ancak CS arayüzü farklıdır; dokunma işlevi bağımsız bir yazılım SPI arayüzünü kullanır.
- Panel boyutları yaklaşık 86mm x 50mm'dir
- IPEX1 harici anten arayüzü; lütfen radyoyu kullanmadan önce uygun bir harici anten bağlayın.
kullanıcıları hedefle
Gömülü geliştiriciler, IoT geliştiricileri, yapımcılar, eğitim/laboratuvar kullanımı ve ürün prototipleme için idealdir.
2. Görünüm ve boyut
Levha boyutları yaklaşık 86 mm × 50 mm'dir. Aşağıdaki şema ekranın, konektörlerin ve ana bileşenlerin tanımlanmasına yardımcı olur.
Bağlayıcı tanımlama
3. Devre kartı özellikleri
| şey | Şartname |
|---|---|
| plaka modeli | ZLX-ESP32-2 |
| çekirdek modül | ESP32-C5-WROOM-1U-N8R8 |
| Tahta boyutu | Yaklaşık. 86 × 50 mm |
| sergilemek | 2,8 inç TFT LCD ekran, ST7789 çip, orijinal çözünürlük 240×320 |
| renk sırası | BGR başlatma |
| Ters çevrilmiş ekran | Kapalı/normal ekran modu |
| dokunmak | Dirençli dokunma, XPT2046 |
| microSD/TF kart yuvası | SPI modu; kart dahil değildir |
| GPS arayüzü | 1,25 mm 4 pinli konnektör; GPIO0/GPIO9'da UART sinyalleri |
| vokal | 2,0 mm 2 pimli hoparlör/ses konektörü; PWM ses + amplifikatör etkin |
| Pil | 3,7V tek fazlı, 1,25 mm çift pimli; koruma devreli, önerilen kapasite 1000–3000mAh |
| harici anten | IPEX1 konektörü; WROOM-1U kablosuz yolu için gereklidir |
| düğme | sıfırlamak, başlatmak |
| indeks | GPIO26'da yeşil LED |
4. ESP32-C5-WROOM-1U-N8R8 modül özellikleri
Aşağıdaki temel parametreler Espressif'in resmi ESP32-C5-WROOM-1 / WROOM-1U veri sayfası v1.2'ye dayanmaktadır.
| şey | Şartname |
|---|---|
| Gömülü SoC | ESP32-C5HR8 |
| İşlemci | 32 bit RISC-V tek çekirdekli işlemci, 240 MHz'e kadar |
| salt okunur bellek | 320 KB |
| HP SRAM | 384 KB |
| LP SRAM | 16 KB |
| flaş | 8 MB Dörtlü SPI |
| PSRAM | 8 MB Dörtlü SPI |
| Wifi | 1T1R, 2,4 GHz + 5 GHz çift bant; IEEE 802.11ax/ac/b/g/n; 150 Mbps'ye kadar |
| 2,4 GHz frekans | 2412–2484 MHz |
| 5 GHz frekansı | 5180–5885 MHz (bölgesel düzenlemelere tabidir) |
| Bluetooth | Bluetooth Düşük Enerji; Espressif v1.2 özellik listesi Bluetooth Core 6.0 sertifikalı olduğunu gösteriyor |
| IEEE 802.15.4 | 2.4 GHz OQPSK，250 Kbps |
| Zigbee/Thread | Zigbee 3.0 / Thread 1.4 |
| GPIO | Modül düzeyinde 22'ye kadar GPIO mevcuttur. |
| 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, GPIO3/4/5/23/25'te bağımsız yazılım SPI'sini kullanır.
- Akü voltajı için, yaklaşık 2:1'lik bir voltaj bölücü oranı kullanarak GPIO1 ADC okumasını dönüştürün ve daha iyi doğruluk için ADC kalibrasyonunu uygulayın.
- Mevcut 5 GHz Wi-Fi kanalları ve iletim gücü yerel düzenlemelere bağlıdır.
- Önyükleme/fabrika ayarlarına sıfırlama davranışı ürün yazılımı tarafından tanımlanır; Ayarların silinmesini önlemek için lütfen yanlışlıkla etkinleştirmeyi önleyin.
Önerilen başlatma sırası
- Güç kaynağı stabil hale geldikten sonra sistemi başlatın ve UART'ta hata ayıklayın.
- LCD SPI'yi başlatın; ST7789, BGR'yi yapılandırın, ters çevirmeyi kapatın ve arka ışığı etkinleştirin.
- XPT2046 touch'ı başlatın.
- Çıkarılabilir depolama gerekiyorsa, kullanıcı tarafından sağlanan uyumlu bir microSD/TF kartı takın, ardından başlatın ve LCD_CS/SD_CS durumunun doğru olduğundan emin olun.
- Gerektiğinde GPS, ses, LED ve pil ADC'sini başlatın.
- Gerektiğinde Wi-Fi/BLE/802.15.4 radyo işlevini etkinleştirin.
11. Sorun Giderme
| soru | çözüm |
|---|---|
| Boş/siyah ekranı göster | GPIO6/7/10/13/14, ST7789 sürücü seçimini, BGR ayarlarını, GPIO13 arka aydınlatmasını ve ters çevirme özelliğinin yanlışlıkla etkinleştirilip etkinleştirilmediğini kontrol edin. |
| yanlış renk | Grafik kitaplığının BGR renk sırasına göre yapılandırıldığını doğrulayın. |
| Dokunma tepkisi yok | GPIO3/4/5/23/25 ve XPT2046 başlatmayı kontrol edin. |
| TF kartı başlatma işlemi başarısız oldu | Paylaşılan SPI SCK/MOSI/MISO'yu kontrol edin ve SD_CS (GPIO27) ile LCD_CS'nin (GPIO10) aynı anda ayarlanmadığından emin olun. |
| Zayıf Wi-Fi sinyali/Wi-Fi yok | IPEX1 harici anteninin bağlı olduğunu ve 2,4/5 GHz bandına uygun olduğunu doğrulayın. |
| Pil okuması yaklaşık yarı yarıya | GPIO1, 100k/100k voltaj bölücü kullanır; ADC tarafı voltajını yaklaşık 2 ile çarpın. |
| GPS verisi yok | GPIO0'un GPS TX aldığını, GPIO9'un GPS RX'i çalıştırdığını ve baud hızını ve gücünü doğrulayın. |
12. İndirmeler ve teknik destek
ZLX-ESP32-2 ürün yazılımı, dosyalar, takip belgeleri ve ilgili destek için lütfen ZLX ESP32 Geliştirme Kartı Destek Merkezini ziyaret edin. Firmware'i yüklemeden önce, web sitesinde gösterilen PCB modelinin donanımınızla tam olarak eşleştiğinden emin olun.
İndirme bağlantısı:https://www.zlxchina.xyz/
Espressif modülü veri sayfası: ESP32-C5-WROOM-1 / WROOM-1U veri sayfası
başvurmak
- ZLX ESP32 Geliştirme Kartı Destek Merkezi
- Espressif ESP32-C5-WROOM-1 ve WROOM-1U Veri Sayfası v1.2 (2026/08/12)
13. Güvenlik ve Çalıştırma
- Lütfen bağlamadan önce pil kutuplarını doğrulayın; Pil konektörlerini ters bağlamayın.
- IPEX konnektörünü takarken veya çıkarırken lütfen dikey kuvvet uygulayın ve RF soketine zarar vermemek için yanal kaldırmadan kaçının.
- Açık devre kartlarını kullanırken elektrostatik boşalmaya karşı koruyucu önlemler alın ve metal nesnelerden kaynaklanan kısa devreleri önleyin.
- 5 GHz radyo bandı, kanalı ve iletim gücü yerel düzenlemelere uygun olmalıdır.
- TF kartları, GPS, ses ve diğer çevre birimleri için lütfen gerçek donanım sürümü tarafından belirtilen güç kaynağı ve mantık seviyelerini takip edin. Açıkça doğrulanmadıkça I/O pinlerine 3,3V'tan yüksek mantık seviyeleri uygulamayın.
14. Belge revizyon geçmişi
| rahip | tarih | betimlemek | Temel |
|---|---|---|---|
| V1.1 | 2026-08-25 | Gözden geçirilmiş microSD/TF kartı, pil ve GPIO talimatları. | Hefei Zhiluxing Bilgi Teknolojisi Co, Ltd |
-Son-