drivers/gpu/drm/i915/gt/uc/intel_huc.h

   1 /* SPDX-License-Identifier: MIT */
   2 /*
   3  * Copyright © 2014-2019 Intel Corporation
   4  */
   5
   6 #ifndef _INTEL_HUC_H_
   7 #define _INTEL_HUC_H_
   8
   9 #include "i915_reg_defs.h"
  10 #include "i915_sw_fence.h"
  11 #include "intel_uc_fw.h"
  12 #include "intel_huc_fw.h"
  13
  14 #include <linux/notifier.h>
  15 #include <linux/hrtimer.h>
  16
  17 struct bus_type;
  18 struct i915_vma;
  19
  20 enum intel_huc_delayed_load_status {
  21         INTEL_HUC_WAITING_ON_GSC = 0,
  22         INTEL_HUC_WAITING_ON_PXP,
  23         INTEL_HUC_DELAYED_LOAD_ERROR,
  24 };
  25
  26 enum intel_huc_authentication_type {
  27         INTEL_HUC_AUTH_BY_GUC = 0,
  28         INTEL_HUC_AUTH_BY_GSC,
  29         INTEL_HUC_AUTH_MAX_MODES
  30 };
  31
  32 struct intel_huc {
  33         /* Generic uC firmware management */
  34         struct intel_uc_fw fw;
  35
  36         /* HuC-specific additions */
  37         struct {
  38                 i915_reg_t reg;
  39                 u32 mask;
  40                 u32 value;
  41         } status[INTEL_HUC_AUTH_MAX_MODES];
  42
  43         struct {
  44                 struct i915_sw_fence fence;
  45                 struct hrtimer timer;
  46                 struct notifier_block nb;
  47                 enum intel_huc_delayed_load_status status;
  48         } delayed_load;
  49
  50         /* for load via GSCCS */
  51         struct i915_vma *heci_pkt;
  52
  53         bool loaded_via_gsc;
  54 };
  55
  56 int intel_huc_sanitize(struct intel_huc *huc);
  57 void intel_huc_init_early(struct intel_huc *huc);
  58 int intel_huc_init(struct intel_huc *huc);
  59 void intel_huc_fini(struct intel_huc *huc);
  60 void intel_huc_suspend(struct intel_huc *huc);
  61 int intel_huc_auth(struct intel_huc *huc, enum intel_huc_authentication_type type);
  62 int intel_huc_wait_for_auth_complete(struct intel_huc *huc,
  63                                      enum intel_huc_authentication_type type);
  64 bool intel_huc_is_authenticated(struct intel_huc *huc,
  65                                 enum intel_huc_authentication_type type);
  66 int intel_huc_check_status(struct intel_huc *huc);
  67 void intel_huc_update_auth_status(struct intel_huc *huc);
  68
  69 void intel_huc_register_gsc_notifier(struct intel_huc *huc, const struct bus_type *bus);
  70 void intel_huc_unregister_gsc_notifier(struct intel_huc *huc, const struct bus_type *bus);
  71
  72 static inline bool intel_huc_is_supported(struct intel_huc *huc)
  73 {
  74         return intel_uc_fw_is_supported(&huc->fw);
  75 }
  76
  77 static inline bool intel_huc_is_wanted(struct intel_huc *huc)
  78 {
  79         return intel_uc_fw_is_enabled(&huc->fw);
  80 }
  81
  82 static inline bool intel_huc_is_used(struct intel_huc *huc)
  83 {
  84         GEM_BUG_ON(__intel_uc_fw_status(&huc->fw) == INTEL_UC_FIRMWARE_SELECTED);
  85         return intel_uc_fw_is_available(&huc->fw);
  86 }
  87
  88 static inline bool intel_huc_is_loaded_by_gsc(const struct intel_huc *huc)
  89 {
  90         return huc->loaded_via_gsc;
  91 }
  92
  93 static inline bool intel_huc_wait_required(struct intel_huc *huc)
  94 {
  95         return intel_huc_is_used(huc) && intel_huc_is_loaded_by_gsc(huc) &&
  96                !intel_huc_is_authenticated(huc, INTEL_HUC_AUTH_BY_GSC);
  97 }
  98
  99 void intel_huc_load_status(struct intel_huc *huc, struct drm_printer *p);
 100
 101 #endif