ZLX · Embedded Hardware & Developer Resources
Model: ZLX-ESP32-2

ESP32-C5 2.8 บอร์ดพัฒนาหน้าจอสัมผัส 2.4G/5G dual-band, เสาอากาศ IPEX ภายนอก

B2B · OEM · ODM

Bulk purchasing and customization cooperation

We are from Hefei, Anhui, China - a city famous for its technology and education. We have professional software and hardware R&D and product design capabilities, and can provide customers with services such as hardware design, embedded software development, function customization, product optimization, and OEM/ODM. If you have bulk purchasing, project customization or product development needs, please feel free to contact us.

⌖ Hefei, Anhui, China✉ mq19880204@gmail.com

ZLX-ESP32-2

ESP32-C5 2.8-inch Touch Display Development Board

คู่มือผู้ใช้ภาษาจีนและอังกฤษ / Bilingual User Manual

Picture 1

Model / แบบอย่าง: ZLX-ESP32-2
Module / โมดูล: ESP32-C5-WROOM-1U-N8R8
Document Version / เวอร์ชันเอกสาร: V1.1 | 2026-08-25



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อินเทอร์เฟซระหว่างมนุษย์กับเครื่องจักร การบันทึกข้อมูล และการพัฒนาแอปพลิเคชัน Internet of Things
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 โปรเซสเซอร์แบบ Single-core สูงสุด 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

เหมาะสำหรับนักพัฒนาแบบฝัง นักพัฒนา IoT ผู้ผลิต การทดลองสอน และการออกแบบต้นแบบผลิตภัณฑ์
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.

Picture 2

Picture 3

รูปภาพ 1 ขนาดด้านหน้าและหน้าจอ / Figure 1 Board front and display-side dimensions

คำอธิบายประกอบอินเทอร์เฟซ / Connector Identification

Picture 4

รูปภาพ 2 ZLX-ESP32-2 คำอธิบายประกอบอินเทอร์เฟซภาษาจีนและอังกฤษ / Figure 2 Bilingual connector identification

3. ข้อมูลจำเพาะของบอร์ดพัฒนา / 3. Board Specifications

โครงการ / Item

ข้อมูลจำเพาะ / Specification

โมเดลบอร์ดพัฒนา / Board model

ZLX-ESP32-2

โมดูลหลัก / Core module

ESP32-C5-WROOM-1U-N8R8

ขนาดกระดาน / Board size

Approx. 86 × 50 mm

แสดง / Display

2.8-inch TFT LCD, ST7789, 240×320 native resolution

ลำดับสี / Color order

BGR initialization

แสดงสีย้อนกลับ / Display inversion

OFF / Normal display mode(ห้ามเปิดสีกลับด้าน)

สัมผัส / Touch

Resistive touch / สัมผัสแบบต้านทาน, XPT2046

microSD/TF ช่องเสียบการ์ด / microSD/TF Card Slot

SPI mode; card not included / SPI โหมด; ไม่ได้มาพร้อมกับการ์ด

GPS อินเตอร์เฟซ / GPS interface

1.25 mm 4-pin connector; UART signals on GPIO0/GPIO9

อินเตอร์เฟซเสียง / Audio

2.0 mm 2-pin speaker/audio connector; PWM audio + amplifier enable

อินเตอร์เฟซแบตเตอรี่ / Battery

3.7 V 1S, 1.25 mm 2-pin; protected 1000–3000 mAh recommended / ส่วนเดียว 3.7 V;คำแนะนำ 1000–3000 mAh พร้อมแผ่นป้องกัน

เสาอากาศภายนอก / External antenna

IPEX1 connector; required for the WROOM-1U radio path

ปุ่ม / Buttons

RESET, BOOT

บ่งชี้สถานะ / Indicator

Green LED on GPIO26

แสดงให้เห็น / 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.

โครงการ / Item

ข้อมูลจำเพาะ / Specification

