Comenzando con la pantalla redonda de Seeed Studio para XIAO

Introducción
La pantalla redonda de Seeed Studio para XIAO es una placa de expansión compatible con todas las placas de desarrollo XIAO. Cuenta con una pantalla táctil completamente cubierta en un lado, diseñada como un disco de 39 mm. Además, incluye un RTC integrado, un chip de carga y una ranura para tarjeta TF dentro de su tamaño compacto, lo que la hace perfecta para pantallas interactivas en hogares inteligentes, dispositivos portátiles y más.
REV | Descripción | FECHA | POR |
---|---|---|---|
v1.0 | Versión inicial | 2023/1/29 | Linus.Liao |
v1.1 | 1.Cambio Cargador Batería Li 2. Agregar un interruptor a A0 y D6 | 2023/4/7 | Linus.Liao |
Especificación
Artículo | Detalle |
---|---|
Fuente de alimentación | USB Tipo-C: 5V @35 mA Batería: 3.7V @37mA |
Corriente de carga | ~ 485 mA |
Memoria expandible | Ranura para tarjeta TF para hasta 32GB FAT |
Screen | Pantalla táctil de 1.28 pulgadas 240×240 resolution 65K colors |
Otros equipos externos | Conector JST 1.25 |
Dimensión | 39mm x 39mm |
Características
- Pantalla táctil capacitiva de expansión: Pantalla redonda de 1.28 pulgadas, resolución de 240×240, 65K colores, que proporciona una exhibición de imágenes clara y colorida.
- Alta compatibilidad: Alta compatibilidad con todos los productos de la serie XIAO, fácilmente integrable en tus proyectos actuales.
- Periféricos ricos: Cuenta con RTC integrado, chip de carga de batería, ranura para tarjeta TF, conector JST 1.25, todo dentro de su tamaño compacto.
- Diseño tamaño reloj: Viene con un diseño circular de 39 mm, adecuado para proyectos portátiles y con espacio limitado.
- Conectar y usar: Todos los pines están expuestos, no se necesita soldadura.
Visión general del hardware
Antes de comenzar, podemos consultar las siguientes imágenes para entender el diseño de los pines de la pantalla redonda y facilitar nuestra comprensión de la función de la pantalla.

Desde el 7 de abril de 2023, la pantalla redonda mejorada añade un interruptor de 2 bits para controlar la retroiluminación de la pantalla y la lectura de voltaje de la batería. Esto permite al usuario elegir libremente si utilizar el pin o liberarlo. Haz clic aquí para leer más detalles.

Empezando
Preparación de hardware
Si deseas aprovechar al máximo las capacidades de la pantalla redonda y tener una excelente experiencia, te recomendamos encarecidamente que adquieras nuestra serie XIAO como placa base para la pantalla redonda.
Las placas XIAO SAMD21, RP2040 y RA4M1 no son completamente compatibles con pantallas circulares debido a la memoria insuficiente.
Seeed Studio XIAO nRF52840 (Sense) | Seeed Studio XIAO ESP32C3 | Seeed Studio XIAO ESP32S3 (Sense) | Seeed Studio XIAO ESP32C6 |
---|---|---|---|
![]() | ![]() | ![]() | ![]() |
La fila de pines en la parte posterior de la pantalla redonda está diseñada para la serie XIAO. Si tienes una placa XIAO a mano, no necesitarás cables adicionales, solo alinea los pines de la XIAO y conéctalos directamente a la pantalla redonda.

Ten en cuenta que al conectar la XIAO, el conector Tipo-C de la XIAO debe estar orientado hacia el exterior de la pantalla redonda. Si por accidente conectas la polaridad al revés, no te preocupes demasiado, ya que la pantalla redonda tiene un circuito de protección de energía que no se dañará fácilmente. Sin embargo, no recomendamos mantener la conexión invertida durante mucho tiempo.
La orientación recomendada para la pantalla redonda es: cuando mires la pantalla redonda, el conector Type-C de la XIAO debe estar orientado hacia la derecha, de modo que el botón de encendido/apagado de la pantalla redonda quede en la esquina inferior izquierda.

