1. نظرة عامة على المنتج / 1. Product Overview

ZLX-ESP32-2 هو منتج يعتمد على ESP32-C5-WROOM-1U-N8R8 وحدات 2.8 لوحة تطوير شاشة تعمل باللمس مقاومة بوصة مع لون متكامل LCD、XPT2046 يلمس،microSD/TF فتحة للبطاقات (فتحة للبطاقات فقط، غير متضمنة). microSD/TF بطاقة)،GPS واجهة، إخراج الصوت، كشف جهد البطارية، أخضر LED、BOOT/RESET زر وواجهة هوائي خارجي. مناسب Wi-Fi 6、Bluetooth LE、Zigbee/Threadوالواجهة بين الإنسان والآلة وتسجيل البيانات وتطوير تطبيقات إنترنت الأشياء.
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.

الميزات الرئيسية / Key Features

• ESP32-C5 32 قليل RISC-V معالج أحادي النواة يصل إلى 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(وحدة الموارد على متن الطائرة، وليس microSD/TF بطاقة) / ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (onboard module memory, not a microSD/TF card)

• 2.4 GHz + 5 GHz الفرقة المزدوجة 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 بوصة 240×320 LCD，ST7789 يقود،BGR التهيئة، تعطيل اللون العكسي / 2.8-inch 240×320 LCD, ST7789 driver, BGR initialization, display inversion disabled

• XPT2046 تحكم باللمس مقاوم / XPT2046 resistive touch controller

• LCD و TF مشاركة البطاقة SPI حافلة مستقلة CS؛المس لاستخدام برنامج مستقل SPI / LCD and TF card share SPI with separate CS; touch uses an independent software SPI

• حجم اللوحة تقريبًا. 86 mm × 50 mm / Board size approx. 86 mm × 50 mm

• IPEX1 واجهة الهوائي الخارجي؛ يجب توصيل الهوائي الخارجي بشكل صحيح قبل استخدام الوظيفة اللاسلكية / IPEX1 external antenna connector; connect a suitable external antenna before radio use

الكائنات القابلة للتطبيق / Intended Users

مناسب للمطورين المدمجين ومطوري إنترنت الأشياء والصانعين وتجارب التدريس وتصميم النموذج الأولي للمنتج.
For embedded developers, IoT developers, makers, education/lab use, and product prototyping.

2. المظهر والحجم / 2. Appearance and Dimensions

الأبعاد الكلية للمجلس تقريبًا 86 mm × 50 mm. يتم استخدام الصور الأمامية والخلفية التالية للتعرف على الشاشة والواجهات والمكونات الرئيسية.
The board outline is approximately 86 mm × 50 mm. The images below help identify the display, connectors, and major components.

صورة 1 الأبعاد الأمامية والشاشة / Figure 1 Board front and display-side dimensions

شرح الواجهة / Connector Identification

صورة 2 ZLX-ESP32-2 التعليقات التوضيحية للواجهة الصينية والإنجليزية / Figure 2 Bilingual connector identification

3. مواصفات مجلس التنمية / 3. Board Specifications

يوضح / Note: دقة الشاشة الأصلية هي 240×320؛عندما يتم ضبط البرنامج على تدوير الشاشة أفقيًا، يمكن التعبير عن حجم العرض المنطقي كـ 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 معلمات الوحدة / 4. ESP32-C5-WROOM-1U-N8R8 Module Specifications

تعتمد المعلمات الرئيسية التالية على Espressif رسمي 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. العرض واللمس / 5. Display and Touch

LCD المعلمة / LCD Parameters

معلمات اللمس / Touch Parameters

• نوع اللمس:4 لمسة سلكية مقاومة؛ المراقب المالي: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.

• المس لاستخدام برنامج مستقل SPI؛ تم وضع علامة على عملية أداة الكشف على أنها لا تتطلب المعايرة. / Touch uses an independent software SPI; the supplied test flow is marked as requiring no calibration.

6. GPIO رسم الخرائط / 6. GPIO Mapping

التعيينات التالية مأخوذة من إصدار العميل المتوفر مع اللوحة GPIO جدول البيانات وفحصه مقابل التخطيطي. الاستخدام المحيطي على متن الطائرة 19 عادية GPIO；TX0=GPIO11、RX0=GPIO12 تستخدم أيضا ل UART0；N8R8 ل GPIO15 لحاف PSRAM المحتلة، لذلك 21 متاح GPIO تم تعيين كل شيء؛EN لا يعتبر عملا 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.

