1. Ürüne genel bakış / 1. Product Overview

ZLX-ESP32-2 bazlı bir üründür ESP32-C5-WROOM-1U-N8R8 Modüler 2.8 entegre renkli inç dirençli dokunmatik ekran geliştirme kartı LCD、XPT2046 dokunmak,microSD/TF Kart yuvası (yalnızca kart yuvası, dahil değildir) microSD/TF Kart),GPS Arayüz, ses çıkışı, akü voltajı algılama, yeşil LED、BOOT/RESET Düğme ve harici anten arayüzü. Uygun Wi-Fi 6、Bluetooth LE、Zigbee/Thread, insan-makine arayüzü, veri kaydı ve Nesnelerin İnterneti uygulama geliştirme.
ZLX-ESP32-2 is a 2.8-inch resistive-touch development board based on the ESP32-C5-WROOM-1U-N8R8 module. It integrates a color LCD, XPT2046 touch controller, a microSD/TF card slot (slot only; no microSD/TF card is included), GPS interface, audio output, battery-voltage sensing, green LED, BOOT/RESET buttons, and an external-antenna connector. It is suitable for Wi-Fi 6, Bluetooth LE, Zigbee/Thread, HMI, data logging, and IoT development.

Ana özellikler / Key Features

• ESP32-C5 32 Biraz RISC-V Tek çekirdekli işlemci, 240 MHz / ESP32-C5 32-bit RISC-V single-core CPU, up to 240 MHz

• ESP32-C5-WROOM-1U-N8R8：8 MB Flash + 8 MB PSRAM(Modül yerleşik kaynakları, değil microSD/TF Kart) / ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (onboard module memory, not a microSD/TF card)

• 2.4 GHz + 5 GHz Çift bant Wi-Fi 6（802.11ax） / 2.4 GHz + 5 GHz dual-band Wi-Fi 6 (802.11ax)

• Bluetooth LE、IEEE 802.15.4、Zigbee 3.0、Thread 1.4 / Bluetooth LE, IEEE 802.15.4, Zigbee 3.0, Thread 1.4

• 2.8 inç 240×320 LCD，ST7789 sürmek,BGR Başlatma, ters rengi devre dışı bırak / 2.8-inch 240×320 LCD, ST7789 driver, BGR initialization, display inversion disabled

• XPT2046 Dirençli dokunmatik kontrolör / XPT2046 resistive touch controller

• LCD Ve TF Kart paylaşımı SPI otobüs, bağımsız CS;Bağımsız yazılımı kullanmak için dokunun SPI / LCD and TF card share SPI with separate CS; touch uses an independent software SPI

• Tahta boyutu yakl. 86 mm × 50 mm / Board size approx. 86 mm × 50 mm

• IPEX1 Harici anten arayüzü; kablosuz işlevi kullanmadan önce harici antenin doğru şekilde bağlanması gerekir / IPEX1 external antenna connector; connect a suitable external antenna before radio use

Uygulanabilir nesneler / Intended Users

Gömülü geliştiriciler, IoT geliştiricileri, yapımcılar, öğretim deneyleri ve ürün prototip tasarımı için uygundur.
For embedded developers, IoT developers, makers, education/lab use, and product prototyping.

2. Görünüm ve boyut / 2. Appearance and Dimensions

Tahtanın genel boyutları yaklaşık olarak 86 mm × 50 mm. Aşağıdaki ön ve arka resimler ekranı, arayüzleri ve ana bileşenleri tanımlamak için kullanılmıştır.
The board outline is approximately 86 mm × 50 mm. The images below help identify the display, connectors, and major components.

resim 1 Ön ve ekran boyutları / Figure 1 Board front and display-side dimensions

Arayüz açıklaması / Connector Identification

resim 2 ZLX-ESP32-2 Çince ve İngilizce arayüz açıklamaları / Figure 2 Bilingual connector identification

3. Geliştirme kurulu özellikleri / 3. Board Specifications

