LCD I2C de Arduino no funciona: encuentra la causa según lo que ves
Intermedio
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
Un LCD 16x2 con un módulo I2C necesita cuatro cables y unas cuantas líneas de código, y aun así falla más que cualquier otro componente de un kit inicial. La buena noticia es que lo que muestra la pantalla acota la causa rápidamente. Esta página está organizada por síntoma, con lo que significa cada uno y cómo arreglarlo.
El circuito de arriba funciona: un Arduino Uno con el LCD en la dirección 0x27 en A4 y A5, mostrando una temperatura. Ábrelo en el editor y podrás provocar a propósito cada una de las fallas de abajo. Para armar el circuito desde cero, el tutorial del LCD I2C cubre en orden el cableado y la biblioteca.
Primero, averigua si el LCD responde
Antes de cambiar cualquier otra cosa, ejecuta un escáner I2C. Pregunta a cada dirección del 1 al 126 si hay un dispositivo ahí y muestra las que responden. Si no encuentra nada, el problema es el cableado o la alimentación, y no servirá de nada trabajar en el código de la pantalla. Si encuentra una dirección, pon esa dirección en tu sketch.
En el circuito del termómetro, el programa i2cscan del Uno imprimió "found 0x27" y tardó 51 milisegundos en todo el bus. Luego cambiamos la propiedad de dirección de la pantalla a 0x3F, la otra dirección común, e imprimió "found 0x3F". Los módulos basados en el chip PCF8574 suelen responder en 0x27 y los que llevan el PCF8574A en 0x3F, pero unos puentes de soldadura pueden mover cualquiera de los dos, así que confía en el escaneo y no en la ficha técnica.
El escáner funciona porque Wire.endTransmission() informa si la dirección fue reconocida (acknowledge). En este circuito devolvió 0 para 0x27 y 2, "no acknowledge", para 0x3F. Puedes usar la misma comprobación en tu propio setup() para imprimir un mensaje claro en lugar de una pantalla en blanco.
#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 en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
El escáner no encuentra nada
Revisa los cuatro cables. En un Uno, SDA es A4 y SCL es A5. Los pines marcados SDA y SCL junto a AREF en las placas más nuevas son las mismas dos señales, y en nuestra prueba la pantalla funcionó igual desde cualquiera de los dos pares. Intercambiar SDA y SCL es el error más común: los intercambiamos en el circuito del termómetro y el escáner reportó "0 device(s)" con ambas líneas en reposo en HIGH. No se daña nada; vuelve a intercambiarlos.
Otras placas usan otros pines. En Mokxi, Wire.begin() usa A4 y A5 en el Uno y el Nano, 20 y 21 en el Mega, GPIO 8 y 9 en el ESP32-C3, y GP4 y GP5 en el Pico, los mismos pines que usa el núcleo Arduino de cada placa. Después revisa la alimentación: VCC a 5 V y GND a GND. La mayoría de estas pantallas son componentes de 5 voltios y se ven tenues o en blanco con 3.3 voltios, lo cual es una trampa real en las placas ESP32 y Pico.
La retroiluminación está encendida, pero no hay texto
Este es el clásico. Primero gira con un desarmador el pequeño trimmer azul de la parte trasera del módulo. En un extremo de su recorrido los caracteres desaparecen, y en el otro cada celda es un bloque sólido. En algún punto intermedio aparece el texto. Una pantalla recién salida de la bolsa suele estar ajustada demasiado hacia un lado. En Mokxi el trimmer es la propiedad de contraste de la pantalla; por debajo de 0.1 nuestra prueba no mostró nada, y cualquier valor por encima mostró el texto.
Si el contraste está bien y el escáner encontró la pantalla, comprueba que la dirección del constructor coincida. Ejecutamos el sketch que funcionaba con la dirección cambiada a 0x3F: la pantalla quedó vacía, porque el sketch le hablaba a un dispositivo que no está ahí. El código compila y corre sin quejarse en ambos casos, y por eso esta falla confunde tanto.
Una fila de bloques sólidos en la línea de arriba
Bloques solo en la primera fila significan que la pantalla tiene alimentación y el contraste está alto, pero el controlador nunca se configuró. Enciende en modo de una línea, que muestra la fila superior de celdas como rectángulos oscuros. El sketch no llamó a lcd.init() (o lcd.begin(), según la biblioteca), o sus comandos nunca llegaron por la dirección o el cableado.
Este es un síntoma que Mokxi no dibuja. Su módulo arranca con todas las salidas en bajo, así que una pantalla que nunca se inicializó simplemente queda oscura con la retroiluminación apagada. En un módulo real la retroiluminación suele encenderse al alimentar y aparecen los bloques. Las causas y las soluciones son las mismas.
El retroiluminado está apagado
El retroiluminado es un bit del puerto del módulo, así que solo se enciende cuando el sketch lo activa. Llama a lcd.backlight() después de lcd.init(). Un sketch que llama a noBacklight(), o que nunca lo activa en una biblioteca que lo requiere, da una pantalla ilegible aunque todo lo demás funcione. En nuestra prueba, noBacklight() dejó la pantalla simulada en blanco. El init() de Mokxi te enciende el retroiluminado; algunas bibliotecas reales no lo hacen, así que mantén la llamada de todos modos. Muchos módulos también tienen un jumper de dos pines para el retroiluminado, y debe estar colocado.
Caracteres incorrectos o sobrantes
Imprimir un número más corto sobre uno más largo deja los dígitos viejos atrás. Imprimimos 100 y luego 99 en el mismo lugar, y la pantalla mostró "990". Imprime unos espacios después del valor, o imprímelo con un ancho fijo, en lugar de llamar a clear() en cada ciclo, lo cual deja la pantalla en blanco un momento y hace que parpadee.
El texto que pasa de la columna dieciséis no salta a la segunda línea. Cada línea en la memoria del controlador mide cuarenta caracteres y la pantalla muestra una ventana de dieciséis caracteres sobre ella. Imprimimos veinte letras y la pantalla encendió exactamente los mismos píxeles que para las primeras dieciséis; las últimas cuatro fueron a una memoria que nadie puede ver. Usa setCursor(0, 1) para pasar a la segunda línea.
Basura por toda la pantalla en hardware real suele significar que la biblioteca no corresponde al módulo. Varias bibliotecas comparten el nombre LiquidCrystal_I2C, y los ejemplos antiguos pasan al constructor un mapa de pines que las versiones nuevas no aceptan. Si la dirección es correcta y el texto sigue mal, la clase hd44780_I2Cexp de la biblioteca hd44780 detecta tanto la dirección como el mapeo de pines, y su sketch I2CexpDiag prueba toda la conexión e informa lo que encuentra.
#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 en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
Abre este circuito en el editor. Arduino Uno: un LCD I2C que sí funciona, cableado como se ejecuta al inicio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.
Abrir el circuitoPreguntas
¿Por qué mi LCD I2C muestra solo bloques?
Bloques en la fila de arriba significan que tiene alimentación y contraste pero nunca se inicializó. Comprueba que se llame a lcd.init() o lcd.begin(), que la dirección coincida con lo que encuentra un escáner I2C, y que SDA y SCL no estén intercambiados.
¿Cuál es la dirección de mi LCD I2C?
Normalmente 0x27 para un módulo con PCF8574 o 0x3F para uno con PCF8574A, pero unos jumpers pueden cambiarla. Ejecuta un sketch de escaneo I2C y usa la dirección que imprima.
¿Por qué mi LCD I2C está iluminado pero en blanco?
La mayoría de las veces hay que girar el trimmer de contraste del módulo. Después, compara la dirección del sketch con el resultado del escáner.
¿Qué pines usa un LCD I2C en un Arduino Uno?
A4 para SDA y A5 para SCL, más 5 V y GND. Los pines SDA y SCL junto a AREF en las placas Uno más nuevas son las mismas dos señales.
Sigue así
Ármalo en la vida real
Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.