إشارات النظام والمنفذ التسلسلي / System and UART Signals

7. تعليمات مشاركة الواجهة والحافلة / 7. Interface and Bus Sharing

SPI اعتبارات المشاركة / SPI Sharing Notes

• LCD و TF مشاركة البطاقة GPIO6(SCK)、GPIO7(MOSI)、GPIO2(MISO)ولكن باستخدام على التوالي GPIO10(LCD_CS) و 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.

• قم بتمكين الجهاز المستهدف فقط في نفس الوقت CS، لتجنب تعارضات الناقل الناتجة عن تحديد أجهزة متعددة في نفس الوقت. / Assert only the target device CS at a time to avoid bus contention.

• يلمس XPT2046 استخدام البرامج المستقلة SPIوليس مع LCD/TF رب SPI الساعة و MOSI مشترك. / The XPT2046 touch controller uses an independent software SPI and does not share the main LCD/TF SCK/MOSI signals.

8. مراسلات وظيفة الكشف / 8. Functional Test Mapping

9. واجهة والاعتبارات الكهربائية / 9. Connector and Electrical Notes

واجهة البطارية / Battery Connector

مجلس التنمية المقدمة 1.25 mm 2-Pin 3.7 V واجهة بطارية واحدة. وفقًا لاتجاه العرض في الرسم التخطيطي المحدد، فإن الجانب الأيسر هو القطب الموجب (+) ، الجانب الأيمن هو القطب السالب (-). إذا كانت طاقة البطارية مطلوبة، فمن المستحسن استخدام السعة 1000–3000 mAhقسم واحد مع لوحة الحماية (دائرة الحماية) 3.7 V أيون الليثيوم/بطارية ليثيوم بوليمر، والتأكد من مواصفات الواجهة والأقطاب الإيجابية والسلبية قبل التوصيل. قد يؤدي الاتصال العكسي إلى إتلاف لوحة التطوير.
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 يمر 100 kΩ / 100 kΩ تكتشف شبكة مقسم الجهد جهد البطارية، لذلك في الظروف المثالية يكون جهد البطارية الفعلي تقريبًا ADC دبوس الجهد 2 مرات. هذه الوظيفة مخصصة فقط لتقدير الجهد، وليست مقياس كولوم الوقود.
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 واجهة / GPS Interface

GPS يستخدم GPIO0 و GPIO9 مثل UART إشارة.GPIO0（GPSTX اسمه) كمدخل في تعريف اللوحة هذا، قم بالاتصال GPS وحدة TX；GPIO9（GPSRX اسمه) كإخراج، الاتصال GPS وحدة RX。1.25 mm 4-Pin يرجى الرجوع إلى إصدار الأجهزة المقابل لمعرفة دبابيس الطاقة وتسلسل الدبوس الفعلي للموصل./يجب أن يسود الرسم التخطيطي.
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 إنه إصدار الهوائي الخارجي. سبورة IPEX1 يجب أن تكون الواجهة متصلة 2.4/5 GHz مطابقة نطاق التردد والمقاومة هي 50 Ω هوائي. لا تقم بالإرسال بقدرة عالية لفترة طويلة دون توصيل هوائي مناسب.
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

يتم توفير إخراج الصوت بواسطة GPIO8（AUDIOPWM)ينتج PWM إشارة،GPIO24（AMP_EN) يتحكم في تمكين مضخم الطاقة؛ الجزء العلوي من اللوحة هو 2.0 mm 2-Pin صوتي/واجهة مكبر الصوت. يرجى الرجوع إلى إمكانيات دائرة مضخم الطاقة الفعلية لإعدادات الحمل ومستوى الصوت المختلفة.
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. تطوير البرمجيات والمشورة التهيئة / 10. Software Development and Initialization Notes

• عرض اختيار السائق ST7789، تم ضبط الدقة الأصلية على 240×320؛ يمكن تدوير الشاشة الأفقية إلى 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.