Preparación de Software
Para usar la pantalla redonda, necesitamos programar la serie XIAO. La herramienta de programación recomendada es el Arduino IDE, y es necesario configurar el entorno de Arduino para la XIAO y agregar el paquete correspondiente para la placa.
Si es la primera vez que usas Arduino, te recomendamos consultar el tutorial Getting Started with Arduino para una guía detallada.
Paso 1. Descarga e instala la versión estable del IDE de Arduino según tu sistema operativo.
Paso 2. Abre la aplicación de Arduino.
Paso 3. Configura el IDE de Arduino para la XIAO que estés utilizando.
Si deseas usar Seeed Studio XIAO RP2350 para los siguientes procedimientos, consulta este tutorial para completar la configuración.
Si deseas usar Seeed Studio XIAO nRF52840 para los siguientes procedimientos, consulta este tutorial para completar la configuración.
Si deseas usar Seeed Studio XIAO ESP32C3 para los siguientes procedimientos, consulta este tutorial para completar la configuración.
Si deseas usar Seeed Studio XIAO ESP32C6 para los siguientes procedimientos, consulta este tutorial para completar la configuración.
Si deseas usar Seeed Studio XIAO ESP32S3 para los siguientes procedimientos, consulta este tutorial para completar la configuración.
Paso 4. Añadir la librería Round Display a Arduino.
Primero, necesitas descargar las librerías TFT_eSPI, LVGL y Round Screen en los siguientes enlaces.
Una vez que hayas descargado el archivo .ZIP de la librería, abre tu Arduino IDE, haz clic en Sketch > Incluir librería > Añadir librería .ZIP. Selecciona el archivo .ZIP que acabas de descargar y, si la librería se instala correctamente, verás un mensaje en la ventana de notificaciones que dice Librería añadida a tus bibliotecas. Esto significa que la librería se instaló correctamente.

Necesitamos usar la función RTC en la pantalla redonda, así que también debes buscar e instalar la librería I2C BM8563 RTC.

Luego, debes tomar el archivo lv_conf.h
y colocarlo en el directorio raíz de la biblioteca de Arduino.
Es importante señalar que el archivo lv_conf.h
aquí es del paquete Seeed_Arduino_RoundDisplay, no de la biblioteca LVGL.
En Windows, el directorio raíz de la biblioteca Arduino es:
C:\Users\${UserName}\Documents\Arduino\libraries

Paso 5. (Opcional) Configurar el entorno de uso
Actualmente, el Round Display es compatible con dos bibliotecas de pantalla diferentes: TFT_eSPI y Arduino GFX. Para el XIAO SAMD21 y XIAO nRF52840, no hay suficiente memoria para ejecutar la biblioteca TFT, por lo que Arduino GFX tendrá un rendimiento significativamente mejor. Puedes buscarla en el Arduino IDE y descargarla.
Si necesitas usar la biblioteca TFT_eSPI, entonces continúa con el paso 5. Si estás usando Arduino GFX, puedes omitir este paso.
Para el contenido de Round Display, nuestro tutorial se centrará en el uso de TFT_eSPI.
Resumen de la biblioteca Arduino
Como probablemente se puede deducir del tutorial anterior, Round Display utiliza principalmente las bibliotecas LVGL, TFT_eSPI y Arduino GFX. Para ahorrar espacio, presentaremos el uso de las bibliotecas LVGL y TFT_eSPI por separado con el ejemplo de dibujar un dial.
Puedes aprender sobre la interfaz y el uso de la biblioteca TFT_eSPI haciendo clic aquí.
Puedes aprender sobre la interfaz y el uso de la biblioteca LVGL haciendo clic aquí.
Puedes aprender sobre la interfaz y el uso de la biblioteca Arduino GFX haciendo clic aquí.
Enciende tu Round Display
Demo 1: Reloj TFT
Una vez que el hardware y el software estén listos, comenzamos a cargar nuestro primer programa de ejemplo. Este programa de muestra se puede utilizar para verificar si el reloj RTC del Round Display está funcionando correctamente. Debido a que esta demo requiere una pequeña cantidad de memoria, es adecuada para todos los modelos XIAO.
Si deseas modificar esta demo para implementar pantallas más complejas, ten en cuenta el tamaño de memoria del XIAO que estás utilizando. El tamaño específico se puede encontrar en la página de introducción de ese XIAO.
YPuedes encontrar este programa de ejemplo en el IDE de Arduino en Archivo -> Ejemplos -> Seeed Arduino Round display -> TFT_Clock.

Solo selecciona el XIAO que estás utilizando y el número de puerto donde se encuentra el XIAO, compila y súbelo.
Asegúrate de que el interruptor del Round Display esté en la posición ON.

Si el programa se ejecuta sin problemas, verá el siguiente efecto.

