drivers/accel/ivpu/ivpu_drv.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Copyright (C) 2020-2024 Intel Corporation
   4  */
   5
   6 #ifndef __IVPU_DRV_H__
   7 #define __IVPU_DRV_H__
   8
   9 #include <drm/drm_device.h>
  10 #include <drm/drm_drv.h>
  11 #include <drm/drm_managed.h>
  12 #include <drm/drm_mm.h>
  13 #include <drm/drm_print.h>
  14
  15 #include <linux/pci.h>
  16 #include <linux/xarray.h>
  17 #include <uapi/drm/ivpu_accel.h>
  18
  19 #include "ivpu_mmu_context.h"
  20 #include "ivpu_ipc.h"
  21
  22 #define DRIVER_NAME "intel_vpu"
  23 #define DRIVER_DESC "Driver for Intel NPU (Neural Processing Unit)"
  24 #define DRIVER_DATE "20230117"
  25
  26 #define PCI_DEVICE_ID_MTL   0x7d1d
  27 #define PCI_DEVICE_ID_ARL   0xad1d
  28 #define PCI_DEVICE_ID_LNL   0x643e
  29
  30 #define IVPU_HW_IP_37XX 37
  31 #define IVPU_HW_IP_40XX 40
  32 #define IVPU_HW_IP_50XX 50
  33 #define IVPU_HW_IP_60XX 60
  34
  35 #define IVPU_HW_IP_REV_LNL_B0 4
  36
  37 #define IVPU_HW_BTRS_MTL 1
  38 #define IVPU_HW_BTRS_LNL 2
  39
  40 #define IVPU_GLOBAL_CONTEXT_MMU_SSID   0
  41 /* SSID 1 is used by the VPU to represent reserved context */
  42 #define IVPU_RESERVED_CONTEXT_MMU_SSID 1
  43 #define IVPU_USER_CONTEXT_MIN_SSID     2
  44 #define IVPU_USER_CONTEXT_MAX_SSID     (IVPU_USER_CONTEXT_MIN_SSID + 63)
  45
  46 #define IVPU_MIN_DB 1
  47 #define IVPU_MAX_DB 255
  48
  49 #define IVPU_NUM_ENGINES       2
  50 #define IVPU_NUM_PRIORITIES    4
  51 #define IVPU_NUM_CMDQS_PER_CTX (IVPU_NUM_ENGINES * IVPU_NUM_PRIORITIES)
  52
  53 #define IVPU_CMDQ_INDEX(engine, priority) ((engine) * IVPU_NUM_PRIORITIES + (priority))
  54
  55 #define IVPU_PLATFORM_SILICON 0
  56 #define IVPU_PLATFORM_SIMICS  2
  57 #define IVPU_PLATFORM_FPGA    3
  58 #define IVPU_PLATFORM_INVALID 8
  59
  60 #define IVPU_DBG_REG     BIT(0)
  61 #define IVPU_DBG_IRQ     BIT(1)
  62 #define IVPU_DBG_MMU     BIT(2)
  63 #define IVPU_DBG_FILE    BIT(3)
  64 #define IVPU_DBG_MISC    BIT(4)
  65 #define IVPU_DBG_FW_BOOT BIT(5)
  66 #define IVPU_DBG_PM      BIT(6)
  67 #define IVPU_DBG_IPC     BIT(7)
  68 #define IVPU_DBG_BO      BIT(8)
  69 #define IVPU_DBG_JOB     BIT(9)
  70 #define IVPU_DBG_JSM     BIT(10)
  71 #define IVPU_DBG_KREF    BIT(11)
  72 #define IVPU_DBG_RPM     BIT(12)
  73 #define IVPU_DBG_MMU_MAP BIT(13)
  74
  75 #define ivpu_err(vdev, fmt, ...) \
  76         drm_err(&(vdev)->drm, "%s(): " fmt, __func__, ##__VA_ARGS__)
  77
  78 #define ivpu_err_ratelimited(vdev, fmt, ...) \
  79         drm_err_ratelimited(&(vdev)->drm, "%s(): " fmt, __func__, ##__VA_ARGS__)
  80
  81 #define ivpu_warn(vdev, fmt, ...) \
  82         drm_warn(&(vdev)->drm, "%s(): " fmt, __func__, ##__VA_ARGS__)
  83
  84 #define ivpu_warn_ratelimited(vdev, fmt, ...) \
  85         drm_err_ratelimited(&(vdev)->drm, "%s(): " fmt, __func__, ##__VA_ARGS__)
  86
  87 #define ivpu_info(vdev, fmt, ...) drm_info(&(vdev)->drm, fmt, ##__VA_ARGS__)
  88
  89 #define ivpu_dbg(vdev, type, fmt, args...) do {                                \
  90         if (unlikely(IVPU_DBG_##type & ivpu_dbg_mask))                         \
  91                 dev_dbg((vdev)->drm.dev, "[%s] " fmt, #type, ##args);          \
  92 } while (0)
  93
  94 #define IVPU_WA(wa_name) (vdev->wa.wa_name)
  95
  96 #define IVPU_PRINT_WA(wa_name) do {                                     \
  97         if (IVPU_WA(wa_name))                                           \
  98                 ivpu_dbg(vdev, MISC, "Using WA: " #wa_name "\n");       \
  99 } while (0)
 100
 101 struct ivpu_wa_table {
 102         bool punit_disabled;
 103         bool clear_runtime_mem;
 104         bool interrupt_clear_with_0;
 105         bool disable_clock_relinquish;
 106         bool disable_d0i3_msg;
 107         bool wp0_during_power_up;
 108 };
 109
 110 struct ivpu_hw_info;
 111 struct ivpu_mmu_info;
 112 struct ivpu_fw_info;
 113 struct ivpu_ipc_info;
 114 struct ivpu_pm_info;
 115
 116 struct ivpu_device {
 117         struct drm_device drm;
 118         void __iomem *regb;
 119         void __iomem *regv;
 120         u32 platform;
 121         u32 irq;
 122
 123         struct ivpu_wa_table wa;
 124         struct ivpu_hw_info *hw;
 125         struct ivpu_mmu_info *mmu;
 126         struct ivpu_fw_info *fw;
 127         struct ivpu_ipc_info *ipc;
 128         struct ivpu_pm_info *pm;
 129
 130         struct ivpu_mmu_context gctx;
 131         struct ivpu_mmu_context rctx;
 132         struct mutex context_list_lock; /* Protects user context addition/removal */
 133         struct xarray context_xa;
 134         struct xa_limit context_xa_limit;
 135
 136         struct xarray db_xa;
 137
 138         struct mutex bo_list_lock; /* Protects bo_list */
 139         struct list_head bo_list;
 140
 141         struct xarray submitted_jobs_xa;
 142         struct ivpu_ipc_consumer job_done_consumer;
 143
 144         atomic64_t unique_id_counter;
 145
 146         ktime_t busy_start_ts;
 147         ktime_t busy_time;
 148
 149         struct {
 150                 int boot;
 151                 int jsm;
 152                 int tdr;
 153                 int autosuspend;
 154                 int d0i3_entry_msg;
 155         } timeout;
 156 };
 157
 158 /*
 159  * file_priv has its own refcount (ref) that allows user space to close the fd
 160  * without blocking even if VPU is still processing some jobs.
 161  */
 162 struct ivpu_file_priv {
 163         struct kref ref;
 164         struct ivpu_device *vdev;
 165         struct mutex lock; /* Protects cmdq */
 166         struct ivpu_cmdq *cmdq[IVPU_NUM_CMDQS_PER_CTX];
 167         struct ivpu_mmu_context ctx;
 168         struct mutex ms_lock; /* Protects ms_instance_list, ms_info_bo */
 169         struct list_head ms_instance_list;
 170         struct ivpu_bo *ms_info_bo;
 171         bool has_mmu_faults;
 172         bool bound;
 173         bool aborted;
 174 };
 175
 176 extern int ivpu_dbg_mask;
 177 extern u8 ivpu_pll_min_ratio;
 178 extern u8 ivpu_pll_max_ratio;
 179 extern int ivpu_sched_mode;
 180 extern bool ivpu_disable_mmu_cont_pages;
 181 extern bool ivpu_force_snoop;
 182
 183 #define IVPU_TEST_MODE_FW_TEST            BIT(0)
 184 #define IVPU_TEST_MODE_NULL_HW            BIT(1)
 185 #define IVPU_TEST_MODE_NULL_SUBMISSION    BIT(2)
 186 #define IVPU_TEST_MODE_D0I3_MSG_DISABLE   BIT(4)
 187 #define IVPU_TEST_MODE_D0I3_MSG_ENABLE    BIT(5)
 188 #define IVPU_TEST_MODE_PREEMPTION_DISABLE BIT(6)
 189 #define IVPU_TEST_MODE_HWS_EXTRA_EVENTS   BIT(7)
 190 #define IVPU_TEST_MODE_DISABLE_TIMEOUTS   BIT(8)
 191 extern int ivpu_test_mode;
 192
 193 struct ivpu_file_priv *ivpu_file_priv_get(struct ivpu_file_priv *file_priv);
 194 void ivpu_file_priv_put(struct ivpu_file_priv **link);
 195
 196 int ivpu_boot(struct ivpu_device *vdev);
 197 int ivpu_shutdown(struct ivpu_device *vdev);
 198 void ivpu_prepare_for_reset(struct ivpu_device *vdev);
 199
 200 static inline u8 ivpu_revision(struct ivpu_device *vdev)
 201 {
 202         return to_pci_dev(vdev->drm.dev)->revision;
 203 }
 204
 205 static inline u16 ivpu_device_id(struct ivpu_device *vdev)
 206 {
 207         return to_pci_dev(vdev->drm.dev)->device;
 208 }
 209
 210 static inline int ivpu_hw_ip_gen(struct ivpu_device *vdev)
 211 {
 212         switch (ivpu_device_id(vdev)) {
 213         case PCI_DEVICE_ID_MTL:
 214         case PCI_DEVICE_ID_ARL:
 215                 return IVPU_HW_IP_37XX;
 216         case PCI_DEVICE_ID_LNL:
 217                 return IVPU_HW_IP_40XX;
 218         default:
 219                 dump_stack();
 220                 ivpu_err(vdev, "Unknown NPU IP generation\n");
 221                 return 0;
 222         }
 223 }
 224
 225 static inline int ivpu_hw_btrs_gen(struct ivpu_device *vdev)
 226 {
 227         switch (ivpu_device_id(vdev)) {
 228         case PCI_DEVICE_ID_MTL:
 229         case PCI_DEVICE_ID_ARL:
 230                 return IVPU_HW_BTRS_MTL;
 231         case PCI_DEVICE_ID_LNL:
 232                 return IVPU_HW_BTRS_LNL;
 233         default:
 234                 dump_stack();
 235                 ivpu_err(vdev, "Unknown buttress generation\n");
 236                 return 0;
 237         }
 238 }
 239
 240 static inline struct ivpu_device *to_ivpu_device(struct drm_device *dev)
 241 {
 242         return container_of(dev, struct ivpu_device, drm);
 243 }
 244
 245 static inline u32 ivpu_get_context_count(struct ivpu_device *vdev)
 246 {
 247         struct xa_limit ctx_limit = vdev->context_xa_limit;
 248
 249         return (ctx_limit.max - ctx_limit.min + 1);
 250 }
 251
 252 static inline u32 ivpu_get_platform(struct ivpu_device *vdev)
 253 {
 254         WARN_ON_ONCE(vdev->platform == IVPU_PLATFORM_INVALID);
 255         return vdev->platform;
 256 }
 257
 258 static inline bool ivpu_is_silicon(struct ivpu_device *vdev)
 259 {
 260         return ivpu_get_platform(vdev) == IVPU_PLATFORM_SILICON;
 261 }
 262
 263 static inline bool ivpu_is_simics(struct ivpu_device *vdev)
 264 {
 265         return ivpu_get_platform(vdev) == IVPU_PLATFORM_SIMICS;
 266 }
 267
 268 static inline bool ivpu_is_fpga(struct ivpu_device *vdev)
 269 {
 270         return ivpu_get_platform(vdev) == IVPU_PLATFORM_FPGA;
 271 }
 272
 273 static inline bool ivpu_is_force_snoop_enabled(struct ivpu_device *vdev)
 274 {
 275         return ivpu_force_snoop;
 276 }
 277
 278 #endif /* __IVPU_DRV_H__ */