com.diozero

Class HD44780Lcd

java.lang.Object

com.diozero.HD44780Lcd

All Implemented Interfaces:

Closeable, AutoCloseable

public class HD44780Lcd
extends Object
implements Closeable

LCD with HD44780 controller.
Code based on this Raspberry-Pi Spy article, Python code.

Another source of information: https://gist.github.com/DenisFromHR/cc863375a6e19dce359d.

HD44780 Datasheet.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HD44780Lcd.Characters
static interface	HD44780Lcd.LcdConnection
static class	HD44780Lcd.PCF8574LcdConnection
static class	HD44780Lcd.PiFaceCadLcdConnection

Constructor Summary

Constructors

Constructor and Description
HD44780Lcd(HD44780Lcd.LcdConnection lcdConnection, int columns, int rows)

Method Summary

Modifier and Type	Method and Description
HD44780Lcd	addText(char character)
HD44780Lcd	addText(int code)
HD44780Lcd	addText(String text)
HD44780Lcd	autoscrollOff()
HD44780Lcd	autoscrollOn()
HD44780Lcd	blinkOff()
HD44780Lcd	blinkOn()
HD44780Lcd	clear() Clear the display
void	close()
HD44780Lcd	createChar(int location, byte[] charMap)
HD44780Lcd	cursorOff()
HD44780Lcd	cursorOn()
HD44780Lcd	cursorOrDisplayShift(boolean displayShift, boolean shiftRight) Cursor or display shift shifts the cursor position or display to the right or left without writing or reading display data.
HD44780Lcd	displayControl(boolean displayOn, boolean cursorEnabled, boolean blinkEnabled)
HD44780Lcd	displayOff()
HD44780Lcd	displayOn()
HD44780Lcd	entryModeControl(boolean increment, boolean shiftDisplay) Control text entry mode.
int	getColumnCount()
int	getRowCount()
boolean	isBacklightEnabled()
boolean	isBlinkEnabled()
boolean	isCursorEnabled()
boolean	isIncrementOn()
boolean	isShiftDisplayOn()
HD44780Lcd	moveCursorLeft()
HD44780Lcd	moveCursorRight()
HD44780Lcd	returnHome() Return the cursor to the home position
HD44780Lcd	setBacklightEnabled(boolean backlightEnabled)
HD44780Lcd	setCharacter(int column, int row, char character)
HD44780Lcd	setCursorPosition(int column, int row)
HD44780Lcd	setText(int row, String text) Send string to display
HD44780Lcd	shiftDisplayLeft()
HD44780Lcd	shiftDisplayRight()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HD44780Lcd

public HD44780Lcd(HD44780Lcd.LcdConnection lcdConnection,
                  int columns,
                  int rows)

Method Detail

getColumnCount

public int getColumnCount()

getRowCount

public int getRowCount()

isBacklightEnabled

public boolean isBacklightEnabled()

setBacklightEnabled

public HD44780Lcd setBacklightEnabled(boolean backlightEnabled)

setCursorPosition

public HD44780Lcd setCursorPosition(int column,
                                    int row)

setCharacter

public HD44780Lcd setCharacter(int column,
                               int row,
                               char character)

setText

public HD44780Lcd setText(int row,
                          String text)

Send string to display

Parameters:

row - Row number (starts at 0)

text - Text to display

Returns:

This object instance

addText

public HD44780Lcd addText(String text)

addText

public HD44780Lcd addText(char character)

addText

public HD44780Lcd addText(int code)

clear

public HD44780Lcd clear()

Clear the display

Returns:

This object instance

returnHome

public HD44780Lcd returnHome()

Return the cursor to the home position

Returns:

This object instance

entryModeControl

public HD44780Lcd entryModeControl(boolean increment,
                                   boolean shiftDisplay)

Control text entry mode.

Parameters:

increment - The cursor or blinking moves to the right when incremented by 1 and to the left when decremented by 1.

shiftDisplay - Shifts the entire display either to the right (I/D = 0) or to the left (I/D = 1) when true. The display does not shift if false. If true, it will seem as if the cursor does not move but the display does.

Returns:

This object instance

autoscrollOn

public HD44780Lcd autoscrollOn()

autoscrollOff

public HD44780Lcd autoscrollOff()

isIncrementOn

public boolean isIncrementOn()

isShiftDisplayOn

public boolean isShiftDisplayOn()

displayControl

public HD44780Lcd displayControl(boolean displayOn,
                                 boolean cursorEnabled,
                                 boolean blinkEnabled)

displayOn

public HD44780Lcd displayOn()

displayOff

public HD44780Lcd displayOff()

cursorOn

public HD44780Lcd cursorOn()

cursorOff

public HD44780Lcd cursorOff()

blinkOn

public HD44780Lcd blinkOn()

blinkOff

public HD44780Lcd blinkOff()

isCursorEnabled

public boolean isCursorEnabled()

isBlinkEnabled

public boolean isBlinkEnabled()

cursorOrDisplayShift

public HD44780Lcd cursorOrDisplayShift(boolean displayShift,
                                       boolean shiftRight)

Cursor or display shift shifts the cursor position or display to the right or left without writing or reading display data. This function is used to correct or search the display. In a 2-line display, the cursor moves to the second line when it passes the 40th digit of the first line. Note that the first and second line displays will shift at the same time. When the displayed data is shifted repeatedly each line moves only horizontally. The second line display does not shift into the first line position.

Parameters:

displayShift - Shift the display if true, the cursor if false.

shiftRight - Shift to the right if true, to the left if false.

Returns:

This object instance

shiftDisplayRight

public HD44780Lcd shiftDisplayRight()

shiftDisplayLeft

public HD44780Lcd shiftDisplayLeft()

moveCursorRight

public HD44780Lcd moveCursorRight()

moveCursorLeft

public HD44780Lcd moveCursorLeft()

createChar

public HD44780Lcd createChar(int location,
                             byte[] charMap)

close

public void close()
           throws RuntimeIOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

RuntimeIOException