diff --git a/有趣的项目/ESP32-S3与2.8寸SPI触摸屏接线记录.md b/有趣的项目/ESP32-S3与2.8寸SPI触摸屏接线记录.md new file mode 100644 index 0000000..6ba8688 --- /dev/null +++ b/有趣的项目/ESP32-S3与2.8寸SPI触摸屏接线记录.md @@ -0,0 +1,126 @@ +# ESP32-S3 与 2.8 英寸 SPI 触摸屏接线记录 + +更新:2026-09-14。 + +## 设备与当前状态 + +- 主控:ESP32-S3 N16R8 开发板,已焊排针。 +- 屏幕:2.8英寸、240×320、SPI TFT,带触摸和SD卡座。 +- 显示驱动:当前程序按ILI9341配置,用户提供的型号尚未通过芯片读取确认。 +- 触摸驱动:当前按XPT2046兼容控制器配置;具体芯片型号尚未独立确认。 +- 用户已反馈屏幕接好并点亮、触摸线已接好;动态眼睛程序将X/Y同时翻转后,用户确认点击与视线方向正确。 +- SD卡功能暂不连接、不初始化。 + +## 接线表 + +GPIO编号指开发板丝印数字,不是排针从一端数起的序号。插拔杜邦线前先断开USB供电。 + +### 显示部分 + +| 屏幕标注 | ESP32-S3 | 说明 | +|---|---|---| +| VCC | 3V3(此前试接方案) | 用户反馈已亮,但未单独确认最终电源接法;按实物补核,不据此改接5V | +| GND | GND | 公共地 | +| CS | GPIO10 | 显示片选,低有效 | +| RESET | GPIO8 | 显示复位,由程序控制 | +| DC | GPIO9 | 显示数据/命令选择 | +| SDI〈MOSI〉 | GPIO11 | 主控向屏幕发送数据 | +| SCK | GPIO12 | SPI时钟 | +| LED | ESP32-S3 的 3V3(用户已确认) | 直接接3.3V,背光常亮;不接GPIO,当前程序不控制背光亮度或开关 | +| SDO〈MISO〉 | 不接 | 暂不读取显示芯片寄存器或像素,不影响写入图像 | + +### 触摸部分 + +| 屏幕标注 | ESP32-S3 | 说明 | +|---|---|---| +| T_CLK | GPIO12 | 与显示SCK共用 | +| T_DIN | GPIO11 | 与显示SDI/MOSI共用 | +| T_DO | GPIO13 | 触摸数据返回,即MISO | +| T_CS | GPIO7 | 触摸独立片选,不能与显示CS合并 | +| T_IRQ | GPIO6 | 触摸通知;现有程序以轮询读取,暂不依赖中断 | + +### 共用连线示意 + +```text +ESP32-S3 GPIO12 ─┬─ 屏幕 SCK + └─ 触摸 T_CLK + +ESP32-S3 GPIO11 ─┬─ 屏幕 SDI / MOSI + └─ 触摸 T_DIN + +ESP32-S3 GPIO13 ─── 触摸 T_DO +ESP32-S3 GPIO10 ─── 屏幕 CS +ESP32-S3 GPIO7 ─── 触摸 T_CS +ESP32-S3 GPIO9 ─── 屏幕 DC +ESP32-S3 GPIO8 ─── 屏幕 RESET +ESP32-S3 GPIO6 ─── 触摸 T_IRQ +ESP32-S3 GND ─── 屏幕 GND +``` + +GPIO11、GPIO12各需要分接两根线,可通过面包板或分线连接。触摸T_DO与显示SDO是不同引脚,目前只连接T_DO。SD卡接口所有信号保持不接,测试时不插SD卡。 + +## 软件配置 + +Arduino IDE开发板:`ESP32S3 Dev Module`(安装Espressif Systems提供的esp32开发板包)。 + +库管理器安装: + +- Adafruit ILI9341 +- Adafruit GFX Library,以及安装提示中的依赖 +- XPT2046_Touchscreen,作者Paul Stoffregen + +与接线对应的关键配置: + +```cpp +Adafruit_ILI9341 tft(&SPI, 9, 10, 8); // DC, CS, RESET +XPT2046_Touchscreen touch(7); // T_CS;采用轮询 + +// 初始化总线前,两个片选均设为输出高电平。 +pinMode(10, OUTPUT); +digitalWrite(10, HIGH); +pinMode(7, OUTPUT); +digitalWrite(7, HIGH); +pinMode(6, INPUT_PULLUP); + +SPI.begin(12, 13, 11, 10); // SCK, MISO, MOSI, SS +tft.begin(10000000); // 显示SPI初始10MHz +tft.setRotation(1); // 横屏320×240 +touch.begin(SPI); +touch.setRotation(1); +``` + +## 测试程序 + +### 笑脸与触摸基础测试 + +文件:`esp32_smile_test/esp32_smile_test.ino`。 + +- 启动切换红、绿、蓝,再显示笑脸。 +- 按下屏幕时笑脸在黄色/青色之间切换,显示触摸次数。 +- 串口115200输出原始坐标、压力及IRQ电平;原始坐标不是屏幕像素坐标。 + +### 动态眼睛测试 + +文件:`esp32_touch_eyes/esp32_touch_eyes.ino`。 + +- 已取消开机三点校准,直接显示眼睛,使用代码顶部的默认触摸范围。 +- 点击时眨眼,视线朝向触摸位置;按住移动可跟随。 +- 最后一次有效触摸后3秒,视线平滑回到正前方。 +- 连续15秒没有触摸后,随机眨眼、向周围看,并间歇回正;触摸立即接管。当前“无人互动”仅按触摸计时,不代表摄像头检测到无人。 +- 根据用户实测上下左右均反向,已设TOUCH_FLIP_X=true、TOUCH_FLIP_Y=true,TOUCH_SWAP_XY仍为false;重新上传后用户确认方向正确。边缘误差调整TOUCH_MIN/MAX_X/Y。IDLE_AFTER_MS控制闲置等待时间。 + +两个程序分别打开、分别上传,不将两个ino复制到同一草图目录。动态眼睛程序已获用户实机反馈:触摸与视线方向正确;长期运行及完整功能验收尚未记录。 + +## 排查提示 + +- 背光亮不代表显示初始化成功;白屏时检查ILI9341型号、CS/DC/RESET和SPI连线。 +- `XPT2046_Touchscreen.h: No such file or directory`表示缺库,先安装触摸库。 +- 显示正常但触摸无响应:检查T_DO→GPIO13、T_CS→GPIO7,以及共用的T_CLK/T_DIN。 +- 触摸方向不对:调整动态眼睛程序顶部的轴交换/翻转和范围参数,更改屏幕旋转方向后需重新检查映射。 +- 当前不要将触摸信号接5V,也不要用显示GPIO给电机供电。 + +## 参考与适用边界 + +同类[MSP2807模块接口说明](https://www.lcdwiki.com/2.8inch_SPI_Module_ILI9341_SKU:MSP2807)与实物照片的引脚名称相符,但不能由外观证明具体板卡版本完全一致。用户已确认LED直接接ESP32-S3的3V3,背光常亮;VCC的最终接法和触摸芯片型号仍需单独核对,不能由LED接法推定。 + +本记录仅适用于当前2.8英寸模块,不能直接套用到此前的GC9A01小圆屏。 diff --git a/有趣的项目/esp32_smile_test/esp32_smile_test.ino b/有趣的项目/esp32_smile_test/esp32_smile_test.ino new file mode 100644 index 0000000..f625601 --- /dev/null +++ b/有趣的项目/esp32_smile_test/esp32_smile_test.ino @@ -0,0 +1,94 @@ +// ESP32-S3 + ILI9341 240x320 display test. +// Install Adafruit ILI9341, Adafruit GFX Library and their dependencies. +// Display: SCK=12, SDI/MOSI=11, CS=10, DC=9, RESET=8, GND=GND. +// Touch: T_CLK=12, T_DIN=11, T_DO=13, T_CS=7, T_IRQ=6. +// Install XPT2046_Touchscreen by Paul Stoffregen as well. +// Display SDO and SD card are not connected. Backlight is externally powered. +#include +#include +#include +#include + +constexpr int TFT_SCK = 12; +constexpr int TFT_MOSI = 11; +constexpr int TFT_CS = 10; +constexpr int TFT_DC = 9; +constexpr int TFT_RST = 8; +constexpr int TOUCH_MISO = 13; +constexpr int TOUCH_CS = 7; +constexpr int TOUCH_IRQ = 6; + +Adafruit_ILI9341 tft(&SPI, TFT_DC, TFT_CS, TFT_RST); +// Poll first to test SPI independently of the IRQ wire. +XPT2046_Touchscreen touch(TOUCH_CS); +bool wasPressed = false; +bool alternateColor = false; +uint32_t touchCount = 0; +uint32_t lastReport = 0; + +void drawFace(uint16_t color); + +void setup() { + Serial.begin(115200); + delay(300); + pinMode(TFT_CS, OUTPUT); + digitalWrite(TFT_CS, HIGH); + pinMode(TOUCH_CS, OUTPUT); + digitalWrite(TOUCH_CS, HIGH); + pinMode(TOUCH_IRQ, INPUT_PULLUP); + SPI.begin(TFT_SCK, TOUCH_MISO, TFT_MOSI, TFT_CS); + tft.begin(10000000); // Start conservatively at 10 MHz for jumper wires. + tft.setRotation(1); // Landscape: 320 x 240. Use 3 if upside down. + touch.begin(SPI); + touch.setRotation(1); + + const uint16_t colors[] = {ILI9341_RED, ILI9341_GREEN, ILI9341_BLUE}; + for (uint16_t color : colors) { + tft.fillScreen(color); + delay(400); + } + + tft.fillScreen(ILI9341_NAVY); + drawFace(ILI9341_YELLOW); + Serial.println("Touch test ready. Raw coordinates are not calibrated pixels."); +} + +void drawFace(uint16_t color) { + const int cx = tft.width() / 2; + const int cy = 105; + tft.fillCircle(cx, cy, 82, color); + tft.fillCircle(cx - 28, cy - 22, 10, ILI9341_BLACK); + tft.fillCircle(cx + 28, cy - 22, 10, ILI9341_BLACK); + + // Parabolic smile: the center is lower than the corners. + for (int x = -42; x <= 42; ++x) { + int y = cy + 43 - (x * x) / 65; + tft.fillCircle(cx + x, y, 3, ILI9341_BLACK); + } + + tft.fillRect(0, 199, tft.width(), 41, ILI9341_NAVY); + tft.setTextColor(ILI9341_WHITE, ILI9341_NAVY); + tft.setTextSize(2); + tft.setCursor(16, 207); + tft.print("Touches: "); + tft.print(touchCount); +} + +void loop() { + bool pressed = touch.touched(); + if (pressed) { + TS_Point point = touch.getPoint(); + if (!wasPressed) { + ++touchCount; + alternateColor = !alternateColor; + drawFace(alternateColor ? ILI9341_CYAN : ILI9341_YELLOW); + } + if (millis() - lastReport >= 150) { + lastReport = millis(); + Serial.printf("raw x=%d y=%d pressure=%d IRQ=%d\n", + point.x, point.y, point.z, digitalRead(TOUCH_IRQ)); + } + } + wasPressed = pressed; + delay(20); +} diff --git a/有趣的项目/esp32_touch_eyes/esp32_touch_eyes.ino b/有趣的项目/esp32_touch_eyes/esp32_touch_eyes.ino new file mode 100644 index 0000000..7e1fe81 --- /dev/null +++ b/有趣的项目/esp32_touch_eyes/esp32_touch_eyes.ino @@ -0,0 +1,141 @@ +// ESP32-S3 N16R8 + ILI9341 + XPT2046-compatible touch. +// Libraries: Adafruit ILI9341, Adafruit GFX Library, XPT2046_Touchscreen. +// LCD: SCK=12 MOSI=11 CS=10 DC=9 RESET=8. LCD SDO disconnected. +// Touch: T_CLK=12 T_DIN=11 T_DO=13 T_CS=7 T_IRQ=6 (polled). +// SD disconnected. Keep the existing working power/backlight connections. +// No startup calibration. Adjust touch mapping constants below if needed. +#include +#include +#include +#include +#include + +Adafruit_ILI9341 tft(&SPI, 9, 10, 8); +XPT2046_Touchscreen touch(7); +// Small off-screen canvas avoids visible erase/redraw flashes. +GFXcanvas16 eyes(280, 112); +// Approximate raw range after touch.setRotation(1), not calibrated pixels. +constexpr int TOUCH_MIN_X = 200, TOUCH_MAX_X = 3900; +constexpr int TOUCH_MIN_Y = 200, TOUCH_MAX_Y = 3900; +constexpr bool TOUCH_SWAP_XY = false; +constexpr bool TOUCH_FLIP_X = true, TOUCH_FLIP_Y = true; +constexpr uint32_t IDLE_AFTER_MS = 15000; +uint32_t idleBlinkAt = 0, idleLookAt = 0; +bool idle = false, idleLookingAway = false; +float gazeX = 0, gazeY = 0, targetX = 0, targetY = 0; +uint32_t lastTouch = 0, blinkStart = 0, lastFrame = 0, lastDown = 0; +bool looking = false, blinking = false, contact = false; +int previousX = 999, previousY = 999, previousOpen = -1; + +void renderEyes(int dx, int dy, int opening) { + eyes.fillScreen(ILI9341_BLACK); + for (int i = 0; i < 2; ++i) { + int x = i == 0 ? 72 : 208; + eyes.fillRoundRect(x-49, 12, 98, 88, 30, ILI9341_WHITE); + eyes.fillCircle(x+dx, 56+dy, 25, ILI9341_CYAN); + eyes.fillCircle(x+dx, 56+dy, 14, ILI9341_BLACK); + eyes.fillCircle(x+dx-7, 49+dy, 5, ILI9341_WHITE); + int cover = (100-opening)*44/100; + if (cover > 0) { + eyes.fillRect(x-50, 12, 100, cover, ILI9341_BLACK); + eyes.fillRect(x-50, 100-cover, 100, cover, ILI9341_BLACK); + } + if (opening < 7) eyes.fillRoundRect(x-39, 54, 78, 4, 2, ILI9341_CYAN); + } + tft.drawRGBBitmap(20, 54, eyes.getBuffer(), 280, 112); +} + +void setup() { + Serial.begin(115200); + pinMode(10, OUTPUT); digitalWrite(10, HIGH); + pinMode(7, OUTPUT); digitalWrite(7, HIGH); + pinMode(6, INPUT_PULLUP); + SPI.begin(12, 13, 11, 10); + tft.begin(10000000); + tft.setRotation(1); + touch.begin(SPI); + touch.setRotation(1); + if (!eyes.getBuffer()) { + tft.fillScreen(ILI9341_RED); + Serial.println("Eye canvas allocation failed."); + while (true) delay(1000); + } + randomSeed(micros()); + tft.fillScreen(ILI9341_BLACK); + tft.setTextColor(ILI9341_CYAN); + tft.setTextSize(2); + tft.setCursor(46, 207); + tft.print("Touch to look!"); + lastFrame = lastTouch = millis(); +} + +void loop() { + uint32_t now = millis(); + if (touch.touched()) { + TS_Point p = touch.getPoint(); + float rawX = TOUCH_SWAP_XY ? p.y : p.x; + float rawY = TOUCH_SWAP_XY ? p.x : p.y; + float px = constrain((rawX-TOUCH_MIN_X)*319.0f/(TOUCH_MAX_X-TOUCH_MIN_X), 0.0f, 319.0f); + if (TOUCH_FLIP_X) px = 319.0f-px; + float py = constrain((rawY-TOUCH_MIN_Y)*239.0f/(TOUCH_MAX_Y-TOUCH_MIN_Y), 0.0f, 239.0f); + if (TOUCH_FLIP_Y) py = 239.0f-py; + idle = false; + idleLookingAway = false; + if (!contact) { blinking = true; blinkStart = now; } + contact = true; + lastDown = lastTouch = now; + looking = true; + targetX = (px-159.5f)/159.5f*20.0f; + targetY = (py-119.5f)/119.5f*14.0f; + } else if (contact && now-lastDown > 100) { + contact = false; // Short release debounce prevents repeated blinks. + } + if (looking && now-lastTouch >= 3000) { + looking = false; + targetX = targetY = 0; + } + // "Unattended" currently means no touch, not camera-based presence detection. + if (!contact && !looking && now-lastTouch >= IDLE_AFTER_MS) { + if (!idle) { + idle = true; + idleLookingAway = false; + idleBlinkAt = now + random(400, 1600); + idleLookAt = now + random(900, 2200); + } + if (!blinking && int32_t(now-idleBlinkAt) >= 0) { + blinking = true; + blinkStart = now; + idleBlinkAt = now + random(2500, 6500); + } + if (int32_t(now-idleLookAt) >= 0) { + idleLookingAway = !idleLookingAway; + if (idleLookingAway) { + targetX = random(0, 2) ? random(9, 21) : -random(9, 21); + targetY = random(-12, 13); + idleLookAt = now + random(800, 2000); + } else { + targetX = targetY = 0; + idleLookAt = now + random(1800, 4500); + } + } + } + if (now-lastFrame < 33) { delay(2); return; } + float dt = (now-lastFrame)/1000.0f; + lastFrame = now; + float blend = 1.0f-expf(-12.0f*dt); + gazeX += (targetX-gazeX)*blend; + gazeY += (targetY-gazeY)*blend; + int opening = 100; + if (blinking) { + uint32_t elapsed = now-blinkStart; + if (elapsed < 100) opening = 100-int(elapsed); + else if (elapsed < 170) opening = 0; + else if (elapsed < 330) opening = int((elapsed-170)*100/160); + else blinking = false; + } + int dx = lroundf(gazeX), dy = lroundf(gazeY); + if (dx != previousX || dy != previousY || opening != previousOpen) { + renderEyes(dx, dy, opening); + previousX = dx; previousY = dy; previousOpen = opening; + } +}