göstermek / Note: Yerel ekran çözünürlüğü 240×320;Yazılım yatay ekran döndürmeye ayarlandığında mantıksal ekran boyutu şu şekilde ifade edilebilir: 320×240。 / The panel native resolution is 240×320; in landscape rotation, the logical display size may be 320×240.

4. ESP32-C5-WROOM-1U-N8R8 Modül parametreleri / 4. ESP32-C5-WROOM-1U-N8R8 Module Specifications

Aşağıdaki temel parametreler temel alınmıştır: Espressif resmi ESP32-C5-WROOM-1 / WROOM-1U Datasheet v1.2。
The following key parameters are based on Espressif's official ESP32-C5-WROOM-1 / WROOM-1U Datasheet v1.2.

5. Görüntüleme ve dokunma / 5. Display and Touch

LCD parametre / LCD Parameters

Dokunma parametreleri / Touch Parameters

• Dokunma türü:4 Tel Dirençli Dokunuş; Denetleyici:XPT2046。 / Touch type: 4-wire resistive; controller: XPT2046.

• DOUT=GPIO3，SCK=GPIO4，DIN=GPIO5。 / DOUT=GPIO3, SCK=GPIO4, DIN=GPIO5.

• CS=GPIO23，IRQ=GPIO25。 / CS=GPIO23, IRQ=GPIO25.

• Bağımsız yazılımı kullanmak için dokunun SPI;Algılama aracı işlemi kalibrasyon gerektirmiyor olarak işaretlendi. / Touch uses an independent software SPI; the supplied test flow is marked as requiring no calibration.

6. GPIO haritalama / 6. GPIO Mapping

Aşağıdaki eşlemeler kartla birlikte sağlanan müşteri sürümündendir GPIO Elektronik tablo ve şematik olarak kontrol edildi. Yerleşik çevre birimi kullanımı 19 Sıradan GPIO；TX0=GPIO11、RX0=GPIO12 Ayrıca şunun için kullanılır: UART0；N8R8 ile ilgili GPIO15 yorgan PSRAM bu nedenle meşgul 21 mevcut GPIO Hepsi atandı;EN İş sayılmaz GPIO。
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.

Sistem ve seri port sinyalleri / System and UART Signals

7. Arayüz ve veri yolu paylaşım talimatları / 7. Interface and Bus Sharing

SPI Dikkate alınması gereken noktaları paylaşma / SPI Sharing Notes

• LCD Ve TF Kart paylaşımı GPIO6(SCK)、GPIO7(MOSI)、GPIO2(MISO), ancak sırasıyla kullanarak GPIO10(LCD_CS) Ve GPIO27(SD_CS)。 / LCD and TF card share GPIO6 (SCK), GPIO7 (MOSI), and GPIO2 (MISO), but use GPIO10 (LCD_CS) and GPIO27 (SD_CS) respectively.

• Hedef cihazı yalnızca aynı anda etkinleştirin CSAynı anda birden fazla cihazın seçilmesinden kaynaklanan veri yolu çakışmalarını önlemek için. / Assert only the target device CS at a time to avoid bus contention.

• dokunmak XPT2046 Bağımsız yazılım kullanın SPI, ile değil LCD/TF Tanrım SPI saat ve MOSI Paylaşıldı. / The XPT2046 touch controller uses an independent software SPI and does not share the main LCD/TF SCK/MOSI signals.

8. Algılama fonksiyonu yazışmaları / 8. Functional Test Mapping

9. Arayüz ve elektriksel hususlar / 9. Connector and Electrical Notes

Pil arayüzü / Battery Connector

Geliştirme kurulu sağlandı 1.25 mm 2-Pin 3.7 V Tek pil arayüzü. İşaretli diyagramın bakış yönüne göre sol taraf pozitif elektrottur (+), sağ taraf negatif kutuptur (-). Pil gücü gerekiyorsa kapasite kullanılması önerilir 1000–3000 mAh, koruma kartlı tek bölmeli (koruma devresi) 3.7 V Lityum iyon/Lityum polimer pili takın ve bağlamadan önce arayüz özelliklerini ve pozitif ve negatif kutupları doğrulayın. Ters bağlantı, geliştirme kartına zarar verebilir.
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.

