Módulo LCD I2C

Para usar este módulo, definí INCLUIR_LCD_I2C antes de incluir Cod-ES.h. La librería Wire.h se incluye automáticamente.

Activación

#define INCLUIR_LCD_I2C
#include <Cod-ES.h>

Conexión de hardware

Pin del módulo I2C	Pin en Arduino Uno
SDA	A4
SCL	A5
VCC	5V
GND	GND

La dirección I2C más común es 0x27. Si la pantalla no funciona, probá con 0x3F. Podés detectar la dirección real usando un escáner I2C.

Clase `LCD_I2C`

Cada pantalla que uses en tu proyecto requiere su propia instancia de LCD_I2C.

Constructor

constructor

Crea una instancia del display LCD I2C.Parámetros:

lcd_Addr — dirección I2C del módulo (normalmente 0x27 o 0x3F).
lcd_cols — número de columnas del display (ej: 16 para un 16x2).
lcd_rows — número de filas del display (ej: 2 para un 16x2).

LCD_I2C lcd(0x27, 16, 2); // Pantalla 16 columnas × 2 filas, dirección 0x27

Métodos de inicialización

void

Inicializa el display y lo prepara para recibir comandos. Debe ser el primer método que llames en inicio. Configura el modo de 4 bits, el número de líneas y el tamaño de los caracteres.

void

Alternativa a inicializar(). Permite especificar columnas, filas y tamaño de carácter explícitamente.Parámetros: cols — columnas; rows — filas; charsize — tamaño de fuente (LCD_5x8DOTS por defecto).

Métodos de control del display

void

Borra todo el contenido de la pantalla y mueve el cursor al origen (columna 0, fila 0).

void

Mueve el cursor al origen sin borrar el contenido de la pantalla.

void

Enciende la pantalla (muestra el contenido en memoria).

void

Apaga la pantalla sin borrar el contenido en memoria.

Métodos de iluminación

void

Enciende la luz de fondo (backlight) del display.

void

Apaga la luz de fondo del display.

Métodos del cursor

void

Posiciona el cursor en la columna y fila indicadas.Parámetros: col — columna (0 a cols - 1); row — fila (0 a rows - 1).

void

Muestra el cursor como una línea subrayada debajo del carácter actual.

void

Oculta el cursor subrayado.

void

Activa el cursor parpadeante (bloque sólido que parpadea).

void

Desactiva el cursor parpadeante.

Métodos de escritura

void

Imprime una cadena de caracteres (const char[]) en la posición actual del cursor.Parámetro: texto a mostrar entre comillas dobles.

size_t

Escribe un único carácter (byte) en la posición actual del cursor. Equivalente a write() de la clase Print.Parámetro: value — código ASCII del carácter.

void

Envía un comando directo al controlador HD44780 del LCD. Para uso avanzado.Parámetro: value — byte de comando.

Métodos de desplazamiento

void

Desplaza todo el contenido visible del display un carácter hacia la izquierda.

void

Desplaza todo el contenido visible del display un carácter hacia la derecha.

void

Activa el desplazamiento automático: cada carácter nuevo empuja el texto existente.

void

Desactiva el desplazamiento automático (comportamiento por defecto).

Métodos de dirección de texto

void

Configura la escritura de izquierda a derecha (modo por defecto).

void

Configura la escritura de derecha a izquierda.

void

Justifica el texto hacia la izquierda respecto al cursor en modo de desplazamiento automático.

void

Justifica el texto hacia la derecha respecto al cursor en modo de desplazamiento automático.

Caracteres personalizados

void

Define un carácter personalizado en la memoria CGRAM del LCD. El display HD44780 admite hasta 8 caracteres personalizados (posiciones 0–7).Parámetros: num — posición en CGRAM (0–7); rows — arreglo de 8 bytes con los bits de cada fila del carácter (5 bits por fila).

// Definir un símbolo de "corazón"
byte corazon[8] = {
  0b00000,
  0b01010,
  0b11111,
  0b11111,
  0b01110,
  0b00100,
  0b00000,
  0b00000
};

lcd.crearCaracter(0, corazon); // Guardar en posición 0
lcd.ajustarCursor(0, 0);
lcd.escribir(0);               // Mostrar el carácter personalizado

Ejemplo completo

#define INCLUIR_LCD_I2C
#include <Cod-ES.h>

LCD_I2C lcd(0x27, 16, 2); // Pantalla 16x2, dirección I2C 0x27

inicio
  lcd.inicializar();          // Iniciar el display
  lcd.encenderLuz();          // Encender retroiluminación

  lcd.ajustarCursor(0, 0);    // Cursor en columna 0, fila 0
  lcd.imprimirCadena("Hola, mundo!");

  lcd.ajustarCursor(0, 1);    // Cursor en columna 0, fila 1
  lcd.imprimirCadena("Cod-ES v1.0");
fin

bucle
fin

Ejemplo — contador en pantalla

#define INCLUIR_LCD_I2C
#include <Cod-ES.h>

LCD_I2C lcd(0x27, 16, 2);
entero contador = 0;

inicio
  lcd.inicializar();
  lcd.encenderLuz();
  lcd.ajustarCursor(0, 0);
  lcd.imprimirCadena("Contador:");
fin

bucle
  lcd.ajustarCursor(0, 1);
  lcd.imprimirCadena("               "); // Limpiar la fila 1
  lcd.ajustarCursor(0, 1);
  lcd.escribir(contador + '0');         // Mostrar el valor
  contador++;
  esperar(1, SEGUNDOS);
fin

Introducción

Referencia del Lenguaje

Módulos

Ejemplos

Módulo LCD I2C

Activación

Conexión de hardware

Clase `LCD_I2C`

Constructor

Métodos de inicialización

Métodos de control del display

Métodos de iluminación

Métodos del cursor

Métodos de escritura

Métodos de desplazamiento

Métodos de dirección de texto

Caracteres personalizados

Ejemplo completo

Ejemplo — contador en pantalla

​Activación

​Conexión de hardware

​Clase LCD_I2C

​Constructor

​Métodos de inicialización

​Métodos de control del display

​Métodos de iluminación

​Métodos del cursor

​Métodos de escritura

​Métodos de desplazamiento

​Métodos de dirección de texto

​Caracteres personalizados

​Ejemplo completo

​Ejemplo — contador en pantalla

Activación

Conexión de hardware

Clase `LCD_I2C`

Constructor

Métodos de inicialización

Métodos de control del display

Métodos de iluminación

Métodos del cursor

Métodos de escritura

Métodos de desplazamiento

Métodos de dirección de texto

Caracteres personalizados

Ejemplo completo

Ejemplo — contador en pantalla