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

   1 /* SPDX-License-Identifier: MIT */
   2 /*
   3  * Copyright © 2019 Intel Corporation
   4  */
   5
   6 #ifndef INTEL_GT_PM_H
   7 #define INTEL_GT_PM_H
   8
   9 #include <linux/types.h>
  10
  11 #include "intel_gt_types.h"
  12 #include "intel_wakeref.h"
  13
  14 static inline bool intel_gt_pm_is_awake(const struct intel_gt *gt)
  15 {
  16         return intel_wakeref_is_active(&gt->wakeref);
  17 }
  18
  19 static inline void intel_gt_pm_get(struct intel_gt *gt)
  20 {
  21         intel_wakeref_get(&gt->wakeref);
  22 }
  23
  24 static inline void __intel_gt_pm_get(struct intel_gt *gt)
  25 {
  26         __intel_wakeref_get(&gt->wakeref);
  27 }
  28
  29 static inline bool intel_gt_pm_get_if_awake(struct intel_gt *gt)
  30 {
  31         return intel_wakeref_get_if_active(&gt->wakeref);
  32 }
  33
  34 static inline void intel_gt_pm_might_get(struct intel_gt *gt)
  35 {
  36         intel_wakeref_might_get(&gt->wakeref);
  37 }
  38
  39 static inline void intel_gt_pm_put(struct intel_gt *gt)
  40 {
  41         intel_wakeref_put(&gt->wakeref);
  42 }
  43
  44 static inline void intel_gt_pm_put_async(struct intel_gt *gt)
  45 {
  46         intel_wakeref_put_async(&gt->wakeref);
  47 }
  48
  49 static inline void intel_gt_pm_might_put(struct intel_gt *gt)
  50 {
  51         intel_wakeref_might_put(&gt->wakeref);
  52 }
  53
  54 #define with_intel_gt_pm(gt, tmp) \
  55         for (tmp = 1, intel_gt_pm_get(gt); tmp; \
  56              intel_gt_pm_put(gt), tmp = 0)
  57
  58 /**
  59  * with_intel_gt_pm_if_awake - if GT is PM awake, get a reference to prevent
  60  *      it to sleep, run some code and then asynchrously put the reference
  61  *      away.
  62  *
  63  * @gt: pointer to the gt
  64  * @wf: pointer to a temporary wakeref.
  65  */
  66 #define with_intel_gt_pm_if_awake(gt, wf) \
  67         for (wf = intel_gt_pm_get_if_awake(gt); wf; intel_gt_pm_put_async(gt), wf = 0)
  68
  69 static inline int intel_gt_pm_wait_for_idle(struct intel_gt *gt)
  70 {
  71         return intel_wakeref_wait_for_idle(&gt->wakeref);
  72 }
  73
  74 void intel_gt_pm_init_early(struct intel_gt *gt);
  75 void intel_gt_pm_init(struct intel_gt *gt);
  76 void intel_gt_pm_fini(struct intel_gt *gt);
  77
  78 void intel_gt_suspend_prepare(struct intel_gt *gt);
  79 void intel_gt_suspend_late(struct intel_gt *gt);
  80 int intel_gt_resume(struct intel_gt *gt);
  81 void intel_gt_resume_early(struct intel_gt *gt);
  82
  83 void intel_gt_runtime_suspend(struct intel_gt *gt);
  84 int intel_gt_runtime_resume(struct intel_gt *gt);
  85
  86 ktime_t intel_gt_get_awake_time(const struct intel_gt *gt);
  87
  88 static inline bool is_mock_gt(const struct intel_gt *gt)
  89 {
  90         return I915_SELFTEST_ONLY(gt->awake == -ENODEV);
  91 }
  92
  93 #endif /* INTEL_GT_PM_H */