GPIO1 geçmek 100 kΩ / 100 kΩ Gerilim bölücü ağ akü voltajını algılar, dolayısıyla ideal koşullar altında gerçek akü voltajı yaklaşık olarak ADC pin voltajı 2 kez. Bu işlev yalnızca voltaj tahmini içindir, yakıt coulomb ölçeri için değildir.
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 arayüz / GPS Interface

GPS kullanmak GPIO0 Ve GPIO9 gibi UART Sinyal.GPIO0（GPSTX adlı) bu kart tanımında giriş olarak bağlanın GPS modül TX；GPIO9（GPSRX adlandırılmış) çıktı olarak bağlanın GPS modül RX。1.25 mm 4-Pin Konektörün güç pinleri ve gerçek pin sırası için lütfen ilgili donanım sürümüne bakın./Şematik diyagram geçerli olacaktır.
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.

harici anten / External Antenna

ESP32-C5-WROOM-1U Harici anten versiyonudur. pano IPEX1 Arayüzün bağlanması gerekiyor 2.4/5 GHz Frekans bandı eşleşmesi ve empedans 50 Ω anten. Uygun bir anten bağlanmadan uzun süre yüksek güçte iletim yapmayın.
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.

ses arabirimi / Audio Connector

Ses çıkışı şu şekilde sağlanır: GPIO8（AUDIOPWM)üretmek PWM sinyal,GPIO24（AMP_EN) güç amplifikatörünün etkinleştirilmesini kontrol eder; tahtanın üst kısmı 2.0 mm 2-Pin Ses/Hoparlör arayüzü. Farklı yük ve ses seviyesi ayarları için lütfen gerçek güç amplifikatörü devresi özelliklerine bakın.
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. Yazılım geliştirme ve başlatma tavsiyesi / 10. Software Development and Initialization Notes

• Sürücü seçimini görüntüle ST7789, yerel çözünürlük şu şekilde ayarlanmıştır: 240×320;Yatay ekran döndürülebilir 320×240。 / 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.