• ترتيب الألوان المستخدم BGR؛لا تقم بتمكين عرض الألوان العكسية (INVON）。 / Use BGR color order; do not enable display inversion (INVON).

• LCD/TF يشارك SPI متى، تدار بشكل منفصل بعد التهيئة LCD_CS(GPIO10) و SD_CS(GPIO27)。 / When LCD and TF share SPI, manage LCD_CS (GPIO10) and SD_CS (GPIO27) independently after initialization.

• XPT2046 يستخدم GPIO3/4/5/23/25 برامج مستقلة SPI。 / XPT2046 uses an independent software SPI on GPIO3/4/5/23/25.

• عند قراءة جهد البطارية GPIO1 ل ADC النتائج تقريبا. 2:1 تحويل نسبة الضغط الجزئي، جنبا إلى جنب مع ADC تعمل المعايرة على تحسين الدقة. / 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 تختلف القنوات المتاحة وقوة الإرسال حسب البلد/القيود التنظيمية الإقليمية. / Available 5 GHz Wi-Fi channels and transmit power depend on local regulations.

• BOOT/يتم تحديد منطق استعادة المصنع بواسطة البرامج الثابتة؛ تجنب الخطأ أثناء التشغيل والتسبب في مسح التكوين. / BOOT/factory-restore behavior is firmware-defined; avoid unintended activation that may clear settings.

تسلسل التهيئة الموصى به / Suggested Initialization Sequence

1. قم بتهيئة النظام والمنفذ التسلسلي بعد استقرار مصدر الطاقة.
After power is stable, initialize the system and debug UART.

2. التهيئة LCD SPI،يثبت ST7789、BGR، قم بإيقاف تشغيل اللون العكسي، ثم قم بتشغيل الإضاءة الخلفية.
Initialize LCD SPI; configure ST7789, BGR, inversion off, then enable backlight.

3. التهيئة XPT2046 يلمس.
Initialize XPT2046 touch.

4. إذا كنت بحاجة إلى استخدام وظيفة التخزين، يرجى إدخال المتوافقة التي أعدها المستخدم microSD/TF البطاقة وإعادة التهيئة والتأكد LCD_CS و SD_CS الوضع صحيح.
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. التهيئة عند الطلب GPS،صوتي،LED،بطارية ADC。
Initialize GPS, audio, LED, and battery ADC as needed.

6. آخر تمكين Wi-Fi/BLE/802.15.4 القدرات اللاسلكية.
Enable Wi-Fi/BLE/802.15.4 radio functions as required.

11. استكشاف الأخطاء وإصلاحها المشاكل الشائعة / 11. Troubleshooting

12. تنزيل البيانات والدعم الفني / 12. Downloads and Technical Support

ZLX-ESP32-2 يرجى منح الأولوية للوصول إلى البرامج الثابتة والملفات ومعلومات المتابعة والدعم ذي الصلة. ZLX ESP32 مركز دعم صانع مجلس التنمية. يرجى التأكد من ما هو مدرج في الصفحة قبل وميض البرنامج الثابت. PCB النموذج هو بالضبط نفس اللوحة الموجودة في متناول اليد.
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.

تنزيل البيانات / Downloads: https://www.zlxchina.xyz/

Espressif module datasheet / مواصفات وحدة Espressif: ESP32-C5-WROOM-1 / WROOM-1U Datasheet

مراجع / References

• ZLX ESP32 مركز دعم صانع مجلس التنمية / 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. احتياطات الاستخدام والسلامة / 13. Safety and Handling

• يجب التأكد من الأقطاب الإيجابية والسلبية قبل توصيل البطارية، ويحظر الاتصال العكسي. / Verify battery polarity before connection; never reverse the battery connector.

• التوصيل والفصل IPEX حافظ على القوة الرأسية عند توصيل الهوائي لتجنب التحريك الجانبي الذي قد يتسبب في سقوط قاعدة التردد اللاسلكي. / When mating/unmating the IPEX connector, apply force vertically and avoid sideways prying that may damage the RF socket.

• عند استخدام اللوحة العارية للوحة التطوير، انتبه إلى الحماية الكهروستاتيكية لتجنب الدوائر القصيرة التي تسببها الأجسام المعدنية. / Use ESD precautions with the bare board and prevent metal objects from causing shorts.

• 5 GHz يجب أن يتوافق نطاق التردد اللاسلكي والقناة والطاقة مع اللوائح المعمول بها في منطقة الاستخدام. / 5 GHz radio band, channels, and transmit power must comply with local regulations.

• TF بطاقة،GPSيرجى اتباع إصدار الأجهزة الفعلي لمعرفة إمكانيات إمداد الطاقة ومستويات الأجهزة الطرفية مثل الصوت والفيديو. لا تتصل بنا دون تأكيد. IO دبوس مطبق أعلاه 3.3 V مستوى. / 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. سجل إصدار الوثيقة / 14. Document Revision History

— End / ينهي -