ZLX-ESP32-2
Placa de desenvolvimento com tela sensível ao toque ESP32-C5 de 2,8 polegadas
1. Visão geral do produto
ZLX-ESP32-2 é uma placa de desenvolvimento de toque resistivo de 2,8 polegadas baseada no módulo ESP32-C5-WROOM-1U-N8R8. Ele integra um display LCD colorido, controlador de toque XPT2046, slot para cartão microSD/TF (apenas slot para cartão, cartão microSD/TF não incluído), interface GPS, saída de áudio, detecção de tensão da bateria, indicador LED verde, botão BOOT/RESET e interface de antena externa. É adequado para Wi-Fi 6, Bluetooth LE, Zigbee/Thread, Interface Homem-Máquina (HMI), registro de dados e desenvolvimento de Internet das Coisas (IoT).
Características principais
- CPU ESP32-C5 RISC-V de núcleo único de 32 bits, até 240 MHz
- ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (módulo de memória integrado, não cartão microSD/TF)
- Wi-Fi 6 de banda dupla de 2,4 GHz + 5 GHz (802.11ax)
- Bluetooth LE、IEEE 802.15.4、Zigbee 3.0、Thread 1.4
- Tela LCD 240 × 320 de 2,8 polegadas, chip de driver ST7789, inicialização BGR, função de inversão de tela desabilitada
- Controlador de toque resistivo XPT2046
- O cartão LCD e TF compartilham uma interface SPI, mas a interface CS é diferente; a função de toque usa uma interface SPI de software independente.
- As dimensões do painel são aproximadamente 86 mm x 50 mm
- Interface de antena externa IPEX1; conecte uma antena externa adequada antes de usar o rádio.
usuários-alvo
Ideal para desenvolvedores incorporados, desenvolvedores de IoT, fabricantes, uso educacional/laboratorial e prototipagem de produtos.
2. Aparência e tamanho
As dimensões da placa são aproximadamente 86 mm × 50 mm. O diagrama a seguir ajuda a identificar a tela, os conectores e os principais componentes.
Identificação do conector
3. Especificações da placa de circuito
| coisa | Especificação |
|---|---|
| modelo de placa | ZLX-ESP32-2 |
| módulo principal | ESP32-C5-WROOM-1U-N8R8 |
| Tamanho do tabuleiro | Aprox. 86 × 50mm |
| exposição | Tela LCD TFT de 2,8 polegadas, chip ST7789, resolução original 240×320 |
| ordem de cores | Inicialização BGR |
| Tela invertida | Modo de exibição desligado/normal |
| tocar | Toque resistivo, XPT2046 |
| Slot para cartão microSD/TF | Modo SPI; cartão não incluído |
| Interface GPS | Conector de 4 pinos de 1,25 mm; Sinais UART em GPIO0/GPIO9 |
| vocal | Conector de alto-falante/áudio de 2,0 mm e 2 pinos; Áudio PWM + amplificador habilitado |
| Bateria | 3,7V monofásico, pino duplo de 1,25mm; com circuito de proteção, capacidade recomendada 1000–3000mAh |
| antena externa | Conector IPEX1; necessário para caminho sem fio WROOM-1U |
| botão | redefinir, começar |
| índice | LED verde no GPIO26 |
4. Especificações do módulo ESP32-C5-WROOM-1U-N8R8
Os parâmetros principais a seguir são baseados na folha de dados oficial ESP32-C5-WROOM-1 / WROOM-1U da Espressif v1.2.
| coisa | Especificação |
|---|---|
| SoC incorporado | ESP32-C5HR8 |
| CPU | Processador RISC-V de núcleo único de 32 bits, até 240 MHz |
| memória somente leitura | 320 KB |
| HP SRAM | 384 KB |
| LP SRAM | 16 KB |
| clarão | SPI quádruplo de 8 MB |
| PSRAM | SPI quádruplo de 8 MB |
| Wi-fi | 1T1R, banda dupla de 2,4 GHz + 5 GHz; IEEE 802.11ax/ac/b/g/n; até 150Mbps |
| Frequência de 2,4 GHz | 2412–2484 MHz |
| Frequência de 5 GHz | 5180–5885 MHz (sujeito às regulamentações regionais) |
| Bluetooth | Bluetooth de baixa energia; A lista de recursos do Espressif v1.2 mostra certificação Bluetooth Core 6.0 |
| IEEE 802.15.4 | 2.4 GHz OQPSK，250 Kbps |
| Zigbee/Thread | Zigbee 3.0 / Thread 1.4 |
| GPIO | Até 22 GPIOs estão disponíveis no nível do módulo. |
| 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.
- O XPT2046 usa software independente SPI em GPIO3/4/5/23/25.
- Para a tensão da bateria, converta a leitura do GPIO1 ADC usando uma proporção do divisor de tensão de aproximadamente 2:1 e aplique a calibração do ADC para melhor precisão.
- Os canais Wi-Fi de 5 GHz disponíveis e a potência de transmissão dependem das regulamentações locais.
- O comportamento de inicialização/redefinição de fábrica é definido pelo firmware; evite a ativação acidental para evitar a limpeza das configurações.
Sequência de inicialização recomendada
- Depois que a fonte de alimentação estiver estável, inicialize o sistema e depure o UART.
- Inicialize o LCD SPI; configure ST7789, BGR, desligue a inversão e habilite a luz de fundo.
- Inicialize o toque XPT2046.
- Se for necessário armazenamento removível, insira um cartão microSD/TF compatível fornecido pelo usuário, inicialize-o e certifique-se de que o status LCD_CS/SD_CS esteja correto.
- Inicialize o GPS, o áudio, o LED e o ADC da bateria conforme necessário.
- Ative a funcionalidade de rádio Wi-Fi/BLE/802.15.4 conforme necessário.
11. Solução de problemas
| pergunta | solução |
|---|---|
| Mostrar tela em branco/preto | Verifique GPIO6/7/10/13/14, seleção do driver ST7789, configurações BGR, luz de fundo GPIO13 e se o recurso de inversão foi ativado acidentalmente. |
| cor errada | Verifique se a biblioteca gráfica está configurada para a ordem de cores BGR. |
| Sem resposta ao toque | Verifique a inicialização do GPIO3/4/5/23/25 e XPT2046. |
| Falha na inicialização do cartão TF | Verifique o SPI SCK/MOSI/MISO compartilhado e certifique-se de que SD_CS (GPIO27) e LCD_CS (GPIO10) não estejam configurados ao mesmo tempo. |
| Sinal de Wi-Fi fraco/sem Wi-Fi | Verifique se a antena externa IPEX1 está conectada e adequada para a banda de 2,4/5 GHz. |
| A leitura da bateria é cerca de metade | GPIO1 usa um divisor de tensão de 100k/100k; multiplique a tensão lateral do ADC por aproximadamente 2. |
| Sem dados de GPS | Verifique se o GPIO0 recebe GPS TX, o GPIO9 aciona GPS RX e verifique a taxa de transmissão e a potência. |
12. Downloads e suporte técnico
Para firmware ZLX-ESP32-2, arquivos, documentação de acompanhamento e suporte relacionado, visite o Centro de suporte da placa de desenvolvimento ZLX ESP32. Antes de atualizar o firmware, certifique-se de confirmar se o modelo de PCB mostrado no site corresponde exatamente ao seu hardware.
Link para baixar:https://www.zlxchina.xyz/
Folha de dados do módulo Espressif: Folha de dados ESP32-C5-WROOM-1 / WROOM-1U
consulte
- Centro de suporte da placa de desenvolvimento ZLX ESP32
- Ficha técnica do Espressif ESP32-C5-WROOM-1 e WROOM-1U v1.2 (12/08/2026)
13. Segurança e Operação
- Confirme a polaridade da bateria antes de conectar; não conecte os conectores da bateria ao contrário.
- Ao conectar ou desconectar o conector IPEX, aplique força vertical e evite forçar lateralmente para evitar danificar o soquete RF.
- Ao utilizar placas de circuito expostas, tome medidas de proteção contra descargas eletrostáticas e evite curtos-circuitos causados por objetos metálicos.
- A banda de rádio de 5 GHz, o canal e a potência de transmissão devem estar em conformidade com os regulamentos locais.
- Para cartões TF, GPS, áudio e outros periféricos, siga a fonte de alimentação e os níveis lógicos especificados pela versão real do hardware. Não aplique níveis lógicos superiores a 3,3 V aos pinos de E/S, a menos que seja explicitamente verificado.
14. Histórico de revisão de documentos
| padre | data | descrever | Base |
|---|---|---|---|
| V1.1 | 2026-08-25 | Instruções revisadas do cartão microSD/TF, bateria e GPIO. | Hefei Zhiluxing Tecnologia da Informação Co., Ltd. |
-Fim-