Skip to contentSkip to conversation

Add ilitek ili9341 panel driver

PATCH Superseded [email protected] 5 participants 19 messages Jul 21, 2021 – Jul 22, 2021

Subsystems (5)

v2 of 4 Superseded Latest is v4 →

lore
Share & tools
lore
#0 lore raw

v2 cover Add ilitek ili9341 panel driver

From: Dillon Min <[email protected]>

Since the st,sf-tc240t-9370-t dts binding already exist in stm32f429-disco.dts but, the panel driver didn't get accepted from mainline. it's time to submit patch fot it.

This driver can support two different interface by different dts bindings:
- spi+dpi, use spi to configure register, dpi for graphic data. st,sf-tc240t-9370-t
- only spi, just like tiny/ili9341.c (actually, this part is copy from tiny) adafruit,yx240qv29

I submited the first patch last year, you can find it at [1]. this patch has one major difference from that one, which is replace the low level communication way, from spi_sync() to mipi_dbi_{command, command_stackbuf}() interface, referred from Linus's patch [2].

both the two dpi/dbi interface was tested on stm32f429-disco board, if anyone want to verify this patch, you need apply the clk patch for this board first, you can get it from [3]

[1] "drm/panel: Add ilitek ili9341 panel driver"
https://lore.kernel.org/lkml/[email protected]/

[2] "drm/panel: s6e63m0: Switch to DBI abstraction for SPI"
https://lore.kernel.org/dri-devel/[email protected]/

[3]
https://lore.kernel.org/lkml/[email protected]/

v2:
- replace vcc regulator to bulk regulators in driver, from linus suggestion.
- fix dtbs_check warnings on ili9341 dts binding check.
- add bulk regulation node in ilitek,ili9341.yaml.
v1 link:
https://lore.kernel.org/lkml/[email protected]/

Dillon Min (3):
dt-bindings: display: panel: Add ilitek ili9341 panel bindings
ARM: dts: stm32: fix dtbs_check warning on ili9341 dts binding drm/panel: Add ilitek ili9341 panel driver

 .../bindings/display/panel/ilitek,ili9341.yaml     |  78 +++
 arch/arm/boot/dts/stm32f429-disco.dts              |   2 +-
 drivers/gpu/drm/panel/Kconfig                      |  12 +
 drivers/gpu/drm/panel/Makefile                     |   1 +
 drivers/gpu/drm/panel/panel-ilitek-ili9341.c       | 778 +++++++++++++++++++++
 5 files changed, 870 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/devicetree/bindings/display/panel/ilitek,ili9341.yaml
 create mode 100644 drivers/gpu/drm/panel/panel-ilitek-ili9341.c
Signature · 1 line
2.7.4
#1 lore raw

PATCH v2 1/3 dt-bindings: display: panel: Add ilitek ili9341 panel bindings

From: Dillon Min <[email protected]>

Add documentation for "ilitek,ili9341" panel.

---
changes in v2:
- add {vci, vddi, vddi-led}-supply bulk regulator according to linus suggestion, thanks.
- add DBI panel in D/CX description.

 .../bindings/display/panel/ilitek,ili9341.yaml     | 78 ++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/display/panel/ilitek,ili9341.yaml
Documentation/devicetree/bindings/display/panel/ilitek,ili9341.yaml new file +78 -0
new file mode 100644
index 000000000000..2ed010f91e2d
@@ -0,0 +1,78 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/display/panel/ilitek,ili9341.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Ilitek-9341 Display Panel
+
+maintainers:
+  - Dillon Min <[email protected]>
+
+description: |
+  Ilitek ILI9341 TFT panel driver with SPI control bus
+  This is a driver for 320x240 TFT panels, accepting a rgb input
+  streams with 16 bits or 18 bits.
+
+allOf:
+  - $ref: panel-common.yaml#
+
+properties:
+  compatible:
+    items:
+      - enum:
+          # ili9341 240*320 Color on stm32f429-disco board
+        - st,sf-tc240t-9370-t
+      - const: ilitek,ili9341
+
+  reg: true
+
+  dc-gpios:
+    maxItems: 1
+    description: Display data/command selection (D/CX) of this DBI panel
+
+  spi-3wire: true
+
+  spi-max-frequency:
+    const: 10000000
+
+  port: true
+
+  vci-supply:
+    description: Analog voltage supply (2.5 .. 3.3V)
+
+  vddi-supply:
+    description: Voltage supply for interface logic (1.65 .. 3.3 V)
+
+  vddi-led-supply:
+    description: Voltage supply for the LED driver (1.65 .. 3.3 V)
+
+additionalProperties: false
+
+required:
+  - compatible
+  - reg
+  - dc-gpios
+  - port
+
+examples:
+  - |+
+    spi {
+        #address-cells = <1>;
+        #size-cells = <0>;
+        panel: display@0 {
+                 compatible = "st,sf-tc240t-9370-t",
+                              "ilitek,ili9341";
+                 reg = <0>;
+                 spi-3wire;
+                 spi-max-frequency = <10000000>;
+                 dc-gpios = <&gpiod 13 0>;
+                 port {
+                         panel_in: endpoint {
+                           remote-endpoint = <&display_out>;
+                      };
+                 };
+             };
+        };
+...
+
Signature · 1 line
2.7.4
Reviewed-by on v2 1/3
#2 lore raw

Re: [PATCH v2 1/3] dt-bindings: display: panel: Add ilitek ili9341 panel bindings

Quoted 7 lines · On Wed, Jul 21, 2021 at 9:41 AM <[email protected]> wrote:

From: Dillon Min <[email protected]>

Add documentation for "ilitek,ili9341" panel.

Yours,
Linus Walleij

#3 lore raw

Re: [PATCH v2 1/3] dt-bindings: display: panel: Add ilitek ili9341 panel bindings

Hi Linus,

Quoted 11 lines · Linus Walleij
Quoted 7 lines · On Wed, Jul 21, 2021 at 9:41 AM <[email protected]> wrote:

From: Dillon Min <[email protected]>

Add documentation for "ilitek,ili9341" panel.

will you take care to push the patches now you did the review?

Sam

#4 lore raw

Re: [PATCH v2 1/3] dt-bindings: display: panel: Add ilitek ili9341 panel bindings

Quoted 8 lines · Sam Ravnborg

Hi Linus,

Quoted 6 lines · Linus Walleij
Quoted 4 lines · On Wed, Jul 21, 2021 at 9:41 AM <[email protected]> wrote:

From: Dillon Min <[email protected]>

Add documentation for "ilitek,ili9341" panel.

Quoted 7 lines
Quoted 5 lines
Quoted 3 lines

will you take care to push the patches now you did the review?

Yes but uncertain about patch 2/3 which fixes a DTS file.

Normally that should go through the SoC tree. I'm fine with applying 1 & 3 but don't want to cause excess errors in schema validation so I'm a bit ambivalent.

I would prefer if patch 2 gets applied to the SoC tree and propagate all the way to linux-next before applying patch 1 & 3 but I understand that will take some time.

Yours,
Linus Walleij

#5 lore raw

PATCH v2 2/3 ARM: dts: stm32: fix dtbs_check warning on ili9341 dts binding

In reply to [email protected]

From: Dillon Min <[email protected]>

Since the compatible string defined from ilitek,ili9341.yaml is "st,sf-tc240t-9370-t", "ilitek,ili9341"

so, append "ilitek,ili9341" to avoid below dtbs_check warning.

arch/arm/boot/dts/stm32f429-disco.dt.yaml: display@1: compatible:
['st,sf-tc240t-9370-t'] is too short

---
 arch/arm/boot/dts/stm32f429-disco.dts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
