• 此示例在 TFT 显示屏上循环显示从 00 到 99 的两位数数字，并在程序启动时展示一系列颜色过渡效果。适用于学习 ESP32 与 TFT 屏交互，可显示循环递增的两位数数字，有颜色过渡和文本显示，测试稳定性与可靠性

【硬件连接】

• 将开发板接入电脑

【代码分析】

• setup()：setup函数在程序启动时执行一次，主要负责初始化 TFT 显示屏并进行一些初始设置
  • tft.init();初始化 TFT 显示屏，为后续的显示操作做好准备
  • 通过一系列的tft.fillScreen()和delay()实现颜色过渡效果，展示了 TFT 显示屏的颜色填充功能，增加程序启动的视觉吸引力
  • tft.fillScreen(0x04FF);设置特定的背景颜色，tft.setTextColor(TFT_WHITE, 0x04FF);设置文本颜色，确保文本在背景下清晰可见

• loop()：loop函数在程序运行过程中不断循环，实现核心的数字显示功能置
  • tft.drawString("Hello, Waveshare!", 30, 40, 2);显示欢迎消息，增强用户体验
  • 数字格式化：将整数number转换为字符串displayNumber，并在数字为一位时添加前导零，确保两位数显示
  • tft.drawString(displayNumber, 55, 80, 6);在显示屏特定位置以特定字体大小显示格式化后的数字
  • number++实现数字自增，当number超过 99 时重置为 0，保证数字在 00 到 99 之间循环
  • delay(1000)控制数字更新速度，让用户能够清晰地看到数字变化

【代码烧录】

• 选择开发板型号ESP32C3 Dev Module与端口
• 配置参数
• 烧录代码

【运行效果】

• 此示例实现了在圆形显示屏上依次显示随机颜色的正方形、三角形和圆形的效果，展示了 TFT 显示屏的图形绘制功能和随机颜色生成的灵活性。适用于学习 ESP32 与圆形显示屏交互，依次绘制随机颜色的正方形、三角形和圆形，位于屏幕中心，每隔 3 秒切换，测试图形绘制稳定性

【硬件连接】

• 将开发板接入电脑

【代码分析】

• drawSquare()：该函数用于绘制一个以随机颜色填充的正方形
  • uint16_t squareColor = tft.color565(random(0, 255), random(0, 255), random(0, 255));生成一个随机的 RGB565 颜色，确保每次绘制的正方形颜色不同
  • 通过计算正方形的对角线长度（等于圆形的直径）和中心坐标，确定正方形的左上角坐标和尺寸
  • tft.fillRect(squareTopLeftX, squareTopLeftY, squareSize, squareSize, squareColor);使用随机颜色填充正方形

• drawTriangle()：此函数绘制一个以随机颜色填充的等边三角形
  • 生成随机颜色
  • 根据圆形的半径计算等边三角形的高度和边长
  • 计算三角形的三个顶点坐标，并存储在triangleX和triangleY数组中
  • tft.fillTriangle(triangleX[0], triangleY[0], triangleX[1], triangleY[1], triangleX[2], triangleY[2], triangleColor);使用随机颜色填充三角形

• drawCircleInCenter()：这个函数绘制一个以随机颜色填充的圆形，圆心位于屏幕中心
  • 生成随机颜色
  • tft.fillCircle(centerX, centerY, 30, circleColor);以屏幕中心坐标和固定半径绘制圆形并使用随机颜色填充

【代码烧录】

• 选择开发板型号ESP32C3 Dev Module与端口
• 配置参数
• 烧录代码

【运行效果】

• 此示例利用 TFT_eSPI 库在不同处理器上驱动 TFT 显示屏展示动画眼睛效果，可配置参数且支持 DMA 提高性能，在主循环中持续更新眼睛状态。适用于学习 TFT_eSPI 库显示眼睛动画，可配置参数，利用状态机控制眨眼，测试性能

【硬件连接】

• 将开发板接入电脑

【代码分析】

• updateEye()：根据不同的条件（是否有光感引脚）更新眼睛的虹膜大小，以实现眼睛对光线或自动变化的响应
  • 函数开始根据是否定义了LIGHT_PIN来决定虹膜大小的更新方式。
  • 若定义了光感引脚：
    • 通过int16_t v = analogRead(LIGHT_PIN);读取光感引脚的模拟值。
    • 根据LIGHT_PIN_FLIP等配置进行必要的反转操作（#ifdef LIGHT_PIN_FLIP部分）。
    • 对读取的值进行范围限制（if (v < LIGHT_MIN) v = LIGHT_MIN; else if (v > LIGHT_MAX) v = LIGHT_MAX;），确保光感值在合理范围内。
    • 进行光感值到虹膜大小范围的映射（v = map(v, 0, (LIGHT_MAX - LIGHT_MIN), IRIS_MAX, IRIS_MIN);）。
    • 根据是否定义了LIGHT_CURVE应用伽马曲线调整光感值（#ifdef LIGHT_CURVE部分）。
    • 最后，根据是否定义了IRIS_SMOOTH，选择平滑处理（滤波方式逐渐调整虹膜大小）或直接设置虹膜大小。
  • 若未定义光感引脚：
    • 使用newIris = random(IRIS_MIN, IRIS_MAX);生成随机的新虹膜大小。
    • 调用split(oldIris, newIris, micros(), 10000000L, IRIS_MAX - IRIS_MIN);函数，通过递归方式实现虹膜大小从旧值到新值的逐渐变化，并更新oldIris为新值