Demo 2: Prueba de Hardware
Debido a que la demo HardwareTest es un poco compleja y ocupa una mayor cantidad de memoria, algunos modelos de XIAO pueden no ejecutarse correctamente debido a la falta de memoria. Hemos creado una tabla de prueba para tu referencia, utilizando la biblioteca TFT y la biblioteca Arduino GFX.
Biblioteca TFT | Arduino GFX | |
---|---|---|
XIAO SAMD21 | ❌ | ❌ |
XIAO RP2040 | ❌ | ❌ |
XIAO RA4M1 | ❌ | ❌ |
XIAO nRF52840 non mbed version | ✅ | ❌ |
XIAO nRF52840 mbed version | ❌ | ✅ |
XIAO ESP32C3 | ✅ | ✅ |
XIAO ESP32C6 | ✅ | ❌ |
XIAO ESP32S3 | ✅ | ✅ |
Este programa de ejemplo se puede utilizar para verificar si el reloj RTC, la tarjeta SD y las funciones táctiles del Round Display están funcionando correctamente.
Puedes encontrar este programa de ejemplo en el IDE de Arduino en Archivo -> Ejemplos -> Seeed Arduino Round display -> HardwareTest.

Solo selecciona el XIAO que estás utilizando y el número de puerto donde se encuentra el XIAO, compila y súbelo.
Asegúrate de que el interruptor del Round Display esté en la posición ON.

Si el programa se ejecuta sin problemas, verá el siguiente efecto.

Este programa de ejemplo probará todos los elementos funcionales de la placa de expansión, incluida la función RTC. Si no tienes instalada la biblioteca I2C BM8563 RTC, es posible que se reporte un error. Puedes comentar la función lv_hardware_test()
, de modo que la detección funcional de la tarjeta SD también se desactive.
Actualización del firmware de calibración
Si encuentras que el tacto a veces no responde, puedes seguir los pasos a continuación para actualizar el firmware de calibración de la pantalla.
- Descarga los códigos desde este enlace.

- Colócalos en el mismo directorio y ejecuta este firmware.

- Abre el monitor serial y verás un mensaje de éxito como la imagen de abajo, lo que significa que la actualización fue exitosa y puedes cargar tu programa para probarlo.

Solución de problemas
P1: ¿Por qué no muestra nada la pantalla después de cargar el programa?
R: Por favor, verifica que el interruptor del Round Display esté encendido. Si estás utilizando el XIAO ESP32C3, también es posible que necesites presionar el botón de Reset después de cargar el programa para que funcione.
P2: Si quiero conectar el Seeed Studio XIAO ESP32S3 Sense a esta pantalla de expansión, ¿habrá un conflicto con dos ranuras para tarjetas TF?
R: Esto no crea un conflicto. Las diferentes ranuras para tarjetas SD son controladas mediante selección de chip. Si deseas usar la ranura microSD en Sense, el pin de selección de chip debe ser 21. Si deseas usar la ranura microSD en Round Display, el pin de selección de chip debe ser D2.
Tenemos ejemplos de cómo usar tanto hardware como microSD en el tutorial de la cámara S3 Sense.
P3: ¿Por qué mi XIAO RP2040 da un error extraño de C++ al usar el código para HardwareTest con Round Display?
R: Esto puede deberse a que no has seleccionado la opción de compilación adecuada para el XIAO RP2040. Por favor, consulta el diagrama a continuación para configurarlo y volver a cargar el programa.

Recursos
- [PDF] Hoja de datos del Charge IC
- [PDF] Hoja de datos del ETA3410
- [PDF] Hoja de datos del RTC PCF8563
- [PDF] Hoja de datos de la pantalla LCD TFT a-Si de 1.28''
- [PDF] Esquema del Seeed Studio Round Display para XIAO
- [PDF] Esquema del Seeed Studio Round Display para XIAO v1.1
- [PDF] Hoja de datos de GJX0128A4-15HY
- [ZIP] Esquema y PCB del Seeed Studio Round Display para XIAO
- [ZIP] Esquema y PCB del Seeed Studio Round Display para XIAO v1.1
- [3DM] Modelo 3D del Round Display para XIAO
- [STL] Diagrama del modelo 3D de la carcasa para Round Display
- [STL] Caja para Seeed Studio XIAO ESP32 S3 Sense con pantalla redonda
Soporte técnico y discusión del producto
¡Gracias por elegir nuestros productos! Estamos aquí para brindarte el apoyo necesario para garantizar que tu experiencia con nuestros productos sea lo más fluida posible. Ofrecemos varios canales de comunicación para adaptarnos a diferentes preferencias y necesidades.