Struct lcd::Display

pub struct Display<HW: Hardware + Delay> { /* fields omitted */ }

Object implementing HD44780 protocol. Stateless (could be created as many times as needed).

Implementations

impl<HW: Hardware + Delay> Display<HW>

pub fn new(hw: HW) -> Display<HW>

pub fn init(&mut self, line: FunctionLine, dots: FunctionDots)

Initialize LCD display. Sets an equivalent of the following setup:

lcd.display(DisplayMode::DisplayOff, DisplayCursor::CursorOff, DisplayBlink::BlinkOff);
lcd.clear();
lcd.entry_mode(EntryModeDirection::EntryRight, EntryModeShift::NoShift);

pub fn clear(&mut self) -> &Self

Clears display and returns cursor to the home position (address 0).

pub fn home(&mut self) -> &Self

Returns cursor to home position. Also returns display being shifted to the original position. DDRAM content remains unchanged.

pub fn entry_mode(
    &mut self,
    dir: EntryModeDirection,
    scroll: EntryModeShift
) -> &Self

Sets cursor move direction (entry); specifies to shift the display (scroll). These operations are performed during data read/write.

pub fn display(
    &mut self,
    display: DisplayMode,
    cursor: DisplayCursor,
    blink: DisplayBlink
) -> &Self

Sets on/off of all display (display), cursor on/off (cursor), and blink of cursor position character (blink).

pub fn scroll(&mut self, dir: Direction) -> &Self

Sets display-shift, direction (dir). DDRAM content remains unchanged.

pub fn cursor(&mut self, dir: Direction) -> &Self

Sets cursor-shift, direction (dir). DDRAM content remains unchanged.

pub fn position(&mut self, col: u8, row: u8)

Sets the cursor position to the given row (row) and column (col).

pub fn print(&mut self, str: &str) -> &Self

Print given string (str) on the LCD screen.

pub fn write(&mut self, data: u8) -> &Self

Write given character (given as data of type u8) on the LCD screen.

pub fn upload_character(&mut self, location: u8, map: [u8; 8]) -> &Self

Upload character image at given location. Only locations 0-7 are supported (panics otherwise). Each character is represented by an array of 8 bytes, each byte being a row. Only 5 bits are used from each byte (representing columns).

pub fn unwrap(self) -> HW

Unwrap HAL back from the driver.

Trait Implementations

impl<HW: Hardware + Delay> Write for Display<HW>

fn write_str(&mut self, s: &str) -> Result

Writes a string slice into this writer, returning whether the write succeeded.

pub fn write_char(&mut self, c: char) -> Result<(), Error>

Writes a char into this writer, returning whether the write succeeded.

pub fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

Glue for usage of the write! macro with implementors of this trait.