arch/arm/boot/dts/stm32f429-disco.dts +1 -1
index 075ac57d0bf4..6435e099c632 100644
@@ -192,7 +192,7 @@
 
 	display: display@1{
 		/* Connect panel-ilitek-9341 to ltdc */
-		compatible = "st,sf-tc240t-9370-t";
+		compatible = "st,sf-tc240t-9370-t", "ilitek,ili9341";
 		reg = <1>;
 		spi-3wire;
 		spi-max-frequency = <10000000>;
Signature · 1 line
2.7.4
author
#6 lore raw

Re: [PATCH v2 2/3] ARM: dts: stm32: fix dtbs_check warning on ili9341 dts binding

Hi Alex,

I suppose you will going to review this patch, I forgot to add the Fixes tag in v2, just add it. I will submit v3 to add this tag in case necessary.

Thanks, Best Regards.
Dillon

Quoted 11 lines · On Wed, 21 Jul 2021 at 15:41, <[email protected]> wrote:

From: Dillon Min <[email protected]>

Since the compatible string defined from ilitek,ili9341.yaml is "st,sf-tc240t-9370-t", "ilitek,ili9341"

so, append "ilitek,ili9341" to avoid below dtbs_check warning.

arch/arm/boot/dts/stm32f429-disco.dt.yaml: display@1: compatible:
['st,sf-tc240t-9370-t'] is too short

It's should be a Fixes tag here.

Fixes a726e2f000ec ("ARM: dts: stm32: enable ltdc binding with

ili9341, gyro l3gd20 on stm32429-disco board")

Quoted 22 lines
---
 arch/arm/boot/dts/stm32f429-disco.dts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
arch/arm/boot/dts/stm32f429-disco.dts +1 -2
index 075ac57d0bf4..6435e099c632 100644
@@ -192,7 +192,7 @@
 
        display: display@1{
                /* Connect panel-ilitek-9341 to ltdc */
-               compatible = "st,sf-tc240t-9370-t";
+               compatible = "st,sf-tc240t-9370-t", "ilitek,ili9341";
                reg = <1>;
                spi-3wire;
                spi-max-frequency = <10000000>;
--

2.7.4

#7 lore raw

PATCH v2 3/3 drm/panel: Add ilitek ili9341 panel driver

In reply to [email protected]

From: Dillon Min <[email protected]>

This driver combine tiny/ili9341.c mipi_dbi_interface driver with mipi_dpi_interface driver, can support ili9341 with serial mode or parallel rgb interface mode by register configuration.

Cc Linus Walleij <[email protected]>

---
changes in v2:
- replace vcc regulator to three bulk regulators(vci, vddi, vddi-led) according to linus suggestion, thanks.

 drivers/gpu/drm/panel/Kconfig                |  12 +
 drivers/gpu/drm/panel/Makefile               |   1 +
 drivers/gpu/drm/panel/panel-ilitek-ili9341.c | 778 +++++++++++++++++++++++++++
 3 files changed, 791 insertions(+)
 create mode 100644 drivers/gpu/drm/panel/panel-ilitek-ili9341.c
drivers/gpu/drm/panel/Kconfig +12 -0
index ef87d92cdf49..eb34b8d1b19a 100644
@@ -124,6 +124,18 @@ config DRM_PANEL_ILITEK_IL9322
 	  Say Y here if you want to enable support for Ilitek IL9322
 	  QVGA (320x240) RGB, YUV and ITU-T BT.656 panels.
 
+config DRM_PANEL_ILITEK_ILI9341
+	tristate "Ilitek ILI9341 240x320 QVGA panels"
+	depends on OF && SPI
+	depends on DRM_KMS_HELPER
+	depends on DRM_KMS_CMA_HELPER
+	depends on BACKLIGHT_CLASS_DEVICE
+	select DRM_MIPI_DBI
+	help
+	  Say Y here if you want to enable support for Ilitek IL9341
+	  QVGA (240x320) RGB panels. support serial & parallel rgb
+	  interface.
+
 config DRM_PANEL_ILITEK_ILI9881C
 	tristate "Ilitek ILI9881C-based panels"
 	depends on OF
drivers/gpu/drm/panel/Makefile +1 -0
index cae4d976c069..0ecde184665d 100644
@@ -11,6 +11,7 @@ obj-$(CONFIG_DRM_PANEL_ELIDA_KD35T133) += panel-elida-kd35t133.o
 obj-$(CONFIG_DRM_PANEL_FEIXIN_K101_IM2BA02) += panel-feixin-k101-im2ba02.o
 obj-$(CONFIG_DRM_PANEL_FEIYANG_FY07024DI26A30D) += panel-feiyang-fy07024di26a30d.o
 obj-$(CONFIG_DRM_PANEL_ILITEK_IL9322) += panel-ilitek-ili9322.o
+obj-$(CONFIG_DRM_PANEL_ILITEK_ILI9341) += panel-ilitek-ili9341.o
 obj-$(CONFIG_DRM_PANEL_ILITEK_ILI9881C) += panel-ilitek-ili9881c.o
 obj-$(CONFIG_DRM_PANEL_INNOLUX_P079ZCA) += panel-innolux-p079zca.o
 obj-$(CONFIG_DRM_PANEL_JDI_LT070ME05000) += panel-jdi-lt070me05000.o
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +778 -0

778 lines not on this page · raw message

Signature · 1 line
2.7.4
Reviewed-by on v2 3/3
#8 lore raw

Re: [PATCH v2 3/3] drm/panel: Add ilitek ili9341 panel driver

Quoted 6 lines · On Wed, Jul 21, 2021 at 9:41 AM <[email protected]> wrote:

From: Dillon Min <[email protected]>

This driver combine tiny/ili9341.c mipi_dbi_interface driver with mipi_dpi_interface driver, can support ili9341 with serial mode or parallel rgb interface mode by register configuration.

Quoted 6 lines
Cc Linus Walleij <[email protected]>

---
changes in v2:
- replace vcc regulator to three bulk regulators(vci, vddi, vddi-led) according to linus suggestion, thanks.

This is a really nice driver.

Yours,
Linus Walleij

author
#9 lore raw

Re: [PATCH v2 3/3] drm/panel: Add ilitek ili9341 panel driver

Quoted 9 lines · Linus Walleij
Quoted 6 lines · On Wed, Jul 21, 2021 at 9:41 AM <[email protected]> wrote:

From: Dillon Min <[email protected]>

This driver combine tiny/ili9341.c mipi_dbi_interface driver with mipi_dpi_interface driver, can support ili9341 with serial mode or parallel rgb interface mode by register configuration.

Quoted 8 lines
Quoted 6 lines
Cc Linus Walleij <[email protected]>

---
changes in v2:
- replace vcc regulator to three bulk regulators(vci, vddi, vddi-led) according to linus suggestion, thanks.

This is a really nice driver.

Thanks, all the code here is inspired by your recent patches. Really appreciate your time to help me.

Thanks & Regards
Dillon

Quoted 5 lines

Yours,
Linus Walleij

Reviewed-by on v2 3/3
#10 lore raw

Re: [PATCH v2 3/3] drm/panel: Add ilitek ili9341 panel driver

In reply to [email protected]
Quoted 657 lines · On Wed, Jul 21, 2021 at 1:11 PM <[email protected]> wrote:

From: Dillon Min <[email protected]>

This driver combine tiny/ili9341.c mipi_dbi_interface driver with mipi_dpi_interface driver, can support ili9341 with serial mode or parallel rgb interface mode by register configuration.

Cc Linus Walleij <[email protected]>

---
changes in v2:
- replace vcc regulator to three bulk regulators(vci, vddi, vddi-led) according to linus suggestion, thanks.

 drivers/gpu/drm/panel/Kconfig                |  12 +
 drivers/gpu/drm/panel/Makefile               |   1 +
 drivers/gpu/drm/panel/panel-ilitek-ili9341.c | 778 +++++++++++++++++++++++++++
 3 files changed, 791 insertions(+)
 create mode 100644 drivers/gpu/drm/panel/panel-ilitek-ili9341.c
drivers/gpu/drm/panel/Kconfig +12 -0
index ef87d92cdf49..eb34b8d1b19a 100644
@@ -124,6 +124,18 @@ config DRM_PANEL_ILITEK_IL9322
          Say Y here if you want to enable support for Ilitek IL9322
          QVGA (320x240) RGB, YUV and ITU-T BT.656 panels.
 
+config DRM_PANEL_ILITEK_ILI9341
+       tristate "Ilitek ILI9341 240x320 QVGA panels"
+       depends on OF && SPI
+       depends on DRM_KMS_HELPER
+       depends on DRM_KMS_CMA_HELPER
+       depends on BACKLIGHT_CLASS_DEVICE
+       select DRM_MIPI_DBI
+       help
+         Say Y here if you want to enable support for Ilitek IL9341
+         QVGA (240x320) RGB panels. support serial & parallel rgb
+         interface.
+
 config DRM_PANEL_ILITEK_ILI9881C
        tristate "Ilitek ILI9881C-based panels"
        depends on OF
drivers/gpu/drm/panel/Makefile +1 -0
index cae4d976c069..0ecde184665d 100644
@@ -11,6 +11,7 @@ obj-$(CONFIG_DRM_PANEL_ELIDA_KD35T133) += panel-elida-kd35t133.o
 obj-$(CONFIG_DRM_PANEL_FEIXIN_K101_IM2BA02) += panel-feixin-k101-im2ba02.o
 obj-$(CONFIG_DRM_PANEL_FEIYANG_FY07024DI26A30D) += panel-feiyang-fy07024di26a30d.o
 obj-$(CONFIG_DRM_PANEL_ILITEK_IL9322) += panel-ilitek-ili9322.o
+obj-$(CONFIG_DRM_PANEL_ILITEK_ILI9341) += panel-ilitek-ili9341.o
 obj-$(CONFIG_DRM_PANEL_ILITEK_ILI9881C) += panel-ilitek-ili9881c.o
 obj-$(CONFIG_DRM_PANEL_INNOLUX_P079ZCA) += panel-innolux-p079zca.o
 obj-$(CONFIG_DRM_PANEL_JDI_LT070ME05000) += panel-jdi-lt070me05000.o
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +596 -0
new file mode 100644
index 000000000000..717b0b930e2f
@@ -0,0 +1,778 @@
+// SPDX-License-Identifier: GPL-2.0-only
+/*
+ * Ilitek ILI9341 TFT LCD drm_panel driver.
+ *
+ * This panel can be configured to support:
+ * - 16-bit parallel RGB interface
+ * - 18-bit parallel RGB interface
+ * - 4-line serial spi interface
+ *
+ * Copyright (C) 2021 Dillon Min <[email protected]>
+ * Derived from drivers/drm/gpu/panel/panel-ilitek-ili9322.c
+ * the reuse of DBI abstraction part referred from Linus's patch
+ * "drm/panel: s6e63m0: Switch to DBI abstraction for SPI"
+ */
+
+#include <linux/bitops.h>
+#include <linux/gpio/consumer.h>
+#include <linux/module.h>
+#include <linux/of_device.h>
+#include <linux/regulator/consumer.h>
+#include <linux/spi/spi.h>
+#include <linux/delay.h>
+#include <video/mipi_display.h>
+#include <drm/drm_mipi_dbi.h>
+#include <drm/drm_gem_framebuffer_helper.h>
+#include <drm/drm_gem_cma_helper.h>
+#include <drm/drm_fb_helper.h>
+#include <drm/drm_atomic_helper.h>
+#include <drm/drm_gem_atomic_helper.h>
+
+#include <drm/drm_drv.h>
+#include <drm/drm_modes.h>
+#include <drm/drm_panel.h>
+#include <drm/drm_print.h>
+
+#define ILI9341_RGB_INTERFACE  0xb0   /* RGB Interface Signal Control */
+#define ILI9341_FRC            0xb1   /* Frame Rate Control register */
+#define ILI9341_DFC            0xb6   /* Display Function Control register */
+#define ILI9341_POWER1         0xc0   /* Power Control 1 register */
+#define ILI9341_POWER2         0xc1   /* Power Control 2 register */
+#define ILI9341_VCOM1          0xc5   /* VCOM Control 1 register */
+#define ILI9341_VCOM2          0xc7   /* VCOM Control 2 register */
+#define ILI9341_POWERA         0xcb   /* Power control A register */
+#define ILI9341_POWERB         0xcf   /* Power control B register */
+#define ILI9341_PGAMMA         0xe0   /* Positive Gamma Correction register */
+#define ILI9341_NGAMMA         0xe1   /* Negative Gamma Correction register */
+#define ILI9341_DTCA           0xe8   /* Driver timing control A */
+#define ILI9341_DTCB           0xea   /* Driver timing control B */
+#define ILI9341_POWER_SEQ      0xed   /* Power on sequence register */
+#define ILI9341_3GAMMA_EN      0xf2   /* 3 Gamma enable register */
+#define ILI9341_INTERFACE      0xf6   /* Interface control register */
+#define ILI9341_PRC            0xf7   /* Pump ratio control register */
+#define ILI9341_ETMOD         0xb7   /* Entry mode set */
+
+#define ILI9341_MADCTL_BGR     BIT(3)
+#define ILI9341_MADCTL_MV      BIT(5)
+#define ILI9341_MADCTL_MX      BIT(6)
+#define ILI9341_MADCTL_MY      BIT(7)
+
+#define ILI9341_POWER_B_LEN    3
+#define ILI9341_POWER_SEQ_LEN  4
+#define ILI9341_DTCA_LEN       3
+#define ILI9341_DTCB_LEN       2
+#define ILI9341_POWER_A_LEN    5
+#define ILI9341_DFC_1_LEN      2
+#define ILI9341_FRC_LEN                2
+#define ILI9341_VCOM_1_LEN     2
+#define ILI9341_DFC_2_LEN      4
+#define ILI9341_COLUMN_ADDR_LEN        4
+#define ILI9341_PAGE_ADDR_LEN  4
+#define ILI9341_INTERFACE_LEN  3
+#define ILI9341_PGAMMA_LEN     15
+#define ILI9341_NGAMMA_LEN     15
+#define ILI9341_CA_LEN         3
+
+#define ILI9341_PIXEL_DPI_16_BITS      (BIT(6) | BIT(4))
+#define ILI9341_PIXEL_DPI_18_BITS      (BIT(6) | BIT(5))
+#define ILI9341_GAMMA_CURVE_1          BIT(0)
+#define ILI9341_IF_WE_MODE             BIT(0)
+#define ILI9341_IF_BIG_ENDIAN          0x00
+#define ILI9341_IF_DM_RGB              BIT(2)
+#define ILI9341_IF_DM_INTERNAL         0x00
+#define ILI9341_IF_DM_VSYNC            BIT(3)
+#define ILI9341_IF_RM_RGB              BIT(1)
+#define ILI9341_IF_RIM_RGB             0x00
+
+#define ILI9341_COLUMN_ADDR            0x00ef
+#define ILI9341_PAGE_ADDR              0x013f
+
+#define ILI9341_RGB_EPL                        BIT(0)
+#define ILI9341_RGB_DPL                        BIT(1)
+#define ILI9341_RGB_HSPL               BIT(2)
+#define ILI9341_RGB_VSPL               BIT(3)
+#define ILI9341_RGB_DE_MODE            BIT(6)
+#define ILI9341_RGB_DISP_PATH_MEM      BIT(7)
+
+#define ILI9341_DBI_VCOMH_4P6V         0x23
+#define ILI9341_DBI_PWR_2_DEFAULT      0x10
+#define ILI9341_DBI_PRC_NORMAL         0x20
+#define ILI9341_DBI_VCOM_1_VMH_4P25V   0x3e
+#define ILI9341_DBI_VCOM_1_VML_1P5V    0x28
+#define ILI9341_DBI_VCOM_2_DEC_58      0x86
+#define ILI9341_DBI_FRC_DIVA           0x00
+#define ILI9341_DBI_FRC_RTNA           0x1b
+#define ILI9341_DBI_EMS_GAS            BIT(0)
+#define ILI9341_DBI_EMS_DTS            BIT(1)
+#define ILI9341_DBI_EMS_GON            BIT(2)
+
+/**
+ * struct ili9341_config - the system specific ILI9341 configuration
+ * @max_spi_speed: 10000000
+ */
+struct ili9341_config {
+       u32 max_spi_speed;
+       /** @mode: the drm display mode */
+       const struct drm_display_mode mode;
+       /** @ca: TODO: need comments for this register */
+       u8 ca[ILI9341_CA_LEN];
+       /** @power_b: TODO: need comments for this register */
+       u8 power_b[ILI9341_POWER_B_LEN];
+       /** @power_seq: TODO: need comments for this register */
+       u8 power_seq[ILI9341_POWER_SEQ_LEN];
+       /** @dtca: TODO: need comments for this register */
+       u8 dtca[ILI9341_DTCA_LEN];
+       /** @dtcb: TODO: need comments for this register */
+       u8 dtcb[ILI9341_DTCB_LEN];
+       /** @power_a: TODO: need comments for this register */
+       u8 power_a[ILI9341_POWER_A_LEN];
+       /** @frc: Frame Rate Control (In Normal Mode/Full Colors) (B1h) */
+       u8 frc[ILI9341_FRC_LEN];
+       /** @prc: TODO: need comments for this register */
+       u8 prc;
+       /** @dfc_1: B6h DISCTRL (Display Function Control) */
+       u8 dfc_1[ILI9341_DFC_1_LEN];
+       /** @power_1: Power Control 1 (C0h) */
+       u8 power_1;
+       /** @power_2: Power Control 2 (C1h) */
+       u8 power_2;
+       /** @vcom_1: VCOM Control 1(C5h) */
+       u8 vcom_1[ILI9341_VCOM_1_LEN];
+       /** @vcom_2: VCOM Control 2(C7h) */
+       u8 vcom_2;
+       /** @address_mode: Memory Access Control (36h) */
+       u8 address_mode;
+       /** @g3amma_en: TODO: need comments for this register */
+       u8 g3amma_en;
+       /** @rgb_interface: RGB Interface Signal Control (B0h) */
+       u8 rgb_interface;
+       /** @dfc_2: refer to dfc_1 */
+       u8 dfc_2[ILI9341_DFC_2_LEN];
+       /** @column_addr: Column Address Set (2Ah) */
+       u8 column_addr[ILI9341_COLUMN_ADDR_LEN];
+       /** @page_addr: Page Address Set (2Bh) */
+       u8 page_addr[ILI9341_PAGE_ADDR_LEN];
+       /** @interface: Interface Control (F6h) */
+       u8 interface[ILI9341_INTERFACE_LEN];
+       /** @pixel_format: This command sets the pixel format for the RGB */
+       /* image data used by
+        */
+       u8 pixel_format;
+       /** @gamma_curve: This command is used to select the desired Gamma */
+       /* curve for the
+        */
+       u8 gamma_curve;
+       /** @pgamma: Positive Gamma Correction (E0h) */
+       u8 pgamma[ILI9341_PGAMMA_LEN];
+       /** @ngamma: Negative Gamma Correction (E1h) */
+       u8 ngamma[ILI9341_NGAMMA_LEN];
+};
+
+struct ili9341 {
+       struct device *dev;
+       const struct ili9341_config *conf;
+       struct drm_panel panel;
+       struct gpio_desc *reset_gpio;
+       struct gpio_desc *dc_gpio;
+       struct mipi_dbi *dbi;
+       u32 max_spi_speed;
+       struct regulator_bulk_data supplies[3];
+};
+
+/*
+ * The Stm32f429-disco board has a panel ili9341 connected to ltdc controller
+ */
+static const struct ili9341_config ili9341_stm32f429_disco_data = {
+       .max_spi_speed = 10000000,
+       .mode = {
+               .clock = 6100,
+               .hdisplay = 240,
+               .hsync_start = 240 + 10,/* hfp 10 */
+               .hsync_end = 240 + 10 + 10,/* hsync 10 */
+               .htotal = 240 + 10 + 10 + 20,/* hbp 20 */
+               .vdisplay = 320,
+               .vsync_start = 320 + 4,/* vfp 4 */
+               .vsync_end = 320 + 4 + 2,/* vsync 2 */
+               .vtotal = 320 + 4 + 2 + 2,/* vbp 2 */
+               .flags = 0,
+               .width_mm = 65,
+               .height_mm = 50,
+               .type = DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED,
+       },
+       .ca = {0xc3, 0x08, 0x50},
+       .power_b = {0x00, 0xc1, 0x30},
+       .power_seq = {0x64, 0x03, 0x12, 0x81},
+       .dtca = {0x85, 0x00, 0x78},
+       .power_a = {0x39, 0x2c, 0x00, 0x34, 0x02},
+       .prc = 0x20,
+       .dtcb = {0x00, 0x00},
+       /* 0x00 fosc, 0x1b 70hz */
+       .frc = {0x00, 0x1b},
+       /* 0x0a Interval scan, AGND AGND AGND AGND
+        * 0xa2 Normally white, G1 -> G320, S720 -> S1,
+        *      Scan Cycle 5 frames,85ms
+        */
+       .dfc_1 = {0x0a, 0xa2},
+       /* 0x10 3.65v */
+       .power_1 = 0x10,
+       /* 0x10 AVDD=vci*2, VGH=vci*7, VGL=-vci*4 */
+       .power_2 = 0x10,
+       /* 0x45 VCOMH 4.425v, 0x15 VCOML -1.975*/
+       .vcom_1 = {0x45, 0x15},
+       /* 0x90 offset voltage, VMH-48, VML-48 */
+       .vcom_2 = 0x90,
+       /* 0xc8 Row Address Order, Column Address Order
+        * BGR 1
+        */
+       .address_mode = 0xc8,
+       .g3amma_en = 0x00,
+       /* 0xc2
+        * Display Data Path: Memory
+        * RGB: DE mode
+        * DOTCLK polarity set (data fetched at the falling time)
+        */
+       .rgb_interface = ILI9341_RGB_DISP_PATH_MEM |
+                       ILI9341_RGB_DE_MODE |
+                       ILI9341_RGB_DPL,
+       /*
+        * 0x0a
+        * Gate outputs in non-display area: Interval scan
+        * Determine source/VCOM output in a non-display area in the partial
+        * display mode: AGND AGND AGND AGND
+        *
+        * 0xa7
+        * Scan Cycle: 15 frames
+        * fFLM = 60Hz: 255ms
+        * Liquid crystal type: Normally white
+        * Gate Output Scan Direction: G1 -> G320
+        * Source Output Scan Direction: S720 -> S1
+        *
+        * 0x27
+        * LCD Driver Line: 320 lines
+        *
+        * 0x04
+        * PCDIV: 4
+        */
+       .dfc_2 = {0x0a, 0xa7, 0x27, 0x04},
+       /* column address: 240 */
+       .column_addr = {0x00, 0x00, (ILI9341_COLUMN_ADDR >> 4) & 0xff,
+                               ILI9341_COLUMN_ADDR & 0xff},
+       /* page address: 320 */
+       .page_addr = {0x00, 0x00, (ILI9341_PAGE_ADDR >> 4) & 0xff,
+                               ILI9341_PAGE_ADDR & 0xff},
+       /* Memory write control: When the transfer number of data exceeds
+        * (EC-SC+1)*(EP-SP+1), the column and page number will be
+        * reset, and the exceeding data will be written into the following
+        * column and page.
+        * Display Operation Mode: RGB Interface Mode
+        * Interface for RAM Access: RGB interface
+        * 16- bit RGB interface (1 transfer/pixel)
+        */
+       .interface = {ILI9341_IF_WE_MODE, 0x00,
+                       ILI9341_IF_DM_RGB | ILI9341_IF_RM_RGB},
+       /* DPI: 16 bits / pixel */
+       .pixel_format = ILI9341_PIXEL_DPI_16_BITS,
+       /* Curve Selected: Gamma curve 1 (G2.2) */
+       .gamma_curve = ILI9341_GAMMA_CURVE_1,
+       .pgamma = {0x0f, 0x29, 0x24, 0x0c, 0x0e,
+                       0x09, 0x4e, 0x78, 0x3c, 0x09,
+                       0x13, 0x05, 0x17, 0x11, 0x00},
+       .ngamma = {0x00, 0x16, 0x1b, 0x04, 0x11,
+                       0x07, 0x31, 0x33, 0x42, 0x05,
+                       0x0c, 0x0a, 0x28, 0x2f, 0x0f},
+};
+
+static inline struct ili9341 *panel_to_ili9341(struct drm_panel *panel)
+{
+       return container_of(panel, struct ili9341, panel);
+}
+
+static void ili9341_dpi_init(struct ili9341 *ili)
+{
+       struct mipi_dbi *dbi = ili->dbi;
+       struct ili9341_config *cfg = (struct ili9341_config *)ili->conf;
+
+       /* Power Control */
+       mipi_dbi_command_stackbuf(dbi, 0xca, cfg->ca, ILI9341_CA_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_POWERB, cfg->power_b,
+                                 ILI9341_POWER_B_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_POWER_SEQ, cfg->power_seq,
+                                 ILI9341_POWER_SEQ_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_DTCA, cfg->dtca,
+                                 ILI9341_DTCA_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_POWERA, cfg->power_a,
+                                 ILI9341_POWER_A_LEN);
+       mipi_dbi_command(ili->dbi, ILI9341_PRC, cfg->prc);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_DTCB, cfg->dtcb,
+                                 ILI9341_DTCB_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_FRC, cfg->frc, ILI9341_FRC_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_DFC, cfg->dfc_1,
+                                 ILI9341_DFC_1_LEN);
+       mipi_dbi_command(dbi, ILI9341_POWER1, cfg->power_1);
+       mipi_dbi_command(dbi, ILI9341_POWER2, cfg->power_2);
+
+       /* VCOM */
+       mipi_dbi_command_stackbuf(dbi, ILI9341_VCOM1, cfg->vcom_1,
+                                 ILI9341_VCOM_1_LEN);
+       mipi_dbi_command(dbi, ILI9341_VCOM2, cfg->vcom_2);
+       mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, cfg->address_mode);
+
+       /* Gamma */
+       mipi_dbi_command(dbi, ILI9341_3GAMMA_EN, cfg->g3amma_en);
+       mipi_dbi_command(dbi, ILI9341_RGB_INTERFACE, cfg->rgb_interface);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_DFC, cfg->dfc_2,
+                                 ILI9341_DFC_2_LEN);
+
+       /* Colomn address set */
+       mipi_dbi_command_stackbuf(dbi, MIPI_DCS_SET_COLUMN_ADDRESS,
+                                 cfg->column_addr, ILI9341_COLUMN_ADDR_LEN);
+
+       /* Page address set */
+       mipi_dbi_command_stackbuf(dbi, MIPI_DCS_SET_PAGE_ADDRESS,
+                                 cfg->page_addr, ILI9341_PAGE_ADDR_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_INTERFACE, cfg->interface,
+                                 ILI9341_INTERFACE_LEN);
+
+       /* Format */
+       mipi_dbi_command(dbi, MIPI_DCS_SET_PIXEL_FORMAT, cfg->pixel_format);
+       mipi_dbi_command(dbi, MIPI_DCS_WRITE_MEMORY_START);
+       msleep(200);
+       mipi_dbi_command(dbi, MIPI_DCS_SET_GAMMA_CURVE, cfg->gamma_curve);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_PGAMMA, cfg->pgamma,
+                                 ILI9341_PGAMMA_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_NGAMMA, cfg->ngamma,
+                                 ILI9341_NGAMMA_LEN);
+       mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE);
+       msleep(200);
+       mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON);
+       mipi_dbi_command(dbi, MIPI_DCS_WRITE_MEMORY_START);
+
+       dev_info(ili->dev, "initialized display rgb interface\n");
+}
+
+static int ili9341_dpi_power_on(struct ili9341 *ili)
+{
+       int ret = 0;
+
+       /* Assert RESET */
+       gpiod_set_value(ili->reset_gpio, 1);
+
+       /* Enable power */
+       ret = regulator_bulk_enable(ARRAY_SIZE(ili->supplies),
+                                   ili->supplies);
+       if (ret < 0) {
+               dev_err(ili->dev, "unable to enable vcc\n");
+               return ret;
+       }
+       msleep(20);
+
+       /* De-assert RESET */
+       gpiod_set_value(ili->reset_gpio, 0);
+       msleep(20);
+
+       return 0;
+}
+
+static int ili9341_dpi_power_off(struct ili9341 *ili)
+{
+       /* Assert RESET */
+       gpiod_set_value(ili->reset_gpio, 1);
+
+       /* Disable power */
+       return regulator_bulk_disable(ARRAY_SIZE(ili->supplies),
+                                     ili->supplies);
+}
+
+static int ili9341_dpi_disable(struct drm_panel *panel)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+
+       mipi_dbi_command(ili->dbi, MIPI_DCS_SET_DISPLAY_OFF);
+       return 0;
+}
+
+static int ili9341_dpi_unprepare(struct drm_panel *panel)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+
+       return ili9341_dpi_power_off(ili);
+}
+
+static int ili9341_dpi_prepare(struct drm_panel *panel)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+       int ret;
+
+       ret = ili9341_dpi_power_on(ili);
+       if (ret < 0)
+               return ret;
+
+       ili9341_dpi_init(ili);
+
+       return ret;
+}
+
+static int ili9341_dpi_enable(struct drm_panel *panel)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+
+       mipi_dbi_command(ili->dbi, MIPI_DCS_SET_DISPLAY_ON);
+       return 0;
+}
+
+static int ili9341_dpi_get_modes(struct drm_panel *panel,
+                                struct drm_connector *connector)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+       struct drm_device *drm = connector->dev;
+       struct drm_display_mode *mode;
+       struct drm_display_info *info;
+
+       info = &connector->display_info;
+       info->width_mm = ili->conf->mode.width_mm;
+       info->height_mm = ili->conf->mode.height_mm;
+
+       if (ili->conf->rgb_interface & ILI9341_RGB_DPL)
+               info->bus_flags |= DRM_BUS_FLAG_PIXDATA_DRIVE_POSEDGE;
+       else
+               info->bus_flags |= DRM_BUS_FLAG_PIXDATA_DRIVE_NEGEDGE;
+
+       if (ili->conf->rgb_interface & ILI9341_RGB_EPL)
+               info->bus_flags |= DRM_BUS_FLAG_DE_LOW;
+       else
+               info->bus_flags |= DRM_BUS_FLAG_DE_HIGH;
+
+       mode = drm_mode_duplicate(drm, &ili->conf->mode);
+       if (!mode) {
+               DRM_ERROR("bad mode or failed to add mode\n");
+               return -EINVAL;
+       }
+       drm_mode_set_name(mode);
+
+       /* Set up the polarity */
+       if (ili->conf->rgb_interface & ILI9341_RGB_HSPL)
+               mode->flags |= DRM_MODE_FLAG_PHSYNC;
+       else
+               mode->flags |= DRM_MODE_FLAG_NHSYNC;
+
+       if (ili->conf->rgb_interface & ILI9341_RGB_VSPL)
+               mode->flags |= DRM_MODE_FLAG_PVSYNC;
+       else
+               mode->flags |= DRM_MODE_FLAG_NVSYNC;
+
+       drm_mode_probed_add(connector, mode);
+
+       return 1; /* Number of modes */
+}
+
+static const struct drm_panel_funcs ili9341_dpi_funcs = {
+       .disable = ili9341_dpi_disable,
+       .unprepare = ili9341_dpi_unprepare,
+       .prepare = ili9341_dpi_prepare,
+       .enable = ili9341_dpi_enable,
+       .get_modes = ili9341_dpi_get_modes,
+};
+
+static void ili9341_dbi_enable(struct drm_simple_display_pipe *pipe,
+                              struct drm_crtc_state *crtc_state,
+                              struct drm_plane_state *plane_state)
+{
+       struct mipi_dbi_dev *dbidev = drm_to_mipi_dbi_dev(pipe->crtc.dev);
+       struct mipi_dbi *dbi = &dbidev->dbi;
+       u8 addr_mode;
+       int ret, idx;
+
+       if (!drm_dev_enter(pipe->crtc.dev, &idx))
+               return;
+
+       DRM_DEBUG_KMS("\n");
+
+       ret = mipi_dbi_poweron_conditional_reset(dbidev);
+       if (ret < 0)
+               goto out_exit;
+       if (ret == 1)
+               goto out_enable;
+
+       mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_OFF);
+
+       mipi_dbi_command(dbi, ILI9341_POWERB, 0x00, 0xc1, 0x30);
+       mipi_dbi_command(dbi, ILI9341_POWER_SEQ, 0x64, 0x03, 0x12, 0x81);
+       mipi_dbi_command(dbi, ILI9341_DTCA, 0x85, 0x00, 0x78);
+       mipi_dbi_command(dbi, ILI9341_POWERA, 0x39, 0x2c, 0x00, 0x34, 0x02);
+       mipi_dbi_command(dbi, ILI9341_PRC, ILI9341_DBI_PRC_NORMAL);
+       mipi_dbi_command(dbi, ILI9341_DTCB, 0x00, 0x00);
+
+       /* Power Control */
+       mipi_dbi_command(dbi, ILI9341_POWER1, ILI9341_DBI_VCOMH_4P6V);
+       mipi_dbi_command(dbi, ILI9341_POWER2, ILI9341_DBI_PWR_2_DEFAULT);
+       /* VCOM */
+       mipi_dbi_command(dbi, ILI9341_VCOM1, ILI9341_DBI_VCOM_1_VMH_4P25V,
+                        ILI9341_DBI_VCOM_1_VML_1P5V);
+       mipi_dbi_command(dbi, ILI9341_VCOM2, ILI9341_DBI_VCOM_2_DEC_58);
+
+       /* Memory Access Control */
+       mipi_dbi_command(dbi, MIPI_DCS_SET_PIXEL_FORMAT,
+                        MIPI_DCS_PIXEL_FMT_16BIT);
+
+       /* Frame Rate */
+       mipi_dbi_command(dbi, ILI9341_FRC, ILI9341_DBI_FRC_DIVA & 0x03,
+                        ILI9341_DBI_FRC_RTNA & 0x1f);
+
+       /* Gamma */
+       mipi_dbi_command(dbi, ILI9341_3GAMMA_EN, 0x00);
+       mipi_dbi_command(dbi, MIPI_DCS_SET_GAMMA_CURVE, ILI9341_GAMMA_CURVE_1);
+       mipi_dbi_command(dbi, ILI9341_PGAMMA,
+                        0x0f, 0x31, 0x2b, 0x0c, 0x0e, 0x08, 0x4e, 0xf1,
+                        0x37, 0x07, 0x10, 0x03, 0x0e, 0x09, 0x00);
+       mipi_dbi_command(dbi, ILI9341_NGAMMA,
+                        0x00, 0x0e, 0x14, 0x03, 0x11, 0x07, 0x31, 0xc1,
+                        0x48, 0x08, 0x0f, 0x0c, 0x31, 0x36, 0x0f);
+
+       /* DDRAM */
+       mipi_dbi_command(dbi, ILI9341_ETMOD, ILI9341_DBI_EMS_GAS |
+                        ILI9341_DBI_EMS_DTS |
+                        ILI9341_DBI_EMS_GON);
+
+       /* Display */
+       mipi_dbi_command(dbi, ILI9341_DFC, 0x08, 0x82, 0x27, 0x00);
+       mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE);
+       msleep(100);
+
+       mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON);
+       msleep(100);
+
+out_enable:
+       switch (dbidev->rotation) {
+       default:
+               addr_mode = ILI9341_MADCTL_MX;
+               break;
+       case 90:
+               addr_mode = ILI9341_MADCTL_MV;
+               break;
+       case 180:
+               addr_mode = ILI9341_MADCTL_MY;
+               break;
+       case 270:
+               addr_mode = ILI9341_MADCTL_MV | ILI9341_MADCTL_MY |
+                           ILI9341_MADCTL_MX;
+               break;
+       }
+       addr_mode |= ILI9341_MADCTL_BGR;
+       mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, addr_mode);
+       mipi_dbi_enable_flush(dbidev, crtc_state, plane_state);
+       DRM_DEBUG_KMS("initialized display serial interface\n");
+out_exit:
+       drm_dev_exit(idx);
+}
+
+static const struct drm_simple_display_pipe_funcs ili9341_dbi_funcs = {
+       .enable = ili9341_dbi_enable,
+       .disable = mipi_dbi_pipe_disable,
+       .update = mipi_dbi_pipe_update,
+       .prepare_fb = drm_gem_simple_display_pipe_prepare_fb,
+};
+
+static const struct drm_display_mode ili9341_dbi_mode = {
+       DRM_SIMPLE_MODE(240, 320, 37, 49),
+};
+
+DEFINE_DRM_GEM_CMA_FOPS(ili9341_dbi_fops);
+
+static struct drm_driver ili9341_dbi_driver = {
+       .driver_features        = DRIVER_GEM | DRIVER_MODESET | DRIVER_ATOMIC,
+       .fops                   = &ili9341_dbi_fops,
+       DRM_GEM_CMA_DRIVER_OPS_VMAP,
+       .debugfs_init           = mipi_dbi_debugfs_init,
+       .name                   = "ili9341",
+       .desc                   = "Ilitek ILI9341",
+       .date                   = "20210716",
+       .major                  = 1,
+       .minor                  = 0,
+};
+
+static int _ili9341_probe(struct spi_device *spi, bool dpi)
+{
+       struct gpio_desc *dc;
+       struct gpio_desc *reset;

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 606

Quoted 10 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +10 -0
+       struct device *dev = &spi->dev;
+       int ret;
+
+       reset = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_HIGH);
+       if (IS_ERR(reset))
+               DRM_DEV_ERROR(dev, "Failed to get gpio 'reset'\n");
+
+       dc = devm_gpiod_get_optional(dev, "dc", GPIOD_OUT_LOW);
+       if (IS_ERR(dc))
+               DRM_DEV_ERROR(dev, "Failed to get gpio 'dc'\n");

Small nit. Moving the above dts parse code into the main probe and have functions for dpi and !dpi would make code more readable.

Otherwise,

author
#11 lore raw

Re: [PATCH v2 3/3] drm/panel: Add ilitek ili9341 panel driver

Hi Jagan

Thanks for your time to review my code.

Quoted 664 lines · Jagan Teki
Quoted 662 lines · On Wed, Jul 21, 2021 at 1:11 PM <[email protected]> wrote:

From: Dillon Min <[email protected]>

This driver combine tiny/ili9341.c mipi_dbi_interface driver with mipi_dpi_interface driver, can support ili9341 with serial mode or parallel rgb interface mode by register configuration.

Cc Linus Walleij <[email protected]>

