newvision,nv3031b (on spi bus)

Description

NewVision NV3031B LCD (Liquid Crystal Display) controller

NewVision NV3031B LCD controller using single-data-line SPI transfers
with four-byte QSPI command framing. Panel-specific timing, power, and
gamma properties contain register parameters without the command byte.

Properties

Properties not inherited from the base binding file.

Name

Type

Details

reset-gpios

phandle-array

Active-low panel reset signal.

This property is required.

supply-gpios

phandle-array

Panel power enable signal.

backlight-leds

phandles

LED child nodes that illuminate the panel. All are driven at the same
brightness.

brightness

int

Initial backlight brightness, from 0 (off) to 255 (maximum). Defaults
to approximately half brightness to limit startup intensity.

Default value: 127

Value range: 0 to 255

rotation

int

Initial clockwise rotation in degrees. Width and height describe the
panel before this rotation is applied.

Default value: 0

Legal values: 0, 90, 180, 270

color-invert

boolean

Enable display color inversion.

red-blue-swap

boolean

Set the BGR bit in the memory access control register.

source-timing

uint8-array

Source timing register (0x60), 1 byte.

This property is required.

Length range: 1 to 1

gate-timing

uint8-array

Gate timing register (0x61), 2 bytes.

This property is required.

Length range: 2 to 2

inversion-control

uint8-array

Inversion control register (0xB4), 1 byte.

This property is required.

Length range: 1 to 1

frame-rate

uint8-array

Frame rate register (0xB1), 3 bytes.

This property is required.

Length range: 3 to 3

porch-control

uint8-array

Porch control register (0xB5), 4 bytes.

This property is required.

Length range: 4 to 4

display-function

uint8-array

Display function register (0xB6), 5 bytes.

This property is required.

Length range: 5 to 5

bias-trim

uint8-array

Bias trim register (0xDF), 1 byte.

This property is required.

Length range: 1 to 1

bias-current

uint8-array

Bias current register (0x67), 1 byte.

This property is required.

Length range: 1 to 1

power-control

uint8-array

Power control register (0x68), 4 bytes.

This property is required.

Length range: 4 to 4

gamma-positive-voltage

uint8-array

Positive gamma voltage register (0xE1), 2 bytes.

This property is required.

Length range: 2 to 2

gamma-negative-voltage

uint8-array

Negative gamma voltage register (0xE4), 2 bytes.

This property is required.

Length range: 2 to 2

gamma-positive-mid

uint8-array

Positive gamma mid-tone register (0xE2), 6 bytes.

This property is required.

Length range: 6 to 6

gamma-negative-mid

uint8-array

Negative gamma mid-tone register (0xE5), 6 bytes.

This property is required.

Length range: 6 to 6

gamma-positive

uint8-array

Positive gamma curve register (0xE0), 8 bytes.

This property is required.

Length range: 8 to 8

gamma-negative

uint8-array

Negative gamma curve register (0xE3), 8 bytes.

This property is required.

Length range: 8 to 8

power-slope

uint8-array

Power slope register (0xE6), 2 bytes.

This property is required.

Length range: 2 to 2

source-equalization

uint8-array

Source equalization register (0xE7), 6 bytes.

This property is required.

Length range: 6 to 6

source-level

uint8-array

Source output level register (0xE8), 3 bytes.

This property is required.

Length range: 3 to 3

gate-equalization

uint8-array

Gate equalization register (0xEC), 1 byte.

This property is required.

Length range: 1 to 1

spi-max-frequency

int

Maximum clock frequency of device's SPI interface in Hz

This property is required.

duplex

int

Duplex mode, full or half. By default it's always full duplex thus 0
as this is, by far, the most common mode.
Use the macros not the actual enum value, here is the concordance
list (see dt-bindings/spi/spi.h)
  0    SPI_FULL_DUPLEX
  2048 SPI_HALF_DUPLEX

Default value: 0

Legal values: 0, 2048

frame-format

int

Motorola or TI frame format. By default it's always Motorola's,
thus 0 as this is, by far, the most common format.
Use the macros not the actual enum value, here is the concordance
list (see dt-bindings/spi/spi.h)
  0     SPI_FRAME_FORMAT_MOTOROLA
  32768 SPI_FRAME_FORMAT_TI

Default value: 0

Legal values: 0, 32768

spi-cpol

boolean

SPI clock polarity which indicates the clock idle state.
If it is used, the clock idle state is logic high; otherwise, low.

spi-cpha

boolean

SPI clock phase that indicates on which edge data is sampled.
If it is used, data is sampled on the second edge; otherwise, on the first edge.

spi-lsb-first

boolean

The device requires least significant bit first data mode.

spi-hold-cs

boolean

In some cases, it is necessary for the controller to manage SPI chip select
under software control, so that multiple spi transactions can be performed
without releasing it. A typical use case is variable length SPI packets
where the first spi transaction reads the length and the second spi transaction
reads length bytes.

spi-cs-high

boolean

The device requires the chip select to be active high.

spi-interframe-delay-ns

int

Delay in nanoseconds between SPI words.
Default of 0 is special value which will assume to mean half of the SCK period.

Default value: 0

spi-cs-setup-delay-ns

int

Delay in nanoseconds to be introduced by the controller after CS is asserted.
Also known as enable lead time.

spi-cs-hold-delay-ns

int

Delay in nanoseconds to be introduced by the controller before the CS is de-asserted.
 Also known as enable lag time.

vin-supply

phandle

Reference to the regulator that controls power to the device.
The referenced devicetree node must have a regulator compatible.

This property should be provided when device power is supplied
by a shared regulator.  The supply state is dependent on the
request status of all devices fed by the regulator.

Contrast with supply-gpios.  If both properties are provided
then the regulator must be requested before the supply GPIOS is
set to an active state, and the supply GPIOS must be set to an
inactive state before releasing the regulator.

height

int

Height of the panel driven by the controller, with the units in pixels.

This property is required.

width

int

Width of the panel driven by the controller, with the units in pixels.

This property is required.