Introduction

This repo is compatible with standard Character LCDs.

Compatible with CircuitPython Versions: 1.0.0

Dependencies

This driver depends on:

• Adafruit CircuitPython

Please ensure all dependencies are available on the CircuitPython filesystem. This is easily achieved by downloading the Adafruit library and driver bundle.

Usage Example

The LCD class interfaces a predefined Character LCD display with CircuitPython.

import adafruit_character_lcd as LCD

You must define the data pins (RS, EN, D4, D5, D6, D7) in your code before using the LCD class. If you want to have on/off backlight functionality, you can also define your backlight as lcd_backlight. Otherwise, the backlight will always remain on. An example of this is below

lcd_rs = digitalio.DigitalInOut(D7)
lcd_en = digitalio.DigitalInOut(D8)
lcd_d7 = digitalio.DigitalInOut(D12)
lcd_d6 = digitalio.DigitalInOut(D11)
lcd_d5 = digitalio.DigitalInOut(D10)
lcd_d4 = digitalio.DigitalInOut(D9)
lcd_backlight = digitalio.DigitalInOut(D13)

You must also define the size of the CharLCD by specifying its lcd_columns and lcd_rows:

lcd_columns = 16
lcd_rows = 2 

After you have set up your LCD, we can make the device by calling it

lcd = LCD.cirpyth_char_lcd(lcd_rs, lcd_en, lcd_d4, lcd_d5, lcd_d6, lcd_d7, lcd_columns, lcd_rows, lcd_backlight)

To verify that your pins are correct, print a hello message to the CharLCD:

lcd.message('hello\ncircuitpython')

Custom character example with create_char() is provided within /examples/

Contributing

Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.