【代码烧录】

• 选择开发板型号ESP32C3 Dev Module与端口
• 配置参数
• 烧录代码

【运行效果】

• 该程序通过控制两个 TFT 显示屏，实现了同步眼部动画效果，可用于机器人面部表情、仿生眼等场景的视觉展示。

【硬件连接】

• 将开发板接入电脑

【代码分析】

• loop()：不断地执行动画和更新显示内容
  • 使用一个内层循环执行Demo_1函数多次，这里的循环次数由变量i控制，循环次数为 7。图像显示通过pushImage函数实现，每次显示前通过片选信号选中对应设备。

【代码烧录】

• 选择开发板型号ESP32C3 Dev Module与端口
• 配置参数
• 烧录代码

【运行效果】

• 仿真眼睛样式1和样式2，交替显示

【硬件连接】

• 将开发板接入电脑

【代码分析】

• loop()：不断地执行动画和更新显示内容
  • 使用一个循环来执行不同的动画操作：
    • 如果a == 1，则先将屏幕填充为黑色（tft.fillScreen(BLACK);），然后调用Demo_1函数，最后通过delay(2000);延迟 2 秒钟。
    • 如果a == 2，则使用一个内层循环执行Demo_2函数多次，这里的循环次数由变量i控制，循环次数为 7。Demo_2函数会依次显示一系列图像，实现动画效果。通过这种方式，可以在程序运行过程中不断地循环执行这两个不同的动画序列

【代码烧录】

• 选择开发板型号ESP32C3 Dev Module与端口
• 配置参数
• 烧录代码

【运行效果】

• 此示例初始化 TFT 显示屏和 LVGL 库，创建图像对象，主循环处理定时器任务。适用于学习 ESP32 与 LVGL 和 TFT 屏交互，初始化后可显示 LVGL 图像，测试稳定性与可靠性

【硬件连接】

• 将开发板接入电脑

【代码分析】

• lv_disp_flush()：负责将 LVGL 的图形数据刷新到 TFT 显示屏
  • 首先计算要刷新区域的宽度w和高度h，确保准确确定数据范围
  • 接着通过tft.setAddrWindow设置 TFT 显示屏的写地址窗口，为数据写入指定正确位置
  • 然后使用tft.pushColors将颜色数据推送到显示屏，这一步决定了显示的图形颜色和内容
  • 最后通知 LVGL 刷新完成，以便 LVGL 继续后续图形处理操作

• setup()：串口、LVGL、TFT 显示屏、显示驱动以及创建并设置图形对象
  • 串口初始化：Serial.begin(115200)准备串口通信用于可能的调试
  • LVGL 初始化：lv_init()启动 LVGL 库的核心组件
  • 若LV_USE_LOG不为 0，注册串口打印函数用于调试：lv_log_register_print_cb(my_print)。
  • TFT 显示屏初始化：
    • tft.begin()初始化 TFT 硬件
    • tft.setRotation(0)设置显示屏为横向翻转方向
  • 显示缓冲区初始化：lv_disp_draw_buf_init(&draw_buf, buf, NULL, screenWidth * screenHeight / 10)，为存储图形数据做准备。
  • 显示驱动初始化和注册：
    • lv_disp_drv_init(&disp_drv)初始化显示驱动结构体
    • 设置驱动参数，如分辨率、刷新回调函数和显示缓冲区等，并注册显示驱动
  • 创建并设置图形对象：
    • 通过LV_IMG_DECLARE(A3)声明图像资源，然后创建图像对象logo_img并设置其源为声明的图像，最后通过lv_obj_center和lv_obj_align设置图像对象在屏幕上的位置

【代码烧录】

• 选择开发板型号ESP32C3 Dev Module与端口
• 配置参数
• 烧录代码

【运行效果】

• 此示例利用 TFT_eSPI 库和 LVGL 图形库对 TFT 显示屏进行初始化设置，搭建图形界面框架以实现显示和交互功能。适用于学习 ESP32 与 LVGL 和 TFT 屏交互,初始化后可显示图形界面，测试稳定性与可靠性

【硬件连接】

• 将开发板接入电脑

【代码分析】

• lv_disp_flush()： LVGL 的显示刷新回调函数，负责将 LVGL 的图形数据推送到 TFT 显示屏，确保显示内容准确更新
  • 计算刷新区域的宽度和高度，准确确定要推送的数据范围
  • 设置 TFT 显示屏的写地址窗口，确保数据写入正确位置
  • 推送颜色数据到显示屏，颜色数据的正确传输决定了显示图形的颜色和内容
  • 通知 LVGL 刷新完成，使 LVGL 能继续后续的图形处理操作

• setup()：串口、LVGL、TFT 显示屏、显示驱动和用户界面的初始化
  • 串口初始化用于可能的调试输出
  • LVGL 初始化启动库的核心组件
  • 若LV_USE_LOG不为 0，注册串口打印函数以便查看 LVGL 日志信息
  • TFT 显示屏初始化包括硬件连接和参数设置，如设置旋转方向
  • 初始化显示缓冲区并配置显示驱动，确保 LVGL 能正确与显示屏交互
  • 调用ui_init初始化用户界面元素
  • 输出调试信息表示初始化完成

【代码烧录】

• 选择开发板型号ESP32C3 Dev Module与端口
• 配置参数
• 烧录代码

【运行效果】