---
changes in v2:
- replace vcc regulator to three bulk regulators(vci, vddi, vddi-led) according to linus suggestion, thanks.

 drivers/gpu/drm/panel/Kconfig                |  12 +
 drivers/gpu/drm/panel/Makefile               |   1 +
 drivers/gpu/drm/panel/panel-ilitek-ili9341.c | 778 +++++++++++++++++++++++++++
 3 files changed, 791 insertions(+)
 create mode 100644 drivers/gpu/drm/panel/panel-ilitek-ili9341.c
drivers/gpu/drm/panel/Kconfig +12 -0
index ef87d92cdf49..eb34b8d1b19a 100644
@@ -124,6 +124,18 @@ config DRM_PANEL_ILITEK_IL9322
          Say Y here if you want to enable support for Ilitek IL9322
          QVGA (320x240) RGB, YUV and ITU-T BT.656 panels.
 
+config DRM_PANEL_ILITEK_ILI9341
+       tristate "Ilitek ILI9341 240x320 QVGA panels"
+       depends on OF && SPI
+       depends on DRM_KMS_HELPER
+       depends on DRM_KMS_CMA_HELPER
+       depends on BACKLIGHT_CLASS_DEVICE
+       select DRM_MIPI_DBI
+       help
+         Say Y here if you want to enable support for Ilitek IL9341
+         QVGA (240x320) RGB panels. support serial & parallel rgb
+         interface.
+
 config DRM_PANEL_ILITEK_ILI9881C
        tristate "Ilitek ILI9881C-based panels"
        depends on OF
drivers/gpu/drm/panel/Makefile +1 -0
index cae4d976c069..0ecde184665d 100644
@@ -11,6 +11,7 @@ obj-$(CONFIG_DRM_PANEL_ELIDA_KD35T133) += panel-elida-kd35t133.o
 obj-$(CONFIG_DRM_PANEL_FEIXIN_K101_IM2BA02) += panel-feixin-k101-im2ba02.o
 obj-$(CONFIG_DRM_PANEL_FEIYANG_FY07024DI26A30D) += panel-feiyang-fy07024di26a30d.o
 obj-$(CONFIG_DRM_PANEL_ILITEK_IL9322) += panel-ilitek-ili9322.o
+obj-$(CONFIG_DRM_PANEL_ILITEK_ILI9341) += panel-ilitek-ili9341.o
 obj-$(CONFIG_DRM_PANEL_ILITEK_ILI9881C) += panel-ilitek-ili9881c.o
 obj-$(CONFIG_DRM_PANEL_INNOLUX_P079ZCA) += panel-innolux-p079zca.o
 obj-$(CONFIG_DRM_PANEL_JDI_LT070ME05000) += panel-jdi-lt070me05000.o
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +601 -0
new file mode 100644
index 000000000000..717b0b930e2f
@@ -0,0 +1,778 @@
+// SPDX-License-Identifier: GPL-2.0-only
+/*
+ * Ilitek ILI9341 TFT LCD drm_panel driver.
+ *
+ * This panel can be configured to support:
+ * - 16-bit parallel RGB interface
+ * - 18-bit parallel RGB interface
+ * - 4-line serial spi interface
+ *
+ * Copyright (C) 2021 Dillon Min <[email protected]>
+ * Derived from drivers/drm/gpu/panel/panel-ilitek-ili9322.c
+ * the reuse of DBI abstraction part referred from Linus's patch
+ * "drm/panel: s6e63m0: Switch to DBI abstraction for SPI"
+ */
+
+#include <linux/bitops.h>
+#include <linux/gpio/consumer.h>
+#include <linux/module.h>
+#include <linux/of_device.h>
+#include <linux/regulator/consumer.h>
+#include <linux/spi/spi.h>
+#include <linux/delay.h>
+#include <video/mipi_display.h>
+#include <drm/drm_mipi_dbi.h>
+#include <drm/drm_gem_framebuffer_helper.h>
+#include <drm/drm_gem_cma_helper.h>
+#include <drm/drm_fb_helper.h>
+#include <drm/drm_atomic_helper.h>
+#include <drm/drm_gem_atomic_helper.h>
+
+#include <drm/drm_drv.h>
+#include <drm/drm_modes.h>
+#include <drm/drm_panel.h>
+#include <drm/drm_print.h>
+
+#define ILI9341_RGB_INTERFACE  0xb0   /* RGB Interface Signal Control */
+#define ILI9341_FRC            0xb1   /* Frame Rate Control register */
+#define ILI9341_DFC            0xb6   /* Display Function Control register */
+#define ILI9341_POWER1         0xc0   /* Power Control 1 register */
+#define ILI9341_POWER2         0xc1   /* Power Control 2 register */
+#define ILI9341_VCOM1          0xc5   /* VCOM Control 1 register */
+#define ILI9341_VCOM2          0xc7   /* VCOM Control 2 register */
+#define ILI9341_POWERA         0xcb   /* Power control A register */
+#define ILI9341_POWERB         0xcf   /* Power control B register */
+#define ILI9341_PGAMMA         0xe0   /* Positive Gamma Correction register */
+#define ILI9341_NGAMMA         0xe1   /* Negative Gamma Correction register */
+#define ILI9341_DTCA           0xe8   /* Driver timing control A */
+#define ILI9341_DTCB           0xea   /* Driver timing control B */
+#define ILI9341_POWER_SEQ      0xed   /* Power on sequence register */
+#define ILI9341_3GAMMA_EN      0xf2   /* 3 Gamma enable register */
+#define ILI9341_INTERFACE      0xf6   /* Interface control register */
+#define ILI9341_PRC            0xf7   /* Pump ratio control register */
+#define ILI9341_ETMOD         0xb7   /* Entry mode set */
+
+#define ILI9341_MADCTL_BGR     BIT(3)
+#define ILI9341_MADCTL_MV      BIT(5)
+#define ILI9341_MADCTL_MX      BIT(6)
+#define ILI9341_MADCTL_MY      BIT(7)
+
+#define ILI9341_POWER_B_LEN    3
+#define ILI9341_POWER_SEQ_LEN  4
+#define ILI9341_DTCA_LEN       3
+#define ILI9341_DTCB_LEN       2
+#define ILI9341_POWER_A_LEN    5
+#define ILI9341_DFC_1_LEN      2
+#define ILI9341_FRC_LEN                2
+#define ILI9341_VCOM_1_LEN     2
+#define ILI9341_DFC_2_LEN      4
+#define ILI9341_COLUMN_ADDR_LEN        4
+#define ILI9341_PAGE_ADDR_LEN  4
+#define ILI9341_INTERFACE_LEN  3
+#define ILI9341_PGAMMA_LEN     15
+#define ILI9341_NGAMMA_LEN     15
+#define ILI9341_CA_LEN         3
+
+#define ILI9341_PIXEL_DPI_16_BITS      (BIT(6) | BIT(4))
+#define ILI9341_PIXEL_DPI_18_BITS      (BIT(6) | BIT(5))
+#define ILI9341_GAMMA_CURVE_1          BIT(0)
+#define ILI9341_IF_WE_MODE             BIT(0)
+#define ILI9341_IF_BIG_ENDIAN          0x00
+#define ILI9341_IF_DM_RGB              BIT(2)
+#define ILI9341_IF_DM_INTERNAL         0x00
+#define ILI9341_IF_DM_VSYNC            BIT(3)
+#define ILI9341_IF_RM_RGB              BIT(1)
+#define ILI9341_IF_RIM_RGB             0x00
+
+#define ILI9341_COLUMN_ADDR            0x00ef
+#define ILI9341_PAGE_ADDR              0x013f
+
+#define ILI9341_RGB_EPL                        BIT(0)
+#define ILI9341_RGB_DPL                        BIT(1)
+#define ILI9341_RGB_HSPL               BIT(2)
+#define ILI9341_RGB_VSPL               BIT(3)
+#define ILI9341_RGB_DE_MODE            BIT(6)
+#define ILI9341_RGB_DISP_PATH_MEM      BIT(7)
+
+#define ILI9341_DBI_VCOMH_4P6V         0x23
+#define ILI9341_DBI_PWR_2_DEFAULT      0x10
+#define ILI9341_DBI_PRC_NORMAL         0x20
+#define ILI9341_DBI_VCOM_1_VMH_4P25V   0x3e
+#define ILI9341_DBI_VCOM_1_VML_1P5V    0x28
+#define ILI9341_DBI_VCOM_2_DEC_58      0x86
+#define ILI9341_DBI_FRC_DIVA           0x00
+#define ILI9341_DBI_FRC_RTNA           0x1b
+#define ILI9341_DBI_EMS_GAS            BIT(0)
+#define ILI9341_DBI_EMS_DTS            BIT(1)
+#define ILI9341_DBI_EMS_GON            BIT(2)
+
+/**
+ * struct ili9341_config - the system specific ILI9341 configuration
+ * @max_spi_speed: 10000000
+ */
+struct ili9341_config {
+       u32 max_spi_speed;
+       /** @mode: the drm display mode */
+       const struct drm_display_mode mode;
+       /** @ca: TODO: need comments for this register */
+       u8 ca[ILI9341_CA_LEN];
+       /** @power_b: TODO: need comments for this register */
+       u8 power_b[ILI9341_POWER_B_LEN];
+       /** @power_seq: TODO: need comments for this register */
+       u8 power_seq[ILI9341_POWER_SEQ_LEN];
+       /** @dtca: TODO: need comments for this register */
+       u8 dtca[ILI9341_DTCA_LEN];
+       /** @dtcb: TODO: need comments for this register */
+       u8 dtcb[ILI9341_DTCB_LEN];
+       /** @power_a: TODO: need comments for this register */
+       u8 power_a[ILI9341_POWER_A_LEN];
+       /** @frc: Frame Rate Control (In Normal Mode/Full Colors) (B1h) */
+       u8 frc[ILI9341_FRC_LEN];
+       /** @prc: TODO: need comments for this register */
+       u8 prc;
+       /** @dfc_1: B6h DISCTRL (Display Function Control) */
+       u8 dfc_1[ILI9341_DFC_1_LEN];
+       /** @power_1: Power Control 1 (C0h) */
+       u8 power_1;
+       /** @power_2: Power Control 2 (C1h) */
+       u8 power_2;
+       /** @vcom_1: VCOM Control 1(C5h) */
+       u8 vcom_1[ILI9341_VCOM_1_LEN];
+       /** @vcom_2: VCOM Control 2(C7h) */
+       u8 vcom_2;
+       /** @address_mode: Memory Access Control (36h) */
+       u8 address_mode;
+       /** @g3amma_en: TODO: need comments for this register */
+       u8 g3amma_en;
+       /** @rgb_interface: RGB Interface Signal Control (B0h) */
+       u8 rgb_interface;
+       /** @dfc_2: refer to dfc_1 */
+       u8 dfc_2[ILI9341_DFC_2_LEN];
+       /** @column_addr: Column Address Set (2Ah) */
+       u8 column_addr[ILI9341_COLUMN_ADDR_LEN];
+       /** @page_addr: Page Address Set (2Bh) */
+       u8 page_addr[ILI9341_PAGE_ADDR_LEN];
+       /** @interface: Interface Control (F6h) */
+       u8 interface[ILI9341_INTERFACE_LEN];
+       /** @pixel_format: This command sets the pixel format for the RGB */
+       /* image data used by
+        */
+       u8 pixel_format;
+       /** @gamma_curve: This command is used to select the desired Gamma */
+       /* curve for the
+        */
+       u8 gamma_curve;
+       /** @pgamma: Positive Gamma Correction (E0h) */
+       u8 pgamma[ILI9341_PGAMMA_LEN];
+       /** @ngamma: Negative Gamma Correction (E1h) */
+       u8 ngamma[ILI9341_NGAMMA_LEN];
+};
+
+struct ili9341 {
+       struct device *dev;
+       const struct ili9341_config *conf;
+       struct drm_panel panel;
+       struct gpio_desc *reset_gpio;
+       struct gpio_desc *dc_gpio;
+       struct mipi_dbi *dbi;
+       u32 max_spi_speed;
+       struct regulator_bulk_data supplies[3];
+};
+
+/*
+ * The Stm32f429-disco board has a panel ili9341 connected to ltdc controller
+ */
+static const struct ili9341_config ili9341_stm32f429_disco_data = {
+       .max_spi_speed = 10000000,
+       .mode = {
+               .clock = 6100,
+               .hdisplay = 240,
+               .hsync_start = 240 + 10,/* hfp 10 */
+               .hsync_end = 240 + 10 + 10,/* hsync 10 */
+               .htotal = 240 + 10 + 10 + 20,/* hbp 20 */
+               .vdisplay = 320,
+               .vsync_start = 320 + 4,/* vfp 4 */
+               .vsync_end = 320 + 4 + 2,/* vsync 2 */
+               .vtotal = 320 + 4 + 2 + 2,/* vbp 2 */
+               .flags = 0,
+               .width_mm = 65,
+               .height_mm = 50,
+               .type = DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED,
+       },
+       .ca = {0xc3, 0x08, 0x50},
+       .power_b = {0x00, 0xc1, 0x30},
+       .power_seq = {0x64, 0x03, 0x12, 0x81},
+       .dtca = {0x85, 0x00, 0x78},
+       .power_a = {0x39, 0x2c, 0x00, 0x34, 0x02},
+       .prc = 0x20,
+       .dtcb = {0x00, 0x00},
+       /* 0x00 fosc, 0x1b 70hz */
+       .frc = {0x00, 0x1b},
+       /* 0x0a Interval scan, AGND AGND AGND AGND
+        * 0xa2 Normally white, G1 -> G320, S720 -> S1,
+        *      Scan Cycle 5 frames,85ms
+        */
+       .dfc_1 = {0x0a, 0xa2},
+       /* 0x10 3.65v */
+       .power_1 = 0x10,
+       /* 0x10 AVDD=vci*2, VGH=vci*7, VGL=-vci*4 */
+       .power_2 = 0x10,
+       /* 0x45 VCOMH 4.425v, 0x15 VCOML -1.975*/
+       .vcom_1 = {0x45, 0x15},
+       /* 0x90 offset voltage, VMH-48, VML-48 */
+       .vcom_2 = 0x90,
+       /* 0xc8 Row Address Order, Column Address Order
+        * BGR 1
+        */
+       .address_mode = 0xc8,
+       .g3amma_en = 0x00,
+       /* 0xc2
+        * Display Data Path: Memory
+        * RGB: DE mode
+        * DOTCLK polarity set (data fetched at the falling time)
+        */
+       .rgb_interface = ILI9341_RGB_DISP_PATH_MEM |
+                       ILI9341_RGB_DE_MODE |
+                       ILI9341_RGB_DPL,
+       /*
+        * 0x0a
+        * Gate outputs in non-display area: Interval scan
+        * Determine source/VCOM output in a non-display area in the partial
+        * display mode: AGND AGND AGND AGND
+        *
+        * 0xa7
+        * Scan Cycle: 15 frames
+        * fFLM = 60Hz: 255ms
+        * Liquid crystal type: Normally white
+        * Gate Output Scan Direction: G1 -> G320
+        * Source Output Scan Direction: S720 -> S1
+        *
+        * 0x27
+        * LCD Driver Line: 320 lines
+        *
+        * 0x04
+        * PCDIV: 4
+        */
+       .dfc_2 = {0x0a, 0xa7, 0x27, 0x04},
+       /* column address: 240 */
+       .column_addr = {0x00, 0x00, (ILI9341_COLUMN_ADDR >> 4) & 0xff,
+                               ILI9341_COLUMN_ADDR & 0xff},
+       /* page address: 320 */
+       .page_addr = {0x00, 0x00, (ILI9341_PAGE_ADDR >> 4) & 0xff,
+                               ILI9341_PAGE_ADDR & 0xff},
+       /* Memory write control: When the transfer number of data exceeds
+        * (EC-SC+1)*(EP-SP+1), the column and page number will be
+        * reset, and the exceeding data will be written into the following
+        * column and page.
+        * Display Operation Mode: RGB Interface Mode
+        * Interface for RAM Access: RGB interface
+        * 16- bit RGB interface (1 transfer/pixel)
+        */
+       .interface = {ILI9341_IF_WE_MODE, 0x00,
+                       ILI9341_IF_DM_RGB | ILI9341_IF_RM_RGB},
+       /* DPI: 16 bits / pixel */
+       .pixel_format = ILI9341_PIXEL_DPI_16_BITS,
+       /* Curve Selected: Gamma curve 1 (G2.2) */
+       .gamma_curve = ILI9341_GAMMA_CURVE_1,
+       .pgamma = {0x0f, 0x29, 0x24, 0x0c, 0x0e,
+                       0x09, 0x4e, 0x78, 0x3c, 0x09,
+                       0x13, 0x05, 0x17, 0x11, 0x00},
+       .ngamma = {0x00, 0x16, 0x1b, 0x04, 0x11,
+                       0x07, 0x31, 0x33, 0x42, 0x05,
+                       0x0c, 0x0a, 0x28, 0x2f, 0x0f},
+};
+
+static inline struct ili9341 *panel_to_ili9341(struct drm_panel *panel)
+{
+       return container_of(panel, struct ili9341, panel);
+}
+
+static void ili9341_dpi_init(struct ili9341 *ili)
+{
+       struct mipi_dbi *dbi = ili->dbi;
+       struct ili9341_config *cfg = (struct ili9341_config *)ili->conf;
+
+       /* Power Control */
+       mipi_dbi_command_stackbuf(dbi, 0xca, cfg->ca, ILI9341_CA_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_POWERB, cfg->power_b,
+                                 ILI9341_POWER_B_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_POWER_SEQ, cfg->power_seq,
+                                 ILI9341_POWER_SEQ_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_DTCA, cfg->dtca,
+                                 ILI9341_DTCA_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_POWERA, cfg->power_a,
+                                 ILI9341_POWER_A_LEN);
+       mipi_dbi_command(ili->dbi, ILI9341_PRC, cfg->prc);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_DTCB, cfg->dtcb,
+                                 ILI9341_DTCB_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_FRC, cfg->frc, ILI9341_FRC_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_DFC, cfg->dfc_1,
+                                 ILI9341_DFC_1_LEN);
+       mipi_dbi_command(dbi, ILI9341_POWER1, cfg->power_1);
+       mipi_dbi_command(dbi, ILI9341_POWER2, cfg->power_2);
+
+       /* VCOM */
+       mipi_dbi_command_stackbuf(dbi, ILI9341_VCOM1, cfg->vcom_1,
+                                 ILI9341_VCOM_1_LEN);
+       mipi_dbi_command(dbi, ILI9341_VCOM2, cfg->vcom_2);
+       mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, cfg->address_mode);
+
+       /* Gamma */
+       mipi_dbi_command(dbi, ILI9341_3GAMMA_EN, cfg->g3amma_en);
+       mipi_dbi_command(dbi, ILI9341_RGB_INTERFACE, cfg->rgb_interface);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_DFC, cfg->dfc_2,
+                                 ILI9341_DFC_2_LEN);
+
+       /* Colomn address set */
+       mipi_dbi_command_stackbuf(dbi, MIPI_DCS_SET_COLUMN_ADDRESS,
+                                 cfg->column_addr, ILI9341_COLUMN_ADDR_LEN);
+
+       /* Page address set */
+       mipi_dbi_command_stackbuf(dbi, MIPI_DCS_SET_PAGE_ADDRESS,
+                                 cfg->page_addr, ILI9341_PAGE_ADDR_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_INTERFACE, cfg->interface,
+                                 ILI9341_INTERFACE_LEN);
+
+       /* Format */
+       mipi_dbi_command(dbi, MIPI_DCS_SET_PIXEL_FORMAT, cfg->pixel_format);
+       mipi_dbi_command(dbi, MIPI_DCS_WRITE_MEMORY_START);
+       msleep(200);
+       mipi_dbi_command(dbi, MIPI_DCS_SET_GAMMA_CURVE, cfg->gamma_curve);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_PGAMMA, cfg->pgamma,
+                                 ILI9341_PGAMMA_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_NGAMMA, cfg->ngamma,
+                                 ILI9341_NGAMMA_LEN);
+       mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE);
+       msleep(200);
+       mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON);
+       mipi_dbi_command(dbi, MIPI_DCS_WRITE_MEMORY_START);
+
+       dev_info(ili->dev, "initialized display rgb interface\n");
+}
+
+static int ili9341_dpi_power_on(struct ili9341 *ili)
+{
+       int ret = 0;
+
+       /* Assert RESET */
+       gpiod_set_value(ili->reset_gpio, 1);
+
+       /* Enable power */
+       ret = regulator_bulk_enable(ARRAY_SIZE(ili->supplies),
+                                   ili->supplies);
+       if (ret < 0) {
+               dev_err(ili->dev, "unable to enable vcc\n");
+               return ret;
+       }
+       msleep(20);
+
+       /* De-assert RESET */
+       gpiod_set_value(ili->reset_gpio, 0);
+       msleep(20);
+
+       return 0;
+}
+
+static int ili9341_dpi_power_off(struct ili9341 *ili)
+{
+       /* Assert RESET */
+       gpiod_set_value(ili->reset_gpio, 1);
+
+       /* Disable power */
+       return regulator_bulk_disable(ARRAY_SIZE(ili->supplies),
+                                     ili->supplies);
+}
+
+static int ili9341_dpi_disable(struct drm_panel *panel)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+
+       mipi_dbi_command(ili->dbi, MIPI_DCS_SET_DISPLAY_OFF);
+       return 0;
+}
+
+static int ili9341_dpi_unprepare(struct drm_panel *panel)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+
+       return ili9341_dpi_power_off(ili);
+}
+
+static int ili9341_dpi_prepare(struct drm_panel *panel)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+       int ret;
+
+       ret = ili9341_dpi_power_on(ili);
+       if (ret < 0)
+               return ret;
+
+       ili9341_dpi_init(ili);
+
+       return ret;
+}
+
+static int ili9341_dpi_enable(struct drm_panel *panel)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+
+       mipi_dbi_command(ili->dbi, MIPI_DCS_SET_DISPLAY_ON);
+       return 0;
+}
+
+static int ili9341_dpi_get_modes(struct drm_panel *panel,
+                                struct drm_connector *connector)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+       struct drm_device *drm = connector->dev;
+       struct drm_display_mode *mode;
+       struct drm_display_info *info;
+
+       info = &connector->display_info;
+       info->width_mm = ili->conf->mode.width_mm;
+       info->height_mm = ili->conf->mode.height_mm;
+
+       if (ili->conf->rgb_interface & ILI9341_RGB_DPL)
+               info->bus_flags |= DRM_BUS_FLAG_PIXDATA_DRIVE_POSEDGE;
+       else
+               info->bus_flags |= DRM_BUS_FLAG_PIXDATA_DRIVE_NEGEDGE;
+
+       if (ili->conf->rgb_interface & ILI9341_RGB_EPL)
+               info->bus_flags |= DRM_BUS_FLAG_DE_LOW;
+       else
+               info->bus_flags |= DRM_BUS_FLAG_DE_HIGH;
+
+       mode = drm_mode_duplicate(drm, &ili->conf->mode);
+       if (!mode) {
+               DRM_ERROR("bad mode or failed to add mode\n");
+               return -EINVAL;
+       }
+       drm_mode_set_name(mode);
+
+       /* Set up the polarity */
+       if (ili->conf->rgb_interface & ILI9341_RGB_HSPL)
+               mode->flags |= DRM_MODE_FLAG_PHSYNC;
+       else
+               mode->flags |= DRM_MODE_FLAG_NHSYNC;
+
+       if (ili->conf->rgb_interface & ILI9341_RGB_VSPL)
+               mode->flags |= DRM_MODE_FLAG_PVSYNC;
+       else
+               mode->flags |= DRM_MODE_FLAG_NVSYNC;
+
+       drm_mode_probed_add(connector, mode);
+
+       return 1; /* Number of modes */
+}
+
+static const struct drm_panel_funcs ili9341_dpi_funcs = {
+       .disable = ili9341_dpi_disable,
+       .unprepare = ili9341_dpi_unprepare,
+       .prepare = ili9341_dpi_prepare,
+       .enable = ili9341_dpi_enable,
+       .get_modes = ili9341_dpi_get_modes,
+};
+
+static void ili9341_dbi_enable(struct drm_simple_display_pipe *pipe,
+                              struct drm_crtc_state *crtc_state,
+                              struct drm_plane_state *plane_state)
+{
+       struct mipi_dbi_dev *dbidev = drm_to_mipi_dbi_dev(pipe->crtc.dev);
+       struct mipi_dbi *dbi = &dbidev->dbi;
+       u8 addr_mode;
+       int ret, idx;
+
+       if (!drm_dev_enter(pipe->crtc.dev, &idx))
+               return;
+
+       DRM_DEBUG_KMS("\n");
+
+       ret = mipi_dbi_poweron_conditional_reset(dbidev);
+       if (ret < 0)
+               goto out_exit;
+       if (ret == 1)
+               goto out_enable;
+
+       mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_OFF);
+
+       mipi_dbi_command(dbi, ILI9341_POWERB, 0x00, 0xc1, 0x30);
+       mipi_dbi_command(dbi, ILI9341_POWER_SEQ, 0x64, 0x03, 0x12, 0x81);
+       mipi_dbi_command(dbi, ILI9341_DTCA, 0x85, 0x00, 0x78);
+       mipi_dbi_command(dbi, ILI9341_POWERA, 0x39, 0x2c, 0x00, 0x34, 0x02);
+       mipi_dbi_command(dbi, ILI9341_PRC, ILI9341_DBI_PRC_NORMAL);
+       mipi_dbi_command(dbi, ILI9341_DTCB, 0x00, 0x00);
+
+       /* Power Control */
+       mipi_dbi_command(dbi, ILI9341_POWER1, ILI9341_DBI_VCOMH_4P6V);
+       mipi_dbi_command(dbi, ILI9341_POWER2, ILI9341_DBI_PWR_2_DEFAULT);
+       /* VCOM */
+       mipi_dbi_command(dbi, ILI9341_VCOM1, ILI9341_DBI_VCOM_1_VMH_4P25V,
+                        ILI9341_DBI_VCOM_1_VML_1P5V);
+       mipi_dbi_command(dbi, ILI9341_VCOM2, ILI9341_DBI_VCOM_2_DEC_58);
+
+       /* Memory Access Control */
+       mipi_dbi_command(dbi, MIPI_DCS_SET_PIXEL_FORMAT,
+                        MIPI_DCS_PIXEL_FMT_16BIT);
+
+       /* Frame Rate */
+       mipi_dbi_command(dbi, ILI9341_FRC, ILI9341_DBI_FRC_DIVA & 0x03,
+                        ILI9341_DBI_FRC_RTNA & 0x1f);
+
+       /* Gamma */
+       mipi_dbi_command(dbi, ILI9341_3GAMMA_EN, 0x00);
+       mipi_dbi_command(dbi, MIPI_DCS_SET_GAMMA_CURVE, ILI9341_GAMMA_CURVE_1);
+       mipi_dbi_command(dbi, ILI9341_PGAMMA,
+                        0x0f, 0x31, 0x2b, 0x0c, 0x0e, 0x08, 0x4e, 0xf1,
+                        0x37, 0x07, 0x10, 0x03, 0x0e, 0x09, 0x00);
+       mipi_dbi_command(dbi, ILI9341_NGAMMA,
+                        0x00, 0x0e, 0x14, 0x03, 0x11, 0x07, 0x31, 0xc1,
+                        0x48, 0x08, 0x0f, 0x0c, 0x31, 0x36, 0x0f);
+
+       /* DDRAM */
+       mipi_dbi_command(dbi, ILI9341_ETMOD, ILI9341_DBI_EMS_GAS |
+                        ILI9341_DBI_EMS_DTS |
+                        ILI9341_DBI_EMS_GON);
+
+       /* Display */
+       mipi_dbi_command(dbi, ILI9341_DFC, 0x08, 0x82, 0x27, 0x00);
+       mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE);
+       msleep(100);
+
+       mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON);
+       msleep(100);
+
+out_enable:
+       switch (dbidev->rotation) {
+       default:
+               addr_mode = ILI9341_MADCTL_MX;
+               break;
+       case 90:
+               addr_mode = ILI9341_MADCTL_MV;
+               break;
+       case 180:
+               addr_mode = ILI9341_MADCTL_MY;
+               break;
+       case 270:
+               addr_mode = ILI9341_MADCTL_MV | ILI9341_MADCTL_MY |
+                           ILI9341_MADCTL_MX;
+               break;
+       }
+       addr_mode |= ILI9341_MADCTL_BGR;
+       mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, addr_mode);
+       mipi_dbi_enable_flush(dbidev, crtc_state, plane_state);
+       DRM_DEBUG_KMS("initialized display serial interface\n");
+out_exit:
+       drm_dev_exit(idx);
+}
+
+static const struct drm_simple_display_pipe_funcs ili9341_dbi_funcs = {
+       .enable = ili9341_dbi_enable,
+       .disable = mipi_dbi_pipe_disable,
+       .update = mipi_dbi_pipe_update,
+       .prepare_fb = drm_gem_simple_display_pipe_prepare_fb,
+};
+
+static const struct drm_display_mode ili9341_dbi_mode = {
+       DRM_SIMPLE_MODE(240, 320, 37, 49),
+};
+
+DEFINE_DRM_GEM_CMA_FOPS(ili9341_dbi_fops);
+
+static struct drm_driver ili9341_dbi_driver = {
+       .driver_features        = DRIVER_GEM | DRIVER_MODESET | DRIVER_ATOMIC,
+       .fops                   = &ili9341_dbi_fops,
+       DRM_GEM_CMA_DRIVER_OPS_VMAP,
+       .debugfs_init           = mipi_dbi_debugfs_init,
+       .name                   = "ili9341",
+       .desc                   = "Ilitek ILI9341",
+       .date                   = "20210716",
+       .major                  = 1,
+       .minor                  = 0,
+};
+
+static int _ili9341_probe(struct spi_device *spi, bool dpi)
+{
+       struct gpio_desc *dc;
+       struct gpio_desc *reset;
+       struct device *dev = &spi->dev;
+       int ret;
+
+       reset = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_HIGH);
+       if (IS_ERR(reset))
Quoted 8 lines

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 606

