Re: [PATCH 01/17] drm/sun4i: Refactor DE2 code

From: Maxime Ripard
Date: Tue Nov 28 2017 - 10:55:12 EST


Hi,

On Mon, Nov 27, 2017 at 09:57:34PM +0100, Jernej Skrabec wrote:
> Since the time initial DE2 driver was written, some knowledge was gained
> what setting are really necessary and what most of the magic values
> mean.
>
> This commit renames some of the macro names to better fit the real
> meaning, replace default values with self explaining macros where
> possible and removes settings which are not really needed.
>
> Signed-off-by: Jernej Skrabec <jernej.skrabec@xxxxxxxx>

While those changes are quite welcome, it should be split in a number
of patches...

> ---
> drivers/gpu/drm/sun4i/sun8i_mixer.c | 65 +++++++++++++++++++------------------
> drivers/gpu/drm/sun4i/sun8i_mixer.h | 31 ++++++++----------
> 2 files changed, 47 insertions(+), 49 deletions(-)
>
> diff --git a/drivers/gpu/drm/sun4i/sun8i_mixer.c b/drivers/gpu/drm/sun4i/sun8i_mixer.c
> index cb193c5f1686..015943c0ed5a 100644
> --- a/drivers/gpu/drm/sun4i/sun8i_mixer.c
> +++ b/drivers/gpu/drm/sun4i/sun8i_mixer.c
> @@ -44,7 +44,8 @@ void sun8i_mixer_layer_enable(struct sun8i_mixer *mixer,
> /* Currently the first UI channel is used */
> int chan = mixer->cfg->vi_num;
>
> - DRM_DEBUG_DRIVER("Enabling layer %d in channel %d\n", layer, chan);
> + DRM_DEBUG_DRIVER("%sabling layer %d in channel %d\n",
> + enable ? "En" : "Dis", layer, chan);
>
> if (enable)
> val = SUN8I_MIXER_CHAN_UI_LAYER_ATTR_EN;
> @@ -55,15 +56,14 @@ void sun8i_mixer_layer_enable(struct sun8i_mixer *mixer,
> SUN8I_MIXER_CHAN_UI_LAYER_ATTR(chan, layer),
> SUN8I_MIXER_CHAN_UI_LAYER_ATTR_EN, val);
>
> - /* Set the alpha configuration */
> - regmap_update_bits(mixer->engine.regs,
> - SUN8I_MIXER_CHAN_UI_LAYER_ATTR(chan, layer),
> - SUN8I_MIXER_CHAN_UI_LAYER_ATTR_ALPHA_MODE_MASK,
> - SUN8I_MIXER_CHAN_UI_LAYER_ATTR_ALPHA_MODE_DEF);
> + if (enable)
> + val = SUN8I_MIXER_BLEND_PIPE_CTL_EN(chan);
> + else
> + val = 0;
> +
> regmap_update_bits(mixer->engine.regs,
> - SUN8I_MIXER_CHAN_UI_LAYER_ATTR(chan, layer),
> - SUN8I_MIXER_CHAN_UI_LAYER_ATTR_ALPHA_MASK,
> - SUN8I_MIXER_CHAN_UI_LAYER_ATTR_ALPHA_DEF);
> + SUN8I_MIXER_BLEND_PIPE_CTL,
> + SUN8I_MIXER_BLEND_PIPE_CTL_EN(chan), val);

... For example, this part right here will remove the alpha setup
part, without any justification in the commit log ...

