drm: panel related updates
Subsystems (13)
cover drm: panel related updates
The first 9 patches replaces direct use of the drm_panel function pointers with their drm_panel_* counterparts. The function pointers are only supposed to be used by the drm_panel infrastructure and direct use are discouraged.
ili9322 is updated to handle bus_flags in get_modes like everyone else. This is in preparation for a later patch series where controller becomes an arugument to get_modes() and not like today where drm_panel is attached to a controller.
The remaining patches move functionality to the drm_panel core that today are repeated in many drivers.
As preparation for this the inline functions are moved to drm_panel.c and kernel-doc is made inline.
panel-simple is updated to benefit from the additional infrastructure and is an example for the simplifications that can be done.
The patchset has been tested on my embedded target, and build tested.
Feedback welcome!
The "fix opencoded" patches are all independent and can be applied out of order. They were kept here to keep panel related patches in one series.
Sam
Sam Ravnborg (16):
drm/bridge: tc358767: fix opencoded use of drm_panel_* drm/exynos: fix opencoded use of drm_panel_* drm/exynos: fix opencoded use of drm_panel_* drm/imx: fix opencoded use of drm_panel_* drm/fsl-dcu: fix opencoded use of drm_panel_* drm/msm: fix opencoded use of drm_panel_* drm/mxsfb: fix opencoded use of drm_panel_* drm/sti: fix opencoded use of drm_panel_* drm/tegra: fix opencoded use of drm_panel_* drm/panel: ili9322: move bus_flags to get_modes() drm/panel: move drm_panel functions to .c file drm/panel: use inline comments in drm_panel.h drm/panel: drop return code from drm_panel_detach() drm/panel: call prepare/enable only once drm/panel: add backlight support
drm/panel: simple: use drm_panel infrastructure
drivers/gpu/drm/bridge/analogix/analogix_dp_core.c | 3 +- drivers/gpu/drm/bridge/tc358767.c | 10 +- drivers/gpu/drm/drm_panel.c | 185 ++++++++++++++++- drivers/gpu/drm/exynos/exynos_drm_dpi.c | 4 +- drivers/gpu/drm/exynos/exynos_drm_dsi.c | 2 +- drivers/gpu/drm/fsl-dcu/fsl_dcu_drm_rgb.c | 10 +- drivers/gpu/drm/imx/imx-ldb.c | 11 +- drivers/gpu/drm/imx/parallel-display.c | 11 +- .../gpu/drm/msm/disp/mdp4/mdp4_lvds_connector.c | 2 +- drivers/gpu/drm/mxsfb/mxsfb_out.c | 2 +- drivers/gpu/drm/panel/panel-ilitek-ili9322.c | 34 ++- drivers/gpu/drm/panel/panel-simple.c | 73 +------ drivers/gpu/drm/sti/sti_dvo.c | 8 +- drivers/gpu/drm/tegra/output.c | 2 +- include/drm/drm_panel.h | 227 +++++++++++---------- 15 files changed, 349 insertions(+), 235 deletions(-)
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 1/16 drm/bridge: tc358767: fix opencoded use of drm_panel_*
Replace open coded version with call to drm_panel_get_modes().
--- drivers/gpu/drm/bridge/tc358767.c | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-)
drivers/gpu/drm/bridge/tc358767.c +4 -6
@@ -1312,7 +1312,7 @@ static int tc_connector_get_modes(struct drm_connector *connector) {struct tc_data *tc =connector_to_tc (connector);struct edid *edid; -unsigned int count; +int count;int ret; ret =tc_get_display_props (tc);
@@ -1321,11 +1321,9 @@ static int tc_connector_get_modes(struct drm_connector *connector)return 0 ; } -if (tc->panel && tc->panel->funcs && tc->panel->funcs->get_modes) { - count = tc->panel->funcs->get_modes (tc->panel); -if (count >0 ) -return count; - } + count =drm_panel_get_modes (tc->panel); +if (count >0 ) +return count; edid =drm_get_edid (connector, &tc->aux.ddc);
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 01/16] drm/bridge: tc358767: fix opencoded use of drm_panel_*
Quoted 17 lines · Sam Ravnborg
Replace open coded version with call to
drm_panel_get_modes().Signed-off-by Sam Ravnborg <[email protected]>Cc Andrzej Hajda <[email protected]>Cc Neil Armstrong <[email protected]>Cc Laurent Pinchart <[email protected]>Cc Jonas Karlman <[email protected]>Cc Jernej Skrabec <[email protected]>--- drivers/gpu/drm/bridge/tc358767.c | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-)drivers/gpu/drm/bridge/tc358767.c +0
-0
drivers/gpu/drm/bridge/tc358767.c static int tc_connector_get_modes(struct drm_connector *connector) · line 1315
Quoted 5 lines
drivers/gpu/drm/bridge/tc358767.c +1
-1@@ -1312,7 +1312,7 @@ static int tc_connector_get_modes(struct drm_connector *connector) {struct tc_data *tc =connector_to_tc (connector);struct edid *edid; -unsigned int count; +int count;
This looks like it also fixes a potential bug ...
drivers/gpu/drm/bridge/tc358767.c static int tc_connector_get_modes(struct drm_connector *connector) · line 1326
Quoted 10 lines
drivers/gpu/drm/bridge/tc358767.c +0
-3int ret; ret =tc_get_display_props (tc);@@ -1321,11 +1321,9 @@ static int tc_connector_get_modes(struct drm_connector *connector)return 0 ; } -if (tc->panel && tc->panel->funcs && tc->panel->funcs->get_modes) { - count = tc->panel->funcs->get_modes (tc->panel); -if (count >0 )
... when .get_modes returns a negative value.
drivers/gpu/drm/bridge/tc358767.c static int tc_connector_get_modes(struct drm_connector *connector) · line 1328
Quoted 7 lines
drivers/gpu/drm/bridge/tc358767.c +3
-2-return count; - } + count =drm_panel_get_modes (tc->panel); +if (count >0 ) +return count; edid =drm_get_edid (connector, &tc->aux.ddc);
regards
Philipp
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 01/16] drm/bridge: tc358767: fix opencoded use of drm_panel_*
Hi Philipp.
Quoted 13 lines · Philipp Zabel
Quoted 12 lines · Sam Ravnborg
Replace open coded version with call to
drm_panel_get_modes().Signed-off-by Sam Ravnborg <[email protected]>Cc Andrzej Hajda <[email protected]>Cc Neil Armstrong <[email protected]>Cc Laurent Pinchart <[email protected]>Cc Jonas Karlman <[email protected]>Cc Jernej Skrabec <[email protected]>--- drivers/gpu/drm/bridge/tc358767.c | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-)
Quoted 12 lines
drivers/gpu/drm/bridge/tc358767.c static int tc_connector_get_modes(struct drm_connector *connector) · line 1315
Quoted 10 lines
drivers/gpu/drm/bridge/tc358767.c +1
-1@@ -1312,7 +1312,7 @@ static int tc_connector_get_modes(struct drm_connector *connector) {struct tc_data *tc =connector_to_tc (connector);struct edid *edid; -unsigned int count; +int count;This looks like it also fixes a potential bug ...
get_modes() return either 0 or number of modes.
The negative return values come into play in drm_panel_get_modes() when panel for example s NULL.
I will add this to changelog before I apply to avoid any misunderstanding.
Sam
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 2/16 drm/exynos: fix opencoded use of drm_panel_*
In reply to Sam Ravnborgdrm_panel_attach() will check if there is a controller already attached - drop the check in the driver.
Use drm_panel_get_modes() so the driver no longer uses the function pointer.
--- drivers/gpu/drm/exynos/exynos_drm_dpi.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
drivers/gpu/drm/exynos/exynos_drm_dpi.c +2 -2
@@ -43,7 +43,7 @@ exynos_dpi_detect(struct drm_connector *connector, bool force) {struct exynos_dpi *ctx =connector_to_dpi (connector); -if (ctx->panel && !ctx->panel->connector) +if (ctx->panel)drm_panel_attach (ctx->panel, &ctx->connector);return connector_status_connected;
@@ -85,7 +85,7 @@ static int exynos_dpi_get_modes(struct drm_connector *connector) }if (ctx->panel) -return ctx->panel->funcs->get_modes (ctx->panel); +return drm_panel_get_modes (ctx->panel);return 0 ; }
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Sam Ravnborg
AppliedRe: [PATCH v1 02/16] drm/exynos: fix opencoded use of drm_panel_*
Quoted 5 lines · Sam Ravnborg
drm_panel_attach()will check if there is a controller already attached - drop the check in the driver.Use
drm_panel_get_modes()so the driver no longer uses the function pointer.
Applied to drm-misc-next.
Sam
Quoted 38 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Inki Dae <[email protected]>Cc Joonyoung Shim <[email protected]>Cc Seung-Woo Kim <[email protected]>Cc Kyungmin Park <[email protected]>Cc Kukjin Kim <[email protected]>Cc Krzysztof Kozlowski <[email protected]>--- drivers/gpu/drm/exynos/exynos_drm_dpi.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)drivers/gpu/drm/exynos/exynos_drm_dpi.c +2
-2@@ -43,7 +43,7 @@ exynos_dpi_detect(struct drm_connector *connector, bool force) {struct exynos_dpi *ctx =connector_to_dpi (connector); -if (ctx->panel && !ctx->panel->connector) +if (ctx->panel)drm_panel_attach (ctx->panel, &ctx->connector);return connector_status_connected;@@ -85,7 +85,7 @@ static int exynos_dpi_get_modes(struct drm_connector *connector) }if (ctx->panel) -return ctx->panel->funcs->get_modes (ctx->panel); +return drm_panel_get_modes (ctx->panel);return 0 ; }Signature · 1 line
2.20.1
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 3/16 drm/exynos: fix opencoded use of drm_panel_*
In reply to Sam RavnborgCall via drm_panel_get_modes().
--- drivers/gpu/drm/exynos/exynos_drm_dsi.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/gpu/drm/exynos/exynos_drm_dsi.c +1 -1
@@ -1460,7 +1460,7 @@ static int exynos_dsi_get_modes(struct drm_connector *connector)struct exynos_dsi *dsi =connector_to_dsi (connector);if (dsi->panel) -return dsi->panel->funcs->get_modes (dsi->panel); +return drm_panel_get_modes (dsi->panel);return 0 ; }
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Sam Ravnborg
AppliedRe: [PATCH v1 03/16] drm/exynos: fix opencoded use of drm_panel_*
Quoted 2 lines · Sam Ravnborg
Call via
drm_panel_get_modes().
Applied to drm-misc-next.
Sam
Quoted 28 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Inki Dae <[email protected]>Cc Joonyoung Shim <[email protected]>Cc Seung-Woo Kim <[email protected]>Cc Kyungmin Park <[email protected]>Cc Kukjin Kim <[email protected]>Cc Krzysztof Kozlowski <[email protected]>--- drivers/gpu/drm/exynos/exynos_drm_dsi.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)drivers/gpu/drm/exynos/exynos_drm_dsi.c +1
-1@@ -1460,7 +1460,7 @@ static int exynos_dsi_get_modes(struct drm_connector *connector)struct exynos_dsi *dsi =connector_to_dsi (connector);if (dsi->panel) -return dsi->panel->funcs->get_modes (dsi->panel); +return drm_panel_get_modes (dsi->panel);return 0 ; }Signature · 1 line
2.20.1
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 4/16 drm/imx: fix opencoded use of drm_panel_*
In reply to Sam RavnborgUse the drm_panel_get_modes() function to get the modes.
This patch leave one test for the function pointer:
panel->funcs->get_modes
This is used to check if the panel may have any modes. There is no direct replacement.
We may be able to just check that drm_panel_get_modes() return > 0, but as this is not the same functionality it is left for later.
--- drivers/gpu/drm/imx/imx-ldb.c | 11 ++++------- drivers/gpu/drm/imx/parallel-display.c | 11 ++++------- 2 files changed, 8 insertions(+), 14 deletions(-)
drivers/gpu/drm/imx/imx-ldb.c +4 -7
@@ -124,14 +124,11 @@ static void imx_ldb_ch_set_bus_format(struct imx_ldb_channel *imx_ldb_ch,static int imx_ldb_connector_get_modes (struct drm_connector *connector) {struct imx_ldb_channel *imx_ldb_ch =con_to_imx_ldb_ch (connector); -int num_modes =0 ; +int num_modes; -if (imx_ldb_ch->panel && imx_ldb_ch->panel->funcs && - imx_ldb_ch->panel->funcs->get_modes) { - num_modes = imx_ldb_ch->panel->funcs->get_modes (imx_ldb_ch->panel); -if (num_modes >0 ) -return num_modes; - } + num_modes =drm_panel_get_modes (imx_ldb_ch->panel); +if (num_modes >0 ) +return num_modes;if (!imx_ldb_ch->edid && imx_ldb_ch->ddc) imx_ldb_ch->edid =drm_get_edid (connector, imx_ldb_ch->ddc);
drivers/gpu/drm/imx/parallel-display.c +4 -7
@@ -47,14 +47,11 @@ static int imx_pd_connector_get_modes(struct drm_connector *connector) {struct imx_parallel_display *imxpd =con_to_imxpd (connector);struct device_node *np = imxpd->dev->of_node; -int num_modes =0 ; +int num_modes; -if (imxpd->panel && imxpd->panel->funcs && - imxpd->panel->funcs->get_modes) { - num_modes = imxpd->panel->funcs->get_modes (imxpd->panel); -if (num_modes >0 ) -return num_modes; - } + num_modes =drm_panel_get_modes (imxpd->panel); +if (num_modes >0 ) +return num_modes;if (imxpd->edid) {drm_connector_update_edid_property (connector, imxpd->edid);
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 04/16] drm/imx: fix opencoded use of drm_panel_*
Quoted 10 lines · Sam Ravnborg
Use the
drm_panel_get_modes()function to get the modes.This patch leave one test for the function pointer:
panel->funcs->get_modesThis is used to check if the panel may have any modes. There is no direct replacement.
We may be able to just check thatdrm_panel_get_modes()return > 0, but as this is not the same functionality it is left for later.
Quoted 7 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Philipp Zabel <[email protected]>Cc Sascha Hauer <[email protected]>Cc Pengutronix Kernel Team <[email protected]>Cc Fabio Estevam <[email protected]>Cc NXP Linux Team <[email protected]>
regards
Philipp
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 5/16 drm/fsl-dcu: fix opencoded use of drm_panel_*
In reply to Sam RavnborgUse drm_panel_get_modes() to access modes. This has a nice side effect to simplify the code.
--- drivers/gpu/drm/fsl-dcu/fsl_dcu_drm_rgb.c | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-)
drivers/gpu/drm/fsl-dcu/fsl_dcu_drm_rgb.c +1 -9
@@ -65,17 +65,9 @@ static const struct drm_connector_funcs fsl_dcu_drm_connector_funcs = {static int fsl_dcu_drm_connector_get_modes (struct drm_connector *connector) {struct fsl_dcu_drm_connector *fsl_connector; -int (*get_modes)(struct drm_panel *panel); -int num_modes =0 ; fsl_connector =to_fsl_dcu_connector (connector); -if (fsl_connector->panel && fsl_connector->panel->funcs && - fsl_connector->panel->funcs->get_modes) { - get_modes = fsl_connector->panel->funcs->get_modes; - num_modes =get_modes (fsl_connector->panel); - } - -return num_modes; +return drm_panel_get_modes (fsl_connector->panel); } static int fsl_dcu_drm_connector_mode_valid(struct drm_connector *connector,
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 05/16] drm/fsl-dcu: fix opencoded use of drm_panel_*
Quoted 22 lines · Sam Ravnborg
Use
drm_panel_get_modes()to access modes. This has a nice side effect to simplify the code.Signed-off-by Sam Ravnborg <[email protected]>Cc Stefan Agner <[email protected]>Cc Alison Wang <[email protected]>--- drivers/gpu/drm/fsl-dcu/fsl_dcu_drm_rgb.c | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-)drivers/gpu/drm/fsl-dcu/fsl_dcu_drm_rgb.c +0
-2@@ -65,17 +65,9 @@ static const struct drm_connector_funcs fsl_dcu_drm_connector_funcs = {static int fsl_dcu_drm_connector_get_modes (struct drm_connector *connector) {struct fsl_dcu_drm_connector *fsl_connector; -int (*get_modes)(struct drm_panel *panel); -int num_modes =0 ;
drivers/gpu/drm/fsl-dcu/fsl_dcu_drm_rgb.c static const struct drm_connector_funcs · line 71
Quoted 10 lines
drivers/gpu/drm/fsl-dcu/fsl_dcu_drm_rgb.c +1
-7fsl_connector =to_fsl_dcu_connector (connector); -if (fsl_connector->panel && fsl_connector->panel->funcs && - fsl_connector->panel->funcs->get_modes) { - get_modes = fsl_connector->panel->funcs->get_modes; - num_modes =get_modes (fsl_connector->panel); - } - -return num_modes; +return drm_panel_get_modes (fsl_connector->panel);
Oh, that old code looks rather messy. Thanks for the simplification!
This behaves slightly different since it now returns -EINVAL or -ENOSYS, but that is what we want.
--
Stefan
Quoted 3 lines
drivers/gpu/drm/fsl-dcu/fsl_dcu_drm_rgb.c +0
-0}static int fsl_dcu_drm_connector_mode_valid(struct
drm_connector*connector,
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 05/16] drm/fsl-dcu: fix opencoded use of drm_panel_*
Hi Stefan.
Thanks for the feedback.
Quoted 36 lines · Stefan Agner
Quoted 22 lines · Sam Ravnborg
Use
drm_panel_get_modes()to access modes. This has a nice side effect to simplify the code.Signed-off-by Sam Ravnborg <[email protected]>Cc Stefan Agner <[email protected]>Cc Alison Wang <[email protected]>--- drivers/gpu/drm/fsl-dcu/fsl_dcu_drm_rgb.c | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-)drivers/gpu/drm/fsl-dcu/fsl_dcu_drm_rgb.c +0
-2@@ -65,17 +65,9 @@ static const struct drm_connector_funcs fsl_dcu_drm_connector_funcs = {static int fsl_dcu_drm_connector_get_modes (struct drm_connector *connector) {struct fsl_dcu_drm_connector *fsl_connector; -int (*get_modes)(struct drm_panel *panel); -int num_modes =0 ;drivers/gpu/drm/fsl-dcu/fsl_dcu_drm_rgb.c static const struct drm_connector_funcs · line 71
Quoted 10 lines
drivers/gpu/drm/fsl-dcu/fsl_dcu_drm_rgb.c +1
-7fsl_connector =to_fsl_dcu_connector (connector); -if (fsl_connector->panel && fsl_connector->panel->funcs && - fsl_connector->panel->funcs->get_modes) { - get_modes = fsl_connector->panel->funcs->get_modes; - num_modes =get_modes (fsl_connector->panel); - } - -return num_modes; +return drm_panel_get_modes (fsl_connector->panel);Oh, that old code looks rather messy. Thanks for the simplification!
Quoted 2 lines
This behaves slightly different since it now returns
-EINVALor-ENOSYS, but that is what we want.
You are right, and I will add this to the changelog when I apply.
Sam
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 6/16 drm/msm: fix opencoded use of drm_panel_*
In reply to Sam RavnborgUse the function drm_panel_get_modes().
--- drivers/gpu/drm/msm/disp/mdp4/mdp4_lvds_connector.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/gpu/drm/msm/disp/mdp4/mdp4_lvds_connector.c +1 -1
@@ -55,7 +55,7 @@ static int mdp4_lvds_connector_get_modes(struct drm_connector *connector)if (panel) {drm_panel_attach (panel, connector); - ret = panel->funcs->get_modes (panel); + ret =drm_panel_get_modes (panel);drm_panel_detach (panel); }
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Sam Ravnborg
AppliedRe: [PATCH v1 06/16] drm/msm: fix opencoded use of drm_panel_*
Quoted 2 lines · Sam Ravnborg
Use the function
drm_panel_get_modes().
Applied to drm-misc-next.
Sam
Quoted 25 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Alexios Zavras <[email protected]>Cc Thomas Gleixner <[email protected]>Cc Allison Randal <[email protected]>Cc Sam Ravnborg <[email protected]>Cc Enrico Weigelt <[email protected]>--- drivers/gpu/drm/msm/disp/mdp4/mdp4_lvds_connector.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)drivers/gpu/drm/msm/disp/mdp4/mdp4_lvds_connector.c +1
-1@@ -55,7 +55,7 @@ static int mdp4_lvds_connector_get_modes(struct drm_connector *connector)if (panel) {drm_panel_attach (panel, connector); - ret = panel->funcs->get_modes (panel); + ret =drm_panel_get_modes (panel);drm_panel_detach (panel); }Signature · 1 line
2.20.1
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 7/16 drm/mxsfb: fix opencoded use of drm_panel_*
In reply to Sam RavnborgUse the drm_panel_get_modes() function.
--- drivers/gpu/drm/mxsfb/mxsfb_out.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/gpu/drm/mxsfb/mxsfb_out.c +1 -1
@@ -30,7 +30,7 @@ static int mxsfb_panel_get_modes(struct drm_connector *connector)drm_connector_to_mxsfb_drm_private (connector);if (mxsfb->panel) -return mxsfb->panel->funcs->get_modes (mxsfb->panel); +return drm_panel_get_modes (mxsfb->panel);return 0 ; }
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 07/16] drm/mxsfb: fix opencoded use of drm_panel_*
Quoted 1 line · Sam Ravnborg
Use the
drm_panel_get_modes()function.
Looks good to me,
--
Stefan
Quoted 28 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Marek Vasut <[email protected]>Cc Stefan Agner <[email protected]>Cc Shawn Guo <[email protected]>Cc Sascha Hauer <[email protected]>Cc Pengutronix Kernel Team <[email protected]>Cc Fabio Estevam <[email protected]>Cc NXP Linux Team <[email protected]>--- drivers/gpu/drm/mxsfb/mxsfb_out.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)drivers/gpu/drm/mxsfb/mxsfb_out.c +1
-1@@ -30,7 +30,7 @@ static int mxsfb_panel_get_modes(struct drm_connector *connector)drm_connector_to_mxsfb_drm_private (connector );if (mxsfb->panel) -return mxsfb->panel->funcs->get_modes (mxsfb->panel); +return drm_panel_get_modes (mxsfb->panel);return 0 ;
Quoted 1 line
}
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 8/16 drm/sti: fix opencoded use of drm_panel_*
In reply to Sam RavnborgUse the drm_panel_(enable|disable|get_modes) functions.
--- drivers/gpu/drm/sti/sti_dvo.c | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-)
drivers/gpu/drm/sti/sti_dvo.c +3 -5
@@ -221,8 +221,7 @@ static void sti_dvo_disable(struct drm_bridge *bridge)writel (0x00000000 , dvo->regs +DVO_DOF_CFG ); -if (dvo->panel) - dvo->panel->funcs->disable (dvo->panel); +drm_panel_disable (dvo->panel);/* Disable/unprepare dvo clock */ clk_disable_unprepare (dvo->clk_pix);
@@ -262,8 +261,7 @@ static void sti_dvo_pre_enable(struct drm_bridge *bridge)if (clk_prepare_enable (dvo->clk))DRM_ERROR ("Failed to prepare/enable dvo clk\n" ); -if (dvo->panel) - dvo->panel->funcs->enable (dvo->panel); +drm_panel_enable (dvo->panel);/* Set LUT */ writel (config->lowbyte, dvo->regs +DVO_LUT_PROG_LOW );
@@ -340,7 +338,7 @@ static int sti_dvo_connector_get_modes(struct drm_connector *connector)struct sti_dvo *dvo = dvo_connector->dvo;if (dvo->panel) -return dvo->panel->funcs->get_modes (dvo->panel); +return drm_panel_get_modes (dvo->panel);return 0 ; }
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 08/16] drm/sti: fix opencoded use of drm_panel_*
Quoted 2 lines · Sam Ravnborg
Use the
drm_panel_(enable|disable|get_modes)functions.
Applied on drm-misc-next,
Thanks.
Benjamin
Quoted 42 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Benjamin Gaignard <[email protected]>Cc Vincent Abriou <[email protected]>--- drivers/gpu/drm/sti/sti_dvo.c | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-)drivers/gpu/drm/sti/sti_dvo.c +3
-6@@ -221,8 +221,7 @@ static void sti_dvo_disable(struct drm_bridge *bridge)writel (0x00000000 , dvo->regs +DVO_DOF_CFG ); -if (dvo->panel) - dvo->panel->funcs->disable (dvo->panel); +drm_panel_disable (dvo->panel);/* Disable/unprepare dvo clock */ clk_disable_unprepare (dvo->clk_pix);@@ -262,8 +261,7 @@ static void sti_dvo_pre_enable(struct drm_bridge *bridge)if (clk_prepare_enable (dvo->clk))DRM_ERROR ("Failed to prepare/enable dvo clk\n" ); -if (dvo->panel) - dvo->panel->funcs->enable (dvo->panel); +drm_panel_enable (dvo->panel);/* Set LUT */ writel (config->lowbyte, dvo->regs +DVO_LUT_PROG_LOW );@@ -340,7 +338,7 @@ static int sti_dvo_connector_get_modes(struct drm_connector *connector)struct sti_dvo *dvo = dvo_connector->dvo;if (dvo->panel) -return dvo->panel->funcs->get_modes (dvo->panel); +return drm_panel_get_modes (dvo->panel);return 0 ; } --
Quoted 2 lines
2.20.1
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 9/16 drm/tegra: fix opencoded use of drm_panel_*
In reply to Sam RavnborgUse the drm_panel_get_modes function.
--- drivers/gpu/drm/tegra/output.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/gpu/drm/tegra/output.c +1 -1
@@ -23,7 +23,7 @@ int tegra_output_connector_get_modes(struct drm_connector *connector)* ignore any other means of obtaining a mode. */ if (output->panel) { - err = output->panel->funcs->get_modes (output->panel); + err =drm_panel_get_modes (output->panel);if (err >0 )return err; }
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Sam Ravnborg
AppliedRe: [PATCH v1 09/16] drm/tegra: fix opencoded use of drm_panel_*
Quoted 1 line · Sam Ravnborg
Use the
drm_panel_get_modesfunction.
Applied to drm-misc-next.
Sam
Quoted 24 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Thierry Reding <[email protected]>Cc Jonathan Hunter <[email protected]>--- drivers/gpu/drm/tegra/output.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)drivers/gpu/drm/tegra/output.c +1
-1@@ -23,7 +23,7 @@ int tegra_output_connector_get_modes(struct drm_connector *connector)* ignore any other means of obtaining a mode. */ if (output->panel) { - err = output->panel->funcs->get_modes (output->panel); + err =drm_panel_get_modes (output->panel);if (err >0 )return err; }Signature · 1 line
2.20.1
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 10/16 drm/panel: ili9322: move bus_flags to get_modes()
In reply to Sam RavnborgTo prepare the driver to receive drm_connector only in the get_modes() callback, move bus_flags handling to ili9322_get_modes().
--- drivers/gpu/drm/panel/panel-ilitek-ili9322.c | 34 +++++++++----------- 1 file changed, 16 insertions(+), 18 deletions(-)
drivers/gpu/drm/panel/panel-ilitek-ili9322.c +16 -18
@@ -349,7 +349,6 @@ static const struct regmap_config ili9322_regmap_config = {static int ili9322_init (struct drm_panel *panel,struct ili9322 *ili) { -struct drm_connector *connector = panel->connector;u8 reg;int ret;int i;
@@ -407,23 +406,11 @@ static int ili9322_init(struct drm_panel *panel, struct ili9322 *ili)* Polarity and inverted color order for RGB input. * None of this applies in the BT.656 mode. */ -if (ili->conf->dclk_active_high) { + reg =0 ; +if (ili->conf->dclk_active_high) reg =ILI9322_POL_DCLK ; - connector->display_info.bus_flags |= -DRM_BUS_FLAG_PIXDATA_DRIVE_POSEDGE ; - }else { - reg =0 ; - connector->display_info.bus_flags |= -DRM_BUS_FLAG_PIXDATA_DRIVE_NEGEDGE ; - } -if (ili->conf->de_active_high) { +if (ili->conf->de_active_high) reg |=ILI9322_POL_DE ; - connector->display_info.bus_flags |= -DRM_BUS_FLAG_DE_HIGH ; - }else { - connector->display_info.bus_flags |= -DRM_BUS_FLAG_DE_LOW ; - }if (ili->conf->hsync_active_high) reg |=ILI9322_POL_HSYNC ;if (ili->conf->vsync_active_high)
@@ -659,9 +646,20 @@ static int ili9322_get_modes(struct drm_panel *panel)struct drm_connector *connector = panel->connector;struct ili9322 *ili =panel_to_ili9322 (panel);struct drm_display_mode *mode; +struct drm_display_info *info; + + info = &connector->display_info; + info->width_mm = ili->conf->width_mm; + info->height_mm = ili->conf->height_mm; +if (ili->conf->dclk_active_high) + info->bus_flags |=DRM_BUS_FLAG_PIXDATA_DRIVE_POSEDGE ; +else + info->bus_flags |=DRM_BUS_FLAG_PIXDATA_DRIVE_NEGEDGE ; - connector->display_info.width_mm = ili->conf->width_mm; - connector->display_info.height_mm = ili->conf->height_mm; +if (ili->conf->de_active_high) + info->bus_flags |=DRM_BUS_FLAG_DE_HIGH ; +else + info->bus_flags |=DRM_BUS_FLAG_DE_LOW ;switch (ili->input) {case ILI9322_INPUT_SRGB_DUMMY_320X240 :
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 10/16] drm/panel: ili9322: move bus_flags to get_modes()
Quoted 6 lines · Sam Ravnborg
To prepare the driver to receive
drm_connectoronly in theget_modes()callback, movebus_flagshandling toili9322_get_modes().Signed-off-by Sam Ravnborg <[email protected]>Cc Thierry Reding <[email protected]>Cc Sam Ravnborg <[email protected]>
OK I don't see where this is going but I trust you so:
Yours,
Linus Walleij
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 11/16 drm/panel: move drm_panel functions to .c file
In reply to Sam RavnborgMove inline functions from include/drm/drm_panel.h to drm_panel.c. This is in preparation for follow-up patches that will add extra logic to the functions.
As they are no longer static inline, EXPORT them.
--- drivers/gpu/drm/drm_panel.c | 96 +++++++++++++++++++++++++++++++++++ include/drm/drm_panel.h | 99 +++---------------------------------- 2 files changed, 104 insertions(+), 91 deletions(-)
drivers/gpu/drm/drm_panel.c +96 -0
@@ -54,6 +54,102 @@ void drm_panel_init(struct drm_panel *panel) }EXPORT_SYMBOL (drm_panel_init); +/** +* drm_panel_prepare - power on a panel +* @panel: DRM panel +* +* Calling this function will enable power and deassert any reset signals to +* the panel. After this has completed it is possible to communicate with any +* integrated circuitry via a command bus. +* +* Return: 0 on success or a negative error code on failure. +*/ +int drm_panel_prepare (struct drm_panel *panel) +{ +if (panel && panel->funcs && panel->funcs->prepare) +return panel->funcs->prepare (panel); + +return panel ? -ENOSYS : -EINVAL ; +} +EXPORT_SYMBOL (drm_panel_prepare); + +/** +* drm_panel_enable - enable a panel +* @panel: DRM panel +* +* Calling this function will cause the panel display drivers to be turned on +* and the backlight to be enabled. Content will be visible on screen after +* this call completes. +* +* Return: 0 on success or a negative error code on failure. +*/ +int drm_panel_enable (struct drm_panel *panel) +{ +if (panel && panel->funcs && panel->funcs->enable) +return panel->funcs->enable (panel); + +return panel ? -ENOSYS : -EINVAL ; +} +EXPORT_SYMBOL (drm_panel_enable); + +/** +* drm_panel_disable - disable a panel +* @panel: DRM panel +* +* This will typically turn off the panel's backlight or disable the display +* drivers. For smart panels it should still be possible to communicate with +* the integrated circuitry via any command bus after this call. +* +* Return: 0 on success or a negative error code on failure. +*/ +int drm_panel_disable (struct drm_panel *panel) +{ +if (panel && panel->funcs && panel->funcs->disable) +return panel->funcs->disable (panel); + +return panel ? -ENOSYS : -EINVAL ; +} +EXPORT_SYMBOL (drm_panel_disable); + +/** +* drm_panel_unprepare - power off a panel +* @panel: DRM panel +* +* Calling this function will completely power off a panel (assert the panel's +* reset, turn off power supplies, ...). After this function has completed, it +* is usually no longer possible to communicate with the panel until another +* call to drm_panel_prepare(). +* +* Return: 0 on success or a negative error code on failure. +*/ +int drm_panel_unprepare (struct drm_panel *panel) +{ +if (panel && panel->funcs && panel->funcs->unprepare) +return panel->funcs->unprepare (panel); + +return panel ? -ENOSYS : -EINVAL ; +} +EXPORT_SYMBOL (drm_panel_unprepare); + +/** +* drm_panel_get_modes - probe the available display modes of a panel +* @panel: DRM panel +* +* The modes probed from the panel are automatically added to the connector +* that the panel is attached to. +* +* Return: The number of modes available from the panel on success or a +* negative error code on failure. +*/ +int drm_panel_get_modes (struct drm_panel *panel) +{ +if (panel && panel->funcs && panel->funcs->get_modes) +return panel->funcs->get_modes (panel); + +return panel ? -ENOSYS : -EINVAL ; +} +EXPORT_SYMBOL (drm_panel_get_modes); +/** * drm_panel_add - add a panel to the global registry * @panel: panel to add
include/drm/drm_panel.h +8 -91
111 lines not on this page · raw message
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 11/16] drm/panel: move drm_panel functions to .c file
Hi Sam,
Thank you for the patch.
Quoted 228 lines · Sam Ravnborg
Move inline functions from
include/drm/drm_panel.htodrm_panel.c. This is in preparation for follow-up patches that will add extra logic to the functions.
As they are no longer static inline, EXPORT them.Signed-off-by Sam Ravnborg <[email protected]>Cc Thierry Reding <[email protected]>Cc Sam Ravnborg <[email protected]>Cc Maarten Lankhorst <[email protected]>Cc Maxime Ripard <[email protected]>Cc Sean Paul <[email protected]>Cc David Airlie <[email protected]>Cc Daniel Vetter <[email protected]>--- drivers/gpu/drm/drm_panel.c | 96 +++++++++++++++++++++++++++++++++++ include/drm/drm_panel.h | 99 +++---------------------------------- 2 files changed, 104 insertions(+), 91 deletions(-)drivers/gpu/drm/drm_panel.c +96
-0@@ -54,6 +54,102 @@ void drm_panel_init(struct drm_panel *panel) }EXPORT_SYMBOL (drm_panel_init); +/** +* drm_panel_prepare - power on a panel +* @panel: DRM panel +* +* Calling this function will enable power and deassert any reset signals to +* the panel. After this has completed it is possible to communicate with any +* integrated circuitry via a command bus. +* +* Return: 0 on success or a negative error code on failure. +*/ +int drm_panel_prepare (struct drm_panel *panel) +{ +if (panel && panel->funcs && panel->funcs->prepare) +return panel->funcs->prepare (panel); + +return panel ? -ENOSYS : -EINVAL ; +} +EXPORT_SYMBOL (drm_panel_prepare); + +/** +* drm_panel_enable - enable a panel +* @panel: DRM panel +* +* Calling this function will cause the panel display drivers to be turned on +* and the backlight to be enabled. Content will be visible on screen after +* this call completes. +* +* Return: 0 on success or a negative error code on failure. +*/ +int drm_panel_enable (struct drm_panel *panel) +{ +if (panel && panel->funcs && panel->funcs->enable) +return panel->funcs->enable (panel); + +return panel ? -ENOSYS : -EINVAL ; +} +EXPORT_SYMBOL (drm_panel_enable); + +/** +* drm_panel_disable - disable a panel +* @panel: DRM panel +* +* This will typically turn off the panel's backlight or disable the display +* drivers. For smart panels it should still be possible to communicate with +* the integrated circuitry via any command bus after this call. +* +* Return: 0 on success or a negative error code on failure. +*/ +int drm_panel_disable (struct drm_panel *panel) +{ +if (panel && panel->funcs && panel->funcs->disable) +return panel->funcs->disable (panel); + +return panel ? -ENOSYS : -EINVAL ; +} +EXPORT_SYMBOL (drm_panel_disable); + +/** +* drm_panel_unprepare - power off a panel +* @panel: DRM panel +* +* Calling this function will completely power off a panel (assert the panel's +* reset, turn off power supplies, ...). After this function has completed, it +* is usually no longer possible to communicate with the panel until another +* call to drm_panel_prepare(). +* +* Return: 0 on success or a negative error code on failure. +*/ +int drm_panel_unprepare (struct drm_panel *panel) +{ +if (panel && panel->funcs && panel->funcs->unprepare) +return panel->funcs->unprepare (panel); + +return panel ? -ENOSYS : -EINVAL ; +} +EXPORT_SYMBOL (drm_panel_unprepare); + +/** +* drm_panel_get_modes - probe the available display modes of a panel +* @panel: DRM panel +* +* The modes probed from the panel are automatically added to the connector +* that the panel is attached to. +* +* Return: The number of modes available from the panel on success or a +* negative error code on failure. +*/ +int drm_panel_get_modes (struct drm_panel *panel) +{ +if (panel && panel->funcs && panel->funcs->get_modes) +return panel->funcs->get_modes (panel); + +return panel ? -ENOSYS : -EINVAL ; +} +EXPORT_SYMBOL (drm_panel_get_modes); +/** * drm_panel_add - add a panel to the global registry * @panel: panel to add include/drm/drm_panel.h +0
-91@@ -97,97 +97,6 @@ struct drm_panel {struct list_head list; }; -/** -* drm_disable_unprepare - power off a panel -* @panel: DRM panel -* -* Calling this function will completely power off a panel (assert the panel's -* reset, turn off power supplies, ...). After this function has completed, it -* is usually no longer possible to communicate with the panel until another -* call to drm_panel_prepare(). -* -* Return: 0 on success or a negative error code on failure. -*/ -static inline int drm_panel_unprepare (struct drm_panel *panel) -{ -if (panel && panel->funcs && panel->funcs->unprepare) -return panel->funcs->unprepare (panel); - -return panel ? -ENOSYS : -EINVAL ; -} - -/** -* drm_panel_disable - disable a panel -* @panel: DRM panel -* -* This will typically turn off the panel's backlight or disable the display -* drivers. For smart panels it should still be possible to communicate with -* the integrated circuitry via any command bus after this call. -* -* Return: 0 on success or a negative error code on failure. -*/ -static inline int drm_panel_disable (struct drm_panel *panel) -{ -if (panel && panel->funcs && panel->funcs->disable) -return panel->funcs->disable (panel); - -return panel ? -ENOSYS : -EINVAL ; -} - -/** -* drm_panel_prepare - power on a panel -* @panel: DRM panel -* -* Calling this function will enable power and deassert any reset signals to -* the panel. After this has completed it is possible to communicate with any -* integrated circuitry via a command bus. -* -* Return: 0 on success or a negative error code on failure. -*/ -static inline int drm_panel_prepare (struct drm_panel *panel) -{ -if (panel && panel->funcs && panel->funcs->prepare) -return panel->funcs->prepare (panel); - -return panel ? -ENOSYS : -EINVAL ; -} - -/** -* drm_panel_enable - enable a panel -* @panel: DRM panel -* -* Calling this function will cause the panel display drivers to be turned on -* and the backlight to be enabled. Content will be visible on screen after -* this call completes. -* -* Return: 0 on success or a negative error code on failure. -*/ -static inline int drm_panel_enable (struct drm_panel *panel) -{ -if (panel && panel->funcs && panel->funcs->enable) -return panel->funcs->enable (panel); - -return panel ? -ENOSYS : -EINVAL ; -} - -/** -* drm_panel_get_modes - probe the available display modes of a panel -* @panel: DRM panel -* -* The modes probed from the panel are automatically added to the connector -* that the panel is attached to. -* -* Return: The number of modes available from the panel on success or a -* negative error code on failure. -*/ -static inline int drm_panel_get_modes (struct drm_panel *panel) -{ -if (panel && panel->funcs && panel->funcs->get_modes) -return panel->funcs->get_modes (panel); - -return panel ? -ENOSYS : -EINVAL ; -} -void drm_panel_init (struct drm_panel *panel);int drm_panel_add (struct drm_panel *panel);
include/drm/drm_panel.h void drm_panel_remove(struct drm_panel *panel); · line 112
Quoted 8 lines
include/drm/drm_panel.h +5
-0@@ -196,6 +105,14 @@ void drm_panel_remove(struct drm_panel *panel);int drm_panel_attach (struct drm_panel *panel,struct drm_connector *connector);int drm_panel_detach (struct drm_panel *panel); +int drm_panel_prepare (struct drm_panel *panel); +int drm_panel_unprepare (struct drm_panel *panel); + +int drm_panel_enable (struct drm_panel *panel); +int drm_panel_disable (struct drm_panel *panel);
Nitpicking, I would keep the order of the declarations aligned with the definitions. prepare - enable - disable - unprepare and prepare - unprepare - enable - disable are both fine with me, as long as they're consistent.
Apart from that,
Quoted 6 lines
include/drm/drm_panel.h +3
-0+ +int drm_panel_get_modes (struct drm_panel *panel); +#if defined(CONFIG_OF ) && defined(CONFIG_DRM_PANEL )struct drm_panel *of_drm_find_panel (const struct device_node *np);#else
Signature · 7 lines
Regards, Laurent Pinchart _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 12/16 drm/panel: use inline comments in drm_panel.h
In reply to Sam RavnborgInline comments provide better space for additional comments. Comments was slightly edited to follow the normal style, but no change to actual content.
Used the opportuniy to change the order in drm_panel_funcs to follow the order they will be used by a panel.
--- include/drm/drm_panel.h | 82 +++++++++++++++++++++++++++++++++-------- 1 file changed, 66 insertions(+), 16 deletions(-)
include/drm/drm_panel.h +66 -16
@@ -36,14 +36,6 @@ struct display_timing;/** * struct drm_panel_funcs - perform operations on a given panel -* @disable: disable panel (turn off back light, etc.) -* @unprepare: turn off panel -* @prepare: turn on panel and perform set up -* @enable: enable panel (turn on back light, etc.) -* @get_modes: add modes to the connector that the panel is attached to and -* return the number of modes added -* @get_timings: copy display timings into the provided array and return -* the number of display timings available * * The .prepare() function is typically called before the display controller * starts to transmit video data. Panel drivers can use this to turn the panel
@@ -69,31 +61,89 @@ struct display_timing;* the panel. This is the job of the .unprepare() function. */ struct drm_panel_funcs { -int (*disable)(struct drm_panel *panel); -int (*unprepare)(struct drm_panel *panel); +/** +* @prepare: +* +* Turn on panel and perform set up. +*/ int (*prepare)(struct drm_panel *panel); + +/** +* @enable: +* +* Enable panel (turn on back light, etc.). +*/ int (*enable)(struct drm_panel *panel); + +/** +* @disable: +* +* Disable panel (turn off back light, etc.). +*/ +int (*disable)(struct drm_panel *panel); + +/** +* @unprepare: +* +* Turn off panel. +*/ +int (*unprepare)(struct drm_panel *panel); + +/** +* @get_modes: +* +* Add modes to the connector that the panel is attached to and +* return the number of modes added. +*/ int (*get_modes)(struct drm_panel *panel); + +/** +* @get_timings: +* +* Copy display timings into the provided array and return +* the number of display timings available. +*/ int (*get_timings)(struct drm_panel *panel,unsigned int num_timings,struct display_timing *timings); };/** * struct drm_panel - DRM panel object -* @drm: DRM device owning the panel -* @connector: DRM connector that the panel is attached to -* @dev: parent device of the panel -* @link: link from panel device (supplier) to DRM device (consumer) -* @funcs: operations that can be performed on the panel -* @list: panel entry in registry */ struct drm_panel { +/** +* @drm: +* +* DRM device owning the panel. +*/ struct drm_device *drm; + +/** +* @connector: +* +* DRM connector that the panel is attached to. +*/ struct drm_connector *connector; + +/** +* @dev: +* +* Parent device of the panel. +*/ struct device *dev; +/** +* @funcs: +* +* Operations that can be performed on the panel. +*/ const struct drm_panel_funcs *funcs; +/** +* @list: +* +* Panel entry in registry. +*/ struct list_head list; };
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 12/16] drm/panel: use inline comments in drm_panel.h
Hi Sam,
Thank you for the patch.
Quoted 6 lines · Sam Ravnborg
Inline comments provide better space for additional comments. Comments was slightly edited to follow the normal style, but no change to actual content.
Used the opportuniy to change the order indrm_panel_funcsto follow the order they will be used by a panel.
Quoted 8 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Maarten Lankhorst <[email protected]>Cc Maxime Ripard <[email protected]>Cc Sean Paul <[email protected]>Cc Thierry Reding <[email protected]>Cc Sam Ravnborg <[email protected]>Cc David Airlie <[email protected]>Cc Daniel Vetter <[email protected]>
Quoted 121 lines
--- include/drm/drm_panel.h | 82 +++++++++++++++++++++++++++++++++-------- 1 file changed, 66 insertions(+), 16 deletions(-)include/drm/drm_panel.h +66
-16@@ -36,14 +36,6 @@ struct display_timing;/** * struct drm_panel_funcs - perform operations on a given panel -* @disable: disable panel (turn off back light, etc.) -* @unprepare: turn off panel -* @prepare: turn on panel and perform set up -* @enable: enable panel (turn on back light, etc.) -* @get_modes: add modes to the connector that the panel is attached to and -* return the number of modes added -* @get_timings: copy display timings into the provided array and return -* the number of display timings available * * The .prepare() function is typically called before the display controller * starts to transmit video data. Panel drivers can use this to turn the panel @@ -69,31 +61,89 @@ struct display_timing;* the panel. This is the job of the .unprepare() function. */ struct drm_panel_funcs { -int (*disable)(struct drm_panel *panel); -int (*unprepare)(struct drm_panel *panel); +/** +* @prepare: +* +* Turn on panel and perform set up. +*/ int (*prepare)(struct drm_panel *panel); + +/** +* @enable: +* +* Enable panel (turn on back light, etc.). +*/ int (*enable)(struct drm_panel *panel); + +/** +* @disable: +* +* Disable panel (turn off back light, etc.). +*/ +int (*disable)(struct drm_panel *panel); + +/** +* @unprepare: +* +* Turn off panel. +*/ +int (*unprepare)(struct drm_panel *panel); + +/** +* @get_modes: +* +* Add modes to the connector that the panel is attached to and +* return the number of modes added. +*/ int (*get_modes)(struct drm_panel *panel); + +/** +* @get_timings: +* +* Copy display timings into the provided array and return +* the number of display timings available. +*/ int (*get_timings)(struct drm_panel *panel,unsigned int num_timings,struct display_timing *timings); };/** * struct drm_panel - DRM panel object -* @drm: DRM device owning the panel -* @connector: DRM connector that the panel is attached to -* @dev: parent device of the panel -* @link: link from panel device (supplier) to DRM device (consumer) -* @funcs: operations that can be performed on the panel -* @list: panel entry in registry */ struct drm_panel { +/** +* @drm: +* +* DRM device owning the panel. +*/ struct drm_device *drm; + +/** +* @connector: +* +* DRM connector that the panel is attached to. +*/ struct drm_connector *connector; + +/** +* @dev: +* +* Parent device of the panel. +*/ struct device *dev; +/** +* @funcs: +* +* Operations that can be performed on the panel. +*/ const struct drm_panel_funcs *funcs; +/** +* @list: +* +* Panel entry in registry. +*/ struct list_head list; };
Signature · 3 lines
Regards, Laurent Pinchart
PATCH 13/16 drm/panel: drop return code from drm_panel_detach()
In reply to Sam RavnborgThere are no errors that can be reported by this function, so drop the return code.
Fix the only bridge driver that checked the return result.
--- drivers/gpu/drm/bridge/analogix/analogix_dp_core.c | 3 +-- drivers/gpu/drm/drm_panel.c | 6 +----- include/drm/drm_panel.h | 2 +- 3 files changed, 3 insertions(+), 8 deletions(-)
drivers/gpu/drm/bridge/analogix/analogix_dp_core.c +1 -2
@@ -1780,8 +1780,7 @@ void analogix_dp_unbind(struct analogix_dp_device *dp)if (dp->plat_data->panel) {if (drm_panel_unprepare (dp->plat_data->panel))DRM_ERROR ("failed to turnoff the panel\n" ); -if (drm_panel_detach (dp->plat_data->panel)) -DRM_ERROR ("failed to detach the panel\n" ); +drm_panel_detach (dp->plat_data->panel); }drm_dp_aux_unregister (&dp->aux);
drivers/gpu/drm/drm_panel.c +1 -5
@@ -219,15 +219,11 @@ EXPORT_SYMBOL(drm_panel_attach);* * This function should not be called by the panel device itself. It * is only for the drm device that called drm_panel_attach(). -* -* Return: 0 on success or a negative error code on failure. */ -int drm_panel_detach (struct drm_panel *panel) +void drm_panel_detach (struct drm_panel *panel) { panel->connector =NULL ; panel->drm =NULL ; - -return 0 ; }EXPORT_SYMBOL (drm_panel_detach);
include/drm/drm_panel.h +1 -1
@@ -153,7 +153,7 @@ int drm_panel_add(struct drm_panel *panel);void drm_panel_remove (struct drm_panel *panel);int drm_panel_attach (struct drm_panel *panel,struct drm_connector *connector); -int drm_panel_detach (struct drm_panel *panel); +void drm_panel_detach (struct drm_panel *panel);int drm_panel_prepare (struct drm_panel *panel);int drm_panel_unprepare (struct drm_panel *panel);
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 13/16] drm/panel: drop return code from drm_panel_detach()
Hi Sam,
Thank you for the patch.
Quoted 4 lines · Sam Ravnborg
There are no errors that can be reported by this function, so drop the return code.
Fix the only bridge driver that checked the return result.
Quoted 13 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Thierry Reding <[email protected]>Cc Sam Ravnborg <[email protected]>Cc Maarten Lankhorst <[email protected]>Cc Maxime Ripard <[email protected]>Cc Sean Paul <[email protected]>Cc David Airlie <[email protected]>Cc Daniel Vetter <[email protected]>Cc Laurent Pinchart <[email protected]>Cc Andrzej Hajda <[email protected]>Cc Gwan-gyeong Mun <[email protected]>Cc Thomas Gleixner <[email protected]>Cc Linus Walleij <[email protected]>
Quoted 54 lines
--- drivers/gpu/drm/bridge/analogix/analogix_dp_core.c | 3 +-- drivers/gpu/drm/drm_panel.c | 6 +----- include/drm/drm_panel.h | 2 +- 3 files changed, 3 insertions(+), 8 deletions(-)drivers/gpu/drm/bridge/analogix/analogix_dp_core.c +1
-2@@ -1780,8 +1780,7 @@ void analogix_dp_unbind(struct analogix_dp_device *dp)if (dp->plat_data->panel) {if (drm_panel_unprepare (dp->plat_data->panel))DRM_ERROR ("failed to turnoff the panel\n" ); -if (drm_panel_detach (dp->plat_data->panel)) -DRM_ERROR ("failed to detach the panel\n" ); +drm_panel_detach (dp->plat_data->panel); }drm_dp_aux_unregister (&dp->aux);drivers/gpu/drm/drm_panel.c +1
-5@@ -219,15 +219,11 @@ EXPORT_SYMBOL(drm_panel_attach);* * This function should not be called by the panel device itself. It * is only for the drm device that called drm_panel_attach(). -* -* Return: 0 on success or a negative error code on failure. */ -int drm_panel_detach (struct drm_panel *panel) +void drm_panel_detach (struct drm_panel *panel) { panel->connector =NULL ; panel->drm =NULL ; - -return 0 ; }EXPORT_SYMBOL (drm_panel_detach);include/drm/drm_panel.h +1
-1@@ -153,7 +153,7 @@ int drm_panel_add(struct drm_panel *panel);void drm_panel_remove (struct drm_panel *panel);int drm_panel_attach (struct drm_panel *panel,struct drm_connector *connector); -int drm_panel_detach (struct drm_panel *panel); +void drm_panel_detach (struct drm_panel *panel);int drm_panel_prepare (struct drm_panel *panel);int drm_panel_unprepare (struct drm_panel *panel);
Signature · 7 lines
Regards, Laurent Pinchart _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 14/16 drm/panel: call prepare/enable only once
In reply to Sam RavnborgMany panel drivers duplicate logic to prevent prepare to be called for a panel that is already prepared.
Likewise for enable.
Implement this logic in drm_panel so the individual drivers no longer needs this.
A panel is considered prepared/enabled only if the prepare/enable call succeeds.
For disable/unprepare it is unconditionally considered disabled/unprepared.
This allows calls to prepare/enable again, even if there were some issue disabling a regulator or similar during disable/unprepare.
--- drivers/gpu/drm/drm_panel.c | 66 ++++++++++++++++++++++++++++++------- include/drm/drm_panel.h | 21 ++++++++++++ 2 files changed, 75 insertions(+), 12 deletions(-)
drivers/gpu/drm/drm_panel.c +54 -12
@@ -66,10 +66,21 @@ EXPORT_SYMBOL(drm_panel_init);*/ int drm_panel_prepare (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->prepare) -return panel->funcs->prepare (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (panel->prepared) +return 0 ; + +if (panel->funcs && panel->funcs->prepare) + ret = panel->funcs->prepare (panel); + +if (ret >=0 ) + panel->prepared = true; + +return ret; }EXPORT_SYMBOL (drm_panel_prepare);
@@ -85,10 +96,21 @@ EXPORT_SYMBOL(drm_panel_prepare);*/ int drm_panel_enable (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->enable) -return panel->funcs->enable (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (panel->enabled) +return 0 ; + +if (panel->funcs && panel->funcs->enable) + ret = panel->funcs->enable (panel); + +if (ret >=0 ) + panel->enabled = true; + +return ret; }EXPORT_SYMBOL (drm_panel_enable);
@@ -104,10 +126,20 @@ EXPORT_SYMBOL(drm_panel_enable);*/ int drm_panel_disable (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->disable) -return panel->funcs->disable (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (!panel->enabled) +return 0 ; + +if (panel->funcs && panel->funcs->disable) + ret = panel->funcs->disable (panel); + + panel->enabled = false; + +return ret; }EXPORT_SYMBOL (drm_panel_disable);
@@ -124,10 +156,20 @@ EXPORT_SYMBOL(drm_panel_disable);*/ int drm_panel_unprepare (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->unprepare) -return panel->funcs->unprepare (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (!panel->prepared) +return 0 ; + +if (panel->funcs && panel->funcs->unprepare) + ret = panel->funcs->unprepare (panel); + + panel->prepared = false; + +return ret; }EXPORT_SYMBOL (drm_panel_unprepare);
include/drm/drm_panel.h +21 -0
@@ -65,6 +65,9 @@ struct drm_panel_funcs {* @prepare: * * Turn on panel and perform set up. +* When the panel is successfully prepared the prepare() function +* will not be called again until the panel has been unprepared. +* */ int (*prepare)(struct drm_panel *panel);
@@ -72,6 +75,8 @@ struct drm_panel_funcs {* @enable: * * Enable panel (turn on back light, etc.). +* When the panel is successfully enabled the enable() function +* will not be called again until the panel has been disabled. */ int (*enable)(struct drm_panel *panel);
@@ -79,6 +84,7 @@ struct drm_panel_funcs {* @disable: * * Disable panel (turn off back light, etc.). +* If the panel is already disabled the disable() function is not called. */ int (*disable)(struct drm_panel *panel);
@@ -86,6 +92,7 @@ struct drm_panel_funcs {* @unprepare: * * Turn off panel. +* If the panel is already unprepared the unprepare() function is not called. */ int (*unprepare)(struct drm_panel *panel);
@@ -145,6 +152,20 @@ struct drm_panel {* Panel entry in registry. */ struct list_head list; + +/** +* @prepared: +* +* Set to true when the panel is successfully prepared. +*/ +bool prepared; + +/** +* @enabled: +* +* Set to true when the panel is successfully enabled. +*/ +bool enabled; };void drm_panel_init (struct drm_panel *panel);
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Laurent Pinchart
reviewerRe: [PATCH v1 14/16] drm/panel: call prepare/enable only once
Hi Sam,
Thank you for the patch.
Quoted 11 lines · Sam Ravnborg
Many panel drivers duplicate logic to prevent prepare to be called for a panel that is already prepared.
Likewise for enable.Implement this logic in
drm_panelso the individual drivers no longer needs this.
A panel is considered prepared/enabled only if the prepare/enable call succeeds.
For disable/unprepare it is unconditionally considered disabled/unprepared.
Quoted 2 lines
This allows calls to prepare/enable again, even if there were some issue disabling a regulator or similar during disable/unprepare.
Is this the right place to handle this ? Shouldn't the upper layers ensure than enable/disable and prepare/unprepare are correcty balanced, and not called multiple times ? Adding enabled and prepared state to drm_panel not only doesn't align well with atomic state handling, but also would hide issues in upper layers that should really be fixed there.
Quoted 175 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Maarten Lankhorst <[email protected]>Cc Maxime Ripard <[email protected]>Cc Sean Paul <[email protected]>Cc Thierry Reding <[email protected]>Cc Sam Ravnborg <[email protected]>Cc David Airlie <[email protected]>Cc Daniel Vetter <[email protected]>--- drivers/gpu/drm/drm_panel.c | 66 ++++++++++++++++++++++++++++++------- include/drm/drm_panel.h | 21 ++++++++++++ 2 files changed, 75 insertions(+), 12 deletions(-)drivers/gpu/drm/drm_panel.c +54
-12@@ -66,10 +66,21 @@ EXPORT_SYMBOL(drm_panel_init);*/ int drm_panel_prepare (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->prepare) -return panel->funcs->prepare (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (panel->prepared) +return 0 ; + +if (panel->funcs && panel->funcs->prepare) + ret = panel->funcs->prepare (panel); + +if (ret >=0 ) + panel->prepared = true; + +return ret; }EXPORT_SYMBOL (drm_panel_prepare);@@ -85,10 +96,21 @@ EXPORT_SYMBOL(drm_panel_prepare);*/ int drm_panel_enable (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->enable) -return panel->funcs->enable (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (panel->enabled) +return 0 ; + +if (panel->funcs && panel->funcs->enable) + ret = panel->funcs->enable (panel); + +if (ret >=0 ) + panel->enabled = true; + +return ret; }EXPORT_SYMBOL (drm_panel_enable);@@ -104,10 +126,20 @@ EXPORT_SYMBOL(drm_panel_enable);*/ int drm_panel_disable (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->disable) -return panel->funcs->disable (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (!panel->enabled) +return 0 ; + +if (panel->funcs && panel->funcs->disable) + ret = panel->funcs->disable (panel); + + panel->enabled = false; + +return ret; }EXPORT_SYMBOL (drm_panel_disable);@@ -124,10 +156,20 @@ EXPORT_SYMBOL(drm_panel_disable);*/ int drm_panel_unprepare (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->unprepare) -return panel->funcs->unprepare (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (!panel->prepared) +return 0 ; + +if (panel->funcs && panel->funcs->unprepare) + ret = panel->funcs->unprepare (panel); + + panel->prepared = false; + +return ret; }EXPORT_SYMBOL (drm_panel_unprepare);include/drm/drm_panel.h +21
-0@@ -65,6 +65,9 @@ struct drm_panel_funcs {* @prepare: * * Turn on panel and perform set up. +* When the panel is successfully prepared the prepare() function +* will not be called again until the panel has been unprepared. +* */ int (*prepare)(struct drm_panel *panel);@@ -72,6 +75,8 @@ struct drm_panel_funcs {* @enable: * * Enable panel (turn on back light, etc.). +* When the panel is successfully enabled the enable() function +* will not be called again until the panel has been disabled. */ int (*enable)(struct drm_panel *panel);@@ -79,6 +84,7 @@ struct drm_panel_funcs {* @disable: * * Disable panel (turn off back light, etc.). +* If the panel is already disabled the disable() function is not called. */ int (*disable)(struct drm_panel *panel);@@ -86,6 +92,7 @@ struct drm_panel_funcs {* @unprepare: * * Turn off panel. +* If the panel is already unprepared the unprepare() function is not called. */ int (*unprepare)(struct drm_panel *panel);@@ -145,6 +152,20 @@ struct drm_panel {* Panel entry in registry. */ struct list_head list; + +/** +* @prepared: +* +* Set to true when the panel is successfully prepared. +*/ +bool prepared; + +/** +* @enabled: +* +* Set to true when the panel is successfully enabled. +*/ +bool enabled; };void drm_panel_init (struct drm_panel *panel);
Signature · 7 lines
Regards, Laurent Pinchart _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 14/16] drm/panel: call prepare/enable only once
Quoted 19 lines · Laurent Pinchart
Hi Sam,
Thank you for the patch.
Quoted 11 lines · Sam Ravnborg
Many panel drivers duplicate logic to prevent prepare to be called for a panel that is already prepared.
Likewise for enable.Implement this logic in
drm_panelso the individual drivers no longer needs this.
A panel is considered prepared/enabled only if the prepare/enable call succeeds.
For disable/unprepare it is unconditionally considered disabled/unprepared.Quoted 2 lines
This allows calls to prepare/enable again, even if there were some issue disabling a regulator or similar during disable/unprepare.
Quoted 7 lines
Is this the right place to handle this ? Shouldn't the upper layers ensure than enable/disable and prepare/unprepare are correcty balanced, and not called multiple times ? Adding enabled and prepared state to
drm_panelnot only doesn't align well with atomic state handling, but also would hide issues in upper layers that should really be fixed there.
Fully agreed. Mistakes happen - hiding them, by returning "success" does not sound like a wise approach.
HTH
Emil
Re: [PATCH v1 14/16] drm/panel: call prepare/enable only once
In reply to Laurent PinchartHi Laurent.
Quoted 16 lines · Sam Ravnborg
Quoted 11 lines
Many panel drivers duplicate logic to prevent prepare to be called for a panel that is already prepared.
Likewise for enable.Implement this logic in
drm_panelso the individual drivers no longer needs this.
A panel is considered prepared/enabled only if the prepare/enable call succeeds.
For disable/unprepare it is unconditionally considered disabled/unprepared.Quoted 2 lines
This allows calls to prepare/enable again, even if there were some issue disabling a regulator or similar during disable/unprepare.
Quoted 6 lines
Is this the right place to handle this ? Shouldn't the upper layers ensure than enable/disable and prepare/unprepare are correcty balanced, and not called multiple times ? Adding enabled and prepared state to
drm_panelnot only doesn't align well with atomic state handling, but also would hide issues in upper layers that should really be fixed there.
The main rationale behind starting on this was that ~15 panel drivers already implements logic to prevent the prepare/enable/disable/unprepare functions to be called out of order.
$ cd drivers/gpu/drm/panel/; git grep enabled | grep bool | wc -l
Several of the panel drivers also implements a mipi_dsi_driver.shutdown() or platform_driver.shutdown(). To the best of my knowledge we cannot guarantee that the upper layers have done the proper disable()/unprepare() dance before a shutdown. So the flags exists to allow the driver to unconditionally call disable() / unprepare() in the shutdown methods.
Same goes for *_driver.remove()
One improvement could be to detect if the panel is prepare() when upper layers call enable() and warn/error in this situation. With the current implementation this is not checked at all. Likewise for unprepare() (require it was never enabled or disable() was caled first)
I claim the check exists for the benefit of .remove and .shutdown, so we could also check if prepare() or enable() is called twice.
Adding logic to call prepare() automagically would hide probems in upper layers and this was only briefly considered - and discarded as hiding bugs.
So to sum up:
- Moving the checks from drivers to the core is a good thing
- The core shall check that a panel is prepared when enable is called and error out if not (or warn).
- The core shall check that a panel is disabled when unprepare is called and error out if not (or warn).
The core shall check if prepare() and enable() is called out of order.
The patch needs to be extended to cover the last three points.
Laurent / Emil / Thierry - agree/comments?
Note: Did a quick round to see if could spot any wrong use of drm_panel_* functions.
Most looked good, but then I did not do a throughly check.
bridge/analogix/analogix_dp_core.c looks fishy.
Looks like analogix_dp_prepare_panel() is a nop the way it is called. I did not look too much on this, maybe I am wrong.
Sam
Quoted 175 lines
Quoted 175 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Maarten Lankhorst <[email protected]>Cc Maxime Ripard <[email protected]>Cc Sean Paul <[email protected]>Cc Thierry Reding <[email protected]>Cc Sam Ravnborg <[email protected]>Cc David Airlie <[email protected]>Cc Daniel Vetter <[email protected]>--- drivers/gpu/drm/drm_panel.c | 66 ++++++++++++++++++++++++++++++------- include/drm/drm_panel.h | 21 ++++++++++++ 2 files changed, 75 insertions(+), 12 deletions(-)drivers/gpu/drm/drm_panel.c +54
-12@@ -66,10 +66,21 @@ EXPORT_SYMBOL(drm_panel_init);*/ int drm_panel_prepare (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->prepare) -return panel->funcs->prepare (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (panel->prepared) +return 0 ; + +if (panel->funcs && panel->funcs->prepare) + ret = panel->funcs->prepare (panel); + +if (ret >=0 ) + panel->prepared = true; + +return ret; }EXPORT_SYMBOL (drm_panel_prepare);@@ -85,10 +96,21 @@ EXPORT_SYMBOL(drm_panel_prepare);*/ int drm_panel_enable (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->enable) -return panel->funcs->enable (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (panel->enabled) +return 0 ; + +if (panel->funcs && panel->funcs->enable) + ret = panel->funcs->enable (panel); + +if (ret >=0 ) + panel->enabled = true; + +return ret; }EXPORT_SYMBOL (drm_panel_enable);@@ -104,10 +126,20 @@ EXPORT_SYMBOL(drm_panel_enable);*/ int drm_panel_disable (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->disable) -return panel->funcs->disable (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (!panel->enabled) +return 0 ; + +if (panel->funcs && panel->funcs->disable) + ret = panel->funcs->disable (panel); + + panel->enabled = false; + +return ret; }EXPORT_SYMBOL (drm_panel_disable);@@ -124,10 +156,20 @@ EXPORT_SYMBOL(drm_panel_disable);*/ int drm_panel_unprepare (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->unprepare) -return panel->funcs->unprepare (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (!panel->prepared) +return 0 ; + +if (panel->funcs && panel->funcs->unprepare) + ret = panel->funcs->unprepare (panel); + + panel->prepared = false; + +return ret; }EXPORT_SYMBOL (drm_panel_unprepare);include/drm/drm_panel.h +21
-0@@ -65,6 +65,9 @@ struct drm_panel_funcs {* @prepare: * * Turn on panel and perform set up. +* When the panel is successfully prepared the prepare() function +* will not be called again until the panel has been unprepared. +* */ int (*prepare)(struct drm_panel *panel);@@ -72,6 +75,8 @@ struct drm_panel_funcs {* @enable: * * Enable panel (turn on back light, etc.). +* When the panel is successfully enabled the enable() function +* will not be called again until the panel has been disabled. */ int (*enable)(struct drm_panel *panel);@@ -79,6 +84,7 @@ struct drm_panel_funcs {* @disable: * * Disable panel (turn off back light, etc.). +* If the panel is already disabled the disable() function is not called. */ int (*disable)(struct drm_panel *panel);@@ -86,6 +92,7 @@ struct drm_panel_funcs {* @unprepare: * * Turn off panel. +* If the panel is already unprepared the unprepare() function is not called. */ int (*unprepare)(struct drm_panel *panel);@@ -145,6 +152,20 @@ struct drm_panel {* Panel entry in registry. */ struct list_head list; + +/** +* @prepared: +* +* Set to true when the panel is successfully prepared. +*/ +bool prepared; + +/** +* @enabled: +* +* Set to true when the panel is successfully enabled. +*/ +bool enabled; };
Quoted 6 lines
Quoted 1 line
include/drm/drm_panel.h +0
-0void drm_panel_init (struct drm_panel *panel);Signature · 3 lines
Regards, Laurent Pinchart
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 14/16] drm/panel: call prepare/enable only once
Hi Sam,
Quoted 25 lines · Sam Ravnborg
Quoted 15 lines · Sam Ravnborg
Quoted 11 lines
Many panel drivers duplicate logic to prevent prepare to be called for a panel that is already prepared.
Likewise for enable.Implement this logic in
drm_panelso the individual drivers no longer needs this.
A panel is considered prepared/enabled only if the prepare/enable call succeeds.
For disable/unprepare it is unconditionally considered disabled/unprepared.Quoted 2 lines
This allows calls to prepare/enable again, even if there were some issue disabling a regulator or similar during disable/unprepare.
Quoted 6 lines
Is this the right place to handle this ? Shouldn't the upper layers ensure than enable/disable and prepare/unprepare are correcty balanced, and not called multiple times ? Adding enabled and prepared state to
drm_panelnot only doesn't align well with atomic state handling, but also would hide issues in upper layers that should really be fixed there.The main rationale behind starting on this was that ~15 panel drivers already implements logic to prevent the prepare/enable/disable/unprepare functions to be called out of order.
Quoted 6 lines
$ cd drivers/gpu/drm/panel/; git grep enabled | grep bool | wc -lSeveral of the panel drivers also implements a
mipi_dsi_driver.shutdown()orplatform_driver.shutdown(). To the best of my knowledge we cannot guarantee that the upper layers have done the proper disable()/unprepare() dance before a shutdown.
If the display controller drivers all behaved correctly, their .shutdown() implementation would disable all the output, and thus disable the panels. I think that's the best way forward, and we should ideally remove .shutdown() from the panel drivers, as otherwise the panel may be disabled before the display driver .shutdown() operation is called, and weird things can then happen.
This being said, guaranteeing proper operation of the display controller drivers isn't easy, so I'm not calling for removing .shutdown() from panel drivers right now, but I think we shouldn't accept that operation in new panel drivers going forward.
Quoted 3 lines
So the flags exists to allow the driver to unconditionally call
disable()/unprepare()in the shutdown methods.
Same goes for*_driver.remove()
I'd rather get rid of the hacks instead of trying to refactor them in generic hack-support helpers ;-) But I get your point, as an interim measure this is probably our best option.
Quoted 6 lines
One improvement could be to detect if the panel is
prepare()when upper layers callenable()and warn/error in this situation. With the current implementation this is not checked at all. Likewise forunprepare()(require it was never enabled ordisable()was caled first)
Quoted 6 lines
I claim the check exists for the benefit of .remove and .shutdown, so we could also check if
prepare()orenable()is called twice.Adding logic to call
prepare()automagically would hide probems in upper layers and this was only briefly considered - and discarded as hiding bugs.
I agree with you.
Quoted 11 lines
So to sum up:
- Moving the checks from drivers to the core is a good thing
- The core shall check that a panel is prepared when enable is called and error out if not (or warn).
- The core shall check that a panel is disabled when unprepare is called and error out if not (or warn).
The core shall check ifprepare()andenable()is called out of order.The patch needs to be extended to cover the last three points.
Laurent / Emil / Thierry - agree/comments?
Maybe with a note in the Documentation/gpu/todo.rst to remove .shutdown() in panel drivers as a long term goal ?
Quoted 183 lines
Note: Did a quick round to see if could spot any wrong use of drm_panel_* functions.
Most looked good, but then I did not do a throughly check.
bridge/analogix/analogix_dp_core.clooks fishy.
Looks likeanalogix_dp_prepare_panel()is a nop the way it is called. I did not look too much on this, maybe I am wrong.Quoted 175 lines
Quoted 175 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Maarten Lankhorst <[email protected]>Cc Maxime Ripard <[email protected]>Cc Sean Paul <[email protected]>Cc Thierry Reding <[email protected]>Cc Sam Ravnborg <[email protected]>Cc David Airlie <[email protected]>Cc Daniel Vetter <[email protected]>--- drivers/gpu/drm/drm_panel.c | 66 ++++++++++++++++++++++++++++++------- include/drm/drm_panel.h | 21 ++++++++++++ 2 files changed, 75 insertions(+), 12 deletions(-)drivers/gpu/drm/drm_panel.c +54
-12@@ -66,10 +66,21 @@ EXPORT_SYMBOL(drm_panel_init);*/ int drm_panel_prepare (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->prepare) -return panel->funcs->prepare (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (panel->prepared) +return 0 ; + +if (panel->funcs && panel->funcs->prepare) + ret = panel->funcs->prepare (panel); + +if (ret >=0 ) + panel->prepared = true; + +return ret; }EXPORT_SYMBOL (drm_panel_prepare);@@ -85,10 +96,21 @@ EXPORT_SYMBOL(drm_panel_prepare);*/ int drm_panel_enable (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->enable) -return panel->funcs->enable (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (panel->enabled) +return 0 ; + +if (panel->funcs && panel->funcs->enable) + ret = panel->funcs->enable (panel); + +if (ret >=0 ) + panel->enabled = true; + +return ret; }EXPORT_SYMBOL (drm_panel_enable);@@ -104,10 +126,20 @@ EXPORT_SYMBOL(drm_panel_enable);*/ int drm_panel_disable (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->disable) -return panel->funcs->disable (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (!panel->enabled) +return 0 ; + +if (panel->funcs && panel->funcs->disable) + ret = panel->funcs->disable (panel); + + panel->enabled = false; + +return ret; }EXPORT_SYMBOL (drm_panel_disable);@@ -124,10 +156,20 @@ EXPORT_SYMBOL(drm_panel_disable);*/ int drm_panel_unprepare (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->unprepare) -return panel->funcs->unprepare (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (!panel->prepared) +return 0 ; + +if (panel->funcs && panel->funcs->unprepare) + ret = panel->funcs->unprepare (panel); + + panel->prepared = false; + +return ret; }EXPORT_SYMBOL (drm_panel_unprepare);include/drm/drm_panel.h +21
-0@@ -65,6 +65,9 @@ struct drm_panel_funcs {* @prepare: * * Turn on panel and perform set up. +* When the panel is successfully prepared the prepare() function +* will not be called again until the panel has been unprepared. +* */ int (*prepare)(struct drm_panel *panel);@@ -72,6 +75,8 @@ struct drm_panel_funcs {* @enable: * * Enable panel (turn on back light, etc.). +* When the panel is successfully enabled the enable() function +* will not be called again until the panel has been disabled. */ int (*enable)(struct drm_panel *panel);@@ -79,6 +84,7 @@ struct drm_panel_funcs {* @disable: * * Disable panel (turn off back light, etc.). +* If the panel is already disabled the disable() function is not called. */ int (*disable)(struct drm_panel *panel);@@ -86,6 +92,7 @@ struct drm_panel_funcs {* @unprepare: * * Turn off panel. +* If the panel is already unprepared the unprepare() function is not called. */ int (*unprepare)(struct drm_panel *panel);@@ -145,6 +152,20 @@ struct drm_panel {* Panel entry in registry. */ struct list_head list; + +/** +* @prepared: +* +* Set to true when the panel is successfully prepared. +*/ +bool prepared; + +/** +* @enabled: +* +* Set to true when the panel is successfully enabled. +*/ +bool enabled; };void drm_panel_init (struct drm_panel *panel);
Signature · 7 lines
Regards, Laurent Pinchart _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Sean Paul
reviewerRe: [PATCH v1 14/16] drm/panel: call prepare/enable only once
In reply to Sam RavnborgQuoted 10 lines · Sam Ravnborg
Many panel drivers duplicate logic to prevent prepare to be called for a panel that is already prepared.
Likewise for enable.Implement this logic in
drm_panelso the individual drivers no longer needs this.
A panel is considered prepared/enabled only if the prepare/enable call succeeds.
For disable/unprepare it is unconditionally considered disabled/unprepared.
Hi Sam,
I did a similar thing a few years ago [1]. IIRC it was well received and just needed some nits cleaned up. Unfortunately I lost interest^W^W switched to other things and dropped it. So thanks for picking this back up!
Fast forward to today, I still think it's a good idea but I want to make sure this won't negatively interact with the self refresh helpers. With the helpers in place, it's possible to call disable consecutively (ie: once to enter self refresh and again to actually shut down). I did a quick pass and it looks like this patch might break that behavior, so you might want to take that into account.
Sean
[1]- https://patchwork.freedesktop.org/series/30712/
Quoted 182 lines
This allows calls to prepare/enable again, even if there were some issue disabling a regulator or similar during disable/unprepare.
Signed-off-by Sam Ravnborg <[email protected]>Cc Maarten Lankhorst <[email protected]>Cc Maxime Ripard <[email protected]>Cc Sean Paul <[email protected]>Cc Thierry Reding <[email protected]>Cc Sam Ravnborg <[email protected]>Cc David Airlie <[email protected]>Cc Daniel Vetter <[email protected]>--- drivers/gpu/drm/drm_panel.c | 66 ++++++++++++++++++++++++++++++------- include/drm/drm_panel.h | 21 ++++++++++++ 2 files changed, 75 insertions(+), 12 deletions(-)drivers/gpu/drm/drm_panel.c +54
-12@@ -66,10 +66,21 @@ EXPORT_SYMBOL(drm_panel_init);*/ int drm_panel_prepare (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->prepare) -return panel->funcs->prepare (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (panel->prepared) +return 0 ; + +if (panel->funcs && panel->funcs->prepare) + ret = panel->funcs->prepare (panel); + +if (ret >=0 ) + panel->prepared = true; + +return ret; }EXPORT_SYMBOL (drm_panel_prepare);@@ -85,10 +96,21 @@ EXPORT_SYMBOL(drm_panel_prepare);*/ int drm_panel_enable (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->enable) -return panel->funcs->enable (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (panel->enabled) +return 0 ; + +if (panel->funcs && panel->funcs->enable) + ret = panel->funcs->enable (panel); + +if (ret >=0 ) + panel->enabled = true; + +return ret; }EXPORT_SYMBOL (drm_panel_enable);@@ -104,10 +126,20 @@ EXPORT_SYMBOL(drm_panel_enable);*/ int drm_panel_disable (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->disable) -return panel->funcs->disable (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (!panel->enabled) +return 0 ; + +if (panel->funcs && panel->funcs->disable) + ret = panel->funcs->disable (panel); + + panel->enabled = false; + +return ret; }EXPORT_SYMBOL (drm_panel_disable);@@ -124,10 +156,20 @@ EXPORT_SYMBOL(drm_panel_disable);*/ int drm_panel_unprepare (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->unprepare) -return panel->funcs->unprepare (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (!panel->prepared) +return 0 ; + +if (panel->funcs && panel->funcs->unprepare) + ret = panel->funcs->unprepare (panel); + + panel->prepared = false; + +return ret; }EXPORT_SYMBOL (drm_panel_unprepare);include/drm/drm_panel.h +21
-0@@ -65,6 +65,9 @@ struct drm_panel_funcs {* @prepare: * * Turn on panel and perform set up. +* When the panel is successfully prepared the prepare() function +* will not be called again until the panel has been unprepared. +* */ int (*prepare)(struct drm_panel *panel);@@ -72,6 +75,8 @@ struct drm_panel_funcs {* @enable: * * Enable panel (turn on back light, etc.). +* When the panel is successfully enabled the enable() function +* will not be called again until the panel has been disabled. */ int (*enable)(struct drm_panel *panel);@@ -79,6 +84,7 @@ struct drm_panel_funcs {* @disable: * * Disable panel (turn off back light, etc.). +* If the panel is already disabled the disable() function is not called. */ int (*disable)(struct drm_panel *panel);@@ -86,6 +92,7 @@ struct drm_panel_funcs {* @unprepare: * * Turn off panel. +* If the panel is already unprepared the unprepare() function is not called. */ int (*unprepare)(struct drm_panel *panel);@@ -145,6 +152,20 @@ struct drm_panel {* Panel entry in registry. */ struct list_head list; + +/** +* @prepared: +* +* Set to true when the panel is successfully prepared. +*/ +bool prepared; + +/** +* @enabled: +* +* Set to true when the panel is successfully enabled. +*/ +bool enabled; };void drm_panel_init (struct drm_panel *panel);Signature · 1 line
2.20.1
Signature · 5 lines
Sean Paul, Software Engineer, Google / Chromium OS _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Laurent Pinchart
reviewerRe: [PATCH v1 14/16] drm/panel: call prepare/enable only once
Hi Sean,
Quoted 17 lines · Sean Paul
Quoted 10 lines · Sam Ravnborg
Many panel drivers duplicate logic to prevent prepare to be called for a panel that is already prepared.
Likewise for enable.Implement this logic in
drm_panelso the individual drivers no longer needs this.
A panel is considered prepared/enabled only if the prepare/enable call succeeds.
For disable/unprepare it is unconditionally considered disabled/unprepared.Hi Sam,
I did a similar thing a few years ago [1]. IIRC it was well received and just needed some nits cleaned up. Unfortunately I lost interest^W^W switched to other things and dropped it. So thanks for picking this back up!
Quoted 6 lines
Fast forward to today, I still think it's a good idea but I want to make sure this won't negatively interact with the self refresh helpers. With the helpers in place, it's possible to call disable consecutively (ie: once to enter self refresh and again to actually shut down). I did a quick pass and it looks like this patch might break that behavior, so you might want to take that into account.
Is this semantics documented somewhere ? The documentation of the panel disable operation is pretty terse, and we need to explicitly state who of the caller and callee needs to track the state.
Quoted 180 lines
[1]- https://patchwork.freedesktop.org/series/30712/
Quoted 178 lines
This allows calls to prepare/enable again, even if there were some issue disabling a regulator or similar during disable/unprepare.
Signed-off-by Sam Ravnborg <[email protected]>Cc Maarten Lankhorst <[email protected]>Cc Maxime Ripard <[email protected]>Cc Sean Paul <[email protected]>Cc Thierry Reding <[email protected]>Cc Sam Ravnborg <[email protected]>Cc David Airlie <[email protected]>Cc Daniel Vetter <[email protected]>--- drivers/gpu/drm/drm_panel.c | 66 ++++++++++++++++++++++++++++++------- include/drm/drm_panel.h | 21 ++++++++++++ 2 files changed, 75 insertions(+), 12 deletions(-)drivers/gpu/drm/drm_panel.c +54
-12@@ -66,10 +66,21 @@ EXPORT_SYMBOL(drm_panel_init);*/ int drm_panel_prepare (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->prepare) -return panel->funcs->prepare (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (panel->prepared) +return 0 ; + +if (panel->funcs && panel->funcs->prepare) + ret = panel->funcs->prepare (panel); + +if (ret >=0 ) + panel->prepared = true; + +return ret; }EXPORT_SYMBOL (drm_panel_prepare);@@ -85,10 +96,21 @@ EXPORT_SYMBOL(drm_panel_prepare);*/ int drm_panel_enable (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->enable) -return panel->funcs->enable (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (panel->enabled) +return 0 ; + +if (panel->funcs && panel->funcs->enable) + ret = panel->funcs->enable (panel); + +if (ret >=0 ) + panel->enabled = true; + +return ret; }EXPORT_SYMBOL (drm_panel_enable);@@ -104,10 +126,20 @@ EXPORT_SYMBOL(drm_panel_enable);*/ int drm_panel_disable (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->disable) -return panel->funcs->disable (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (!panel->enabled) +return 0 ; + +if (panel->funcs && panel->funcs->disable) + ret = panel->funcs->disable (panel); + + panel->enabled = false; + +return ret; }EXPORT_SYMBOL (drm_panel_disable);@@ -124,10 +156,20 @@ EXPORT_SYMBOL(drm_panel_disable);*/ int drm_panel_unprepare (struct drm_panel *panel) { -if (panel && panel->funcs && panel->funcs->unprepare) -return panel->funcs->unprepare (panel); +int ret = -ENOSYS ; -return panel ? -ENOSYS : -EINVAL ; +if (!panel) +return -EINVAL ; + +if (!panel->prepared) +return 0 ; + +if (panel->funcs && panel->funcs->unprepare) + ret = panel->funcs->unprepare (panel); + + panel->prepared = false; + +return ret; }EXPORT_SYMBOL (drm_panel_unprepare);include/drm/drm_panel.h +21
-0@@ -65,6 +65,9 @@ struct drm_panel_funcs {* @prepare: * * Turn on panel and perform set up. +* When the panel is successfully prepared the prepare() function +* will not be called again until the panel has been unprepared. +* */ int (*prepare)(struct drm_panel *panel);@@ -72,6 +75,8 @@ struct drm_panel_funcs {* @enable: * * Enable panel (turn on back light, etc.). +* When the panel is successfully enabled the enable() function +* will not be called again until the panel has been disabled. */ int (*enable)(struct drm_panel *panel);@@ -79,6 +84,7 @@ struct drm_panel_funcs {* @disable: * * Disable panel (turn off back light, etc.). +* If the panel is already disabled the disable() function is not called. */ int (*disable)(struct drm_panel *panel);@@ -86,6 +92,7 @@ struct drm_panel_funcs {* @unprepare: * * Turn off panel. +* If the panel is already unprepared the unprepare() function is not called. */ int (*unprepare)(struct drm_panel *panel);@@ -145,6 +152,20 @@ struct drm_panel {* Panel entry in registry. */ struct list_head list; + +/** +* @prepared: +* +* Set to true when the panel is successfully prepared. +*/ +bool prepared; + +/** +* @enabled: +* +* Set to true when the panel is successfully enabled. +*/ +bool enabled; };void drm_panel_init (struct drm_panel *panel);
Signature · 7 lines
Regards, Laurent Pinchart _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 15/16 drm/panel: add backlight support
In reply to Sam RavnborgPanels often supports backlight as specified in a device tree. Update the drm_panel infrastructure to support this to simplify the drivers.
With this the panel driver just needs to add the following to the probe() function:
err = drm_panel_of_backlight(panel);
if (err)
return err;Then drm_panel will handle all the rest.
--- drivers/gpu/drm/drm_panel.c | 41 +++++++++++++++++++++++++++++++++++++ include/drm/drm_panel.h | 23 +++++++++++++++++++++ 2 files changed, 64 insertions(+)
drivers/gpu/drm/drm_panel.c +41 -0
@@ -21,6 +21,7 @@* DEALINGS IN THE SOFTWARE. */ +#include <linux/backlight.h> #include <linux/err.h> #include <linux/module.h>
@@ -110,6 +111,7 @@ int drm_panel_enable(struct drm_panel *panel)if (ret >=0 ) panel->enabled = true; +backlight_enable (panel->backlight);return ret; }EXPORT_SYMBOL (drm_panel_enable);
@@ -134,6 +136,8 @@ int drm_panel_disable(struct drm_panel *panel)if (!panel->enabled)return 0 ; +backlight_disable (panel->backlight); +if (panel->funcs && panel->funcs->disable) ret = panel->funcs->disable (panel);
@@ -308,6 +312,43 @@ struct drm_panel *of_drm_find_panel(const struct device_node *np)EXPORT_SYMBOL (of_drm_find_panel);#endif +#ifdef CONFIG_BACKLIGHT_CLASS_DEVICE +/** +* drm_panel_of_backlight - use backlight device node for backlight +* @panel: DRM panel +* +* Use this function to enable backlight handling if your panel +* uses device tree and has a backlight handle. +* +* When panel is enabled backlight will be enabled after a +* successfull call to &drm_panel_funcs.enable() +* +* When panel is disabled backlight will be disabled before the +* call to &drm_panel_funcs.disable(). +* +* A typical implementation for a panel driver supporting device tree +* will call this function and then backlight just works. +* +* Return: 0 on success or a negative error code on failure. +*/ +int drm_panel_of_backlight (struct drm_panel *panel) +{ +struct backlight_device *backlight; + +if (!panel || !panel->dev) +return -EINVAL ; + + backlight =devm_of_find_backlight (panel->dev); + +if (IS_ERR (backlight)) +return PTR_ERR (backlight); + + panel->backlight = backlight; +return 0 ; +} +EXPORT_SYMBOL (drm_panel_of_backlight); +#endif +MODULE_AUTHOR ("Thierry Reding <[email protected]>" );MODULE_DESCRIPTION ("DRM panel infrastructure" );MODULE_LICENSE ("GPL and additional rights" );
include/drm/drm_panel.h +23 -0
@@ -28,6 +28,7 @@#include <linux/errno.h> #include <linux/list.h> +struct backlight_device ;struct device_node ;struct drm_connector ;struct drm_device ;
@@ -59,6 +60,10 @@ struct display_timing;* * To save power when no video data is transmitted, a driver can power down * the panel. This is the job of the .unprepare() function. +* +* Backlight can be handled automatically if configured using +* drm_panel_of_backlight(). Then the driver do not need to implement the +* functionality to enable/disable backlight. */ struct drm_panel_funcs {/**
@@ -139,6 +144,15 @@ struct drm_panel {*/ struct device *dev; +/** +* @backlight: +* +* Backlight device, used to turn on backlight after +* the call to enable(), and to turn off +* backlight before call to disable(). +*/ +struct backlight_device *backlight; +/** * @funcs: *
@@ -193,4 +207,13 @@ static inline struct drm_panel *of_drm_find_panel(const struct device_node *np) }#endif +#if defined(CONFIG_BACKLIGHT_CLASS_DEVICE ) && defined(CONFIG_DRM_PANEL ) +int drm_panel_of_backlight (struct drm_panel *panel); +#else +static inline int drm_panel_of_backlight (struct drm_panel *panel) +{ +return -EINVAL ; +} +#endif +#endif
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Laurent Pinchart
reviewerRe: [PATCH v1 15/16] drm/panel: add backlight support
Hi Sam,
Thank you for the patch.
Quoted 4 lines · Sam Ravnborg
Panels often supports backlight as specified in a device tree. Update the
drm_panelinfrastructure to support this to simplify the drivers.
Quoted 8 lines
With this the panel driver just needs to add the following to the
probe()function:err = drm_panel_of_backlight(panel); if (err) return err;Then
drm_panelwill handle all the rest.
Do you have an example on how this will simplify drivers ? How many existing panel drivers would benefit from this, and do you plan to convert them ?
Quoted 127 lines
Signed-off-by Sam Ravnborg <[email protected]>Cc Maarten Lankhorst <[email protected]>Cc Maxime Ripard <[email protected]>Cc Sean Paul <[email protected]>Cc Thierry Reding <[email protected]>Cc Sam Ravnborg <[email protected]>Cc David Airlie <[email protected]>Cc Daniel Vetter <[email protected]>--- drivers/gpu/drm/drm_panel.c | 41 +++++++++++++++++++++++++++++++++++++ include/drm/drm_panel.h | 23 +++++++++++++++++++++ 2 files changed, 64 insertions(+)drivers/gpu/drm/drm_panel.c +41
-0@@ -21,6 +21,7 @@* DEALINGS IN THE SOFTWARE. */ +#include <linux/backlight.h> #include <linux/err.h> #include <linux/module.h> @@ -110,6 +111,7 @@ int drm_panel_enable(struct drm_panel *panel)if (ret >=0 ) panel->enabled = true; +backlight_enable (panel->backlight);return ret; }EXPORT_SYMBOL (drm_panel_enable);@@ -134,6 +136,8 @@ int drm_panel_disable(struct drm_panel *panel)if (!panel->enabled)return 0 ; +backlight_disable (panel->backlight); +if (panel->funcs && panel->funcs->disable) ret = panel->funcs->disable (panel);@@ -308,6 +312,43 @@ struct drm_panel *of_drm_find_panel(const struct device_node *np)EXPORT_SYMBOL (of_drm_find_panel);#endif +#ifdef CONFIG_BACKLIGHT_CLASS_DEVICE +/** +* drm_panel_of_backlight - use backlight device node for backlight +* @panel: DRM panel +* +* Use this function to enable backlight handling if your panel +* uses device tree and has a backlight handle. +* +* When panel is enabled backlight will be enabled after a +* successfull call to &drm_panel_funcs.enable() +* +* When panel is disabled backlight will be disabled before the +* call to &drm_panel_funcs.disable(). +* +* A typical implementation for a panel driver supporting device tree +* will call this function and then backlight just works. +* +* Return: 0 on success or a negative error code on failure. +*/ +int drm_panel_of_backlight (struct drm_panel *panel) +{ +struct backlight_device *backlight; + +if (!panel || !panel->dev) +return -EINVAL ; + + backlight =devm_of_find_backlight (panel->dev); + +if (IS_ERR (backlight)) +return PTR_ERR (backlight); + + panel->backlight = backlight; +return 0 ; +} +EXPORT_SYMBOL (drm_panel_of_backlight); +#endif +MODULE_AUTHOR ("Thierry Reding <[email protected]>" );MODULE_DESCRIPTION ("DRM panel infrastructure" );MODULE_LICENSE ("GPL and additional rights" );include/drm/drm_panel.h +14
-0@@ -28,6 +28,7 @@#include <linux/errno.h> #include <linux/list.h> +struct backlight_device ;struct device_node ;struct drm_connector ;struct drm_device ;@@ -59,6 +60,10 @@ struct display_timing;* * To save power when no video data is transmitted, a driver can power down * the panel. This is the job of the .unprepare() function. +* +* Backlight can be handled automatically if configured using +* drm_panel_of_backlight(). Then the driver do not need to implement the +* functionality to enable/disable backlight. */ struct drm_panel_funcs {/** @@ -139,6 +144,15 @@ struct drm_panel {*/ struct device *dev; +/** +* @backlight: +* +* Backlight device, used to turn on backlight after +* the call to enable(), and to turn off +* backlight before call to disable(). +*/ +struct backlight_device *backlight; +/** * @funcs: *
include/drm/drm_panel.h static inline struct drm_panel *of_drm_find_panel(const struct device_node *np) · line 211
Quoted 5 lines
include/drm/drm_panel.h +2
-0@@ -193,4 +207,13 @@ static inline struct drm_panel *of_drm_find_panel(const struct device_node *np) }#endif +#if defined(CONFIG_BACKLIGHT_CLASS_DEVICE ) && defined(CONFIG_DRM_PANEL ) +int drm_panel_of_backlight (struct drm_panel *panel);
I would expect callers of this function to depend on (or select) CONFIG_DRM_PANEL, so I would drop it from here.
include/drm/drm_panel.h static inline struct drm_panel *of_drm_find_panel(const struct device_node *np) · line 215
Quoted 4 lines
include/drm/drm_panel.h +4
-0+#else +static inline int drm_panel_of_backlight (struct drm_panel *panel) +{ +return -EINVAL ;
Maybe -ENOSYS ?
Quoted 4 lines
include/drm/drm_panel.h +3
-0+} +#endif +#endif
Signature · 7 lines
Regards, Laurent Pinchart _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
PATCH 16/16 drm/panel: simple: use drm_panel infrastructure
In reply to Sam RavnborgUse drm_panel infrastrucute:
- drm_panel has guards for calling disable/enable twice
- drm_panel has backlight support
To use the drm_panel infrastructure use the drm_panel_* variants for prepare/enable/disable/unprepare.
--- drivers/gpu/drm/panel/panel-simple.c | 73 +++++----------------------- 1 file changed, 11 insertions(+), 62 deletions(-)
drivers/gpu/drm/panel/panel-simple.c +11 -62
@@ -21,7 +21,6 @@* DEALINGS IN THE SOFTWARE. */ -#include <linux/backlight.h> #include <linux/delay.h> #include <linux/gpio/consumer.h> #include <linux/module.h>
@@ -98,13 +97,10 @@ struct panel_desc {struct panel_simple {struct drm_panel base; -bool prepared; -bool enabled;bool no_hpd;const struct panel_desc *desc; -struct backlight_device *backlight;struct regulator *supply;struct i2c_adapter *ddc;
@@ -232,20 +228,9 @@ static int panel_simple_disable(struct drm_panel *panel) {struct panel_simple *p =to_panel_simple (panel); -if (!p->enabled) -return 0 ; - -if (p->backlight) { - p->backlight->props.power =FB_BLANK_POWERDOWN ; - p->backlight->props.state |=BL_CORE_FBBLANK ; -backlight_update_status (p->backlight); - } -if (p->desc->delay.disable)msleep (p->desc->delay.disable); - p->enabled = false; -return 0 ; }
@@ -253,9 +238,6 @@ static int panel_simple_unprepare(struct drm_panel *panel) {struct panel_simple *p =to_panel_simple (panel); -if (!p->prepared) -return 0 ; -gpiod_set_value_cansleep (p->enable_gpio,0 );regulator_disable (p->supply);
@@ -263,8 +245,6 @@ static int panel_simple_unprepare(struct drm_panel *panel)if (p->desc->delay.unprepare)msleep (p->desc->delay.unprepare); - p->prepared = false; -return 0 ; }
@@ -274,9 +254,6 @@ static int panel_simple_prepare(struct drm_panel *panel)unsigned int delay;int err; -if (p->prepared) -return 0 ; - err =regulator_enable (p->supply);if (err <0 ) {dev_err (panel->dev,"failed to enable supply: %d\n" , err);
@@ -291,8 +268,6 @@ static int panel_simple_prepare(struct drm_panel *panel)if (delay)msleep (delay); - p->prepared = true; -return 0 ; }
@@ -300,20 +275,9 @@ static int panel_simple_enable(struct drm_panel *panel) {struct panel_simple *p =to_panel_simple (panel); -if (p->enabled) -return 0 ; -if (p->desc->delay.enable)msleep (p->desc->delay.enable); -if (p->backlight) { - p->backlight->props.state &= ~BL_CORE_FBBLANK ; - p->backlight->props.power =FB_BLANK_UNBLANK ; -backlight_update_status (p->backlight); - } - - p->enabled = true; -return 0 ; }
@@ -413,7 +377,7 @@ static void panel_simple_parse_panel_timing_node(struct device *dev,static int panel_simple_probe (struct device *dev,const struct panel_desc *desc) { -struct device_node *backlight, *ddc; +struct device_node *ddc;struct panel_simple *panel;struct display_timing dt;int err;
@@ -422,8 +386,6 @@ static int panel_simple_probe(struct device *dev, const struct panel_desc *desc)if (!panel)return -ENOMEM ; - panel->enabled = false; - panel->prepared = false; panel->desc = desc; panel->no_hpd =of_property_read_bool (dev->of_node,"no-hpd" );
@@ -441,24 +403,13 @@ static int panel_simple_probe(struct device *dev, const struct panel_desc *desc)return err; } - backlight =of_parse_phandle (dev->of_node,"backlight" ,0 ); -if (backlight) { - panel->backlight =of_find_backlight_by_node (backlight); -of_node_put (backlight); - -if (!panel->backlight) -return -EPROBE_DEFER ; - } - ddc =of_parse_phandle (dev->of_node,"ddc-i2c-bus" ,0 );if (ddc) { panel->ddc =of_find_i2c_adapter_by_node (ddc);of_node_put (ddc); -if (!panel->ddc) { - err = -EPROBE_DEFER ; - goto free_backlight; - } +if (!panel->ddc) +return -EPROBE_DEFER ; }if (!of_get_display_timing (dev->of_node,"panel-timing" , &dt))
@@ -468,6 +419,10 @@ static int panel_simple_probe(struct device *dev, const struct panel_desc *desc) panel->base.dev = dev; panel->base.funcs = &panel_simple_funcs; + err =drm_panel_of_backlight (&panel->base); +if (err) + goto free_ddc; + err =drm_panel_add (&panel->base);if (err <0 ) goto free_ddc;
@@ -479,9 +434,6 @@ static int panel_simple_probe(struct device *dev, const struct panel_desc *desc) free_ddc:if (panel->ddc)put_device (&panel->ddc->dev); -free_backlight: -if (panel->backlight) -put_device (&panel->backlight->dev);return err; }
@@ -492,15 +444,12 @@ static int panel_simple_remove(struct device *dev)drm_panel_remove (&panel->base); -panel_simple_disable (&panel->base); -panel_simple_unprepare (&panel->base); +drm_panel_disable (&panel->base); +drm_panel_unprepare (&panel->base);if (panel->ddc)put_device (&panel->ddc->dev); -if (panel->backlight) -put_device (&panel->backlight->dev); -return 0 ; }
@@ -508,8 +457,8 @@ static void panel_simple_shutdown(struct device *dev) {struct panel_simple *panel =dev_get_drvdata (dev); -panel_simple_disable (&panel->base); -panel_simple_unprepare (&panel->base); +drm_panel_disable (&panel->base); +drm_panel_unprepare (&panel->base); }static const struct drm_display_mode ampire_am_480272h3tmqw_t01h_mode = {
Signature · 6 lines
2.20.1 _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Re: [PATCH v1 16/16] drm/panel: simple: use drm_panel infrastructure
Hi Sam,
Thank you for the patch.
Quoted 2 lines · Sam Ravnborg
Use
drm_panelinfrastrucute:
-drm_panelhas guards for calling disable/enable twice
As stated in the review of the corresponding patch, I think those checks should be dropped, but not moved to the panel core.
Quoted 1 line
-
drm_panelhas backlight support
This answers my first question in the review of 15/16 :-)
Quoted 6 lines
To use the
drm_panelinfrastructure use the drm_panel_* variants for prepare/enable/disable/unprepare.Signed-off-by Sam Ravnborg <[email protected]>Cc Thierry Reding <[email protected]>Cc Sam Ravnborg <[email protected]>
The change looks good overall,
but this is pending an agreement on what to do with the multiple prepare/enable guards.
Quoted 167 lines
--- drivers/gpu/drm/panel/panel-simple.c | 73 +++++----------------------- 1 file changed, 11 insertions(+), 62 deletions(-)drivers/gpu/drm/panel/panel-simple.c +7
-52@@ -21,7 +21,6 @@* DEALINGS IN THE SOFTWARE. */ -#include <linux/backlight.h> #include <linux/delay.h> #include <linux/gpio/consumer.h> #include <linux/module.h> @@ -98,13 +97,10 @@ struct panel_desc {struct panel_simple {struct drm_panel base; -bool prepared; -bool enabled;bool no_hpd;const struct panel_desc *desc; -struct backlight_device *backlight;struct regulator *supply;struct i2c_adapter *ddc;@@ -232,20 +228,9 @@ static int panel_simple_disable(struct drm_panel *panel) {struct panel_simple *p =to_panel_simple (panel); -if (!p->enabled) -return 0 ; - -if (p->backlight) { - p->backlight->props.power =FB_BLANK_POWERDOWN ; - p->backlight->props.state |=BL_CORE_FBBLANK ; -backlight_update_status (p->backlight); - } -if (p->desc->delay.disable)msleep (p->desc->delay.disable); - p->enabled = false; -return 0 ; }@@ -253,9 +238,6 @@ static int panel_simple_unprepare(struct drm_panel *panel) {struct panel_simple *p =to_panel_simple (panel); -if (!p->prepared) -return 0 ; -gpiod_set_value_cansleep (p->enable_gpio,0 );regulator_disable (p->supply);@@ -263,8 +245,6 @@ static int panel_simple_unprepare(struct drm_panel *panel)if (p->desc->delay.unprepare)msleep (p->desc->delay.unprepare); - p->prepared = false; -return 0 ; }@@ -274,9 +254,6 @@ static int panel_simple_prepare(struct drm_panel *panel)unsigned int delay;int err; -if (p->prepared) -return 0 ; - err =regulator_enable (p->supply);if (err <0 ) {dev_err (panel->dev,"failed to enable supply: %d\n" , err);@@ -291,8 +268,6 @@ static int panel_simple_prepare(struct drm_panel *panel)if (delay)msleep (delay); - p->prepared = true; -return 0 ; }@@ -300,20 +275,9 @@ static int panel_simple_enable(struct drm_panel *panel) {struct panel_simple *p =to_panel_simple (panel); -if (p->enabled) -return 0 ; -if (p->desc->delay.enable)msleep (p->desc->delay.enable); -if (p->backlight) { - p->backlight->props.state &= ~BL_CORE_FBBLANK ; - p->backlight->props.power =FB_BLANK_UNBLANK ; -backlight_update_status (p->backlight); - } - - p->enabled = true; -return 0 ; }@@ -413,7 +377,7 @@ static void panel_simple_parse_panel_timing_node(struct device *dev,static int panel_simple_probe (struct device *dev,const struct panel_desc *desc) { -struct device_node *backlight, *ddc; +struct device_node *ddc;struct panel_simple *panel;struct display_timing dt;int err;@@ -422,8 +386,6 @@ static int panel_simple_probe(struct device *dev, const struct panel_desc *desc)if (!panel)return -ENOMEM ; - panel->enabled = false; - panel->prepared = false; panel->desc = desc; panel->no_hpd =of_property_read_bool (dev->of_node,"no-hpd" );@@ -441,24 +403,13 @@ static int panel_simple_probe(struct device *dev, const struct panel_desc *desc)return err; } - backlight =of_parse_phandle (dev->of_node,"backlight" ,0 ); -if (backlight) { - panel->backlight =of_find_backlight_by_node (backlight); -of_node_put (backlight); - -if (!panel->backlight) -return -EPROBE_DEFER ; - } - ddc =of_parse_phandle (dev->of_node,"ddc-i2c-bus" ,0 );if (ddc) { panel->ddc =of_find_i2c_adapter_by_node (ddc);of_node_put (ddc); -if (!panel->ddc) { - err = -EPROBE_DEFER ; - goto free_backlight; - } +if (!panel->ddc) +return -EPROBE_DEFER ; }if (!of_get_display_timing (dev->of_node,"panel-timing" , &dt))@@ -468,6 +419,10 @@ static int panel_simple_probe(struct device *dev, const struct panel_desc *desc) panel->base.dev = dev; panel->base.funcs = &panel_simple_funcs; + err =drm_panel_of_backlight (&panel->base); +if (err) + goto free_ddc; + err =drm_panel_add (&panel->base);if (err <0 ) goto free_ddc;
drivers/gpu/drm/panel/panel-simple.c static int panel_simple_probe(struct device *dev, const struct panel_desc *desc) · line 484
Quoted 6 lines
drivers/gpu/drm/panel/panel-simple.c +0
-3@@ -479,9 +434,6 @@ static int panel_simple_probe(struct device *dev, const struct panel_desc *desc) free_ddc:if (panel->ddc)put_device (&panel->ddc->dev); -free_backlight: -if (panel->backlight) -put_device (&panel->backlight->dev);
This looks weird, where
Quoted 32 lines
drivers/gpu/drm/panel/panel-simple.c +4
-7return err; }@@ -492,15 +444,12 @@ static int panel_simple_remove(struct device *dev)drm_panel_remove (&panel->base); -panel_simple_disable (&panel->base); -panel_simple_unprepare (&panel->base); +drm_panel_disable (&panel->base); +drm_panel_unprepare (&panel->base);if (panel->ddc)put_device (&panel->ddc->dev); -if (panel->backlight) -put_device (&panel->backlight->dev); -return 0 ; }@@ -508,8 +457,8 @@ static void panel_simple_shutdown(struct device *dev) {struct panel_simple *panel =dev_get_drvdata (dev); -panel_simple_disable (&panel->base); -panel_simple_unprepare (&panel->base); +drm_panel_disable (&panel->base); +drm_panel_unprepare (&panel->base); }static const struct drm_display_mode ampire_am_480272h3tmqw_t01h_mode = {
Signature · 7 lines
Regards, Laurent Pinchart _______________________________________________ dri-devel mailing list [email protected] https://lists.freedesktop.org/mailman/listinfo/dri-devel
Quoted 20 lines · Sam Ravnborg
The first 9 patches replaces direct use of the
drm_panelfunction pointers with their drm_panel_* counterparts. The function pointers are only supposed to be used by thedrm_panelinfrastructure and direct use are discouraged.ili9322 is updated to handle
bus_flagsinget_modeslike everyone else. This is in preparation for a later patch series where controller becomes an arugument toget_modes()and not like today wheredrm_panelis attached to a controller.The remaining patches move functionality to the
drm_panelcore that today are repeated in many drivers.
As preparation for this the inline functions are moved todrm_panel.cand kernel-doc is made inline.
panel-simple is updated to benefit from the additional infrastructure and is an example for the simplifications that can be done.The patchset has been tested on my embedded target, and build tested.
Quoted 7 lines
Feedback welcome!
The "fix opencoded" patches are all independent and can be applied out of order. They were kept here to keep panel related patches in one series.
Sam
Thanks for working on this Sam.
Patches 1-13 are:
-Emil
_______________________________________________
dri-devel mailing list
[email protected]
https://lists.freedesktop.org/mailman/listinfo/dri-devel