Aprender

Serial.print() e println() no Arduino, linha por linha

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: imprimindo no monitor serialao vivo0.000 s 0.00x
Clique para abrir no editor
Uma saudação, pi com cinco casas, o tempo ligado a cada segundo e um eco do que você digita.

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 aula

O 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.

firmware/uno/examples/serial (o setup() rodando acima)
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.

Uma linha a partir de quatro chamadas
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.

Casas e bases
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.

sprintf em um Uno
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".

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.