gt/uc/intel_guc.h

   1 /* SPDX-License-Identifier: MIT */
   2 /*
   3  * Copyright © 2014-2019 Intel Corporation
   4  */
   5
   6 #ifndef _INTEL_GUC_H_
   7 #define _INTEL_GUC_H_
   8
   9 #include "intel_uncore.h"
  10 #include "intel_guc_fw.h"
  11 #include "intel_guc_fwif.h"
  12 #include "intel_guc_ct.h"
  13 #include "intel_guc_log.h"
  14 #include "intel_guc_reg.h"
  15 #include "intel_uc_fw.h"
  16 #include "i915_utils.h"
  17 #include "i915_vma.h"
  18
  19 struct __guc_ads_blob;
  20
  21 /*
  22  * Top level structure of GuC. It handles firmware loading and manages client
  23  * pool. intel_guc owns a intel_guc_client to replace the legacy ExecList
  24  * submission.
  25  */
  26 struct intel_guc {
  27         struct intel_uc_fw fw;
  28         struct intel_guc_log log;
  29         struct intel_guc_ct ct;
  30
  31         /* intel_guc_recv interrupt related state */
  32         spinlock_t irq_lock;
  33         unsigned int msg_enabled_mask;
  34
  35         struct {
  36                 bool enabled;
  37                 void (*reset)(struct intel_guc *guc);
  38                 void (*enable)(struct intel_guc *guc);
  39                 void (*disable)(struct intel_guc *guc);
  40         } interrupts;
  41
  42         bool submission_selected;
  43
  44         struct i915_vma *ads_vma;
  45         struct __guc_ads_blob *ads_blob;
  46
  47         struct i915_vma *stage_desc_pool;
  48         void *stage_desc_pool_vaddr;
  49
  50         struct i915_vma *workqueue;
  51         void *workqueue_vaddr;
  52         spinlock_t wq_lock;
  53
  54         struct i915_vma *proc_desc;
  55         void *proc_desc_vaddr;
  56
  57         /* Control params for fw initialization */
  58         u32 params[GUC_CTL_MAX_DWORDS];
  59
  60         /* GuC's FW specific registers used in MMIO send */
  61         struct {
  62                 u32 base;
  63                 unsigned int count;
  64                 enum forcewake_domains fw_domains;
  65         } send_regs;
  66
  67         /* register used to send interrupts to the GuC FW */
  68         i915_reg_t notify_reg;
  69
  70         /* Store msg (e.g. log flush) that we see while CTBs are disabled */
  71         u32 mmio_msg;
  72
  73         /* To serialize the intel_guc_send actions */
  74         struct mutex send_mutex;
  75 };
  76
  77 static inline struct intel_guc *log_to_guc(struct intel_guc_log *log)
  78 {
  79         return container_of(log, struct intel_guc, log);
  80 }
  81
  82 static
  83 inline int intel_guc_send(struct intel_guc *guc, const u32 *action, u32 len)
  84 {
  85         return intel_guc_ct_send(&guc->ct, action, len, NULL, 0);
  86 }
  87
  88 static inline int
  89 intel_guc_send_and_receive(struct intel_guc *guc, const u32 *action, u32 len,
  90                            u32 *response_buf, u32 response_buf_size)
  91 {
  92         return intel_guc_ct_send(&guc->ct, action, len,
  93                                  response_buf, response_buf_size);
  94 }
  95
  96 static inline void intel_guc_to_host_event_handler(struct intel_guc *guc)
  97 {
  98         intel_guc_ct_event_handler(&guc->ct);
  99 }
 100
 101 /* GuC addresses above GUC_GGTT_TOP also don't map through the GTT */
 102 #define GUC_GGTT_TOP    0xFEE00000
 103
 104 /**
 105  * intel_guc_ggtt_offset() - Get and validate the GGTT offset of @vma
 106  * @guc: intel_guc structure.
 107  * @vma: i915 graphics virtual memory area.
 108  *
 109  * GuC does not allow any gfx GGTT address that falls into range
 110  * [0, ggtt.pin_bias), which is reserved for Boot ROM, SRAM and WOPCM.
 111  * Currently, in order to exclude [0, ggtt.pin_bias) address space from
 112  * GGTT, all gfx objects used by GuC are allocated with intel_guc_allocate_vma()
 113  * and pinned with PIN_OFFSET_BIAS along with the value of ggtt.pin_bias.
 114  *
 115  * Return: GGTT offset of the @vma.
 116  */
 117 static inline u32 intel_guc_ggtt_offset(struct intel_guc *guc,
 118                                         struct i915_vma *vma)
 119 {
 120         u32 offset = i915_ggtt_offset(vma);
 121
 122         GEM_BUG_ON(offset < i915_ggtt_pin_bias(vma));
 123         GEM_BUG_ON(range_overflows_t(u64, offset, vma->size, GUC_GGTT_TOP));
 124
 125         return offset;
 126 }
 127
 128 void intel_guc_init_early(struct intel_guc *guc);
 129 void intel_guc_init_send_regs(struct intel_guc *guc);
 130 void intel_guc_write_params(struct intel_guc *guc);
 131 int intel_guc_init(struct intel_guc *guc);
 132 void intel_guc_fini(struct intel_guc *guc);
 133 void intel_guc_notify(struct intel_guc *guc);
 134 int intel_guc_send_mmio(struct intel_guc *guc, const u32 *action, u32 len,
 135                         u32 *response_buf, u32 response_buf_size);
 136 int intel_guc_to_host_process_recv_msg(struct intel_guc *guc,
 137                                        const u32 *payload, u32 len);
 138 int intel_guc_sample_forcewake(struct intel_guc *guc);
 139 int intel_guc_auth_huc(struct intel_guc *guc, u32 rsa_offset);
 140 int intel_guc_suspend(struct intel_guc *guc);
 141 int intel_guc_resume(struct intel_guc *guc);
 142 struct i915_vma *intel_guc_allocate_vma(struct intel_guc *guc, u32 size);
 143 int intel_guc_allocate_and_map_vma(struct intel_guc *guc, u32 size,
 144                                    struct i915_vma **out_vma, void **out_vaddr);
 145
 146 static inline bool intel_guc_is_supported(struct intel_guc *guc)
 147 {
 148         return intel_uc_fw_is_supported(&guc->fw);
 149 }
 150
 151 static inline bool intel_guc_is_wanted(struct intel_guc *guc)
 152 {
 153         return intel_uc_fw_is_enabled(&guc->fw);
 154 }
 155
 156 static inline bool intel_guc_is_used(struct intel_guc *guc)
 157 {
 158         GEM_BUG_ON(__intel_uc_fw_status(&guc->fw) == INTEL_UC_FIRMWARE_SELECTED);
 159         return intel_uc_fw_is_available(&guc->fw);
 160 }
 161
 162 static inline bool intel_guc_is_fw_running(struct intel_guc *guc)
 163 {
 164         return intel_uc_fw_is_running(&guc->fw);
 165 }
 166
 167 static inline bool intel_guc_is_ready(struct intel_guc *guc)
 168 {
 169         return intel_guc_is_fw_running(guc) && intel_guc_ct_enabled(&guc->ct);
 170 }
 171
 172 static inline int intel_guc_sanitize(struct intel_guc *guc)
 173 {
 174         intel_uc_fw_sanitize(&guc->fw);
 175         intel_guc_ct_sanitize(&guc->ct);
 176         guc->mmio_msg = 0;
 177
 178         return 0;
 179 }
 180
 181 static inline void intel_guc_enable_msg(struct intel_guc *guc, u32 mask)
 182 {
 183         spin_lock_irq(&guc->irq_lock);
 184         guc->msg_enabled_mask |= mask;
 185         spin_unlock_irq(&guc->irq_lock);
 186 }
 187
 188 static inline void intel_guc_disable_msg(struct intel_guc *guc, u32 mask)
 189 {
 190         spin_lock_irq(&guc->irq_lock);
 191         guc->msg_enabled_mask &= ~mask;
 192         spin_unlock_irq(&guc->irq_lock);
 193 }
 194
 195 int intel_guc_reset_engine(struct intel_guc *guc,
 196                            struct intel_engine_cs *engine);
 197
 198 void intel_guc_load_status(struct intel_guc *guc, struct drm_printer *p);
 199
 200 #endif