LCD I2C do Arduino não funciona: descubra a causa pelo que você vê
Intermediário
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
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.
#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.
#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 circuitoPerguntas
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.
Continuar
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.