Pular para o conteúdo principal

Primeiros Passos com o Seeed Studio Round Display para XIAO

Compre Agora 🖱️

Introdução​

O Seeed Studio Round Display para XIAO é uma placa de expansão compatível com todas as placas de desenvolvimento XIAO. Ele possui uma tela sensível ao toque totalmente coberta em um dos lados, projetada como um disco de 39 mm. Contém RTC onboard, chip de carregamento, slot para cartão TF dentro de seu tamanho compacto, perfeito para exibições interativas em casas inteligentes, wearables e muito mais.

REVDescriçãoDATAPOR
v1.0Versão inicial2023/1/29Linus.Liao
v1.11.Alterar CI de carregamento de bateria Li
2.Adicionar uma chave para A0 e D6		2023/4/7Linus.Liao

Especificações​

ItemDetalhe
Fonte de alimentaçãoUSB Tipo-C: 5V @35 mA
Carregamento de bateria: 3.7V @37mA
Corrente de carregamento~ 485 mA
Memória expansívelSlot para cartão TF de até 32GB FAT
TelaTela sensível ao toque de 1,28 polegadas
Resolução 240×240
65K cores
Outro equipamento externoConector JST 1.25
Dimensão39mm x 39mm

Recursos​

  • Placa de expansão com tela sensível ao toque capacitiva: Tela redonda de 1,28 polegadas, resolução 240×240, 65K cores, proporcionando exibição de imagens claras e coloridas
  • Alta compatibilidade: Altamente compatível com todos os produtos da série XIAO, facilmente integrado aos seus projetos atuais
  • Periféricos ricos: Possui RTC onboard, chip de carregamento de bateria, slot para cartão TF, conector JST 1.25, tudo dentro de seu tamanho compacto
  • Design em tamanho de relógio: Vem com design circular de 39 mm, adequado para projetos vestíveis e com espaço limitado
  • Plug and Play: Todos os pinos são expostos, não é necessário soldar

Visão Geral de Hardware​

Antes de começarmos, podemos consultar as imagens a seguir para entender o design dos pinos do Round Display, a fim de facilitar nossa compreensão da função do Round Display.

Desde 7 de abril de 2023, o Round Display reformulado adiciona uma chave de 2 bits para controlar a luz de fundo da tela e a leitura da tensão da bateria. Para que o usuário possa escolher livremente se deseja usar o pino ou liberá-lo. Clique aqui para ler mais detalhes.

Primeiros Passos​

Preparação de Hardware​

Se você quiser aproveitar ao máximo os recursos do Round Display e ter uma ótima experiência, recomendamos fortemente que você adquira nossa série XIAO como a placa-mãe para o Round Display.

dica

XIAO SAMD21, RP2040 e RA4M1 podem não ser compatíveis com telas circulares devido à memória insuficiente.

Seeed Studio XIAO nRF52840 (Sense)Seeed Studio XIAO ESP32C3Seeed Studio XIAO ESP32S3 (Sense)Seeed Studio XIAO ESP32C6
Compre Agora 🖱️
Compre Agora 🖱️
Compre Agora 🖱️
Compre Agora 🖱️

A fileira de pinos na parte de trás do Round Display é projetada para a série XIAO. Se você já tiver um XIAO em mãos, não precisa preparar nenhum cabo adicional, apenas alinhe os pinos do XIAO e conecte-os diretamente ao Round Display.

cuidado

Observe que, ao conectar o XIAO, o conector Type-C do XIAO deve estar voltado para a parte externa do Round Display. Se você inverter a polaridade acidentalmente, não se preocupe demais, o Round Display possui um circuito de proteção de energia que não será facilmente danificado, mas não recomendamos que você mantenha a conexão invertida por muito tempo.

A orientação recomendada para o Round Display é: quando você estiver de frente para o Round Display, o conector Type-C do XIAO fica voltado para a direita, de modo que o botão liga/desliga do Round Display fique no canto inferior esquerdo.

Preparação de Software​

Para usar o Round Display, precisamos programar a série XIAO. A ferramenta de programação recomendada é o Arduino IDE, e você precisa configurar o ambiente Arduino para o XIAO e adicionar o pacote da placa.

dica

