ZLX-ESP32-2
Доска разработки сенсорного дисплея ESP32-C5 2,8 дюйма
1 Описание продукта
ZLX-ESP32-2 - это 2,8-дюймовая резистивная плата разработки на основе модуля ESP32-C5-WROOM-1U-N8R8. Он включает в себя цветной ЖК-дисплей, сенсорный контроллер XPT2046, слот для карты microSD/TF (только слот для карты, за исключением карты microSD/TF), интерфейс GPS, аудиовыход, обнаружение напряжения батареи, зеленый светодиодный индикатор, кнопку загрузки/сброса и интерфейс внешней антенны. Он подходит для Wi-Fi 6, Bluetooth LE, Zigbee/Thread, человеко-машинного интерфейса (HMI), регистрации данных и разработки Интернета вещей (IoT).
Основные характеристики
- ESP32-C5 32-разрядный одноядерный процессор RISC-V с частотой 240 МГц
- ESP32-C5-WROOM-1U-N8R8: 8 МБ флэш-памяти + 8 МБ PSRAM (память встроенного модуля, не карта microSD/TF)
- 2,4 ГГц + 5 ГГц двухдиапазонный Wi-Fi 6 (802.11ax)
- Bluetooth LE、IEEE 802.15.4、Zigbee 3.0、Thread 1.4
- 2,8-дюймовый ЖК-дисплей 240 × 320, чип драйвера ST7789, инициализация BGR, функция инверсии дисплея отключена
- Резистивный сенсорный контроллер XPT2046
- ЖК-дисплей и карта TF имеют один интерфейс SPI, но интерфейс CS отличается; сенсорная функция использует отдельный программный интерфейс SPI.
- Размер листа ок. 86 мм х 50 мм
- Интерфейс внешней антенны IPEX1; подключите соответствующую внешнюю антенну перед использованием радио.
Целевой пользователь
Для встраиваемых разработчиков, разработчиков IoT, производителей, образовательного/лабораторного использования и прототипирования продукта.
2. Внешний вид и размеры
Размер платы составляет приблизительно 86 мм х 50 мм. Изображение ниже помогает идентифицировать дисплей, разъемы и основные компоненты.
Идентификация разъема
3. Технические характеристики печатной платы
| вещи | Параметры |
|---|---|
| Модель планшета | ZLX-ESP32-2 |
| Основные модули | ESP32-C5-WROOM-1U-N8R8 |
| Размер пластины | Прибл. 86 x 50 мм |
| Страны показа | 2.8 "TFT LCD, чип ST7789, оригинальное разрешение 240 × 320 |
| Порядок цветов | Инициализация BGR |
| Показать инвертированный | Выкл./Нормальный режим отображения |
| Прикоснуться | Резистивный сенсорный XPT2046 |
| слот для карты microSD/TF | Режим SPI; карта не входит в комплект |
| Интерфейс GPS | 1,25 мм 4-контактный разъем; сигнал UART на GPIO0/GPIO9 |
| акустический | 2,0 мм 2-контактный динамик/аудио разъем; ШИМ-аудио + усилитель включен |
| Батарея | 3,7 В однофазный, 1,25 мм двухконтактный; с цепью защиты, рекомендуемая емкость 1000-3000 мАч |
| Внешняя антенна | Разъем IPEX1; требуется для беспроводного тракта WROOM-1U |
| Кнопка | Сброс, запуск |
| Показатель | Зеленый светодиод на GPIO26 |
4. Технические характеристики модуля ESP32-C5-WROOM-1U-N8R8
Следующие ключевые параметры основаны на официальном техническом описании Espressif ESP32-C5-WROOM-1/WROOM-1U v1.2.
| вещи | Параметры |
|---|---|
| Встроенные SoC | ESP32-C5HR8 |
| Центральный процессор | 32-битный одноядерный процессор RISC-V на частоте до 240 МГц |
| - постоянные запоминающие устройства. | 320 KB |
| HP SRAM | 384 KB |
| LP SRAM | 16 KB |
| & Фильтр: | 8 МБ Quad Channel SPI |
| PSRAM | 8 МБ Quad Channel SPI |
| Wi-Fi | 1T1R, 2,4 ГГц + 5 ГГц двухдиапазонный; IEEE 802.11ax/ac/b/g/n; до 150 Мбит/с |
| 2.4 ГГц | 2412–2484 MHz |
| Частота 5 ГГц | 5180–5885 МГц (в соответствии с местными правилами) |
| Bluetooth | Bluetooth с низким энергопотреблением; Список функций Espressif v1.2 показывает сертифицированный Bluetooth Core 6.0 |
| IEEE 802.15.4 | 2.4 GHz OQPSK，250 Kbps |
| Zigbee/Thread | Zigbee 3.0 / Thread 1.4 |
| GPIO | На уровне модуля доступно до 22 GPIO. |
| 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 использует автономное программное обеспечение SPI на GPIO3/4/5/23/25.
- Для напряжения батареи преобразуйте показания АЦП GPIO1, используя отношение парциального напряжения приблизительно 2: 1, и примените калибровку АЦП для повышения точности.
- Доступные каналы Wi-Fi 5 ГГц и мощность передачи зависят от местных правил.
- Поведение запуска/восстановления заводских настроек определяется прошивкой; пожалуйста, избегайте случайной активации, чтобы избежать очистки настроек.
Предлагаемый порядок инициализации
- Когда питание стабильно, инициализируйте систему и отладьте UART.
- Инициализируйте ЖК-интерфейс SPI; настройте ST7789, BGR, выключите инверсию и включите подсветку.
- Инициализируйте XPT2046.
- Если требуется съемное хранилище, вставьте совместимую пользовательскую карту microSD/TF, затем инициализируйте ее и убедитесь, что статус LCD_CS/SD_CS правильный.
- При необходимости инициализируйте GPS, аудио, светодиоды и АЦП аккумулятора.
- При необходимости включите радиостанцию Wi-Fi/BLE/802.15.4.
11. Поиск и устранение неисправностей
| проблема | Решение |
|---|---|
| Показать пустой/черный экран | Проверьте GPIO6/7/10/13/14, выбор привода ST7789, настройки BGR, GPIO13 с подсветкой и случайное включение инверсии. |
| Ошибка цвета | Убедитесь, что графическая библиотека настроена на порядок цветов BGR. |
| Нет реакции на прикосновение | Проверьте инициализацию GPIO3/4/5/23/25 и XPT2046. |
| Ошибка инициализации карты TF | Проверьте общий SPI SCK/MOSI/MISO и убедитесь, что SD_CS (GPIO27) и LCD_CS (GPIO10) не установлены одновременно. |
| Сигнал Wi-Fi слабый/нет Wi-Fi | Убедитесь, что внешняя антенна IPEX1 подключена и работает в диапазоне ГГц 2.4/5. |
| Около половины показаний батареи | GPIO1 использует делитель напряжения 100k/100k; умножьте напряжение на стороне АЦП примерно на 2. |
| Нет данных GPS | Убедитесь, что GPIO0 принимает GPS TX, GPIO9 управляет GPS RX и проверяет скорость передачи данных и источник питания. |
12. Загрузка и техническая поддержка
Для получения прошивки ZLX-ESP32-2, документации, дополнительной документации и соответствующей поддержки посетите Центр поддержки Совета по разработке ZLX ESP32. Прежде чем прошивать прошивку, убедитесь, что модель печатной платы, показанная на веб-сайте, точно соответствует вашему оборудованию.
Ссылка для скачивания:https://www.zlxchina.xyz/
Технический паспорт модуля Lexin: ESP32-C5-WROOM-1/WROOM-1U Технический паспорт
Для справки
- Центр поддержки Совета разработчиков ZLX ESP32
- Спецификация Espressif ESP32-C5-WROOM-1 и WROOM-1U v1.2 (2026-08-12)
13. Безопасность и эксплуатация
- Перед подключением проверьте полярность аккумулятора; никогда не меняйте разъем аккумулятора.
- При подключении и отключении разъема IPEX прикладывайте усилие вертикально и избегайте боковых вставок, чтобы не повредить радиочастотную розетку.
- При использовании неизолированных печатных плат принимайте меры защиты от электростатических разрядов и предотвращайте короткие замыкания, вызванные металлическими предметами.
- Радиодиапазоны, каналы и мощность передачи 5 ГГц должны соответствовать местным нормам.
- Для карт TF, GPS, аудио и других периферийных устройств следуйте уровням мощности и логики, указанным в фактической версии оборудования. Не применяйте логический уровень выше 3,3 В к контактам ввода/вывода, если это явно не проверено.
14. История пересмотра документа
| Пастор | Дата | ОПИСАНИЕ | Базовое |
|---|---|---|---|
| V1.1 | 2026-08-25 | Пересмотренные инструкции для карт microSD/TF, батарей и GPIO. | Hefei Zhiluxing Information Technology Co., Ltd. |
- Конец -