ZLX-ESP32-2
ESP32-C5 2.8-inch Touch Display Development Board
คู่มือผู้ใช้ภาษาจีนและอังกฤษ / Bilingual User Manual

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.
|
|
รูปภาพ 1 ขนาดด้านหน้าและหน้าจอ / Figure 1 Board front and display-side dimensions
คำอธิบายประกอบอินเทอร์เฟซ / Connector Identification

รูปภาพ 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/14、ST7789 การเลือกไดรเวอร์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 TX、GPIO9 จับ 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
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 รักษาแรงในแนวตั้งเมื่อเชื่อมต่อเสาอากาศเพื่อหลีกเลี่ยงการงัดด้านข้างซึ่งอาจทำให้ฐาน 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 แสดงให้เห็น | Hefei Zhiluxing Information Technology Co., Ltd. |
— End / เสร็จ -