Quoted 5 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +5 -0
+               DRM_DEV_ERROR(dev, "Failed to get gpio 'reset'\n");
+
+       dc = devm_gpiod_get_optional(dev, "dc", GPIOD_OUT_LOW);
+       if (IS_ERR(dc))
+               DRM_DEV_ERROR(dev, "Failed to get gpio 'dc'\n");

Small nit. Moving the above dts parse code into the main probe and have functions for dpi and !dpi would make code more readable.

Okay, just to make sure I fully understand your suggestion, you ask me to change the code below, right? thanks.

static int ili9341_dpi_probe(struct spi_device *spi,
struct gpio_desc *dc, struct gpio_desc *reset)

{
    ....
}

static int ili9341_dbi_probe(struct spi_device *spi,

                                            struct gpio_desc *dc,
                                            struct gpio_desc *reset){
    ....
}

static int ili9341_probe(struct spi_device *spi)

{
    ....
    struct device *dev = &spi->dev;
    struct gpio_desc *dc;
    struct gpio_desc *reset;
    const struct spi_device_id *id = spi_get_device_id(spi);

    reset = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_HIGH);
    if (IS_ERR(reset))
            drm_err(dev, "Failed to get gpio 'reset'\n");

     dc = devm_gpiod_get_optional(dev, "dc", GPIOD_OUT_LOW);
      if (IS_ERR(dc))
              drm_err(dev, "Failed to get gpio 'dc'\n");

      if (!strcmp(id->name, "sf-tc240t-9370-t"))
                return ili9341_dpi_probe(spi, dc, reset);
       else if (!strcmp(id->name, "yx240qv29"))
                return ili9341_dbi_probe(spi, dc, reset);

        return -1;

}

Quoted 3 lines

Otherwise,

#12 lore raw

Re: [PATCH v2 3/3] drm/panel: Add ilitek ili9341 panel driver

Hi Dillon,

Quoted 717 lines · Dillon Min

Hi Jagan

Thanks for your time to review my code.

Quoted 664 lines · Jagan Teki
Quoted 662 lines · On Wed, Jul 21, 2021 at 1:11 PM <[email protected]> wrote:

From: Dillon Min <[email protected]>

This driver combine tiny/ili9341.c mipi_dbi_interface driver with mipi_dpi_interface driver, can support ili9341 with serial mode or parallel rgb interface mode by register configuration.

Cc Linus Walleij <[email protected]>

---
changes in v2:
- replace vcc regulator to three bulk regulators(vci, vddi, vddi-led) according to linus suggestion, thanks.

 drivers/gpu/drm/panel/Kconfig                |  12 +
 drivers/gpu/drm/panel/Makefile               |   1 +
 drivers/gpu/drm/panel/panel-ilitek-ili9341.c | 778 +++++++++++++++++++++++++++
 3 files changed, 791 insertions(+)
 create mode 100644 drivers/gpu/drm/panel/panel-ilitek-ili9341.c
drivers/gpu/drm/panel/Kconfig +12 -0
index ef87d92cdf49..eb34b8d1b19a 100644
@@ -124,6 +124,18 @@ config DRM_PANEL_ILITEK_IL9322
          Say Y here if you want to enable support for Ilitek IL9322
          QVGA (320x240) RGB, YUV and ITU-T BT.656 panels.
 
+config DRM_PANEL_ILITEK_ILI9341
+       tristate "Ilitek ILI9341 240x320 QVGA panels"
+       depends on OF && SPI
+       depends on DRM_KMS_HELPER
+       depends on DRM_KMS_CMA_HELPER
+       depends on BACKLIGHT_CLASS_DEVICE
+       select DRM_MIPI_DBI
+       help
+         Say Y here if you want to enable support for Ilitek IL9341
+         QVGA (240x320) RGB panels. support serial & parallel rgb
+         interface.
+
 config DRM_PANEL_ILITEK_ILI9881C
        tristate "Ilitek ILI9881C-based panels"
        depends on OF
drivers/gpu/drm/panel/Makefile +1 -0
index cae4d976c069..0ecde184665d 100644
@@ -11,6 +11,7 @@ obj-$(CONFIG_DRM_PANEL_ELIDA_KD35T133) += panel-elida-kd35t133.o
 obj-$(CONFIG_DRM_PANEL_FEIXIN_K101_IM2BA02) += panel-feixin-k101-im2ba02.o
 obj-$(CONFIG_DRM_PANEL_FEIYANG_FY07024DI26A30D) += panel-feiyang-fy07024di26a30d.o
 obj-$(CONFIG_DRM_PANEL_ILITEK_IL9322) += panel-ilitek-ili9322.o
