1. Visão geral do produto / 1. Product Overview

ZLX-ESP32-2 é um produto baseado em ESP32-C5-WROOM-1U-N8R8 Modular 2.8 placa de desenvolvimento de tela de toque resistiva de polegada com cor integrada LCD、XPT2046 tocar,microSD/TF Slot para cartão (apenas slot para cartão, não incluído microSD/TF Cartão),GPS Interface, saída de áudio, detecção de tensão da bateria, verde LED、BOOT/RESET Interface de botão e antena externa. Adequado Wi-Fi 6、Bluetooth LE、Zigbee/Thread, interface homem-máquina, gravação de dados e desenvolvimento de aplicações para Internet das Coisas.
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.

Características principais / Key Features

• ESP32-C5 32 Pedaço RISC-V Processador de núcleo único, até 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(Recursos integrados do módulo, não microSD/TF Cartão) / ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (onboard module memory, not a microSD/TF card)

• 2.4 GHz + 5 GHz Banda dupla 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 polegada 240×320 LCD，ST7789 dirigir,BGR Inicialização, desative a cor inversa / 2.8-inch 240×320 LCD, ST7789 driver, BGR initialization, display inversion disabled

• XPT2046 Controlador de toque resistivo / XPT2046 resistive touch controller

• LCD e TF Compartilhamento de cartão SPI ônibus, independente CS;Toque para usar software independente SPI / LCD and TF card share SPI with separate CS; touch uses an independent software SPI

• Tamanho da placa aprox. 86 mm × 50 mm / Board size approx. 86 mm × 50 mm

• IPEX1 Interface de antena externa; a antena externa deve estar conectada corretamente antes de usar a função sem fio / IPEX1 external antenna connector; connect a suitable external antenna before radio use

Objetos aplicáveis / Intended Users

Adequado para desenvolvedores incorporados, desenvolvedores de IoT, fabricantes, experimentos de ensino e design de protótipos de produtos.
For embedded developers, IoT developers, makers, education/lab use, and product prototyping.

2. Aparência e tamanho / 2. Appearance and Dimensions

As dimensões gerais da placa são aproximadamente 86 mm × 50 mm. As seguintes imagens frontais e traseiras são usadas para identificar a tela, interfaces e componentes principais.
The board outline is approximately 86 mm × 50 mm. The images below help identify the display, connectors, and major components.

foto 1 Dimensões frontal e da tela / Figure 1 Board front and display-side dimensions

Anotação de interface / Connector Identification

foto 2 ZLX-ESP32-2 Anotações de interface em chinês e inglês / Figure 2 Bilingual connector identification

3. Especificações da placa de desenvolvimento / 3. Board Specifications

ilustrar / Note: A resolução de tela nativa é 240×320;Quando o software está configurado para rotação horizontal da tela, o tamanho lógico da exibição pode ser expresso como 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 Parâmetros do módulo / 4. ESP32-C5-WROOM-1U-N8R8 Module Specifications

Os seguintes parâmetros principais são baseados em Espressif oficial 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. Exibir e tocar / 5. Display and Touch

LCD parâmetro / LCD Parameters

Parâmetros de toque / Touch Parameters

• Tipo de toque:4 Toque resistivo de fio; Controlador: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.

• Toque para usar software independente SPI;O processo da ferramenta de detecção está marcado como não necessitando de calibração. / Touch uses an independent software SPI; the supplied test flow is marked as requiring no calibration.

6. GPIO mapeamento / 6. GPIO Mapping

Os seguintes mapeamentos são da versão do cliente fornecida com a placa GPIO Planilha e verificado em relação ao esquema. Uso de periféricos integrados 19 Um comum GPIO；TX0=GPIO11、RX0=GPIO12 Também usado para UART0；N8R8 de GPIO15 colcha PSRAM ocupado, portanto 21 disponível GPIO Todos atribuídos;EN Não contado como trabalho 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.

Sinais do sistema e da porta serial / System and UART Signals

7. Instruções de compartilhamento de interface e barramento / 7. Interface and Bus Sharing

SPI Compartilhando considerações / SPI Sharing Notes

• LCD e TF Compartilhamento de cartão GPIO6(SCK)、GPIO7(MOSI)、GPIO2(MISO), mas usando respectivamente GPIO10(LCD_CS) e 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.

• Habilite apenas o dispositivo de destino ao mesmo tempo CS, para evitar conflitos de barramento causados ​​pela seleção de vários dispositivos ao mesmo tempo. / Assert only the target device CS at a time to avoid bus contention.

• tocar XPT2046 Use software independente SPI, não com LCD/TF Senhor SPI relógio e MOSI compartilhado. / The XPT2046 touch controller uses an independent software SPI and does not share the main LCD/TF SCK/MOSI signals.

8. Correspondência da função de detecção / 8. Functional Test Mapping

9. Interface e considerações elétricas / 9. Connector and Electrical Notes

Interface de bateria / Battery Connector

Placa de desenvolvimento fornecida 1.25 mm 2-Pin 3.7 V Interface de bateria única. De acordo com a direção de visualização do diagrama marcado, o lado esquerdo é o eletrodo positivo (+), o lado direito é o pólo negativo (-). Se for necessária energia da bateria, recomenda-se usar a capacidade 1000–3000 mAh, seção única com placa de proteção (circuito de proteção) 3.7 V Íon de lítio/Bateria de polímero de lítio e confirme as especificações da interface e os pólos positivo e negativo antes de conectar. A conexão reversa pode danificar a placa de desenvolvimento.
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 passar 100 kΩ / 100 kΩ A rede divisora ​​de tensão detecta a tensão da bateria, portanto, em circunstâncias ideais, a tensão real da bateria é aproximadamente ADC tensão do pino 2 vezes. Esta função serve apenas para estimativa de tensão, não para um medidor de Coulomb de combustível.
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 usar GPIO0 e GPIO9 como UART Sinal.GPIO0（GPSTX nomeado) como entrada nesta definição da placa, conecte GPS módulo TX；GPIO9（GPSRX nomeado) como saída, conecte GPS módulo RX。1.25 mm 4-Pin Consulte a versão de hardware correspondente para obter os pinos de alimentação e a sequência real de pinos do conector./O diagrama esquemático prevalecerá.
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.