Se esta é a sua primeira vez usando o Arduino, recomendamos fortemente que você consulte Primeiros Passos com o Arduino.

Etapa 1. Baixe e instale a versão estável do Arduino IDE de acordo com seu sistema operacional​

Download Arduino IDE

Etapa 2. Inicie o aplicativo Arduino​

Etapa 3. Configure o Arduino IDE para o XIAO que você está usando​

  • Se você quiser usar o Seeed Studio XIAO RP2350 para as rotinas posteriores, consulte este tutorial para concluir a adição.

  • Se você quiser usar o Seeed Studio XIAO nRF52840 para as rotinas posteriores, consulte este tutorial para concluir a adição.

  • Se você quiser usar o Seeed Studio XIAO ESP32C3 para as rotinas posteriores, consulte este tutorial para concluir a adição.

  • Se você quiser usar o Seeed Studio XIAO ESP32C6 para as rotinas posteriores, consulte este tutorial para concluir a adição.

  • Se você quiser usar o Seeed Studio XIAO ESP32S3 para as rotinas posteriores, consulte este tutorial para concluir a adição.

Etapa 4. Instalação de bibliotecas gráficas e bibliotecas de driver de tela​

Para usar o round display, precisamos instalar duas bibliotecas com antecedência. Uma é a biblioteca de driver de dispositivo do round display, que é usada para acionar as funções de tela e toque do dispositivo. A outra é a biblioteca de exibição gráfica, que fornece algumas interfaces muito comuns para desenhar gráficos.

  1. Baixe a biblioteca Seeed_Arduino_RoundDisplay do GitHub:
Baixar a Biblioteca

  1. Baixe a biblioteca Seeed_GFX do GitHub:
Baixar a Biblioteca

  1. Instale a biblioteca adicionando o arquivo ZIP na IDE Arduino. Vá em Sketch > Include Library > Add .ZIP Library e selecione o arquivo ZIP baixado.
nota

Se você já tiver instalado a biblioteca TFT_eSPI anteriormente, talvez seja necessário removê-la temporariamente ou renomeá-la na pasta de bibliotecas do Arduino para evitar conflitos, pois Seeed_GFX é um fork de TFT_eSPI com recursos adicionais.

Visão geral das bibliotecas Arduino​

Como podemos ver pelo tutorial acima, a Round Display utiliza principalmente as bibliotecas LVGL, TFT_eSPI e Arduino GFX. Por questão de espaço, vamos apresentar o uso das bibliotecas LVGL e TFT_eSPI separadamente com o exemplo de desenhar um mostrador.

  • Você pode aprender sobre a interface e o uso da biblioteca TFT_eSPI clicando aqui.

  • Você pode aprender sobre a interface e o uso da biblioteca LVGL clicando aqui.

  • Você pode aprender sobre a interface e o uso da biblioteca Arduino GFX clicando aqui.

Acenda sua Round Display​

Demo 1: Arduino Life - Como usar a biblioteca Seeed_GFX na Round Display​

Abra o sketch de exemplo da biblioteca Seeed_GFX: File > Seeed_GFX > Examples > Round Display > Arduino_Life

Crie um novo arquivo chamado driver.h na mesma pasta do seu sketch Arduino clicando na seta ao lado da aba do exemplo e selecionando "New Tab".

Nomeie o novo arquivo como driver.h.

Acesse a Seeed GFX Configuration Tool, e selecione "TRMNL 7.5" (OG) DIY Kit" como mostrado na imagem.

Copie o código gerado e cole no arquivo driver.h que você criou. O código deve ser semelhante a isto:

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

Agora você pode enviar o exemplo para o seu TRMNL DIY Kit e ver o display ePaper em ação!

cuidado

Observe que o código para todas as telas subsequentes precisa ser acompanhado por um arquivo driver.h, que é usado para selecionar o tipo de tela a ser usada.

Demo 2: TFT Clock​

cuidado

Consulte o Demo1, crie um novo arquivo driver.h no mesmo diretório do arquivo .ino e mantenha o seguinte código nele: #define BOARD_SCREEN_COMBO 501

dica

Precisamos usar a função RTC na Round Display, então você também precisa buscar e instalar a biblioteca I2C BM8563 RTC.