> }
>
> static int sun8i_mixer_drm_format_to_layer(struct drm_plane *plane,
> @@ -71,15 +71,15 @@ static int sun8i_mixer_drm_format_to_layer(struct drm_plane *plane,
> {
> switch (format) {
> case DRM_FORMAT_ARGB8888:
> - *mode = SUN8I_MIXER_CHAN_UI_LAYER_ATTR_FBFMT_ARGB8888;
> + *mode = SUN8I_MIXER_FBFMT_ARGB8888;
> break;
>
> case DRM_FORMAT_XRGB8888:
> - *mode = SUN8I_MIXER_CHAN_UI_LAYER_ATTR_FBFMT_XRGB8888;
> + *mode = SUN8I_MIXER_FBFMT_XRGB8888;
> break;
>
> case DRM_FORMAT_RGB888:
> - *mode = SUN8I_MIXER_CHAN_UI_LAYER_ATTR_FBFMT_RGB888;
> + *mode = SUN8I_MIXER_FBFMT_RGB888;
> break;
>
> default:
> @@ -107,7 +107,7 @@ int sun8i_mixer_update_layer_coord(struct sun8i_mixer *mixer,
> state->crtc_h));
> DRM_DEBUG_DRIVER("Updating blender size\n");
> regmap_write(mixer->engine.regs,
> - SUN8I_MIXER_BLEND_ATTR_INSIZE(0),
> + SUN8I_MIXER_BLEND_ATTR_INSIZE(chan),

I guess that one is fixing a bug too.

> SUN8I_MIXER_SIZE(state->crtc_w,
> state->crtc_h));
> regmap_write(mixer->engine.regs, SUN8I_MIXER_BLEND_OUTSIZE,
> @@ -173,6 +173,7 @@ int sun8i_mixer_update_layer_formats(struct sun8i_mixer *mixer,
> return ret;
> }
>
> + val <<= SUN8I_MIXER_CHAN_UI_LAYER_ATTR_FBFMT_OFFSET;
> regmap_update_bits(mixer->engine.regs,
> SUN8I_MIXER_CHAN_UI_LAYER_ATTR(chan, layer),
> SUN8I_MIXER_CHAN_UI_LAYER_ATTR_FBFMT_MASK, val);
> @@ -247,6 +248,7 @@ static int sun8i_mixer_bind(struct device *dev, struct device *master,
> struct sun8i_mixer *mixer;
> struct resource *res;
> void __iomem *regs;
> + int plane_cnt;
> int i, ret;
>
> /*
> @@ -325,27 +327,26 @@ static int sun8i_mixer_bind(struct device *dev, struct device *master,
> regmap_write(mixer->engine.regs, SUN8I_MIXER_GLOBAL_CTL,
> SUN8I_MIXER_GLOBAL_CTL_RT_EN);
>
> - /* Initialize blender */
> - regmap_write(mixer->engine.regs, SUN8I_MIXER_BLEND_FCOLOR_CTL,
> - SUN8I_MIXER_BLEND_FCOLOR_CTL_DEF);
> - regmap_write(mixer->engine.regs, SUN8I_MIXER_BLEND_PREMULTIPLY,
> - SUN8I_MIXER_BLEND_PREMULTIPLY_DEF);
> + /* Set background color to black */
> regmap_write(mixer->engine.regs, SUN8I_MIXER_BLEND_BKCOLOR,
> - SUN8I_MIXER_BLEND_BKCOLOR_DEF);
> - regmap_write(mixer->engine.regs, SUN8I_MIXER_BLEND_MODE(0),
> - SUN8I_MIXER_BLEND_MODE_DEF);
> - regmap_write(mixer->engine.regs, SUN8I_MIXER_BLEND_CK_CTL,
> - SUN8I_MIXER_BLEND_CK_CTL_DEF);
> + SUN8I_MIXER_BLEND_COLOR_BLACK);
>
> - regmap_write(mixer->engine.regs,
> - SUN8I_MIXER_BLEND_ATTR_FCOLOR(0),
> - SUN8I_MIXER_BLEND_ATTR_FCOLOR_DEF);
> -
> - /* Select the first UI channel */
> - DRM_DEBUG_DRIVER("Selecting channel %d (first UI channel)\n",
> - mixer->cfg->vi_num);
> - regmap_write(mixer->engine.regs, SUN8I_MIXER_BLEND_ROUTE,
> - mixer->cfg->vi_num);
> + /*
> + * Set fill color of bottom plane to black. Generally not needed
> + * except when VI plane is at bottom (zpos = 0) and enabled.
> + */
> + regmap_write(mixer->engine.regs, SUN8I_MIXER_BLEND_PIPE_CTL,
> + SUN8I_MIXER_BLEND_PIPE_CTL_FC_EN(0));
> + regmap_write(mixer->engine.regs, SUN8I_MIXER_BLEND_ATTR_FCOLOR(0),
> + SUN8I_MIXER_BLEND_COLOR_BLACK);
> +
> + /* Fixed zpos for now */
> + regmap_write(mixer->engine.regs, SUN8I_MIXER_BLEND_ROUTE, 0x43210);
> +
> + plane_cnt = mixer->cfg->vi_num + mixer->cfg->ui_num;
> + for (i = 0; i < plane_cnt; i++)
> + regmap_write(mixer->engine.regs, SUN8I_MIXER_BLEND_MODE(i),
> + SUN8I_MIXER_BLEND_MODE_DEF);

You're reworking a significant part here as well, with some part
moving (or being removed) and no clear justifications as to why you
need to do that.

This is not only an issue when you want to review this code, but also
if you happen to introduce a bug, then someone bisects and finds that
commit. It's quite difficult in that case what part is actually
breaking stuff.

Thanks!
Maxime

--
Maxime Ripard, Free Electrons
Embedded Linux and Kernel engineering
http://free-electrons.com

Attachment: signature.asc
Description: PGP signature