M5GFX 项目下载及安装教程

1. 项目介绍

M5GFX 是一个专为 M5Stack 系列设备设计的图形库，支持多种 M5Stack 设备，如 M5Stack Basic、M5Stack Core2、M5Stick C 等。该库提供了丰富的图形绘制功能，适用于开发各种图形界面应用。

2. 项目下载位置

M5GFX 项目托管在 GitHub 上，可以通过以下步骤进行下载：

1. 打开终端或命令提示符。

2. 使用 git clone 命令下载项目：

   git clone https://github.com/m5stack/M5GFX.git
   

   下载完成后，项目文件将保存在当前目录下的 M5GFX 文件夹中。

3. 项目安装环境配置

3.1 安装依赖

在安装 M5GFX 之前，需要确保系统中已安装以下依赖：

• Arduino IDE 或 PlatformIO：用于编译和上传代码。
• ESP32 开发板支持：确保 Arduino IDE 或 PlatformIO 中已安装 ESP32 开发板支持。

3.2 配置环境

3.2.1 Arduino IDE 配置

1. 打开 Arduino IDE。

2. 进入 文件 -> 首选项，在 附加开发板管理器网址 中添加 ESP32 支持：

   https://dl.espressif.com/dl/package_esp32_index.json
   

3. 进入 工具 -> 开发板 -> 开发板管理器，搜索并安装 esp32。

   

3.2.2 PlatformIO 配置

1. 打开 Visual Studio Code，安装 PlatformIO 插件。

2. 创建一个新的 PlatformIO 项目，选择 Espressif 32 作为开发板。

   

4. 项目安装方式

4.1 使用 Arduino IDE 安装

1. 将下载的 M5GFX 文件夹复制到 Arduino IDE 的 libraries 目录下。
2. 打开 Arduino IDE，选择 文件 -> 示例 -> M5GFX，选择一个示例程序进行编译和上传。

4.2 使用 PlatformIO 安装

1. 在 PlatformIO 项目中，将 M5GFX 文件夹复制到 lib 目录下。

2. 在 platformio.ini 文件中添加以下内容：

   [env:esp32dev]
   platform = espressif32
   board = esp32dev
   framework = arduino
   lib_deps =
       M5GFX
   

3. 打开 main.cpp 文件，编写代码并上传到开发板。

5. 项目处理脚本

M5GFX 项目中包含多个示例程序和处理脚本，位于 examples 目录下。以下是一个简单的示例脚本：

#include <M5GFX.h>

M5GFX display;

void setup() {
    display.begin();
    display.setRotation(1);
    display.fillScreen(TFT_BLACK);
    display.setTextColor(TFT_WHITE);
    display.setTextSize(2);
    display.setCursor(0, 0);
    display.println("Hello, M5GFX!");
}

void loop() {
    // 主循环
}

该脚本初始化 M5GFX 显示器，并在屏幕上显示 "Hello, M5GFX!"。

通过以上步骤，您可以成功下载、安装并运行 M5GFX 项目。