[PATCH 14/32] drm/mipi-dsi: add .attach_new to mipi_dsi_host_ops

Luca Ceresoli luca.ceresoli at bootlin.com
Wed Jun 25 16:45:18 UTC 2025


In preparation to avoid DSI host drivers to take any pointer to struct
mipi_dsi_device, add a new host op which does not take such pointer. The
old op can be removed once all users are converted to the new one.

The .attach_new op takes the DSI device format values, (part of) which are
needed by most DSI host drivers. It passes a temporary struct, in order to
ensure host drivers copy the values they need and not keep a pointer.

The struct with the data (struct mipi_dsi_bus_fmt) is a subset of struct
mipi_dsi_device. After all host drivers are converted, struct
mipi_dsi_device can be modified to hold a struct mipi_dsi_bus_fmt instead
of individual fields.

Signed-off-by: Luca Ceresoli <luca.ceresoli at bootlin.com>
---
 drivers/gpu/drm/drm_mipi_dsi.c | 21 +++++++++++++++++++--
 include/drm/drm_mipi_dsi.h     | 29 ++++++++++++++++++++++++++++-
 2 files changed, 47 insertions(+), 3 deletions(-)

diff --git a/drivers/gpu/drm/drm_mipi_dsi.c b/drivers/gpu/drm/drm_mipi_dsi.c
index f16f70c70c87988a95f959d0b8b18a6941dd2808..f45425f777f6bed6ac5f261b0097455c52ab7d9e 100644
--- a/drivers/gpu/drm/drm_mipi_dsi.c
+++ b/drivers/gpu/drm/drm_mipi_dsi.c
@@ -367,6 +367,18 @@ void mipi_dsi_host_unregister(struct mipi_dsi_host *host)
 }
 EXPORT_SYMBOL(mipi_dsi_host_unregister);
 
+static void mipi_dsi_dev_copy_bus_fmt(struct mipi_dsi_bus_fmt *fmt,
+				      const struct mipi_dsi_device *dsi_dev)
+{
+	fmt->channel	= dsi_dev->channel;
+	fmt->lanes	= dsi_dev->lanes;
+	fmt->format	= dsi_dev->format;
+	fmt->mode_flags	= dsi_dev->mode_flags;
+	fmt->hs_rate	= dsi_dev->hs_rate;
+	fmt->lp_rate	= dsi_dev->lp_rate;
+	fmt->dsc	= dsi_dev->dsc;
+}
+
 /**
  * mipi_dsi_attach - attach a DSI device to its DSI host
  * @dsi: DSI peripheral
@@ -374,15 +386,20 @@ EXPORT_SYMBOL(mipi_dsi_host_unregister);
 int mipi_dsi_attach(struct mipi_dsi_device *dsi)
 {
 	const struct mipi_dsi_host_ops *ops = dsi->host->ops;
+	struct mipi_dsi_bus_fmt bus_fmt;
 	int ret;
 
-	if (!ops || !ops->attach)
+	if (!ops || !(ops->attach_new || ops->attach))
 		return -ENOSYS;
 
 	if (dsi->lanes < 1)
 		return dev_err_probe(&dsi->dev, -EINVAL, "Incorrect lanes number\n");
 
-	ret = ops->attach(dsi->host, dsi);
+	mipi_dsi_dev_copy_bus_fmt(&bus_fmt, dsi);
+
+	ret = ops->attach_new ?
+		ops->attach_new(dsi->host, &bus_fmt) :
+		ops->attach(dsi->host, dsi);
 	if (ret) {
 		dev_err(dsi->host->dev,
 			"Failed to attach %s device (lanes:%d bpp:%d mode-flags:0x%lx) (%d)\n",
diff --git a/include/drm/drm_mipi_dsi.h b/include/drm/drm_mipi_dsi.h
index e42483fd022fed4dfc9e5ef180117c3dd37a3b51..5d5f3dca1ec1a654378ccca15f3f15a5ce957518 100644
--- a/include/drm/drm_mipi_dsi.h
+++ b/include/drm/drm_mipi_dsi.h
@@ -102,9 +102,34 @@ enum mipi_dsi_pixel_format {
 
 #define DSI_DEV_NAME_SIZE		20
 
+/**
+ * struct mipi_dsi_bus_fmt - format required by a DSI peripheral device
+ * @channel: virtual channel assigned to the peripheral
+ * @format: pixel format for video mode
+ * @lanes: number of active data lanes
+ * @mode_flags: DSI operation mode related flags
+ * @hs_rate: maximum lane frequency for high speed mode in hertz, this should
+ * be set to the real limits of the hardware, zero is only accepted for
+ * legacy drivers
+ * @lp_rate: maximum lane frequency for low power mode in hertz, this should
+ * be set to the real limits of the hardware, zero is only accepted for
+ * legacy drivers
+ * @dsc: panel/bridge DSC pps payload to be sent
+ */
+struct mipi_dsi_bus_fmt {
+	unsigned int channel;
+	unsigned int lanes;
+	enum mipi_dsi_pixel_format format;
+	unsigned long mode_flags;
+	unsigned long hs_rate;
+	unsigned long lp_rate;
+	struct drm_dsc_config *dsc;
+};
+
 /**
  * struct mipi_dsi_host_ops - DSI bus operations
- * @attach: attach DSI device to DSI host
+ * @attach_new: attach DSI device to DSI host; either @attach_new or @attach is mandatory
+ * @attach: deprecated version of @attach_new
  * @detach: detach DSI device from DSI host
  * @transfer: transmit a DSI packet
  *
@@ -126,6 +151,8 @@ enum mipi_dsi_pixel_format {
  * properly enabled.
  */
 struct mipi_dsi_host_ops {
+	int (*attach_new)(struct mipi_dsi_host *host,
+			  const struct mipi_dsi_bus_fmt *bus_fmt);
 	int (*attach)(struct mipi_dsi_host *host,
 		      struct mipi_dsi_device *dsi);
 	int (*detach)(struct mipi_dsi_host *host,

-- 
2.49.0



More information about the dri-devel mailing list