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:
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);