ESP32-S38080 并行MRB2801ILI9341TFT 接线
ESP32-S3 并行 TFT 接线(esp32-s3-parallel-tft-wiring)
把 MRB2801 / ILI9341 这类 8080 并行屏正确接到 ESP32-S3,并自写驱动——纠正"把它当 SPI 接"的常见错误。
一、这个 skill 是做什么的
很多带触摸的 2.8 寸 TFT(如 MRB2801、ILI9341 驱动、240×320)是8080 并行接口,不是 SPI。但它背板上丝印的 CLK/MOSI/MISO 又偏偏是触摸芯片 XPT2046 的 SPI 总线——于是大量新手把整块屏当成 SPI 屏去接,结果屏毫无反应。本技能就是要纠正这个误区,并给出正确的 8080 并行接线、ESP32-S3 的 GPIO 预算、8 位电阻改造、3.3V 供电铁律,以及如何在 S3 上自写一个 ILI9341_8080 驱动(因为常用的 MCUFRIEND_kbv 库在 S3 上根本不能用)。
二、什么时候用它
- 把带触摸的 2.8" TFT(MRB2801、ILI9341、240×320)接到 ESP32-S3。
- 你正把 ILI9341 当 SPI 屏接线(用 CLK/MOSI/MISO 当显示 SPI)——这是错的,本技能纠正它。
- 需要在 ESP32-S3(如 N16R8)上做 GPIO 预算、自写 8080 驱动、或对接线/解析逻辑做多方验证。
你可能会听到的"信号原话":
- "我的 ILI9341 用 SPI 接 ESP32-S3 怎么不亮?"
- "MRB2801 这块屏怎么接?它背面写的 CLK/MOSI 是接 SPI 吗?"
- "MCUFRIEND 库在 S3 上用不了,我该怎么驱动这块并行屏?"
三、前置条件 / 准备
- 硬件:ESP32-S3 开发板(如 N16R8)、MRB2801 / ILI9341 并行 TFT 模块、若干杜邦线;若走 8 位模式还需电烙铁改电阻(焊开 R5、短接 R4)。
- 供电:必须有稳定的 3.3V 电源给模块 VDD(模块自带 XC6206 LDO,3.3V 供电时整板 IO 都是 3.3V,与 ESP32 兼容)。
- 软件:Arduino 框架 +
Adafruit_GFX 库(自写驱动继承它);或 ESP-IDF。
- 认知前提:先接受"这是并行屏不是 SPI 屏"这个事实,再谈接线。
四、具体用法(步骤)
铁律(必读,避免重复踩坑)
- MRB2801 是 8080 并行屏,不是 SPI。板上丝印的 CLK/MOSI/MISO 是触摸 XPT2046 的 SPI 总线,不是 ILI9341 的。ILI9341 只有 8080 并行接口(DB0~DB15 + CS/RS/WR/RD/RST)。
- 供电必须 3.3V,严禁 5V。ESP32-S3 的 GPIO 仅 3.3V 耐受,给模块 VDD 喂 5V 会回灌 5V 信号烧坏主控。
- 8 位模式需改电阻。模块默认 R5 短接 = 16 位模式;用 8 位必须焊开 R5、短接 R4(把 IM 配成 8 位),否则数据被错读、屏不亮/花屏。
- MCUFRIEND_kbv 在 S3 上不可用(占 GPIO32/33 且撞 PSRAM、用只对 GPIO0–31 有效的写法),必须自写驱动。
GPIO 预算与接线(参数化模板)
原则:代码只引用参数名,换板只改表,不改驱动。先按板图列出真正空闲脚(排除 strapping 脚、PSRAM 占用脚、原生 USB 占用脚),再数够不够 29 脚。
- LCD 控制:
PIN_LCD_CS / PIN_LCD_RS / PIN_LCD_WR / PIN_LCD_RD / PIN_LCD_RST
- LCD 数据(16 位):
PIN_D0 … PIN_D15 全接
- 背光:
PIN_LCD_BL(输出高=亮,可 PWM)
- 电源:模块 VDD → 3.3V;GND → GND
- 触摸 XPT2046(独立 SPI):
PIN_TS_CLK / PIN_TS_MOSI / PIN_TS_MISO / PIN_TS_CS
- 音频 MAX98357(独立 I2S):
PIN_I2S_BCLK / PIN_I2S_LRC / PIN_I2S_DIN
示例值(仅作参考,须按你的板子修改)见 skill 内 references/mrb2801_wiring.md 的「信号 → 参数名 → 示例 GPIO」表。若空闲脚不足 29 个,才退化为 8 位模式并做电阻改造。
自写 ILI9341_8080 驱动
类 ILI9341_8080 : public Adafruit_GFX(240,320),实现 drawPixel/fillRect/drawFastHLine/drawFastVLine/setAddrWindow;写字节用 GPIO.out_w1tc/w1ts 单次原子操作(仅 GPIO0–31 有效,本方案屏脚都在 0–31);WR 脉冲 wrLow(); wrHigh();;初始化序列 0x01→0x11→0x3A(COLMOD=0x55)→0x36(MADCTL)→0x29;触摸走 SPIClass touchSPI(HSPI); XPT2046_Touchscreen ts(T_CS,255);。
五、可直接照用的示例
你直接对 AI大模型或AI智能体 说:"我买了块 MRB2801 屏,背面写着 CLK/MOSI/MISO,是不是按 SPI 屏接到 ESP32-S3 就行?"
AI大模型或AI智能体 会:立刻纠正——CLK/MOSI/MISO 是触摸芯片的 SPI,ILI9341 本身是 8080 并行屏。会给你上面的 16 位接线表(CS/RS/WR/RD/RST + DB0~DB15),强调 VDD 必须 3.3V,并说明要自写 ILI9341_8080 驱动、不能用 MCUFRIEND 库。
你直接对 AI大模型或AI智能体 说:"N16R8 上我想并口屏 + 触摸 + 功放全保留,GPIO 够用吗?"
AI大模型或AI智能体 会:帮你做 GPIO 预算——16 位并口取空闲脚、控制 5 脚、BL 1 脚、触摸 4 脚、音频 3 脚共 29 脚,空闲还余 5 脚,功放+触摸全保留、无需砍功能、无需改电阻。并提醒避开 0/3/35/36/37。
进阶 / 可选——如果你要验证驱动用到的库字段(如 I2S)在目标 ESP-IDF 版本里确实存在,可以拉头文件核对(raw.githubusercontent 常 DNS 失败,改用 jsdelivr CDN)。
curl -s https://cdn.jsdelivr.net/gh/espressif/esp-idf@release/v4.4/components/driver/include/driver/i2s.h | grep -nE "tx_desc_auto_clear|fixed_mclk|use_apll"
(这只是"验证流程"里的库字段确认一步;实际接线与驱动编写 AI大模型或AI智能体 会手把手带你做。)
六、常见注意 / 避坑
- 把显示当 SPI 接(CLK/MOSI/MISO 实际是触摸)→ 屏无反应。认准 8080 并行的 DB/CS/RS/WR/RD/RST。
- 供电 5V 必烧主控:ESP32-S3 GPIO 仅 3.3V 耐受,模块 VDD 一律 3.3V。
- 8 位模式忘改电阻:默认 16 位,用 8 位必须焊开 R5、短接 R4,否则屏不亮/花屏。
- RD 在写模式必须保持高电平(输出常高即可);不在 26–37 上挂任何 IO(PSRAM 占用)。
- MCUFRIEND_kbv 在 S3 失效:必须自写 8080 驱动,别浪费时间调这个库。
- MADCTL(0x36) 决定方向,上电若镜像只调该字节,不影响接线。
七、相关 skill / 延伸
- esp32-firmware-to-pcb:并行屏接线验证稳定后,想把它做成正式 PCB 打样,用这个反推工程包。
- esp32-tft-hzk16-chinese:屏接好想显示简体中文(命令回显/菜单),用这个内嵌 HZK16 点阵字库。
- arduino-sketch-stub-compile:自写驱动后、烧录前,用这个预检草图能否编译。