Serial.print() e println() no Arduino, linha por linha
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
Serial.print(x) envia x para o monitor serial e permanece na mesma linha. Serial.println(x) faz o mesmo e depois encerra a linha, então a próxima coisa impressa começa em uma nova. Chame Serial.begin(9600) uma vez em setup() primeiro, e configure o monitor serial na mesma velocidade.
O circuito acima é um Uno sozinho, conversando com o monitor serial. Aperte Rodar. Ele imprime "Mokxi Arduino Uno: serial example", depois "pi to five places is 3.14159", depois "up 1000 ms", "up 2000 ms" e assim por diante, uma vez por segundo. Digite uma letra na caixa abaixo do monitor e aperte Enter: um A volta como "you typed: A (0x41)", e o Enter como "you typed: <newline>".
Abaixo está como print e println diferem byte a byte, como escolher casas decimais e bases numéricas, o jeito errado de imprimir texto e um número juntos, e o que a impressão custa em tempo, cada um rodando em um Uno com o que ele imprimiu.
Quer a versão passo a passo? A aula "Fazendo a placa falar" percorre isso com checkpoints.
Abrir a aulaO sketch
Aqui está o setup() do sketch que roda acima. Serial.begin(115200) abre a porta a 115200 baud. print() escreve "pi to five places is " e deixa a linha aberta, e println(3.14159265, 5) acrescenta o número com cinco casas decimais e encerra a linha.
Imprima antes de Serial.begin() e nada sai. Imprimimos "before begin" primeiro e "after begin" segundo, e só "after begin" chegou.
void setup() {
Serial.begin(115200);
Serial.println("Mokxi Arduino Uno: serial example");
Serial.print("pi to five places is ");
Serial.println(3.14159265, 5);
}print contra println
Três prints e um println, print("a"), print("b"), println("c"), imprimiram "abc" em uma linha, e o próximo println começou uma nova. O fim de linha que println acrescenta tem dois bytes, um retorno de carro e uma quebra de linha, \r\n. O monitor serial os esconde; um programa lendo a porta, ou outra placa, vê os dois.
Serial.println() com nada entre os parênteses só encerra a linha, o que é útil depois de uma sequência de prints.
void setup() {
Serial.begin(9600);
Serial.print("a");
Serial.print("b");
Serial.println("c");
Serial.println("next line");
}
void loop() {
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Casas decimais, HEX e BIN
Um float é impresso com duas casas decimais, a menos que você indique outra coisa. Serial.println(3.14159) imprimiu 3.14. Passe o número de casas em segundo lugar: println(3.14159, 4) imprimiu 3.1416, arredondado, e println(2.0 / 3, 3) imprimiu 0.667. Com 0 casas ele arredonda para um número inteiro, metades para cima: 1.5 imprimiu 2 e 2.5 imprimiu 3.
Para um número inteiro, o segundo valor é a base. println(255, HEX) imprimiu FF e println(5, BIN) imprimiu 101, sem zeros à esquerda, então preencha você mesmo se quiser todos os oito bits. Um número negativo em HEX mostra os quatro bytes de um long: -1 imprimiu FFFFFFFF.
void setup() {
Serial.begin(9600);
Serial.println(3.14159);
Serial.println(3.14159, 4);
Serial.println(2.0 / 3, 3);
Serial.println(1.5, 0);
Serial.println(2.5, 0);
Serial.println(255, HEX);
Serial.println(5, BIN);
Serial.println(-1, HEX);
}
void loop() {
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Números, letras e write()
print() decide como mostrar algo pelo seu tipo. println(65) imprimiu 65, println('A') imprimiu A, e um bool imprimiu 1. Serial.write(65) é diferente: ele envia o próprio byte, e o monitor mostra o caractere com esse código, um A. Use print() para pessoas e write() para enviar bytes brutos a outro dispositivo.
print() também retorna quantos caracteres ele enviou. int n = Serial.print("hello"); deu 5.
Texto e um número na mesma linha
O jeito rápido que não funciona: Serial.println("Temp: " + t); com t em 21 imprimiu alguns símbolos soltos. Somar um número a um texto entre aspas avança ao longo do texto em vez de juntar, e 21 letras adiante é além do fim de "Temp: ". O Clang avisou: adding 'int' to a string does not append to the string. O jeito simples são duas chamadas, Serial.print("Temp: "); e depois Serial.println(t);, e "Temp: " + String(t) também funciona; ambos imprimiram "Temp: 21".
Quem conhece C recorre a sprintf(). Funciona para números inteiros: "%02d:%02d" com 7 e 5 imprimiu 07:05. Em um Uno ele não lida com floats: %f imprimiu "t=?", porque o printf pequeno do Uno deixa floats de fora. Use dtostrf(t, 6, 2, buf), que imprimiu " 21.50", ou imprima o float sozinho. E %d é um int: dado um long de 100000 ele imprimiu -31072, com um aviso; use %ld para um long.
void setup() {
Serial.begin(9600);
char buf[40];
float t = 21.5;
sprintf(buf, "t=%f", t);
Serial.println(buf);
dtostrf(t, 6, 2, buf);
Serial.println(buf);
sprintf(buf, "%02d:%02d", 7, 5);
Serial.println(buf);
long big = 100000;
sprintf(buf, "%d", big);
Serial.println(buf);
sprintf(buf, "%ld", big);
Serial.println(buf);
}
void loop() {
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
O que a impressão custa, e F()
Imprimir leva tempo, definido pela taxa de baud. A 9600 baud, um caractere leva cerca de um milissegundo para ser enviado. O Uno mantém uma fila de 64 bytes, então uma linha curta entra na fila e o sketch segue em frente, mas uma longa espera por espaço. Uma linha de 100 caracteres levou 38504 microssegundos para imprimir a 9600 baud, e 3168 a 115200. Um sketch que imprime muito a 9600 passa a maior parte do tempo imprimindo; use 115200, a menos que outra coisa defina a velocidade.
Em um Uno, cada trecho de texto entre aspas em um sketch também é copiado para os seus 2048 bytes de RAM quando ele inicia. Envolva textos fixos em F(), como em Serial.println(F("from flash"));, e ele será lido da flash, onde há muito mais espaço. Imprimiu "from flash" exatamente como antes. Para um sketch com muitas mensagens, essa é a RAM mais fácil de recuperar.
Se o monitor mostrar símbolos sem sentido em vez de palavras, a velocidade dele não corresponde à de Serial.begin(). A página sobre lixo no monitor serial traz isso e as outras causas.
Abra este circuito no editor. Arduino Uno: imprimindo no monitor serial, ligado como roda no topo desta página. Mude um componente ou um valor e rode de novo.
Perguntas
Qual é a diferença entre Serial.print e Serial.println?
print() envia o texto e permanece na mesma linha. println() o envia e depois um retorno de carro e uma quebra de linha, então o que vier depois começa em uma nova linha.
Como imprimo um float com mais casas decimais?
Passe o número de casas depois do valor: Serial.println(3.14159, 4) imprime 3.1416. Sem isso, um float é impresso com duas casas.
Como imprimo texto e uma variável na mesma linha?
Use duas chamadas: Serial.print("Temp: "); e depois Serial.println(t);. Ou junte como Strings, "Temp: " + String(t). Escrever "Temp: " + t sem String() imprime parte do texto ou lixo.
Por que o sprintf imprime um ponto de interrogação para um float no Arduino?
O printf do Uno é compilado sem suporte a float, então %f imprime ?. Converta o float com dtostrf() primeiro, ou imprima com Serial.print(t, 2).
Por que meu monitor serial não mostra nada?
Verifique se Serial.begin() roda antes do primeiro print e se o monitor está configurado na mesma taxa de baud. Qualquer coisa impressa antes de Serial.begin() é perdida.
Como imprimo um número em HEX com um zero à esquerda?
`Serial.println(10, HEX)` imprimiu "A" e `Serial.println(255, HEX)` imprimiu "FF": print() omite os zeros à esquerda. Para um byte, imprima o zero você mesmo quando ele for menor que 0x10. `if (b < 0x10) Serial.print("0");` antes de `Serial.println(b, HEX);` imprimiu "0A".
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.