+obj-$(CONFIG_DRM_PANEL_ILITEK_ILI9341) += panel-ilitek-ili9341.o
 obj-$(CONFIG_DRM_PANEL_ILITEK_ILI9881C) += panel-ilitek-ili9881c.o
 obj-$(CONFIG_DRM_PANEL_INNOLUX_P079ZCA) += panel-innolux-p079zca.o
 obj-$(CONFIG_DRM_PANEL_JDI_LT070ME05000) += panel-jdi-lt070me05000.o
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +601 -0
new file mode 100644
index 000000000000..717b0b930e2f
@@ -0,0 +1,778 @@
+// SPDX-License-Identifier: GPL-2.0-only
+/*
+ * Ilitek ILI9341 TFT LCD drm_panel driver.
+ *
+ * This panel can be configured to support:
+ * - 16-bit parallel RGB interface
+ * - 18-bit parallel RGB interface
+ * - 4-line serial spi interface
+ *
+ * Copyright (C) 2021 Dillon Min <[email protected]>
+ * Derived from drivers/drm/gpu/panel/panel-ilitek-ili9322.c
+ * the reuse of DBI abstraction part referred from Linus's patch
+ * "drm/panel: s6e63m0: Switch to DBI abstraction for SPI"
+ */
+
+#include <linux/bitops.h>
+#include <linux/gpio/consumer.h>
+#include <linux/module.h>
+#include <linux/of_device.h>
+#include <linux/regulator/consumer.h>
+#include <linux/spi/spi.h>
+#include <linux/delay.h>
+#include <video/mipi_display.h>
+#include <drm/drm_mipi_dbi.h>
+#include <drm/drm_gem_framebuffer_helper.h>
+#include <drm/drm_gem_cma_helper.h>
+#include <drm/drm_fb_helper.h>
+#include <drm/drm_atomic_helper.h>
+#include <drm/drm_gem_atomic_helper.h>
+
+#include <drm/drm_drv.h>
+#include <drm/drm_modes.h>
+#include <drm/drm_panel.h>
+#include <drm/drm_print.h>
+
+#define ILI9341_RGB_INTERFACE  0xb0   /* RGB Interface Signal Control */
+#define ILI9341_FRC            0xb1   /* Frame Rate Control register */
+#define ILI9341_DFC            0xb6   /* Display Function Control register */
+#define ILI9341_POWER1         0xc0   /* Power Control 1 register */
+#define ILI9341_POWER2         0xc1   /* Power Control 2 register */
+#define ILI9341_VCOM1          0xc5   /* VCOM Control 1 register */
+#define ILI9341_VCOM2          0xc7   /* VCOM Control 2 register */
+#define ILI9341_POWERA         0xcb   /* Power control A register */
+#define ILI9341_POWERB         0xcf   /* Power control B register */
+#define ILI9341_PGAMMA         0xe0   /* Positive Gamma Correction register */
+#define ILI9341_NGAMMA         0xe1   /* Negative Gamma Correction register */
+#define ILI9341_DTCA           0xe8   /* Driver timing control A */
+#define ILI9341_DTCB           0xea   /* Driver timing control B */
+#define ILI9341_POWER_SEQ      0xed   /* Power on sequence register */
+#define ILI9341_3GAMMA_EN      0xf2   /* 3 Gamma enable register */
+#define ILI9341_INTERFACE      0xf6   /* Interface control register */
+#define ILI9341_PRC            0xf7   /* Pump ratio control register */
+#define ILI9341_ETMOD         0xb7   /* Entry mode set */
+
+#define ILI9341_MADCTL_BGR     BIT(3)
+#define ILI9341_MADCTL_MV      BIT(5)
+#define ILI9341_MADCTL_MX      BIT(6)
+#define ILI9341_MADCTL_MY      BIT(7)
+
+#define ILI9341_POWER_B_LEN    3
+#define ILI9341_POWER_SEQ_LEN  4
+#define ILI9341_DTCA_LEN       3
+#define ILI9341_DTCB_LEN       2
+#define ILI9341_POWER_A_LEN    5
+#define ILI9341_DFC_1_LEN      2
+#define ILI9341_FRC_LEN                2
+#define ILI9341_VCOM_1_LEN     2
+#define ILI9341_DFC_2_LEN      4
+#define ILI9341_COLUMN_ADDR_LEN        4
+#define ILI9341_PAGE_ADDR_LEN  4
+#define ILI9341_INTERFACE_LEN  3
+#define ILI9341_PGAMMA_LEN     15
+#define ILI9341_NGAMMA_LEN     15
+#define ILI9341_CA_LEN         3
+
+#define ILI9341_PIXEL_DPI_16_BITS      (BIT(6) | BIT(4))
+#define ILI9341_PIXEL_DPI_18_BITS      (BIT(6) | BIT(5))
+#define ILI9341_GAMMA_CURVE_1          BIT(0)
+#define ILI9341_IF_WE_MODE             BIT(0)
+#define ILI9341_IF_BIG_ENDIAN          0x00
+#define ILI9341_IF_DM_RGB              BIT(2)
+#define ILI9341_IF_DM_INTERNAL         0x00
+#define ILI9341_IF_DM_VSYNC            BIT(3)
+#define ILI9341_IF_RM_RGB              BIT(1)
+#define ILI9341_IF_RIM_RGB             0x00
+
+#define ILI9341_COLUMN_ADDR            0x00ef
+#define ILI9341_PAGE_ADDR              0x013f
+
+#define ILI9341_RGB_EPL                        BIT(0)
+#define ILI9341_RGB_DPL                        BIT(1)
+#define ILI9341_RGB_HSPL               BIT(2)
+#define ILI9341_RGB_VSPL               BIT(3)
+#define ILI9341_RGB_DE_MODE            BIT(6)
+#define ILI9341_RGB_DISP_PATH_MEM      BIT(7)
+
+#define ILI9341_DBI_VCOMH_4P6V         0x23
+#define ILI9341_DBI_PWR_2_DEFAULT      0x10
+#define ILI9341_DBI_PRC_NORMAL         0x20
+#define ILI9341_DBI_VCOM_1_VMH_4P25V   0x3e
+#define ILI9341_DBI_VCOM_1_VML_1P5V    0x28
+#define ILI9341_DBI_VCOM_2_DEC_58      0x86
+#define ILI9341_DBI_FRC_DIVA           0x00
+#define ILI9341_DBI_FRC_RTNA           0x1b
+#define ILI9341_DBI_EMS_GAS            BIT(0)
+#define ILI9341_DBI_EMS_DTS            BIT(1)
+#define ILI9341_DBI_EMS_GON            BIT(2)
+
+/**
+ * struct ili9341_config - the system specific ILI9341 configuration
+ * @max_spi_speed: 10000000
+ */
+struct ili9341_config {
+       u32 max_spi_speed;
+       /** @mode: the drm display mode */
+       const struct drm_display_mode mode;
+       /** @ca: TODO: need comments for this register */
+       u8 ca[ILI9341_CA_LEN];
+       /** @power_b: TODO: need comments for this register */
+       u8 power_b[ILI9341_POWER_B_LEN];
+       /** @power_seq: TODO: need comments for this register */
+       u8 power_seq[ILI9341_POWER_SEQ_LEN];
+       /** @dtca: TODO: need comments for this register */
+       u8 dtca[ILI9341_DTCA_LEN];
+       /** @dtcb: TODO: need comments for this register */
+       u8 dtcb[ILI9341_DTCB_LEN];
+       /** @power_a: TODO: need comments for this register */
+       u8 power_a[ILI9341_POWER_A_LEN];
+       /** @frc: Frame Rate Control (In Normal Mode/Full Colors) (B1h) */
+       u8 frc[ILI9341_FRC_LEN];
+       /** @prc: TODO: need comments for this register */
+       u8 prc;
+       /** @dfc_1: B6h DISCTRL (Display Function Control) */
+       u8 dfc_1[ILI9341_DFC_1_LEN];
+       /** @power_1: Power Control 1 (C0h) */
+       u8 power_1;
+       /** @power_2: Power Control 2 (C1h) */
+       u8 power_2;
+       /** @vcom_1: VCOM Control 1(C5h) */
+       u8 vcom_1[ILI9341_VCOM_1_LEN];
+       /** @vcom_2: VCOM Control 2(C7h) */
+       u8 vcom_2;
+       /** @address_mode: Memory Access Control (36h) */
+       u8 address_mode;
+       /** @g3amma_en: TODO: need comments for this register */
+       u8 g3amma_en;
+       /** @rgb_interface: RGB Interface Signal Control (B0h) */
+       u8 rgb_interface;
+       /** @dfc_2: refer to dfc_1 */
+       u8 dfc_2[ILI9341_DFC_2_LEN];
+       /** @column_addr: Column Address Set (2Ah) */
+       u8 column_addr[ILI9341_COLUMN_ADDR_LEN];
+       /** @page_addr: Page Address Set (2Bh) */
+       u8 page_addr[ILI9341_PAGE_ADDR_LEN];
+       /** @interface: Interface Control (F6h) */
+       u8 interface[ILI9341_INTERFACE_LEN];
+       /** @pixel_format: This command sets the pixel format for the RGB */
+       /* image data used by
+        */
+       u8 pixel_format;
+       /** @gamma_curve: This command is used to select the desired Gamma */
+       /* curve for the
+        */
+       u8 gamma_curve;
+       /** @pgamma: Positive Gamma Correction (E0h) */
+       u8 pgamma[ILI9341_PGAMMA_LEN];
+       /** @ngamma: Negative Gamma Correction (E1h) */
+       u8 ngamma[ILI9341_NGAMMA_LEN];
+};
+
+struct ili9341 {
+       struct device *dev;
+       const struct ili9341_config *conf;
+       struct drm_panel panel;
+       struct gpio_desc *reset_gpio;
+       struct gpio_desc *dc_gpio;
+       struct mipi_dbi *dbi;
+       u32 max_spi_speed;
+       struct regulator_bulk_data supplies[3];
+};
+
+/*
+ * The Stm32f429-disco board has a panel ili9341 connected to ltdc controller
+ */
+static const struct ili9341_config ili9341_stm32f429_disco_data = {
+       .max_spi_speed = 10000000,
+       .mode = {
+               .clock = 6100,
+               .hdisplay = 240,
+               .hsync_start = 240 + 10,/* hfp 10 */
+               .hsync_end = 240 + 10 + 10,/* hsync 10 */
+               .htotal = 240 + 10 + 10 + 20,/* hbp 20 */
+               .vdisplay = 320,
+               .vsync_start = 320 + 4,/* vfp 4 */
+               .vsync_end = 320 + 4 + 2,/* vsync 2 */
+               .vtotal = 320 + 4 + 2 + 2,/* vbp 2 */
+               .flags = 0,
+               .width_mm = 65,
+               .height_mm = 50,
+               .type = DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED,
+       },
+       .ca = {0xc3, 0x08, 0x50},
+       .power_b = {0x00, 0xc1, 0x30},
+       .power_seq = {0x64, 0x03, 0x12, 0x81},
+       .dtca = {0x85, 0x00, 0x78},
+       .power_a = {0x39, 0x2c, 0x00, 0x34, 0x02},
+       .prc = 0x20,
+       .dtcb = {0x00, 0x00},
+       /* 0x00 fosc, 0x1b 70hz */
+       .frc = {0x00, 0x1b},
+       /* 0x0a Interval scan, AGND AGND AGND AGND
+        * 0xa2 Normally white, G1 -> G320, S720 -> S1,
+        *      Scan Cycle 5 frames,85ms
+        */
+       .dfc_1 = {0x0a, 0xa2},
+       /* 0x10 3.65v */
+       .power_1 = 0x10,
+       /* 0x10 AVDD=vci*2, VGH=vci*7, VGL=-vci*4 */
+       .power_2 = 0x10,
+       /* 0x45 VCOMH 4.425v, 0x15 VCOML -1.975*/
+       .vcom_1 = {0x45, 0x15},
+       /* 0x90 offset voltage, VMH-48, VML-48 */
+       .vcom_2 = 0x90,
+       /* 0xc8 Row Address Order, Column Address Order
+        * BGR 1
+        */
+       .address_mode = 0xc8,
+       .g3amma_en = 0x00,
+       /* 0xc2
+        * Display Data Path: Memory
+        * RGB: DE mode
+        * DOTCLK polarity set (data fetched at the falling time)
+        */
+       .rgb_interface = ILI9341_RGB_DISP_PATH_MEM |
+                       ILI9341_RGB_DE_MODE |
+                       ILI9341_RGB_DPL,
+       /*
+        * 0x0a
+        * Gate outputs in non-display area: Interval scan
+        * Determine source/VCOM output in a non-display area in the partial
+        * display mode: AGND AGND AGND AGND
+        *
+        * 0xa7
+        * Scan Cycle: 15 frames
+        * fFLM = 60Hz: 255ms
+        * Liquid crystal type: Normally white
+        * Gate Output Scan Direction: G1 -> G320
+        * Source Output Scan Direction: S720 -> S1
+        *
+        * 0x27
+        * LCD Driver Line: 320 lines
+        *
+        * 0x04
+        * PCDIV: 4
+        */
+       .dfc_2 = {0x0a, 0xa7, 0x27, 0x04},
+       /* column address: 240 */
+       .column_addr = {0x00, 0x00, (ILI9341_COLUMN_ADDR >> 4) & 0xff,
+                               ILI9341_COLUMN_ADDR & 0xff},
+       /* page address: 320 */
+       .page_addr = {0x00, 0x00, (ILI9341_PAGE_ADDR >> 4) & 0xff,
+                               ILI9341_PAGE_ADDR & 0xff},
+       /* Memory write control: When the transfer number of data exceeds
+        * (EC-SC+1)*(EP-SP+1), the column and page number will be
+        * reset, and the exceeding data will be written into the following
+        * column and page.
+        * Display Operation Mode: RGB Interface Mode
+        * Interface for RAM Access: RGB interface
+        * 16- bit RGB interface (1 transfer/pixel)
+        */
+       .interface = {ILI9341_IF_WE_MODE, 0x00,
+                       ILI9341_IF_DM_RGB | ILI9341_IF_RM_RGB},
+       /* DPI: 16 bits / pixel */
+       .pixel_format = ILI9341_PIXEL_DPI_16_BITS,
+       /* Curve Selected: Gamma curve 1 (G2.2) */
+       .gamma_curve = ILI9341_GAMMA_CURVE_1,
+       .pgamma = {0x0f, 0x29, 0x24, 0x0c, 0x0e,
+                       0x09, 0x4e, 0x78, 0x3c, 0x09,
+                       0x13, 0x05, 0x17, 0x11, 0x00},
+       .ngamma = {0x00, 0x16, 0x1b, 0x04, 0x11,
+                       0x07, 0x31, 0x33, 0x42, 0x05,
+                       0x0c, 0x0a, 0x28, 0x2f, 0x0f},
+};
+
+static inline struct ili9341 *panel_to_ili9341(struct drm_panel *panel)
+{
+       return container_of(panel, struct ili9341, panel);
+}
+
+static void ili9341_dpi_init(struct ili9341 *ili)
+{
+       struct mipi_dbi *dbi = ili->dbi;
+       struct ili9341_config *cfg = (struct ili9341_config *)ili->conf;
+
+       /* Power Control */
+       mipi_dbi_command_stackbuf(dbi, 0xca, cfg->ca, ILI9341_CA_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_POWERB, cfg->power_b,
+                                 ILI9341_POWER_B_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_POWER_SEQ, cfg->power_seq,
+                                 ILI9341_POWER_SEQ_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_DTCA, cfg->dtca,
+                                 ILI9341_DTCA_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_POWERA, cfg->power_a,
+                                 ILI9341_POWER_A_LEN);
+       mipi_dbi_command(ili->dbi, ILI9341_PRC, cfg->prc);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_DTCB, cfg->dtcb,
+                                 ILI9341_DTCB_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_FRC, cfg->frc, ILI9341_FRC_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_DFC, cfg->dfc_1,
+                                 ILI9341_DFC_1_LEN);
+       mipi_dbi_command(dbi, ILI9341_POWER1, cfg->power_1);
+       mipi_dbi_command(dbi, ILI9341_POWER2, cfg->power_2);
+
+       /* VCOM */
+       mipi_dbi_command_stackbuf(dbi, ILI9341_VCOM1, cfg->vcom_1,
+                                 ILI9341_VCOM_1_LEN);
+       mipi_dbi_command(dbi, ILI9341_VCOM2, cfg->vcom_2);
+       mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, cfg->address_mode);
+
+       /* Gamma */
+       mipi_dbi_command(dbi, ILI9341_3GAMMA_EN, cfg->g3amma_en);
+       mipi_dbi_command(dbi, ILI9341_RGB_INTERFACE, cfg->rgb_interface);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_DFC, cfg->dfc_2,
+                                 ILI9341_DFC_2_LEN);
+
+       /* Colomn address set */
+       mipi_dbi_command_stackbuf(dbi, MIPI_DCS_SET_COLUMN_ADDRESS,
+                                 cfg->column_addr, ILI9341_COLUMN_ADDR_LEN);
+
+       /* Page address set */
+       mipi_dbi_command_stackbuf(dbi, MIPI_DCS_SET_PAGE_ADDRESS,
+                                 cfg->page_addr, ILI9341_PAGE_ADDR_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_INTERFACE, cfg->interface,
+                                 ILI9341_INTERFACE_LEN);
+
+       /* Format */
+       mipi_dbi_command(dbi, MIPI_DCS_SET_PIXEL_FORMAT, cfg->pixel_format);
+       mipi_dbi_command(dbi, MIPI_DCS_WRITE_MEMORY_START);
+       msleep(200);
+       mipi_dbi_command(dbi, MIPI_DCS_SET_GAMMA_CURVE, cfg->gamma_curve);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_PGAMMA, cfg->pgamma,
+                                 ILI9341_PGAMMA_LEN);
+       mipi_dbi_command_stackbuf(dbi, ILI9341_NGAMMA, cfg->ngamma,
+                                 ILI9341_NGAMMA_LEN);
+       mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE);
+       msleep(200);
+       mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON);
+       mipi_dbi_command(dbi, MIPI_DCS_WRITE_MEMORY_START);
+
+       dev_info(ili->dev, "initialized display rgb interface\n");
+}
+
+static int ili9341_dpi_power_on(struct ili9341 *ili)
+{
+       int ret = 0;
+
+       /* Assert RESET */
+       gpiod_set_value(ili->reset_gpio, 1);
+
+       /* Enable power */
+       ret = regulator_bulk_enable(ARRAY_SIZE(ili->supplies),
+                                   ili->supplies);
+       if (ret < 0) {
+               dev_err(ili->dev, "unable to enable vcc\n");
+               return ret;
+       }
+       msleep(20);
+
+       /* De-assert RESET */
+       gpiod_set_value(ili->reset_gpio, 0);
+       msleep(20);
+
+       return 0;
+}
+
+static int ili9341_dpi_power_off(struct ili9341 *ili)
+{
+       /* Assert RESET */
+       gpiod_set_value(ili->reset_gpio, 1);
+
+       /* Disable power */
+       return regulator_bulk_disable(ARRAY_SIZE(ili->supplies),
+                                     ili->supplies);
+}
+
+static int ili9341_dpi_disable(struct drm_panel *panel)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+
+       mipi_dbi_command(ili->dbi, MIPI_DCS_SET_DISPLAY_OFF);
+       return 0;
+}
+
+static int ili9341_dpi_unprepare(struct drm_panel *panel)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+
+       return ili9341_dpi_power_off(ili);
+}
+
+static int ili9341_dpi_prepare(struct drm_panel *panel)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+       int ret;
+
+       ret = ili9341_dpi_power_on(ili);
+       if (ret < 0)
+               return ret;
+
+       ili9341_dpi_init(ili);
+
+       return ret;
+}
+
+static int ili9341_dpi_enable(struct drm_panel *panel)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+
+       mipi_dbi_command(ili->dbi, MIPI_DCS_SET_DISPLAY_ON);
+       return 0;
+}
+
+static int ili9341_dpi_get_modes(struct drm_panel *panel,
+                                struct drm_connector *connector)
+{
+       struct ili9341 *ili = panel_to_ili9341(panel);
+       struct drm_device *drm = connector->dev;
+       struct drm_display_mode *mode;
+       struct drm_display_info *info;
+
+       info = &connector->display_info;
+       info->width_mm = ili->conf->mode.width_mm;
+       info->height_mm = ili->conf->mode.height_mm;
+
+       if (ili->conf->rgb_interface & ILI9341_RGB_DPL)
+               info->bus_flags |= DRM_BUS_FLAG_PIXDATA_DRIVE_POSEDGE;
+       else
+               info->bus_flags |= DRM_BUS_FLAG_PIXDATA_DRIVE_NEGEDGE;
+
+       if (ili->conf->rgb_interface & ILI9341_RGB_EPL)
+               info->bus_flags |= DRM_BUS_FLAG_DE_LOW;
+       else
+               info->bus_flags |= DRM_BUS_FLAG_DE_HIGH;
+
+       mode = drm_mode_duplicate(drm, &ili->conf->mode);
+       if (!mode) {
+               DRM_ERROR("bad mode or failed to add mode\n");
+               return -EINVAL;
+       }
+       drm_mode_set_name(mode);
+
+       /* Set up the polarity */
+       if (ili->conf->rgb_interface & ILI9341_RGB_HSPL)
+               mode->flags |= DRM_MODE_FLAG_PHSYNC;
+       else
+               mode->flags |= DRM_MODE_FLAG_NHSYNC;
+
+       if (ili->conf->rgb_interface & ILI9341_RGB_VSPL)
+               mode->flags |= DRM_MODE_FLAG_PVSYNC;
+       else
+               mode->flags |= DRM_MODE_FLAG_NVSYNC;
+
+       drm_mode_probed_add(connector, mode);
+
+       return 1; /* Number of modes */
+}
+
+static const struct drm_panel_funcs ili9341_dpi_funcs = {
+       .disable = ili9341_dpi_disable,
+       .unprepare = ili9341_dpi_unprepare,
+       .prepare = ili9341_dpi_prepare,
+       .enable = ili9341_dpi_enable,
+       .get_modes = ili9341_dpi_get_modes,
+};
+
+static void ili9341_dbi_enable(struct drm_simple_display_pipe *pipe,
+                              struct drm_crtc_state *crtc_state,
+                              struct drm_plane_state *plane_state)
+{
+       struct mipi_dbi_dev *dbidev = drm_to_mipi_dbi_dev(pipe->crtc.dev);
+       struct mipi_dbi *dbi = &dbidev->dbi;
+       u8 addr_mode;
+       int ret, idx;
+
+       if (!drm_dev_enter(pipe->crtc.dev, &idx))
+               return;
+
+       DRM_DEBUG_KMS("\n");
+
+       ret = mipi_dbi_poweron_conditional_reset(dbidev);
+       if (ret < 0)
+               goto out_exit;
+       if (ret == 1)
+               goto out_enable;
+
+       mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_OFF);
+
+       mipi_dbi_command(dbi, ILI9341_POWERB, 0x00, 0xc1, 0x30);
+       mipi_dbi_command(dbi, ILI9341_POWER_SEQ, 0x64, 0x03, 0x12, 0x81);
+       mipi_dbi_command(dbi, ILI9341_DTCA, 0x85, 0x00, 0x78);
+       mipi_dbi_command(dbi, ILI9341_POWERA, 0x39, 0x2c, 0x00, 0x34, 0x02);
+       mipi_dbi_command(dbi, ILI9341_PRC, ILI9341_DBI_PRC_NORMAL);
+       mipi_dbi_command(dbi, ILI9341_DTCB, 0x00, 0x00);
+
+       /* Power Control */
+       mipi_dbi_command(dbi, ILI9341_POWER1, ILI9341_DBI_VCOMH_4P6V);
+       mipi_dbi_command(dbi, ILI9341_POWER2, ILI9341_DBI_PWR_2_DEFAULT);
+       /* VCOM */
+       mipi_dbi_command(dbi, ILI9341_VCOM1, ILI9341_DBI_VCOM_1_VMH_4P25V,
+                        ILI9341_DBI_VCOM_1_VML_1P5V);
+       mipi_dbi_command(dbi, ILI9341_VCOM2, ILI9341_DBI_VCOM_2_DEC_58);
+
+       /* Memory Access Control */
+       mipi_dbi_command(dbi, MIPI_DCS_SET_PIXEL_FORMAT,
+                        MIPI_DCS_PIXEL_FMT_16BIT);
+
+       /* Frame Rate */
+       mipi_dbi_command(dbi, ILI9341_FRC, ILI9341_DBI_FRC_DIVA & 0x03,
+                        ILI9341_DBI_FRC_RTNA & 0x1f);
+
+       /* Gamma */
+       mipi_dbi_command(dbi, ILI9341_3GAMMA_EN, 0x00);
+       mipi_dbi_command(dbi, MIPI_DCS_SET_GAMMA_CURVE, ILI9341_GAMMA_CURVE_1);
+       mipi_dbi_command(dbi, ILI9341_PGAMMA,
+                        0x0f, 0x31, 0x2b, 0x0c, 0x0e, 0x08, 0x4e, 0xf1,
+                        0x37, 0x07, 0x10, 0x03, 0x0e, 0x09, 0x00);
+       mipi_dbi_command(dbi, ILI9341_NGAMMA,
+                        0x00, 0x0e, 0x14, 0x03, 0x11, 0x07, 0x31, 0xc1,
+                        0x48, 0x08, 0x0f, 0x0c, 0x31, 0x36, 0x0f);
+
+       /* DDRAM */
+       mipi_dbi_command(dbi, ILI9341_ETMOD, ILI9341_DBI_EMS_GAS |
+                        ILI9341_DBI_EMS_DTS |
+                        ILI9341_DBI_EMS_GON);
+
+       /* Display */
+       mipi_dbi_command(dbi, ILI9341_DFC, 0x08, 0x82, 0x27, 0x00);
+       mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE);
+       msleep(100);
+
+       mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON);
+       msleep(100);
+
+out_enable:
+       switch (dbidev->rotation) {
+       default:
+               addr_mode = ILI9341_MADCTL_MX;
+               break;
+       case 90:
+               addr_mode = ILI9341_MADCTL_MV;
+               break;
+       case 180:
+               addr_mode = ILI9341_MADCTL_MY;
+               break;
+       case 270:
+               addr_mode = ILI9341_MADCTL_MV | ILI9341_MADCTL_MY |
+                           ILI9341_MADCTL_MX;
+               break;
+       }
+       addr_mode |= ILI9341_MADCTL_BGR;
+       mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, addr_mode);
+       mipi_dbi_enable_flush(dbidev, crtc_state, plane_state);
+       DRM_DEBUG_KMS("initialized display serial interface\n");
+out_exit:
+       drm_dev_exit(idx);
+}
+
+static const struct drm_simple_display_pipe_funcs ili9341_dbi_funcs = {
+       .enable = ili9341_dbi_enable,
+       .disable = mipi_dbi_pipe_disable,
+       .update = mipi_dbi_pipe_update,
+       .prepare_fb = drm_gem_simple_display_pipe_prepare_fb,
+};
+
+static const struct drm_display_mode ili9341_dbi_mode = {
+       DRM_SIMPLE_MODE(240, 320, 37, 49),
+};
+
+DEFINE_DRM_GEM_CMA_FOPS(ili9341_dbi_fops);
+
+static struct drm_driver ili9341_dbi_driver = {
+       .driver_features        = DRIVER_GEM | DRIVER_MODESET | DRIVER_ATOMIC,
+       .fops                   = &ili9341_dbi_fops,
+       DRM_GEM_CMA_DRIVER_OPS_VMAP,
+       .debugfs_init           = mipi_dbi_debugfs_init,
+       .name                   = "ili9341",
+       .desc                   = "Ilitek ILI9341",
+       .date                   = "20210716",
+       .major                  = 1,
+       .minor                  = 0,
+};
+
+static int _ili9341_probe(struct spi_device *spi, bool dpi)
+{
+       struct gpio_desc *dc;
+       struct gpio_desc *reset;
+       struct device *dev = &spi->dev;
+       int ret;
+
+       reset = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_HIGH);
+       if (IS_ERR(reset))
Quoted 8 lines

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 606

Quoted 5 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +5 -0
+               DRM_DEV_ERROR(dev, "Failed to get gpio 'reset'\n");
+
+       dc = devm_gpiod_get_optional(dev, "dc", GPIOD_OUT_LOW);
+       if (IS_ERR(dc))
+               DRM_DEV_ERROR(dev, "Failed to get gpio 'dc'\n");

Small nit. Moving the above dts parse code into the main probe and have functions for dpi and !dpi would make code more readable.

Okay, just to make sure I fully understand your suggestion, you ask me to change the code below, right? thanks.

static int ili9341_dpi_probe(struct spi_device *spi,
struct gpio_desc *dc, struct gpio_desc *reset)

{
    ....
}

static int ili9341_dbi_probe(struct spi_device *spi,

                                            struct gpio_desc *dc,
                                            struct gpio_desc *reset){
    ....
}

static int ili9341_probe(struct spi_device *spi)

{
    ....
    struct device *dev = &spi->dev;
    struct gpio_desc *dc;
    struct gpio_desc *reset;
    const struct spi_device_id *id = spi_get_device_id(spi);

    reset = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_HIGH);
    if (IS_ERR(reset))
            drm_err(dev, "Failed to get gpio 'reset'\n");

     dc = devm_gpiod_get_optional(dev, "dc", GPIOD_OUT_LOW);
      if (IS_ERR(dc))
              drm_err(dev, "Failed to get gpio 'dc'\n");

      if (!strcmp(id->name, "sf-tc240t-9370-t"))
                return ili9341_dpi_probe(spi, dc, reset);
       else if (!strcmp(id->name, "yx240qv29"))
                return ili9341_dbi_probe(spi, dc, reset);

        return -1;
Quoted 1 line

}

Perfect, thanks!

Jagan.

#13 lore raw

Re: [PATCH v2 3/3] drm/panel: Add ilitek ili9341 panel driver

In reply to [email protected]

Hi Dillon,

Quoted 8 lines · On Wed, Jul 21, 2021 at 03:41:28PM +0800, [email protected] wrote:

From: Dillon Min <[email protected]>

This driver combine tiny/ili9341.c mipi_dbi_interface driver with mipi_dpi_interface driver, can support ili9341 with serial mode or parallel rgb interface mode by register configuration.

Cc Linus Walleij <[email protected]>

I have not looked at the driver before, sorry for being late. A few nits in the following.

Sam

Quoted 9 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +9 -0
+#include <linux/bitops.h>
+#include <linux/gpio/consumer.h>
+#include <linux/module.h>
+#include <linux/of_device.h>
+#include <linux/regulator/consumer.h>
+#include <linux/spi/spi.h>
+#include <linux/delay.h>
+#include <video/mipi_display.h>
+#include <drm/drm_mipi_dbi.h>

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 34

Quoted 10 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +10 -0
+#include <drm/drm_gem_framebuffer_helper.h>
+#include <drm/drm_gem_cma_helper.h>
+#include <drm/drm_fb_helper.h>
+#include <drm/drm_atomic_helper.h>
+#include <drm/drm_gem_atomic_helper.h>
+
+#include <drm/drm_drv.h>
+#include <drm/drm_modes.h>
+#include <drm/drm_panel.h>
+#include <drm/drm_print.h>

Spaces between blocks of includes.
So linux/* goes in one block, video/* in next block, drm/* in the last block.
Sort alphabetically in each block.

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 112

Quoted 5 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +5 -0
+
+/**
+ * struct ili9341_config - the system specific ILI9341 configuration
+ * @max_spi_speed: 10000000
+ */

Unless you plan to pull this into our kernel-doc there is really no need for a kernel-doc marker. On the other hand W=1 builds will tell if you missed something. So there are arguments both ways.

