[RFC PATCH 3/4] gpu/drm: Add TinyDRM for DSI/DBI panels

Sandy Huang sandy.huang01 at yahoo.com
Wed Jul 8 02:26:40 UTC 2020


Hi paul,

     After add this driver, the followinig usage scenarios can be supported?

     panel 1. crtc->encoder->connector[edp/hdmi/mipi dsi] -> panel

     panel 2. Panel setup/control and framebuffer upload over SPI

     the two panel maybe display same/different conctent at same time.


在 2020/6/7 21:38, Paul Cercueil 写道:
> The new API function mipi_dsi_maybe_register_tiny_driver() is supposed
> to be called by DSI/DBI panel drivers at the end of their probe.
>
> If it is detected that the panel is not connected to any controller,
> because it has no port #0 node in Device Tree that points back to it,
> then a TinyDRM driver is registered with it.
>
> This TinyDRM driver expects that a DCS-compliant protocol is used by the
> DSI/DBI panel and can only be used with these.
>
> Signed-off-by: Paul Cercueil <paul at crapouillou.net>
> ---
>   drivers/gpu/drm/tiny/Kconfig    |   8 +
>   drivers/gpu/drm/tiny/Makefile   |   1 +
>   drivers/gpu/drm/tiny/tiny-dsi.c | 262 ++++++++++++++++++++++++++++++++
>   include/drm/drm_mipi_dsi.h      |  19 +++
>   4 files changed, 290 insertions(+)
>   create mode 100644 drivers/gpu/drm/tiny/tiny-dsi.c
>
> diff --git a/drivers/gpu/drm/tiny/Kconfig b/drivers/gpu/drm/tiny/Kconfig
> index 4160e74e4751..54ee58aecf66 100644
> --- a/drivers/gpu/drm/tiny/Kconfig
> +++ b/drivers/gpu/drm/tiny/Kconfig
> @@ -9,6 +9,14 @@ config DRM_GM12U320
>   	 This is a KMS driver for projectors which use the GM12U320 chipset
>   	 for video transfer over USB2/3, such as the Acer C120 mini projector.
>   
> +config TINYDRM_DSI
> +	tristate "DRM support for generic DBI/DSI display panels"
> +	depends on DRM && DRM_MIPI_DSI
> +	select DRM_MIPI_DBI
> +	select DRM_KMS_CMA_HELPER
> +	help
> +	  DRM driver for generic DBI/DSI display panels
> +
>   config TINYDRM_HX8357D
>   	tristate "DRM support for HX8357D display panels"
>   	depends on DRM && SPI
> diff --git a/drivers/gpu/drm/tiny/Makefile b/drivers/gpu/drm/tiny/Makefile
> index c96ceee71453..49513db9a307 100644
> --- a/drivers/gpu/drm/tiny/Makefile
> +++ b/drivers/gpu/drm/tiny/Makefile
> @@ -1,6 +1,7 @@
>   # SPDX-License-Identifier: GPL-2.0-only
>   
>   obj-$(CONFIG_DRM_GM12U320)		+= gm12u320.o
> +obj-$(CONFIG_TINYDRM_DSI)		+= tiny-dsi.o
>   obj-$(CONFIG_TINYDRM_HX8357D)		+= hx8357d.o
>   obj-$(CONFIG_TINYDRM_ILI9225)		+= ili9225.o
>   obj-$(CONFIG_TINYDRM_ILI9341)		+= ili9341.o
> diff --git a/drivers/gpu/drm/tiny/tiny-dsi.c b/drivers/gpu/drm/tiny/tiny-dsi.c
> new file mode 100644
> index 000000000000..915e598844bd
> --- /dev/null
> +++ b/drivers/gpu/drm/tiny/tiny-dsi.c
> @@ -0,0 +1,262 @@
> +// SPDX-License-Identifier: GPL-2.0-or-later
> +/*
> + * TinyDRM driver for standard DSI/DBI panels
> + *
> + * Copyright 2020 Paul Cercueil <paul at crapouillou.net>
> + */
> +
> +#include <linux/module.h>
> +
> +#include <drm/drm_atomic_helper.h>
> +#include <drm/drm_damage_helper.h>
> +#include <drm/drm_drv.h>
> +#include <drm/drm_fb_helper.h>
> +#include <drm/drm_fourcc.h>
> +#include <drm/drm_gem_cma_helper.h>
> +#include <drm/drm_gem_framebuffer_helper.h>
> +#include <drm/drm_mipi_dbi.h>
> +#include <drm/drm_mipi_dsi.h>
> +#include <drm/drm_modeset_helper.h>
> +#include <drm/drm_panel.h>
> +#include <drm/drm_probe_helper.h>
> +
> +#include <video/mipi_display.h>
> +
> +struct tiny_dsi {
> +	struct drm_device drm;
> +	struct drm_connector connector;
> +	struct drm_simple_display_pipe pipe;
> +
> +	struct mipi_dsi_device *dsi;
> +	struct drm_panel *panel;
> +};
> +
> +#define mipi_dcs_command(dsi, cmd, seq...) \
> +({ \
> +	u8 d[] = { seq }; \
> +	mipi_dsi_dcs_write(dsi, cmd, d, ARRAY_SIZE(d)); \
> +})
> +
> +static inline struct tiny_dsi *drm_to_tiny_dsi(struct drm_device *drm)
> +{
> +	return container_of(drm, struct tiny_dsi, drm);
> +}
> +
> +static void tiny_dsi_fb_dirty(struct drm_framebuffer *fb, struct drm_rect *rect)
> +{
> +	struct drm_gem_object *gem = drm_gem_fb_get_obj(fb, 0);
> +	struct drm_gem_cma_object *cma_obj = to_drm_gem_cma_obj(gem);
> +	struct tiny_dsi *priv = drm_to_tiny_dsi(fb->dev);
> +	unsigned int height = rect->y2 - rect->y1;
> +	unsigned int width = rect->x2 - rect->x1;
> +	bool fb_convert;
> +	int idx, ret;
> +	void *tr;
> +
> +	if (!drm_dev_enter(fb->dev, &idx))
> +		return;
> +
> +	DRM_DEBUG_KMS("Flushing [FB:%d] " DRM_RECT_FMT "\n", fb->base.id, DRM_RECT_ARG(rect));
> +
> +	fb_convert = width != fb->width || height != fb->height
> +		|| fb->format->format == DRM_FORMAT_XRGB8888;
> +	if (fb_convert) {
> +		tr = kzalloc(width * height * 2, GFP_KERNEL);
> +
> +		/* TODO: swap pixels if needed */
> +		ret = mipi_dbi_buf_copy(tr, fb, rect, false);
> +		if (ret)
> +			goto err_msg;
> +	} else {
> +		tr = cma_obj->vaddr;
> +	}
> +
> +	mipi_dcs_command(priv->dsi, MIPI_DCS_SET_COLUMN_ADDRESS,
> +			 (rect->x1 >> 8) & 0xff, rect->x1 & 0xff,
> +			 (rect->x2 >> 8) & 0xff, rect->x2 & 0xff);
> +	mipi_dcs_command(priv->dsi, MIPI_DCS_SET_PAGE_ADDRESS,
> +			 (rect->y1 >> 8) & 0xff, rect->y1 & 0xff,
> +			 (rect->y2 >> 8) & 0xff, rect->y2 & 0xff);
> +
> +	ret = mipi_dsi_dcs_write(priv->dsi, MIPI_DCS_WRITE_MEMORY_START,
> +				 tr, width * height * 2);
> +err_msg:
> +	if (ret)
> +		dev_err_once(fb->dev->dev, "Failed to update display %d\n", ret);
> +
> +	if (fb_convert)
> +		kfree(tr);
> +	drm_dev_exit(idx);
> +}
> +
> +static void tiny_dsi_enable(struct drm_simple_display_pipe *pipe,
> +			    struct drm_crtc_state *crtc_state,
> +			    struct drm_plane_state *plane_state)
> +{
> +	struct tiny_dsi *priv = drm_to_tiny_dsi(pipe->crtc.dev);
> +
> +	drm_panel_enable(priv->panel);
> +}
> +
> +static void tiny_dsi_disable(struct drm_simple_display_pipe *pipe)
> +{
> +	struct tiny_dsi *priv = drm_to_tiny_dsi(pipe->crtc.dev);
> +
> +	drm_panel_disable(priv->panel);
> +}
> +
> +static void tiny_dsi_update(struct drm_simple_display_pipe *pipe,
> +			    struct drm_plane_state *old_state)
> +{
> +	struct drm_plane_state *state = pipe->plane.state;
> +	struct drm_rect rect;
> +
> +	if (drm_atomic_helper_damage_merged(old_state, state, &rect))
> +		tiny_dsi_fb_dirty(state->fb, &rect);
> +}
> +
> +static const struct drm_simple_display_pipe_funcs tiny_dsi_pipe_funcs = {
> +	.enable = tiny_dsi_enable,
> +	.disable = tiny_dsi_disable,
> +	.update = tiny_dsi_update,
> +	.prepare_fb = drm_gem_fb_simple_display_pipe_prepare_fb,
> +};
> +
> +static int tiny_dsi_connector_get_modes(struct drm_connector *connector)
> +{
> +	struct tiny_dsi *priv = drm_to_tiny_dsi(connector->dev);
> +
> +	return drm_panel_get_modes(priv->panel, connector);
> +}
> +
> +static const struct drm_connector_helper_funcs tiny_dsi_connector_hfuncs = {
> +	.get_modes = tiny_dsi_connector_get_modes,
> +};
> +
> +static const struct drm_connector_funcs tiny_dsi_connector_funcs = {
> +	.reset = drm_atomic_helper_connector_reset,
> +	.fill_modes = drm_helper_probe_single_connector_modes,
> +	.destroy = drm_connector_cleanup,
> +	.atomic_duplicate_state = drm_atomic_helper_connector_duplicate_state,
> +	.atomic_destroy_state = drm_atomic_helper_connector_destroy_state,
> +};
> +
> +DEFINE_DRM_GEM_CMA_FOPS(tiny_dsi_fops);
> +
> +static const uint32_t tiny_dsi_formats[] = {
> +	DRM_FORMAT_RGB565,
> +	DRM_FORMAT_XRGB8888,
> +};
> +
> +static const struct drm_mode_config_funcs tiny_dsi_mode_config_funcs = {
> +	.fb_create = drm_gem_fb_create_with_dirty,
> +	.atomic_check = drm_atomic_helper_check,
> +	.atomic_commit = drm_atomic_helper_commit,
> +};
> +
> +static void tiny_dsi_release(struct drm_device *drm)
> +{
> +	struct tiny_dsi *priv = drm_to_tiny_dsi(drm);
> +
> +	drm_mode_config_cleanup(drm);
> +	drm_dev_fini(drm);
> +	kfree(priv);
> +}
> +
> +static struct drm_driver tiny_dsi_driver = {
> +	.driver_features	= DRIVER_GEM | DRIVER_MODESET | DRIVER_ATOMIC,
> +	.fops			= &tiny_dsi_fops,
> +	.release		= tiny_dsi_release,
> +	DRM_GEM_CMA_VMAP_DRIVER_OPS,
> +	.name			= "tiny-dsi",
> +	.desc			= "Tiny DSI",
> +	.date			= "20200605",
> +	.major			= 1,
> +	.minor			= 0,
> +};
> +
> +static void tiny_dsi_remove(void *drm)
> +{
> +	drm_dev_unplug(drm);
> +	drm_atomic_helper_shutdown(drm);
> +}
> +
> +int mipi_dsi_register_tiny_driver(struct mipi_dsi_device *dsi)
> +{
> +	struct device *dev = &dsi->dev;
> +	struct drm_device *drm;
> +	struct tiny_dsi *priv;
> +	static const uint64_t modifiers[] = {
> +		DRM_FORMAT_MOD_LINEAR,
> +		DRM_FORMAT_MOD_INVALID
> +	};
> +	int ret;
> +
> +	priv = kzalloc(sizeof(*priv), GFP_KERNEL);
> +	if (!priv)
> +		return -ENOMEM;
> +
> +	priv->dsi = dsi;
> +	drm = &priv->drm;
> +
> +	ret = devm_drm_dev_init(dev, drm, &tiny_dsi_driver);
> +	if (ret) {
> +		kfree(priv);
> +		return ret;
> +	}
> +
> +	drm_mode_config_init(drm);
> +
> +	priv->panel = of_drm_find_panel(dev->of_node);
> +	if (IS_ERR(priv->panel)) {
> +		dev_err(dev, "Unable to find panel\n");
> +		return PTR_ERR(priv->panel);
> +	}
> +
> +	drm->mode_config.preferred_depth = 16;
> +
> +	drm->mode_config.funcs = &tiny_dsi_mode_config_funcs;
> +	drm->mode_config.min_width = 0;
> +	drm->mode_config.min_height = 0;
> +	drm->mode_config.max_width = 4096;
> +	drm->mode_config.max_height = 4096;
> +
> +	drm_connector_helper_add(&priv->connector, &tiny_dsi_connector_hfuncs);
> +	ret = drm_connector_init(drm, &priv->connector, &tiny_dsi_connector_funcs,
> +				 DRM_MODE_CONNECTOR_DSI);
> +	if (ret) {
> +		dev_err(dev, "Unable to init connector\n");
> +		return ret;
> +	}
> +
> +	ret = drm_simple_display_pipe_init(drm, &priv->pipe, &tiny_dsi_pipe_funcs,
> +					   tiny_dsi_formats, ARRAY_SIZE(tiny_dsi_formats),
> +					   modifiers, &priv->connector);
> +	if (ret) {
> +		dev_err(dev, "Unable to init display pipe\n");
> +		return ret;
> +	}
> +
> +	drm_plane_enable_fb_damage_clips(&priv->pipe.plane);
> +
> +	drm_mode_config_reset(drm);
> +
> +	ret = drm_dev_register(drm, 0);
> +	if (ret) {
> +		dev_err(dev, "Failed to register DRM driver\n");
> +		return ret;
> +	}
> +
> +	ret = devm_add_action_or_reset(dev, tiny_dsi_remove, drm);
> +	if (ret)
> +		return ret;
> +
> +	drm_fbdev_generic_setup(drm, 0);
> +
> +	return 0;
> +}
> +EXPORT_SYMBOL_GPL(mipi_dsi_register_tiny_driver);
> +
> +MODULE_DESCRIPTION("DSI/DBI TinyDRM driver");
> +MODULE_AUTHOR("Paul Cercueil <paul at crapouillou.net>");
> +MODULE_LICENSE("GPL");
> diff --git a/include/drm/drm_mipi_dsi.h b/include/drm/drm_mipi_dsi.h
> index 65d2961fc054..0c2589a55df6 100644
> --- a/include/drm/drm_mipi_dsi.h
> +++ b/include/drm/drm_mipi_dsi.h
> @@ -10,6 +10,7 @@
>   #define __DRM_MIPI_DSI_H__
>   
>   #include <linux/device.h>
> +#include <linux/of_graph.h>
>   
>   struct mipi_dsi_host;
>   struct mipi_dsi_device;
> @@ -337,4 +338,22 @@ void mipi_dsi_driver_unregister(struct mipi_dsi_driver *driver);
>   	module_driver(__mipi_dsi_driver, mipi_dsi_driver_register, \
>   			mipi_dsi_driver_unregister)
>   
> +#if IS_ENABLED(CONFIG_TINYDRM_DSI)
> +int mipi_dsi_register_tiny_driver(struct mipi_dsi_device *dsi);
> +#else
> +static inline int mipi_dsi_register_tiny_driver(struct mipi_dsi_device *dsi)
> +{
> +	return 0;
> +}
> +#endif
> +
> +static inline int mipi_dsi_maybe_register_tiny_driver(struct mipi_dsi_device *dsi)
> +{
> +	/* Register the TinyDRM DSI/DBI driver if the panel has no controller */
> +	if (!of_graph_get_port_by_id(dsi->dev.of_node, 0))
> +		return mipi_dsi_register_tiny_driver(dsi);
> +
> +	return 0;
> +}
> +
>   #endif /* __DRM_MIPI_DSI__ */


More information about the dri-devel mailing list