Quelle  intel_fb_pin.c   Sprache: C

// SPDX-License-Identifier: MIT
/*
 * Copyright © 2021 Intel Corporation
 */

/**
 * DOC: display pinning helpers
 */

#include "gem/i915_gem_domain.h"
#include "gem/i915_gem_object.h"

#include "i915_drv.h"
#include "intel_display_core.h"
#include "intel_display_rpm.h"
#include "intel_display_types.h"
#include "intel_dpt.h"
#include "intel_fb.h"
#include "intel_fb_pin.h"
#include "intel_plane.h"

static struct i915_vma *
intel_fb_pin_to_dpt(const struct drm_framebuffer *fb,
      const struct i915_gtt_view *view,
      unsigned int alignment,
      unsigned long *out_flags,
      struct i915_address_space *vm)
{
 struct drm_device *dev = fb->dev;
 struct intel_display *display = to_intel_display(dev);
 struct drm_i915_private *dev_priv = to_i915(dev);
 struct drm_gem_object *_obj = intel_fb_bo(fb);
 struct drm_i915_gem_object *obj = to_intel_bo(_obj);
 struct i915_gem_ww_ctx ww;
 struct i915_vma *vma;
 int ret;

 /*
 * We are not syncing against the binding (and potential migrations)
 * below, so this vm must never be async.
 */
 if (drm_WARN_ON(&dev_priv->drm, vm->bind_async_flags))
  return ERR_PTR(-EINVAL);

 if (WARN_ON(!i915_gem_object_is_framebuffer(obj)))
  return ERR_PTR(-EINVAL);

 atomic_inc(&display->restore.pending_fb_pin);

 for_i915_gem_ww(&ww, ret, true) {
  ret = i915_gem_object_lock(obj, &ww);
  if (ret)
   continue;

  if (HAS_LMEM(dev_priv)) {
   unsigned int flags = obj->flags;

   /*
 * For this type of buffer we need to able to read from the CPU
 * the clear color value found in the buffer, hence we need to
 * ensure it is always in the mappable part of lmem, if this is
 * a small-bar device.
 */
   if (intel_fb_rc_ccs_cc_plane(fb) >= 0)
    flags &= ~I915_BO_ALLOC_GPU_ONLY;
   ret = __i915_gem_object_migrate(obj, &ww, INTEL_REGION_LMEM_0,
       flags);
   if (ret)
    continue;
  }

  ret = i915_gem_object_set_cache_level(obj, I915_CACHE_NONE);
  if (ret)
   continue;

  vma = i915_vma_instance(obj, vm, view);
  if (IS_ERR(vma)) {
   ret = PTR_ERR(vma);
   continue;
  }

  if (i915_vma_misplaced(vma, 0, alignment, 0)) {
   ret = i915_vma_unbind(vma);
   if (ret)
    continue;
  }

  ret = i915_vma_pin_ww(vma, &ww, 0, alignment, PIN_GLOBAL);
  if (ret)
   continue;
 }
 if (ret) {
  vma = ERR_PTR(ret);
  goto err;
 }

 vma->display_alignment = max(vma->display_alignment, alignment);

 i915_gem_object_flush_if_display(obj);

 i915_vma_get(vma);
err:
 atomic_dec(&display->restore.pending_fb_pin);

 return vma;
}