Quando o hardware e o software estiverem prontos, começamos a enviar nosso primeiro programa de exemplo. Este programa pode ser usado para verificar se o relógio RTC da Round Display está funcionando corretamente. Como este demo requer uma pequena quantidade de memória, é adequado para todos os modelos XIAO.

dica

Se você quiser modificar este demo para implementar telas mais complexas, lembre-se do tamanho da memória do XIAO que você está usando. O tamanho específico pode ser encontrado na página de introdução desse XIAO.

Você pode encontrar este programa de exemplo na IDE Arduino em File -> Examples -> Seeed Arduino Round display -> TFT_Clock.

Basta selecionar o XIAO que você está usando e o número da porta onde o XIAO está conectado, compilar e enviar.

Certifique-se de que o interruptor da Round Display esteja na posição ON.

Se o programa rodar sem problemas, você verá o seguinte efeito.

Demo 3: Teste de Hardware​

cuidado

Consulte o Demo1, crie um novo arquivo driver.h no mesmo diretório do arquivo .ino e mantenha o seguinte código nele: #define BOARD_SCREEN_COMBO 501

Como o demo HardwareTest é um pouco complexo e ocupa uma quantidade maior de memória, alguns modelos XIAO podem falhar na execução devido à memória insuficiente. Criamos uma tabela de testes para sua referência, usando a biblioteca TFT e a 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 exemplo pode ser usado para verificar se o relógio RTC, o cartão SD e as funções de toque da Round Display estão funcionando corretamente.

dica

Precisamos usar a função RTC na Round Display, então você também precisa buscar e instalar a biblioteca I2C BM8563 RTC.

Você pode encontrar este programa de exemplo na IDE Arduino em File -> Examples -> Seeed Arduino Round display -> HardwareTest.

Basta selecionar o XIAO que você está usando e o número da porta onde o XIAO está conectado, compilar e enviar.

Certifique-se de que o interruptor da Round Display esteja na posição ON.

Se o programa rodar sem problemas, você verá o seguinte efeito.

nota

Este programa de exemplo irá testar todos os itens funcionais da placa de expansão, incluindo a função RTC. Se você não tiver a biblioteca I2C BM8563 RTC instalada, poderá ocorrer um erro; você pode comentar a função lv_hardware_test(), então a detecção funcional do cartão SD também será desativada.

Atualização do Firmware de Calibração​

dica

Se você perceber que o toque às vezes não responde, pode seguir os passos abaixo para atualizar o firmware de calibração da tela.

  1. Baixe os códigos neste link
  1. Coloque-os no mesmo diretório e execute este firmware.
  1. Abra o monitor serial e você verá uma mensagem de sucesso como na imagem abaixo, o que significa que a atualização foi bem-sucedida e você pode enviar o seu programa para testá-lo!

Solução de problemas​

P1: Por que o display não mostra nada depois que eu envio o programa?​

R: Verifique se o interruptor da Round Display está ligado. Se você estiver usando o XIAO ESP32C3, talvez também seja necessário pressionar Reset após enviar o programa para que funcione.

P2: Se eu quiser conectar o Seeed Studio XIAO ESP32S3 Sense a esta tela de expansão, haverá conflito com dois slots de cartão TF?​

R: Isso não cria conflito. Os diferentes slots de cartão SD são controlados via chip select; se você quiser usar o slot de cartão microSD no Sense, o pino de chip select deve ser 21; se quiser usar o slot de cartão microSD na Round Display, o pino de chip select deve ser D2.

Temos exemplos de uso simultâneo de hardware e cartões microSD no tutorial da câmera S3 Sense.

P3: Por que meu XIAO RP2040 apresenta um erro C++ muito estranho ao usar o código de HardwareTest com o Round Display?​

R: Isso pode ser causado por você não ter selecionado a opção de compilação apropriada para o XIAO RP2040. Consulte o diagrama abaixo para configurar e reenviar o programa.

Recursos​

Suporte Técnico e Discussão de Produto​

Obrigado por escolher nossos produtos! Estamos aqui para oferecer diferentes tipos de suporte para garantir que sua experiência com nossos produtos seja a mais tranquila possível. Oferecemos vários canais de comunicação para atender a diferentes preferências e necessidades.

Loading Comments...