tdo,tr230s (on mipi-dbi bus)

Description

TR230S display bridge/controller

Shanghai Top Display Optoelectronics TR230S is a display bridge/controller
that accepts RGB565 pixel data from a host and drives an attached RGB display
panel.

This binding supports the MIPI DBI Type C four-wire SPI host interface.
The TR230S also supports other host interfaces outside the scope of this
binding. WAIT is controller-ready flow control and is checked before each
controller transaction.

Properties

Properties not inherited from the base binding file.

Name

Type

Details

width

int

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

This property is required.

Value range: 1 to 65535

height

int

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

This property is required.

Value range: 1 to 65535

mipi-max-frequency

int

Maximum SPI clock frequency, in Hz. The default of 100 MHz is the
manufacturer's maximum specified SPI interface frequency; a board may
select a lower frequency.

Default value: 100000000

Value range: 1 to 100000000

mipi-mode

string

MIPI DBI Type C mode used by this binding.

Default value: MIPI_DBI_MODE_SPI_4WIRE

Legal values: MIPI_DBI_MODE_SPI_3WIRE, MIPI_DBI_MODE_SPI_4WIRE, MIPI_DBI_MODE_6800_BUS_16_BIT, MIPI_DBI_MODE_6800_BUS_9_BIT, MIPI_DBI_MODE_6800_BUS_8_BIT, MIPI_DBI_MODE_8080_BUS_16_BIT, MIPI_DBI_MODE_8080_BUS_9_BIT, MIPI_DBI_MODE_8080_BUS_8_BIT

wait-gpios

phandle-array

Controller-ready input. The active logical state means that the TR230S
can accept a new controller transaction.

This property is required.

ready-timeout-ms

int

Maximum time to wait for controller readiness, in milliseconds. If the
property is omitted or set to zero, the driver waits indefinitely,
matching the manufacturer's STM32 example polling behavior.

Minimum value: 0

reset-pre-delay-ms

int

Delay before asserting hardware reset, in milliseconds. The 10 ms
default follows the manufacturer's STM32 example and was validated on
hardware; shorter timing did not initialize the tested module reliably.

Default value: 10

Minimum value: 0

reset-pulse-ms

int

Hardware-reset pulse width, in milliseconds. The 10 ms default follows
the manufacturer's STM32 example and was validated on hardware; shorter
timing did not initialize the tested module reliably.

Default value: 10

Minimum value: 1

post-reset-delay-ms

int

Minimum time after releasing hardware reset before the first controller
transaction, in milliseconds. The 2000 ms default follows the
manufacturer's STM32 example and was validated on hardware; shorter
timing did not initialize the tested module reliably.

Default value: 2000

Minimum value: 0

initial-brightness

int

Initial non-blanked brightness.

This property is required.

Value range: 0 to 255

duplex

int

SPI Duplex mode, full or half. By default it's always full duplex thus 0
as this is, by far, the most common mode.
Selecting half duplex allows to use the SPI controller's SDO as a bidirectional line,
typically used when only one data line is connected.
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

mipi-cpol

boolean

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

mipi-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.

mipi-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.

color-coding

string

Color coding for MIPI DBI Type A or Type B(6800/8080) interface. These definitions
should match those in dt-bindings/mipi_dbi/mipi_dbi.h

Legal values: MIPI_DBI_MODE_RGB332, MIPI_DBI_MODE_RGB444, MIPI_DBI_MODE_RGB565, MIPI_DBI_MODE_RGB666_1, MIPI_DBI_MODE_RGB666_2, MIPI_DBI_MODE_RGB888_1, MIPI_DBI_MODE_RGB888_2

te-mode

string

MIPI DBI tearing enable signal mode. Defaults to disabled.

Default value: MIPI_DBI_TE_NO_EDGE

Legal values: MIPI_DBI_TE_NO_EDGE, MIPI_DBI_TE_RISING_EDGE, MIPI_DBI_TE_FALLING_EDGE

te-delay

int

Delay in microseconds to wait before transmitting display data after a
tearing enable synchronization signal is seen. Defaults to 0 since most
controllers will not need a delay.

Default value: 0

supply-gpios

phandle-array

GPIO specifier that controls power to the device.

This property should be provided when the device has a dedicated
switch that controls power to the device.  The supply state is
entirely the responsibility of the device driver.

Contrast with vin-supply.

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.