• Kullanılan renk sırası BGR;Ters renklerin görüntülenmesini etkinleştirme (INVON）。 / Use BGR color order; do not enable display inversion (INVON).

• LCD/TF paylaşmak SPI ne zaman, başlatmadan sonra ayrı olarak yönetilir LCD_CS(GPIO10) Ve SD_CS(GPIO27)。 / When LCD and TF share SPI, manage LCD_CS (GPIO10) and SD_CS (GPIO27) independently after initialization.

• XPT2046 kullanmak GPIO3/4/5/23/25 bağımsız yazılım SPI。 / XPT2046 uses an independent software SPI on GPIO3/4/5/23/25.

• Akü voltajını okurken, GPIO1 ile ilgili ADC Yaklaşık olarak sonuçlar. 2:1 Kısmi basınç oranı dönüşümü ile birlikte ADC Kalibrasyon doğruluğu artırır. / For battery voltage, convert the GPIO1 ADC reading using the approximately 2:1 divider ratio and apply ADC calibration for better accuracy.

• Wi-Fi 5 GHz Mevcut kanallar ve iletim gücü ülkeye göre değişir/Bölgesel düzenleyici kısıtlamalar. / Available 5 GHz Wi-Fi channels and transmit power depend on local regulations.

• BOOT/Fabrika geri yükleme mantığı ürün yazılımı tarafından belirlenir; Çalışma sırasında yanlış tetiklemeyi ve konfigürasyonun silinmesine neden olmayı önleyin. / BOOT/factory-restore behavior is firmware-defined; avoid unintended activation that may clear settings.

Önerilen başlatma sırası / Suggested Initialization Sequence

1. Güç kaynağı stabil hale geldikten sonra sistemi ve seri bağlantı noktasını başlatın.
After power is stable, initialize the system and debug UART.

2. başlatma LCD SPI,kurmak ST7789、BGR, ters rengi kapatın ve ardından arka ışığı açın.
Initialize LCD SPI; configure ST7789, BGR, inversion off, then enable backlight.

3. başlatma XPT2046 dokunmak.
Initialize XPT2046 touch.

4. Depolama işlevini kullanmanız gerekiyorsa lütfen kullanıcı tarafından hazırlanan uyumlu microSD/TF kartını takın, yeniden başlatın ve emin olun LCD_CS Ve SD_CS Durum doğrudur.
If removable storage is required, insert a compatible user-supplied microSD/TF card, then initialize it and ensure correct LCD_CS/SD_CS states.

5. Talep üzerine başlat GPS,ses,LED,Pil ADC。
Initialize GPS, audio, LED, and battery ADC as needed.

6. Son etkinleştirilen Wi-Fi/BLE/802.15.4 Kablosuz özellikler.
Enable Wi-Fi/BLE/802.15.4 radio functions as required.

11. Yaygın sorunları giderme / 11. Troubleshooting

12. Veri indirme ve teknik destek / 12. Downloads and Technical Support

ZLX-ESP32-2 Lütfen ürün yazılımına, dosyalara, takip bilgilerine ve ilgili desteğe öncelikli erişim verin. ZLX ESP32 Geliştirme Kurulu Oluşturucu Destek Merkezi. Firmware'i yüklemeden önce lütfen sayfada listelenenleri doğrulayın. PCB Model eldeki anakartla tamamen aynı.
For ZLX-ESP32-2 firmware, files, future documentation, and related support, use the ZLX ESP32 development-board support center. Before flashing firmware, confirm the PCB model shown on the website exactly matches your hardware.

Veri indirme / Downloads: https://www.zlxchina.xyz/

Espressif module datasheet / Espressif Modülü Özellikleri: ESP32-C5-WROOM-1 / WROOM-1U Datasheet

Referanslar / References

• ZLX ESP32 Geliştirme Kurulu Oluşturucu Destek Merkezi / ZLX ESP32 Development Board Support Center — https://www.zlxchina.xyz/

• Espressif ESP32-C5-WROOM-1 & WROOM-1U Datasheet v1.2 (2026-08-12) / Espressif ESP32-C5-WROOM-1 & WROOM-1U Datasheet v1.2 (2026-08-12) — https://espressif.com/documentation/esp32-c5-wroom-1_wroom-1u_datasheet_en.pdf

13. Kullanım ve güvenlik önlemleri / 13. Safety and Handling

• Pili bağlamadan önce pozitif ve negatif kutuplar onaylanmalıdır ve ters bağlantı yasaktır. / Verify battery polarity before connection; never reverse the battery connector.

• Tak ve çıkar IPEX RF tabanının düşmesine neden olabilecek yanal kaldırmayı önlemek için anteni bağlarken dikey kuvvet uygulayın. / When mating/unmating the IPEX connector, apply force vertically and avoid sideways prying that may damage the RF socket.

• Geliştirme kartının çıplak kartını kullanırken metal nesnelerin neden olduğu kısa devreleri önlemek için elektrostatik korumaya dikkat edin. / Use ESD precautions with the bare board and prevent metal objects from causing shorts.

• 5 GHz Kablosuz frekans bandı, kanalı ve gücü, kullanım bölgesindeki düzenlemelere uygun olmalıdır. / 5 GHz radio band, channels, and transmit power must comply with local regulations.

• TF Kart,GPSGüç kaynağı özellikleri ve ses ve video gibi çevre birimlerinin seviyeleri için lütfen gerçek donanım sürümünü takip edin. Onay almadan bizimle iletişime geçmeyin. IO yukarıda uygulanan pin 3.3 V seviye. / For TF, GPS, audio, and other peripherals, follow the actual hardware revision for supply and logic levels. Do not apply logic levels above 3.3 V to IO pins unless explicitly verified.

14. Belge sürüm kaydı / 14. Document Revision History

— End / Sona ermek -