LiquidCrystal_I2C

LiquidCrystal_I2C.h - wyświetlacz tekstowy LCD z konwerterem I2C

Biblioteka LiquidCrystal_I2C.h zawiera szereg funkcji przydatnych gdy w swoim projekcie wykorzystujemy popularne wyświetlacze tekstowe LCD np. 16x2 podłączone do Arduino na magistrali I2C. Podłączenie takie wymaga użycia konwertera I2C np. LCM1602 I2C. Podłączenie wyświetlacza z takim konwerterem wymaga tylko 2 przewodów sygnałowych SDA i SCL, a co ciekawsze za pomocą tych samych dwóch przewodów można podłączyć kolejne urządzenia, które mogą komunikować się za pomocą magistrali I2C.

Do pobrania:

📂 LiquidCrystal_I2C-1.1.2.zip


Opis funkcji biblioteki

  • LiquidCrystal_I2C(uint8_t lcd_Addr,uint8_t lcd_cols,uint8_t lcd_rows) - definicja parametrów wyświetlacza gdzie lcd_Addr to adres na magistrali I2C, lcd_cols to ilość kolumn czyli ilość znaków w poziomie, lcd_rows ilość wierszy najczęściej definicja wygląda tak: LiquidCrystal_I2C lcd(0x27,16,2); czyli definiujemy wyświetlacz LCD o adresie 0x27 na magistrali I2C, 16 kolumnach i 2 wierszach znakowych.

  • void begin(uint8_t cols, uint8_t rows, uint8_t charsize = LCD_5x8DOTS ) - funkcja ustawiająca ilość kolumn t_cols, wierszy t_rows oraz rozmiar znaku na wyświetlaczu charsize tzn. ilość punktów z jakich składa się znak, standardowo 5x8DOTS lub 5x10DOTS.

  • void clear() - funkcja czyszcząca ekran i powrót kursora na pozycję 0 czyli do pierwszego wiersza pierwszej kolumny

  • void home() - funkcja przemieszczająca kursor na pozycję 0 czyli do pierwszego wiersza pierwszej kolumny

  • void noDisplay() - funkcja wyłączająca wyświetlacz

  • void display() - funkcja włączająca wyświetlacz

  • void noBlink() - funkcja wyłączająca miganie kursora

  • void blink() - funkcja włączająca miganie kursora

  • void noCursor() - funkcja wyłączająca kursor

  • void cursor() - funkcja włączająca kursor

  • void scrollDisplayLeft() - przesuwanie zawartości ekranu w lewo

  • void scrollDisplayRight() - przesuwanie zawartości ekranu w prawo

  • void printLeft() - (brak danych)

  • void printRight() - (brak danych)

  • void leftToRight() - tekst pływający od lewej do prawej

  • void rightToLeft() - tekst pływający od prawej do lewej

  • void shiftIncrement() - (brak danych)

  • void shiftDecrement() - (brak danych)

  • void noBacklight() - wyłączenie podświetlenia ekranu

  • void backlight() - włączenie podświetlenia ekranu

  • void autoscroll() - wyrównanie tekstu na prawo od kursora

  • void noAutoscroll() - wyrównanie tekstu na lewo od kursora

  • void createChar(uint8_t, uint8_t[]) - funkcja służąca do definiowania własnych znaków na wyświetlaczu LCD, przydatna gdy chcemy uzyskać polskie znaki lub jakiś znak którego nie ma w tablicy znaków, a możemy dodatkowo zdefiniować 8 znaków

  • void setCursor(uint8_t, uint8_t) - funkcja ustawiająca na kursor na podanej argumentami pozycji gdzie pierwszy parametr to numera znaku w wierszu, a drugi to numer kolumny - kolumny i wiersze numerowane są od 0

  • void write(uint8_t) - funkcja wypisująca teksty lub wartości podane w argumencie

  • void command(uint8_t) - funkcja niskopoziomowa wysłanie komendy do wyświetlacza o numerze podanym w argumencie

  • void init() - funkcja inicjalizująca początkowe ustawienia wyświetlacza

Funkcje aliasy:

  • void blink_on() - alias blink()

  • void blink_off() - alias noBlink()

  • void cursor_on() - alias cursor()

  • void cursor_off() - alias noCursor()

  • void setBacklight(uint8_t new_val) - alias backlight() oraz nobacklight()

  • void load_custom_character(uint8_t char_num, uint8_t *rows) - alias createChar()

  • void printstr(const char[]) - alias write(uint8_t);