[PATCH 1/4] drm/vram: Add helpers to validate a display mode's memory requirements

Daniel Vetter daniel at ffwll.ch
Mon Feb 3 09:49:30 UTC 2020


On Sat, Feb 01, 2020 at 01:27:41PM +0100, Thomas Zimmermann wrote:
> Devices with low amount of dedicated video memory may not be able
> to use all possible display modes, as the framebuffers may not fit
> into VRAM. The new helper function drm_vram_helper_mode_valid()
> implements a simple test to sort out all display modes that can
> not be used in any case. Drivers should call this function from
> struct drm_mode_config_funcs.mode_valid.
> 
> Calling drm_vram_helper_mode_valid() works best for 32-bit framebuffers;
> drivers with framebuffers of different color depth can use
> drm_vram_helper_mode_valid_internal() instead.
> 
> The functionality was originally implemented by the ast driver, which
> is being converted as well.
> 
> Signed-off-by: Thomas Zimmermann <tzimmermann at suse.de>
> ---
>  drivers/gpu/drm/ast/ast_main.c        | 24 +--------
>  drivers/gpu/drm/drm_gem_vram_helper.c | 76 +++++++++++++++++++++++++++
>  include/drm/drm_gem_vram_helper.h     | 14 +++++
>  3 files changed, 91 insertions(+), 23 deletions(-)
> 
> diff --git a/drivers/gpu/drm/ast/ast_main.c b/drivers/gpu/drm/ast/ast_main.c
> index b79f484e9bd2..18a0a4ce00f6 100644
> --- a/drivers/gpu/drm/ast/ast_main.c
> +++ b/drivers/gpu/drm/ast/ast_main.c
> @@ -388,31 +388,9 @@ static int ast_get_dram_info(struct drm_device *dev)
>  	return 0;
>  }
>  
> -enum drm_mode_status ast_mode_config_mode_valid(struct drm_device *dev,
> -						const struct drm_display_mode *mode)
> -{
> -	static const unsigned long max_bpp = 4; /* DRM_FORMAT_XRGBA8888 */
> -
> -	struct ast_private *ast = dev->dev_private;
> -	unsigned long fbsize, fbpages, max_fbpages;
> -
> -	/* To support double buffering, a framebuffer may not
> -	 * consume more than half of the available VRAM.
> -	 */
> -	max_fbpages = (ast->vram_size / 2) >> PAGE_SHIFT;
> -
> -	fbsize = mode->hdisplay * mode->vdisplay * max_bpp;
> -	fbpages = DIV_ROUND_UP(fbsize, PAGE_SIZE);
> -
> -	if (fbpages > max_fbpages)
> -		return MODE_MEM;
> -
> -	return MODE_OK;
> -}
> -
>  static const struct drm_mode_config_funcs ast_mode_funcs = {
>  	.fb_create = drm_gem_fb_create,
> -	.mode_valid = ast_mode_config_mode_valid,
> +	.mode_valid = drm_vram_helper_mode_valid,
>  	.atomic_check = drm_atomic_helper_check,
>  	.atomic_commit = drm_atomic_helper_commit,
>  };
> diff --git a/drivers/gpu/drm/drm_gem_vram_helper.c b/drivers/gpu/drm/drm_gem_vram_helper.c
> index a4863326061a..89aebd500655 100644
> --- a/drivers/gpu/drm/drm_gem_vram_helper.c
> +++ b/drivers/gpu/drm/drm_gem_vram_helper.c
> @@ -1141,3 +1141,79 @@ void drm_vram_helper_release_mm(struct drm_device *dev)
>  	dev->vram_mm = NULL;
>  }
>  EXPORT_SYMBOL(drm_vram_helper_release_mm);
> +
> +/*
> + * Mode-config helpers
> + */
> +
> +/**
> + * drm_vram_helper_mode_valid_internal - Tests if a display mode's
> + *	framebuffer fits into the available video memory.
> + * @dev:	the DRM device
> + * @mode:	the mode to test
> + * @max_bpp:	the maximum number of bytes per pixel

Does this render correctly? I thought an empty comment line is required
between comments and the free-form paragraphs ... Also usual style (in drm
at least) is that the Returns: block is more towards the end of the text,
and not indented.


> + * Returns:
> + *	MODE_OK the display mode is supported, or an error code of type
> + *	enum drm_mode_status otherwise.
> + *
> + * This function tests if enough video memory is available using the
> + * specified display mode. Atomic modesetting requires importing the
> + * designated framebuffer into video memory before evicting the active
> + * one. Hence, any framebuffer may consume at most half of the available
> + * VRAM. Display modes that require a larger framebuffer can not be used,
> + * even of the CRTC does support them.
> + *
> + * Drivers should call this function from
> + * struct drm_mode_config_funcs.mode_valid. See drm_vram_helper_mode_valid()
> + * for framebuffers that use at most 32-bit color depth.
> + *
> + * Note:
> + *	The function can only test if the display mode is supported in
> + *	general. If you have too many framebuffers pinned to video memory,
> + *	a display mode may still not be usable in practice.
> + */
> +enum drm_mode_status
> +drm_vram_helper_mode_valid_internal(struct drm_device *dev,
> +				    const struct drm_display_mode *mode,
> +				    unsigned long max_bpp)
> +{
> +	struct drm_vram_mm *vmm = dev->vram_mm;
> +	unsigned long fbsize, fbpages, max_fbpages;
> +
> +	if (!dev->vram_mm)

This is a driver bug imo (most likely of enabling hotplug/output detection
before the vram handling is set up), needs to be wrapped in a WARN_ON to
catch this.

> +		return MODE_BAD;
> +
> +	max_fbpages = (vmm->vram_size / 2) >> PAGE_SHIFT;
> +
> +	fbsize = mode->hdisplay * mode->vdisplay * max_bpp;
> +	fbpages = DIV_ROUND_UP(fbsize, PAGE_SIZE);
> +
> +	if (fbpages > max_fbpages)
> +		return MODE_MEM;
> +
> +	return MODE_OK;
> +}
> +EXPORT_SYMBOL(drm_vram_helper_mode_valid_internal);