ชิปในตัว / Embedded SoC

ESP32-C5HR8

CPU

32-bit RISC-V single core, up to 240 MHz

ROM

320 KB

HP SRAM

384 KB

LP SRAM

16 KB

Flash

8 MB Quad SPI

PSRAM

8 MB Quad SPI

Wi-Fi

1T1R, 2.4 GHz + 5 GHz dual-band; IEEE 802.11ax/ac/b/g/n; up to 150 Mbps

2.4 GHz ความถี่ / Frequency

2412–2484 MHz

5 GHz ความถี่ / Frequency

5180–5885 MHz (subject to regional regulations)

Bluetooth

Bluetooth LE; Espressif v1.2 feature list states Bluetooth Core 6.0 certified

IEEE 802.15.4

2.4 GHz OQPSK, 250 Kbps

Zigbee / Thread

Zigbee 3.0 / Thread 1.4

GPIO

Up to 22 GPIOs at module level

อุปกรณ์ต่อพ่วงทั่วไป / 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. แสดงผลและสัมผัส / 5. Display and Touch

LCD พารามิเตอร์ / LCD Parameters

โครงการ / Item

ข้อมูลจำเพาะ / Specification

ขนาด / Size

2.8 inch

ขับ IC / 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

  • ประเภทสัมผัส: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.

GPIO

Signal

คำนิยาม / Definition

ทิศทาง / Direction

การทำงาน / Function

แสดงให้เห็น / Notes

0

GPSTX

GPS พอร์ตอนุกรม TX / GPS UART TX

Input / เข้า

GPS test / GPSทดสอบ

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

เสียง PWM / Audio PWM

Output

Audio test

Audio output control

9

GPSRX

GPS พอร์ตอนุกรม RX / 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 แสงไฟ / 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

สีเขียว LED / 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 / ESP32 รีเซ็ตและเปิดใช้งาน

System enable/reset; not a GPIO / เปิดใช้งานระบบ/รีเซ็ต ไม่ได้เป็นของ GPIO

UART0_TX / TX0 / GPIO11

UART0 transmit / UART0 การส่งพอร์ตอนุกรม

Used; excluded from the 19 peripheral GPIO count / ใช้แล้ว; ไม่นับรวมข้างต้น 19 อุปกรณ์ต่อพ่วง GPIO

UART0_RX / RX0 / GPIO12

UART0 receive / UART0 การรับพอร์ตอนุกรม

Used; excluded from the 19 peripheral GPIO count / ใช้แล้ว; ไม่นับรวมข้างต้น 19 อุปกรณ์ต่อพ่วง GPIO

7. คำแนะนำในการแชร์อินเทอร์เฟซและบัส / 7. Interface and Bus Sharing

โครงการ / Item

GPIO

แสดงให้เห็น / Description

LCD + TF SPI แบ่งปัน / Shared SPI

GPIO6 / GPIO7 / GPIO2

SCK, MOSI, MISO shared; devices separated by independent CS / นาฬิกาและสายข้อมูลที่ใช้ร่วมกัน ใช้อย่างอิสระ 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 การแบ่งปันข้อพิจารณา / 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

รายการทดสอบ / 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 การทดสอบการ์ด / 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 ทดสอบ / Wi-Fi

Internal RF

2.4 GHz / 5 GHz scan

No listed GPIO occupied

BLE ทดสอบ / BLE

Internal RF

BLE scan

No listed GPIO occupied

GPS ทดสอบ / GPS

GPIO0, 9

GPS UART data

GPSTX / GPSRX

LED ทดสอบ / LED

GPIO26

Green LED

HIGH on / LOW off

การทดสอบแบตเตอรี่ / Battery

GPIO1

ADC measures divided battery voltage

Voltage estimate, not a coulomb counter

BOOT รีเซ็ตเป็นค่าจากโรงงาน / Factory restore

GPIO28

BOOT input / restore logic

Behavior is defined by firmware

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

