1. Общая информация / 1. Product Overview

ZLX-ESP32-2 это продукт, основанный на ESP32-C5-WROOM-1U-N8R8 Модульный 2.8 макетная плата дюймового резистивного сенсорного экрана со встроенным цветом LCD、XPT2046 трогать,microSD/TF Слот для карты (только слот для карты, не входит в комплект поставки) microSD/TF карта),GPS Интерфейс, аудиовыход, определение напряжения аккумулятора, зеленый LED、BOOT/RESET Кнопка и интерфейс внешней антенны. Подходящий Wi-Fi 6、Bluetooth LE、Zigbee/Thread, человеко-машинный интерфейс, запись данных и разработка приложений Интернета вещей.
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.

Основные характеристики / Key Features

• ESP32-C5 32 Кусочек RISC-V Одноядерный процессор, до 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(Встроенные ресурсы модуля, а не microSD/TF Карта) / ESP32-C5-WROOM-1U-N8R8: 8 MB Flash + 8 MB PSRAM (onboard module memory, not a microSD/TF card)

• 2.4 GHz + 5 GHz Двухдиапазонный 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 дюйм 240×320 LCD，ST7789 водить машину,BGR Инициализация, отключить инверсный цвет / 2.8-inch 240×320 LCD, ST7789 driver, BGR initialization, display inversion disabled

• XPT2046 Резистивный сенсорный контроллер / XPT2046 resistive touch controller

• LCD и TF Кард-шеринг SPI автобус, независимый CS;Нажмите, чтобы использовать автономное программное обеспечение. SPI / LCD and TF card share SPI with separate CS; touch uses an independent software SPI

• Размер доски ок. 86 mm × 50 mm / Board size approx. 86 mm × 50 mm

• IPEX1 Внешний антенный интерфейс; перед использованием функции беспроводной связи внешняя антенна должна быть правильно подключена / IPEX1 external antenna connector; connect a suitable external antenna before radio use

Применимые объекты / Intended Users

Подходит для разработчиков встраиваемых систем, разработчиков Интернета вещей, производителей, обучающих экспериментов и проектирования прототипов продуктов.
For embedded developers, IoT developers, makers, education/lab use, and product prototyping.

2. Внешний вид и размер / 2. Appearance and Dimensions

Габаритные размеры платы примерно 86 mm × 50 mm. Следующие изображения спереди и сзади используются для идентификации экрана, интерфейсов и основных компонентов.
The board outline is approximately 86 mm × 50 mm. The images below help identify the display, connectors, and major components.

картина 1 Размеры передней панели и экрана / Figure 1 Board front and display-side dimensions

Выноска интерфейса / Connector Identification

картина 2 ZLX-ESP32-2 Аннотации интерфейса на китайском и английском языках / Figure 2 Bilingual connector identification

3. Технические характеристики макетной платы / 3. Board Specifications

Описание / Note: Родное разрешение экрана 240×320;Если в программе установлено горизонтальное вращение экрана, логический размер дисплея можно выразить как 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 Параметры модуля / 4. ESP32-C5-WROOM-1U-N8R8 Module Specifications

Следующие ключевые параметры основаны на Espressif чиновник 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. Дисплей и сенсорный экран / 5. Display and Touch

LCD Параметры / LCD Parameters

Сенсорные параметры / Touch Parameters

• Тип сенсорного экрана:4 Проводной резистивный сенсорный; Контроллер: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.

• Нажмите, чтобы использовать автономное программное обеспечение. SPI;Процесс средства обнаружения помечен как не требующий калибровки. / Touch uses an independent software SPI; the supplied test flow is marked as requiring no calibration.

6. GPIO картографирование / 6. GPIO Mapping

Следующие сопоставления взяты из клиентской версии, поставляемой с платой. GPIO Таблица и сверено со схемой. Использование встроенных периферийных устройств 19 Обычный GPIO；TX0=GPIO11、RX0=GPIO12 Также используется для UART0；N8R8 из GPIO15 одеяло PSRAM занят, следовательно 21 доступный GPIO Все назначено;EN Не считается работой 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 UART Signals

7. Инструкции по совместному использованию интерфейса и шины / 7. Interface and Bus Sharing

SPI Обмен соображениями / SPI Sharing Notes

• LCD и TF Кард-шеринг GPIO6(SCK)、GPIO7(MOSI)、GPIO2(MISO), но используя соответственно GPIO10(LCD_CS) и 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.

• Включайте одновременно только целевое устройство CS, чтобы избежать конфликтов шины, вызванных одновременным выбором нескольких устройств. / Assert only the target device CS at a time to avoid bus contention.

• Коснитесь XPT2046 Используйте автономное программное обеспечение SPI, а не с LCD/TF Господин SPI часы и MOSI поделился. / The XPT2046 touch controller uses an independent software SPI and does not share the main LCD/TF SCK/MOSI signals.

8. Функция обнаружения соответствия / 8. Functional Test Mapping

9. Интерфейс и электрические соображения / 9. Connector and Electrical Notes

Интерфейс батареи / Battery Connector

Плата для разработки предоставлена 1.25 mm 2-Pin 3.7 V Интерфейс с одной батареей. В соответствии с направлением просмотра отмеченной диаграммы левая сторона является положительным электродом (+), правая часть — отрицательный полюс (-). Если требуется питание от аккумулятора, рекомендуется использовать емкость 1000–3000 mAh, одна секция с платой защиты (схема защиты) 3.7 V Литий-ионный/Литий-полимерный аккумулятор. Перед подключением проверьте характеристики интерфейса, а также положительные и отрицательные полюса. Обратное подключение может повредить макетную плату.
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 проходить 100 kΩ / 100 kΩ Сеть делителя напряжения определяет напряжение батареи, поэтому в идеальных условиях фактическое напряжение батареи составляет приблизительно ADC напряжение на выводе 2 раз. Эта функция предназначена только для оценки напряжения, а не для измерения кулонов топлива.
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 интерфейс / GPS Interface

