lcd_parallel_bus

Crates.iolcd_parallel_bus
lib.rslcd_parallel_bus
version0.1.0
created_at2025-02-01 22:18:14.204397+00
updated_at2025-02-01 22:18:14.204397+00
descriptionA driver for various liquid crystal displays driven by HD44780 or equivalent, including double controller like 40x4 displays.
homepage
repositoryhttps://codeberg.org/frere_jacques/lcd_parallel_bus
max_upload_size
id1539042
size381,065
Jacob König-Otto (frere-jacques)

documentation

README

lcd_parallel_bus

This is a driver for HD44780 or compatible chip based LCDs via a parallel bus.

Overview

This driver supports both the four bit and eight bit parallel data bus. Some displays like a four line times forty character display commonly named LCD4004, which is driven by two chips and has an additional EN2 line, is supported too. The bus structs, which support two chip devices, can be additionally be used to drive two separate one chip displays via one bus.

All functionalities of the HD44780 are supported, including busy waiting, reading busy flag and address counter, reading from and writing to the display data RAM (DDRAM) and character generator RAM (CGRAM).

This driver can be used as async or as blocking. The Lcd and the bus structs are available in a blocking variant in the blocking module.

Features

  • async or blocking
  • Four and eight bit bus
  • Support for dual chip devices like the LCD4004 or two LCD in parallel.
  • Busy waiting
  • Reading from display:
    • busy flag
    • address counter
    • DDRAM
    • CGRAM
  • Optional support for defmt
  • Little Ferris example

Examples

There are multiple examples in the example section of this repository based on a STM32F1. These LCDs work with some limitation in display quality at 3.3V, but are designed for 5V. The pin selection in the example is made to use 5V tolerant pins.

Use this driver if:

  • You need one of the above features.
  • If you like the

Don't use this driver if:

  • Your device is controlled via I2C.

Alternatives

There exist several alternative crates for these devices. Many of them are either async or blocking. The ammount of features supported varies strongly.

License

MIT or Apache-2.0

Commit count: 0

cargo fmt