คำถาม / Issue

English

วิธีการรักษา / Solution

Solution (EN)

หน้าจอสีขาว/หน้าจอสีดำ

Blank/black display

พิจารณา GPIO6/7/10/13/14ST7789 การเลือกไดรเวอร์BGR การตั้งค่า, แบ็คไลท์ GPIO13 และไม่ว่าจะเปิดสีผกผันโดยไม่ได้ตั้งใจหรือไม่

Check GPIO6/7/10/13/14, ST7789 driver selection, BGR setting, backlight GPIO13, and whether inversion was accidentally enabled.

สีไม่ถูกต้อง

Incorrect colors

ยืนยันว่าลำดับสีของไลบรารีกราฟิกเป็น BGR

Confirm the graphics library is configured for BGR color order.

ไม่มีการตอบสนองต่อการสัมผัส

No touch response

พิจารณา GPIO3/4/5/23/25 และ XPT2046 การเริ่มต้น

Check GPIO3/4/5/23/25 and XPT2046 initialization.

TF การเริ่มต้นการ์ดล้มเหลว

TF card init fails

พิจารณา LCD/TF แบ่งปัน SPI ของ SCK/MOSI/MISOเช่นเดียวกับ SD_CS(GPIO27) และ LCD_CS(GPIO10) ไม่ว่าจะมีความขัดแย้ง.

Check shared SPI SCK/MOSI/MISO and make sure SD_CS (GPIO27) and LCD_CS (GPIO10) are not asserted simultaneously.

Wi-Fi สัญญาณอ่อนหรือไม่สามารถสแกนได้

Weak/no Wi-Fi

ยืนยัน IPEX1 มีการเชื่อมต่อเสาอากาศภายนอกและรองรับการใช้งาน 2.4/5 GHz เสาอากาศที่เหมาะสม

Confirm the IPEX1 external antenna is connected and suitable for 2.4/5 GHz.

การอ่านค่าแรงดันไฟฟ้าของแบตเตอรี่มีค่าประมาณครึ่งหนึ่งของจริง

Battery reading is about half

GPIO1 ส่วนหน้าคือ 100k/100k ความดันบางส่วนจะต้องคูณโดยประมาณเมื่อทำการแปลง 2

GPIO1 uses a 100k/100k divider; multiply the ADC-side voltage by approximately 2.

GPS ไม่มีข้อมูล

No GPS data

ยืนยัน GPIO0 จับ GPS TXGPIO9 จับ GPS RXและตรวจสอบอัตรารับส่งข้อมูลและแหล่งจ่ายไฟ

Confirm GPIO0 receives GPS TX, GPIO9 drives GPS RX, and verify baud rate and power.

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 / ข้อมูลจำเพาะของโมดูล Espressif: ESP32-C5-WROOM-1 / WROOM-1U Datasheet

อ้างอิง / References

13. ข้อควรระวังในการใช้งานและความปลอดภัย / 13. Safety and Handling

  • ต้องยืนยันขั้วบวกและขั้วลบก่อนเชื่อมต่อแบตเตอรี่และห้ามเชื่อมต่อแบบย้อนกลับ / Verify battery polarity before connection; never reverse the battery connector.

  • เสียบปลั๊กแล้วถอดปลั๊ก IPEX รักษาแรงในแนวตั้งเมื่อเชื่อมต่อเสาอากาศเพื่อหลีกเลี่ยงการงัดด้านข้างซึ่งอาจทำให้ฐาน RF หลุดออก / 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

เวอร์ชัน / Rev.

วันที่ / Date

เนื้อหา / Description

แหล่งที่มา / Basis

V1.1

2026-08-25

การแก้ไข:microSD/TF, แบตเตอรี่ และ GPIO แสดงให้เห็น
Revised microSD/TF, battery, and GPIO notes.

Hefei Zhiluxing Information Technology Co., Ltd.

 End / เสร็จ -