LCD-I2C-Fonctions

Fonctions disponibles

Voici les différentes fonctions disponibles dans la bibliothèques LiquidCrystal_I2C

• print() - Affiche une chaine de caractère à l'écran et déplace le curseur sur la ligne suivante si l'on dépasse la largeur d'affichage. Si le texte est trop long pour être affiché sur une ligne, une partie de celui-ci est perdu.
• clear() - Efface l'écran.
• home() - Replace le curseur en haut à gauche (pour le prochain affichage.
• noDisplay() - éteint rapidement l'écran (le contenu affiché n'est pas modifié). N'impacte pas le contrôle du rétro-éclairage.
• display() - allume rapidement l'écran (le contenu affiché n'est pas modifié). N'impacte pas le contrôle du rétro-éclairage.
• noBlink() - L'affichage du curseur est fixe (si le curseur est visible).
• blink() - Le curseur clignote (si le curseur est visible)
• noCursor() - désactive le curseur qui devient invisible.
• cursor() - active le curseur (underline cursor) qui devient visible.
• scrollDisplayLeft() - Décale le contenu affiché d'une colonne sur la gauche (sans modifier la RAM)
• scrollDisplayRight() - Décale le contenu affiché d'une colonne sur la droite (sans modifier la RAM)
• leftToRight() - Active l'affichage normal (annule l'effet introduit par rightToLeft())
• rightToLeft() - Affiche le texte de gauche à droite (à l'envers) depuis la position du curseur. "Hello!" est donc affiché "!olleH" depuis la position du curseur.
• noBacklight() - Désactive le rétro-éclairage
• backlight() - Active le rétro-éclairage
• autoscroll() - "Justifie le texte à droite" depuis la position du curseur
• noAutoscroll() - Justifie le texte à gauche depuis la position du curseur
• createChar(uint8_t, uint8_t[]) - Voyez l'exemple disponible dans le menu Fichier -> Exemples -> LiquidCrystal_I2C
• setCursor(uint8_t col, uint8_t row) - Modifie la position du curseur à l'écran pour le prochain affichage (de 0 à N-1). Attention, le premier argument la colonne.
• shiftIncrement() - pas de documentation disponible
• shiftDecrement() - pas de documentation disponible
• printLeft() - pas de documentation disponible
• printRight() - pas de documentation disponible

print() sur LCD 16x2

Voici un exemple qui décris le comportement de plusieurs instructions lcd.print() sur un écran lcd 16x2.

#include <Wire.h> 
#include <LiquidCrystal_I2C.h>

LiquidCrystal_I2C lcd(0x27,16,2);  // set the LCD address to 0x27 for a 16 chars and 2 line display

void setup()
{
  lcd.init();                      // initialize the lcd 
 
  // Print a message to the LCD.
  lcd.backlight();
  lcd.print("Hello voici un texte vraiment tres long!");
  lcd.print("ffff!");
  lcd.print("eeeef!");
  lcd.print("12315");
  lcd.print("789999");
}

void loop()
{
  delay( 1000 );
}

Ce qui produit le résultat suivant sur un écran LCD 16x2

Hello voici un texte vraiment t
!ffff!eeeef!1231

Print() sur LCD 20x4

Voici un autre exemple d'affichage sur un LCD 20x4 .

#include <Wire.h> 
#include <LiquidCrystal_I2C.h>

// Ecran LCD branché sur la backpack LCD I2C (a l'adresse 0x27)
// Dimension de l'écran 20 caractères par ligne, 4 lignes
LiquidCrystal_I2C lcd(0x27,20,4);  

void setup()
{
  // Initialize l'ecran
  lcd.init();
 
  // Affiche des messages sur l'ecran
  lcd.backlight();
  lcd.home();
  lcd.print("LCD 20x4 Blanc/Bleu");
  lcd.setCursor(0,1); // colonne, ligne
  lcd.print("Disponible chez");
  lcd.setCursor(7,2); 
  lcd.print("MC Hobby Sprl");
  lcd.setCursor(0,3);
  lcd.print("--shop.mchobby.be--");
}

void loop()
{
  delay( 1000 );
}

---

Réalisé par Meurisse D. pour MCHobby.be.

Remerciements à Mr Roblin pour la correction de la coquille dans la bibliothèque et complément d'info sur l'adressage I2C.

Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : «  Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.

L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.