struct i915_vma *
intel_fb_pin_to_ggtt(const struct drm_framebuffer *fb,
       const struct i915_gtt_view *view,
       unsigned int alignment,
       unsigned int phys_alignment,
       unsigned int vtd_guard,
       bool uses_fence,
       unsigned long *out_flags)
{
 struct drm_device *dev = fb->dev;
 struct intel_display *display = to_intel_display(dev);
 struct drm_i915_private *dev_priv = to_i915(dev);
 struct drm_gem_object *_obj = intel_fb_bo(fb);
 struct drm_i915_gem_object *obj = to_intel_bo(_obj);
 struct ref_tracker *wakeref;
 struct i915_gem_ww_ctx ww;
 struct i915_vma *vma;
 unsigned int pinctl;
 int ret;

 if (drm_WARN_ON(dev, !i915_gem_object_is_framebuffer(obj)))
  return ERR_PTR(-EINVAL);

 if (drm_WARN_ON(dev, alignment && !is_power_of_2(alignment)))
  return ERR_PTR(-EINVAL);

 /*
 * Global gtt pte registers are special registers which actually forward
 * writes to a chunk of system memory. Which means that there is no risk
 * that the register values disappear as soon as we call
 * intel_runtime_pm_put(), so it is correct to wrap only the
 * pin/unpin/fence and not more.
 */
 wakeref = intel_display_rpm_get(display);

 atomic_inc(&display->restore.pending_fb_pin);

 /*
 * Valleyview is definitely limited to scanning out the first
 * 512MiB. Lets presume this behaviour was inherited from the
 * g4x display engine and that all earlier gen are similarly
 * limited. Testing suggests that it is a little more
 * complicated than this. For example, Cherryview appears quite
 * happy to scanout from anywhere within its global aperture.
 */
 pinctl = 0;
 if (HAS_GMCH(dev_priv))
  pinctl |= PIN_MAPPABLE;

 i915_gem_ww_ctx_init(&ww, true);
retry:
 ret = i915_gem_object_lock(obj, &ww);
 if (!ret && phys_alignment)
  ret = i915_gem_object_attach_phys(obj, phys_alignment);
 else if (!ret && HAS_LMEM(dev_priv))
  ret = i915_gem_object_migrate(obj, &ww, INTEL_REGION_LMEM_0);
 if (!ret)
  ret = i915_gem_object_pin_pages(obj);
 if (ret)
  goto err;

 vma = i915_gem_object_pin_to_display_plane(obj, &ww, alignment,
         vtd_guard, view, pinctl);
 if (IS_ERR(vma)) {
  ret = PTR_ERR(vma);
  goto err_unpin;
 }

 if (uses_fence && i915_vma_is_map_and_fenceable(vma)) {
  /*
 * Install a fence for tiled scan-out. Pre-i965 always needs a
 * fence, whereas 965+ only requires a fence if using
 * framebuffer compression.  For simplicity, we always, when
 * possible, install a fence as the cost is not that onerous.
 *
 * If we fail to fence the tiled scanout, then either the
 * modeset will reject the change (which is highly unlikely as
 * the affected systems, all but one, do not have unmappable
 * space) or we will not be able to enable full powersaving
 * techniques (also likely not to apply due to various limits
 * FBC and the like impose on the size of the buffer, which
 * presumably we violated anyway with this unmappable buffer).
 * Anyway, it is presumably better to stumble onwards with
 * something and try to run the system in a "less than optimal"
 * mode that matches the user configuration.
 */
  ret = i915_vma_pin_fence(vma);
  if (ret != 0 && DISPLAY_VER(dev_priv) < 4) {
   i915_vma_unpin(vma);
   goto err_unpin;
  }
  ret = 0;

  if (vma->fence)
   *out_flags |= PLANE_HAS_FENCE;
 }

 i915_vma_get(vma);

err_unpin:
 i915_gem_object_unpin_pages(obj);
err:
 if (ret == -EDEADLK) {
  ret = i915_gem_ww_ctx_backoff(&ww);
  if (!ret)
   goto retry;
 }
 i915_gem_ww_ctx_fini(&ww);
 if (ret)
  vma = ERR_PTR(ret);

 atomic_dec(&display->restore.pending_fb_pin);
 intel_display_rpm_put(display, wakeref);
 return vma;
}

void intel_fb_unpin_vma(struct i915_vma *vma, unsigned long flags)
{
 if (flags & PLANE_HAS_FENCE)
  i915_vma_unpin_fence(vma);
 i915_vma_unpin(vma);
 i915_vma_put(vma);
}