Quoted 41 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +41 -0
+struct ili9341_config {
+	u32 max_spi_speed;
+	/** @mode: the drm display mode */
+	const struct drm_display_mode mode;
+	/** @ca: TODO: need comments for this register */
+	u8 ca[ILI9341_CA_LEN];
+	/** @power_b: TODO: need comments for this register */
+	u8 power_b[ILI9341_POWER_B_LEN];
+	/** @power_seq: TODO: need comments for this register */
+	u8 power_seq[ILI9341_POWER_SEQ_LEN];
+	/** @dtca: TODO: need comments for this register */
+	u8 dtca[ILI9341_DTCA_LEN];
+	/** @dtcb: TODO: need comments for this register */
+	u8 dtcb[ILI9341_DTCB_LEN];
+	/** @power_a: TODO: need comments for this register */
+	u8 power_a[ILI9341_POWER_A_LEN];
+	/** @frc: Frame Rate Control (In Normal Mode/Full Colors) (B1h) */
+	u8 frc[ILI9341_FRC_LEN];
+	/** @prc: TODO: need comments for this register */
+	u8 prc;
+	/** @dfc_1: B6h DISCTRL (Display Function Control) */
+	u8 dfc_1[ILI9341_DFC_1_LEN];
+	/** @power_1: Power Control 1 (C0h) */
+	u8 power_1;
+	/** @power_2: Power Control 2 (C1h) */
+	u8 power_2;
+	/** @vcom_1: VCOM Control 1(C5h) */
+	u8 vcom_1[ILI9341_VCOM_1_LEN];
+	/** @vcom_2: VCOM Control 2(C7h) */
+	u8 vcom_2;
+	/** @address_mode: Memory Access Control (36h) */
+	u8 address_mode;
+	/** @g3amma_en: TODO: need comments for this register */
+	u8 g3amma_en;
+	/** @rgb_interface: RGB Interface Signal Control (B0h) */
+	u8 rgb_interface;
+	/** @dfc_2: refer to dfc_1 */
+	u8 dfc_2[ILI9341_DFC_2_LEN];
+	/** @column_addr: Column Address Set (2Ah) */
+	u8 column_addr[ILI9341_COLUMN_ADDR_LEN];
+	/** @page_addr: Page Address Set (2Bh) */

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 163

Quoted 10 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +10 -0
+	u8 page_addr[ILI9341_PAGE_ADDR_LEN];
+	/** @interface: Interface Control (F6h) */
+	u8 interface[ILI9341_INTERFACE_LEN];
+	/** @pixel_format: This command sets the pixel format for the RGB */
+	/* image data used by
+	 */
+	u8 pixel_format;
+	/** @gamma_curve: This command is used to select the desired Gamma */
+	/* curve for the
+	 */

Make this a single comment block.

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 172

Quoted 9 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +9 -0
+	u8 gamma_curve;
+	/** @pgamma: Positive Gamma Correction (E0h) */
+	u8 pgamma[ILI9341_PGAMMA_LEN];
+	/** @ngamma: Negative Gamma Correction (E1h) */
+	u8 ngamma[ILI9341_NGAMMA_LEN];
+};
+
+struct ili9341 {
+	struct device *dev;

We will have struct device * both in drm_panel and in ili9341. You could brop the one in ili9341.

Quoted 265 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +265 -0
+	const struct ili9341_config *conf;
+	struct drm_panel panel;
+	struct gpio_desc *reset_gpio;
+	struct gpio_desc *dc_gpio;
+	struct mipi_dbi *dbi;
+	u32 max_spi_speed;
+	struct regulator_bulk_data supplies[3];
+};
+
+/*
+ * The Stm32f429-disco board has a panel ili9341 connected to ltdc controller
+ */
+static const struct ili9341_config ili9341_stm32f429_disco_data = {
+	.max_spi_speed = 10000000,
+	.mode = {
+		.clock = 6100,
+		.hdisplay = 240,
+		.hsync_start = 240 + 10,/* hfp 10 */
+		.hsync_end = 240 + 10 + 10,/* hsync 10 */
+		.htotal = 240 + 10 + 10 + 20,/* hbp 20 */
+		.vdisplay = 320,
+		.vsync_start = 320 + 4,/* vfp 4 */
+		.vsync_end = 320 + 4 + 2,/* vsync 2 */
+		.vtotal = 320 + 4 + 2 + 2,/* vbp 2 */
+		.flags = 0,
+		.width_mm = 65,
+		.height_mm = 50,
+		.type = DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED,
+	},
+	.ca = {0xc3, 0x08, 0x50},
+	.power_b = {0x00, 0xc1, 0x30},
+	.power_seq = {0x64, 0x03, 0x12, 0x81},
+	.dtca = {0x85, 0x00, 0x78},
+	.power_a = {0x39, 0x2c, 0x00, 0x34, 0x02},
+	.prc = 0x20,
+	.dtcb = {0x00, 0x00},
+	/* 0x00 fosc, 0x1b 70hz */
+	.frc = {0x00, 0x1b},
+	/* 0x0a Interval scan, AGND AGND AGND AGND
+	 * 0xa2 Normally white, G1 -> G320, S720 -> S1,
+	 *	Scan Cycle 5 frames,85ms
+	 */
+	.dfc_1 = {0x0a, 0xa2},
+	/* 0x10 3.65v */
+	.power_1 = 0x10,
+	/* 0x10 AVDD=vci*2, VGH=vci*7, VGL=-vci*4 */
+	.power_2 = 0x10,
+	/* 0x45 VCOMH 4.425v, 0x15 VCOML -1.975*/
+	.vcom_1 = {0x45, 0x15},
+	/* 0x90 offset voltage, VMH-48, VML-48 */
+	.vcom_2 = 0x90,
+	/* 0xc8 Row Address Order, Column Address Order
+	 * BGR 1
+	 */
+	.address_mode = 0xc8,
+	.g3amma_en = 0x00,
+	/* 0xc2
+	 * Display Data Path: Memory
+	 * RGB: DE mode
+	 * DOTCLK polarity set (data fetched at the falling time)
+	 */
+	.rgb_interface = ILI9341_RGB_DISP_PATH_MEM |
+			ILI9341_RGB_DE_MODE |
+			ILI9341_RGB_DPL,
+	/*
+	 * 0x0a
+	 * Gate outputs in non-display area: Interval scan
+	 * Determine source/VCOM output in a non-display area in the partial
+	 * display mode: AGND AGND AGND AGND
+	 *
+	 * 0xa7
+	 * Scan Cycle: 15 frames
+	 * fFLM = 60Hz: 255ms
+	 * Liquid crystal type: Normally white
+	 * Gate Output Scan Direction: G1 -> G320
+	 * Source Output Scan Direction: S720 -> S1
+	 *
+	 * 0x27
+	 * LCD Driver Line: 320 lines
+	 *
+	 * 0x04
+	 * PCDIV: 4
+	 */
+	.dfc_2 = {0x0a, 0xa7, 0x27, 0x04},
+	/* column address: 240 */
+	.column_addr = {0x00, 0x00, (ILI9341_COLUMN_ADDR >> 4) & 0xff,
+				ILI9341_COLUMN_ADDR & 0xff},
+	/* page address: 320 */
+	.page_addr = {0x00, 0x00, (ILI9341_PAGE_ADDR >> 4) & 0xff,
+				ILI9341_PAGE_ADDR & 0xff},
+	/* Memory write control: When the transfer number of data exceeds
+	 * (EC-SC+1)*(EP-SP+1), the column and page number will be
+	 * reset, and the exceeding data will be written into the following
+	 * column and page.
+	 * Display Operation Mode: RGB Interface Mode
+	 * Interface for RAM Access: RGB interface
+	 * 16- bit RGB interface (1 transfer/pixel)
+	 */
+	.interface = {ILI9341_IF_WE_MODE, 0x00,
+			ILI9341_IF_DM_RGB | ILI9341_IF_RM_RGB},
+	/* DPI: 16 bits / pixel */
+	.pixel_format = ILI9341_PIXEL_DPI_16_BITS,
+	/* Curve Selected: Gamma curve 1 (G2.2) */
+	.gamma_curve = ILI9341_GAMMA_CURVE_1,
+	.pgamma = {0x0f, 0x29, 0x24, 0x0c, 0x0e,
+			0x09, 0x4e, 0x78, 0x3c, 0x09,
+			0x13, 0x05, 0x17, 0x11, 0x00},
+	.ngamma = {0x00, 0x16, 0x1b, 0x04, 0x11,
+			0x07, 0x31, 0x33, 0x42, 0x05,
+			0x0c, 0x0a, 0x28, 0x2f, 0x0f},
+};
+
+static inline struct ili9341 *panel_to_ili9341(struct drm_panel *panel)
+{
+	return container_of(panel, struct ili9341, panel);
+}
+
+static void ili9341_dpi_init(struct ili9341 *ili)
+{
+	struct mipi_dbi *dbi = ili->dbi;
+	struct ili9341_config *cfg = (struct ili9341_config *)ili->conf;
+
+	/* Power Control */
+	mipi_dbi_command_stackbuf(dbi, 0xca, cfg->ca, ILI9341_CA_LEN);
+	mipi_dbi_command_stackbuf(dbi, ILI9341_POWERB, cfg->power_b,
+				  ILI9341_POWER_B_LEN);
+	mipi_dbi_command_stackbuf(dbi, ILI9341_POWER_SEQ, cfg->power_seq,
+				  ILI9341_POWER_SEQ_LEN);
+	mipi_dbi_command_stackbuf(dbi, ILI9341_DTCA, cfg->dtca,
+				  ILI9341_DTCA_LEN);
+	mipi_dbi_command_stackbuf(dbi, ILI9341_POWERA, cfg->power_a,
+				  ILI9341_POWER_A_LEN);
+	mipi_dbi_command(ili->dbi, ILI9341_PRC, cfg->prc);
+	mipi_dbi_command_stackbuf(dbi, ILI9341_DTCB, cfg->dtcb,
+				  ILI9341_DTCB_LEN);
+	mipi_dbi_command_stackbuf(dbi, ILI9341_FRC, cfg->frc, ILI9341_FRC_LEN);
+	mipi_dbi_command_stackbuf(dbi, ILI9341_DFC, cfg->dfc_1,
+				  ILI9341_DFC_1_LEN);
+	mipi_dbi_command(dbi, ILI9341_POWER1, cfg->power_1);
+	mipi_dbi_command(dbi, ILI9341_POWER2, cfg->power_2);
+
+	/* VCOM */
+	mipi_dbi_command_stackbuf(dbi, ILI9341_VCOM1, cfg->vcom_1,
+				  ILI9341_VCOM_1_LEN);
+	mipi_dbi_command(dbi, ILI9341_VCOM2, cfg->vcom_2);
+	mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, cfg->address_mode);
+
+	/* Gamma */
+	mipi_dbi_command(dbi, ILI9341_3GAMMA_EN, cfg->g3amma_en);
+	mipi_dbi_command(dbi, ILI9341_RGB_INTERFACE, cfg->rgb_interface);
+	mipi_dbi_command_stackbuf(dbi, ILI9341_DFC, cfg->dfc_2,
+				  ILI9341_DFC_2_LEN);
+
+	/* Colomn address set */
+	mipi_dbi_command_stackbuf(dbi, MIPI_DCS_SET_COLUMN_ADDRESS,
+				  cfg->column_addr, ILI9341_COLUMN_ADDR_LEN);
+
+	/* Page address set */
+	mipi_dbi_command_stackbuf(dbi, MIPI_DCS_SET_PAGE_ADDRESS,
+				  cfg->page_addr, ILI9341_PAGE_ADDR_LEN);
+	mipi_dbi_command_stackbuf(dbi, ILI9341_INTERFACE, cfg->interface,
+				  ILI9341_INTERFACE_LEN);
+
+	/* Format */
+	mipi_dbi_command(dbi, MIPI_DCS_SET_PIXEL_FORMAT, cfg->pixel_format);
+	mipi_dbi_command(dbi, MIPI_DCS_WRITE_MEMORY_START);
+	msleep(200);
+	mipi_dbi_command(dbi, MIPI_DCS_SET_GAMMA_CURVE, cfg->gamma_curve);
+	mipi_dbi_command_stackbuf(dbi, ILI9341_PGAMMA, cfg->pgamma,
+				  ILI9341_PGAMMA_LEN);
+	mipi_dbi_command_stackbuf(dbi, ILI9341_NGAMMA, cfg->ngamma,
+				  ILI9341_NGAMMA_LEN);
+	mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE);
+	msleep(200);
+	mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON);
+	mipi_dbi_command(dbi, MIPI_DCS_WRITE_MEMORY_START);
+
+	dev_info(ili->dev, "initialized display rgb interface\n");
+}
+
+static int ili9341_dpi_power_on(struct ili9341 *ili)
+{
+	int ret = 0;
+
+	/* Assert RESET */
+	gpiod_set_value(ili->reset_gpio, 1);
+
+	/* Enable power */
+	ret = regulator_bulk_enable(ARRAY_SIZE(ili->supplies),
+				    ili->supplies);
+	if (ret < 0) {
+		dev_err(ili->dev, "unable to enable vcc\n");
+		return ret;
+	}
+	msleep(20);
+
+	/* De-assert RESET */
+	gpiod_set_value(ili->reset_gpio, 0);
+	msleep(20);
+
+	return 0;
+}
+
+static int ili9341_dpi_power_off(struct ili9341 *ili)
+{
+	/* Assert RESET */
+	gpiod_set_value(ili->reset_gpio, 1);
+
+	/* Disable power */
+	return regulator_bulk_disable(ARRAY_SIZE(ili->supplies),
+				      ili->supplies);
+}
+
+static int ili9341_dpi_disable(struct drm_panel *panel)
+{
+	struct ili9341 *ili = panel_to_ili9341(panel);
+
+	mipi_dbi_command(ili->dbi, MIPI_DCS_SET_DISPLAY_OFF);
+	return 0;
+}
+
+static int ili9341_dpi_unprepare(struct drm_panel *panel)
+{
+	struct ili9341 *ili = panel_to_ili9341(panel);
+
+	return ili9341_dpi_power_off(ili);
+}
+
+static int ili9341_dpi_prepare(struct drm_panel *panel)
+{
+	struct ili9341 *ili = panel_to_ili9341(panel);
+	int ret;
+
+	ret = ili9341_dpi_power_on(ili);
+	if (ret < 0)
+		return ret;
+
+	ili9341_dpi_init(ili);
+
+	return ret;
+}
+
+static int ili9341_dpi_enable(struct drm_panel *panel)
+{
+	struct ili9341 *ili = panel_to_ili9341(panel);
+
+	mipi_dbi_command(ili->dbi, MIPI_DCS_SET_DISPLAY_ON);
+	return 0;
+}
+
+static int ili9341_dpi_get_modes(struct drm_panel *panel,
+				 struct drm_connector *connector)
+{
+	struct ili9341 *ili = panel_to_ili9341(panel);
+	struct drm_device *drm = connector->dev;
+	struct drm_display_mode *mode;
+	struct drm_display_info *info;
+
+	info = &connector->display_info;
+	info->width_mm = ili->conf->mode.width_mm;
+	info->height_mm = ili->conf->mode.height_mm;
+
+	if (ili->conf->rgb_interface & ILI9341_RGB_DPL)
+		info->bus_flags |= DRM_BUS_FLAG_PIXDATA_DRIVE_POSEDGE;
+	else

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 447

Quoted 10 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +10 -0
+		info->bus_flags |= DRM_BUS_FLAG_PIXDATA_DRIVE_NEGEDGE;
+
+	if (ili->conf->rgb_interface & ILI9341_RGB_EPL)
+		info->bus_flags |= DRM_BUS_FLAG_DE_LOW;
+	else
+		info->bus_flags |= DRM_BUS_FLAG_DE_HIGH;
+
+	mode = drm_mode_duplicate(drm, &ili->conf->mode);
+	if (!mode) {
+		DRM_ERROR("bad mode or failed to add mode\n");

DRM_ERROR and friends are not used in panel/* - the new variants drm_err() shall be used.
This goes for the other uses of DRM_* as well.

Quoted 116 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +116 -0
+		return -EINVAL;
+	}
+	drm_mode_set_name(mode);
+
+	/* Set up the polarity */
+	if (ili->conf->rgb_interface & ILI9341_RGB_HSPL)
+		mode->flags |= DRM_MODE_FLAG_PHSYNC;
+	else
+		mode->flags |= DRM_MODE_FLAG_NHSYNC;
+
+	if (ili->conf->rgb_interface & ILI9341_RGB_VSPL)
+		mode->flags |= DRM_MODE_FLAG_PVSYNC;
+	else
+		mode->flags |= DRM_MODE_FLAG_NVSYNC;
+
+	drm_mode_probed_add(connector, mode);
+
+	return 1; /* Number of modes */
+}
+
+static const struct drm_panel_funcs ili9341_dpi_funcs = {
+	.disable = ili9341_dpi_disable,
+	.unprepare = ili9341_dpi_unprepare,
+	.prepare = ili9341_dpi_prepare,
+	.enable = ili9341_dpi_enable,
+	.get_modes = ili9341_dpi_get_modes,
+};
+
+static void ili9341_dbi_enable(struct drm_simple_display_pipe *pipe,
+			       struct drm_crtc_state *crtc_state,
+			       struct drm_plane_state *plane_state)
+{
+	struct mipi_dbi_dev *dbidev = drm_to_mipi_dbi_dev(pipe->crtc.dev);
+	struct mipi_dbi *dbi = &dbidev->dbi;
+	u8 addr_mode;
+	int ret, idx;
+
+	if (!drm_dev_enter(pipe->crtc.dev, &idx))
+		return;
+
+	DRM_DEBUG_KMS("\n");
+
+	ret = mipi_dbi_poweron_conditional_reset(dbidev);
+	if (ret < 0)
+		goto out_exit;
+	if (ret == 1)
+		goto out_enable;
+
+	mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_OFF);
+
+	mipi_dbi_command(dbi, ILI9341_POWERB, 0x00, 0xc1, 0x30);
+	mipi_dbi_command(dbi, ILI9341_POWER_SEQ, 0x64, 0x03, 0x12, 0x81);
+	mipi_dbi_command(dbi, ILI9341_DTCA, 0x85, 0x00, 0x78);
+	mipi_dbi_command(dbi, ILI9341_POWERA, 0x39, 0x2c, 0x00, 0x34, 0x02);
+	mipi_dbi_command(dbi, ILI9341_PRC, ILI9341_DBI_PRC_NORMAL);
+	mipi_dbi_command(dbi, ILI9341_DTCB, 0x00, 0x00);
+
+	/* Power Control */
+	mipi_dbi_command(dbi, ILI9341_POWER1, ILI9341_DBI_VCOMH_4P6V);
+	mipi_dbi_command(dbi, ILI9341_POWER2, ILI9341_DBI_PWR_2_DEFAULT);
+	/* VCOM */
+	mipi_dbi_command(dbi, ILI9341_VCOM1, ILI9341_DBI_VCOM_1_VMH_4P25V,
+			 ILI9341_DBI_VCOM_1_VML_1P5V);
+	mipi_dbi_command(dbi, ILI9341_VCOM2, ILI9341_DBI_VCOM_2_DEC_58);
+
+	/* Memory Access Control */
+	mipi_dbi_command(dbi, MIPI_DCS_SET_PIXEL_FORMAT,
+			 MIPI_DCS_PIXEL_FMT_16BIT);
+
+	/* Frame Rate */
+	mipi_dbi_command(dbi, ILI9341_FRC, ILI9341_DBI_FRC_DIVA & 0x03,
+			 ILI9341_DBI_FRC_RTNA & 0x1f);
+
+	/* Gamma */
+	mipi_dbi_command(dbi, ILI9341_3GAMMA_EN, 0x00);
+	mipi_dbi_command(dbi, MIPI_DCS_SET_GAMMA_CURVE, ILI9341_GAMMA_CURVE_1);
+	mipi_dbi_command(dbi, ILI9341_PGAMMA,
+			 0x0f, 0x31, 0x2b, 0x0c, 0x0e, 0x08, 0x4e, 0xf1,
+			 0x37, 0x07, 0x10, 0x03, 0x0e, 0x09, 0x00);
+	mipi_dbi_command(dbi, ILI9341_NGAMMA,
+			 0x00, 0x0e, 0x14, 0x03, 0x11, 0x07, 0x31, 0xc1,
+			 0x48, 0x08, 0x0f, 0x0c, 0x31, 0x36, 0x0f);
+
+	/* DDRAM */
+	mipi_dbi_command(dbi, ILI9341_ETMOD, ILI9341_DBI_EMS_GAS |
+			 ILI9341_DBI_EMS_DTS |
+			 ILI9341_DBI_EMS_GON);
+
+	/* Display */
+	mipi_dbi_command(dbi, ILI9341_DFC, 0x08, 0x82, 0x27, 0x00);
+	mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE);
+	msleep(100);
+
+	mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON);
+	msleep(100);
+
+out_enable:
+	switch (dbidev->rotation) {
+	default:
+		addr_mode = ILI9341_MADCTL_MX;
+		break;
+	case 90:
+		addr_mode = ILI9341_MADCTL_MV;
+		break;
+	case 180:
+		addr_mode = ILI9341_MADCTL_MY;
+		break;
+	case 270:
+		addr_mode = ILI9341_MADCTL_MV | ILI9341_MADCTL_MY |
+			    ILI9341_MADCTL_MX;
+		break;
+	}
+	addr_mode |= ILI9341_MADCTL_BGR;
+	mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, addr_mode);
+	mipi_dbi_enable_flush(dbidev, crtc_state, plane_state);
+	DRM_DEBUG_KMS("initialized display serial interface\n");

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 573

Quoted 10 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +10 -0
+out_exit:
+	drm_dev_exit(idx);
+}
+
+static const struct drm_simple_display_pipe_funcs ili9341_dbi_funcs = {
+	.enable = ili9341_dbi_enable,
+	.disable = mipi_dbi_pipe_disable,
+	.update = mipi_dbi_pipe_update,
+	.prepare_fb = drm_gem_simple_display_pipe_prepare_fb,
+};

So this is a full display driver. The more relevant home for this driver is inside drm/tiny/.

Quoted 207 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +205 -0
+
+static const struct drm_display_mode ili9341_dbi_mode = {
+	DRM_SIMPLE_MODE(240, 320, 37, 49),
+};
+
+DEFINE_DRM_GEM_CMA_FOPS(ili9341_dbi_fops);
+
+static struct drm_driver ili9341_dbi_driver = {
+	.driver_features	= DRIVER_GEM | DRIVER_MODESET | DRIVER_ATOMIC,
+	.fops			= &ili9341_dbi_fops,
+	DRM_GEM_CMA_DRIVER_OPS_VMAP,
+	.debugfs_init		= mipi_dbi_debugfs_init,
+	.name			= "ili9341",
+	.desc			= "Ilitek ILI9341",
+	.date			= "20210716",
+	.major			= 1,
+	.minor			= 0,
+};
+
+static int _ili9341_probe(struct spi_device *spi, bool dpi)
+{
+	struct gpio_desc *dc;
+	struct gpio_desc *reset;
+	struct device *dev = &spi->dev;
+	int ret;
+
+	reset = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_HIGH);
+	if (IS_ERR(reset))
+		DRM_DEV_ERROR(dev, "Failed to get gpio 'reset'\n");
+
+	dc = devm_gpiod_get_optional(dev, "dc", GPIOD_OUT_LOW);
+	if (IS_ERR(dc))
+		DRM_DEV_ERROR(dev, "Failed to get gpio 'dc'\n");
+
+	if (!dpi) {
+		struct mipi_dbi_dev *dbidev;
+		struct mipi_dbi *dbi;
+		struct drm_device *drm;
+		struct regulator *vcc;
+		u32 rotation = 0;
+
+		vcc = devm_regulator_get_optional(dev, "vcc");
+		if (IS_ERR(vcc))
+			DRM_DEV_ERROR(dev, "get optional vcc failed\n");
+
+		dbidev = devm_drm_dev_alloc(dev, &ili9341_dbi_driver,
+					    struct mipi_dbi_dev, drm);
+		if (IS_ERR(dbidev))
+			return PTR_ERR(dbidev);
+
+		dbi = &dbidev->dbi;
+		drm = &dbidev->drm;
+		dbi->reset = reset;
+		dbidev->regulator = vcc;
+
+		drm_mode_config_init(drm);
+		dbidev->backlight = devm_of_find_backlight(dev);
+		if (IS_ERR(dbidev->backlight))
+			return PTR_ERR(dbidev->backlight);
+
+		device_property_read_u32(dev, "rotation", &rotation);
+
+		ret = mipi_dbi_spi_init(spi, dbi, dc);
+		if (ret)
+			return ret;
+
+		ret = mipi_dbi_dev_init(dbidev, &ili9341_dbi_funcs,
+					&ili9341_dbi_mode, rotation);
+		if (ret)
+			return ret;
+
+		drm_mode_config_reset(drm);
+
+		ret = drm_dev_register(drm, 0);
+		if (ret)
+			return ret;
+
+		spi_set_drvdata(spi, drm);
+
+		drm_fbdev_generic_setup(drm, 0);
+	} else {
+		struct ili9341 *ili;
+
+		ili = devm_kzalloc(dev, sizeof(struct ili9341), GFP_KERNEL);
+		if (!ili)
+			return -ENOMEM;
+
+		ili->dbi = devm_kzalloc(dev, sizeof(struct mipi_dbi),
+					GFP_KERNEL);
+		if (!ili->dbi)
+			return -ENOMEM;
+
+		ili->supplies[0].supply = "vci";
+		ili->supplies[1].supply = "vddi";
+		ili->supplies[2].supply = "vddi-led";
+
+		ret = devm_regulator_bulk_get(dev, ARRAY_SIZE(ili->supplies),
+					      ili->supplies);
+		if (ret < 0) {
+			dev_err(dev, "failed to get regulators: %d\n", ret);
+			return ret;
+		}
+
+		ret = mipi_dbi_spi_init(spi, ili->dbi, dc);
+		if (ret)
+			return ret;
+
+		spi_set_drvdata(spi, ili);
+
+		ili->dev = dev;
+		ili->reset_gpio = reset;
+		/*
+		 * Every new incarnation of this display must have a unique
+		 * data entry for the system in this driver.
+		 */
+		ili->conf = of_device_get_match_data(dev);
+		if (!ili->conf) {
+			dev_err(dev, "missing device configuration\n");
+			return -ENODEV;
+		}
+
+		ili->max_spi_speed = ili->conf->max_spi_speed;
+
+		drm_panel_init(&ili->panel, dev, &ili9341_dpi_funcs,
+			       DRM_MODE_CONNECTOR_DPI);
+
+		drm_panel_add(&ili->panel);
+	}
+
+	return 0;
+}
+
+static int ili9341_probe(struct spi_device *spi)
+{
+	const struct spi_device_id *id = spi_get_device_id(spi);
+
+	if (!strcmp(id->name, "sf-tc240t-9370-t"))
+		return _ili9341_probe(spi, true);
+	else if (!strcmp(id->name, "yx240qv29"))
+		return _ili9341_probe(spi, false);
+
+	return -1;
+}
+
+static int ili9341_remove(struct spi_device *spi)
+{
+	const struct spi_device_id *id = spi_get_device_id(spi);
+	struct ili9341 *ili = spi_get_drvdata(spi);
+	struct drm_device *drm = spi_get_drvdata(spi);
+
+	if (!strcmp(id->name, "sf-tc240t-9370-t")) {
+		ili9341_dpi_power_off(ili);
+		drm_panel_remove(&ili->panel);
+	} else if (!strcmp(id->name, "yx240qv29")) {
+		drm_dev_unplug(drm);
+		drm_atomic_helper_shutdown(drm);
+	}
+	return 0;
+}
+
+static void ili9341_shutdown(struct spi_device *spi)
+{
+	const struct spi_device_id *id = spi_get_device_id(spi);
+
+	if (!strcmp(id->name, "yx240qv29"))
+		drm_atomic_helper_shutdown(spi_get_drvdata(spi));
+}
+
+static const struct of_device_id ili9341_of_match[] = {
+	{
+		.compatible = "st,sf-tc240t-9370-t",
+		.data = &ili9341_stm32f429_disco_data,
+	},
+	{
+		/* porting from tiny/ili9341.c
+		 * for original mipi dbi compitable
+		 */
+		.compatible = "adafruit,yx240qv29",
+		.data = NULL,
+	},
+};
+MODULE_DEVICE_TABLE(of, ili9341_of_match);
+
+static const struct spi_device_id ili9341_id[] = {
+	{ "yx240qv29", 0 },
+	{ "sf-tc240t-9370-t", 0 },
+	{ }
+};
+MODULE_DEVICE_TABLE(spi, ili9341_id);
+
+static struct spi_driver ili9341_driver = {
+	.probe = ili9341_probe,
+	.remove = ili9341_remove,
+	.shutdown = ili9341_shutdown,
+	.id_table = ili9341_id,
+	.driver = {
+		.name = "panel-ilitek-ili9341",
+		.of_match_table = ili9341_of_match,
+	},
+};
+module_spi_driver(ili9341_driver);
+
+MODULE_AUTHOR("Dillon Min <[email protected]>");
+MODULE_DESCRIPTION("ILI9341 LCD panel driver");
+MODULE_LICENSE("GPL v2");
Signature · 1 line
2.7.4
author
#14 lore raw

