1. Product overview / 1. Product Overview

ZLX-ESP32-2 is a product based on ESP32-C5-WROOM-1U-N8R8 Modular 2.8 inch resistive touch screen development board with integrated color LCD、XPT2046 touch,microSD/TF Card slot (card slot only, not included microSD/TF Card),GPS Interface, audio output, battery voltage detection, green LED、BOOT/RESET Button and external antenna interface. Suitable Wi-Fi 6、Bluetooth LE、Zigbee/Thread, human-machine interface, data recording and Internet of Things application development.
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.

Main features / Key Features

• ESP32-C5 32 Bit RISC-V Single-core processor, up to 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(Module onboard resources, not microSD/TF Card) / ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (onboard module memory, not a microSD/TF card)

• 2.4 GHz + 5 GHz Dual band 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 drive,BGR Initialization, disable inverse color / 2.8-inch 240×320 LCD, ST7789 driver, BGR initialization, display inversion disabled

• XPT2046 Resistive touch controller / XPT2046 resistive touch controller

• LCD and TF Card sharing SPI bus, independent CS;Touch to use standalone software SPI / LCD and TF card share SPI with separate CS; touch uses an independent software SPI

• Board size approx. 86 mm × 50 mm / Board size approx. 86 mm × 50 mm

• IPEX1 External antenna interface; the external antenna must be connected correctly before using the wireless function / IPEX1 external antenna connector; connect a suitable external antenna before radio use

Applicable objects / Intended Users

Suitable for embedded developers, IoT developers, makers, teaching experiments and product prototype design.
For embedded developers, IoT developers, makers, education/lab use, and product prototyping.

2. Appearance and size / 2. Appearance and Dimensions

The overall dimensions of the board are approximately 86 mm × 50 mm. The following front and back pictures are used to identify the screen, interfaces and main components.
The board outline is approximately 86 mm × 50 mm. The images below help identify the display, connectors, and major components.

picture 1 Front and screen dimensions / Figure 1 Board front and display-side dimensions

Interface annotation / Connector Identification

picture 2 ZLX-ESP32-2 Chinese and English interface annotation / Figure 2 Bilingual connector identification

3. Development board specifications / 3. Board Specifications

illustrate / Note: The native screen resolution is 240×320;When the software is set to horizontal screen rotation, the logical display size can be expressed as 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 Module parameters / 4. ESP32-C5-WROOM-1U-N8R8 Module Specifications

The following key parameters are based on Espressif official 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. Display and touch / 5. Display and Touch

LCD parameter / LCD Parameters

Touch parameters / Touch Parameters

• Touch type:4 Wire Resistive Touch; Controller: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.

• Touch to use standalone software SPI;The detection tool process is marked as not requiring calibration. / Touch uses an independent software SPI; the supplied test flow is marked as requiring no calibration.

6. GPIO mapping / 6. GPIO Mapping

The following mappings are from the customer version provided with the board GPIO Spreadsheet and checked against schematic. Onboard peripheral usage 19 An ordinary GPIO；TX0=GPIO11、RX0=GPIO12 Also used for UART0；N8R8 of GPIO15 quilt PSRAM occupied, therefore 21 available GPIO All assigned;EN Not counted as work 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 serial port signals / System and UART Signals

7. Interface and bus sharing instructions / 7. Interface and Bus Sharing

SPI Sharing considerations / SPI Sharing Notes

• LCD and TF Card sharing GPIO6(SCK)、GPIO7(MOSI)、GPIO2(MISO), but use respectively GPIO10(LCD_CS) and 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.

• Only enable the target device at the same time CS, to avoid bus conflicts caused by multiple devices being selected at the same time. / Assert only the target device CS at a time to avoid bus contention.

• touch XPT2046 Use standalone software SPI, not with LCD/TF Lord SPI clock and MOSI shared. / The XPT2046 touch controller uses an independent software SPI and does not share the main LCD/TF SCK/MOSI signals.

8. Detection function correspondence / 8. Functional Test Mapping

9. Interface and electrical considerations / 9. Connector and Electrical Notes

Battery interface / Battery Connector

Development board provided 1.25 mm 2-Pin 3.7 V Single battery interface. According to the viewing direction of the marked diagram, the left side is the positive electrode (+), the right side is the negative pole (-). If battery power is required, it is recommended to use capacity 1000–3000 mAh, single section with protection board (protection circuit) 3.7 V Lithium ion/Lithium polymer battery, and confirm the interface specifications and positive and negative poles before connecting. Reverse connection may damage the development board.
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 pass 100 kΩ / 100 kΩ The voltage divider network detects the battery voltage, so under ideal conditions the actual battery voltage is approximately ADC pin voltage 2 times. This function is only for voltage estimation, not a fuel coulomb meter.
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 Interface

