實驗效果

凌順實驗室（lingshunlab.com）在本示例中，主要運行Arduino_GFX庫的Hello World的程序。

該庫還有很多有趣的示例，涵蓋了現實GIF，PNG，JPEG，Mjpeg等格式的圖片，還有LVGL這個強大的UI庫，可以在示例中一一查看學習。

以下圖片就是程序運行后TFT屏幕顯示的畫面，程序是不斷的把「Hello LingshunLAB.com」這句字符串隨機在屏幕上疊加顯示。

引腳說明

BOM

接線

安裝庫

方法一：通過Arduino IDE 2 的安裝方法

1，點擊Library

2，搜索框輸入「GFX Library for Arduino」

3，點擊「INSTALL」進行安裝

4，安裝完成后，該庫的名稱旁邊會顯示「INSTALLED」

方法二：GITHUB 倉庫下載安裝方法

1，首先到GITHUB下載「GFX Library for Arduino」：https://github.com/moononournation/Arduino_GFX

2，解壓

3，把解壓的文件放進Arduino IDE的libraries文件夾

程序提點

加載 Arduino_GFX_Library 庫

#include 

配置使用的開發板

在本示例中使用的是ESP32，

并且使用的是VSPI 的硬件SPI引腳，

根據接線圖，使用以下代碼進行開發板的配置：

/* More data bus class:  */
//Arduino_DataBus *bus = create_default_Arduino_DataBus();
Arduino_DataBus *bus = new Arduino_ESP32SPI(13 /* DC */, 5 /* CS */, 18 /* SCK */, 23 /* MOSI */, GFX_NOT_DEFINED /* MISO */, VSPI /* spi_num */);

更多的開發板配置參考：https://github.com/moononournation/Arduino_GFX/wiki/Data-Bus-Class

ESP32 GPIO口大全：https://lingshunlab.com/book/esp32/esp32-pinout-reference

配置TFT屏幕

本示例，使用的是ST7789系列240x240分辨率的TFT屏幕，根據接線進行如下配置：

/* More display class:  */
Arduino_GFX *gfx = new Arduino_ST7789(
  bus, 14 /* RST */, 0 /* rotation */, true /* IPS */,
  240 /* width */, 240 /* height */,
  0 /* col offset 1 */, 0 /* row offset 1 */);

代碼

通過示例代碼中，可以找到HelloWorld的例子

以下是修改配置代碼后的，合適ESP32的開發板連接ST7789系列240x240分辨率的代碼：

// welcome to www.lingshunlab.com
// 

#include 

#define GFX_BL 12 // default backlight pin, you may replace DF_GFX_BL to actual backlight pin

/* More data bus class:  */
//Arduino_DataBus *bus = create_default_Arduino_DataBus();
Arduino_DataBus *bus = new Arduino_ESP32SPI(13 /* DC */, 5 /* CS */, 18 /* SCK */, 23 /* MOSI */, GFX_NOT_DEFINED /* MISO */, VSPI /* spi_num */);

/* More display class:  */
Arduino_GFX *gfx = new Arduino_ST7789(
  bus, 14 /* RST */, 0 /* rotation */, true /* IPS */,
  240 /* width */, 240 /* height */,
  0 /* col offset 1 */, 0 /* row offset 1 */);

/*******************************************************************************
 * End of Arduino_GFX setting
 ******************************************************************************/

void setup(void)
{
    gfx->begin();
    gfx->fillScreen(BLACK);

#ifdef GFX_BL
    pinMode(GFX_BL, OUTPUT);
    digitalWrite(GFX_BL, HIGH);
#endif

    gfx->setCursor(10, 10);
    gfx->setTextColor(RED);
    gfx->println("Hello LingshunLAB.com!");
    delay(5000); // 5 seconds
}

void loop()
{
    gfx->setCursor(random(gfx->width()), 20+random(gfx->height()));
    gfx->setTextColor(random(0xffff), random(0xffff));
    gfx->setTextSize(random(6) /* x scale */, random(6) /* y scale */, random(2) /* pixel_margin */);
    gfx->println("Hello LingshunLAB.com!");

    delay(1000); // 1 second
}

審核編輯：劉清