Hd44780 Class

Definition

Namespace:

Iot.Device.CharacterLcd

Assembly:

Iot.Device.Bindings.dll

Package:

Iot.Device.Bindings v3.0.0

Supports LCD character displays compatible with the HD44780 LCD controller/driver. Also supports serial interface adapters such as the MCP23008.

public class Hd44780 : IDisposable, Iot.Device.CharacterLcd.ICharacterLcd

type Hd44780 = class
    interface ICharacterLcd
    interface IDisposable

Public Class Hd44780
Implements ICharacterLcd, IDisposable

Inheritance

Object

Hd44780

Derived

Iot.Device.CharacterLcd.Lcd1602

Iot.Device.CharacterLcd.Lcd2004

Iot.Device.CharacterLcd.LcdRgb

Implements

IDisposable ICharacterLcd

Remarks

The Hitatchi HD44780 was released in 1987 and set the standard for LCD controllers. Hitatchi does not make this chipset anymore, but most character LCD drivers are intended to be fully compatible with this chipset. Some examples: Sunplus SPLC780D, Sitronix ST7066U, Samsung KS0066U, Aiptek AIP31066, and many more.

Some compatible chips extend the HD44780 with addtional pins and features. They are still fully compatible. The ST7036 is one example.

This implementation was drawn from numerous datasheets and libraries such as Adafruit_Python_CharLCD.

Constructors

Hd44780(Size, LcdInterface)

Initializes a new HD44780 LCD controller.

Fields

_lcdInterface	LCD interface used by the device
_rowOffsets	Offsets of the rows
ClearDisplayCommand	Command which can be used to clear the display
ReturnHomeCommand	Command which can be used to return (cursor) home
SetCGRamAddressCommand	Command which can be used to set CG RAM address
SetDDRamAddressCommand	Command which can be used to set DD RAM address

Properties

AutoShift	When enabled the display will shift rather than the cursor.
BacklightOn	Enable/disable the backlight. (Will always return false if no backlight pin was provided.)
BlinkingCursorVisible	Enable/disable the blinking cursor.
DisplayOn	Enable/disable the display.
Increment	Gets/sets whether the cursor location increments (true) or decrements (false).
NumberOfCustomCharactersSupported	Returns the number of custom characters for this display. A custom character is one that can be user-defined and assigned to a slot using CreateCustomCharacter(Int32, ReadOnlySpan<Byte>)
Size	Logical size, in characters, of the LCD.
UnderlineCursorVisible	Enable/disable the underline cursor.

Methods

Clear()	Clears the LCD, returning the cursor to home and unshifting if shifted. Will also set to Increment.
CreateCustomCharacter(Int32, Byte[])	Fill one of the 8 CGRAM locations (character codes 0 - 7) with custom characters. See CreateCustomCharacter(Int32, ReadOnlySpan<Byte>) for details.
CreateCustomCharacter(Int32, ReadOnlySpan<Byte>)	Fill one of the 8 CGRAM locations (character codes 0 - 7) with custom characters.
Dispose()	Releases unmanaged resources used by Hd44780 and optionally release managed resources
GetTwoLineMode(Int32)	Determines if the device should use two line mode
Home()	Moves the cursor to the first line and first column, unshifting if shifted.
InitializeRowOffsets(Int32)	Initializes row offsets
SendCommand(Byte)	Sends command to the device
SendCommandAndWait(Byte)	The initialization sequence and some other complex commands should be sent with delays, or the display may behave unexpectedly. It may show random, blinking characters or display text very faintly only.
SendCommands(ReadOnlySpan<Byte>)	Send commands to the device
SendData(Byte)	Sends byte to the device
SendData(ReadOnlySpan<Byte>)	Sends data to the device
SendData(ReadOnlySpan<Char>)	Sends data to the device
SetCursorPosition(Int32, Int32)	Moves the cursor to an explicit column and row position.
ShiftCursorLeft()	Move the cursor left one position.
ShiftCursorRight()	Move the cursor right one position.
ShiftDisplayLeft()	Move the display left one position.
ShiftDisplayRight()	Move the display right one position.
WaitForNotBusy(Int32)	Wait for the device to not be busy.
Write(Char[])	Write a raw byte stream to the display. Used if character translation already took place
Write(ReadOnlySpan<Char>)	Write a raw byte stream to the display. Used if character translation already took place
Write(String)	Write text to display.

Extension Methods

CreateCustomCharacter(ICharacterLcd, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

Creates a custom character for standard displays with 8-pixel-per-row characters. See CreateCustomCharacter(Int32, ReadOnlySpan<Byte>) for details.