Re: [PATCH v2 3/3] drm/panel: Add ilitek ili9341 panel driver

Hi Sam,

Thanks for your time on my code review.

Quoted 10 lines · Sam Ravnborg

Hi Dillon,

Quoted 6 lines · On Wed, Jul 21, 2021 at 03:41:28PM +0800, [email protected] wrote:

From: Dillon Min <[email protected]>

This driver combine tiny/ili9341.c mipi_dbi_interface driver with mipi_dpi_interface driver, can support ili9341 with serial mode or parallel rgb interface mode by register configuration.

Quoted 5 lines
Quoted 2 lines
Cc Linus Walleij <[email protected]>

I have not looked at the driver before, sorry for being late. A few nits in the following.

That's fine. thanks.

Quoted 19 lines

Sam

Quoted 16 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +16 -0
+#include <linux/bitops.h>
+#include <linux/gpio/consumer.h>
+#include <linux/module.h>
+#include <linux/of_device.h>
+#include <linux/regulator/consumer.h>
+#include <linux/spi/spi.h>
+#include <linux/delay.h>
+#include <video/mipi_display.h>
+#include <drm/drm_mipi_dbi.h>
+#include <drm/drm_gem_framebuffer_helper.h>
+#include <drm/drm_gem_cma_helper.h>
+#include <drm/drm_fb_helper.h>
+#include <drm/drm_atomic_helper.h>
+#include <drm/drm_gem_atomic_helper.h>
+
+#include <drm/drm_drv.h>
Quoted 8 lines

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 34

Quoted 3 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +3 -0
+#include <drm/drm_modes.h>
+#include <drm/drm_panel.h>
+#include <drm/drm_print.h>

Spaces between blocks of includes.
So linux/* goes in one block, video/* in next block, drm/* in the last block.
Sort alphabetically in each block.

I will add this change to v3. thanks.

Quoted 9 lines

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 112

Quoted 6 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +5 -0
+
+/**
+ * struct ili9341_config - the system specific ILI9341 configuration
+ * @max_spi_speed: 10000000
+ */

Unless you plan to pull this into our kernel-doc there is really no need for a kernel-doc marker. On the other hand W=1 builds will tell if you missed something. So there are arguments both ways.

This driver was following the drm/panel/panel-ilitek-ili9322.c style, I didn't realize the /** ... */ is the kernel-doc marker before. just because W=1 report some warnings, so i add all this marker to struct ili9341_config

I will remove all the kernel-doc markers, and try to build with W=1 again, thanks.

Quoted 52 lines
Quoted 42 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +41 -0
+struct ili9341_config {
+     u32 max_spi_speed;
+     /** @mode: the drm display mode */
+     const struct drm_display_mode mode;
+     /** @ca: TODO: need comments for this register */
+     u8 ca[ILI9341_CA_LEN];
+     /** @power_b: TODO: need comments for this register */
+     u8 power_b[ILI9341_POWER_B_LEN];
+     /** @power_seq: TODO: need comments for this register */
+     u8 power_seq[ILI9341_POWER_SEQ_LEN];
+     /** @dtca: TODO: need comments for this register */
+     u8 dtca[ILI9341_DTCA_LEN];
+     /** @dtcb: TODO: need comments for this register */
+     u8 dtcb[ILI9341_DTCB_LEN];
+     /** @power_a: TODO: need comments for this register */
+     u8 power_a[ILI9341_POWER_A_LEN];
+     /** @frc: Frame Rate Control (In Normal Mode/Full Colors) (B1h) */
+     u8 frc[ILI9341_FRC_LEN];
+     /** @prc: TODO: need comments for this register */
+     u8 prc;
+     /** @dfc_1: B6h DISCTRL (Display Function Control) */
+     u8 dfc_1[ILI9341_DFC_1_LEN];
+     /** @power_1: Power Control 1 (C0h) */
+     u8 power_1;
+     /** @power_2: Power Control 2 (C1h) */
+     u8 power_2;
+     /** @vcom_1: VCOM Control 1(C5h) */
+     u8 vcom_1[ILI9341_VCOM_1_LEN];
+     /** @vcom_2: VCOM Control 2(C7h) */
+     u8 vcom_2;
+     /** @address_mode: Memory Access Control (36h) */
+     u8 address_mode;
+     /** @g3amma_en: TODO: need comments for this register */
+     u8 g3amma_en;
+     /** @rgb_interface: RGB Interface Signal Control (B0h) */
+     u8 rgb_interface;
+     /** @dfc_2: refer to dfc_1 */
+     u8 dfc_2[ILI9341_DFC_2_LEN];
+     /** @column_addr: Column Address Set (2Ah) */
+     u8 column_addr[ILI9341_COLUMN_ADDR_LEN];
+     /** @page_addr: Page Address Set (2Bh) */

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 163

Quoted 10 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +10 -0
+     u8 page_addr[ILI9341_PAGE_ADDR_LEN];
+     /** @interface: Interface Control (F6h) */
+     u8 interface[ILI9341_INTERFACE_LEN];
+     /** @pixel_format: This command sets the pixel format for the RGB */
+     /* image data used by
+      */
+     u8 pixel_format;
+     /** @gamma_curve: This command is used to select the desired Gamma */
+     /* curve for the
+      */
Quoted 1 line

Make this a single comment block.

Okay.

Quoted 12 lines

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 172

Quoted 10 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +9 -0
+     u8 gamma_curve;
+     /** @pgamma: Positive Gamma Correction (E0h) */
+     u8 pgamma[ILI9341_PGAMMA_LEN];
+     /** @ngamma: Negative Gamma Correction (E1h) */
+     u8 ngamma[ILI9341_NGAMMA_LEN];
+};
+
+struct ili9341 {
+     struct device *dev;

We will have struct device * both in drm_panel and in ili9341. You could brop the one in ili9341.

Okay, I will use the dev from 'struct drm_panel'.

Quoted 272 lines
Quoted 272 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +271 -0
+     const struct ili9341_config *conf;
+     struct drm_panel panel;
+     struct gpio_desc *reset_gpio;
+     struct gpio_desc *dc_gpio;
+     struct mipi_dbi *dbi;
+     u32 max_spi_speed;
+     struct regulator_bulk_data supplies[3];
+};
+
+/*
+ * The Stm32f429-disco board has a panel ili9341 connected to ltdc controller
+ */
+static const struct ili9341_config ili9341_stm32f429_disco_data = {
+     .max_spi_speed = 10000000,
+     .mode = {
+             .clock = 6100,
+             .hdisplay = 240,
+             .hsync_start = 240 + 10,/* hfp 10 */
+             .hsync_end = 240 + 10 + 10,/* hsync 10 */
+             .htotal = 240 + 10 + 10 + 20,/* hbp 20 */
+             .vdisplay = 320,
+             .vsync_start = 320 + 4,/* vfp 4 */
+             .vsync_end = 320 + 4 + 2,/* vsync 2 */
+             .vtotal = 320 + 4 + 2 + 2,/* vbp 2 */
+             .flags = 0,
+             .width_mm = 65,
+             .height_mm = 50,
+             .type = DRM_MODE_TYPE_DRIVER | DRM_MODE_TYPE_PREFERRED,
+     },
+     .ca = {0xc3, 0x08, 0x50},
+     .power_b = {0x00, 0xc1, 0x30},
+     .power_seq = {0x64, 0x03, 0x12, 0x81},
+     .dtca = {0x85, 0x00, 0x78},
+     .power_a = {0x39, 0x2c, 0x00, 0x34, 0x02},
+     .prc = 0x20,
+     .dtcb = {0x00, 0x00},
+     /* 0x00 fosc, 0x1b 70hz */
+     .frc = {0x00, 0x1b},
+     /* 0x0a Interval scan, AGND AGND AGND AGND
+      * 0xa2 Normally white, G1 -> G320, S720 -> S1,
+      *      Scan Cycle 5 frames,85ms
+      */
+     .dfc_1 = {0x0a, 0xa2},
+     /* 0x10 3.65v */
+     .power_1 = 0x10,
+     /* 0x10 AVDD=vci*2, VGH=vci*7, VGL=-vci*4 */
+     .power_2 = 0x10,
+     /* 0x45 VCOMH 4.425v, 0x15 VCOML -1.975*/
+     .vcom_1 = {0x45, 0x15},
+     /* 0x90 offset voltage, VMH-48, VML-48 */
+     .vcom_2 = 0x90,
+     /* 0xc8 Row Address Order, Column Address Order
+      * BGR 1
+      */
+     .address_mode = 0xc8,
+     .g3amma_en = 0x00,
+     /* 0xc2
+      * Display Data Path: Memory
+      * RGB: DE mode
+      * DOTCLK polarity set (data fetched at the falling time)
+      */
+     .rgb_interface = ILI9341_RGB_DISP_PATH_MEM |
+                     ILI9341_RGB_DE_MODE |
+                     ILI9341_RGB_DPL,
+     /*
+      * 0x0a
+      * Gate outputs in non-display area: Interval scan
+      * Determine source/VCOM output in a non-display area in the partial
+      * display mode: AGND AGND AGND AGND
+      *
+      * 0xa7
+      * Scan Cycle: 15 frames
+      * fFLM = 60Hz: 255ms
+      * Liquid crystal type: Normally white
+      * Gate Output Scan Direction: G1 -> G320
+      * Source Output Scan Direction: S720 -> S1
+      *
+      * 0x27
+      * LCD Driver Line: 320 lines
+      *
+      * 0x04
+      * PCDIV: 4
+      */
+     .dfc_2 = {0x0a, 0xa7, 0x27, 0x04},
+     /* column address: 240 */
+     .column_addr = {0x00, 0x00, (ILI9341_COLUMN_ADDR >> 4) & 0xff,
+                             ILI9341_COLUMN_ADDR & 0xff},
+     /* page address: 320 */
+     .page_addr = {0x00, 0x00, (ILI9341_PAGE_ADDR >> 4) & 0xff,
+                             ILI9341_PAGE_ADDR & 0xff},
+     /* Memory write control: When the transfer number of data exceeds
+      * (EC-SC+1)*(EP-SP+1), the column and page number will be
+      * reset, and the exceeding data will be written into the following
+      * column and page.
+      * Display Operation Mode: RGB Interface Mode
+      * Interface for RAM Access: RGB interface
+      * 16- bit RGB interface (1 transfer/pixel)
+      */
+     .interface = {ILI9341_IF_WE_MODE, 0x00,
+                     ILI9341_IF_DM_RGB | ILI9341_IF_RM_RGB},
+     /* DPI: 16 bits / pixel */
+     .pixel_format = ILI9341_PIXEL_DPI_16_BITS,
+     /* Curve Selected: Gamma curve 1 (G2.2) */
+     .gamma_curve = ILI9341_GAMMA_CURVE_1,
+     .pgamma = {0x0f, 0x29, 0x24, 0x0c, 0x0e,
+                     0x09, 0x4e, 0x78, 0x3c, 0x09,
+                     0x13, 0x05, 0x17, 0x11, 0x00},
+     .ngamma = {0x00, 0x16, 0x1b, 0x04, 0x11,
+                     0x07, 0x31, 0x33, 0x42, 0x05,
+                     0x0c, 0x0a, 0x28, 0x2f, 0x0f},
+};
+
+static inline struct ili9341 *panel_to_ili9341(struct drm_panel *panel)
+{
+     return container_of(panel, struct ili9341, panel);
+}
+
+static void ili9341_dpi_init(struct ili9341 *ili)
+{
+     struct mipi_dbi *dbi = ili->dbi;
+     struct ili9341_config *cfg = (struct ili9341_config *)ili->conf;
+
+     /* Power Control */
+     mipi_dbi_command_stackbuf(dbi, 0xca, cfg->ca, ILI9341_CA_LEN);
+     mipi_dbi_command_stackbuf(dbi, ILI9341_POWERB, cfg->power_b,
+                               ILI9341_POWER_B_LEN);
+     mipi_dbi_command_stackbuf(dbi, ILI9341_POWER_SEQ, cfg->power_seq,
+                               ILI9341_POWER_SEQ_LEN);
+     mipi_dbi_command_stackbuf(dbi, ILI9341_DTCA, cfg->dtca,
+                               ILI9341_DTCA_LEN);
+     mipi_dbi_command_stackbuf(dbi, ILI9341_POWERA, cfg->power_a,
+                               ILI9341_POWER_A_LEN);
+     mipi_dbi_command(ili->dbi, ILI9341_PRC, cfg->prc);
+     mipi_dbi_command_stackbuf(dbi, ILI9341_DTCB, cfg->dtcb,
+                               ILI9341_DTCB_LEN);
+     mipi_dbi_command_stackbuf(dbi, ILI9341_FRC, cfg->frc, ILI9341_FRC_LEN);
+     mipi_dbi_command_stackbuf(dbi, ILI9341_DFC, cfg->dfc_1,
+                               ILI9341_DFC_1_LEN);
+     mipi_dbi_command(dbi, ILI9341_POWER1, cfg->power_1);
+     mipi_dbi_command(dbi, ILI9341_POWER2, cfg->power_2);
+
+     /* VCOM */
+     mipi_dbi_command_stackbuf(dbi, ILI9341_VCOM1, cfg->vcom_1,
+                               ILI9341_VCOM_1_LEN);
+     mipi_dbi_command(dbi, ILI9341_VCOM2, cfg->vcom_2);
+     mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, cfg->address_mode);
+
+     /* Gamma */
+     mipi_dbi_command(dbi, ILI9341_3GAMMA_EN, cfg->g3amma_en);
+     mipi_dbi_command(dbi, ILI9341_RGB_INTERFACE, cfg->rgb_interface);
+     mipi_dbi_command_stackbuf(dbi, ILI9341_DFC, cfg->dfc_2,
+                               ILI9341_DFC_2_LEN);
+
+     /* Colomn address set */
+     mipi_dbi_command_stackbuf(dbi, MIPI_DCS_SET_COLUMN_ADDRESS,
+                               cfg->column_addr, ILI9341_COLUMN_ADDR_LEN);
+
+     /* Page address set */
+     mipi_dbi_command_stackbuf(dbi, MIPI_DCS_SET_PAGE_ADDRESS,
+                               cfg->page_addr, ILI9341_PAGE_ADDR_LEN);
+     mipi_dbi_command_stackbuf(dbi, ILI9341_INTERFACE, cfg->interface,
+                               ILI9341_INTERFACE_LEN);
+
+     /* Format */
+     mipi_dbi_command(dbi, MIPI_DCS_SET_PIXEL_FORMAT, cfg->pixel_format);
+     mipi_dbi_command(dbi, MIPI_DCS_WRITE_MEMORY_START);
+     msleep(200);
+     mipi_dbi_command(dbi, MIPI_DCS_SET_GAMMA_CURVE, cfg->gamma_curve);
+     mipi_dbi_command_stackbuf(dbi, ILI9341_PGAMMA, cfg->pgamma,
+                               ILI9341_PGAMMA_LEN);
+     mipi_dbi_command_stackbuf(dbi, ILI9341_NGAMMA, cfg->ngamma,
+                               ILI9341_NGAMMA_LEN);
+     mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE);
+     msleep(200);
+     mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON);
+     mipi_dbi_command(dbi, MIPI_DCS_WRITE_MEMORY_START);
+
+     dev_info(ili->dev, "initialized display rgb interface\n");
+}
+
+static int ili9341_dpi_power_on(struct ili9341 *ili)
+{
+     int ret = 0;
+
+     /* Assert RESET */
+     gpiod_set_value(ili->reset_gpio, 1);
+
+     /* Enable power */
+     ret = regulator_bulk_enable(ARRAY_SIZE(ili->supplies),
+                                 ili->supplies);
+     if (ret < 0) {
+             dev_err(ili->dev, "unable to enable vcc\n");
+             return ret;
+     }
+     msleep(20);
+
+     /* De-assert RESET */
+     gpiod_set_value(ili->reset_gpio, 0);
+     msleep(20);
+
+     return 0;
+}
+
+static int ili9341_dpi_power_off(struct ili9341 *ili)
+{
+     /* Assert RESET */
+     gpiod_set_value(ili->reset_gpio, 1);
+
+     /* Disable power */
+     return regulator_bulk_disable(ARRAY_SIZE(ili->supplies),
+                                   ili->supplies);
+}
+
+static int ili9341_dpi_disable(struct drm_panel *panel)
+{
+     struct ili9341 *ili = panel_to_ili9341(panel);
+
+     mipi_dbi_command(ili->dbi, MIPI_DCS_SET_DISPLAY_OFF);
+     return 0;
+}
+
+static int ili9341_dpi_unprepare(struct drm_panel *panel)
+{
+     struct ili9341 *ili = panel_to_ili9341(panel);
+
+     return ili9341_dpi_power_off(ili);
+}
+
+static int ili9341_dpi_prepare(struct drm_panel *panel)
+{
+     struct ili9341 *ili = panel_to_ili9341(panel);
+     int ret;
+
+     ret = ili9341_dpi_power_on(ili);
+     if (ret < 0)
+             return ret;
+
+     ili9341_dpi_init(ili);
+
+     return ret;
+}
+
+static int ili9341_dpi_enable(struct drm_panel *panel)
+{
+     struct ili9341 *ili = panel_to_ili9341(panel);
+
+     mipi_dbi_command(ili->dbi, MIPI_DCS_SET_DISPLAY_ON);
+     return 0;
+}
+
+static int ili9341_dpi_get_modes(struct drm_panel *panel,
+                              struct drm_connector *connector)
+{
+     struct ili9341 *ili = panel_to_ili9341(panel);
+     struct drm_device *drm = connector->dev;
+     struct drm_display_mode *mode;
+     struct drm_display_info *info;
+
+     info = &connector->display_info;
+     info->width_mm = ili->conf->mode.width_mm;
+     info->height_mm = ili->conf->mode.height_mm;
+
+     if (ili->conf->rgb_interface & ILI9341_RGB_DPL)
+             info->bus_flags |= DRM_BUS_FLAG_PIXDATA_DRIVE_POSEDGE;
+     else
+             info->bus_flags |= DRM_BUS_FLAG_PIXDATA_DRIVE_NEGEDGE;
+
+     if (ili->conf->rgb_interface & ILI9341_RGB_EPL)
+             info->bus_flags |= DRM_BUS_FLAG_DE_LOW;
+     else
+             info->bus_flags |= DRM_BUS_FLAG_DE_HIGH;
Quoted 8 lines

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 447

Quoted 4 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +4 -0
+
+     mode = drm_mode_duplicate(drm, &ili->conf->mode);
+     if (!mode) {
+             DRM_ERROR("bad mode or failed to add mode\n");

DRM_ERROR and friends are not used in panel/* - the new variants drm_err() shall be used.
This goes for the other uses of DRM_* as well.

Okay, I will change to using drm_err().

Quoted 122 lines
Quoted 122 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +121 -0
+             return -EINVAL;
+     }
+     drm_mode_set_name(mode);
+
+     /* Set up the polarity */
+     if (ili->conf->rgb_interface & ILI9341_RGB_HSPL)
+             mode->flags |= DRM_MODE_FLAG_PHSYNC;
+     else
+             mode->flags |= DRM_MODE_FLAG_NHSYNC;
+
+     if (ili->conf->rgb_interface & ILI9341_RGB_VSPL)
+             mode->flags |= DRM_MODE_FLAG_PVSYNC;
+     else
+             mode->flags |= DRM_MODE_FLAG_NVSYNC;
+
+     drm_mode_probed_add(connector, mode);
+
+     return 1; /* Number of modes */
+}
+
+static const struct drm_panel_funcs ili9341_dpi_funcs = {
+     .disable = ili9341_dpi_disable,
+     .unprepare = ili9341_dpi_unprepare,
+     .prepare = ili9341_dpi_prepare,
+     .enable = ili9341_dpi_enable,
+     .get_modes = ili9341_dpi_get_modes,
+};
+
+static void ili9341_dbi_enable(struct drm_simple_display_pipe *pipe,
+                            struct drm_crtc_state *crtc_state,
+                            struct drm_plane_state *plane_state)
+{
+     struct mipi_dbi_dev *dbidev = drm_to_mipi_dbi_dev(pipe->crtc.dev);
+     struct mipi_dbi *dbi = &dbidev->dbi;
+     u8 addr_mode;
+     int ret, idx;
+
+     if (!drm_dev_enter(pipe->crtc.dev, &idx))
+             return;
+
+     DRM_DEBUG_KMS("\n");
+
+     ret = mipi_dbi_poweron_conditional_reset(dbidev);
+     if (ret < 0)
+             goto out_exit;
+     if (ret == 1)
+             goto out_enable;
+
+     mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_OFF);
+
+     mipi_dbi_command(dbi, ILI9341_POWERB, 0x00, 0xc1, 0x30);
+     mipi_dbi_command(dbi, ILI9341_POWER_SEQ, 0x64, 0x03, 0x12, 0x81);
+     mipi_dbi_command(dbi, ILI9341_DTCA, 0x85, 0x00, 0x78);
+     mipi_dbi_command(dbi, ILI9341_POWERA, 0x39, 0x2c, 0x00, 0x34, 0x02);
+     mipi_dbi_command(dbi, ILI9341_PRC, ILI9341_DBI_PRC_NORMAL);
+     mipi_dbi_command(dbi, ILI9341_DTCB, 0x00, 0x00);
+
+     /* Power Control */
+     mipi_dbi_command(dbi, ILI9341_POWER1, ILI9341_DBI_VCOMH_4P6V);
+     mipi_dbi_command(dbi, ILI9341_POWER2, ILI9341_DBI_PWR_2_DEFAULT);
+     /* VCOM */
+     mipi_dbi_command(dbi, ILI9341_VCOM1, ILI9341_DBI_VCOM_1_VMH_4P25V,
+                      ILI9341_DBI_VCOM_1_VML_1P5V);
+     mipi_dbi_command(dbi, ILI9341_VCOM2, ILI9341_DBI_VCOM_2_DEC_58);
+
+     /* Memory Access Control */
+     mipi_dbi_command(dbi, MIPI_DCS_SET_PIXEL_FORMAT,
+                      MIPI_DCS_PIXEL_FMT_16BIT);
+
+     /* Frame Rate */
+     mipi_dbi_command(dbi, ILI9341_FRC, ILI9341_DBI_FRC_DIVA & 0x03,
+                      ILI9341_DBI_FRC_RTNA & 0x1f);
+
+     /* Gamma */
+     mipi_dbi_command(dbi, ILI9341_3GAMMA_EN, 0x00);
+     mipi_dbi_command(dbi, MIPI_DCS_SET_GAMMA_CURVE, ILI9341_GAMMA_CURVE_1);
+     mipi_dbi_command(dbi, ILI9341_PGAMMA,
+                      0x0f, 0x31, 0x2b, 0x0c, 0x0e, 0x08, 0x4e, 0xf1,
+                      0x37, 0x07, 0x10, 0x03, 0x0e, 0x09, 0x00);
+     mipi_dbi_command(dbi, ILI9341_NGAMMA,
+                      0x00, 0x0e, 0x14, 0x03, 0x11, 0x07, 0x31, 0xc1,
+                      0x48, 0x08, 0x0f, 0x0c, 0x31, 0x36, 0x0f);
+
+     /* DDRAM */
+     mipi_dbi_command(dbi, ILI9341_ETMOD, ILI9341_DBI_EMS_GAS |
+                      ILI9341_DBI_EMS_DTS |
+                      ILI9341_DBI_EMS_GON);
+
+     /* Display */
+     mipi_dbi_command(dbi, ILI9341_DFC, 0x08, 0x82, 0x27, 0x00);
+     mipi_dbi_command(dbi, MIPI_DCS_EXIT_SLEEP_MODE);
+     msleep(100);
+
+     mipi_dbi_command(dbi, MIPI_DCS_SET_DISPLAY_ON);
+     msleep(100);
+
+out_enable:
+     switch (dbidev->rotation) {
+     default:
+             addr_mode = ILI9341_MADCTL_MX;
+             break;
+     case 90:
+             addr_mode = ILI9341_MADCTL_MV;
+             break;
+     case 180:
+             addr_mode = ILI9341_MADCTL_MY;
+             break;
+     case 270:
+             addr_mode = ILI9341_MADCTL_MV | ILI9341_MADCTL_MY |
+                         ILI9341_MADCTL_MX;
+             break;
+     }
+     addr_mode |= ILI9341_MADCTL_BGR;
+     mipi_dbi_command(dbi, MIPI_DCS_SET_ADDRESS_MODE, addr_mode);
+     mipi_dbi_enable_flush(dbidev, crtc_state, plane_state);
+     DRM_DEBUG_KMS("initialized display serial interface\n");
+out_exit:
+     drm_dev_exit(idx);
+}
+
+static const struct drm_simple_display_pipe_funcs ili9341_dbi_funcs = {
Quoted 8 lines

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 573

Quoted 5 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +5 -0
+     .enable = ili9341_dbi_enable,
+     .disable = mipi_dbi_pipe_disable,
+     .update = mipi_dbi_pipe_update,
+     .prepare_fb = drm_gem_simple_display_pipe_prepare_fb,
+};

