Saltar al contenido principal

Introducción a Seeed Studio Round Display para XIAO

Consigue uno ahora 🖱️

Introducción​

Seeed Studio Round Display para XIAO es una placa de expansión compatible con todas las placas de desarrollo XIAO. Incorpora en un lado una pantalla táctil de cobertura completa, diseñada como un disco de 39 mm. Contiene RTC integrado, chip de carga y ranura para tarjeta TF dentro de su tamaño compacto, perfecta para pantallas interactivas en hogares inteligentes, wearables y más.

REVDescripciónFECHAPOR
v1.0Versión inicial2023/1/29Linus.Liao
v1.11.Cambiar el IC de carga de la batería de litio
2.Añadir un interruptor a A0 y D6		2023/4/7Linus.Liao

Especificación​

ElementoDetalle
AlimentaciónUSB Type-C: 5V @35 mA
Carga de batería: 3.7V @37mA
Corriente de carga~ 485 mA
Memoria ampliableRanura para tarjeta TF de hasta 32GB FAT
PantallaPantalla táctil de 1,28 pulgadas
Resolución 240×240
65K colores
Otro equipo externoConector JST 1.25
Dimensiones39mm x 39mm

Características​

  • Placa de expansión con pantalla táctil capacitiva: Pantalla redonda de 1,28 pulgadas, resolución 240×240, 65K colores, que proporciona una exhibición de imágenes clara y colorida
  • Alta compatibilidad: Altamente compatible con todos los productos de la serie XIAO, se integra fácilmente en tus proyectos actuales
  • Periféricos ricos: Incorpora RTC, chip de carga de batería, ranura para tarjeta TF y conector JST 1.25, todo dentro de su tamaño compacto
  • Diseño del tamaño de un reloj: Presenta 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

Descripción general del hardware​

Antes de empezar, podemos consultar las siguientes imágenes para comprender el diseño de pines de la Round Display y así facilitar nuestra comprensión de la función de la Round Display.

Desde el 7 de abril de 2023, la Round Display renovada añade un interruptor de 2 bits para controlar la retroiluminación de la pantalla y la lectura del voltaje de la batería, de modo que el usuario pueda elegir libremente si usar el pin o liberarlo. Haz clic aquí para leer más detalles.

Primeros pasos​

Preparación de hardware​

Si quieres aprovechar al máximo las capacidades de la Round Display y tener una gran experiencia, te recomendamos encarecidamente que compres nuestra serie XIAO como placa base para la Round Display.

tip

XIAO SAMD21, RP2040 y RA4M1 pueden no ser compatibles con pantallas circulares debido a memoria insuficiente.

Seeed Studio XIAO nRF52840 (Sense)Seeed Studio XIAO ESP32C3Seeed Studio XIAO ESP32S3 (Sense)Seeed Studio XIAO ESP32C6
Consigue uno ahora 🖱️
Consigue uno ahora 🖱️
Consigue uno ahora 🖱️
Consigue uno ahora 🖱️

La hilera de pines en la parte posterior de la Round Display está diseñada para la serie XIAO. Si ya tienes una XIAO, no necesitas preparar cables adicionales, solo alinea los pines de la XIAO e insértalos directamente en la Round Display.

precaución

Ten en cuenta que al conectar la XIAO, el conector Type-C de la XIAO debe mirar hacia el exterior de la Round Display. Si accidentalmente inviertes la polaridad, no te preocupes demasiado, la Round Display tiene un circuito de protección de alimentación que no se dañará fácilmente, pero no recomendamos que mantengas la conexión invertida durante mucho tiempo.

La orientación recomendada para la Round Display es: cuando mires de frente la Round Display, el conector Type-C de la XIAO debe mirar hacia la derecha, de modo que el botón de encendido/apagado de la Round Display quede en la esquina inferior izquierda.

Preparación de software​

Para usar la Round Display, necesitamos programar la serie XIAO. La herramienta de programación recomendada es el Arduino IDE, y debes configurar el entorno de Arduino para la XIAO y añadir el paquete de la placa.

tip

Si es la primera vez que usas Arduino, te recomendamos encarecidamente que consultes Introducción a Arduino.