static unsigned int
intel_plane_fb_min_alignment(const struct intel_plane_state *plane_state)
{
 const struct intel_framebuffer *fb = to_intel_framebuffer(plane_state->hw.fb);

 return fb->min_alignment;
}

static unsigned int
intel_plane_fb_min_phys_alignment(const struct intel_plane_state *plane_state)
{
 struct intel_plane *plane = to_intel_plane(plane_state->uapi.plane);
 const struct drm_framebuffer *fb = plane_state->hw.fb;

 if (!intel_plane_needs_physical(plane))
  return 0;

 return plane->min_alignment(plane, fb, 0);
}

static unsigned int
intel_plane_fb_vtd_guard(const struct intel_plane_state *plane_state)
{
 return intel_fb_view_vtd_guard(plane_state->hw.fb,
           &plane_state->view,
           plane_state->hw.rotation);
}

int intel_plane_pin_fb(struct intel_plane_state *plane_state,
         const struct intel_plane_state *old_plane_state)
{
 struct intel_plane *plane = to_intel_plane(plane_state->uapi.plane);
 const struct intel_framebuffer *fb =
  to_intel_framebuffer(plane_state->hw.fb);
 struct i915_vma *vma;

 if (!intel_fb_uses_dpt(&fb->base)) {
  vma = intel_fb_pin_to_ggtt(&fb->base, &plane_state->view.gtt,
        intel_plane_fb_min_alignment(plane_state),
        intel_plane_fb_min_phys_alignment(plane_state),
        intel_plane_fb_vtd_guard(plane_state),
        intel_plane_uses_fence(plane_state),
        &plane_state->flags);
  if (IS_ERR(vma))
   return PTR_ERR(vma);

  plane_state->ggtt_vma = vma;

  /*
 * Pre-populate the dma address before we enter the vblank
 * evade critical section as i915_gem_object_get_dma_address()
 * will trigger might_sleep() even if it won't actually sleep,
 * which is the case when the fb has already been pinned.
 */
  if (intel_plane_needs_physical(plane)) {
   struct drm_i915_gem_object *obj = to_intel_bo(intel_fb_bo(&fb->base));

   plane_state->phys_dma_addr = i915_gem_object_get_dma_address(obj, 0);
  }
 } else {
  unsigned int alignment = intel_plane_fb_min_alignment(plane_state);

  vma = intel_dpt_pin_to_ggtt(fb->dpt_vm, alignment / 512);
  if (IS_ERR(vma))
   return PTR_ERR(vma);

  plane_state->ggtt_vma = vma;

  vma = intel_fb_pin_to_dpt(&fb->base, &plane_state->view.gtt,
       alignment, &plane_state->flags,
       fb->dpt_vm);
  if (IS_ERR(vma)) {
   intel_dpt_unpin_from_ggtt(fb->dpt_vm);
   plane_state->ggtt_vma = NULL;
   return PTR_ERR(vma);
  }

  plane_state->dpt_vma = vma;

  WARN_ON(plane_state->ggtt_vma == plane_state->dpt_vma);
 }

 return 0;
}

void intel_plane_unpin_fb(struct intel_plane_state *old_plane_state)
{
 const struct intel_framebuffer *fb =
  to_intel_framebuffer(old_plane_state->hw.fb);
 struct i915_vma *vma;

 if (!intel_fb_uses_dpt(&fb->base)) {
  vma = fetch_and_zero(&old_plane_state->ggtt_vma);
  if (vma)
   intel_fb_unpin_vma(vma, old_plane_state->flags);
 } else {
  vma = fetch_and_zero(&old_plane_state->dpt_vma);
  if (vma)
   intel_fb_unpin_vma(vma, old_plane_state->flags);

  vma = fetch_and_zero(&old_plane_state->ggtt_vma);
  if (vma)
   intel_dpt_unpin_from_ggtt(fb->dpt_vm);
 }
}

void intel_fb_get_map(struct i915_vma *vma, struct iosys_map *map)
{
 iosys_map_set_vaddr_iomem(map, i915_vma_get_iomap(vma));
}