如何使用 1.69 英寸 ST7789 TFT 显示屏与 ESP32-C3 连接

这是一个轻量级且功能完备的 TFT 显示库，专为与 ESP32-C3 配合使用 1.69 英寸的 ST7789 显示屏而设计。该项目消除了 Arduino IDE、ESP32 核心更新以及现有显示库之间持续存在的不兼容问题。

这座图书馆从零开始构建，旨在确保稳定且高效的渲染效果，同时避免依赖庞大的依赖项——这使其成为开发定制硬件平台(如集成式手持游戏机生态系统或智能物联网仪表盘)的理想基础。

硬件清单

要使用此库并运行所提供的示例，您将需要：

•微控制器：ESP32-C3 开发板

•显示屏：1.69 英寸 ST7789 液晶显示屏

•存储(可选)：微型 SD 卡模块(适用于 SD 卡示例)

•布线：面包板和跳线线缆

接线图与布线方式

默认情况下，该库已配置为使用 ESP32-C3 的标准 SPI 引脚。您可以直接在设置文件中自定义这些引脚，以满足您项目的具体需求。

组件 ------------- ESP32-C3 引脚 ------------------------------------

TFT MOSI ---------------- 默认的 SPI MOSI ---------------------------------------- GPIO 6TFT SCLK ---------------- 默认的 SPI SCLK ----------------------------------------- GPIO 4TFT CS -------------------- 在用户设置中定义 --------------------------------- GPIO 7TFT DC -------------------- 在用户设置中定义 --------------------------------- GPIO 8TFT RST ------------------- 在用户设置中定义 -------------------------------- GPIO 5

SD 卡 MISO ---------- 默认 SPI MISO(仅在使用 SD 卡时适用) --------------- GPIO 1(注意：请查看您所使用的特定 ESP32-C3 板的引脚图以获取确切的默认 SPI GPIO 编号)

Arduino 安装与设置

1. 安装库

•从 GitHub 上将此资源库以 .ZIP 文件的形式下载下来。

•打开你的 Arduino 软件开发环境。

•前往“绘图”菜单下的“包含库”选项，然后选择“添加.ZIP 库”，接着选择下载的文件即可。

2. 配置用户设置 这是至关重要的一步!就像 TFT_eSPI 一样，您必须对库进行配置，使其与您的特定接线方式相匹配。

•前往您的 Arduino 库文件夹，并打开此库的文件夹。

•打开“src”文件夹中的“User_Setup”文件。

•在此处请明确指定您的具体引脚、SPI 速度以及颜色格式。

•SD 卡 SPI 共享：如果您在同一 SPI 总线上同时使用 SD 卡和显示屏，那么您必须取消注释此文件中的 MISO 定义部分。如果您未使用 SD 卡，则请保持其注释状态。

•保存并关闭该文件。

示例及使用方法

如果您熟悉 TFT_eSPI，那么您会感到非常自在。这个库涵盖了所有基本的绘图功能，而且学习曲线几乎为零。

打开 Arduino IDE 并切换至“文件”>“示例”>“DSN-Esp32C3-St7789”菜单项，以此来尝试这些功能：

•图形测试示例：一个基准测试和语法演示。您可以直接上传此文件，无需修改任何代码。它会测试线条、矩形、圆形和文本的绘制速度。

•示例_说明：展示了如何使用精灵函数来进行无闪烁的绘图以及实现流畅的用户界面元素。

•位图示例：一个极具说服力的示例，展示了如何直接从微型 SD 卡读取位图/图像文件，并通过共享 SPI 技术将其无缝地呈现在显示屏上。

本文编译自hackster.io