【花雕学编程】Arduino动手做（249）--GC9A01人类淡褐色眼睛
【花雕学编程】Arduino动手做（249）--GC9A01人类淡褐色眼睛
【花雕学编程】Arduino动手做（249）--GC9A01人类淡褐色眼睛
【花雕学编程】Arduino动手做（249）--GC9A01人类淡褐色眼睛
【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）实验二百四十九：1.28寸圆形彩色TFT显示屏 高清IPS 模块 240*240 SPI接口GC9A01驱动
项目之一百二十：ESP32+GC9A01之标准的人类般的淡褐色眼睛
实验开源代码
/*
【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
实验二百四十九：1.28寸圆形彩色TFT显示屏 高清IPS 模块 240*240 SPI接口GC9A01驱动
项目之一百二十：ESP32+GC9A01之标准的人类般的淡褐色眼睛
*/
// GC9A01---------- ESP32
// RST ------------ NC（复位引脚，此处未连接）
// CS ------------- D4（片选引脚，连接到ESP32的D4引脚）
// DC ------------- D2（数据/命令选择引脚，连接到ESP32的D2引脚）
// SDA ------------ D23 (green)（主数据输出引脚，连接到ESP32的D23引脚，绿色线）
// SCL ------------ D18 (yellow)（时钟信号引脚，连接到ESP32的D18引脚，黄色线）
// GND ------------ GND（接地引脚，连接到ESP32的接地端）
// VCC -------------3V3（电源引脚，连接到ESP32的3.3V电源）
// 显示的眼睛的大小取决于屏幕的尺寸和分辨率。
// 眼睛图像的宽度固定为 128 像素。在人类的生理结构中，
// 睑裂 (睁开的眼睛的宽度) 大约是 30 毫米。因此，
// 低分辨率、大像素尺寸的显示屏最适合以真实的比例
// 显示眼睛的图像。请注意，显示器制造商通常会标注对角线尺寸，
// 因此一个 128x128 的 1.7 英寸显示屏或 128x160 的 2 英寸显示屏
// 在尺寸上是比较合适的。
// 眼睛的配置设置，包括眼睛的样式、显示器的数量、
// 片选引脚以及眼睛在屏幕上的 X 轴偏移量，都可以在草图的
// "config.h" 选项卡中进行定义。
// 通过在 ESP32 和 STM32 处理器上使用 DMA (直接内存访问，仅适用于 SPI 显示屏)，
// 可以显著提高程序的性能 (以每秒传输的帧数，即 fps 来衡量)。
// 应该使用显示器所支持的尽可能高的 SPI 时钟速率。
// 最小推荐速率为 27MHz，一些显示器甚至可以在 40-80MHz 的更高频率下稳定运行。
// 下表列出了在不同处理器上，使用单只默认眼睛 (defaultEye) 时的性能表现：
// 无 DMA 有 DMA
// ESP8266 (160MHz CPU) 40MHz SPI 36 fps
// ESP32 27MHz SPI 53 fps 85 fps
// ESP32 40MHz SPI 67 fps 102 fps
// ESP32 80MHz SPI 82 fps 116 fps // 注意：很少有显示器能在 80MHz 下稳定工作
// STM32F401 55MHz SPI 44 fps 90 fps
// STM32F446 55MHz SPI 83 fps 155 fps
// STM32F767 55MHz SPI 136 fps 197 fps
// 当接口是 SPI 时，DMA 可以与 RP2040、STM32 和 ESP32 处理器一起使用。
// 要启用 DMA，请取消注释下一行：
//#define USE_DMA
// 加载 TFT_eSPI 库，用于控制 TFT LCD
#include <SPI.h> // 包含 Arduino 的 SPI 库
#include <TFT_eSPI.h> // 包含 TFT_eSPI 库
TFT_eSPI tft; // 创建一个 TFT_eSPI 类的实例，用于控制显示屏
// 在眼睛的渲染过程中，会使用一个像素缓冲区来存储即将绘制的数据。
// BUFFER_SIZE 定义了这个缓冲区的大小，128 到 1024 似乎是一个最佳的范围。
#define BUFFER_SIZE 240
#ifdef USE_DMA
#define BUFFERS 2 // 如果启用了 DMA，则使用 2 个缓冲区进行乒乓操作，提高效率
#else
#define BUFFERS 1 // 如果没有启用 DMA，则只需要 1 个缓冲区
#endif
uint16_t pbuffer; // 声明一个二维数组作为像素渲染缓冲区，每个缓冲区可以存储 BUFFER_SIZE 个 16 位颜色值
bool dmaBuf = 0; // 一个布尔变量，用于选择当前正在使用的 DMA 缓冲区 (在双缓冲情况下)
// 这个结构体 (struct) 在 config.h 文件中被填充数据。
typedef struct { // 定义一个名为 eyeInfo_t 的结构体，用于存储每个眼睛的配置信息
int8_tselect; // 用于连接到每个眼睛的屏幕的片选 (Chip Select, CS) 引脚编号 (int8_t 是 8 位有符号整数)
int8_twink; // 连接到每个眼睛的“眨眼”按钮的引脚编号 (int8_t)。如果某个眼睛没有眨眼按钮，则设置为 -1。
uint8_t rotation; // 该眼睛所连接的显示屏的旋转角度 (0-3)。uint8_t 是 8 位无符号整数。
int16_t xposition; // 眼睛图像在屏幕上的 X 轴位置偏移量 (int16_t 是 16 位有符号整数)。
} eyeInfo_t;
#include "config.h" // ****** 所有的配置都在这个文件中完成 ******
extern void user_setup(void); // 声明在 user*.cpp 文件中定义的用户自定义初始化函数
extern void user_loop(void);// 声明在 user*.cpp 文件中定义的用户自定义循环函数
#define SCREEN_X_START 0
#define SCREEN_X_END SCREEN_WIDTH // 定义屏幕上眼睛图像的 X 轴范围的起始和结束。SCREEN_WIDTH 应该在 config.h 中定义。
#define SCREEN_Y_START 0
#define SCREEN_Y_END SCREEN_HEIGHT // 定义屏幕上眼睛图像的 Y 轴范围的起始和结束。SCREEN_HEIGHT 应该在 config.h 中定义。
// 使用一个简单的状态机来控制眼睛的眨眼 (blink) 和单眼眨眼 (wink) 动作：
#define NOBLINK 0 // 定义一个状态：当前没有进行任何眨眼动作
#define ENBLINK 1 // 定义一个状态：眼睑当前正在闭合 (Engaging Blink)
#define DEBLINK 2 // 定义一个状态：眼睑当前正在张开 (Disengaging Blink)
typedef struct { // 定义一个名为 eyeBlink 的结构体，用于存储每个眼睛的眨眼状态信息
uint8_tstate; // 当前的眨眼状态 (NOBLINK, ENBLINK, DEBLINK)
uint32_t duration; // 当前眨眼状态的持续时间 (以微秒为单位)。uint32_t 是 32 位无符号整数。
uint32_t startTime; // 上次眨眼状态发生改变的时间 (以微秒为单位)。
} eyeBlink;
struct { // 定义一个匿名结构体，用于存储每个眼睛的特定信息。eye 数组的每个元素都是这个结构体。
int16_t tft_cs; // 连接到每个显示屏的片选 (Chip Select) 引脚编号
eyeBlink blink; // 一个 eyeBlink 结构体，存储该眼睛的当前眨眼状态
int16_t xposition; // 该眼睛的图像在屏幕上的 X 轴位置
} eye; // 声明一个名为 eye 的数组，其大小由 NUM_EYES (在 config.h 中定义) 决定。每个元素存储一只眼睛的信息。
uint32_t startTime; // 用于记录程序启动或上次帧率计算的时间，以便计算每秒帧数 (FPS)。
// 初始化 -- 在启动时运行一次 --------------------------------------------------
void setup(void) {
Serial.begin(115200); // 初始化串口通信，波特率为 115200
//while (!Serial); // 如果需要等待串口连接，则取消注释此行
Serial.println("Starting"); // 通过串口打印 "Starting"
#if defined(DISPLAY_BACKLIGHT) && (DISPLAY_BACKLIGHT >= 0)
// 如果定义了 DISPLAY_BACKLIGHT 并且其值大于等于 0 (表示使用了背光控制引脚)
Serial.println("Backlight turned off"); // 通过串口打印 "Backlight turned off"
pinMode(DISPLAY_BACKLIGHT, OUTPUT);// 将背光控制引脚设置为输出模式
digitalWrite(DISPLAY_BACKLIGHT, LOW); // 将背光引脚拉低，通常表示关闭背光
#endif
// 调用用户在 user_setup() 函数中定义的任何附加初始化功能
user_setup();
// 初始化眼睛。这个函数可能会设置所有片选引脚为低电平，以便后续的 tft.init() 可以正常工作。
initEyes(); // 这个函数应该在其他地方定义 (例如在 eye_functions.cpp 中)
// 初始化 TFT 显示屏
Serial.println("Initialising displays"); // 通过串口打印 "Initialising displays"
tft.init(); // 调用 TFT_eSPI 库的初始化函数
#ifdef USE_DMA
tft.initDMA(); // 如果定义了 USE_DMA，则初始化 DMA 功能
#endif
// 拉高片选引脚，以便可以单独配置每个显示屏
digitalWrite(eye.tft_cs, HIGH); // 将第一个眼睛的片选引脚拉高
if (NUM_EYES > 1) digitalWrite(eye.tft_cs, HIGH); // 如果有第二个眼睛，则将其片选引脚也拉高
// 遍历每个眼睛
for (uint8_t e = 0; e < NUM_EYES; e++) {
digitalWrite(eye.tft_cs, LOW); // 将当前眼睛的片选引脚拉低，选中该显示屏
tft.setRotation(eyeInfo.rotation); // 设置当前显示屏的旋转角度，该角度从 eyeInfo 数组中获取
tft.fillScreen(TFT_BLACK); // 使用黑色填充当前显示屏
digitalWrite(eye.tft_cs, HIGH); // 将当前眼睛的片选引脚拉高，取消选中该显示屏
}
#if defined(DISPLAY_BACKLIGHT) && (DISPLAY_BACKLIGHT >= 0)
Serial.println("Backlight now on!"); // 通过串口打印 "Backlight now on!"
analogWrite(DISPLAY_BACKLIGHT, BACKLIGHT_MAX); // 使用模拟写入设置背光亮度为最大值
#endif
startTime = millis(); // 记录程序启动时的毫秒数，用于后续的帧率计算
}
// 主循环 -- 在 setup() 函数执行完毕后持续运行 ----------------------------
void loop() {
updateEye(); // 调用 updateEye() 函数来更新眼睛的显示。这个函数应该在其他地方定义 (例如在 eye_functions.cpp 中)。
}
【花雕学编程】Arduino动手做（249）--GC9A01人类淡褐色眼睛
为了方便起见，这里提供了一个配置文件，如果您添加了纵杆和按钮，则需要编辑此文件。config.h 文件
// 此处引脚选择基于 Adafruit Learning System 针对 Teensy 3.x 项目的原始指南。
// 其中一些引脚编号甚至在较小的 SAMD M0 和 M4 板上不存在，
// 因此您可能需要进行其他的引脚选择：
// 图形设置 (眼睛外观) ----------------------------------------------------
// 如果使用单眼，您可能希望启用下一行，它使用一个更简单的
// “橄榄球形”眼睛，左右对称。默认形状包含眼睑内侧的小肉阜，
// 创建了明显的左右眼。
//#define SYMMETRICAL_EYELID
// 启用以下 #include 中的一个 -- 包含各种眼睛的大型图形表：
#include "data/defaultEye.h" // 标准的人类般的淡褐色眼睛 -或-
//#include "data/dragonEye.h" // 狭缝瞳孔的火龙/恶魔之眼 -或-
//#include "data/noScleraEye.h" // 大虹膜，无巩膜 -或-
//#include "data/goatEye.h" // 水平瞳孔的山羊/克朗普斯之眼 -或-
//#include "data/newtEye.h" // 蝾螈之眼 -或-
//#include "data/terminatorEye.h" // 终结者之眼！
//#include "data/catEye.h" // 卡通猫眼 (扁平的“2D”颜色)
//#include "data/owlEye.h" // 猫头鹰之眼 (禁用追踪)
//#include "data/naugaEye.h" // 瑙加玩偶的咕噜噜眼 (禁用追踪)
//#include "data/doeEye.h" // 卡通小鹿眼 (禁用追踪)
// 显示硬件设置 (屏幕类型和连接) ----------------------------------------
#define TFT_COUNT 1 // 屏幕数量 (1 或 2)
#define TFT1_CS -1 // TFT 1 片选引脚 (设置为 -1 以使用 TFT_eSPI 设置)
#define TFT2_CS -1 // TFT 2 片选引脚 (设置为 -1 以使用 TFT_eSPI 设置)
#define TFT_1_ROT 1 // TFT 1 旋转角度
#define TFT_2_ROT 1 // TFT 2 旋转角度
#define EYE_1_XPOSITION60 // 眼睛 1 图像在显示屏上的 X 轴偏移
//#define EYE_2_XPOSITION320 - 128 // 眼睛 2 图像在显示屏上的 X 轴偏移
#define DISPLAY_BACKLIGHT-1 // 背光控制引脚 (-1 表示无背光控制)
#define BACKLIGHT_MAX 255
// 眼睛列表 ----------------------------------------------------------------
#define NUM_EYES 1 // 要显示的眼睛数量 (1 或 2)
#define BLINK_PIN -1 // 手动眨眼按钮引脚 (双眼)
#define LH_WINK_PIN -1 // 左眼眨眼引脚 (设置为 -1 表示无引脚)
#define RH_WINK_PIN -1 // 右眼眨眼引脚 (设置为 -1 表示无引脚)
// 此表包含每只眼睛一行。该表必须存在且名称必须为此名称，
// 并且包含一行或多行。每行包含三个项目：
// 对应 TFT/OLED 显示屏的片选线引脚编号，该眼睛的“眨眼”按钮
// 引脚编号 (如果未使用则为 -1)，屏幕旋转值 (0-3) 和该眼睛的 X 轴位置偏移。
#if (NUM_EYES == 2)
eyeInfo_t eyeInfo[] = {
{ TFT1_CS, LH_WINK_PIN, TFT_1_ROT, EYE_1_XPOSITION }, // 左眼片选和眨眼引脚，旋转角度和偏移
{ TFT2_CS, RH_WINK_PIN, TFT_2_ROT, EYE_2_XPOSITION }, // 右眼片选和眨眼引脚，旋转角度和偏移
};
#else
eyeInfo_t eyeInfo[] = {
{ TFT1_CS, LH_WINK_PIN, TFT_1_ROT, EYE_1_XPOSITION }, // 眼睛片选和眨眼引脚，旋转角度和偏移
};
#endif
// 输入设置 (用于控制眼睛运动) --------------------------------------------
// JOYSTICK_X_PIN 和 JOYSTICK_Y_PIN 指定用于手动控制眼睛的模拟摇杆的
// 模拟输入引脚。如果设置为 -1 或未定义，眼睛将自动移动。
// IRIS_PIN 指定用于光敏电阻以使瞳孔对光线做出反应 (或用于手动控制的电位器) 的
// 模拟输入引脚。如果设置为 -1 或未定义，瞳孔将自动变化。
// BLINK_PIN 指定用于按钮 (接地) 的输入引脚，该按钮将使任何/所有眼睛眨眼。
// 如果设置为 -1 或未定义，眼睛仅在定义了 AUTOBLINK 时眨眼，
// 或者如果上面的 eyeInfo[] 表包含每只眼睛的眨眼按钮设置。
//#define JOYSTICK_X_PIN A0 // 眼睛水平位置的模拟引脚 (否则自动)
//#define JOYSTICK_Y_PIN A1 // 眼睛垂直位置的模拟引脚 (同上)
//#define JOYSTICK_X_FLIP // 如果定义，则反转摇杆 X 轴
//#define JOYSTICK_Y_FLIP // 如果定义，则反转摇杆 Y 轴
#define TRACKING // 如果定义，则眼睑追踪瞳孔
#define AUTOBLINK // 如果定义，眼睛也会自主眨眼
//#define LIGHT_PIN -1 // 光线传感器引脚
//#define LIGHT_CURVE0.33 // 光线传感器调整曲线
//#define LIGHT_MIN 0 // 光线传感器的最小有用读数
//#define LIGHT_MAX 1023 // 传感器的最大有用读数
//#define IRIS_SMOOTH // 如果启用，则过滤来自 IRIS_PIN 的输入
#if !defined(IRIS_MIN) // 每只眼睛可能有自己的 MIN/MAX
#define IRIS_MIN 90 // 最亮光线下虹膜大小 (0-1023)
#endif
#if !defined(IRIS_MAX)
#define IRIS_MAX 130 // 最暗光线下虹膜大小 (0-1023)
#endif
【花雕学编程】Arduino动手做（249）--GC9A01人类淡褐色眼睛
代码解读：这段代码是 "UncannyEyes" 项目的一个版本，它使用 ESP32 或其他兼容的微控制器来驱动 TFT LCD 屏幕，模拟逼真的眼睛动画。以下是代码的简单解读：
1、核心功能:
• 模拟眼睛: 代码旨在在 TFT 屏幕上绘制和动画显示一只或两只眼睛。
• 可配置: 眼睛的外观、显示器的配置（数量、连接引脚、旋转方向、位置偏移）等都通过 config.h 文件进行设置。
• 性能优化: 提到了使用 DMA (直接内存访问) 来提高 SPI 通信速度，从而提升动画的帧率 (FPS)。
• 眨眼控制: 支持自动眨眼 (AUTOBLINK)，也可以通过按钮手动控制眨眼 (BLINK_PIN, LH_WINK_PIN, RH_WINK_PIN)。
• 输入控制 (可选): 注释部分提到了可以使用模拟摇杆 (JOYSTICK_X_PIN, JOYSTICK_Y_PIN) 或光线传感器 (LIGHT_PIN) 来控制眼睛的运动和瞳孔大小。
• 眼睑追踪 (可选): 如果定义了 TRACKING，眼睑的运动会跟随瞳孔的运动。
2、主要组成部分:
• #include: 引入了必要的库，包括 SPI 通信库和 TFT_eSPI 库，后者是专门为 ESP32 等芯片优化的 TFT LCD 控制库。
• BUFFER_SIZE 和 pbuffer: 定义了一个像素缓冲区，用于在绘制眼睛图像时临时存储像素数据，提高效率。
• eyeInfo_t 结构体: 用于存储每个眼睛的配置信息，包括连接的 TFT 的片选引脚、眨眼按钮引脚、屏幕旋转角度和在屏幕上的 X 轴位置。这些信息从 config.h 文件加载。
• eyeBlink 结构体: 用于管理眼睛的眨眼状态，包括当前状态 (正在闭合、张开、不眨眼)、眨眼持续时间和上次状态改变的时间。
• eye 数组: 存储了 eyeInfo_t 和 eyeBlink 结构体的实例，每个元素对应一只眼睛。
• setup() 函数: 在程序启动时运行一次，用于初始化串口、背光、用户自定义功能 (user_setup())、眼睛 (initEyes()) 和 TFT 显示屏 (tft.init())。它还会根据 config.h 中的设置配置每个眼睛连接的 TFT 屏幕的旋转和初始显示。
• loop() 函数: 在 setup() 之后持续运行，主要调用 updateEye() 函数来更新眼睛的动画。这个 updateEye() 函数的实际实现应该在其他地方 (例如 eye_functions.cpp)。
简单来说，这段代码是一个框架，用于在连接到 ESP32 或类似控制器的 TFT LCD 屏幕上创建生动的眼睛动画。它的核心是通过配置信息和状态管理，控制屏幕上像素的颜色变化，从而模拟眼睛的运动、眨眼等行为。具体的眼睛外观、动画逻辑和控制方式在 config.h 和其他源文件中实现。
【花雕学编程】Arduino动手做（249）--GC9A01人类淡褐色眼睛
实验场景图动态图【花雕学编程】Arduino动手做（249）--GC9A01人类淡褐色眼睛
【花雕学编程】Arduino动手做（249）--GC9A01人类淡褐色眼睛
实验记录视频（33秒）【【花雕学编程】Arduino动手做（249）---ESP32+GC9A01之标准的人类般的淡褐色眼睛#电子爱好者 #单片机开发 #科技改变生活】
https://www.bilibili.com/video/BV18jLszkE4p/?share_source=copy_web&vd_source=371a292a55e5ca9be994cbb4a86cc987
https://www.bilibili.com/video/BV18jLszkE4p/?share_source=copy_web&vd_source=371a292a55e5ca9be994cbb4a86cc987
【花雕学编程】Arduino动手做（249）--GC9A01人类淡褐色眼睛
实验场景图动态图
页:
[1]