1. 项目概述与核心价值最近在捣鼓一个挺有意思的小项目用ESP32和两块便宜的ST7735屏幕做一对会动的“眼睛”。这玩意儿看着挺酷灵感其实来源于Adafruit经典的“Uncanny Eyes”项目但咱们这次用更主流的ESP32和TFT_eSPI库来实现成本能压到很低两块屏加一个开发板网上淘一淘十块钱左右就能搞定。对于想入门嵌入式图形或者给机器人、玩偶、万圣节道具做个互动眼睛的朋友来说这是个绝佳的练手项目。它本质上是一个嵌入式图形应用核心就是让微控制器MCU驱动TFT液晶屏实时渲染出逼真的眼球动画包括瞳孔的移动、眨眼等效果。这里面的技术栈涉及SPI通信、图形缓冲、DMA数据传输以及如何高效地组织代码和资源。我折腾下来发现虽然TFT_eSPI库已经帮我们封装了大部分脏活累活但要想让动画跑得流畅不卡顿中间还是有不少门道和坑需要留意。这篇文章我就把自己从硬件连线、软件配置到性能调优的全过程以及踩过的那些坑都详细记录下来希望能帮你少走弯路一次成功。2. 硬件选型与连接方案解析2.1 核心硬件清单与选型理由这个项目的硬件部分非常精简核心就三样主控、屏幕和供电。主控芯片ESP32我选择ESP32作为主控主要基于以下几点考虑性能与价格平衡ESP32双核240MHz的主频对于渲染128x128分辨率的图形绰绰有余而且价格极其亲民。丰富的外设与内存项目需要驱动两块屏幕SPI接口和足够的RAM是关键。ESP32有多个SPI接口HSPI和VSPI并且片上SRAM通常有520KB足以容纳图形缓冲区和程序运行所需空间。DMA支持这是实现流畅动画的“秘密武器”。ESP32的SPI外设支持DMA直接内存访问意味着在向屏幕发送图像数据时CPU可以“抽身”去处理下一帧的计算极大地提升了数据传输效率和整体帧率。生态完善在Arduino IDE和PlatformIO中都有非常好的支持库资源丰富社区活跃遇到问题容易找到解决方案。当然原文也提到了ESP8266和STM32作为备选。ESP8266单核且主频较低内存也更小运行起来帧率会低一些动画可能不够“跟手”但做个简单的演示没问题。STM32系列尤其是F4/F7系列性能强悍且原生支持硬件图形加速是更高阶的选择但开发环境搭建相对复杂一些。对于初次尝试ESP32是性价比和易用性综合最佳的选择。显示屏ST7735驱动的1.44英寸128x128 TFT屏市面上这种屏很多通常被称为“1.44寸IPS屏”或“1.44寸TFT”。选择它是因为成本极低单价通常在5元以内是学习嵌入式图形最经济的入门选择。接口简单采用4线SPI接口SCK, MOSI, DC, CS加上电源和背光接线非常清晰只需要主控的少量GPIO。驱动成熟ST7735是经典驱动芯片TFT_eSPI库对其支持非常完善有现成的优化设置。分辨率适中128x128对于绘制一只细节丰富的眼睛来说足够同时又不至于给ESP32带来过大的渲染压力。注意购买时务必确认是“4线SPI”接口并询问卖家具体的引脚定义尤其是RESET和背光控制引脚不同批次的屏幕引脚顺序可能有差异。其他材料面包板和杜邦线用于原型搭建和测试。但请注意如果项目需要移动或用于穿戴设备面包板连接非常不可靠极易接触不良导致屏幕闪烁或熄灭。最终成品强烈建议焊接。供电调试时可用电脑USB供电。独立运行时一个普通的5V/1A的USB充电宝就完全足够。2.2 电路连接详解与避坑指南连接两块屏幕到同一个ESP32原理是共享SPI总线SCK, MOSI但使用不同的片选CS和数据/命令DC引脚进行区分。下面是我实测可用的连接方案以ESP32 DevKit V1为例ESP32引脚功能屏幕1连接屏幕2连接备注3.3V电源VCCVCC绝对不要接5V会烧屏。GND地GNDGND共地。GPIO 18SPI SCK (时钟)SCKSCK共享时钟线。GPIO 23SPI MOSI (主出从入)SDA (或 MOSI)SDA (或 MOSI)共享数据线。GPIO 2TFT_CS (片选1)CS-用于选择屏幕1。GPIO 15TFT_CS (片选2)-CS用于选择屏幕2。GPIO 4TFT_DC (数据/命令1)DC (或 A0)-告诉屏幕当前发送的是数据还是命令。GPIO 5TFT_DC (数据/命令2)-DC (或 A0)GPIO 22预留可用于背光控制BLKBLK背光控制非必需可直接接3.3V常亮。- (任意GPIO)TFT_RST (复位)RESETRESET可共用一根复位线或接ESP32的EN引脚。连接时的核心要点与常见坑点电源是关键务必使用3.3V为屏幕供电。很多屏幕模块自带3.3V稳压但输入脚标着VCC接5V也能亮但这会缩短寿命或导致色彩异常。最稳妥的方法是测量模块的稳压芯片型号确认。共享SPI总线SCK和MOSI必须并联到两块屏幕这是SPI总线的工作方式。独立的CS和DC这是驱动多块屏幕的核心。每个屏幕必须有自己独立的CS和DC引脚由程序控制分时通信。复位引脚处理可以将两块屏幕的RESET引脚并联然后连接到一个ESP32的GPIO如GPIO21或者直接接到ESP32的EN复位引脚上。这样上电或程序复位时屏幕也能同步复位。背光控制如果屏幕的BLK引脚是低电平点亮可以像上表那样用GPIO控制。如果是高电平点亮则需要接上拉电阻或直接接VCC。为了省事我通常直接接VCC让背光常亮。实操心得在面包板上搭建时先用万用表蜂鸣档检查所有连接是否导通尤其是GND和3.3V。很多“屏幕不亮”的问题都是电源或地线虚接导致的。焊接时建议使用排针和排母方便日后调试和更换。3. 软件环境搭建与库配置3.1 Arduino IDE与板卡支持安装首先确保你安装了最新版的Arduino IDE1.8.x或2.x均可。接着需要为ESP32安装开发板支持包。打开Arduino IDE进入文件 - 首选项。在“附加开发板管理器网址”中填入以下网址如果已有其他用逗号分隔https://espressif.github.io/arduino-esp32/package_esp32_index.json点击“好”保存然后打开工具 - 开发板 - 开发板管理器。在搜索框中输入“esp32”找到由“Espressif Systems”提供的“esp32”平台点击安装。这个过程会下载所有必要的工具链和库需要一些时间。安装完成后在工具 - 开发板列表中就能选择“ESP32 Dev Module”或其他合适的型号。3.2 TFT_eSPI库的安装与关键配置这是项目的核心图形库。可以通过Arduino IDE的库管理器安装项目 - 加载库 - 管理库...搜索“TFT_eSPI”找到Bodmer的版本进行安装。务必安装2.3.4或更高版本旧版本可能不包含我们需要的动画眼睛例程。安装后库的配置才是重中之重。TFT_eSPI库通过用户配置文件来适配不同的屏幕和主板我们需要修改它。找到库目录。通常在我的文档\Arduino\libraries\TFT_eSPI或Arduino IDE安装目录下的libraries文件夹里。进入该目录你会看到一个名为User_Setups的文件夹里面有很多预设的配置文件如Setup43_ST7735.h。我们不是直接修改这些而是修改根目录下的User_Setup.h文件。重要不要动User_Setup.h正确做法是在User_Setups文件夹里找到一个与你屏幕最匹配的配置文件例如对于常见的128x128 ST7735屏Setup47_ST7735.h是个很好的起点。复制这个文件然后重命名为User_Setup.h并覆盖根目录下原有的User_Setup.h文件。现在用文本编辑器打开这个新的User_Setup.h文件。我们需要修改几个关键地方// 示例基于 Setup47_ST7735.h 的修改片段 #define ST7735_DRIVER // 启用ST7735驱动这行通常已存在 #define TFT_WIDTH 128 #define TFT_HEIGHT 128 // 设置屏幕尺寸 // 最关键注释掉或删除原有的 TFT_CS, TFT_DC 定义 // #define TFT_CS PIN_DX // 芯片选择控制引脚 // #define TFT_DC PIN_DX // 数据/命令控制引脚 // 因为我们将在主程序中动态控制多个屏幕的CS和DC所以这里不能全局定义。 // 但其他引脚如RST、背光可以保留或根据你的连接修改。 #define TFT_RST -1 // 设为-1如果共用复位线或由其他方式控制 #define TFT_BL -1 // 背光控制引脚-1为常亮 // 启用ESP32的硬件SPI并指定引脚通常不需要改除非你用非标准引脚 #define TFT_SPI_PORT SPI // 使用HSPI或VSPI #define TFT_MISO 19 #define TFT_MOSI 23 #define TFT_SCLK 18为什么必须注释掉TFT_CS和TFT_DC在单屏幕例程中库需要知道默认的CS和DC引脚。但在我们的双屏项目中每个屏幕都有自己的CS和DC引脚并且需要在程序运行时动态切换。如果在库配置中写死了库就会一直尝试控制那个固定的引脚导致我们无法分时控制两块屏幕。因此这个定义必须移到主程序里去做。3.3 获取并理解动画眼睛例程配置好库之后在Arduino IDE中打开示例文件 - 示例 - TFT_eSPI - 320 x 240 - Animated_Eyes_2。这个Animated_Eyes_2.ino就是为我们双屏项目量身定制的。打开后你会发现它除了主.ino文件还包含了eye.ino和config.h等标签页。我们需要重点关注config.h。4. 项目代码剖析与核心参数配置4.1 config.h 文件深度配置config.h文件是连接我们硬件连接和软件逻辑的桥梁。必须根据你实际的接线情况准确修改其中的引脚定义。// config.h 内容示例根据前文的连接表修改 #define DISPLAY_COUNT 2 // 使用的屏幕数量2代表双屏 // 第一块屏幕的引脚定义 #define TFT_CS_1 2 // GPIO2 连接屏幕1的CS #define TFT_DC_1 4 // GPIO4 连接屏幕1的DC // 第二块屏幕的引脚定义 #define TFT_CS_2 15 // GPIO15 连接屏幕2的CS #define TFT_DC_2 5 // GPIO5 连接屏幕2的DC // 共享的SPI引脚应与User_Setup.h中一致或在主程序中重定义 #define TFT_MOSI 23 #define TFT_SCLK 18 // MISO对于纯输出的屏幕可以不用定义 // #define TFT_MISO 19 // 复位引脚如果共用 #define TFT_RST -1 // 使用软件复位或指定具体引脚如22 // 性能关键设置 #define SPI_FREQUENCY 27000000 // SPI时钟频率单位Hz。ST7735最高约27MHz #define SPI_READ_FREQUENCY 20000000 // 读频率可设低些 #define SPI_TOUCH_FREQUENCY 2500000 // 触摸屏频率本项目无用 // 是否使用DMA #define USE_DMA // 注释掉此行以禁用DMA参数解读与调优建议SPI_FREQUENCY(SPI时钟频率)这是影响帧率的最重要参数之一。ST7735数据手册标称最高时钟为15MHz但实际上很多模块能在27MHz甚至40MHz下稳定工作。可以从20MHz开始测试逐步提高直到屏幕出现雪花、花屏或数据错乱然后退回一个稳定值。27MHz是一个广泛验证过的、比较稳定的高速设置。USE_DMA(使用DMA)务必启用启用后库会使用ESP32的DMA通道来传输屏幕数据。实测中启用DMA可以将帧率提升30%-50%以上并且能大幅降低CPU占用率让CPU有更多时间处理眼球运动的逻辑动画会更加流畅跟手。引脚定义再次核对TFT_CS_x和TFT_DC_x是否与你的物理连接一一对应。一个常见的错误是CS和DC接反或者两块屏幕的定义弄混导致只有一块屏有显示或者显示混乱。4.2 主程序逻辑与眼球动画原理主程序Animated_Eyes_2.ino的结构非常清晰。它创建了两个TFT_eSPI对象tft1和tft2分别对应两块屏幕。在setup()函数中初始化这两个对象并传入各自的CS和DC引脚编号。动画的核心在loop()函数和eye.ino文件中。其工作原理可以概括为状态更新根据时间或随机算法计算眼球下一帧的状态。包括瞳孔位置通常模拟眼球跟随一个“目标点”移动这个目标点可以按轨迹运动如八字形或随机微动。眨眼状态用一个周期函数如正弦波控制眼皮的开合程度模拟眨眼。眼球缩放模拟注视远近物体时的瞳孔大小变化。图形渲染每一帧程序都会在内存中的一个“画布”缓冲区上重新绘制整个眼球。顺序通常是眼白底色 - 虹膜纹理 - 瞳孔 - 高光 - 眼皮覆盖在上方。TFT_eSPI库提供了画圆、填充、绘制位图等基本函数用于构建这些图形元素。数据传输渲染好一帧图像后通过SPI接口利用DMA将整帧图像数据快速发送到对应的TFT屏幕。由于DMA的存在这个传输过程几乎不占用CPU时间。eye.ino文件里包含了所有绘制眼球的函数如drawEye()。你可以在这里找到控制眼球外观的所有参数虹膜颜色、瞳孔大小、眼皮形状等。修改这里就能创造出不同风格的眼睛比如猫眼、机器人眼、血丝眼等等。实操心得性能瓶颈分析帧率FPS主要受限于两点SPI数据传输速度和CPU渲染计算速度。SPI速度通过提高SPI_FREQUENCY和启用USE_DMA来优化。这是提升帧率最有效的手段。CPU渲染绘制复杂图形如高分辨率虹膜位图、复杂眼皮形状会消耗更多时间。如果帧率不足可以尝试简化图形例如使用纯色虹膜代替纹理位图或者减少眼皮的细节。一个简单的测试方法在loop()中注释掉drawEye()调用只执行清屏和画一个简单图形看看帧率是否大幅提升。如果是说明瓶颈在渲染如果变化不大说明瓶颈可能在SPI传输或DMA设置上。5. 编译、上传与调试实战5.1 编译设置与上传步骤在Arduino IDE中选择正确的开发板工具 - 开发板 - ESP32 Arduino - ESP32 Dev Module。选择正确的端口工具 - 端口。在工具菜单中进行以下关键设置Upload Speed: 921600(提高上传速度)Flash Frequency: 80MHzFlash Mode: QIO(默认)Partition Scheme: Default 4MB with spiffs (1.2MB APP/1.5MB SPIFFS)或Huge APP (3MB No OTA/1MB SPIFFS)。由于程序较大建议选择后者以提供更多程序空间。Core Debug Level: 无点击上传按钮。首次上传可能会比较慢因为需要编译整个库和程序。5.2 常见问题与排查技巧实录即使按照步骤操作第一次运行时也能遇到问题。下面是我遇到过的典型问题及解决方法现象可能原因排查步骤与解决方案编译错误1. 库版本不兼容。2.User_Setup.h配置错误。3. 引脚重复定义。1. 确保TFT_eSPI库为2.3.4。2. 检查User_Setup.h中是否注释了TFT_CS和TFT_DC。3. 检查config.h和主程序中是否有引脚冲突。上传失败1. 端口被占用或选择错误。2. ESP32未进入下载模式需按BOOT键。3. 驱动问题。1. 拔插USB线重选端口。2. 上传时先按住BOOT键不放再按一下ENRST键然后松开EN键再松开BOOT键。3. 安装CP210x或CH340 USB转串口驱动。屏幕白屏或全亮1. 电源问题电压/电流不足。2. 复位信号问题。3. 初始化序列错误。1. 用万用表测量屏幕VCC脚是否为稳定3.3V。2. 检查RST引脚连接尝试在setup()开头加digitalWrite(TFT_RST, LOW); delay(10); digitalWrite(TFT_RST, HIGH); delay(100);进行软件复位。3. 确认User_Setup.h中的驱动芯片型号ST7735_DRIVER是否正确。只有一块屏幕亮1. 第二块屏幕的CS或DC引脚定义错误或接触不良。2. 程序只初始化了一块屏幕。1. 用万用表检查第二块屏幕的CS、DC线是否连通到正确的ESP32引脚。2. 检查config.h中DISPLAY_COUNT是否为2并确认tft2的初始化代码被执行。屏幕花屏、闪烁、错位1. SPI时钟频率过高。2. DMA缓冲区冲突或设置不当。3. 电源纹波干扰。1. 逐步降低SPI_FREQUENCY如从27M降到20M测试。2. 尝试在config.h中注释掉#define USE_DMA以禁用DMA看是否恢复正常。如果正常可能是DMA通道冲突尝试在User_Setup.h中修改#define DMA_CHANNEL 1可以是1或2。3. 在屏幕的VCC和GND之间并联一个100uF的电解电容和一个0.1uF的陶瓷电容滤除电源噪声。动画卡顿帧率低1. DMA未启用。2. SPI频率设置过低。3. 渲染逻辑过于复杂。4. 程序使用了delay()函数阻塞。1. 确认USE_DMA已定义。2. 在稳定前提下尝试提高SPI频率。3. 简化eye.ino中的绘图函数例如用fillCircle代替drawBitmap绘制虹膜。4. 避免在loop()中使用delay()用millis()进行非阻塞定时。瞳孔不移动或移动怪异眼球运动算法参数问题或计算溢出。检查eye.ino中计算瞳孔位置的函数如moveEye()。确保目标点坐标在合理范围内例如相对于屏幕中心。可以添加串口打印输出瞳孔的目标坐标进行调试。一个高级调试技巧添加帧率显示为了直观了解性能可以在代码中添加帧率计算和显示虽然会额外消耗一些性能。// 在全局变量区 unsigned long lastFrameTime 0; float fps 0; // 在loop()函数中每帧绘制完成后 unsigned long currentTime millis(); if (currentTime - lastFrameTime 1000) { // 每秒更新一次 fps frameCount; // frameCount需要在每帧loop中自增 frameCount 0; lastFrameTime currentTime; // 可以选择在屏幕角落显示fps会占用渲染时间 // tft1.setCursor(0,0); // tft1.printf(FPS:%.1f, fps); } Serial.printf(FPS: %.1f\n, fps); // 通过串口监视器查看更准确6. 优化、定制与进阶玩法项目成功运行后你就可以开始发挥创意进行定制和优化了。6.1 外观定制创造独一无二的眼睛所有视觉参数都在eye.ino文件中。你可以修改虹膜颜色和纹理修改drawEye()函数中绘制虹膜的部分。可以将纯色填充改为渐变色或者加载一个小型位图作为纹理注意内存占用。瞳孔大小与形状调整瞳孔半径的计算公式甚至可以尝试绘制非圆形的瞳孔。眼皮动画eyeLid()函数控制眨眼。你可以修改其运动曲线让眨眼更快或更慢或者创造“双眨眼”、“半眯眼”等效果。添加血丝或光晕在眼白上随机画一些细红线模拟血丝或在瞳孔周围绘制径向渐变光晕。6.2 交互升级让眼睛“活”起来基础例程的眼睛是自主运动的。我们可以通过添加传感器让它与环境互动。跟随移动添加一个超声波传感器如HC-SR04或TOF传感器根据检测到的物体距离动态调整瞳孔大小模拟对焦。注视方向使用两个舵机云台让整个眼睛模块可以物理转动结合程序控制实现真正的“注视”功能。情绪表达通过一个按钮或语音模块切换不同的“情绪模式”例如正常、惊讶、困倦、愤怒每种模式对应不同的瞳孔大小、眼皮位置和移动速度。6.3 电源管理与成品化如果打算将其用作可穿戴设备或长期展示降低功耗ESP32具有深度睡眠模式。如果不需要眼睛常亮可以设置为每隔几秒唤醒一次执行一次眨眼或眼球转动然后继续睡眠极大延长电池续航。完善供电使用一个小的锂电池如3.7V 18650配合充放电管理模块为整个系统供电。注意ESP32和屏幕都需要3.3V所以需要选择输出3.3V的降压模块。结构封装使用3D打印或激光切割制作一个眼窝形状的外壳将屏幕、ESP32和电池封装进去只露出显示部分。这不仅能保护电路也能让视觉效果更逼真。最后关于原文评论区有人问到的“如何移除眼皮”其实很简单。在drawEye()函数里找到绘制上眼皮和下眼皮的函数调用通常是fillRect或fillTriangle等将它们注释掉即可。这样就会一直显示一个圆睁的眼睛。同理你也可以修改这部分代码来实现“半闭眼”或其他的静态眼型。这个项目就像一把钥匙打开了嵌入式图形和实时动画的大门。从让两个小方块动起来到创造出能传递情绪的眼睛整个过程充满了硬件调试和软件调优的乐趣。我最深的体会是嵌入式开发中“稳定优先于炫酷”。一开始总想追求最高的帧率和最复杂的特效但往往先遭遇的是电源不稳、信号干扰、内存溢出这些基础问题。把SPI频率调低一点给电源加个电容仔细检查每一根飞线这些看似枯燥的工作才是项目最终能稳定运行的基础。当你看到自己创造的眼睛流畅地跟随、自然地眨眼时那种成就感远超过单纯调通一个例程。
ESP32驱动双ST7735屏实现流畅眼球动画：硬件连接、软件配置与性能调优全解析
发布时间：2026/6/5 18:36:46
1. 项目概述与核心价值最近在捣鼓一个挺有意思的小项目用ESP32和两块便宜的ST7735屏幕做一对会动的“眼睛”。这玩意儿看着挺酷灵感其实来源于Adafruit经典的“Uncanny Eyes”项目但咱们这次用更主流的ESP32和TFT_eSPI库来实现成本能压到很低两块屏加一个开发板网上淘一淘十块钱左右就能搞定。对于想入门嵌入式图形或者给机器人、玩偶、万圣节道具做个互动眼睛的朋友来说这是个绝佳的练手项目。它本质上是一个嵌入式图形应用核心就是让微控制器MCU驱动TFT液晶屏实时渲染出逼真的眼球动画包括瞳孔的移动、眨眼等效果。这里面的技术栈涉及SPI通信、图形缓冲、DMA数据传输以及如何高效地组织代码和资源。我折腾下来发现虽然TFT_eSPI库已经帮我们封装了大部分脏活累活但要想让动画跑得流畅不卡顿中间还是有不少门道和坑需要留意。这篇文章我就把自己从硬件连线、软件配置到性能调优的全过程以及踩过的那些坑都详细记录下来希望能帮你少走弯路一次成功。2. 硬件选型与连接方案解析2.1 核心硬件清单与选型理由这个项目的硬件部分非常精简核心就三样主控、屏幕和供电。主控芯片ESP32我选择ESP32作为主控主要基于以下几点考虑性能与价格平衡ESP32双核240MHz的主频对于渲染128x128分辨率的图形绰绰有余而且价格极其亲民。丰富的外设与内存项目需要驱动两块屏幕SPI接口和足够的RAM是关键。ESP32有多个SPI接口HSPI和VSPI并且片上SRAM通常有520KB足以容纳图形缓冲区和程序运行所需空间。DMA支持这是实现流畅动画的“秘密武器”。ESP32的SPI外设支持DMA直接内存访问意味着在向屏幕发送图像数据时CPU可以“抽身”去处理下一帧的计算极大地提升了数据传输效率和整体帧率。生态完善在Arduino IDE和PlatformIO中都有非常好的支持库资源丰富社区活跃遇到问题容易找到解决方案。当然原文也提到了ESP8266和STM32作为备选。ESP8266单核且主频较低内存也更小运行起来帧率会低一些动画可能不够“跟手”但做个简单的演示没问题。STM32系列尤其是F4/F7系列性能强悍且原生支持硬件图形加速是更高阶的选择但开发环境搭建相对复杂一些。对于初次尝试ESP32是性价比和易用性综合最佳的选择。显示屏ST7735驱动的1.44英寸128x128 TFT屏市面上这种屏很多通常被称为“1.44寸IPS屏”或“1.44寸TFT”。选择它是因为成本极低单价通常在5元以内是学习嵌入式图形最经济的入门选择。接口简单采用4线SPI接口SCK, MOSI, DC, CS加上电源和背光接线非常清晰只需要主控的少量GPIO。驱动成熟ST7735是经典驱动芯片TFT_eSPI库对其支持非常完善有现成的优化设置。分辨率适中128x128对于绘制一只细节丰富的眼睛来说足够同时又不至于给ESP32带来过大的渲染压力。注意购买时务必确认是“4线SPI”接口并询问卖家具体的引脚定义尤其是RESET和背光控制引脚不同批次的屏幕引脚顺序可能有差异。其他材料面包板和杜邦线用于原型搭建和测试。但请注意如果项目需要移动或用于穿戴设备面包板连接非常不可靠极易接触不良导致屏幕闪烁或熄灭。最终成品强烈建议焊接。供电调试时可用电脑USB供电。独立运行时一个普通的5V/1A的USB充电宝就完全足够。2.2 电路连接详解与避坑指南连接两块屏幕到同一个ESP32原理是共享SPI总线SCK, MOSI但使用不同的片选CS和数据/命令DC引脚进行区分。下面是我实测可用的连接方案以ESP32 DevKit V1为例ESP32引脚功能屏幕1连接屏幕2连接备注3.3V电源VCCVCC绝对不要接5V会烧屏。GND地GNDGND共地。GPIO 18SPI SCK (时钟)SCKSCK共享时钟线。GPIO 23SPI MOSI (主出从入)SDA (或 MOSI)SDA (或 MOSI)共享数据线。GPIO 2TFT_CS (片选1)CS-用于选择屏幕1。GPIO 15TFT_CS (片选2)-CS用于选择屏幕2。GPIO 4TFT_DC (数据/命令1)DC (或 A0)-告诉屏幕当前发送的是数据还是命令。GPIO 5TFT_DC (数据/命令2)-DC (或 A0)GPIO 22预留可用于背光控制BLKBLK背光控制非必需可直接接3.3V常亮。- (任意GPIO)TFT_RST (复位)RESETRESET可共用一根复位线或接ESP32的EN引脚。连接时的核心要点与常见坑点电源是关键务必使用3.3V为屏幕供电。很多屏幕模块自带3.3V稳压但输入脚标着VCC接5V也能亮但这会缩短寿命或导致色彩异常。最稳妥的方法是测量模块的稳压芯片型号确认。共享SPI总线SCK和MOSI必须并联到两块屏幕这是SPI总线的工作方式。独立的CS和DC这是驱动多块屏幕的核心。每个屏幕必须有自己独立的CS和DC引脚由程序控制分时通信。复位引脚处理可以将两块屏幕的RESET引脚并联然后连接到一个ESP32的GPIO如GPIO21或者直接接到ESP32的EN复位引脚上。这样上电或程序复位时屏幕也能同步复位。背光控制如果屏幕的BLK引脚是低电平点亮可以像上表那样用GPIO控制。如果是高电平点亮则需要接上拉电阻或直接接VCC。为了省事我通常直接接VCC让背光常亮。实操心得在面包板上搭建时先用万用表蜂鸣档检查所有连接是否导通尤其是GND和3.3V。很多“屏幕不亮”的问题都是电源或地线虚接导致的。焊接时建议使用排针和排母方便日后调试和更换。3. 软件环境搭建与库配置3.1 Arduino IDE与板卡支持安装首先确保你安装了最新版的Arduino IDE1.8.x或2.x均可。接着需要为ESP32安装开发板支持包。打开Arduino IDE进入文件 - 首选项。在“附加开发板管理器网址”中填入以下网址如果已有其他用逗号分隔https://espressif.github.io/arduino-esp32/package_esp32_index.json点击“好”保存然后打开工具 - 开发板 - 开发板管理器。在搜索框中输入“esp32”找到由“Espressif Systems”提供的“esp32”平台点击安装。这个过程会下载所有必要的工具链和库需要一些时间。安装完成后在工具 - 开发板列表中就能选择“ESP32 Dev Module”或其他合适的型号。3.2 TFT_eSPI库的安装与关键配置这是项目的核心图形库。可以通过Arduino IDE的库管理器安装项目 - 加载库 - 管理库...搜索“TFT_eSPI”找到Bodmer的版本进行安装。务必安装2.3.4或更高版本旧版本可能不包含我们需要的动画眼睛例程。安装后库的配置才是重中之重。TFT_eSPI库通过用户配置文件来适配不同的屏幕和主板我们需要修改它。找到库目录。通常在我的文档\Arduino\libraries\TFT_eSPI或Arduino IDE安装目录下的libraries文件夹里。进入该目录你会看到一个名为User_Setups的文件夹里面有很多预设的配置文件如Setup43_ST7735.h。我们不是直接修改这些而是修改根目录下的User_Setup.h文件。重要不要动User_Setup.h正确做法是在User_Setups文件夹里找到一个与你屏幕最匹配的配置文件例如对于常见的128x128 ST7735屏Setup47_ST7735.h是个很好的起点。复制这个文件然后重命名为User_Setup.h并覆盖根目录下原有的User_Setup.h文件。现在用文本编辑器打开这个新的User_Setup.h文件。我们需要修改几个关键地方// 示例基于 Setup47_ST7735.h 的修改片段 #define ST7735_DRIVER // 启用ST7735驱动这行通常已存在 #define TFT_WIDTH 128 #define TFT_HEIGHT 128 // 设置屏幕尺寸 // 最关键注释掉或删除原有的 TFT_CS, TFT_DC 定义 // #define TFT_CS PIN_DX // 芯片选择控制引脚 // #define TFT_DC PIN_DX // 数据/命令控制引脚 // 因为我们将在主程序中动态控制多个屏幕的CS和DC所以这里不能全局定义。 // 但其他引脚如RST、背光可以保留或根据你的连接修改。 #define TFT_RST -1 // 设为-1如果共用复位线或由其他方式控制 #define TFT_BL -1 // 背光控制引脚-1为常亮 // 启用ESP32的硬件SPI并指定引脚通常不需要改除非你用非标准引脚 #define TFT_SPI_PORT SPI // 使用HSPI或VSPI #define TFT_MISO 19 #define TFT_MOSI 23 #define TFT_SCLK 18为什么必须注释掉TFT_CS和TFT_DC在单屏幕例程中库需要知道默认的CS和DC引脚。但在我们的双屏项目中每个屏幕都有自己的CS和DC引脚并且需要在程序运行时动态切换。如果在库配置中写死了库就会一直尝试控制那个固定的引脚导致我们无法分时控制两块屏幕。因此这个定义必须移到主程序里去做。3.3 获取并理解动画眼睛例程配置好库之后在Arduino IDE中打开示例文件 - 示例 - TFT_eSPI - 320 x 240 - Animated_Eyes_2。这个Animated_Eyes_2.ino就是为我们双屏项目量身定制的。打开后你会发现它除了主.ino文件还包含了eye.ino和config.h等标签页。我们需要重点关注config.h。4. 项目代码剖析与核心参数配置4.1 config.h 文件深度配置config.h文件是连接我们硬件连接和软件逻辑的桥梁。必须根据你实际的接线情况准确修改其中的引脚定义。// config.h 内容示例根据前文的连接表修改 #define DISPLAY_COUNT 2 // 使用的屏幕数量2代表双屏 // 第一块屏幕的引脚定义 #define TFT_CS_1 2 // GPIO2 连接屏幕1的CS #define TFT_DC_1 4 // GPIO4 连接屏幕1的DC // 第二块屏幕的引脚定义 #define TFT_CS_2 15 // GPIO15 连接屏幕2的CS #define TFT_DC_2 5 // GPIO5 连接屏幕2的DC // 共享的SPI引脚应与User_Setup.h中一致或在主程序中重定义 #define TFT_MOSI 23 #define TFT_SCLK 18 // MISO对于纯输出的屏幕可以不用定义 // #define TFT_MISO 19 // 复位引脚如果共用 #define TFT_RST -1 // 使用软件复位或指定具体引脚如22 // 性能关键设置 #define SPI_FREQUENCY 27000000 // SPI时钟频率单位Hz。ST7735最高约27MHz #define SPI_READ_FREQUENCY 20000000 // 读频率可设低些 #define SPI_TOUCH_FREQUENCY 2500000 // 触摸屏频率本项目无用 // 是否使用DMA #define USE_DMA // 注释掉此行以禁用DMA参数解读与调优建议SPI_FREQUENCY(SPI时钟频率)这是影响帧率的最重要参数之一。ST7735数据手册标称最高时钟为15MHz但实际上很多模块能在27MHz甚至40MHz下稳定工作。可以从20MHz开始测试逐步提高直到屏幕出现雪花、花屏或数据错乱然后退回一个稳定值。27MHz是一个广泛验证过的、比较稳定的高速设置。USE_DMA(使用DMA)务必启用启用后库会使用ESP32的DMA通道来传输屏幕数据。实测中启用DMA可以将帧率提升30%-50%以上并且能大幅降低CPU占用率让CPU有更多时间处理眼球运动的逻辑动画会更加流畅跟手。引脚定义再次核对TFT_CS_x和TFT_DC_x是否与你的物理连接一一对应。一个常见的错误是CS和DC接反或者两块屏幕的定义弄混导致只有一块屏有显示或者显示混乱。4.2 主程序逻辑与眼球动画原理主程序Animated_Eyes_2.ino的结构非常清晰。它创建了两个TFT_eSPI对象tft1和tft2分别对应两块屏幕。在setup()函数中初始化这两个对象并传入各自的CS和DC引脚编号。动画的核心在loop()函数和eye.ino文件中。其工作原理可以概括为状态更新根据时间或随机算法计算眼球下一帧的状态。包括瞳孔位置通常模拟眼球跟随一个“目标点”移动这个目标点可以按轨迹运动如八字形或随机微动。眨眼状态用一个周期函数如正弦波控制眼皮的开合程度模拟眨眼。眼球缩放模拟注视远近物体时的瞳孔大小变化。图形渲染每一帧程序都会在内存中的一个“画布”缓冲区上重新绘制整个眼球。顺序通常是眼白底色 - 虹膜纹理 - 瞳孔 - 高光 - 眼皮覆盖在上方。TFT_eSPI库提供了画圆、填充、绘制位图等基本函数用于构建这些图形元素。数据传输渲染好一帧图像后通过SPI接口利用DMA将整帧图像数据快速发送到对应的TFT屏幕。由于DMA的存在这个传输过程几乎不占用CPU时间。eye.ino文件里包含了所有绘制眼球的函数如drawEye()。你可以在这里找到控制眼球外观的所有参数虹膜颜色、瞳孔大小、眼皮形状等。修改这里就能创造出不同风格的眼睛比如猫眼、机器人眼、血丝眼等等。实操心得性能瓶颈分析帧率FPS主要受限于两点SPI数据传输速度和CPU渲染计算速度。SPI速度通过提高SPI_FREQUENCY和启用USE_DMA来优化。这是提升帧率最有效的手段。CPU渲染绘制复杂图形如高分辨率虹膜位图、复杂眼皮形状会消耗更多时间。如果帧率不足可以尝试简化图形例如使用纯色虹膜代替纹理位图或者减少眼皮的细节。一个简单的测试方法在loop()中注释掉drawEye()调用只执行清屏和画一个简单图形看看帧率是否大幅提升。如果是说明瓶颈在渲染如果变化不大说明瓶颈可能在SPI传输或DMA设置上。5. 编译、上传与调试实战5.1 编译设置与上传步骤在Arduino IDE中选择正确的开发板工具 - 开发板 - ESP32 Arduino - ESP32 Dev Module。选择正确的端口工具 - 端口。在工具菜单中进行以下关键设置Upload Speed: 921600(提高上传速度)Flash Frequency: 80MHzFlash Mode: QIO(默认)Partition Scheme: Default 4MB with spiffs (1.2MB APP/1.5MB SPIFFS)或Huge APP (3MB No OTA/1MB SPIFFS)。由于程序较大建议选择后者以提供更多程序空间。Core Debug Level: 无点击上传按钮。首次上传可能会比较慢因为需要编译整个库和程序。5.2 常见问题与排查技巧实录即使按照步骤操作第一次运行时也能遇到问题。下面是我遇到过的典型问题及解决方法现象可能原因排查步骤与解决方案编译错误1. 库版本不兼容。2.User_Setup.h配置错误。3. 引脚重复定义。1. 确保TFT_eSPI库为2.3.4。2. 检查User_Setup.h中是否注释了TFT_CS和TFT_DC。3. 检查config.h和主程序中是否有引脚冲突。上传失败1. 端口被占用或选择错误。2. ESP32未进入下载模式需按BOOT键。3. 驱动问题。1. 拔插USB线重选端口。2. 上传时先按住BOOT键不放再按一下ENRST键然后松开EN键再松开BOOT键。3. 安装CP210x或CH340 USB转串口驱动。屏幕白屏或全亮1. 电源问题电压/电流不足。2. 复位信号问题。3. 初始化序列错误。1. 用万用表测量屏幕VCC脚是否为稳定3.3V。2. 检查RST引脚连接尝试在setup()开头加digitalWrite(TFT_RST, LOW); delay(10); digitalWrite(TFT_RST, HIGH); delay(100);进行软件复位。3. 确认User_Setup.h中的驱动芯片型号ST7735_DRIVER是否正确。只有一块屏幕亮1. 第二块屏幕的CS或DC引脚定义错误或接触不良。2. 程序只初始化了一块屏幕。1. 用万用表检查第二块屏幕的CS、DC线是否连通到正确的ESP32引脚。2. 检查config.h中DISPLAY_COUNT是否为2并确认tft2的初始化代码被执行。屏幕花屏、闪烁、错位1. SPI时钟频率过高。2. DMA缓冲区冲突或设置不当。3. 电源纹波干扰。1. 逐步降低SPI_FREQUENCY如从27M降到20M测试。2. 尝试在config.h中注释掉#define USE_DMA以禁用DMA看是否恢复正常。如果正常可能是DMA通道冲突尝试在User_Setup.h中修改#define DMA_CHANNEL 1可以是1或2。3. 在屏幕的VCC和GND之间并联一个100uF的电解电容和一个0.1uF的陶瓷电容滤除电源噪声。动画卡顿帧率低1. DMA未启用。2. SPI频率设置过低。3. 渲染逻辑过于复杂。4. 程序使用了delay()函数阻塞。1. 确认USE_DMA已定义。2. 在稳定前提下尝试提高SPI频率。3. 简化eye.ino中的绘图函数例如用fillCircle代替drawBitmap绘制虹膜。4. 避免在loop()中使用delay()用millis()进行非阻塞定时。瞳孔不移动或移动怪异眼球运动算法参数问题或计算溢出。检查eye.ino中计算瞳孔位置的函数如moveEye()。确保目标点坐标在合理范围内例如相对于屏幕中心。可以添加串口打印输出瞳孔的目标坐标进行调试。一个高级调试技巧添加帧率显示为了直观了解性能可以在代码中添加帧率计算和显示虽然会额外消耗一些性能。// 在全局变量区 unsigned long lastFrameTime 0; float fps 0; // 在loop()函数中每帧绘制完成后 unsigned long currentTime millis(); if (currentTime - lastFrameTime 1000) { // 每秒更新一次 fps frameCount; // frameCount需要在每帧loop中自增 frameCount 0; lastFrameTime currentTime; // 可以选择在屏幕角落显示fps会占用渲染时间 // tft1.setCursor(0,0); // tft1.printf(FPS:%.1f, fps); } Serial.printf(FPS: %.1f\n, fps); // 通过串口监视器查看更准确6. 优化、定制与进阶玩法项目成功运行后你就可以开始发挥创意进行定制和优化了。6.1 外观定制创造独一无二的眼睛所有视觉参数都在eye.ino文件中。你可以修改虹膜颜色和纹理修改drawEye()函数中绘制虹膜的部分。可以将纯色填充改为渐变色或者加载一个小型位图作为纹理注意内存占用。瞳孔大小与形状调整瞳孔半径的计算公式甚至可以尝试绘制非圆形的瞳孔。眼皮动画eyeLid()函数控制眨眼。你可以修改其运动曲线让眨眼更快或更慢或者创造“双眨眼”、“半眯眼”等效果。添加血丝或光晕在眼白上随机画一些细红线模拟血丝或在瞳孔周围绘制径向渐变光晕。6.2 交互升级让眼睛“活”起来基础例程的眼睛是自主运动的。我们可以通过添加传感器让它与环境互动。跟随移动添加一个超声波传感器如HC-SR04或TOF传感器根据检测到的物体距离动态调整瞳孔大小模拟对焦。注视方向使用两个舵机云台让整个眼睛模块可以物理转动结合程序控制实现真正的“注视”功能。情绪表达通过一个按钮或语音模块切换不同的“情绪模式”例如正常、惊讶、困倦、愤怒每种模式对应不同的瞳孔大小、眼皮位置和移动速度。6.3 电源管理与成品化如果打算将其用作可穿戴设备或长期展示降低功耗ESP32具有深度睡眠模式。如果不需要眼睛常亮可以设置为每隔几秒唤醒一次执行一次眨眼或眼球转动然后继续睡眠极大延长电池续航。完善供电使用一个小的锂电池如3.7V 18650配合充放电管理模块为整个系统供电。注意ESP32和屏幕都需要3.3V所以需要选择输出3.3V的降压模块。结构封装使用3D打印或激光切割制作一个眼窝形状的外壳将屏幕、ESP32和电池封装进去只露出显示部分。这不仅能保护电路也能让视觉效果更逼真。最后关于原文评论区有人问到的“如何移除眼皮”其实很简单。在drawEye()函数里找到绘制上眼皮和下眼皮的函数调用通常是fillRect或fillTriangle等将它们注释掉即可。这样就会一直显示一个圆睁的眼睛。同理你也可以修改这部分代码来实现“半闭眼”或其他的静态眼型。这个项目就像一把钥匙打开了嵌入式图形和实时动画的大门。从让两个小方块动起来到创造出能传递情绪的眼睛整个过程充满了硬件调试和软件调优的乐趣。我最深的体会是嵌入式开发中“稳定优先于炫酷”。一开始总想追求最高的帧率和最复杂的特效但往往先遭遇的是电源不稳、信号干扰、内存溢出这些基础问题。把SPI频率调低一点给电源加个电容仔细检查每一根飞线这些看似枯燥的工作才是项目最终能稳定运行的基础。当你看到自己创造的眼睛流畅地跟随、自然地眨眼时那种成就感远超过单纯调通一个例程。
相关文章
保姆级教程：用QGIS 3.28把Excel气象数据变成酷炫色斑图（附数据）
零基础玩转气象可视化：QGIS 3.28色斑图制作全流程指南当你在论文或报告中需要展示气温、降水量的空间分布时，是否曾被专业GIS软件的门槛劝退？本文将以一份Excel气象数据为例，带你用QGIS 3.28完成从数据表格到出版级色斑图的蜕变。…
移动电源三合一方案深度解析：从硬件到软件的演进与选型实战
1. 移动电源三合一方案：一个被误解的技术选择最近和几个做消费电子方案的朋友聊天，发现大家对于移动电源的“三合一”方案，普遍存在一种既好奇又担忧的心态。一方面，市场宣传都说三合一方案集成度高、成本低，是未来的趋…
渔人的直感：终极FF14钓鱼计时器完全指南
渔人的直感：终极FF14钓鱼计时器完全指南 【免费下载链接】Fishers-Intuition 渔人的直感，最终幻想14钓鱼计时器 项目地址: https://gitcode.com/gh_mirrors/fi/Fishers-Intuition 还在为《最终幻想14》复杂的钓鱼计时而烦恼吗？渔人的直…
终极免费开源方案：OmenSuperHub让你完全掌控惠普游戏本性能
终极免费开源方案：OmenSuperHub让你完全掌控惠普游戏本性能 【免费下载链接】OmenSuperHub Control Omen laptop performance, fan speeds, and keyboard lighting, and unlock power limits. 项目地址: https://gitcode.com/gh_mirrors/om/OmenSuperHub 你是…
AMD Ryzen处理器深度调优工具：SMUDebugTool全面解析与实战指南
AMD Ryzen处理器深度调优工具：SMUDebugTool全面解析与实战指南 【免费下载链接】SMUDebugTool A dedicated tool to help write/read various parameters of Ryzen-based systems, such as manual overclock, SMU, PCI, CPUID, MSR and Power Table. 项目地址: ht…
还在用SoapUI？试试用Postman调试老项目里的SOAP接口（附完整配置步骤）
告别SoapUI：用Postman高效调试遗留系统中的SOAP接口接手一个老旧项目时，最令人头疼的莫过于那些年久失修的SOAP接口。文档缺失、技术栈过时，而团队早已习惯了Postman的便捷操作。本文将带你从零开始，用Postman征服那些看似复杂的S…
用快马平台快速原型一个温情Web应用：给阿嬷的情书网站
快速体验 打开 InsCode(快马)平台 https://www.inscode.net输入框内输入如下内容： 请使用HTML、CSS和JavaScript，结合一个轻量级前端框架如Vue.js，生成一个名为‘给阿嬷的情书’的静态网站项目。核心功能包括：1、一个温馨的首页…
Cursor Free VIP：终极免费方案，轻松绕过试用限制畅享AI编程助手
Cursor Free VIP：终极免费方案，轻松绕过试用限制畅享AI编程助手 【免费下载链接】cursor-free-vip [Support 0.45]（Multi Language 多语言）自动注册 Cursor Ai ，自动重置机器ID ， 免费升级使用Pro 功能: Yo…
联发科高层动荡背后：芯片巨头的战略迷思与转型阵痛
1. 联发科高层动荡：从“脸面”CFO离职看芯片巨头的十字路口最近半导体圈子里最热闹的话题，莫过于联发科（MediaTek）接连不断的高层人事地震。先是手机事业部老大徐志强离职的传闻闹得沸沸扬扬，紧接着，一个更…
利用claude code skill在快马平台快速构建个人博客原型
快速体验 打开 InsCode(快马)平台 https://www.inscode.net输入框内输入如下内容： 请使用快马平台生成一个个人博客网站的原型。要求具备以下核心功能：响应式设计适配手机和电脑，包含首页文章列表展示，文章详情页，关…
Gemma-4 E4B配置参数详解：如何优化模型性能和输出质量
Gemma-4 E4B配置参数详解：如何优化模型性能和输出质量 【免费下载链接】gemma-4-E4B 项目地址: https://ai.gitcode.com/hf_mirrors/google/gemma-4-E4B Gemma-4 E4B是Google推出的先进多模态AI模型，支持文本、图像、音频和视频处理。本文将详细…
AI 赋能下企业账户接管欺诈成因、风险与全维度防御体系研究
摘要：依托 Wintrust 金融集团发布的行业调研与美联储、FinCEN 公开统计数据，本文以美国 2022—2024 年账户接管欺诈（Account Takeover Fraud，ATO）损失逐年攀升的现实数据为切入点，系统梳理账户接管欺诈的定…
Win10/Win11下Realtek 8188GU网卡驱动感叹号？别急着扔，试试这个手动安装的野路子
Realtek 8188GU网卡驱动故障深度修复指南：从原理到实战当设备管理器里那个顽固的黄色感叹号挥之不去，而你已经尝试了所有"标准操作"——Windows自动更新、第三方驱动工具、甚至重启大法——却依然无济于事时，是时候换个思路了。这篇…
AnolisOS 8.8安装源配置踩坑实录：从‘设置基础软件仓库时出错’到成功联网的保姆级指南
AnolisOS 8.8安装源配置实战指南：从诊断到解决方案的全流程解析当你在安装AnolisOS 8.8时遇到"设置基础软件仓库时出错"的提示，这通常意味着系统无法访问或识别安装源。这个问题看似简单，但背后可能涉及网络配置、镜像选择、启动参…
基于树莓派Pico的反应速度测试游戏：从GPIO编程到状态机实战
1. 项目概述与核心思路最近在整理工作室的电子元件，翻出来几个闲置的街机按钮和一块树莓派Pico，灵机一动，决定做个简单又有趣的反应速度测试游戏。这个项目非常适合想入门嵌入式开发的朋友，它不涉及复杂的传感器和通信协议&#x…
Zotero Duplicates Merger：5步彻底清理文献库重复条目
Zotero Duplicates Merger：5步彻底清理文献库重复条目 【免费下载链接】ZoteroDuplicatesMerger A zotero plugin to automatically merge duplicate items 项目地址: https://gitcode.com/gh_mirrors/zo/ZoteroDuplicatesMerger 还在为文献库中堆积如山的重…
利用随机有限集理论对蜂群的ILQR和MPC控制研究附Matlab代码
✅作者简介：热爱科研的Matlab仿真开发者，擅长数据处理、建模仿真、程序设计、完整代码获取、论文复现及科研仿真。🍎 往期回顾关注个人主页：Matlab科研工作室🍊个人信条：格物致知,完整Matlab代码及仿真咨询…
为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因
更多请点击： https://intelliparadigm.com 第一章：为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因 Gemini邮件的客户转化效率（CTE）显著偏低，根本原因常被误判为…