ZLX-ESP32-2

ESP32-C5 2.8-inch Touch Display Development Board

Hướng dẫn sử dụng tiếng Trung và tiếng Anh / Bilingual User Manual

Model / người mẫu: ZLX-ESP32-2
Module / mô-đun: ESP32-C5-WROOM-1U-N8R8
Document Version / Phiên bản tài liệu: V1.1 | 2026-08-25

1. Tổng quan về sản phẩm / 1. Product Overview

ZLX-ESP32-2 là một sản phẩm dựa trên ESP32-C5-WROOM-1U-N8R8 Mô-đun 2.8 Bảng phát triển màn hình cảm ứng điện trở inch tích hợp màu sắc LCD、XPT2046 chạm,microSD/TF Khe cắm thẻ (chỉ có khe cắm thẻ, không bao gồm) microSD/TF thẻ),GPS Giao diện, đầu ra âm thanh, phát hiện điện áp pin, màu xanh lá cây LED、BOOT/RESET Nút và giao diện ăng-ten bên ngoài. Thích hợp Wi-Fi 6、Bluetooth LE、Zigbee/Thread, giao diện người-máy, ghi dữ liệu và phát triển ứng dụng Internet of Things.
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.

Các tính năng chính / Key Features

• ESP32-C5 32 Chút RISC-V Bộ xử lý lõi đơn, lên đến 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(Tài nguyên trên mô-đun, không phải microSD/TF Thẻ) / ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (onboard module memory, not a microSD/TF card)

• 2.4 GHz + 5 GHz Băng tần kép 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 inch 240×320 LCD，ST7789 lái xe,BGR Khởi tạo, tắt màu đảo ngược / 2.8-inch 240×320 LCD, ST7789 driver, BGR initialization, display inversion disabled

• XPT2046 Bộ điều khiển cảm ứng điện trở / XPT2046 resistive touch controller

• LCD Và TF Chia sẻ thẻ SPI xe buýt, độc lập CS;Chạm để sử dụng phần mềm độc lập SPI / LCD and TF card share SPI with separate CS; touch uses an independent software SPI

• Kích thước bảng xấp xỉ. 86 mm × 50 mm / Board size approx. 86 mm × 50 mm

• IPEX1 Giao diện ăng-ten bên ngoài; ăng-ten bên ngoài phải được kết nối chính xác trước khi sử dụng chức năng không dây / IPEX1 external antenna connector; connect a suitable external antenna before radio use

Đối tượng áp dụng / Intended Users

Thích hợp cho các nhà phát triển nhúng, nhà phát triển IoT, nhà sản xuất, giảng dạy thí nghiệm và thiết kế nguyên mẫu sản phẩm.
For embedded developers, IoT developers, makers, education/lab use, and product prototyping.

2. Ngoại hình và kích thước / 2. Appearance and Dimensions

Kích thước tổng thể của bảng là khoảng 86 mm × 50 mm. Hình ảnh mặt trước và mặt sau sau đây dùng để nhận biết màn hình, giao diện và các thành phần chính.
The board outline is approximately 86 mm × 50 mm. The images below help identify the display, connectors, and major components.

hình ảnh 1 Kích thước mặt trước và màn hình / Figure 1 Board front and display-side dimensions

Chú thích giao diện / Connector Identification

hình ảnh 2 ZLX-ESP32-2 Chú thích giao diện tiếng Trung và tiếng Anh / Figure 2 Bilingual connector identification

3. Thông số kỹ thuật của bảng phát triển / 3. Board Specifications

minh họa / Note: Độ phân giải màn hình gốc là 240×320;Khi phần mềm được đặt ở chế độ xoay màn hình ngang, kích thước hiển thị logic có thể được biểu thị bằng 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 Thông số mô-đun / 4. ESP32-C5-WROOM-1U-N8R8 Module Specifications

Các thông số chính sau đây được dựa trên Espressif chính thức 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. Hiển thị và chạm / 5. Display and Touch

LCD tham số / LCD Parameters

Thông số cảm ứng / Touch Parameters

• Kiểu cảm ứng:4 Dây cảm ứng điện trở; Bộ điều khiển: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.

• Chạm để sử dụng phần mềm độc lập SPI;Quy trình của công cụ phát hiện được đánh dấu là không cần hiệu chuẩn. / Touch uses an independent software SPI; the supplied test flow is marked as requiring no calibration.

6. GPIO lập bản đồ / 6. GPIO Mapping

