#no-std #lcd #embedded-hal-driver #embedded-hal #hd44780

no-std hd44780-driver

A crate to use HD44780 compliant displays with embedded-hal

4 releases (2 breaking)

0.4.0 Sep 15, 2020
0.3.0 Feb 21, 2019
0.2.1 Oct 17, 2018
0.2.0 Aug 8, 2018

#3 in #lcd

Download history 134/week @ 2023-06-11 380/week @ 2023-06-18 186/week @ 2023-06-25 421/week @ 2023-07-02 457/week @ 2023-07-09 310/week @ 2023-07-16 284/week @ 2023-07-23 266/week @ 2023-07-30 321/week @ 2023-08-06 296/week @ 2023-08-13 207/week @ 2023-08-20 526/week @ 2023-08-27 370/week @ 2023-09-03 294/week @ 2023-09-10 239/week @ 2023-09-17 320/week @ 2023-09-24

1,383 downloads per month
Used in 6 crates (5 directly)

MIT license

776 lines


crates.io crates.io travis-ci.org API

Implementation of the embedded-hal traits for the HD44780.


Examples for several different boards can be found here

Any platform that implements the embedded-hal traits is supported by this library! See awesome-embedded-rust for a list of supported platforms.

Getting Started

This library aims to keep it simple in that to get started all you will have to do is supply the HD44780::new function a bunch of pins from your platform that implement the OutputPin trait for embedded-hal as well as a struct that implements the delay traits DelayUs<u16> and DelayMs<u8>.

// Pseudo-code: check the HAL crate for your specific device for exact code to get pins / delay
// It is recommended to use push/pull output pins, but if your specific LCD device has pull-up resistors
// an open/drain output pin should work too

let mut delay = Delay::new();

let mut lcd = HD44780::new_4bit(
    d4.into_push_pull_output(&mut port), // Register Select pin
    d3.into_push_pull_output(&mut port), // Enable pin

    d9.into_push_pull_output(&mut port),  // d4
    d10.into_push_pull_output(&mut port), // d5
    d11.into_push_pull_output(&mut port), // d6
    d12.into_push_pull_output(&mut port), // d7
    &mut delay,

// Unshift display and set cursor to 0
lcd.reset(&mut delay); 

// Clear existing characters
lcd.clear(&mut delay); 

// Display the following string
lcd.write_str("Hello, world!", &mut delay);

// Move the cursor to the second line
lcd.set_cursor_pos(40, &mut delay);

// Display the following string on the second line
lcd.write_str("I'm on line 2!", &mut delay);


  • 4-bit & 8-bit modes are supported
  • Support for i2c backpacks


  • Busy flag support (Waiting for support from embedded-hal to read and write from a pin)
  • Non-blocking API
  • A more user-friendly API with additional features
  • Custom characters


  • Additional issues as well as pull-requests are welcome.

  • If you have a platform not yet covered in this repository that is supported by embedded-hal, a pull-request of an example would be awesome!


This project is licensed under MIT license (LICENSE or https://opensource.org/licenses/MIT)