【花雕学编程】Arduino动手做（249）---GC9A01仪表盘进度条

  【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
  实验二百四十九：1.28寸圆形彩色TFT显示屏 高清IPS 模块 240*240 SPI接口GC9A01驱动
  项目之八十四：GC9A01园屏之仪表盘进度条与模拟加载动画

实验开源代码

/*
  【Arduino】189种传感器模块系列实验（资料代码+仿真编程+图形编程）
  实验二百四十九：1.28寸圆形彩色TFT显示屏 高清IPS 模块 240*240 SPI接口GC9A01驱动
  项目之八十四：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 "SPI.h"
#include "Adafruit_GFX.h"
#include "Adafruit_GC9A01A.h"

#define TFT_CS 4
#define TFT_DC 2
#define TFT_RST -1

Adafruit_GC9A01A tft = Adafruit_GC9A01A(TFT_CS, TFT_DC, TFT_RST);

#define SCREEN_WIDTH 240
#define SCREEN_HEIGHT 240
#define CENTER_X SCREEN_WIDTH / 2
#define CENTER_Y SCREEN_HEIGHT / 2
#define RADIUS 80  // **仪表盘半径**
#define NEEDLE_LENGTH 70  // **指针长度**
#define SPEED 5  // **加载速度**

int progress = 0;

void setup() {
    Serial.begin(115200);
    tft.begin();
    tft.setRotation(1);
}

void loop() {
    tft.fillScreen(tft.color565(0, 0, 0));

    // **绘制圆形进度条**
    tft.drawCircle(CENTER_X, CENTER_Y, RADIUS, tft.color565(255, 255, 255));

    // **计算指针位置**
    float angle = progress * 3.6 * M_PI / 180;  // **转换成弧度**
    int needleX = CENTER_X + NEEDLE_LENGTH * cos(angle);
    int needleY = CENTER_Y + NEEDLE_LENGTH * sin(angle);

    // **绘制旋转指针**
    tft.drawLine(CENTER_X, CENTER_Y, needleX, needleY, tft.color565(255, 0, 0));

    // **更新进度**
    progress += SPEED;
    if (progress >= 100) {
        progress = 0;
    }

    delay(100);
}
复制代码

这段代码的核心功能是 模拟仪表盘进度条与加载动画，让 圆形进度条 和 旋转指针 显示动态变化的进度。以下是代码的简要解读：
代码结构
1️⃣ 初始化屏幕
• 使用 Adafruit_GC9A01A 控制 TFT 显示屏，并设置黑色背景。
2️⃣ 绘制圆形进度条
• drawCircle() 生成 白色圆环，作为仪表盘边界。
• progress 变量用于 控制进度，确保动画流畅。
3️⃣ 旋转指针
• drawLine() 生成 红色指针，每次循环旋转一定角度。
• 指针的位置由 cos() 和 sin() 计算，确保沿圆弧运动。
4️⃣ 进度动画
• progress += SPEED; 使进度不断增加，实现加载动画。
• 当进度达到 100 时，重置为 0，形成循环效果。
• delay(100); 控制动画速度，使指针平滑旋转。

最终效果
圆形仪表盘 + 旋转进度条，模拟加载过程
流畅动画，形成动态视觉效果
黑色背景 + 白色圆环 + 红色指针，增强对比度

实验场景图  动态图