Skip to main content

Seeed Studio XIAO 圆形显示屏入门指南

立即购买 🖱️

介绍​

Seeed Studio XIAO 圆形显示屏是一款与所有 XIAO 开发板兼容的扩展板。它的一面配备了全覆盖触摸屏，设计为 39mm 圆盘形状。在紧凑的尺寸内集成了板载 RTC、充电芯片、TF 卡槽，非常适合智能家居、可穿戴设备等交互式显示应用。

版本描述日期作者
v1.0初始版本2023/1/29Linus.Liao
v1.11.更换锂电池充电IC
2.在A0和D6之间添加开关		2023/4/7Linus.Liao

规格参数​

项目详细信息
电源供应USB Type-C: 5V @35 mA
电池充电: 3.7V @37mA
充电电流~ 485 mA
可扩展存储TF 卡插槽，支持最大 32GB FAT 格式
屏幕1.28 英寸触摸屏
240×240 分辨率
65K 色彩
其他外部设备JST 1.25 连接器
尺寸39mm x 39mm

特性​

  • 电容触摸屏扩展板：配备1.28英寸圆形显示屏，240×240分辨率，65K色彩，提供清晰多彩的图像展示
  • 高兼容性：与所有XIAO系列产品高度兼容，轻松集成到您现有的项目中
  • 丰富外设：在紧凑尺寸内集成板载RTC、电池充电芯片、TF卡槽、JST 1.25连接器
  • 手表尺寸设计：采用39毫米圆形设计，适用于可穿戴和空间受限的项目
  • 即插即用：所有引脚均已引出，无需焊接

硬件概述​

在开始之前，我们可以参考以下图片了解圆形显示屏的引脚设计，以便于我们理解圆形显示屏的功能。

自2023年4月7日起，改进后的圆形显示屏增加了一个2位开关来控制屏幕背光和电池电压读取。用户可以自由选择是否使用该引脚或释放它。点击这里阅读更多详细信息。

入门指南​

硬件准备​

如果您想充分利用圆形显示屏的全部功能并获得出色的体验，我们强烈建议您购买我们的XIAO系列作为圆形显示屏的主板。

tip

XIAO SAMD21、RP2040和RA4M1由于内存不足，可能不兼容圆形屏幕。

Seeed Studio XIAO nRF52840 (Sense)Seeed Studio XIAO ESP32C3Seeed Studio XIAO ESP32S3 (Sense)Seeed Studio XIAO ESP32C6
立即购买 🖱️
立即购买 🖱️
立即购买 🖱️
立即购买 🖱️

Round Display 背面的引脚排设计用于 XIAO 系列。如果您手头有 XIAO，则无需准备任何额外的电缆，只需对齐 XIAO 的引脚并将其直接插入 Round Display 即可。

caution

请注意，连接 XIAO 时，XIAO 的 Type-C 连接器应朝向 Round Display 的外侧。如果您意外接反了极性，不要过于担心，Round Display 具有电源保护电路，不会轻易损坏，但我们不建议您长时间保持反向连接。

Round Display 的推荐方向是：当您面对 Round Display 时，XIAO 的 Type-C 连接器朝向右侧，这样 Round Display 的开/关按钮就在左下角。

软件准备​

要使用 Round Display，我们需要对 XIAO 系列进行编程。推荐的编程工具是 Arduino IDE，您需要为 XIAO 配置 Arduino 环境并添加板载包。

tip

如果这是您第一次使用 Arduino，我们强烈建议您参考 Arduino 入门指南。

步骤 1. 根据您的操作系统下载并安装稳定版本的 Arduino IDE​

下载 Arduino IDE

步骤 2. 启动 Arduino 应用程序​

步骤 3. 为您正在使用的 XIAO 配置 Arduino IDE​

  • 如果您想在后续例程中使用 Seeed Studio XIAO RP2350，请参考 此教程 完成添加。

  • 如果您想在后续例程中使用 Seeed Studio XIAO nRF52840，请参考 此教程 完成添加。

  • 如果您想在后续例程中使用 Seeed Studio XIAO ESP32C3，请参考 此教程 完成添加。

  • 如果您想在后续例程中使用 Seeed Studio XIAO ESP32C6，请参考 此教程 完成添加。

  • 如果您想在后续例程中使用 Seeed Studio XIAO ESP32S3，请参考 此教程 完成添加。

步骤 4. 安装图形库和屏幕驱动库​

要使用圆形显示屏，我们需要提前安装两个库。一个是圆形显示设备驱动库，用于驱动设备的屏幕和触摸功能。另一个是图形显示库，它提供了一些非常常用的绘制图形接口。

  1. 从 GitHub 下载 Seeed_Arduino_RoundDisplay 库：
下载库

  1. 从 GitHub 下载 Seeed_GFX 库：
下载库

  1. 在 Arduino IDE 中通过添加 ZIP 文件来安装库。转到 Sketch > Include Library > Add .ZIP Library 并选择下载的 ZIP 文件。
note

如果您之前安装了 TFT_eSPI 库，您可能需要暂时从 Arduino 库文件夹中删除或重命名它以避免冲突，因为 Seeed_GFX 是 TFT_eSPI 的一个分支，具有额外的功能。

Arduino 库概述​

从上面的教程中我们可以看出，Round Display 主要使用 LVGL、TFT_eSPI 和 Arduino GFX 库。为了节省篇幅，我们将以绘制表盘为例，分别介绍 LVGL 和 TFT_eSPI 库的使用。

  • 您可以点击**这里**了解 TFT_eSPI 库的接口和使用方法。

  • 您可以点击**这里**了解 LVGL 库的接口和使用方法。

  • 您可以点击**这里**了解 Arduino GFX 库的接口和使用方法。

