drivers/gpu/drm/i915/gt/intel_engine_pm.h

   1 /* SPDX-License-Identifier: MIT */
   2 /*
   3  * Copyright © 2019 Intel Corporation
   4  */
   5
   6 #ifndef INTEL_ENGINE_PM_H
   7 #define INTEL_ENGINE_PM_H
   8
   9 #include "i915_request.h"
  10 #include "intel_engine_types.h"
  11 #include "intel_wakeref.h"
  12
  13 static inline bool
  14 intel_engine_pm_is_awake(const struct intel_engine_cs *engine)
  15 {
  16         return intel_wakeref_is_active(&engine->wakeref);
  17 }
  18
  19 static inline void intel_engine_pm_get(struct intel_engine_cs *engine)
  20 {
  21         intel_wakeref_get(&engine->wakeref);
  22 }
  23
  24 static inline bool intel_engine_pm_get_if_awake(struct intel_engine_cs *engine)
  25 {
  26         return intel_wakeref_get_if_active(&engine->wakeref);
  27 }
  28
  29 static inline void intel_engine_pm_put(struct intel_engine_cs *engine)
  30 {
  31         intel_wakeref_put(&engine->wakeref);
  32 }
  33
  34 static inline void intel_engine_pm_put_async(struct intel_engine_cs *engine)
  35 {
  36         intel_wakeref_put_async(&engine->wakeref);
  37 }
  38
  39 static inline void intel_engine_pm_put_delay(struct intel_engine_cs *engine,
  40                                              unsigned long delay)
  41 {
  42         intel_wakeref_put_delay(&engine->wakeref, delay);
  43 }
  44
  45 static inline void intel_engine_pm_flush(struct intel_engine_cs *engine)
  46 {
  47         intel_wakeref_unlock_wait(&engine->wakeref);
  48 }
  49
  50 static inline struct i915_request *
  51 intel_engine_create_kernel_request(struct intel_engine_cs *engine)
  52 {
  53         struct i915_request *rq;
  54
  55         /*
  56          * The engine->kernel_context is special as it is used inside
  57          * the engine-pm barrier (see __engine_park()), circumventing
  58          * the usual mutexes and relying on the engine-pm barrier
  59          * instead. So whenever we use the engine->kernel_context
  60          * outside of the barrier, we must manually handle the
  61          * engine wakeref to serialise with the use inside.
  62          */
  63         intel_engine_pm_get(engine);
  64         rq = i915_request_create(engine->kernel_context);
  65         intel_engine_pm_put(engine);
  66
  67         return rq;
  68 }
  69
  70 void intel_engine_init__pm(struct intel_engine_cs *engine);
  71
  72 #endif /* INTEL_ENGINE_PM_H */