Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

Kazi Afroza Sultana — Thu, 05 Jun 2025 14:54:35 GMT

Hello Abdullah,

You can upload the overlay file here so I can check.

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

Kazi Afroza Sultana — Thu, 05 Jun 2025 14:53:50 GMT

Hello Nanag,

You need to change the parameters following way

mipi-mode:
The value should be an integer macro, not a string. For 4-wire SPI, use <MIPI_DBI_MODE_SPI_4WIRE>.
Make sure you include the correct header:
#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>

mipi-max-frequency:
Use a direct integer value (e.g., <8000000>) instead of DT_FREQ_M(8) unless you have that macro defined.

This is the overlay file after this change

#include <zephyr/dt-bindings/display/panel.h>
#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>

/ {
    chosen {
        zephyr,display = &st7789v;
    };

    leds {
        compatible = "gpio-leds";
        lcd_backlight: lcd_backlight {
            gpios = <&gpio0 11 GPIO_ACTIVE_LOW>;
            label = "LCD Backlight";
        };
    };

    mipi_dbi {
        compatible = "zephyr,mipi-dbi-spi";
        status = "okay";
        reset-gpios = <&gpio0 27 GPIO_ACTIVE_LOW>;
        dc-gpios = <&gpio0 31 GPIO_ACTIVE_HIGH>;
        spi-dev = <&spi0>;
        write-only;
        #address-cells = <1>;
        #size-cells = <0>;

        st7789v: st7789v@0 {
            compatible = "sitronix,st7789v";
            status = "okay";
            reg = <0>;
            mipi-max-frequency = <8000000>;
            mipi-mode = <MIPI_DBI_MODE_SPI_4WIRE>;
            width = <240>;
            height = <240>;
            x-offset = <0>;
            y-offset = <0>;
            vcom = <0x19>;
            gctrl = <0x35>;
            vrhs = <0x12>;
            vdvs = <0x20>;
            mdac = <0x00>;
            gamma = <0x01>;
            colmod = <0x05>;
            lcm = <0x2c>;
            porch-param = [0c 0c 00 33 33];
            cmd2en-param = [5a 69 02 01];
            pwctrl1-param = [a4 a1];
            pvgam-param = [D0 04 0D 11 13 2B 3F 54 4C 18 0D 0B 1F 23];
            nvgam-param = [D0 04 0C 11 13 2C 3F 44 51 2F 1F 1F 20 23];
            ram-param = [00 F0];
            rgb-param = [CD 08 14];
        };
    };
};

Besides this also can check if your confif file contains following configurations

CONFIG_SPI=y
CONFIG_SPI_NRFX=y
CONFIG_MIPI_DBI=y
CONFIG_DISPLAY=y
CONFIG_LVGL=y  # If using LVGL

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

Abdullah Javed — Wed, 28 May 2025 07:13:27 GMT

Hi,
I am using nrf52840 with ili9341 display and mipi_dbi node with spi, I am using same mipi setup, I am not able to figure out what is the issue here.
can someone please guide me here.
I am getting these errors:

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

nanangcreacoll — Wed, 28 May 2025 02:42:44 GMT

overlay file:

#include <zephyr/dt-bindings/display/panel.h>
#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>