点亮您的 Round Display​

演示 1：Arduino Life - 如何在圆形显示屏上使用 Seeed_GFX 库​

从 Seeed_GFX 库中打开示例代码：File > Seeed_GFX > Examples > Round Display > Arduino_Life

在与您的 Arduino 代码相同的文件夹中创建一个名为 driver.h 的新文件，点击示例选项卡旁边的箭头并选择"New Tab"。

将新文件命名为 driver.h。

前往 Seeed GFX 配置工具，选择"TRMNL 7.5" (OG) DIY Kit"，如图所示。

复制生成的代码并将其粘贴到您创建的 driver.h 文件中。代码应该如下所示：

#define BOARD_SCREEN_COMBO 501 // Round Display for Seeed Studio XIAO （GC9A01)

现在您可以将示例上传到您的 TRMNL DIY 套件，并看到 ePaper 显示屏的实际效果！

caution

请注意，所有后续屏幕的代码都需要配备一个 driver.h 文件，该文件用于选择要使用的屏幕类型。

演示 2：TFT 时钟​

caution

请参考演示1，在与 .ino 文件相同的目录中创建一个新的 driver.h 文件，并在其中保留以下代码：#define BOARD_SCREEN_COMBO 501

tip

我们需要使用圆形显示屏上的 RTC 功能，因此您还需要搜索并安装 I2C BM8563 RTC 库。

硬件和软件准备就绪后，我们开始上传第一个示例程序。此示例程序可用于检查圆形显示屏的 RTC 时钟是否正常工作。由于此演示需要少量内存，适用于所有 XIAO 型号。

tip

如果您想修改此演示以实现更复杂的显示，请注意您使用的 XIAO 的内存大小。具体大小可以在该 XIAO 的介绍页面上找到。

您可以在 Arduino IDE 中的 文件 -> 示例 -> Seeed Arduino Round display -> TFT_Clock 下找到此示例程序。

只需选择您使用的 XIAO 和 XIAO 所在的端口号，编译并上传即可。

确保圆形显示屏开关切换到 ON 位置。

如果程序运行顺利，您将看到以下效果。

演示 3：硬件测试​

caution

请参考演示1，在与 .ino 文件相同的目录中创建一个新的 driver.h 文件，并在其中保留以下代码：#define BOARD_SCREEN_COMBO 501

由于硬件测试演示比较复杂且占用较大内存，一些 XIAO 型号可能由于内存不足而无法成功运行。我们创建了一个测试表供您参考，使用 TFT 库和 Arduino GFX 库。

TFT 库Arduino GFX
XIAO SAMD21❌❌
XIAO RP2040❌❌
XIAO RA4M1❌❌
XIAO nRF52840 非 mbed 版本✅❌
XIAO nRF52840 mbed 版本❌✅
XIAO ESP32C3✅✅
XIAO ESP32C6✅❌
XIAO ESP32S3✅✅

这个示例程序可以用来检查圆形显示屏的RTC时钟、SD卡和触摸功能是否正常工作。

tip

我们需要使用圆形显示屏上的RTC功能，所以您还需要搜索并安装 I2C BM8563 RTC 库。

您可以在Arduino IDE中的 文件 -> 示例 -> Seeed Arduino Round display -> HardwareTest 下找到这个示例程序。

只需选择您正在使用的XIAO和XIAO所在的端口号，编译并上传即可。

确保圆形显示屏的开关切换到ON位置。

如果程序运行顺利，您将看到以下效果。

note

这个示例程序将测试扩展板的所有功能项目，包括RTC功能。如果您没有安装I2C BM8563 RTC库，那么可能会报错，您可以注释掉函数 lv_hardware_test()，然后SD卡的功能检测也会被关闭。

校准固件更新​

tip

如果您发现触摸有时无响应，您可以按照以下步骤更新屏幕的校准固件。

  1. 从这个链接下载代码
  1. 将它们放在同一个目录中并运行这个固件。
  1. 打开串口监视器，您将看到如下图所示的成功消息，这意味着更新成功，您可以上传您的程序来尝试！

故障排除​

Q1: 为什么我上传程序后显示屏什么都不显示？​

A: 请检查圆形显示屏的开关是否打开。如果您使用的是XIAO ESP32C3，您可能还需要在上传程序后按下复位键才能使其工作。

Q2: 如果我想将Seeed Studio XIAO ESP32S3 Sense连接到这个扩展屏幕，两个TF卡槽会产生冲突吗？​

A: 这不会产生冲突。不同的SD卡槽通过片选控制，如果您想使用Sense上的microSD卡槽，片选引脚应该是 21，如果您想使用圆形显示屏上的microSD卡槽，片选引脚应该是 D2。

我们在S3 Sense相机教程中有同时使用硬件和microSD卡的示例。

Q3: 为什么我的XIAO RP2040在使用圆形显示屏的HardwareTest代码时出现非常奇怪的C++错误？​

A: 这可能是由于您没有为XIAO RP2040选择适当的编译选项造成的。请参考下图进行设置并重新上传程序。

资源​

技术支持与产品讨论​

感谢您选择我们的产品！我们在这里为您提供不同的支持，以确保您使用我们产品的体验尽可能顺畅。我们提供多种沟通渠道，以满足不同的偏好和需求。

Loading Comments...