So this is a full display driver. The more relevant home for this driver is inside drm/tiny/.

Yes, actually, this is the major topic I'd like to discuss with maintainers here.
There are some options to support this panel.

- support only-dbi interface by drm/tiny/ili9341.c
- support dbi(register) + dpi(data) by drm/panel/panel-ilitek-ili9341.c (remove the code copied from tiny/ili9341.c)
- move all the code which support dbi+dpi to drm/tiny/ili9341.c (remove this driver)
- keep this driver, remove tiny/ili9341.c

I don't have a preferred one for this, all fine with me. After I get the decision from you and other maintainers, I will change the code.

It's meanful for other panels which have the same situations.

Quoted 208 lines
Quoted 208 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +205 -1
+
+static const struct drm_display_mode ili9341_dbi_mode = {
+     DRM_SIMPLE_MODE(240, 320, 37, 49),
+};
+
+DEFINE_DRM_GEM_CMA_FOPS(ili9341_dbi_fops);
+
+static struct drm_driver ili9341_dbi_driver = {
+     .driver_features        = DRIVER_GEM | DRIVER_MODESET | DRIVER_ATOMIC,
+     .fops                   = &ili9341_dbi_fops,
+     DRM_GEM_CMA_DRIVER_OPS_VMAP,
+     .debugfs_init           = mipi_dbi_debugfs_init,
+     .name                   = "ili9341",
+     .desc                   = "Ilitek ILI9341",
+     .date                   = "20210716",
+     .major                  = 1,
+     .minor                  = 0,
+};
+
+static int _ili9341_probe(struct spi_device *spi, bool dpi)
+{
+     struct gpio_desc *dc;
+     struct gpio_desc *reset;
+     struct device *dev = &spi->dev;
+     int ret;
+
+     reset = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_HIGH);
+     if (IS_ERR(reset))
+             DRM_DEV_ERROR(dev, "Failed to get gpio 'reset'\n");
+
+     dc = devm_gpiod_get_optional(dev, "dc", GPIOD_OUT_LOW);
+     if (IS_ERR(dc))
+             DRM_DEV_ERROR(dev, "Failed to get gpio 'dc'\n");
+
+     if (!dpi) {
+             struct mipi_dbi_dev *dbidev;
+             struct mipi_dbi *dbi;
+             struct drm_device *drm;
+             struct regulator *vcc;
+             u32 rotation = 0;
+
+             vcc = devm_regulator_get_optional(dev, "vcc");
+             if (IS_ERR(vcc))
+                     DRM_DEV_ERROR(dev, "get optional vcc failed\n");
+
+             dbidev = devm_drm_dev_alloc(dev, &ili9341_dbi_driver,
+                                         struct mipi_dbi_dev, drm);
+             if (IS_ERR(dbidev))
+                     return PTR_ERR(dbidev);
+
+             dbi = &dbidev->dbi;
+             drm = &dbidev->drm;
+             dbi->reset = reset;
+             dbidev->regulator = vcc;
+
+             drm_mode_config_init(drm);
+             dbidev->backlight = devm_of_find_backlight(dev);
+             if (IS_ERR(dbidev->backlight))
+                     return PTR_ERR(dbidev->backlight);
+
+             device_property_read_u32(dev, "rotation", &rotation);
+
+             ret = mipi_dbi_spi_init(spi, dbi, dc);
+             if (ret)
+                     return ret;
+
+             ret = mipi_dbi_dev_init(dbidev, &ili9341_dbi_funcs,
+                                     &ili9341_dbi_mode, rotation);
+             if (ret)
+                     return ret;
+
+             drm_mode_config_reset(drm);
+
+             ret = drm_dev_register(drm, 0);
+             if (ret)
+                     return ret;
+
+             spi_set_drvdata(spi, drm);
+
+             drm_fbdev_generic_setup(drm, 0);
+     } else {
+             struct ili9341 *ili;
+
+             ili = devm_kzalloc(dev, sizeof(struct ili9341), GFP_KERNEL);
+             if (!ili)
+                     return -ENOMEM;
+
+             ili->dbi = devm_kzalloc(dev, sizeof(struct mipi_dbi),
+                                     GFP_KERNEL);
+             if (!ili->dbi)
+                     return -ENOMEM;
+
+             ili->supplies[0].supply = "vci";
+             ili->supplies[1].supply = "vddi";
+             ili->supplies[2].supply = "vddi-led";
+
+             ret = devm_regulator_bulk_get(dev, ARRAY_SIZE(ili->supplies),
+                                           ili->supplies);
+             if (ret < 0) {
+                     dev_err(dev, "failed to get regulators: %d\n", ret);
+                     return ret;
+             }
+
+             ret = mipi_dbi_spi_init(spi, ili->dbi, dc);
+             if (ret)
+                     return ret;
+
+             spi_set_drvdata(spi, ili);
+
+             ili->dev = dev;
+             ili->reset_gpio = reset;
+             /*
+              * Every new incarnation of this display must have a unique
+              * data entry for the system in this driver.
+              */
+             ili->conf = of_device_get_match_data(dev);
+             if (!ili->conf) {
+                     dev_err(dev, "missing device configuration\n");
+                     return -ENODEV;
+             }
+
+             ili->max_spi_speed = ili->conf->max_spi_speed;
+
+             drm_panel_init(&ili->panel, dev, &ili9341_dpi_funcs,
+                            DRM_MODE_CONNECTOR_DPI);
+
+             drm_panel_add(&ili->panel);
+     }
+
+     return 0;
+}
+
+static int ili9341_probe(struct spi_device *spi)
+{
+     const struct spi_device_id *id = spi_get_device_id(spi);
+
+     if (!strcmp(id->name, "sf-tc240t-9370-t"))
+             return _ili9341_probe(spi, true);
+     else if (!strcmp(id->name, "yx240qv29"))
+             return _ili9341_probe(spi, false);
+
+     return -1;
+}
+
+static int ili9341_remove(struct spi_device *spi)
+{
+     const struct spi_device_id *id = spi_get_device_id(spi);
+     struct ili9341 *ili = spi_get_drvdata(spi);
+     struct drm_device *drm = spi_get_drvdata(spi);
+
+     if (!strcmp(id->name, "sf-tc240t-9370-t")) {
+             ili9341_dpi_power_off(ili);
+             drm_panel_remove(&ili->panel);
+     } else if (!strcmp(id->name, "yx240qv29")) {
+             drm_dev_unplug(drm);
+             drm_atomic_helper_shutdown(drm);
+     }
+     return 0;
+}
+
+static void ili9341_shutdown(struct spi_device *spi)
+{
+     const struct spi_device_id *id = spi_get_device_id(spi);
+
+     if (!strcmp(id->name, "yx240qv29"))
+             drm_atomic_helper_shutdown(spi_get_drvdata(spi));
+}
+
+static const struct of_device_id ili9341_of_match[] = {
+     {
+             .compatible = "st,sf-tc240t-9370-t",
+             .data = &ili9341_stm32f429_disco_data,
+     },
+     {
+             /* porting from tiny/ili9341.c
+              * for original mipi dbi compitable
+              */
+             .compatible = "adafruit,yx240qv29",
+             .data = NULL,
+     },
+};
+MODULE_DEVICE_TABLE(of, ili9341_of_match);
+
+static const struct spi_device_id ili9341_id[] = {
+     { "yx240qv29", 0 },
+     { "sf-tc240t-9370-t", 0 },
+     { }
+};
+MODULE_DEVICE_TABLE(spi, ili9341_id);
+
+static struct spi_driver ili9341_driver = {
+     .probe = ili9341_probe,
+     .remove = ili9341_remove,
+     .shutdown = ili9341_shutdown,
+     .id_table = ili9341_id,
+     .driver = {
+             .name = "panel-ilitek-ili9341",
+             .of_match_table = ili9341_of_match,
+     },
+};
+module_spi_driver(ili9341_driver);
+
+MODULE_AUTHOR("Dillon Min <[email protected]>");
+MODULE_DESCRIPTION("ILI9341 LCD panel driver");
+MODULE_LICENSE("GPL v2");
--

2.7.4

#15 lore raw

Re: [PATCH v2 3/3] drm/panel: Add ilitek ili9341 panel driver

In reply to [email protected]

Den 21.07.2021 09.41, skrev [email protected]:

Quoted 10 lines

From: Dillon Min <[email protected]>

This driver combine tiny/ili9341.c mipi_dbi_interface driver with mipi_dpi_interface driver, can support ili9341 with serial mode or parallel rgb interface mode by register configuration.

Cc Linus Walleij <[email protected]>

---

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 751

Quoted 10 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +10 -0
+static const struct of_device_id ili9341_of_match[] = {
+	{
+		.compatible = "st,sf-tc240t-9370-t",
+		.data = &ili9341_stm32f429_disco_data,
+	},
+	{
+		/* porting from tiny/ili9341.c
+		 * for original mipi dbi compitable
+		 */
+		.compatible = "adafruit,yx240qv29",

I don't understand this, now there will be 2 drivers that support the same display?

AFAICT drm/tiny/ili9341.c is just copied into this driver, is the plan to remove the tiny/ driver? If so I couldn't see this mentioned anywhere.

Noralf.

Quoted 4 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +4 -0
+		.data = NULL,
+	},
+};
+MODULE_DEVICE_TABLE(of, ili9341_of_match);
author
#16 lore raw

Re: [PATCH v2 3/3] drm/panel: Add ilitek ili9341 panel driver

Hi Noralf

Thanks for your time to review my patch.

Quoted 25 lines · Noralf Trønnes

Den 21.07.2021 09.41, skrev [email protected]:

Quoted 10 lines

From: Dillon Min <[email protected]>

This driver combine tiny/ili9341.c mipi_dbi_interface driver with mipi_dpi_interface driver, can support ili9341 with serial mode or parallel rgb interface mode by register configuration.

Cc Linus Walleij <[email protected]>

---

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 751

Quoted 10 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +10 -0
+static const struct of_device_id ili9341_of_match[] = {
+     {
+             .compatible = "st,sf-tc240t-9370-t",
+             .data = &ili9341_stm32f429_disco_data,
+     },
+     {
+             /* porting from tiny/ili9341.c
+              * for original mipi dbi compitable
+              */
+             .compatible = "adafruit,yx240qv29",
Quoted 2 lines

I don't understand this, now there will be 2 drivers that support the same display?

There is no reason to create two drivers to support the same display.

To support only-dbi and dbi+dpi panel at drm/panel or drm/tiny both fine with me.

Quoted 3 lines

AFAICT drm/tiny/ili9341.c is just copied into this driver, is the plan to remove the tiny/ driver? If so I couldn't see this mentioned anywhere.

Yes, I'd like to merge the code from drm/tiny/ili9341.c to this driver (to make a single driver to support different bus).

I have two purpose to extend the feature drm/tiny/ili9341.c

- keep compatible = "adafruit,yx240qv29", add bus mode dts bindings (panel_bus) to define the interface which host wants to use. such as
panel_bus="dbi" or "rgb"
or "i80" for this case, i will add dpi code to drm/tiny/ili9341.c.

- merge tiny/ili9341.c to this driver,remove drm/tiny/ili9341.c, add new dts compatible
string to support other interfaces. just like what i'm doing now.

I have no idea about your plan on drm/tiny drivers, actually some of these panels under
the diny folder can support both dbi and dbi+dpi (much faster, need more pins). no
doubt the requirement to support dpi is always there.

What is your preference?

Thanks & Regards
Dillon

Quoted 7 lines

Noralf.

Quoted 4 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +4 -0
+             .data = NULL,
+     },
+};
+MODULE_DEVICE_TABLE(of, ili9341_of_match);
#17 lore raw

Re: [PATCH v2 3/3] drm/panel: Add ilitek ili9341 panel driver

Den 22.07.2021 04.07, skrev Dillon Min:

Quoted 56 lines

Hi Noralf

Thanks for your time to review my patch.

Quoted 25 lines · Noralf Trønnes

Den 21.07.2021 09.41, skrev [email protected]:

Quoted 10 lines

From: Dillon Min <[email protected]>

This driver combine tiny/ili9341.c mipi_dbi_interface driver with mipi_dpi_interface driver, can support ili9341 with serial mode or parallel rgb interface mode by register configuration.

Cc Linus Walleij <[email protected]>

---

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 751

Quoted 10 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +10 -0
+static const struct of_device_id ili9341_of_match[] = {
+     {
+             .compatible = "st,sf-tc240t-9370-t",
+             .data = &ili9341_stm32f429_disco_data,
+     },
+     {
+             /* porting from tiny/ili9341.c
+              * for original mipi dbi compitable
+              */
+             .compatible = "adafruit,yx240qv29",
Quoted 2 lines

I don't understand this, now there will be 2 drivers that support the same display?

There is no reason to create two drivers to support the same display.

To support only-dbi and dbi+dpi panel at drm/panel or drm/tiny both fine with me.

Quoted 3 lines

AFAICT drm/tiny/ili9341.c is just copied into this driver, is the plan to remove the tiny/ driver? If so I couldn't see this mentioned anywhere.

Yes, I'd like to merge the code from drm/tiny/ili9341.c to this driver (to make a single driver to support different bus).

I have two purpose to extend the feature drm/tiny/ili9341.c

- keep compatible = "adafruit,yx240qv29", add bus mode dts bindings (panel_bus) to define the interface which host wants to use. such as
panel_bus="dbi" or "rgb"
or "i80" for this case, i will add dpi code to drm/tiny/ili9341.c.

- merge tiny/ili9341.c to this driver,remove drm/tiny/ili9341.c, add new dts compatible
string to support other interfaces. just like what i'm doing now.

Quoted 8 lines

I have no idea about your plan on drm/tiny drivers, actually some of these panels under
the diny folder can support both dbi and dbi+dpi (much faster, need more pins). no
doubt the requirement to support dpi is always there.

What is your preference?

I have no plans for tiny/, it's just a place to put tiny DRM drivers of all sorts.

Whether or not to have "full" DRM drivers in panel/ is up to Sam and Laurent I guess, currently there's only drm_panel drivers in there. I have no objections to doing that though.

I just wanted to make sure we don't have 2 drivers for the same display.

Noralf.

Quoted 10 lines

Thanks & Regards
Dillon

Quoted 7 lines

Noralf.

Quoted 4 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +4 -0
+             .data = NULL,
+     },
+};
+MODULE_DEVICE_TABLE(of, ili9341_of_match);
author
#18 lore raw

Re: [PATCH v2 3/3] drm/panel: Add ilitek ili9341 panel driver

Hi Noralf,

Quoted 66 lines · Noralf Trønnes

Den 22.07.2021 04.07, skrev Dillon Min:

Quoted 62 lines

Hi Noralf

Thanks for your time to review my patch.

Quoted 25 lines · Noralf Trønnes

Den 21.07.2021 09.41, skrev [email protected]:

Quoted 10 lines

From: Dillon Min <[email protected]>

This driver combine tiny/ili9341.c mipi_dbi_interface driver with mipi_dpi_interface driver, can support ili9341 with serial mode or parallel rgb interface mode by register configuration.

Cc Linus Walleij <[email protected]>

---

drivers/gpu/drm/panel/panel-ilitek-ili9341.c line 751

Quoted 10 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +10 -0
+static const struct of_device_id ili9341_of_match[] = {
+     {
+             .compatible = "st,sf-tc240t-9370-t",
+             .data = &ili9341_stm32f429_disco_data,
+     },
+     {
+             /* porting from tiny/ili9341.c
+              * for original mipi dbi compitable
+              */
+             .compatible = "adafruit,yx240qv29",
Quoted 2 lines

I don't understand this, now there will be 2 drivers that support the same display?

There is no reason to create two drivers to support the same display.

To support only-dbi and dbi+dpi panel at drm/panel or drm/tiny both fine with me.

Quoted 3 lines

AFAICT drm/tiny/ili9341.c is just copied into this driver, is the plan to remove the tiny/ driver? If so I couldn't see this mentioned anywhere.

Yes, I'd like to merge the code from drm/tiny/ili9341.c to this driver (to make a single driver to support different bus).

I have two purpose to extend the feature drm/tiny/ili9341.c

- keep compatible = "adafruit,yx240qv29", add bus mode dts bindings (panel_bus) to define the interface which host wants to use. such as
panel_bus="dbi" or "rgb"
or "i80" for this case, i will add dpi code to drm/tiny/ili9341.c.

- merge tiny/ili9341.c to this driver,remove drm/tiny/ili9341.c, add new dts compatible
string to support other interfaces. just like what i'm doing now.

I have no idea about your plan on drm/tiny drivers, actually some of these panels under
the diny folder can support both dbi and dbi+dpi (much faster, need more pins). no
doubt the requirement to support dpi is always there.

Quoted 5 lines
Quoted 2 lines

What is your preference?

I have no plans for tiny/, it's just a place to put tiny DRM drivers of all sorts.

Thanks for clarifying.

Quoted 6 lines

Whether or not to have "full" DRM drivers in panel/ is up to Sam and Laurent I guess, currently there's only drm_panel drivers in there. I have no objections to doing that though.

I just wanted to make sure we don't have 2 drivers for the same display.

Sure, agree with you, sorry for not mentioning it in the cover letter. I'm waiting for Sam and Laurent's feedback, then submit v3 after that.

Best regards.
Dillon

Quoted 13 lines

Noralf.

Quoted 10 lines

Thanks & Regards
Dillon

Quoted 7 lines

Noralf.

Quoted 4 lines
drivers/gpu/drm/panel/panel-ilitek-ili9341.c new file +4 -0
+             .data = NULL,
+     },
+};
+MODULE_DEVICE_TABLE(of, ili9341_of_match);