ZLX-ESP32-2
Bảng phát triển màn hình cảm ứng 2,8 inch ESP32-C5
1. Tổng quan về sản phẩm
ZLX-ESP32-2 là bảng phát triển cảm ứng điện trở 2,8 inch dựa trên mô-đun ESP32-C5-WROOM-1U-N8R8. Nó tích hợp màn hình LCD màu, bộ điều khiển cảm ứng XPT2046, khe cắm thẻ nhớ microSD/TF (chỉ có khe cắm thẻ, không bao gồm thẻ nhớ microSD/TF), giao diện GPS, đầu ra âm thanh, phát hiện điện áp pin, đèn LED xanh lục, nút BOOT/RESET và giao diện ăng-ten bên ngoài. Nó phù hợp với Wi-Fi 6, Bluetooth LE, Zigbee/Thread, Giao diện người máy (HMI), ghi dữ liệu và phát triển Internet of Things (IoT).
Các tính năng chính
- CPU lõi đơn RISC-V 32-bit ESP32-C5, lên đến 240 MHz
- ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (bộ nhớ mô-đun tích hợp, không phải thẻ nhớ microSD/TF)
- Wi-Fi 6 băng tần kép 2,4 GHz + 5 GHz (802.11ax)
- Bluetooth LE、IEEE 802.15.4、Zigbee 3.0、Thread 1.4
- Màn hình LCD 2,8 inch 240×320, chip điều khiển ST7789, khởi tạo BGR, tắt chức năng đảo ngược màn hình
- Bộ điều khiển cảm ứng điện trở XPT2046
- Thẻ LCD và TF chia sẻ giao diện SPI, nhưng giao diện CS thì khác; chức năng cảm ứng sử dụng giao diện SPI phần mềm độc lập.
- Kích thước bảng điều khiển khoảng 86mm x 50mm
- Giao diện ăng-ten ngoài IPEX1; vui lòng kết nối ăng-ten bên ngoài phù hợp trước khi sử dụng radio.
người dùng mục tiêu
Lý tưởng cho các nhà phát triển nhúng, nhà phát triển IoT, nhà sản xuất, sử dụng trong giáo dục/phòng thí nghiệm và tạo nguyên mẫu sản phẩm.
2. Hình dáng và kích thước
Kích thước bảng khoảng 86 mm × 50 mm. Sơ đồ sau đây giúp xác định màn hình, đầu nối và các thành phần chính.
Nhận dạng trình kết nối
3. Thông số kỹ thuật board mạch
| điều | Đặc điểm kỹ thuật |
|---|---|
| mô hình tấm | ZLX-ESP32-2 |
| mô-đun lõi | ESP32-C5-WROOM-1U-N8R8 |
| Kích thước bảng | Xấp xỉ. 86 × 50mm |
| triển lãm | Màn hình TFT LCD 2,8 inch, chip ST7789, độ phân giải gốc 240×320 |
| thứ tự màu sắc | Khởi tạo BGR |
| Hiển thị đảo ngược | Chế độ hiển thị tắt/bình thường |
| chạm | Cảm ứng điện trở, XPT2046 |
| Khe cắm thẻ nhớ microSD/TF | chế độ SPI; thẻ không bao gồm |
| Giao diện GPS | Đầu nối 4 chân 1,25mm; Tín hiệu UART trên GPIO0/GPIO9 |
| phát âm | Đầu nối loa/âm thanh 2.0mm 2 chân; Đã bật bộ khuếch đại âm thanh + bộ khuếch đại |
| Ắc quy | 3.7V một pha, chân đôi 1,25mm; có mạch bảo vệ, dung lượng khuyến nghị 1000–3000mAh |
| ăng-ten bên ngoài | Đầu nối IPEX1; cần thiết cho đường dẫn không dây WROOM-1U |
| cái nút | đặt lại, bắt đầu |
| chỉ mục | Đèn LED xanh lục trên GPIO26 |
4. Thông số kỹ thuật mô-đun ESP32-C5-WROOM-1U-N8R8
Các thông số chính sau đây dựa trên bảng dữ liệu ESP32-C5-WROOM-1 / WROOM-1U chính thức của Espressif v1.2.
| điều | Đặc điểm kỹ thuật |
|---|---|
| SoC nhúng | ESP32-C5HR8 |
| CPU | Bộ xử lý lõi đơn RISC-V 32 bit, tốc độ lên tới 240 MHz |
| bộ nhớ chỉ đọc | 320 KB |
| HP SRAM | 384 KB |
| LP SRAM | 16 KB |
| đèn flash | SPI 4 MB 8 MB |
| PSRAM | SPI 4 MB 8 MB |
| Wifi | Băng tần kép 1T1R, 2,4 GHz + 5 GHz; IEEE 802.11ax/ac/b/g/n; lên tới 150 Mb/giây |
| Tần số 2,4 GHz | 2412–2484 MHz |
| Tần số 5GHz | 5180–5885 MHz (tuân theo quy định của khu vực) |
| Bluetooth | Bluetooth năng lượng thấp; Danh sách tính năng Espressif v1.2 hiển thị chứng nhận Bluetooth Core 6.0 |
| IEEE 802.15.4 | 2.4 GHz OQPSK，250 Kbps |
| Zigbee/Thread | Zigbee 3.0 / Thread 1.4 |
| GPIO | Có tới 22 GPIO có sẵn ở cấp độ mô-đun. |
| 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 sử dụng SPI phần mềm độc lập trên GPIO3/4/5/23/25.
- Đối với điện áp pin, hãy chuyển đổi số đọc ADC GPIO1 bằng tỷ lệ chia điện áp khoảng 2:1 và áp dụng hiệu chuẩn ADC để có độ chính xác cao hơn.
- Các kênh Wi-Fi 5 GHz khả dụng và công suất phát tùy thuộc vào quy định của địa phương.
- Hoạt động khởi động/khôi phục cài đặt gốc được xác định bởi phần sụn; vui lòng tránh vô tình kích hoạt để tránh xóa cài đặt.
Trình tự khởi tạo được đề xuất
- Sau khi nguồn điện ổn định, khởi động hệ thống và gỡ lỗi UART.
- Khởi tạo LCD SPI; định cấu hình ST7789, BGR, tắt đảo ngược và bật đèn nền.
- Khởi tạo cảm ứng XPT2046.
- Nếu cần có bộ nhớ di động, hãy lắp thẻ microSD/TF tương thích do người dùng cung cấp, sau đó khởi tạo thẻ và đảm bảo trạng thái LCD_CS/SD_CS là chính xác.
- Khởi tạo GPS, âm thanh, đèn LED và ADC pin nếu cần.
- Bật chức năng vô tuyến Wi-Fi/BLE/802.15.4 nếu cần.
11. Khắc phục sự cố
| câu hỏi | giải pháp |
|---|---|
| Hiển thị màn hình trống/đen | Kiểm tra lựa chọn trình điều khiển GPIO6/7/10/13/14, ST7789, cài đặt BGR, đèn nền GPIO13 và xem tính năng đảo ngược có vô tình được bật hay không. |
| sai màu | Xác minh rằng thư viện đồ họa được cấu hình theo thứ tự màu BGR. |
| Không có phản hồi cảm ứng | Kiểm tra khởi tạo GPIO3/4/5/23/25 và XPT2046. |
| Khởi tạo thẻ TF không thành công | Kiểm tra SPI SCK/MOSI/MISO được chia sẻ và đảm bảo SD_CS (GPIO27) và LCD_CS (GPIO10) không được đặt cùng lúc. |
| Tín hiệu Wi-Fi yếu/không có Wi-Fi | Xác minh rằng ăng-ten ngoài IPEX1 đã được kết nối và phù hợp với băng tần 2,4/5 GHz. |
| Pin đọc được khoảng một nửa | GPIO1 sử dụng bộ chia điện áp 100k/100k; nhân điện áp phía ADC với khoảng 2. |
| Không có dữ liệu GPS | Xác minh rằng GPIO0 nhận được GPS TX, GPIO9 điều khiển GPS RX, đồng thời xác minh tốc độ truyền và nguồn điện. |
12. Tải xuống và hỗ trợ kỹ thuật
Để biết phần sụn, tệp, tài liệu tiếp theo và hỗ trợ liên quan của ZLX-ESP32-2, vui lòng truy cập Trung tâm hỗ trợ Ban phát triển ZLX ESP32. Trước khi cài đặt chương trình cơ sở, hãy đảm bảo xác nhận rằng kiểu PCB hiển thị trên trang web khớp chính xác với phần cứng của bạn.
Liên kết tải xuống:https://www.zlxchina.xyz/
Bảng dữ liệu mô-đun Espressif: Bảng dữ liệu ESP32-C5-WROOM-1 / WROOM-1U
tham khảo
- Trung tâm hỗ trợ ban phát triển ZLX ESP32
- Espressif ESP32-C5-WROOM-1 & WROOM-1U Bảng dữ liệu v1.2 (2026-08-12)
13. An toàn và vận hành
- Vui lòng xác nhận cực của pin trước khi kết nối; không kết nối ngược các đầu nối pin.
- Khi cắm hoặc rút đầu nối IPEX, vui lòng tác dụng lực thẳng đứng và tránh cạy sang bên để tránh làm hỏng ổ cắm RF.
- Khi sử dụng bảng mạch hở, hãy thực hiện các biện pháp bảo vệ chống phóng tĩnh điện và ngăn ngừa đoản mạch do vật kim loại gây ra.
- Băng tần, kênh và công suất phát vô tuyến 5 GHz phải tuân thủ các quy định của địa phương.
- Đối với thẻ TF, GPS, âm thanh và các thiết bị ngoại vi khác, vui lòng tuân theo mức logic và nguồn điện được chỉ định bởi phiên bản phần cứng thực tế. Không áp dụng mức logic cao hơn 3,3V cho các chân I/O trừ khi được xác minh rõ ràng.
14. Lịch sử sửa đổi tài liệu
| linh mục | ngày | mô tả | Căn cứ |
|---|---|---|---|
| V1.1 | 2026-08-25 | Hướng dẫn sử dụng thẻ nhớ microSD/TF, pin và GPIO đã được sửa đổi. | Công ty TNHH Công nghệ thông tin Zhiluxing Hợp Phì |
-Kết thúc-