【花雕学编程】Arduino动手做（249）---ESP32+GC9A01之蓝色背景白色文本的向上滚动显示

《Arduino 手册（思路与案例）》栏目介绍：
在电子制作与智能控制的应用领域：广泛涉及了Arduino BLDC、Arduino CNC、Arduino ESP32 SPP、Arduino FreeRTOS、Arduino FOC、Arduino GRBL、Arduino HTTP、Arduino HUB75、Arduino IoT Cloud、Arduino JSON、Arduino LCD、Arduino OLED、Arduino LVGL、Arduino PID 及 Arduino TFT 等方面的相关拓展思路和众多参考案例。本专栏目前博客近2300篇。
https://blog.csdn.net/weixin_41659040/category_12422453.html

37款传感器与模块的提法，在网络上广泛流传，其实Arduino能够兼容的传感器模块肯定是不止37种的。鉴于本人手头积累了一些传感器和执行器模块，依照实践出真知（一定要动手做）的理念，以学习和交流为目的，这里准备逐一动手试试多做实验，不管成功与否，都会记录下来——小小的进步或是搞不掂的问题，希望能够抛砖引玉。

【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
实验二百四十九：1.28寸圆形彩色TFT显示屏 高清IPS 模块 240*240 SPI接口GC9A01驱动

实验开发板使用ESP32

实验模块接线示意图

【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电源）

#include <TFT_eSPI.h>  // **TFT_eSPI 库**
#include <SPI.h>

TFT_eSPI tft = TFT_eSPI();  // **初始化 TFT 屏幕**
const char* text = "ESP32 + GC9A01 Display Test";  // **需要显示的文本**
int y = 120;  // **文本起始 Y 坐标**
int scrollSpeed = 2;  // **滚动速度**

void setup() {
    tft.init();
    tft.setRotation(2);  // **适配 GC9A01 圆形显示**
    tft.fillScreen(TFT_BLUE);  // **设置蓝色背景**
    tft.setTextColor(TFT_WHITE, TFT_BLUE);  // **白色字体，带蓝色背景**
    tft.setTextSize(2);  // **设置字体大小**
}

void loop() {
    tft.fillScreen(TFT_BLUE);  // **清屏**
    tft.drawString(text, 20, y, 2);  // **绘制文本**

    y -= scrollSpeed;  // **向上滚动**

    // **如果文字完全离开屏幕顶部，则重置位置**
    if (y < -20) {  
        y = 190;  
    }

    delay(50);  // **控制滚动速度**
}

代码简单解读

这段代码在 GC9A01 圆形 TFT 屏幕 上实现了 蓝色背景 + 白色文本的向上滚动显示，核心逻辑如下：

1. 初始化
   ✅ tft.init(); → 启动 GC9A01 屏幕
   ✅ tft.setRotation(2); → 旋转屏幕，适配圆形显示
   ✅ tft.fillScreen(TFT_BLUE); → 设置蓝色背景
   ✅ tft.setTextColor(TFT_WHITE, TFT_BLUE); → 白色字体，带蓝色背景
   ✅ tft.setTextSize(2); → 调整字体大小

2. 文字滚动
   ✅ y -= scrollSpeed; → 让文本不断向上移动
   ✅ drawString(text, 20, y, 2); → 绘制字符串，显示文本
   ✅ 清屏 → fillScreen(TFT_BLUE); 避免残留的旧字符

3. 循环滚动
   ✅ if (y < -20) y = 120; → 当文本滚出屏幕顶部后，重新从底部开始滚动
   ✅ delay(50); → 控制滚动速度，让动画流畅

这个代码让 GC9A01 屏幕不断滚动显示文本，形成向上移动的动画效果。

实验场景图 动态图