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 上根本不能用)。

二、什么时候用它

你可能会听到的"信号原话":

三、前置条件 / 准备

四、具体用法(步骤)

铁律(必读,避免重复踩坑)

  1. MRB2801 是 8080 并行屏,不是 SPI。板上丝印的 CLK/MOSI/MISO 是触摸 XPT2046 的 SPI 总线,不是 ILI9341 的。ILI9341 只有 8080 并行接口(DB0~DB15 + CS/RS/WR/RD/RST)。
  2. 供电必须 3.3V,严禁 5V。ESP32-S3 的 GPIO 仅 3.3V 耐受,给模块 VDD 喂 5V 会回灌 5V 信号烧坏主控。
  3. 8 位模式需改电阻。模块默认 R5 短接 = 16 位模式;用 8 位必须焊开 R5、短接 R4(把 IM 配成 8 位),否则数据被错读、屏不亮/花屏。
  4. MCUFRIEND_kbv 在 S3 上不可用(占 GPIO32/33 且撞 PSRAM、用只对 GPIO0–31 有效的写法),必须自写驱动。

GPIO 预算与接线(参数化模板)

原则:代码只引用参数名,换板只改表,不改驱动。先按板图列出真正空闲脚(排除 strapping 脚、PSRAM 占用脚、原生 USB 占用脚),再数够不够 29 脚。

示例值(仅作参考,须按你的板子修改)见 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智能体 会手把手带你做。)

六、常见注意 / 避坑

七、相关 skill / 延伸

← 返回 SKILL 库