Aprender

LCD I2C do Arduino não funciona: descubra a causa pelo que você vê

Intermediário

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: um LCD I2C que funcionaao vivo0.000 s 0.00x
Clique para abrir no editor
Um LCD 16x2 no endereço 0x27, em A4 e A5, mostrando uma temperatura. Abra e mude o endereço ou o contraste para estragá-lo.

Um LCD 16x2 com um módulo I2C precisa de quatro fios e poucas linhas de código, e ainda assim falha mais do que qualquer outro componente de um kit inicial. A boa notícia é que o que aparece na tela reduz rapidamente as causas. Esta página está organizada por sintoma, com o que cada um significa e como consertar.

O circuito acima é um que funciona: um Arduino Uno com o LCD no endereço 0x27, em A4 e A5, mostrando uma temperatura. Abra no editor e você poderá provocar de propósito cada defeito abaixo. Para montar o circuito do zero, o tutorial de LCD I2C cobre a ligação e a biblioteca na ordem.

Primeiro, descubra se o LCD responde

Antes de mudar qualquer outra coisa, rode um scanner I2C. Ele pergunta a cada endereço, de 1 a 126, se há um dispositivo ali e imprime os que respondem. Se não encontrar nada, o problema é ligação ou alimentação, e nenhum trabalho no código do display vai ajudar. Se encontrar um endereço, coloque esse endereço no seu sketch.

No circuito do termômetro, o programa i2cscan do Uno imprimiu "found 0x27" e levou 51 milissegundos para o barramento inteiro. Depois mudamos a propriedade de endereço do display para 0x3F, o outro endereço comum, e ele imprimiu "found 0x3F". Módulos com o chip PCF8574 normalmente respondem em 0x27 e os com PCF8574A em 0x3F, mas jumpers de solda podem mudar qualquer um dos dois, então confie no scan, não na lista.

O scanner funciona porque Wire.endTransmission() informa se o endereço foi reconhecido. Neste circuito, ele retornou 0 para 0x27 e 2, "no acknowledge", para 0x3F. Você pode usar a mesma verificação no seu setup() para imprimir uma mensagem clara em vez de uma tela vazia.

Confira o endereço antes de usar
#include <Wire.h>

void setup() {
  Serial.begin(9600);
  Wire.begin();
  Wire.beginTransmission(0x27);
  byte status = Wire.endTransmission();
  if (status == 0) {
    Serial.println("LCD found at 0x27");
  } else {
    Serial.println("Nothing at 0x27: run a scanner");
  }
}

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 scanner não encontra nada

Verifique os quatro fios. No Uno, SDA é A4 e SCL é A5. Os pinos rotulados SDA e SCL perto do AREF em placas mais novas são os mesmos dois sinais, e no nosso teste o display funcionou igual em qualquer par. Trocar SDA e SCL é o erro mais comum: trocamos no circuito do termômetro e o scanner informou "0 device(s)" com as duas linhas em nível HIGH. Nada se danifica; é só trocar de volta.

Outras placas usam outros pinos. No Mokxi, Wire.begin() usa A4 e A5 no Uno e no Nano, 20 e 21 no Mega, GPIO 8 e 9 no ESP32-C3, e GP4 e GP5 no Pico, os mesmos pinos que o core do Arduino de cada placa usa. Depois confira a alimentação: VCC no 5 V e GND no GND. A maioria desses displays funciona a 5 volts e fica fraca ou vazia com 3,3 volts, uma verdadeira armadilha nas placas ESP32 e Pico.

A luz de fundo está acesa, mas não há texto

Esse é o clássico. Primeiro gire o pequeno trimmer azul na parte de trás do módulo com uma chave de fenda. Em uma extremidade do curso os caracteres somem, e na outra cada célula vira um bloco sólido. Em algum ponto entre eles, o texto aparece. Um display recém-saído do saquinho costuma estar ajustado longe demais para um lado. No Mokxi, o trimmer é a propriedade de contraste do display; abaixo de 0,1 o nosso teste não mostrou nada, e qualquer valor acima mostrou o texto.

Se o contraste está certo e o scanner encontrou o display, confira se o endereço no construtor corresponde. Rodamos o sketch funcional com o endereço mudado para 0x3F: a tela ficou vazia, porque o sketch estava falando com um dispositivo que não existe. O código compila e roda normalmente nos dois casos, e por isso esse erro confunde tanto.