Các ánh xạ sau đây là từ phiên bản khách hàng được cung cấp kèm theo bảng GPIO Bảng tính và kiểm tra dựa trên sơ đồ. Sử dụng thiết bị ngoại vi trên tàu 19 Một người bình thường GPIO；TX0=GPIO11、RX0=GPIO12 Cũng được sử dụng cho UART0；N8R8 của GPIO15 chăn bông PSRAM do đó bị chiếm đóng 21 có sẵn GPIO Tất cả được giao;EN Không được tính là công việc 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.

Tín hiệu hệ thống và cổng nối tiếp / System and UART Signals

7. Giao diện và hướng dẫn chia sẻ bus / 7. Interface and Bus Sharing

SPI Chia sẻ cân nhắc / SPI Sharing Notes

• LCD Và TF Chia sẻ thẻ GPIO6(SCK)、GPIO7(MOSI)、GPIO2(MISO), nhưng sử dụng tương ứng GPIO10(LCD_CS) Và 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.

• Chỉ kích hoạt thiết bị mục tiêu cùng một lúc CS, để tránh xung đột bus do nhiều thiết bị được chọn cùng lúc. / Assert only the target device CS at a time to avoid bus contention.

• chạm XPT2046 Sử dụng phần mềm độc lập SPI, không phải với LCD/TF Chúa ơi SPI đồng hồ và MOSI đã chia sẻ. / The XPT2046 touch controller uses an independent software SPI and does not share the main LCD/TF SCK/MOSI signals.

8. Chức năng phát hiện tương ứng / 8. Functional Test Mapping

9. Cân nhắc về giao diện và điện / 9. Connector and Electrical Notes

Giao diện pin / Battery Connector

Ban phát triển cung cấp 1.25 mm 2-Pin 3.7 V Giao diện pin đơn. Theo hướng nhìn của sơ đồ đã đánh dấu, phía bên trái là điện cực dương (+), phía bên phải là cực âm (-). Nếu cần nguồn pin thì nên sử dụng dung lượng 1000–3000 mAh, một phần có bảng bảo vệ (mạch bảo vệ) 3.7 V ion liti/Pin lithium polymer và xác nhận các thông số kỹ thuật giao diện cũng như các cực dương và cực âm trước khi kết nối. Kết nối ngược có thể làm hỏng bảng phát triển.
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 vượt qua 100 kΩ / 100 kΩ Mạng phân chia điện áp phát hiện điện áp của pin, vì vậy trong những trường hợp lý tưởng, điện áp thực tế của pin xấp xỉ ADC điện áp pin 2 lần. Chức năng này chỉ để ước tính điện áp, không phải là máy đo coulomb nhiên liệu.
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 giao diện / GPS Interface

GPS sử dụng GPIO0 Và GPIO9 BẰNG UART Tín hiệu.GPIO0（GPSTX được đặt tên) làm đầu vào trong định nghĩa bảng này, hãy kết nối GPS mô-đun TX；GPIO9（GPSRX được đặt tên) làm đầu ra, kết nối GPS mô-đun RX。1.25 mm 4-Pin Vui lòng tham khảo phiên bản phần cứng tương ứng để biết các chân nguồn và trình tự chân thực tế của đầu nối./Sơ đồ nguyên lý sẽ chiếm ưu thế.
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.

ăng-ten bên ngoài / External Antenna

ESP32-C5-WROOM-1U Đây là phiên bản ăng-ten bên ngoài. Cái bảng IPEX1 Giao diện cần được kết nối với 2.4/5 GHz Sự kết hợp băng tần và trở kháng là 50 Ω anten. Không truyền ở công suất cao trong thời gian dài mà không kết nối ăng-ten phù hợp.
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.

giao diện âm thanh / Audio Connector

Đầu ra âm thanh được cung cấp bởi GPIO8（AUDIOPWM)sản xuất PWM Tín hiệu,GPIO24（AMP_EN) điều khiển kích hoạt bộ khuếch đại công suất; phía trên cùng của bảng là 2.0 mm 2-Pin Âm thanh/Giao diện loa. Vui lòng tham khảo khả năng thực tế của mạch khuếch đại công suất để biết các cài đặt tải và âm lượng khác nhau.
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. Tư vấn khởi tạo và phát triển phần mềm / 10. Software Development and Initialization Notes

• Lựa chọn trình điều khiển hiển thị ST7789, độ phân giải gốc được đặt thành 240×320;Màn hình ngang có thể xoay sang 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.

