ZLX-ESP32-2
لوحة تطوير شاشة اللمس ESP32 - C5 2.8 بوصة
1. نظرة عامة على المنتج
ZLX - ESP32 -2 عبارة عن لوحة تطوير تعمل باللمس مقاوم 2.8 بوصة تعتمد على وحدة ESP32 - C5 - WROOM -1U - N8R8. إنه يدمج شاشة LCD ملونة، ووحدة تحكم تعمل باللمس XPT2046، وفتحة بطاقة microSD/TF (فتحة البطاقة فقط، باستثناء بطاقة microSD/TF)، وواجهة GPS، وإخراج الصوت، واكتشاف جهد البطارية، ومؤشر LED الأخضر، وزر التمهيد/إعادة الضبط، وواجهة الهوائي الخارجية. وهي مناسبة لشبكة Wi - Fi 6 و Bluetooth LE و Zigbee/Thread وواجهة الجهاز البشري (HMI) وتسجيل البيانات وتطوير إنترنت الأشياء (IoT).
الميزات الرئيسية
- وحدة المعالجة المركزية أحادية النواة ESP32 - C5 32 بت RISC - V @ 240 ميجاهرتز
- ESP32 - C5 - WROOM -1U - N8R8: فلاش 8 ميجابايت + PSRAM 8 ميجابايت (ذاكرة وحدة مدمجة، بطاقة غير microSD/TF)
- 2.4 جيجا هرتز + 5 جيجا هرتز واي فاي مزدوج النطاق 6 (802.11ax)
- Bluetooth LE、IEEE 802.15.4、Zigbee 3.0、Thread 1.4
- 2.8 بوصة 240 × 320 شاشة LCD، رقاقة تشغيل ST7789، تهيئة BGR، وظيفة عكس الشاشة معطلة
- جهاز التحكم باللمس المقاوم XPT2046
- تشترك بطاقة LCD و TF في واجهة SPI واحدة، لكن واجهة CS مختلفة ؛ تستخدم وظيفة اللمس واجهة SPI منفصلة للبرنامج.
- حجم الورقة حوالي 86 مم × 50 مم
- واجهة الهوائي الخارجي IPEX1 ؛ قم بتوصيل الهوائي الخارجي المناسب قبل استخدام الراديو.
المستخدم المستهدف
للمطورين المضمنين، ومطوري إنترنت الأشياء، والصناع، والاستخدامات التعليمية/المختبرية، والنماذج الأولية للمنتجات.
2. المظهر والأبعاد
يبلغ حجم اللوحة حوالي 86 مم × 50 مم. تساعد الصورة أدناه على تحديد الشاشة والموصلات والمكونات الرئيسية.
تعريف الموصل
3. مواصفات لوحة الدوائر
| الأصناف | ● المواصفات |
|---|---|
| نموذج اللوحة | ZLX-ESP32-2 |
| الوحدات الأساسية | ESP32-C5-WROOM-1U-N8R8 |
| حجم اللوحة | 86 × 50 ملم تقريبًا |
| عرض | شاشة TFT LCD مقاس 2.8 بوصة، رقاقة ST7789، دقة أصلية 240 × 320 |
| ترتيب الألوان | تهيئة BGR |
| عرض المعكوس | وضع إيقاف التشغيل/العرض العادي |
| اللمس | لمسة مقاومة XPT2046 |
| فتحة بطاقة microSD/TF | وضع SPI ؛ البطاقة غير مشمولة |
| واجهة نظام تحديد المواقع العالمي (GPS | موصل رباعي المسامير 1.25 مم ؛ إشارة UART على GPIO0/GPIO9 |
| صوتي | 2.0 مم مكبر صوت/موصل صوت ثنائي السنون ؛ صوت PWM + مكبر للصوت ممكّن |
| بطارية | 3.7 فولت طور واحد، 1.25 مم دبوس مزدوج ؛ مع دائرة حماية، السعة الموصى بها 1000-3000 مللي أمبير في الساعة |
| هوائي خارجي | موصل IPEX1 ؛ مطلوب لمسار WROOM -1U اللاسلكي |
| أسلوب الأزرار | إعادة التعيين، بدء التشغيل |
| المؤشــر | مؤشر LED أخضر على GPIO26 |
4. مواصفات وحدة ESP32 - C5 - WROOM -1U - N8R8
تستند المعلمات الرئيسية التالية إلى ورقة بيانات إسبرسيف الرسمية ESP32 - C5 - WROOM -1/WROOM -1U v1.2.
| الأصناف | ● المواصفات |
|---|---|
| قواعد العمليات الموحدة المضمنة | ESP32-C5HR8 |
| وحدات المعالجة المركزية | معالج RISC - V أحادي النواة 32 بت بسرعة تصل إلى 240 ميجاهرتز |
| قراءة الذاكرة فقط | 320 KB |
| HP SRAM | 384 KB |
| LP SRAM | 16 KB |
| فلاش | 8 ميجابايت رباعي القناة SPI |
| PSRAM | 8 ميجابايت رباعي القناة SPI |
| واي فاي | 1T1R، 2.4 جيجا هرتز + 5 جيجا هرتز نطاق مزدوج ؛ IEEE 802.11ax/ac/b/g/n ؛ حتى 150 ميغابت في الثانية |
| تردد 2.4 جيجاهرتز | 2412–2484 MHz |
| تردد 5 جيجاهرتز | 5180–5885 ميغاهيرتز (تخضع للوائح المحلية) |
| بلوتوث | Bluetooth Low Energy ؛ تعرض قائمة ميزات Espressif v1.2 شهادة Bluetooth Core 6.0 المعتمدة |
| IEEE 802.15.4 | 2.4 GHz OQPSK，250 Kbps |
| Zigbee/Thread | Zigbee 3.0 / Thread 1.4 |
| GPIO | يتوفر ما يصل إلى 22 GPIOs على مستوى الوحدة. |
| 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 برنامج مستقل SPI على GPIO3/4/5/23/25.
- بالنسبة لجهد البطارية، قم بتحويل قراءات GPIO1 ADC باستخدام نسبة جهد جزئي تبلغ 2: 1 تقريبًا وقم بتطبيق معايرة ADC للحصول على دقة أعلى.
- تعتمد قنوات Wi - Fi المتاحة بسرعة 5 جيجاهرتز وقوة الإرسال على اللوائح المحلية.
- يتم تحديد سلوك بدء/استعادة إعدادات المصنع بواسطة البرنامج الثابت ؛ يرجى تجنب التنشيط العرضي لتجنب مسح الإعدادات.
ترتيب التهيئة المقترح
- عندما تكون الطاقة مستقرة، قم بتهيئة النظام وقم بتصحيح UART.
- تهيئة شاشة LCD SPI ؛ تكوين ST7789، BGR، إيقاف الانقلاب، وتمكين الإضاءة الخلفية.
- قم بتهيئة لمسة XPT2046.
- إذا كان التخزين القابل للإزالة مطلوبًا، فأدخل بطاقة microSD/TF متوافقة مع المستخدم، ثم قم بتهيئتها وتأكد من صحة حالة LCD_CS/SD_CS.
- قم بتهيئة نظام تحديد المواقع العالمي (GPS)، والصوت، ومصابيح LED، وADCs للبطارية حسب الحاجة.
- قم بتمكين راديو Wi - Fi/BLE/802.15.4 حسب الحاجة.
11. استكشاف الأخطاء وإصلاحها
| المسائل | الحلول |
|---|---|
| عرض شاشة فارغة/سوداء | تحقق من GPIO6/7/10/13/14، واختيار محرك الأقراص ST7789، وإعدادات BGR، والإضاءة الخلفية GPIO13، وإذا تم تمكين الانقلاب عن طريق الخطأ. |
| خطأ في اللون | تحقق من تكوين مكتبة الرسومات لترتيب ألوان BGR. |
| لا توجد استجابة باللمس | تحقق من تهيئة GPIO3/4/5/23/25 و XPT2046. |
| فشل تهيئة بطاقة TF | تحقق من SPI SCK/MOSI/MISO المشتركة وتأكد من عدم ضبط SD_CS (GPIO27) و LCD_CS (GPIO10) في نفس الوقت. |
| إشارة Wi - Fi ضعيفة/لا توجد شبكة Wi - Fi | تحقق من أن الهوائي الخارجي IPEX1 متصل ويعمل في نطاق 2.4/5 جيجاهرتز. |
| حوالي نصف قراءات البطارية | يستخدم GPIO1 فاصل جهد 100k/100k ؛ اضرب الجهد الجانبي لـ ADC بحوالي 2. |
| لا توجد بيانات GPS | تحقق من أن GPIO0 يتلقى GPS TX، ويقوم GPIO9 بتشغيل GPS RX، والتحقق من معدل الباود وإمدادات الطاقة. |
12. التنزيلات والدعم الفني
للحصول على البرنامج الثابت ZLX - ESP32 -2 والوثائق ووثائق المتابعة والدعم ذي الصلة، قم بزيارة مركز دعم مجلس تطوير ZLX ESP32. قبل وميض البرنامج الثابت، تأكد من أن طراز PCB الموضح على موقع الويب يتطابق تمامًا مع أجهزتك.
رابط التحميلhttps://www.zlxchina.xyz/
ورقة بيانات وحدة ليكسين: ESP32 - C5 - WROOM -1/WROOM -1U ورقة بيانات
المراجع
- مركز دعم مجلس تطوير ZLX ESP32
- إسبرسيف ESP32 - C5 - WROOM -1 & WROOM -1U ورقة بيانات الإصدار 1.2 (2026-08-12)
13. السلامة والتشغيل
- تحقق من قطبية البطارية قبل التوصيل ؛ لا تقم أبدًا بعكس موصل البطارية.
- عند توصيل موصل IPEX وفصله، قم بتطبيق القوة عموديًا وتجنب التحريك الجانبي لتجنب إتلاف مقبس التردد اللاسلكي.
- عند استخدام لوحات الدوائر المكشوفة، اتخذ تدابير حماية التفريغ الكهروستاتيكي ومنع الدوائر القصيرة التي تسببها الأجسام المعدنية.
- يجب أن تتوافق نطاقات الراديو والقنوات وقوة الإرسال 5 جيجاهرتز مع اللوائح المحلية.
- بالنسبة لبطاقات TF و GPS والصوت والأجهزة الطرفية الأخرى، اتبع مستويات الطاقة والمنطق المحددة في إصدار الأجهزة الفعلي. لا تطبق مستوى منطق أعلى من 3.3 فولت على دبابيس الإدخال/الإخراج ما لم يتم التحقق منها صراحة.
14. تاريخ مراجعة الوثيقة
| كاهن | التاريخ /................................. | الوصف | أساس (بناء) |
|---|---|---|---|
| V1.1 | 2026-08-25 | تعليمات منقحة لبطاقات microSD/TF والبطاريات و GPIO. | شركة Hefei Zhiluxing Information Technology Co.، Ltd. |
-انتهى-