Paso 1. Descarga e instala la versión estable de Arduino IDE según tu sistema operativo​

Descargar Arduino IDE

Paso 2. Inicia la aplicación de Arduino​

Paso 3. Configura el Arduino IDE para la XIAO que estás utilizando​

  • Si quieres usar Seeed Studio XIAO RP2350 para las rutinas posteriores, consulta este tutorial para completar la adición.

  • Si quieres usar Seeed Studio XIAO nRF52840 para las rutinas posteriores, consulta este tutorial para completar la adición.

  • Si quieres usar Seeed Studio XIAO ESP32C3 para las rutinas posteriores, consulta este tutorial para completar la adición.

  • Si quieres usar Seeed Studio XIAO ESP32C6 para las rutinas posteriores, consulta este tutorial para completar la adición.

  • Si quieres usar Seeed Studio XIAO ESP32S3 para las rutinas posteriores, consulta este tutorial para completar la adición.

Paso 4. Instalación de las bibliotecas gráficas y de control de la pantalla​

Para usar la Round Display, necesitamos instalar previamente dos bibliotecas. Una es la biblioteca del controlador del dispositivo Round Display, que se utiliza para controlar las funciones de pantalla y táctil del dispositivo. La otra es la biblioteca de visualización gráfica, que proporciona algunas interfaces muy comunes para dibujar gráficos.

  1. Descarga la biblioteca Seeed_Arduino_RoundDisplay desde GitHub:
Descargar la biblioteca

  1. Descarga la biblioteca Seeed_GFX desde GitHub:
Descargar la biblioteca

  1. Instala la biblioteca añadiendo el archivo ZIP en Arduino IDE. Ve a Sketch > Include Library > Add .ZIP Library y selecciona el archivo ZIP descargado.
nota

Si has instalado previamente la biblioteca TFT_eSPI, es posible que tengas que eliminarla temporalmente o cambiarle el nombre en la carpeta de bibliotecas de Arduino para evitar conflictos, ya que Seeed_GFX es un fork de TFT_eSPI con funciones adicionales.

Descripción general de la biblioteca de Arduino​

Como probablemente podamos ver en el tutorial anterior, Round Display utiliza principalmente las bibliotecas LVGL, TFT_eSPI y Arduino GFX. Por motivos de espacio, presentaremos el uso de las bibliotecas LVGL y TFT_eSPI por separado con el ejemplo de dibujar una esfera.

  • Puedes conocer la interfaz y el uso de la biblioteca TFT_eSPI haciendo clic aquí.

  • Puedes conocer la interfaz y el uso de la biblioteca LVGL haciendo clic aquí.

  • Puedes conocer la interfaz y el uso de la biblioteca Arduino GFX haciendo clic aquí.

Enciende tu Round Display​

Demo 1: Arduino Life - Cómo usar la biblioteca Seeed_GFX en la pantalla redonda​

Abre el ejemplo de sketch de la biblioteca Seeed_GFX: File > Seeed_GFX > Examples > Round Display > Arduino_Life

Crea un nuevo archivo llamado driver.h en la misma carpeta que tu sketch de Arduino haciendo clic en la flecha junto a la pestaña del ejemplo y seleccionando "New Tab".

Nombra el nuevo archivo como driver.h.

Ve a la Seeed GFX Configuration Tool, y selecciona "Round Display for Seeed Studio XIAO" como se muestra en la imagen.

Copia el código generado y pégalo en el archivo driver.h que creaste. El código debería verse así:

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

¡Ahora puedes subir el ejemplo a tu Round Display y ver la pantalla LCD en acción!

precaución

Ten en cuenta que el código de todas las pantallas posteriores debe ir acompañado de un archivo driver.h, que se utiliza para seleccionar el tipo de pantalla que se va a utilizar.

Demo 2: TFT Clock​

precaución

Por favor, consulta la Demo1, crea un nuevo archivo driver.h en el mismo directorio que el archivo .ino, y mantén en él el siguiente código: #define BOARD_SCREEN_COMBO 501

tip