• Thứ tự màu được sử dụng BGR;Không cho phép hiển thị màu đảo ngược (INVON）。 / Use BGR color order; do not enable display inversion (INVON).

• LCD/TF chia sẻ SPI khi nào, được quản lý riêng sau khi khởi tạo LCD_CS(GPIO10) Và SD_CS(GPIO27)。 / When LCD and TF share SPI, manage LCD_CS (GPIO10) and SD_CS (GPIO27) independently after initialization.

• XPT2046 sử dụng GPIO3/4/5/23/25 phần mềm độc lập SPI。 / XPT2046 uses an independent software SPI on GPIO3/4/5/23/25.

• Khi đọc điện áp pin, GPIO1 của ADC Kết quả xấp xỉ. 2:1 Chuyển đổi tỷ lệ áp suất riêng phần, kết hợp với ADC Hiệu chuẩn cải thiện độ chính xác. / 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 Các kênh khả dụng và công suất phát khác nhau tùy theo quốc gia/Hạn chế quy định khu vực. / Available 5 GHz Wi-Fi channels and transmit power depend on local regulations.

• BOOT/Logic khôi phục cài đặt gốc được xác định bởi phần sụn; tránh nhầm lẫn trong quá trình hoạt động và khiến cấu hình bị xóa. / BOOT/factory-restore behavior is firmware-defined; avoid unintended activation that may clear settings.

Trình tự khởi tạo được đề xuất / Suggested Initialization Sequence

1. Khởi tạo hệ thống và cổng nối tiếp sau khi nguồn điện ổn định.
After power is stable, initialize the system and debug UART.

2. khởi tạo LCD SPI,cài đặt ST7789、BGR, tắt đảo màu rồi bật đèn nền.
Initialize LCD SPI; configure ST7789, BGR, inversion off, then enable backlight.

3. khởi tạo XPT2046 chạm.
Initialize XPT2046 touch.

4. Nếu bạn cần sử dụng chức năng lưu trữ, vui lòng chèn tệp tương thích do người dùng chuẩn bị microSD/TF thẻ, khởi tạo lại và đảm bảo LCD_CS Và SD_CS Trạng thái là chính xác.
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. Khởi tạo theo yêu cầu GPS,âm thanh,LED,Ắc quy ADC。
Initialize GPS, audio, LED, and battery ADC as needed.

6. Đã bật lần cuối Wi-Fi/BLE/802.15.4 Khả năng không dây.
Enable Wi-Fi/BLE/802.15.4 radio functions as required.

11. Khắc phục sự cố thường gặp / 11. Troubleshooting

12. Tải xuống dữ liệu và hỗ trợ kỹ thuật / 12. Downloads and Technical Support

ZLX-ESP32-2 Vui lòng cấp quyền truy cập ưu tiên vào chương trình cơ sở, tệp, thông tin theo dõi và hỗ trợ liên quan. ZLX ESP32 Trung tâm Hỗ trợ Nhà sản xuất Ban Phát triển. Vui lòng xác nhận những gì được liệt kê trên trang trước khi flash firmware. PCB Mô hình này hoàn toàn giống với bảng trong tay.
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.

Tải dữ liệu xuống / Downloads: https://www.zlxchina.xyz/

Espressif module datasheet / Thông số kỹ thuật mô-đun Espressif: ESP32-C5-WROOM-1 / WROOM-1U Datasheet

Tài liệu tham khảo / References

• ZLX ESP32 Trung tâm Hỗ trợ Người tạo Ban Phát triển / 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. Cách sử dụng và biện pháp phòng ngừa an toàn / 13. Safety and Handling

• Các cực dương và cực âm phải được xác nhận trước khi kết nối pin và cấm kết nối ngược. / Verify battery polarity before connection; never reverse the battery connector.

• Cắm và rút phích cắm IPEX Giữ lực thẳng đứng khi kết nối ăng-ten để tránh sự cạy ngang có thể khiến đế RF rơi ra. / When mating/unmating the IPEX connector, apply force vertically and avoid sideways prying that may damage the RF socket.

• Khi sử dụng bảng trần của bảng phát triển, hãy chú ý bảo vệ tĩnh điện để tránh đoản mạch do vật kim loại gây ra. / Use ESD precautions with the bare board and prevent metal objects from causing shorts.

• 5 GHz Băng tần, kênh và nguồn không dây phải tuân thủ các quy định tại khu vực sử dụng. / 5 GHz radio band, channels, and transmit power must comply with local regulations.

• TF Thẻ,GPSVui lòng theo dõi phiên bản phần cứng thực tế để biết khả năng cấp nguồn và mức độ của các thiết bị ngoại vi như âm thanh và video. Đừng liên hệ với chúng tôi mà không có xác nhận. IO pin được áp dụng ở trên 3.3 V mức độ. / 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. Bản ghi phiên bản tài liệu / 14. Document Revision History

— End / Hoàn thành -