【花雕学编程】Arduino动手做(249)---ESP32驱动1.28寸 TFT GC9A01圆屏之多行滚动显示字母“Hello world!”
2025-03-2574
AI 快速预览详细
本教程介绍了如何使用ESP32和1.28寸TFT GC9A01圆屏实现多行滚动显示“Hello world!”的效果。硬件清单包括ESP32和TFT GC9A01显示屏。最终效果是屏幕上从底部逐行滚动显示“Hello world!”,每行文字的颜色随机变化。难度等级适合初学者和有一定基础的Arduino编程爱好者。通过详细的代码和实验说明,你可以轻松完成这个项目。






【Arduino】189种传感器模块系列实验(资料代码+仿真编程+图形编程)
实验二百四十九:1.28寸圆形彩色TFT显示屏 高清IPS 模块 240*240 SPI接口GC9A01驱动
项目实验之九:多行滚动显示字母“Hello world!”,每行字体颜色随机
实验开源代码
代码
/*
【Arduino】189种传感器模块系列实验(资料代码+仿真编程+图形编程)
实验二百四十九:1.28寸圆形彩色TFT显示屏 高清IPS 模块 240*240 SPI接口GC9A01驱动
项目实验之九:多行滚动显示字母“Hello world!”,每行字体颜色随机
*/
// GC9A010 -------- 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 "SPI.h" // 引入SPI库
#include "Adafruit_GFX.h" // 引入Adafruit GFX库
#include "Adafruit_GC9A01A.h" // 引入GC9A01A显示屏驱动库
#define TFT_DC 2 // 定义TFT显示屏的DC引脚
#define TFT_CS 4 // 定义TFT显示屏的CS引脚
Adafruit_GC9A01A tft(TFT_CS, TFT_DC); // 创建GC9A01A对象
void setup() {
Serial.begin(9600); // 初始化串口通信
Serial.println("Scrolling 'Hello world!' with Random Colors");
tft.begin(); // 初始化显示屏
tft.setRotation(2); // 设置显示屏方向
tft.fillScreen(GC9A01A_BLACK); // 清屏
randomSeed(analogRead(0)); // 初始化随机数种子
}
void loop() {
int screenWidth = tft.width(); // 屏幕宽度
int screenHeight = tft.height(); // 屏幕高度
int textHeight = 20; // 每行文字的高度(像素)
int totalLines = screenHeight / textHeight; // 计算屏幕可容纳的行数
int scrollY = screenHeight; // 初始化文字起始滚动位置
// 定义颜色数组(可自定义更多颜色)
uint16_t colors[] = {GC9A01A_RED, GC9A01A_GREEN, GC9A01A_BLUE, GC9A01A_YELLOW, GC9A01A_CYAN, GC9A01A_MAGENTA, GC9A01A_WHITE};
int colorCount = sizeof(colors) / sizeof(colors[0]);
while (true) {
// 清屏
tft.fillScreen(GC9A01A_BLACK);
// 绘制多行滚动文字
for (int i = 0; i < totalLines; i++) {
int lineY = scrollY + (i * textHeight); // 计算每行的Y坐标
if (lineY >= 0 && lineY < screenHeight) {
// 随机颜色选择
uint16_t color = colors[random(0, colorCount)];
// 设置文字属性
tft.setTextColor(color);
tft.setTextSize(3); // 字体大小1(可以根据需求调整)
tft.setCursor(10, lineY); // 每行固定X位置
tft.print("Hello world!");
}
}
// 更新滚动位置
scrollY -= textHeight / 4; // 滚动速度:每次减少1/4行高度
if (scrollY <= -textHeight) {
scrollY = 0; // 滚动结束时重置
}
delay(700); // 延时控制滚动速度
}
}代码说明
1、多行动态滚动:
滚动逻辑通过scrollY变量实现,动态调整每一行的Y坐标。
滚动位置重置后,形成循环效果。
2、随机字体颜色:
使用颜色数组colors定义多种颜色,每次绘制随机选择一种颜色。
每行显示的“Hello world!”都有独特的随机颜色。
3、动态文本排布:
通过计算totalLines动态确定屏幕能够容纳的最大行数。
每行文字的垂直间距由textHeight设置,确保文字不重叠。
4、动画节奏控制:
延时delay(100)控制滚动速度,调整行的滚动频率。
5、效果描述
屏幕上将从底部逐行滚动显示“Hello world!”。
每一行的文字颜色都随机变化,显示效果丰富多彩。
滚动循环往复,不断更新内容,带来持续的视觉吸引力。
实验场景图 动态图











