hit,hd44780

Vendor: Hitachi Ltd.

Note

An implementation of a driver matching this compatible is available in drivers/auxdisplay/auxdisplay_hd44780.c.

Description

Hitachi HD44780 LCD

Properties

Node specific properties

Properties not inherited from the base binding file.

Name

Type

Details

mode

int

 
Operating mode of display, 8-bit or 4 for 4-bit mode

This property is required.

Legal values: 4, 8

register-select-gpios

phandle-array

 
GPIO connected to Register Select (RS) of LCD

This property is required.

read-write-gpios

phandle-array

 
Optional GPIO used for selecting read or write mode

enable-gpios

phandle-array

 
GPIO used for enabling commands to be sent

This property is required.

data-bus-gpios

phandle-array

 
Array of GPIOs connected to the DB lines of the display, this must
contain 8 entries ascending from DB0 to DB7, for 4-bit interface
displays, the first 4 must be set as `<0>`

This property is required.

brightness-gpios

phandle-array

 
Optional GPIO used for controlling the brightness (contrast)

backlight-gpios

phandle-array

 
Optional GPIO used for enabling the backlight

line-addresses

uint8-array

 
Array of addresses for each row, will use defaults if not provided.
Default is as per Hitachi HD44780 specification.

Default value: [0, 64, 20, 84]

enable-line-rise-delay-us

int

 
Delay time (in us) to wait after enable line rises before setting low.
Default is as per Hitachi HD44780 specification.

Default value: 800

enable-line-fall-delay-us

int

 
Delay time (in us) to wait after enable line falls before sending
another command. Default is as per Hitachi HD44780 specification.

Default value: 100

clear-command-delay-us

int

 
Delay time (in us) to wait after issuing a clear command before sending
another command. Default is as per Hitachi HD44780 specification.

Default value: 5000

boot-delay-ms

int

 
Delay time (in ms) to wait at boot time before sending a command (note:
this will delay startup of the whole application by this time, this
should only be used when time is needed for the display device to be
ready before it can be configured which without any delay would cause
the display to not function properly).

columns

int

 
Number of text columns that the display has

This property is required.

rows

int

 
Number of text rows that the display has

This property is required.

Deprecated node specific properties

Deprecated properties not inherited from the base binding file.

(None)

Base properties

Properties inherited from the base binding file, which defines common properties that may be set on many nodes. Not all of these may apply to the “hit,hd44780” compatible.

Name

Type

Details

status

string

 
indicates the operational status of a device

Legal values: 'ok', 'okay', 'disabled', 'reserved', 'fail', 'fail-sss'

See Important properties for more information.

compatible

string-array

 
compatible strings

This property is required.

See Important properties for more information.

reg

array

 
register space

See Important properties for more information.

reg-names

string-array

 
name of each register space

interrupts

array

 
interrupts for device

See Important properties for more information.

interrupts-extended

compound

 
extended interrupt specifier for device

interrupt-names

string-array

 
name of each interrupt

interrupt-parent

phandle

 
phandle to interrupt controller node

label

string

 
Human readable string describing the device (used as device_get_binding() argument)

See Important properties for more information.

This property is deprecated.

clocks

phandle-array

 
Clock gate information

clock-names

string-array

 
name of each clock

#address-cells

int

 
number of address cells in reg property

#size-cells

int

 
number of size cells in reg property

dmas

phandle-array

 
DMA channels specifiers

dma-names

string-array

 
Provided names of DMA channel specifiers

io-channels

phandle-array

 
IO channels specifiers

io-channel-names

string-array

 
Provided names of IO channel specifiers

mboxes

phandle-array

 
mailbox / IPM channels specifiers

mbox-names

string-array

 
Provided names of mailbox / IPM channel specifiers

power-domains

phandle-array

 
Power domain specifiers

power-domain-names

string-array

 
Provided names of power domain specifiers

#power-domain-cells

int

 
Number of cells in power-domains property

zephyr,deferred-init

boolean

 
Do not initialize device automatically on boot. Device should be manually
initialized using device_init().

wakeup-source

boolean

 
Property to identify that a device can be used as wake up source.

When this property is provided a specific flag is set into the
device that tells the system that the device is capable of
wake up the system.

Wake up capable devices are disabled (interruptions will not wake up
the system) by default but they can be enabled at runtime if necessary.

zephyr,pm-device-runtime-auto

boolean

 
Automatically configure the device for runtime power management after the
init function runs.

zephyr,disabling-power-states

phandles

 
List of power states that will disable this device power.