Uma fileira de blocos sólidos na linha de cima

Blocos só na primeira linha significam que o display tem alimentação e o contraste está alto, mas o controlador nunca foi configurado. Ele liga em modo de uma linha, que mostra a fileira de cima como retângulos escuros. O sketch não chamou lcd.init() (ou lcd.begin(), dependendo da biblioteca), ou os comandos nunca chegaram por causa do endereço ou da ligação.

Este é um sintoma que o Mokxi não desenha. O módulo começa com todas as saídas em nível baixo, então um display nunca inicializado fica simplesmente escuro com a luz de fundo apagada. Num módulo real a luz de fundo normalmente acende na alimentação e os blocos aparecem. As causas e as soluções são as mesmas.

A luz de fundo está apagada

A luz de fundo é um bit na porta do módulo, então só acende quando o sketch a ativa. Chame lcd.backlight() depois de lcd.init(). Um sketch que chama noBacklight(), ou nunca a ativa numa biblioteca que exige isso, resulta num display ilegível mesmo com todo o resto funcionando. No nosso teste, noBacklight() deixou o display simulado em branco. O init() do Mokxi acende a luz de fundo para você; algumas bibliotecas reais não fazem isso, então mantenha a chamada mesmo assim. Muitos módulos também têm um jumper de dois pinos para a luz de fundo, e ele precisa estar instalado.

Caracteres errados ou que sobraram

Imprimir um número mais curto sobre um mais longo deixa os dígitos antigos para trás. Imprimimos 100 e depois 99 no mesmo lugar, e o display mostrou "990". Imprima alguns espaços depois do valor, ou imprima com largura fixa, em vez de chamar clear() a cada loop, o que apaga a tela por um instante e causa cintilação.

Texto depois da décima sexta coluna não passa para a segunda linha. Cada linha na memória do controlador tem quarenta caracteres, e o display mostra uma janela de dezesseis sobre ela. Imprimimos vinte letras e o display acendeu exatamente os mesmos pixels das primeiras dezesseis; as últimas quatro foram para uma memória que ninguém vê. Use setCursor(0, 1) para ir para a segunda linha.

Lixo pela tela toda em hardware real normalmente significa que a biblioteca não corresponde ao módulo. Várias bibliotecas compartilham o nome LiquidCrystal_I2C, e exemplos antigos passam um mapa de pinos ao construtor que as mais novas não aceitam. Se o endereço está certo e o texto continua errado, a classe hd44780_I2Cexp da biblioteca hd44780 detecta o endereço e o mapeamento de pinos, e o sketch I2CexpDiag testa a conexão inteira e relata o que encontra.

Sobrescreva um valor sem sobras nem cintilação
#include <Wire.h>
#include <LiquidCrystal_I2C.h>

LiquidCrystal_I2C lcd(0x27, 16, 2);

void setup() {
  lcd.init();
  lcd.backlight();
  lcd.print("Count:");
}

void loop() {
  int value = analogRead(A0);
  lcd.setCursor(7, 0);
  lcd.print(value);
  lcd.print("    ");  // wipes digits left from a longer number
  delay(200);
}

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: um LCD I2C que funciona, ligado como roda no topo desta página. Mude um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Por que meu LCD I2C mostra só blocos?

Blocos na fileira de cima significam que ele tem alimentação e contraste, mas nunca foi inicializado. Confira se lcd.init() ou lcd.begin() é chamado, se o endereço corresponde ao que um scanner I2C encontra e se SDA e SCL não estão trocados.

Qual é o endereço do meu LCD I2C?

Normalmente 0x27 para um módulo PCF8574 ou 0x3F para um PCF8574A, mas jumpers podem mudar isso. Rode um sketch de scanner I2C e use o endereço que ele imprimir.

Por que meu LCD I2C está aceso mas vazio?

Na maioria das vezes, o trimmer de contraste no módulo precisa ser girado. Depois disso, confira o endereço no sketch com o resultado do scanner.

Quais pinos um LCD I2C usa em um Arduino Uno?

A4 para SDA e A5 para SCL, mais 5 V e GND. Os pinos SDA e SCL ao lado do AREF em placas Uno mais novas são os mesmos dois sinais.

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.