Pular para o conteúdo principal

Monitor UART

Adquira agora 🖱️

Introdução​

Bem-vindo à documentação do Monitor UART do XIAO Debug Mate.

Esta página fornece orientações claras sobre como usar o Debug Mate para monitoramento de dados seriais. Você encontrará instruções passo a passo para configuração de hardware, ferramentas de software recomendadas e explicações de conceitos relevantes para ajudar você a aproveitar ao máximo os recursos de monitoramento UART em cenários de desenvolvimento e depuração.

Conceitos a entender antes de usar o Monitor Serial​

Antes de começar, vamos esclarecer dois conceitos fundamentais que são essenciais para trabalhar com comunicação serial.

Comunicação serial​

Comunicação serial é um método de envio de dados, um bit de cada vez, sequencialmente, por um único canal de comunicação. Pense nisso como carros trafegando por uma estrada de mão única, um atrás do outro. No mundo dos microcontroladores, isso é mais comumente implementado usando um protocolo chamado UART (Universal Asynchronous Receiver-Transmitter). É a principal forma de os desenvolvedores obterem mensagens de depuração, leituras de sensores e atualizações de status de seus dispositivos.

RX/TX​

Estes são os dois pinos que fazem a comunicação serial acontecer:

  • TX (Transmit): Este é o pino de "envio". O microcontrolador usa este pino para enviar dados.
  • RX (Receive): Este é o pino de "recebimento". O microcontrolador usa este pino para escutar dados recebidos.

Lógica de Comunicação UART

A Regra de Ouro: TX (Transmit) deve ser conectado ao RX (Receive)
Dispositivo A(MCU/PC)TXTransmitRXReceiveGNDDispositivo B(Sensor)TXTransmitRXReceiveGNDFluxo de Dados (TX → RX)Fluxo de Dados (RX ← TX)Terra Comum (GND)
Laranja: A para B
Azul: B para A

A regra mais importante a lembrar é que você deve fazer a conexão cruzada desses pinos entre os dispositivos. O pino TX de um dispositivo deve ser conectado ao pino RX do outro, e vice-versa. É como uma conversa: a boca (TX) de uma pessoa fala com o ouvido (RX) da outra.

Primeiros Passos​

O XIAO Debug Mate pode monitorar dados seriais de duas maneiras: diretamente em sua tela LCD integrada ou encaminhando os dados para um computador. Este guia cobre ambas.

Preparação de software (para monitoramento no PC)​

Se você optar por visualizar os dados seriais no seu computador, vai precisar de um aplicativo de "terminal serial" ou "monitor serial". O XIAO Debug Mate aparecerá como uma porta COM padrão no seu PC. Aqui estão algumas opções de software populares:

  • PlatformIO Serial Monitor: Se você estiver usando o VS Code com PlatformIO, basta clicar no botão "Serial Monitor" na barra de status.
  • Arduino IDE Serial Monitor: O monitor clássico e simples integrado ao Arduino IDE.
  • PuTTY: Um emulador de terminal leve e muito popular para Windows.
  • CoolTerm: Um terminal serial fácil de usar e cheio de recursos para Windows, macOS e Linux.
  • minicom / screen: Poderosas ferramentas em linha de comando para usuários de Linux e macOS.

Preparação de hardware​

O XIAO Debug Mate oferece três formas flexíveis de conectar seu dispositivo alvo para monitoramento serial.

Para placas XIAO (plug-and-play)​

Este é o método mais fácil para monitorar uma placa XIAO. O Debug Mate é projetado para escutar a porta Serial1 (D6 e D7) do XIAO por padrão.

  1. Basta conectar sua placa XIAO diretamente aos headers fêmea na parte frontal do XIAO Debug Mate.
  2. A conexão é feita automaticamente. Nenhum fio extra é necessário.

Para Dispositivos Grove UART​

O conector Grove dedicado permite uma conexão limpa e segura a qualquer módulo Grove baseado em UART.

  1. Pegue seu dispositivo Grove UART (por exemplo, um Grove GPS ou Grove MP3 V4).
  2. Use um cabo Grove padrão para conectá-lo à porta Grove no lado direito do XIAO Debug Mate.

Para Outros Dispositivos UART​

