Skip to content

Commit 0784a86

Browse files
danieldegrassehenrikbrixandersen
authored andcommitted
doc: releases: migration-guide: add migration note for ST7789V display
Add migration note to ST7789V display, which has been converted to the MIPI DBI API. Signed-off-by: Daniel DeGrasse <[email protected]>
1 parent a0e3dd1 commit 0784a86

File tree

1 file changed

+44
-0
lines changed

1 file changed

+44
-0
lines changed

doc/releases/migration-guide-3.7.rst

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -351,6 +351,50 @@ Display
351351
};
352352
};
353353
354+
355+
* ST7789V based displays now use the MIPI DBI driver class. These displays
356+
must now be declared within a MIPI DBI driver wrapper device, which will
357+
manage interfacing with the display. (:github:`73750`) Note that the
358+
`cmd-data-gpios` pin has changed polarity with this update, to align better
359+
with the new `dc-gpios` name. For an example, see below:
360+
361+
.. code-block:: devicetree
362+
363+
/* Legacy ST7789V display definition */
364+
&spi0 {
365+
st7789: st7789@0 {
366+
compatible = "sitronix,st7789v";
367+
reg = <0>;
368+
spi-max-frequency = <32000000>;
369+
reset-gpios = <&gpio0 6 GPIO_ACTIVE_LOW>;
370+
cmd-data-gpios = <&gpio0 12 GPIO_ACTIVE_LOW>;
371+
...
372+
};
373+
};
374+
375+
/* New display definition with MIPI DBI device */
376+
377+
#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>
378+
379+
...
380+
381+
mipi_dbi {
382+
compatible = "zephyr,mipi-dbi-spi";
383+
reset-gpios = <&gpio0 6 GPIO_ACTIVE_LOW>;
384+
dc-gpios = <&gpio0 12 GPIO_ACTIVE_HIGH>;
385+
spi-dev = <&spi0>;
386+
#address-cells = <1>;
387+
#size-cells = <0>;
388+
389+
st7789: st7789@0 {
390+
compatible = "sitronix,st7789v";
391+
reg = <0>;
392+
mipi-max-frequency = <32000000>;
393+
mipi-mode = <MIPI_DBI_MODE_SPI_4WIRE>;
394+
...
395+
};
396+
};
397+
354398
Enhanced Serial Peripheral Interface (eSPI)
355399
===========================================
356400

0 commit comments

Comments
 (0)