O editor

O plotter serial

Faça um gráfico dos números que seu sketch imprime, na aba Plot ao lado de Serial.

O que ele não consegue ver: só o que o sketch imprime. O eixo x é o tempo simulado do quadro em que uma linha chegou, então duas linhas impressas no mesmo quadro compartilham um carimbo de tempo; nada é interpolado, suavizado ou filtrado; e uma linha que a regra atual não consegue ler fica na aba Serial em vez de virar um ponto. Essa linha é a primeira coisa do painel, acima do gráfico, e ela não rola para fora da tela.

Imprimindo algo para plotar

Qualquer coisa que uma placa com monitor serial imprimir. Um número sozinho é uma curva:

Serial.println(analogRead(A0));

Vários números em uma linha são várias curvas, separados por espaço, vírgula ou tabulação:

Serial.print(reading);
Serial.print(',');
Serial.println(target);

E um par label:value dá nome à curva dele, que é o que coloca uma palavra na legenda em vez de #1:

Serial.print("temp:");
Serial.print(celsius);
Serial.print(" humidity:");
Serial.println(humidity);

Esse é o formato do plotter do Arduino IDE, de propósito: um sketch escrito para o Serial Plotter do IDE plota aqui sem mudar uma linha, e um sketch escrito aqui plota lá.

As duas regras, e por que são duas

O botão no cabeçalho do painel alterna entre elas.

Números em qualquer lugar é o padrão. Todo número em uma linha vira um ponto e toda palavra é ignorada, então um sketch escrito antes de alguém pensar em plotar plota como está. A estação meteorológica imprime

reading 3: 23.4 C, 48 %RH

e duas curvas aparecem, 23.4 e 48. O custo é honesto e vale a pena conhecer: uma mensagem com número dentro (DHT22 no pino 2) também é um ponto, e ela cai na primeira curva. Aperte Limpar depois da mensagem, ou troque de regra.

Somente a linha inteira é a regra do Arduino IDE: a linha plota só se todo token dela for um número ou um label:value. Nada espúrio nunca entra, e um sketch que mistura prosa com os números não plota nada. A linha de status embaixo do gráfico diz quantas linhas ficaram na Serial, então um gráfico vazio sempre tem um motivo na tela.

De qualquer forma, 0x1f não é 31 e um token vazio não é zero: um número tem que parecer um (12, -0.5, +3, .25, 1e-3) ou não é um.

Lendo o gráfico

O eixo y é autoajustado conforme as curvas que estão ligadas e a janela visível, com um décimo da variação sobrando acima e abaixo, arredondado para um passo de 1-2-5, de modo que as linhas da grade fiquem em números fáceis de ler. Uma linha reta ganha uma caixa em volta em vez de ser desenhada como uma curva de ruído.

O seletor de janela escolhe quanto tempo aparece na tela, de um segundo a cinco minutos. Os pontos antigos são guardados, não jogados fora: amplie a janela e eles estão lá de novo, e o CSV tem todos eles.

A legenda é um botão por curva. Clique em um para tirar aquela curva do gráfico, o que também a tira da escala, então uma curva que varia de 0 a 1023 não achata as quatro ao lado. O número em cada tecla é o valor mais recente daquela curva.

Pausar para de adicionar pontos. A placa continua rodando e imprimindo, e a aba Serial continua enchendo: é uma pausa no gráfico, não no circuito, e a linha de status avisa isso enquanto estiver pausado.

O CSV entrega todos os pontos num arquivo: uma linha por instante, uma coluna por curva. Uma curva que não imprimiu nada naquele instante ganha uma célula vazia em vez de um zero, porque "não disse nada" e "disse zero" são coisas diferentes.

O que contém

Doze curvas e vinte mil pontos cada, os mais antigos descartados primeiro. Um sketch que imprime um rótulo novo a cada linha é um bug, não um dado, então o décimo terceiro nome é recusado e a linha de status avisa.

Um gráfico pertence a uma execução. Apertar Rodar de novo começa um gráfico vazio, porque uma curva que atravessasse um reinício seriam dois circuitos diferentes desenhados como um só.

Um exemplo para abrir

A Estação meteorológica imprime uma temperatura e uma umidade a cada dois segundos e meio, numa linha com palavras: a regra padrão plota as duas, e a falha da primeira leitura é um espaço vazio, não um zero.

Veja também