GPS use GPIO0 and GPIO9 as UART Signal.GPIO0（GPSTX named) as input in this board definition, connect GPS module TX；GPIO9（GPSRX named) as output, connect GPS module RX。1.25 mm 4-Pin Please refer to the corresponding hardware version for the power pins and actual pin sequence of the connector./The schematic diagram shall prevail.
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 / External Antenna

ESP32-C5-WROOM-1U It is the external antenna version. board IPEX1 The interface needs to be connected with 2.4/5 GHz The frequency band matching and impedance are 50 Ω antenna. Do not transmit at high power for an extended period of time without a suitable antenna connected.
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 interface / Audio Connector

Audio output is provided by GPIO8（AUDIOPWM)produce PWM Signal,GPIO24（AMP_EN) controls the power amplifier enable; the top of the board is 2.0 mm 2-Pin Audio/Speaker interface. Please refer to the actual power amplifier circuit capabilities for different load and volume settings.
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 advice / 10. Software Development and Initialization Notes

• Display driver selection ST7789, the native resolution is set to 240×320;Horizontal screen can be rotated to 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.

• Color order used BGR;Do not enable display inverse colors (INVON）。 / Use BGR color order; do not enable display inversion (INVON).

• LCD/TF share SPI when, managed separately after initialization LCD_CS(GPIO10) and SD_CS(GPIO27)。 / When LCD and TF share SPI, manage LCD_CS (GPIO10) and SD_CS (GPIO27) independently after initialization.

• XPT2046 use GPIO3/4/5/23/25 independent software SPI。 / XPT2046 uses an independent software SPI on GPIO3/4/5/23/25.

• When reading the battery voltage, the GPIO1 of ADC Results by approx. 2:1 Partial pressure ratio conversion, combined with ADC Calibration improves accuracy. / 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 channels and transmit power vary depending on the country/Regional regulatory restrictions. / Available 5 GHz Wi-Fi channels and transmit power depend on local regulations.

• BOOT/The factory reset logic is determined by firmware; avoid mistriggering during operation and causing the configuration to be cleared. / BOOT/factory-restore behavior is firmware-defined; avoid unintended activation that may clear settings.

Recommended initialization sequence / Suggested Initialization Sequence

1. Initialize the system and serial port after the power supply is stable.
After power is stable, initialize the system and debug UART.

2. initialization LCD SPI,set up ST7789、BGR, turn off the inverse color, and then turn on the backlight.
Initialize LCD SPI; configure ST7789, BGR, inversion off, then enable backlight.

3. initialization XPT2046 touch.
Initialize XPT2046 touch.

4. If you need to use the storage function, please insert the user-prepared compatible microSD/TF card, reinitialize, and ensure LCD_CS and SD_CS The status is correct.
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. Initialize on demand GPS,audio,LED,Battery ADC。
Initialize GPS, audio, LED, and battery ADC as needed.

6. Last enabled Wi-Fi/BLE/802.15.4 Wireless capabilities.
Enable Wi-Fi/BLE/802.15.4 radio functions as required.

11. Troubleshooting common problems / 11. Troubleshooting

12. Data download and technical support / 12. Downloads and Technical Support

ZLX-ESP32-2 Please give priority access to the firmware, files, follow-up information and related support. ZLX ESP32 Development Board Maker Support Center. Please confirm what is listed on the page before flashing the firmware. PCB The model is exactly the same as the board in hand.
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.

Data download / Downloads: https://www.zlxchina.xyz/

Espressif module datasheet / Espressif Module Specifications: ESP32-C5-WROOM-1 / WROOM-1U Datasheet

References / References

• ZLX ESP32 Development Board Maker Support Center / 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. Usage and safety precautions / 13. Safety and Handling

• The positive and negative poles must be confirmed before connecting the battery, and reverse connection is prohibited. / Verify battery polarity before connection; never reverse the battery connector.

• Plug and unplug IPEX Keep vertical force when connecting the antenna to avoid lateral prying that may cause the RF base to fall off. / When mating/unmating the IPEX connector, apply force vertically and avoid sideways prying that may damage the RF socket.

• When using the bare board of the development board, pay attention to electrostatic protection to avoid short circuits caused by metal objects. / Use ESD precautions with the bare board and prevent metal objects from causing shorts.

• 5 GHz Wireless frequency band, channel and power must comply with the regulations of the area of ​​use. / 5 GHz radio band, channels, and transmit power must comply with local regulations.

• TF Card,GPSPlease follow the actual hardware version for the power supply capabilities and levels of peripherals such as audio and video. Do not contact us without confirmation. IO pin applied above 3.3 V level. / 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. Document version record / 14. Document Revision History

— End / Finish -