/ {
	chosen {
		zephyr,display = &st7789v;
	};

	leds {
        compatible = "gpio-leds";
        lcd_backlight: lcd_backlight {
            gpios = <&gpio0 11 GPIO_ACTIVE_LOW>;
            label = "LCD Backlight";
        };
    };

    mipi_dbi {
        compatible = "zephyr,mipi-dbi-spi";
        status = "okay";
        reset-gpios = <&gpio0 27 GPIO_ACTIVE_LOW>;
        dc-gpios = <&gpio0 31 GPIO_ACTIVE_HIGH>;
        spi-dev = <&spi0>;
        write-only;
        #address-cells = <1>;
        #size-cells = <0>;

        st7789v: st7789v@0 {
            compatible = "sitronix,st7789v";
            status = "okay";
            reg = <0>;
            mipi-max-frequency = <DT_FREQ_M(8)>;
            mipi-mode = "MIPI_DBI_MODE_SPI_4WIRE";
            width = <240>;
            height = <240>;
            x-offset = <0>;
            y-offset = <0>;
            vcom = <0x19>;
            gctrl = <0x35>;
            vrhs = <0x12>;
            vdvs = <0x20>;
            mdac = <0x00>;
            gamma = <0x01>;
            colmod = <0x05>;
            lcm = <0x2c>;
            porch-param = [0c 0c 00 33 33];
            cmd2en-param = [5a 69 02 01];
            pwctrl1-param = [a4 a1];
            pvgam-param = [D0 04 0D 11 13 2B 3F 54 4C 18 0D 0B 1F 23];
            nvgam-param = [D0 04 0C 11 13 2C 3F 44 51 2F 1F 1F 20 23];
            ram-param = [00 F0];
            rgb-param = [CD 08 14];
        };
    };
};

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

Kazi Afroza Sultana — Tue, 27 May 2025 14:37:16 GMT

Hello Nanag,

Please send me the overlay file.

BR
Kazi

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

nanangcreacoll — Thu, 22 May 2025 09:38:06 GMT

Already added those files, still nothing on the display.

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

Kazi Afroza Sultana — Thu, 22 May 2025 09:34:18 GMT

Hello,

Add these header files

#include <zephyr/dt-bindings/display/panel.h>
#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

nanangcreacoll — Thu, 22 May 2025 09:23:45 GMT

I am having the exact same issue with ST7789V, it works and can display when configured with SPI (NCS SDK 2.7.0), but cannot display when configured with MIPI DBI (NCS SDK 3.0.1). Does it need further configuration? I tried it with the display sample (sample/driver/display).

overaly:

/ {
	chosen {
		zephyr,display = &st7789v;
	};

	leds {
        compatible = "gpio-leds";
        lcd_backlight: lcd_backlight {
            gpios = <&gpio0 11 GPIO_ACTIVE_LOW>;
            label = "LCD Backlight";
        };
    };

    mipi_dbi {
        compatible = "zephyr,mipi-dbi-spi";
        status = "okay";
        reset-gpios = <&gpio0 27 GPIO_ACTIVE_LOW>;
        dc-gpios = <&gpio0 31 GPIO_ACTIVE_HIGH>;
        spi-dev = <&spi0>;
        write-only;
        #address-cells = <1>;
        #size-cells = <0>;

        st7789v: st7789v@0 {
            compatible = "sitronix,st7789v";
            status = "okay";
            reg = <0>;
            mipi-max-frequency = <DT_FREQ_M(8)>;
            mipi-mode = "MIPI_DBI_MODE_SPI_4WIRE";
            width = <240>;
            height = <240>;
            x-offset = <0>;
            y-offset = <0>;
            vcom = <0x19>;
            gctrl = <0x35>;
            vrhs = <0x12>;
            vdvs = <0x20>;
            mdac = <0x00>;
            gamma = <0x01>;
            colmod = <0x05>;
            lcm = <0x2c>;
            porch-param = [0c 0c 00 33 33];
            cmd2en-param = [5a 69 02 01];
            pwctrl1-param = [a4 a1];
            pvgam-param = [D0 04 0D 11 13 2B 3F 54 4C 18 0D 0B 1F 23];
            nvgam-param = [D0 04 0C 11 13 2C 3F 44 51 2F 1F 1F 20 23];
            ram-param = [00 F0];
            rgb-param = [CD 08 14];
        };
    };
};

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

bjornolsen — Thu, 27 Mar 2025 22:43:05 GMT

Yes. Thank you

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

Kazi Afroza Sultana — Wed, 26 Mar 2025 09:05:27 GMT

Great! so with these two

#include <zephyr/dt-bindings/display/panel.h>
#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>

header files and the overlay file I attached before solved the issue?

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

bjornolsen — Tue, 25 Mar 2025 14:53:42 GMT

OK I did a completely clean build. now it works 100% all good.

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

