arduino 圆形tft

### 关于Arduino与圆形TFT显示屏的相关资料

#### 硬件连接教程

对于GC9A01这种特定类型的圆形TFT显示屏，在尝试点亮屏幕之前，确保正确配置硬件连接至关重要。通常情况下，这类显示器通过SPI接口与Arduino通信。具体来说，需要将显示屏的数据线（DIN）、时钟线（CLK）、芯片选择线（CS）、数据/命令选择线（DC）以及复位线（RST）分别连接到Arduino对应的引脚上[^2]。

为了简化这一过程，可以参考如下典型的引脚映射方案：

| 屏幕引脚 | Arduino Uno |
| --- | --- |
| DIN (MOSI) | D11 或者 SDA |
| CLK (SCK) | D13 或者 SCL |
| CS | D10 |
| DC | D9 |
| RST | D8 |

请注意不同型号的Arduino板可能有不同的默认SPI管脚分配；上述表格仅作为一般指导原则。

#### 驱动程序安装与初始化

当完成物理连线之后，下一步就是加载适合的驱动库来控制该设备。根据描述中的经验分享，`Arduino_GFX`库能够有效支持GC9A01屏，并提供了良好的文档和支持社区帮助解决问题。可以通过Arduino IDE内置的库管理器轻松安装此库。

一旦安装完毕，则可以在项目中引入必要的头文件并创建相应的对象实例来进行基本设置操作，例如设定背光亮度、旋转方向等参数。下面是一段简单的初始化代码片段用于启动GC9A01显示模块：

#include "Adafruit_GC9A01.h"

#define TFT_DC    9
#define TFT_CS    10
#define TFT_RST   8
#define TFT_MOSI  11
#define TFT_SCLK  13

// 创建一个名为`tft`的对象关联至指定引脚
Adafruit_GC9A01 tft(TFT_CS, TFT_DC, TFT_MOSI, TFT_SCLK, TFT_RST);

void setup() {
  Serial.begin(115200);
  
  // 初始化LCD
  if (!tft.init()) {
    Serial.println("Failed to initialize screen");
    while (true);
  }
}

这段代码展示了如何利用`Adafruit_GC9A01`类实现对GC9A01圆形单色液晶面板的基本初始化流程。

#### 示例代码展示

为了让开发者更直观地理解如何运用这些工具开发应用程序，这里给出一段完整的示例代码用来测试新接入的圆形TFT显示屏是否正常工作。本例程将在屏幕上画出一条动态变化的手表指针效果，模拟传统机械手表的工作原理[^4]。

#include <math.h>
#include "Adafruit_GC9A01.h"
#include "lvgl/lvgl.h" // 如果打算集成LVGL GUI框架的话也需要加入这条语句

const float pi = 3.1415;

/// @brief 绘制时钟指针的方法
/// 参数说明见原文档
void DrawClockHand(int len, int value, int _interval, uint32_t color) {
  float x, y;
  x = len * cos(value * _interval * pi / 180 - pi / 2) + 120;
  y = len * sin(value * _interval * pi / 180 - pi / 2) + 120;
  tft.drawLine(120, 120, x, y, color);
}

void loop() {
  static unsigned long previousMillis = 0;
  const long interval = 1000; // 更新频率设为每秒一次
  
  unsigned long currentMillis = millis();
  if(currentMillis - previousMillis >= interval){
    previousMillis = currentMillis;
    
    // 清除旧图像
    tft.fillScreen(ST77XX_BLACK);
    
    // 计算当前时间对应的角度位置
    int hourAngle = ((hour()%12)*30)+((minute()/60.0f)*30);
    int minuteAngle = minute()*6+(second()/60.0f)*6;
    int secondAngle = second()*6;
    
    // 分别绘制三个不同的指针
    DrawClockHand(60,hourAngle ,30,LV_COLOR_WHITE.color);     // 时针
    DrawClockHand(90,minuteAngle,6 ,LV_COLOR_LIGHTBLUE.color);// 分针
    DrawClockHand(110,secondAngle,6 ,LV_COLOR_RED.color);      // 秒针
    
    delay(100); // 减少CPU占用率
  }
}

以上代码实现了在一个直径约为240像素的圆形区域内呈现类似真实世界里的石英腕表界面的效果。其中涉及到了三角函数计算坐标转换逻辑，同时也体现了良好编码习惯下的变量命名规范和注释风格。