Instruções de Conexão do Pino de Alimentação

Se você precisa conectar ou não os pinos de alimentação de 3,3 V das duas placas de desenvolvimento depende de se o outro dispositivo é alimentado pelo Debug Mate. Se o outro dispositivo for alimentado por sua própria conexão USB independente, você não deve conectar os pinos de 3,3 V do dispositivo e do Debug Mate. Fazer isso pode danificar o dispositivo.

Você pode monitorar qualquer dispositivo com pinos TX e RX acessíveis, como outra placa de desenvolvimento ou um circuito personalizado.

Existem duas maneiras principais de fazer isso:

  • Opção 1: Usando os Headers Principais: Conecte os pinos TX e RX do seu dispositivo aos headers fêmea do XIAO Debug Mate usando fios DuPont. Lembre-se de fazer a conexão cruzada: TX do dispositivo -> RX do Debug Mate (Pino D7 no header) e RX do dispositivo -> TX do Debug Mate (Pino D6 no header).

  • Opção 2: Usando a Porta Grove: Use um cabo de conversão Grove para DuPont. Conecte o conector Grove ao Debug Mate e conecte as pontas individuais DuPont aos pinos TX, RX, VCC e GND do seu dispositivo. Muitas vezes, esta é uma conexão mais estável e confiável.

O diagrama a seguir mostra as definições de pinos para a interface Grove.

Lembrete Crucial

Sempre certifique-se de que o pino TX do seu dispositivo esteja conectado a um pino receptor no Debug Mate, e que o pino RX do dispositivo esteja conectado a um pino transmissor.

Graças ao seu design versátil, o XIAO Debug Mate permite que você conecte até dois dispositivos UART simultaneamente: um via soquete XIAO e outro via porta Grove. Você pode então alternar entre o monitoramento de cada dispositivo usando o menu na tela.

Esse poderoso recurso elimina o doloroso processo de refazer a fiação repetidas vezes ao depurar sistemas complexos que envolvem vários dispositivos seriais.

Operando o Monitor Serial​

O XIAO Debug Mate possui uma ferramenta serial versátil que pode ser usada tanto para monitoramento no próprio dispositivo quanto baseado em PC. Este guia o conduzirá por sua navegação e funções.

Antes de explorar os recursos, é crucial entender como navegar na interface. Todas as operações são realizadas usando a roda de rolagem e o botão.

  1. Entrando no Menu: A partir da tela principal, use a roda de rolagem para realçar o ícone da Ferramenta Serial (canto inferior esquerdo). Pressione o botão para entrar no menu serial.

  2. Controles Principais:

    • Roda de Rolagem: Usada para mover um cursor ou alternar entre modos principais.
    • Pressão Curta do Botão: Usada para confirmar uma seleção ou ativar o cursor de configurações.
    • Pressão Longa do Botão: Usada para sair de um menu ou voltar.

Existem dois estados principais de interação:

  • Sem Cursor Ativo: Neste estado, girar a roda de rolagem alterna entre as funções principais (por exemplo, Modo Passthrough vs. Modo Monitor).
  • Cursor Ativo: Após uma pressão curta, um cursor aparece na parte superior da tela. Agora, a roda de rolagem move esse cursor, permitindo que você selecione uma configuração para alterar.

Guia Rápido de Navegação​

AçãoFunção
Roda de Rolagem (sem cursor)Alternar entre os modos Passthrough e Monitor.
Pressão Curta do BotãoAtivar o cursor de seleção para Fonte/Taxa de Baud.
Pressão Longa do BotãoRetornar ao menu anterior.

Os Dois Modos de Monitoramento​

Com os controles básicos compreendidos, você pode agora alternar facilmente entre os dois modos principais de operação. Basta girar a roda de rolagem (enquanto nenhum cursor estiver ativo) para alternar entre eles.

1. Modo Passthrough (para PC)​

Este é o modo padrão, projetado para encaminhar todos os dados seriais da fonte selecionada diretamente para o seu computador para visualização em um terminal serial no PC.

  • Exibição na Tela: A tela mostra informações de status, não os dados em si.
    • Canto Superior Esquerdo: A fonte serial ativa (por exemplo, XIAO).
    • Canto Superior Direito: A taxa de baud atual (por exemplo, 9600).
    • Centro: Os indicadores RX e TX (a partir da perspectiva do Debug Mate) serão animados para mostrar o fluxo de dados de e para o PC.

