Skip to main content

基于 XIAO 的圆形显示器快速上手

点击购买 🖱️

引言​

Seeed Studio Round Display for XIAO是一款兼容所有XIAO开发板的扩展板。它的一侧有一个全覆盖的触摸屏，设计为39毫米的圆盘。它包含板载RTC、充电芯片、TF卡插槽，体积小巧，非常适合智能家居、可穿戴设备等的交互式显示器。

规格​

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

功能​

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

硬件概述​

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

入门​

硬件准备​

如果您想充分利用圆显的功能并获得良好的体验，我们强烈建议您购买我们的XIAO系列作为圆显的主板。

Seeed Studio XIAO SAMD21Seeed Studio XIAO RP2040Seeed Studio XIAO nRF52840 (Sense)Seeed Studio XIAO ESP32C3Seeed Studio XIAO ESP32S3 (Sense)
点击购买 🖱️
点击购买 🖱️
点击购买 🖱️
点击购买 🖱️
点击购买 🖱️

圆形显示器背面的一排引脚是为XIAO系列设计的。如果你手头有XIAO，你不需要准备任何额外的电缆，只需对准XIAO的引脚并将其直接插入圆形显示器即可。

danger

请注意，连接XIAO时，XIAO的C型连接器应面向圆形显示器的外侧。如果你不小心颠倒了极性，不要太担心，圆形显示器有一个电源保护电路，不会轻易损坏，但我们不建议你长时间保持反向连接。

圆形显示的推荐方向是：当您面对圆形显示时，XIAO的Type-C连接器朝向右侧，因此圆形显示的打开/关闭按钮位于左下角。

软件准备​

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

：：提示 如果这是您第一次使用Arduino，我们强烈建议您参考Arduino入门. :::

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

下载 Arduino IDE

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

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

  • 如果您想使用Seeed Studio XIAO SAMD21进行后续例程，请参阅this tutorial 以完成添加。

  • 如果您想使用Seeed Studio XIAO RP2040进行后续例程，请参阅本教程以完成添加。

  • 如果您想使用Seeed Studio XIAO nRF52840进行后续例程，请参阅this tutorial 以完成添加。

  • 如果您想使用Seeed Studio XIAO ESP32C3进行后续例程，请参阅本教程以完成添加。

  • 如果您想在后面的例程中使用Seeed Studio XIAO ESP32S3，请参阅本教程以完成添加。

步骤4。将圆形显示库添加到Arduino。​

首先，您需要在Arduino IDE中搜索并下载最新版本的TFT_eSPI和LVGL库。

如果您想在扩展板上使用RTC功能，则还需要搜索并安装I2C BM8563 RTC库。

note

与Round Display兼容的TFT_eSPI库已提交合并请求，因此在下一版本发布时，您可以在Arduino IDE中搜索并下载TFT_eSPI以正常使用。在此之前，如果您需要将TFT_eSPI库用于Round Display，请从此处下载。

下载库

如果您以前安装过TFT_eSPI库，请删除原始库并安装新库。

然后，我们还需要下载并导入Round Display的配置库。

下载库

既然您已经下载了zip库，请打开Arduino IDE，单击草图>包含库>添加.zip库。选择刚下载的zip文件，如果库安装正确，您将在通知窗口中看到库已添加到库中。这意味着库已成功安装。

然后，您需要获取“lv_conf.h”文件，并将其剪切到Arduino库的根目录中。

：：：小心 请注意，此处的“lv_conf.h”文件来自Seeed_Arduino_RoundDisplay，而不是来自LVGL库。 ：：：

在Windows上，Arduino库的根目录是： C:\Users\${UserName}\Documents\Arduino\libraries

步骤5。（可选）配置使用环境​

Round Display目前适用于两种不同的基于库的显示器，一种是TFT_eSPI，另一种是Arduino GFX。在nRF52840上，Arduino GFX将具有明显更好的性能。

：：：注释 如果需要使用TFT_eSPI库，请继续执行步骤5。如果你正在使用Arduino GFX，那么你可以跳过这一步。 关于Round Display的内容，我们的教程将重点介绍TFT_eSPI的使用。 ：：：

请在Arduino库的根目录中找到TFT_eSPI文件夹，然后修改TFT_eSPI目录中的“User_Setup_Select.h”文件。

C:\Users\${UserName}\Documents\Arduino\libraries\TFT_eSPI\User_Setup_Select.h

如果要使用TFT_eSPI库进行显示驱动，则必须在#include<User_Setup.h>行中注释，并在该行中取消注释#include <User_Setups/Setup66_Seeed_XIAO_RoundDisplay.h> 在User_Setup_Select.h 文件里。

Arduino图书馆概述​

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

  • 您可以通过单击了解TFT_eSPI库的接口和使用 此处.

  • 您可以通过单击了解LVGL库的界面和使用 此处.

  • 您可以通过单击了解Arduino GFX库的界面和使用 此处.

点亮圆形显示屏​

一旦硬件和软件准备就绪，我们就开始上传我们的第一个示例程序。此示例程序可用于检查圆显的RTC时钟、SD卡和触摸功能是否正常工作。

您可以在Arduino IDE中的 File -> Examples -> Seeed Arduino Round display -> HardwareTest.

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

确保圆形显示开关切换到ON（接通）位置。

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

：：：注释 此示例程序将测试扩展板的所有功能项目，包括RTC功能。如果您没有安装I2C BM8563 RTC库，则可能会报告错误，您可以注释掉该函数lv_hardware_test()，则SD卡的功能检测也将关闭。 :::

故障排除​

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

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

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

A： 这不会造成冲突。不同的SD卡插槽通过芯片选择进行控制，如果您想在Sense上使用microSD卡插槽，芯片选择引脚应为21，如果您想要在Round Display上使用microSD卡插槽，则芯片选择引脚应该为D2。

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

Q3：为什么我的XIAO RP2040在使用带有圆形显示的硬件测试代码时会出现一个非常奇怪的C++错误？​

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

Q4：我已经学习了教程，但仍然无法正确编译TFT或LVGL程序，该怎么办？​

TFT库和LVGL库的更新可能会导致教程中的过程失败。我们建议您使用我们的库的测试和稳定版本，您甚至无需自己更改其中的配置即可使用。

资源​

技术支持和产品讨论​

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

Loading Comments...