Skip to content

Commit 1ed9ef4

Browse files
danieldegrassenashif
authored andcommitted
docs: releases: migration-guide-3.7: add note about ST7735R migration
Add note about migration of ST7735R displays to MIPI DBI API. Signed-off-by: Daniel DeGrasse <[email protected]>
1 parent 6347aa7 commit 1ed9ef4

File tree

1 file changed

+43
-0
lines changed

1 file changed

+43
-0
lines changed

doc/releases/migration-guide-3.7.rst

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -213,6 +213,49 @@ Controller Area Network (CAN)
213213
Display
214214
=======
215215

216+
* ST7735R based displays now use the MIPI DBI driver class. These displays
217+
must now be declared within a MIPI DBI driver wrapper device, which will
218+
manage interfacing with the display. Note that the `cmd-data-gpios` pin has
219+
changed polarity with this update, to align better with the new
220+
`dc-gpios` name. For an example, see below:
221+
222+
.. code-block:: devicetree
223+
224+
/* Legacy ST7735R display definition */
225+
&spi0 {
226+
st7735r: st7735r@0 {
227+
compatible = "sitronix,st7735r";
228+
reg = <0>;
229+
spi-max-frequency = <32000000>;
230+
reset-gpios = <&gpio0 6 GPIO_ACTIVE_LOW>;
231+
cmd-data-gpios = <&gpio0 12 GPIO_ACTIVE_LOW>;
232+
...
233+
};
234+
};
235+
236+
/* New display definition with MIPI DBI device */
237+
238+
#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>
239+
240+
...
241+
242+
mipi_dbi {
243+
compatible = "zephyr,mipi-dbi-spi";
244+
reset-gpios = <&gpio0 6 GPIO_ACTIVE_LOW>;
245+
dc-gpios = <&gpio0 12 GPIO_ACTIVE_HIGH>;
246+
spi-dev = <&spi0>;
247+
#address-cells = <1>;
248+
#size-cells = <0>;
249+
250+
st7735r: st7735r@0 {
251+
compatible = "sitronix,st7735r";
252+
reg = <0>;
253+
mipi-max-frequency = <32000000>;
254+
mipi-mode = <MIPI_DBI_MODE_SPI_4WIRE>;
255+
...
256+
};
257+
};
258+
216259
Enhanced Serial Peripheral Interface (eSPI)
217260
===========================================
218261

0 commit comments

Comments
 (0)