Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/FrancoMartino/cod-es/llms.txt

Use this file to discover all available pages before exploring further.

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 I2CPin en Arduino Uno
SDAA4
SCLA5
VCC5V
GNDGND
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

​
LCD_I2C
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

​
lcd.inicializar
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.
​
lcd.iniciar
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

​
lcd.limpiar
void
Borra todo el contenido de la pantalla y mueve el cursor al origen (columna 0, fila 0).
​
lcd.regresarAlInicio
void
Mueve el cursor al origen sin borrar el contenido de la pantalla.
​
lcd.encenderDisplay
void
Enciende la pantalla (muestra el contenido en memoria).
​
lcd.apagarDisplay
void
Apaga la pantalla sin borrar el contenido en memoria.

​
Métodos de iluminación

​
lcd.encenderLuz
void
Enciende la luz de fondo (backlight) del display.
​
lcd.apagarLuz
void
Apaga la luz de fondo del display.

​
Métodos del cursor

​
lcd.ajustarCursor
void
Posiciona el cursor en la columna y fila indicadas.Parámetros: col — columna (0 a cols - 1); row — fila (0 a rows - 1).
​
lcd.encenderCursor
void
Muestra el cursor como una línea subrayada debajo del carácter actual.
​
lcd.apagarCursor
void
Oculta el cursor subrayado.
​
lcd.encenderParpadeo
void
Activa el cursor parpadeante (bloque sólido que parpadea).
​
lcd.apagarParpadeo
void
Desactiva el cursor parpadeante.

​
Métodos de escritura

​
lcd.imprimirCadena
void
Imprime una cadena de caracteres (const char[]) en la posición actual del cursor.Parámetro: texto a mostrar entre comillas dobles.
​
lcd.escribir
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.
​
lcd.comando
void
Envía un comando directo al controlador HD44780 del LCD. Para uso avanzado.Parámetro: value — byte de comando.

​
Métodos de desplazamiento

​
lcd.deslizarDisplayIzquierda
void
Desplaza todo el contenido visible del display un carácter hacia la izquierda.
​
lcd.deslizarDisplayDerecha
void
Desplaza todo el contenido visible del display un carácter hacia la derecha.
​
lcd.deslizarAutomaticamente
void
Activa el desplazamiento automático: cada carácter nuevo empuja el texto existente.
​
lcd.noDeslizarAutomaticamente
void
Desactiva el desplazamiento automático (comportamiento por defecto).

​
Métodos de dirección de texto

​
lcd.izquierdaADerecha
void
Configura la escritura de izquierda a derecha (modo por defecto).
​
lcd.derechaAIzquierda
void
Configura la escritura de derecha a izquierda.
​
lcd.imprimirIzquierda
void
Justifica el texto hacia la izquierda respecto al cursor en modo de desplazamiento automático.
​
lcd.imprimirDerecha
void
Justifica el texto hacia la derecha respecto al cursor en modo de desplazamiento automático.

​
Caracteres personalizados

​
lcd.crearCaracter
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

Build docs developers (and LLMs) love

Get started for freeTalk to us