bjornolsen — Tue, 25 Mar 2025 14:43:05 GMT

Hello.

I get the same error.
But it resolved the issue with pixel-format which I could include.

here is the full overlay.

#include <zephyr/dt-bindings/display/panel.h>
#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>

/ {
    chosen {
        zephyr,display = &gc9a01;
    };

    mipi_dbi {
        compatible = "zephyr,mipi-dbi-spi";
        dc-gpios = <&gpio0 30 GPIO_ACTIVE_HIGH>;
        reset-gpios = <&gpio0 2 GPIO_ACTIVE_LOW>;
        spi-dev = <&spi3>;
        #address-cells = <1>;
        #size-cells = <0>;

        gc9a01: gc9a01@0 {
            status = "okay";
            compatible = "galaxycore,gc9x01x";
            reg = <0>;
            mipi-max-frequency = <100000000>;
            pixel-format = <PANEL_PIXEL_FORMAT_RGB_565>;
            width = <240>;
            height = <240>;
            display-inversion;
            orientation = "180"; // Set to rotate the display
        };
    };
};

&spi3_default {
	group1 {
		psels = <NRF_PSEL(SPIM_SCK, 0, 28)>,
				<NRF_PSEL(SPIM_MISO, 0, 4)>,
				<NRF_PSEL(SPIM_MOSI, 0, 29)>;
		nordic,drive-mode = <NRF_DRIVE_H0H1>;
	};
};

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

Kazi Afroza Sultana — Tue, 25 Mar 2025 13:58:37 GMT

Hello,

For the first error, it seems the PANEL_ was not defined. It should be in the devicetree file as header file

#include <zephyr/dt-bindings/display/panel.h>

Can you try this first and see if you get the second error?

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

bjornolsen — Tue, 25 Mar 2025 13:43:22 GMT

Hi Kazi,

Tried your code.

devicetree error:

nrf52840dk_nrf52840.overlay:37 (column 29): parse error: expected number or parenthesized expression

That is cause by "pixel-format = <PANEL_PIXEL_FORMAT_RGB_565>;"
If I remove that line and recompile

C:/Users/BjornOlsen/Documents/GitHub/nestlab/build/zephyr/include/generated/devicetree_generated.h:15794:50: error: 'DT_N_S_mipi_dbi_S_gc9a01_0_P_width' undeclared here (not in a function); did you mean 'DT_N_S_mipi_dbi_S_gc9a01_0_P_reg'?
15794 | #define DT_CHOSEN_zephyr_display DT_N_S_mipi_dbi_S_gc9a01_0

so now it seems to complain about width.

I feel I am getting closer, but not quite there yet.

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

Kazi Afroza Sultana — Tue, 25 Mar 2025 11:55:35 GMT

Hello,

The error shows mipi_dbi is defined out of the root scope. You can try to add this inside the root.

#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>

/ {
    chosen {
        zephyr,display = &gc9a01;
    };

    mipi_dbi {
        compatible = "zephyr,mipi-dbi-spi";
        dc-gpios = <&gpio0 8 GPIO_ACTIVE_HIGH>;
        reset-gpios = <&gpio0 14 GPIO_ACTIVE_LOW>;
        spi-dev = <&spi0>;
        #address-cells = <1>;
        #size-cells = <0>;

        gc9a01: gc9a01@0 {
            status = "okay";
            compatible = "galaxycore,gc9x01x";
            reg = <0>;
            mipi-max-frequency = <100000000>;
            width = <240>;
            height = <240>;
            pixel-format = <PANEL_PIXEL_FORMAT_RGB_565>;
            display-inversion;
            orientation = "180"; // Set to rotate the display
        };
    };
};

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

bjornolsen — Sun, 23 Mar 2025 09:58:07 GMT

I am having the same issue. I think I am close...

for SDK 2.7 this works perfectly

#include <zephyr/dt-bindings/display/panel.h>