GPS использовать GPIO0 и GPIO9 как UART Сигнал.GPIO0（GPSTX по имени) в качестве входных данных в определении этой платы, подключите GPS Раздел (модуль) TX；GPIO9（GPSRX по имени) в качестве выхода, подключите GPS Раздел (модуль) RX。1.25 mm 4-Pin Пожалуйста, обратитесь к соответствующей версии оборудования для получения информации о контактах питания и фактической последовательности контактов разъема./Принципиальная схема имеет преимущественную силу.
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 Это версия с внешней антенной. доска IPEX1 Интерфейс должен быть подключен к 2.4/5 GHz Согласование полосы частот и импеданс 50 Ω антенна. Не осуществляйте передачу на высокой мощности в течение длительного периода времени без подсоединенной подходящей антенны.
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

Аудиовыход обеспечивается GPIO8（AUDIOPWM)производить PWM Сигнал,GPIO24（AMP_EN) управляет включением усилителя мощности; верхняя часть доски 2.0 mm 2-Pin Аудио/Интерфейс динамика. Пожалуйста, ознакомьтесь с фактическими возможностями схемы усилителя мощности для различных настроек нагрузки и громкости.
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. Рекомендации по разработке и инициализации программного обеспечения / 10. Software Development and Initialization Notes

• Выбор драйвера дисплея ST7789, собственное разрешение установлено на 240×320;Горизонтальный экран можно повернуть в 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.

• Используемый порядок цветов BGR;Не включать отображение инвертированных цветов (INVON）。 / Use BGR color order; do not enable display inversion (INVON).

• LCD/TF делиться SPI когда, управляется отдельно после инициализации LCD_CS(GPIO10) и SD_CS(GPIO27)。 / When LCD and TF share SPI, manage LCD_CS (GPIO10) and SD_CS (GPIO27) independently after initialization.

• XPT2046 использовать GPIO3/4/5/23/25 независимое программное обеспечение SPI。 / XPT2046 uses an independent software SPI on GPIO3/4/5/23/25.

• При считывании напряжения аккумулятора GPIO1 из ADC Результаты примерно 2:1 Преобразование степени парциального давления в сочетании с ADC Калибровка повышает точность. / 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 5 GHz Wi-Fi channels and transmit power depend on local regulations.

• BOOT/Логика восстановления заводских настроек определяется прошивкой; избегайте ошибочного срабатывания во время работы, приводящего к очистке конфигурации. / BOOT/factory-restore behavior is firmware-defined; avoid unintended activation that may clear settings.

Рекомендуемая последовательность инициализации / Suggested Initialization Sequence

1. Инициализируйте систему и последовательный порт после стабилизации электропитания.
After power is stable, initialize the system and debug UART.

2. инициализация LCD SPI,настраивать ST7789、BGR, выключите инверсию цвета, а затем включите подсветку.
Initialize LCD SPI; configure ST7789, BGR, inversion off, then enable backlight.

3. инициализация XPT2046 трогать.
Initialize XPT2046 touch.

4. Если вам нужно использовать функцию хранения, вставьте подготовленный пользователем совместимый microSD/TF карту, повторно инициализируйте и убедитесь, что LCD_CS и SD_CS Статус правильный.
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. Инициализация по требованию GPS, аудио,LED,Батарея ADC。
Initialize GPS, audio, LED, and battery ADC as needed.

6. Последнее включение Wi-Fi/BLE/802.15.4 Беспроводные возможности.
Enable Wi-Fi/BLE/802.15.4 radio functions as required.

11. Устранение распространенных проблем / 11. Troubleshooting

12. Загрузка данных и техническая поддержка / 12. Downloads and Technical Support

ZLX-ESP32-2 Пожалуйста, предоставьте приоритетный доступ к прошивке, файлам, последующей информации и соответствующей поддержке. ZLX ESP32 Центр поддержки производителей плат для разработки. Пожалуйста, подтвердите то, что указано на странице, прежде чем прошивать прошивку. PCB Модель точно такая же, как и доска в руках.
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.

Загрузка данных / Downloads: https://www.zlxchina.xyz/

Espressif module datasheet / Технические характеристики модуля Эспрессиф: ESP32-C5-WROOM-1 / WROOM-1U Datasheet

Ссылки / References

• ZLX ESP32 Центр поддержки производителей плат для разработки / 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. Использование и меры безопасности / 13. Safety and Handling

• Положительный и отрицательный полюсы должны быть подтверждены перед подключением аккумулятора, обратное подключение запрещено. / Verify battery polarity before connection; never reverse the battery connector.

• Подключите и отключите IPEX При подключении антенны сохраняйте вертикальное усилие, чтобы избежать бокового поддевания, которое может привести к падению радиочастотного основания. / When mating/unmating the IPEX connector, apply force vertically and avoid sideways prying that may damage the RF socket.

• При использовании голой платы макетной платы обратите внимание на электростатическую защиту, чтобы избежать коротких замыканий, вызванных металлическими предметами. / Use ESD precautions with the bare board and prevent metal objects from causing shorts.

• 5 GHz Полоса частот, канал и мощность беспроводной сети должны соответствовать нормативам региона использования. / 5 GHz radio band, channels, and transmit power must comply with local regulations.

• TF По картеGPSПожалуйста, следуйте фактической версии оборудования для возможностей источника питания и уровней периферийных устройств, таких как аудио и видео. Не обращайтесь к нам без подтверждения. IO штифт применен выше 3.3 V уровень. / 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. Запись версии документа / 14. Document Revision History

— End / Заканчивать -