Skip to main content

Primeros Pasos con Seeed Studio Round Display para XIAO

Introducción

Seeed Studio Round Display 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 39mm. Contiene RTC integrado, chip de carga, ranura para tarjeta TF dentro de su tamaño compacto, perfecto para pantallas interactivas en hogar inteligente, dispositivos portátiles y más.

REVDescripciónFECHAPOR
v1.0Versión Inicial2023/1/29Linus.Liao
v1.11.Cambiar IC de Carga de Batería Li
2.Agregar un interruptor a A0 y D6
2023/4/7Linus.Liao

Especificación

ElementoDetalle
Fuente de AlimentaciónUSB Tipo-C: 5V @35 mA
Carga de Batería: 3.7V @37mA
Corriente de carga~ 485 mA
Memoria expandibleRanura para tarjeta TF hasta 32GB FAT
PantallaPantalla táctil de 1.28 pulgadas
Resolución 240×240
65K colores
Otro Equipo ExternoConector JST 1.25
Dimensión39mm 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, proporcionando una exhibición de imágenes clara y colorida
  • Alta Compatibilidad: Altamente compatible con todos los productos de la serie XIAO, fácilmente integrable en tus proyectos actuales
  • Periféricos Ricos: Incluye 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 del Tamaño de un Reloj: Viene con diseño circular de 39 mm, adecuado para proyectos portátiles y con limitaciones de espacio
  • Plug and Play: Todos los pines están disponibles, no se necesita soldadura

Descripción General del Hardware

Antes de comenzar, podemos referirnos a las siguientes imágenes para entender el diseño de pines de la Pantalla Redonda para facilitar nuestra comprensión de la función de la Pantalla Redonda.

Desde el 7 de abril de 2023, la Pantalla Redonda 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. Para que el usuario pueda elegir libremente si usar el pin o liberarlo. Haz clic aquí para leer más detalles.

Primeros Pasos

Preparación del Hardware

Si quieres aprovechar todas las capacidades de la Pantalla Redonda y tener una gran experiencia, te recomendamos encarecidamente que compres nuestra serie XIAO como placa madre para la Pantalla Redonda.

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

La fila de pines en la parte posterior del Round Display está diseñada para la serie XIAO. Si tienes XIAO a mano, no necesitas preparar cables adicionales, simplemente alinea los pines del XIAO y conéctalos directamente al Round Display.

caution

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

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

Preparación del Software

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

tip

Si esta es tu primera vez usando Arduino, te recomendamos encarecidamente que consultes Comenzando con Arduino.

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

Paso 2. Ejecuta la aplicación Arduino.

Paso 3. Configura el Arduino IDE para el XIAO que estés usando.

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

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

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

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

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

Paso 4. Instalación de bibliotecas gráficas y bibliotecas de controladores de pantalla

Para usar el round display, necesitamos instalar dos bibliotecas con anticipación. Una es la biblioteca de controladores de dispositivo del round display, que se usa 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:

  1. Descarga la biblioteca Seeed_GFX desde GitHub:

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

Si previamente has instalado la biblioteca TFT_eSPI, es posible que necesites eliminarla temporalmente o renombrarla en tu carpeta de bibliotecas de Arduino para evitar conflictos, ya que Seeed_GFX es una bifurcación de TFT_eSPI con características adicionales.

Descripción General de la Biblioteca Arduino

Como probablemente podemos deducir del tutorial anterior, Round Display utiliza principalmente las bibliotecas LVGL, TFT_eSPI y Arduino GFX. Por cuestiones de 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: Arduino Life - Cómo usar la biblioteca Seeed_GFX en round display

Abre el sketch de ejemplo 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 Herramienta de Configuración Seeed GFX, y selecciona "TRMNL 7.5" (OG) DIY Kit" 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 TRMNL DIY Kit y ver la pantalla ePaper en acción!

caution

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

Demo 2: Reloj TFT

caution

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

tip

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

Una vez que el hardware y software estén listos, comenzamos subiendo nuestro primer programa de ejemplo. Este programa de muestra puede usarse para verificar si el reloj RTC de la Pantalla Redonda está funcionando 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, por favor ten en cuenta el tamaño de memoria del XIAO que estás usando. El tamaño específico se puede encontrar en la página de introducción de ese XIAO.

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

Solo selecciona el XIAO que estás usando y el número de puerto donde está ubicado el XIAO, compila y súbelo.

Asegúrate de que el interruptor de la Pantalla Redonda esté en la posición ON.

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

Demo 3: Prueba de Hardware

caution

Por favor consulta Demo1, crea un nuevo archivo driver.h en el mismo directorio que el archivo .ino, y mantén el siguiente código en él: #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 fallar al ejecutarse exitosamente debido a memoria insuficiente. Hemos creado una tabla de prueba para tu referencia, usando la librería TFT y la librería Arduino GFX.

Librería TFTArduino GFX
XIAO SAMD21
XIAO RP2040
XIAO RA4M1
XIAO nRF52840 versión no mbed
XIAO nRF52840 versión mbed
XIAO ESP32C3
XIAO ESP32C6
XIAO ESP32S3

Este programa de ejemplo se puede usar para verificar si el reloj RTC de la Round Display, la tarjeta SD y las funciones táctiles están funcionando 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 el IDE de Arduino bajo File -> Examples -> Seeed Arduino Round display -> HardwareTest.

Solo selecciona el XIAO que estés usando y el número de puerto donde se encuentra el XIAO, compila y súbelo.

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

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

note

Este programa de ejemplo probará todos los elementos funcionales de la placa de expansión, incluyendo la función RTC. Si no tienes instalada la biblioteca I2C BM8563 RTC, entonces puede reportarse un error, puedes comentar la función lv_hardware_test(), entonces la detección funcional de la tarjeta SD también se desactivará.

Actualización del Firmware de Calibración

tip

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

  1. Descarga los códigos desde este enlace
  1. Ponlos en el mismo directorio y ejecuta este firmware.
  1. Abre el monitor serie y verás un mensaje exitoso como esta imagen a continuación, lo que significa que se actualizó exitosamente 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 verifica que el interruptor de la Round Display esté encendido. Si estás usando el XIAO ESP32C3, también puede que necesites presionar Reset después de subir el programa para que funcione.

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

R: Esto no crea un conflicto. Las diferentes ranuras de tarjeta SD se controlan mediante selección de chip, si quieres usar la ranura de tarjeta microSD en Sense, el pin de selección de chip debe ser 21, si quieres usar la ranura de tarjeta microSD en Round Display, el pin de selección de chip debe ser D2.

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

P3: ¿Por qué mi XIAO RP2040 obtiene un error de C++ muy extraño al usar el código para HardwareTest con Round Display?

R: Esto puede ser causado por no seleccionar la opción de compilación apropiada para el XIAO RP2040. Por favor consulta el diagrama a continuación para configurar y volver a subir el programa.

Recursos

Soporte técnico y discusión de productos

¡Gracias por elegir nuestros productos! Estamos aquí para brindarle diferentes tipos de soporte para asegurar que su experiencia con nuestros productos sea lo más fluida posible. Ofrecemos varios canales de comunicación para satisfacer diferentes preferencias y necesidades.

Loading Comments...