Monitor série online

Como usar o monitor série

1. Liga o teu Arduino, ESP32, Raspberry Pi Pico, módulo GPS ou adaptador USB-série (FTDI, CH340, CP210x, PL2303).
2. Em Definições da porta, escolhe o Baud rate que o teu dispositivo usa. Seleciona Personalizado… para velocidades invulgares, como 74880 (o registo de arranque do ESP8266). Deixa Bits de dados, Paridade, Bits de paragem e Controlo de fluxo em 8, Nenhuma, 1 e Nenhum, a não ser que a documentação do dispositivo diga outra coisa: é a configuração comum «8N1».
3. Carrega em Escolher a porta e ligar. O navegador abre a sua própria lista de portas série; escolhe o teu dispositivo e confirma.
4. Os dados recebidos aparecem no Terminal. Alterna entre Texto e Hex, e liga ou desliga as Marcas de tempo e o Deslocamento automático quando quiseres.
5. Escreve um comando em Linha a enviar, escolhe o Fim de linha que o teu firmware espera e carrega em Enviar (ou Enter). As linhas enviadas aparecem com um > no início.
6. Carrega em Transferir o registo para guardares o conteúdo do terminal num ficheiro de texto, em Limpar para recomeçar, e em Desligar antes de retirares o cabo ou de abrires a porta noutro programa.

As definições série explicadas

Uma UART envia cada byte como um bit de início, 5 a 8 bits de dados, um bit de paridade opcional e um ou dois bits de paragem. As duas pontas têm de estar de acordo nestas definições; um Baud rate errado é a causa mais comum de caracteres sem sentido como ⸮⸮⸮ ou símbolos aleatórios. Valores típicos:

• 9600 e 115200 baud: sketches Arduino (Serial.begin(…)) e a maioria dos módulos;
• 74880: as mensagens de arranque do ESP8266, antes de o teu sketch mudar a velocidade;
• 4800 ou 9600: muitos recetores GPS (frases NMEA);
• controlo de fluxo Hardware (RTS/CTS): modems e alguns adaptadores industriais, quando os fios RTS/CTS estão ligados.

Com uma placa com USB nativo (Arduino Leonardo, Pico, ESP32-S2/S3), o «baud rate» é muitas vezes ignorado porque os dados passam diretamente por USB, mas tem de ser definido na mesma.

Vistas de texto e hexadecimal

A vista Texto descodifica os bytes como UTF-8 e divide-os em linhas em LF, CR ou CR+LF, mesmo quando um fim de linha chega partido em dois pacotes USB. Cada linha recebe a hora a que chegou o primeiro byte, ao milissegundo. A vista Hex mostra cada bloco recebido como um dump hexadecimal: deslocamento, 16 bytes por linha em hexadecimal e uma coluna com os caracteres ASCII imprimíveis. Usa-a para protocolos binários (Modbus RTU, tramas de sensores) ou para veres caracteres invisíveis como 0D 0A (CR LF) ou 00.

O terminal mostra as últimas 1500 linhas, e a ferramenta mantém em memória as últimas 5000 linhas ou blocos. Transferir o registo guarda-os na vista atual, com as marcas de tempo se estiverem ativadas.

Fins de linha

Muitos firmwares só processam um comando quando recebem um fim de linha. Os exemplos Arduino costumam ler até LF (\n), os modems de comandos AT esperam CR (\r), e as consolas ao estilo Windows usam CR+LF. Escolhe Nenhum para enviares exatamente os bytes que escreveste.