2. Modo Monitor (no LCD)​

Este modo captura e exibe os dados seriais diretamente na tela LCD do Debug Mate. Os dados não são encaminhados para o PC neste modo.

  • Exibição na Tela: A tela é dividida em duas janelas para exibir o tráfego de dados.
    • RX Window: Mostra os dados recebidos do soquete XIAO/Grove.
    • TX Window: Mostra os dados recebidos do PC.
cuidado

O Debug Mate não pode exibir dados de ambas as fontes simultaneamente. Você deve selecionar a fonte ativa usando o menu de configurações.

nota

Os rótulos RX e TX neste documento são sempre a partir da perspectiva do Debug Mate:

  • RX indica dados recebidos pelo Debug Mate (ou seja, sinais seriais que entram no Debug Mate).
  • TX indica dados enviados pelo Debug Mate (ou seja, sinais sendo transmitidos pelo Debug Mate).

Isso significa que dados enviados do dispositivo XIAO ou Grove para o Debug Mate aparecerão na janela RX, não importa qual porta esteja selecionada como fonte. O conteúdo mostrado na janela RX depende de qual fonte (XIAO/Grove) você escolheu nas configurações.

TX sempre se refere a dados originados do PC — quando você digita e envia mensagens a partir de um terminal serial no seu computador, elas são transmitidas via TX do Debug Mate para a fonte atualmente selecionada (XIAO ou Grove).

  • Em ambos os modos "Passthrough" e "Monitor", o PC pode enviar dados ao Debug Mate por meio de sua porta COM virtual, e o Debug Mate encaminhará essas mensagens para o dispositivo serial de destino que você selecionou.
  • O que você vê na janela TX é, portanto, sempre o que o PC está enviando através do Debug Mate, independentemente do modo de monitoramento atual.

Configurando Fonte e Taxa de Baud​

Para alterar a fonte de dados ou a taxa de baud, você deve primeiro ativar o cursor de configurações.

  1. Ativar Cursor: A partir de qualquer modo, pressione o botão uma vez. Um cursor aparecerá na parte superior da tela.
  1. Selecionar Configuração: Use o botão para mover o cursor entre a fonte (XIAO/Grove) e a taxa de baud.
dica

Após alternar as fontes, o conteúdo da nova fonte pode não aparecer imediatamente. Isso ocorre porque a impressora deve esperar os dados da fonte de entrada anterior terminarem de ser impressos antes de receber informações da ne

  1. Entrar no Menu: Para a opção de taxa de baud, com a configuração desejada realçada, pressione o botão para abrir seu menu de configuração.
  1. Alterar Valor: Use a roda de rolagem para escolher sua taxa de baud e pressione o botão para confirmar.

O Menu de Taxa de Baud e Indicador Visual​

O menu de taxa de baud permite que você selecione entre nove taxas comuns (4800 a 921600). Como um toque visual único, entrar nesse menu também ativa a matriz de 36 LEDs na parte traseira do dispositivo, com o padrão de luz mudando para refletir a taxa selecionada.

Conceitos-Chave e Limitações​

  • Um Depurador, Não uma Ponte: O Debug Mate é uma ferramenta de diagnóstico, não uma ponte de comunicação. Ele não encaminhará automaticamente dados da porta XIAO para a porta Grove.
  • Parâmetros Seriais Fixos: Parâmetros seriais básicos (8-N-1) são fixos no firmware. Usuários avançados podem modificar o código open-source para alterá-los.
  • Monitoramento de Fonte Única: Você só pode monitorar ativamente uma única fonte (XIAO ou Grove) por vez.

Agradecimentos Especiais​

Agradecimentos especiais a 啊猫啊狗晒太阳 (Ah Mao Ah Gou Shai Tai Yang) pela inspiração de design para a matriz de LEDs. O design do indicador de LED onboard do Debug Mate faz referência ao excelente projeto open-source deles. O design original é muito criativo e prático.

Se você quiser ver o design original, pode conferir o vídeo de demonstração e a página inicial do autor através dos links abaixo.

Loading Comments...