Skip to main content

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

note

本文档由 AI 翻译。如您发现内容有误或有改进建议，欢迎通过页面下方的评论区，或在以下 Issue 页面中告诉我们：https://github.com/Seeed-Studio/wiki-documents/issues

立即购买 🖱️

简介​

Seeed Studio 圆形显示屏是兼容所有 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
可扩展存储支持最大 32GB FAT 的 TF 卡插槽
屏幕1.28 英寸触摸屏
240×240 分辨率
65K 色彩
其他外部设备JST 1.25 接口
尺寸39mm x 39mm

特性​

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

硬件概览​

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

自 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 入门指南。

第一步：根据您的操作系统下载并安装稳定版本的 Arduino IDE。​

下载 Arduino IDE

第二步：启动 Arduino 应用程序。​

第三步：为您使用的 XIAO 配置 Arduino IDE。​

  • 如果您想使用 Seeed Studio XIAO RP2350 进行后续操作，请参考 此教程 完成添加。

  • 如果您想使用 Seeed Studio XIAO nRF52840 进行后续操作，请参考 此教程 完成添加。

  • 如果您想使用 Seeed Studio XIAO ESP32C3 进行后续操作，请参考 此教程 完成添加。

  • 如果您想使用 Seeed Studio XIAO ESP32C6 进行后续操作，请参考 此教程 完成添加。

  • 如果您想使用 Seeed Studio XIAO ESP32S3 进行后续操作，请参考 此教程 完成添加。

第四步：将 Round Display 的库添加到 Arduino。​

首先，您需要下载以下链接中的 TFT_eSPI、LVGL 和 Round Screen 库。

下载 LVGL 库

下载 TFT 库

下载屏幕库

既然您已经下载了 ZIP 库，请打开 Arduino IDE，点击 Sketch > Include Library > Add .ZIP Library。选择您刚刚下载的 ZIP 文件，如果库安装正确，您会在通知窗口中看到 Library added to your libraries。这意味着库已成功安装。

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

然后，您需要将 lv_conf.h 文件剪切到 Arduino 库的根目录。

caution

请注意，这里的 lv_conf.h 文件来自 Seeed_Arduino_RoundDisplay，而不是 LVGL 库。

在 Windows 系统中，Arduino 库的根目录是：

C:\Users\${UserName}\Documents\Arduino\libraries

第五步 (可选) 配置使用环境​

圆形显示屏目前适配了基于两种不同库的显示屏，一个是 TFT_eSPI，另一个是 Arduino GFX。对于 XIAO SAMD21 和 XIAO nRF52840，由于内存不足无法运行 TFT 库，而 Arduino GFX 的性能会显著更好。您可以在 Arduino IDE 中搜索并下载它。

tip

如果您需要使用 TFT_eSPI 库，请继续执行 第五步。如果您使用的是 Arduino GFX，则可以跳过此步骤。

关于圆形显示屏的内容，我们的教程将重点介绍 TFT_eSPI 的使用。

Arduino 库概述​

从上述教程中我们可以看出，圆形显示屏主要使用 LVGL、TFT_eSPI 和 Arduino GFX 库。为了节省空间，我们将分别介绍 LVGL 和 TFT_eSPI 库的使用，并以绘制表盘为例。

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

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

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

点亮您的圆形显示屏​

示例 1: TFT 时钟​

tip

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

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

tip

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

您可以在 Arduino IDE 中找到此示例程序，路径为 File -> Examples -> Seeed Arduino Round display -> TFT_Clock。

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

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

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

示例 2: 硬件测试​

由于 HardwareTest 示例较为复杂且占用较大的内存，一些 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 中找到此示例程序，路径为 File -> Examples -> 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...