Lendo o monitor serial em um Arduino
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
Para ler o que você digita no monitor serial, verifique Serial.available() para saber se algo chegou, e depois chame Serial.read() para pegar um caractere. if (Serial.available() > 0) { char c = Serial.read(); } é o padrão completo, e ele permite que um sketch receba comandos do seu teclado enquanto continua com todo o resto.
O circuito acima é um Uno com um LED no pino 13, esperando três comandos. Aperte Rodar, clique na caixa abaixo do monitor serial, digite o e aperte Enter. Ele responde "ok: on" e a lâmpada acende. Digite b para "ok: blink", f para "ok: off", e qualquer outra coisa para "unknown command: x", com sua letra no lugar do x.
Below is what Serial.read() really hands you, reading a whole line, reading a number, and the one bug everyone meets with parseInt(): the extra 0 that turns up a second after the number you typed.
Quer a versão passo a passo? A aula "Recebendo comandos" percorre isso com checkpoints.
Abrir a aulaavailable() e read()
Serial.available() retorna quantos caracteres chegaram e estão esperando. Ele não espera nada. Serial.read() pega o mais antigo e o retorna, ou -1 se não houver nada lá; sem nada digitado, nosso sketch imprimiu -1 e um available() de 0. Nenhuma das chamadas espera, então o piscar no sketch acima continua rodando enquanto ele escuta.
Digite "hi" e aperte Enter, e imprima cada caractere como número em vez de letra, e a placa imprimiu 104 105 10. Esses são os códigos de h e i, e depois um 10, que é a quebra de linha. O monitor serial da IDE do Arduino tem um menu Line ending que decide o que ele envia depois do seu texto; o monitor do Mokxi sempre envia uma quebra de linha, igual à opção New Line da IDE. É por isso que o sketch acima ignora '\n' e '\r' em vez de responder "unknown command".
while (Serial.available() > 0) {
int c = Serial.read();
if (c == '\n' || c == '\r') continue;
if (c == 'o') {
mode = ON;
Serial.println("ok: on");
} else if (c == 'f') {
mode = OFF;
Serial.println("ok: off");
} else if (c == 'b') {
mode = BLINK;
Serial.println("ok: blink");
} else {
Serial.print("unknown command: ");
Serial.println((char)c);
}
}Ler uma linha inteira
Para comandos com mais de uma letra, leia até a quebra de linha com Serial.readStringUntil('\n'). Ele junta os caracteres em uma String até encontrar uma quebra de linha, remove a quebra de linha e devolve o resto. Ao digitar "hello", o sketch abaixo imprimiu "[hello] 5": cinco letras, sem quebra de linha no fim.
Se nada chegar, readStringUntil() espera até um segundo pelo próximo caractere, depois desiste e retorna o que tem. Chame-o só quando available() disser que há algo lá, como abaixo, e a espera nunca passa do tempo que uma linha leva para chegar.
Com a linha em uma String, o resto é código comum. if (line == "on") a compara, line.startsWith("speed ") verifica como ela começa, e line.substring(6).toInt() transforma o resto em número, então um comando como speed 120 não precisa de mais que três linhas para ser lido.
If your sketch compares a line with == and it never matches on a real board, check the IDE’s Line ending menu. With Both NL & CR it sends a carriage return before the newline, and that carriage return stays on the end of the line. We sent "on" that way: the line was 3 characters long and line == "on" was false. After line.trim(); it was 2 characters and true. Mokxi’s monitor sends no carriage return, so this one only shows up on the bench, which is a good reason to call trim() anyway.
void setup() {
Serial.begin(9600);
}
void loop() {
if (Serial.available() > 0) {
String line = Serial.readStringUntil('\n');
Serial.print("[");
Serial.print(line);
Serial.print("] ");
Serial.println(line.length());
}
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Read a number, and the 0 a second later
Serial.parseInt() pula tudo que não é dígito, lê um número inteiro e o retorna como long. É o jeito mais rápido de digitar um número, e tem uma armadilha. Rode o sketch abaixo, digite 42 e aperte Enter. Ele imprimiu "got 42 at 502", e depois, um segundo mais tarde, "got 0 at 1502", um número que você nunca digitou.
Here is why. parseInt() stops at the first character that is not a digit and leaves it waiting, so the newline is still there. Next time round, available() is 1, so parseInt() runs again, skips the newline, finds nothing more, waits its one-second timeout and returns 0. Call Serial.setTimeout(50); in setup() and the 0 arrives sooner, at 552 ms, but it still arrives.
A correção é ler a linha primeiro e transformá-la em número depois. Com String line = Serial.readStringUntil('\n'); int n = line.toInt(); o mesmo 42 imprimiu "got 42 at 502" e nada mais. parseInt() ainda é útil para dois números em uma linha. Ao digitar "12 30", duas chamadas em sequência imprimiram "42 at 505", a soma, e depois "0 at 2505": a quebra de linha que sobrou iniciou outra rodada, e as duas chamadas dela esperaram seu segundo inteiro.
void setup() {
Serial.begin(9600);
}
void loop() {
if (Serial.available() > 0) {
int n = Serial.parseInt();
Serial.print("got ");
Serial.print(n);
Serial.print(" at ");
Serial.println(millis());
}
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Abra este circuito no editor. Arduino Uno: comandos do monitor serial, ligado conforme roda no topo desta página. Troque um componente ou um valor e rode de novo.
Perguntas
Por que Serial.parseInt() retorna 0?
Porque a quebra de linha enviada depois do seu número ainda está esperando. O próximo parseInt() a pula, não encontra dígitos, espera o timeout de um segundo e retorna 0. Em vez disso, leia a linha com readStringUntil('\n') e converta com toInt().
O que Serial.read() retorna quando nada foi enviado?
-1. Verifique Serial.available() primeiro, e só chame read() quando ele for maior que 0.
Por que a minha entrada tem um caractere extra no final?
O monitor serial envia um final de linha depois do seu texto: uma quebra de linha, um retorno de carro ou ambos, dependendo da configuração Final de linha dele. readStringUntil('\n') remove a quebra de linha, mas mantém um retorno de carro. Chame trim() na String para removê-lo.
O Serial.read() espera por entrada?
Não. Ele retorna imediatamente, com o próximo caractere ou -1. readString(), readStringUntil() e parseInt() esperam, por até o timeout definido por Serial.setTimeout(), que é 1000 ms se você não mudar.
Posso testar entrada serial sem uma placa?
Sim. O monitor serial do Mokxi envia o que você digita para a placa simulada, seguido de uma quebra de linha, então todo sketch desta página roda no navegador como rodaria em um Uno.
Como leio uma string da serial para um vetor de char?
`int n = Serial.readBytesUntil('\n', buf, sizeof(buf) - 1);` copies everything up to the newline into buf and returns how many characters it copied. It does not end the text with a zero, so write `buf[n] = 0;` next. Typed hello, the sketch printed "got 5 bytes: hello".
Continuar
De onde vêm as informações desta página
Monte isto de verdade
Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.