Necesitamos usar la función RTC en la pantalla redonda, por lo que también necesitas buscar e instalar la biblioteca I2C BM8563 RTC.

Una vez que el hardware y el software estén listos, empezamos a subir nuestro primer programa de ejemplo. Este programa de ejemplo se puede utilizar para comprobar si el reloj RTC del Round Display funciona correctamente. Debido a que esta demo requiere una pequeña cantidad de memoria, es adecuada para todos los modelos XIAO.

tip

Si quieres 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.

Puedes encontrar este programa de ejemplo en Arduino IDE en File -> Examples -> Seeed Arduino Round display -> TFT_Clock.

Solo tienes que seleccionar el XIAO que estás utilizando y el número de puerto donde se encuentra el XIAO, compilarlo y subirlo.

Asegúrate de que el interruptor del Round Display esté en la posición ON.

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

Demo 3: Hareware Test​

precaución

Por favor, consulta la Demo1, crea un nuevo archivo driver.h en el mismo directorio que el archivo .ino, y mantén en él el siguiente código: #define BOARD_SCREEN_COMBO 501

Debido a que la demo HardwareTest es un poco compleja y ocupa una mayor cantidad de memoria, algunos modelos XIAO pueden no ejecutarse correctamente debido a memoria insuficiente. Hemos creado una tabla de pruebas para tu referencia, utilizando la biblioteca TFT y la biblioteca Arduino GFX.

Biblioteca TFTArduino 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 comprobar si el reloj RTC, la tarjeta SD y las funciones táctiles del Round Display funcionan correctamente.

tip

Necesitamos usar la función RTC en la pantalla redonda, por lo que también necesitas buscar e instalar la biblioteca I2C BM8563 RTC.

Puedes encontrar este programa de ejemplo en Arduino IDE en File -> Examples -> Seeed Arduino Round display -> HardwareTest.

Solo tienes que seleccionar el XIAO que estás utilizando y el número de puerto donde se encuentra el XIAO, compilarlo y subirlo.

Asegúrate de que el interruptor del Round Display esté en la posición ON.

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

nota

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, entonces puede aparecer un error; puedes comentar la función lv_hardware_test(), entonces también se desactivará la detección funcional de la tarjeta SD.

Actualización del firmware de calibración​

tip

Si descubres que a veces la función táctil no responde, puedes seguir los pasos siguientes para actualizar el firmware de calibración de la pantalla.

  1. Descarga el código desde este enlace
  1. Ponlos en el mismo directorio y ejecuta este firmware.
  1. Abre el monitor serie y verás un mensaje de éxito como en la imagen de abajo, lo que significa que la actualización se ha realizado correctamente y ¡puedes subir tu programa para probarlo!

Solución de problemas​

P1: ¿Por qué la pantalla no muestra nada después de subir el programa?​

R: Por favor, comprueba que el interruptor del Round Display esté encendido. Si estás utilizando el XIAO ESP32C3, es posible que también tengas que pulsar Reset después de subir el programa para que funcione.

P2: Si quiero conectar Seeed Studio XIAO ESP32S3 Sense a esta pantalla de expansión, ¿habrá un conflicto con dos ranuras para tarjeta TF?​

R: Esto no crea ningún conflicto. Las diferentes ranuras para tarjetas SD se controlan mediante chip select; si quieres usar la ranura para tarjeta microSD en Sense, el pin de chip select debe ser 21, si quieres usar la ranura para tarjeta microSD en Round Display, el pin de chip select debe ser D2.

Tenemos ejemplos de uso tanto del hardware como de tarjetas microSD en el tutorial de la cámara S3 Sense.

P3: ¿Por qué mi XIAO RP2040 muestra un error de C++ muy extraño cuando uso el código de HardwareTest con la pantalla redonda?​

R: Esto puede deberse a que no has seleccionado la opción de compilación adecuada para la XIAO RP2040. Consulta el diagrama siguiente para configurarlo y volver a cargar el programa.

Recursos​

Soporte técnico y debate sobre el producto​

¡Gracias por elegir nuestros productos! Estamos aquí para ofrecerte diferentes tipos de soporte y 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.

Loading Comments...