/ {
	chosen {
		zephyr,display = &gs91010;
	};
};


 
&spi3 {
	status = "okay";

	gs91010: gc9x01x@0 {
		compatible = "galaxycore,gc9x01x";
		reg = <0>;
		spi-max-frequency = <100000000>;
		width = <240>;
		height = <240>;
		pixel-format = <PANEL_PIXEL_FORMAT_RGB_565>;
		cmd-data-gpios = <&gpio0 30 GPIO_ACTIVE_HIGH>;	
		reset-gpios = <&gpio0 2 GPIO_ACTIVE_LOW>;
		display-inversion; 
		orientation = "180"; // Set to rotate the display
		// gamma settings can be added if needed
	};

	cs-gpios = <&gpio0 31 GPIO_ACTIVE_LOW>;
};

&spi3_default {
	group1 {
		psels = <NRF_PSEL(SPIM_SCK, 0, 28)>,
				<NRF_PSEL(SPIM_MISO, 0, 4)>,
				<NRF_PSEL(SPIM_MOSI, 0, 29)>;
		nordic,drive-mode = <NRF_DRIVE_H0H1>;
	};
};

Now when switching to SDK 2.9

#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>

/ {
	chosen {
		zephyr,display = &gs91010;
	};
};

mipi_dbi {
    compatible = "zephyr,mipi-dbi-spi";
    dc-gpios = <&gpio0 8 GPIO_ACTIVE_HIGH>;
    reset-gpios = <&gpio0 14 GPIO_ACTIVE_LOW>;
    spi-dev = <&spi0>;
    #address-cells = <1>;
    #size-cells = <0>;

    gc9a01: gc9a01@0 {
        status = "okay";
        compatible = "galaxycore,gc9x01x";
        reg = <0>;
        mipi-max-frequency = <100000000>;
        width = <240>;
		height = <240>;
		pixel-format = <PANEL_PIXEL_FORMAT_RGB_565>;
		cmd-data-gpios = <&gpio0 30 GPIO_ACTIVE_HIGH>;	
		reset-gpios = <&gpio0 2 GPIO_ACTIVE_LOW>;
		display-inversion; 
		orientation = "180"; // Set to rotate the display
    };
};

But I get errors such as
"Node mipi_dbi defined outside of root scope. Only reference nodes and the root node itself are allowed

mipi_dbi/" "devicetree error: ./nrf52840dk_nrf52840.overlay:23 (column 1): parse error: expected '/' or label reference (&foo) CMake Error at C:/ncs/v2.9.0/zephyr/cmake/modules/dts.cmake:295 (execute_process):" I have read the various update guidelines, but that does not help me solve this problem

RE: Inquiry on ST7789V MIPI-DBI Driver Configuration in NCS 2.9.0

Kazi Afroza Sultana — Tue, 04 Feb 2025 13:40:20 GMT

Hello,

You can see this documentation (Migration guide to Zephyr v3.7.0) to know how to define MIPI-DBI device.

#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h> should be added in the MIPI_DBI bindings device tree.

/* Legacy GC9X01 display definition */
&spi0 {
    gc9a01: gc9a01@0 {
        status = "okay";
        compatible = "galaxycore,gc9x01x";
        reg = <0>;
        spi-max-frequency = <100000000>;
        cmd-data-gpios = <&gpio0 8 GPIO_ACTIVE_HIGH>;
        reset-gpios = <&gpio0 14 GPIO_ACTIVE_LOW>;
        ...
    };
};

/* New display definition with MIPI DBI device */

#include <zephyr/dt-bindings/mipi_dbi/mipi_dbi.h>

...

mipi_dbi {
    compatible = "zephyr,mipi-dbi-spi";
    dc-gpios = <&gpio0 8 GPIO_ACTIVE_HIGH>;
    reset-gpios = <&gpio0 14 GPIO_ACTIVE_LOW>;
    spi-dev = <&spi0>;
    #address-cells = <1>;
    #size-cells = <0>;

    gc9a01: gc9a01@0 {
        status = "okay";
        compatible = "galaxycore,gc9x01x";
        reg = <0>;
        mipi-max-frequency = <100000000>;
        ...
    };
};