antena externa / External Antenna

ESP32-C5-WROOM-1U É a versão com antena externa. quadro IPEX1 A interface precisa estar conectada com 2.4/5 GHz A correspondência de banda de frequência e a impedância são 50 Ω antena. Não transmita em alta potência por um longo período de tempo sem uma antena adequada conectada.
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.

interface de áudio / Audio Connector

A saída de áudio é fornecida por GPIO8（AUDIOPWM)produzir PWM Sinal,GPIO24（AMP_EN) controla a habilitação do amplificador de potência; o topo do tabuleiro é 2.0 mm 2-Pin Áudio/Interface de alto-falante. Consulte as capacidades reais do circuito do amplificador de potência para diferentes configurações de carga e volume.
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. Desenvolvimento de software e consultoria de inicialização / 10. Software Development and Initialization Notes

• Seleção do driver de exibição ST7789, a resolução nativa é definida como 240×320;A tela horizontal pode ser girada para 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.

• Ordem de cores usada BGR;Não habilite a exibição de cores inversas (INVON）。 / Use BGR color order; do not enable display inversion (INVON).

• LCD/TF compartilhar SPI quando, gerenciado separadamente após a inicialização LCD_CS(GPIO10) e SD_CS(GPIO27)。 / When LCD and TF share SPI, manage LCD_CS (GPIO10) and SD_CS (GPIO27) independently after initialization.

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

• Ao ler a tensão da bateria, o GPIO1 de ADC Resultados em aprox. 2:1 Conversão da relação de pressão parcial, combinada com ADC A calibração melhora a precisão. / 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 Os canais disponíveis e a potência de transmissão variam dependendo do país/Restrições regulatórias regionais. / Available 5 GHz Wi-Fi channels and transmit power depend on local regulations.

• BOOT/A lógica de restauração de fábrica é determinada pelo firmware; evitar disparos incorretos durante a operação e fazer com que a configuração seja apagada. / BOOT/factory-restore behavior is firmware-defined; avoid unintended activation that may clear settings.

Sequência de inicialização recomendada / Suggested Initialization Sequence

1. Inicialize o sistema e a porta serial depois que a fonte de alimentação estiver estável.
After power is stable, initialize the system and debug UART.

2. inicialização LCD SPI,configurar ST7789、BGR, desligue a cor inversa e ligue a luz de fundo.
Initialize LCD SPI; configure ST7789, BGR, inversion off, then enable backlight.

3. inicialização XPT2046 tocar.
Initialize XPT2046 touch.

4. Se você precisar usar a função de armazenamento, insira o compatível preparado pelo usuário microSD/TF cartão, reinicializar e garantir LCD_CS e SD_CS O status está correto.
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. Inicializar sob demanda GPS,áudio,LED,Bateria ADC。
Initialize GPS, audio, LED, and battery ADC as needed.

6. Última ativação Wi-Fi/BLE/802.15.4 Capacidades sem fio.
Enable Wi-Fi/BLE/802.15.4 radio functions as required.

11. Solução de problemas comuns / 11. Troubleshooting

12. Download de dados e suporte técnico / 12. Downloads and Technical Support

ZLX-ESP32-2 Dê acesso prioritário ao firmware, arquivos, informações de acompanhamento e suporte relacionado. ZLX ESP32 Centro de suporte ao criador de placas de desenvolvimento. Por favor, confirme o que está listado na página antes de atualizar o firmware. PCB O modelo é exatamente igual ao tabuleiro em mãos.
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.

Download de dados / Downloads: https://www.zlxchina.xyz/

Espressif module datasheet / Especificações do módulo Espressif: ESP32-C5-WROOM-1 / WROOM-1U Datasheet

Referências / References

• ZLX ESP32 Centro de suporte ao criador de placa de desenvolvimento / 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. Precauções de uso e segurança / 13. Safety and Handling

• Os pólos positivo e negativo devem ser confirmados antes de conectar a bateria, e a conexão reversa é proibida. / Verify battery polarity before connection; never reverse the battery connector.

• Conecte e desconecte IPEX Mantenha a força vertical ao conectar a antena para evitar intromissões laterais que podem causar a queda da base de RF. / When mating/unmating the IPEX connector, apply force vertically and avoid sideways prying that may damage the RF socket.

• Ao usar a placa nua da placa de desenvolvimento, preste atenção à proteção eletrostática para evitar curtos-circuitos causados ​​por objetos metálicos. / Use ESD precautions with the bare board and prevent metal objects from causing shorts.

• 5 GHz A banda de frequência, o canal e a potência sem fio devem estar em conformidade com os regulamentos da região de uso. / 5 GHz radio band, channels, and transmit power must comply with local regulations.

• TF Cartão,GPSSiga a versão real do hardware para saber os recursos de fonte de alimentação e os níveis de periféricos, como áudio e vídeo. Não entre em contato conosco sem confirmação. IO pino aplicado acima 3.3 V nível. / 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. Registro de versão do documento / 14. Document Revision History

— End / Terminar -