Anyway, patch looks good (with the nits addressed one way or the other):

Reviewed-by: Daniel Vetter <daniel.vetter at ffwll.ch>
> +
> +/**
> + * drm_vram_helper_mode_valid - Tests if a display mode's
> + *	framebuffer fits into the available video memory.
> + * @dev:	the DRM device
> + * @mode:	the mode to test
> + * Returns:
> + *	MODE_OK the display mode is supported, or an error code of type
> + *	enum drm_mode_status otherwise.
> + *
> + * This function is a variant of drm_vram_helper_mode_valid_internal()
> + * for framebuffers that use at most 32-bit color depth. It can be plugged
> + * directly into struct drm_mode_config_funcs.mode_valid.
> + */
> +enum drm_mode_status
> +drm_vram_helper_mode_valid(struct drm_device *dev,
> +			   const struct drm_display_mode *mode)
> +{
> +	static const unsigned long max_bpp = 4; /* DRM_FORMAT_XRGBA8888 */
> +
> +	return drm_vram_helper_mode_valid_internal(dev, mode, max_bpp);
> +}
> +EXPORT_SYMBOL(drm_vram_helper_mode_valid);
> diff --git a/include/drm/drm_gem_vram_helper.h b/include/drm/drm_gem_vram_helper.h
> index 573e9fd109bf..e7d9144c79ad 100644
> --- a/include/drm/drm_gem_vram_helper.h
> +++ b/include/drm/drm_gem_vram_helper.h
> @@ -6,6 +6,7 @@
>  #include <drm/drm_file.h>
>  #include <drm/drm_gem.h>
>  #include <drm/drm_ioctl.h>
> +#include <drm/drm_modes.h>
>  #include <drm/ttm/ttm_bo_api.h>
>  #include <drm/ttm/ttm_bo_driver.h>
>  #include <drm/ttm/ttm_placement.h>
> @@ -205,4 +206,17 @@ struct drm_vram_mm *drm_vram_helper_alloc_mm(
>  	struct drm_device *dev, uint64_t vram_base, size_t vram_size);
>  void drm_vram_helper_release_mm(struct drm_device *dev);
>  
> +/*
> + * Mode-config helpers
> + */
> +
> +enum drm_mode_status
> +drm_vram_helper_mode_valid_internal(struct drm_device *dev,
> +				    const struct drm_display_mode *mode,
> +				    unsigned long max_bpp);
> +
> +enum drm_mode_status
> +drm_vram_helper_mode_valid(struct drm_device *dev,
> +			   const struct drm_display_mode *mode);
> +
>  #endif
> -- 
> 2.25.0
> 

-- 
Daniel Vetter
Software Engineer, Intel Corporation
http://blog.ffwll.ch


More information about the dri-devel mailing list