drivers/gpu/drm/i915/gt/intel_engine_user.c

   1 /*
   2  * SPDX-License-Identifier: MIT
   3  *
   4  * Copyright © 2019 Intel Corporation
   5  */
   6
   7 #include <linux/list.h>
   8 #include <linux/list_sort.h>
   9 #include <linux/llist.h>
  10
  11 #include "i915_drv.h"
  12 #include "intel_engine.h"
  13 #include "intel_engine_user.h"
  14
  15 struct intel_engine_cs *
  16 intel_engine_lookup_user(struct drm_i915_private *i915, u8 class, u8 instance)
  17 {
  18         struct rb_node *p = i915->uabi_engines.rb_node;
  19
  20         while (p) {
  21                 struct intel_engine_cs *it =
  22                         rb_entry(p, typeof(*it), uabi_node);
  23
  24                 if (class < it->uabi_class)
  25                         p = p->rb_left;
  26                 else if (class > it->uabi_class ||
  27                          instance > it->uabi_instance)
  28                         p = p->rb_right;
  29                 else if (instance < it->uabi_instance)
  30                         p = p->rb_left;
  31                 else
  32                         return it;
  33         }
  34
  35         return NULL;
  36 }
  37
  38 void intel_engine_add_user(struct intel_engine_cs *engine)
  39 {
  40         llist_add((struct llist_node *)&engine->uabi_node,
  41                   (struct llist_head *)&engine->i915->uabi_engines);
  42 }
  43
  44 static const u8 uabi_classes[] = {
  45         [RENDER_CLASS] = I915_ENGINE_CLASS_RENDER,
  46         [COPY_ENGINE_CLASS] = I915_ENGINE_CLASS_COPY,
  47         [VIDEO_DECODE_CLASS] = I915_ENGINE_CLASS_VIDEO,
  48         [VIDEO_ENHANCEMENT_CLASS] = I915_ENGINE_CLASS_VIDEO_ENHANCE,
  49 };
  50
  51 static int engine_cmp(void *priv, struct list_head *A, struct list_head *B)
  52 {
  53         const struct intel_engine_cs *a =
  54                 container_of((struct rb_node *)A, typeof(*a), uabi_node);
  55         const struct intel_engine_cs *b =
  56                 container_of((struct rb_node *)B, typeof(*b), uabi_node);
  57
  58         if (uabi_classes[a->class] < uabi_classes[b->class])
  59                 return -1;
  60         if (uabi_classes[a->class] > uabi_classes[b->class])
  61                 return 1;
  62
  63         if (a->instance < b->instance)
  64                 return -1;
  65         if (a->instance > b->instance)
  66                 return 1;
  67
  68         return 0;
  69 }
  70
  71 static struct llist_node *get_engines(struct drm_i915_private *i915)
  72 {
  73         return llist_del_all((struct llist_head *)&i915->uabi_engines);
  74 }
  75
  76 static void sort_engines(struct drm_i915_private *i915,
  77                          struct list_head *engines)
  78 {
  79         struct llist_node *pos, *next;
  80
  81         llist_for_each_safe(pos, next, get_engines(i915)) {
  82                 struct intel_engine_cs *engine =
  83                         container_of((struct rb_node *)pos, typeof(*engine),
  84                                      uabi_node);
  85                 list_add((struct list_head *)&engine->uabi_node, engines);
  86         }
  87         list_sort(NULL, engines, engine_cmp);
  88 }
  89
  90 static void set_scheduler_caps(struct drm_i915_private *i915)
  91 {
  92         static const struct {
  93                 u8 engine;
  94                 u8 sched;
  95         } map[] = {
  96 #define MAP(x, y) { ilog2(I915_ENGINE_##x), ilog2(I915_SCHEDULER_CAP_##y) }
  97                 MAP(HAS_PREEMPTION, PREEMPTION),
  98                 MAP(HAS_SEMAPHORES, SEMAPHORES),
  99                 MAP(SUPPORTS_STATS, ENGINE_BUSY_STATS),
 100 #undef MAP
 101         };
 102         struct intel_engine_cs *engine;
 103         u32 enabled, disabled;
 104
 105         enabled = 0;
 106         disabled = 0;
 107         for_each_uabi_engine(engine, i915) { /* all engines must agree! */
 108                 int i;
 109
 110                 if (engine->schedule)
 111                         enabled |= (I915_SCHEDULER_CAP_ENABLED |
 112                                     I915_SCHEDULER_CAP_PRIORITY);
 113                 else
 114                         disabled |= (I915_SCHEDULER_CAP_ENABLED |
 115                                      I915_SCHEDULER_CAP_PRIORITY);
 116
 117                 for (i = 0; i < ARRAY_SIZE(map); i++) {
 118                         if (engine->flags & BIT(map[i].engine))
 119                                 enabled |= BIT(map[i].sched);
 120                         else
 121                                 disabled |= BIT(map[i].sched);
 122                 }
 123         }
 124
 125         i915->caps.scheduler = enabled & ~disabled;
 126         if (!(i915->caps.scheduler & I915_SCHEDULER_CAP_ENABLED))
 127                 i915->caps.scheduler = 0;
 128 }
 129
 130 const char *intel_engine_class_repr(u8 class)
 131 {
 132         static const char * const uabi_names[] = {
 133                 [RENDER_CLASS] = "rcs",
 134                 [COPY_ENGINE_CLASS] = "bcs",
 135                 [VIDEO_DECODE_CLASS] = "vcs",
 136                 [VIDEO_ENHANCEMENT_CLASS] = "vecs",
 137         };
 138
 139         if (class >= ARRAY_SIZE(uabi_names) || !uabi_names[class])
 140                 return "xxx";
 141
 142         return uabi_names[class];
 143 }
 144
 145 struct legacy_ring {
 146         struct intel_gt *gt;
 147         u8 class;
 148         u8 instance;
 149 };
 150
 151 static int legacy_ring_idx(const struct legacy_ring *ring)
 152 {
 153         static const struct {
 154                 u8 base, max;
 155         } map[] = {
 156                 [RENDER_CLASS] = { RCS0, 1 },
 157                 [COPY_ENGINE_CLASS] = { BCS0, 1 },
 158                 [VIDEO_DECODE_CLASS] = { VCS0, I915_MAX_VCS },
 159                 [VIDEO_ENHANCEMENT_CLASS] = { VECS0, I915_MAX_VECS },
 160         };
 161
 162         if (GEM_DEBUG_WARN_ON(ring->class >= ARRAY_SIZE(map)))
 163                 return INVALID_ENGINE;
 164
 165         if (GEM_DEBUG_WARN_ON(ring->instance >= map[ring->class].max))
 166                 return INVALID_ENGINE;
 167
 168         return map[ring->class].base + ring->instance;
 169 }
 170
 171 static void add_legacy_ring(struct legacy_ring *ring,
 172                             struct intel_engine_cs *engine)
 173 {
 174         if (engine->gt != ring->gt || engine->class != ring->class) {
 175                 ring->gt = engine->gt;
 176                 ring->class = engine->class;
 177                 ring->instance = 0;
 178         }
 179
 180         engine->legacy_idx = legacy_ring_idx(ring);
 181         if (engine->legacy_idx != INVALID_ENGINE)
 182                 ring->instance++;
 183 }
 184
 185 void intel_engines_driver_register(struct drm_i915_private *i915)
 186 {
 187         struct legacy_ring ring = {};
 188         u8 uabi_instances[4] = {};
 189         struct list_head *it, *next;
 190         struct rb_node **p, *prev;
 191         LIST_HEAD(engines);
 192
 193         sort_engines(i915, &engines);
 194
 195         prev = NULL;
 196         p = &i915->uabi_engines.rb_node;
 197         list_for_each_safe(it, next, &engines) {
 198                 struct intel_engine_cs *engine =
 199                         container_of((struct rb_node *)it, typeof(*engine),
 200                                      uabi_node);
 201                 char old[sizeof(engine->name)];
 202
 203                 GEM_BUG_ON(engine->class >= ARRAY_SIZE(uabi_classes));
 204                 engine->uabi_class = uabi_classes[engine->class];
 205
 206                 GEM_BUG_ON(engine->uabi_class >= ARRAY_SIZE(uabi_instances));
 207                 engine->uabi_instance = uabi_instances[engine->uabi_class]++;
 208
 209                 /* Replace the internal name with the final user facing name */
 210                 memcpy(old, engine->name, sizeof(engine->name));
 211                 scnprintf(engine->name, sizeof(engine->name), "%s%u",
 212                           intel_engine_class_repr(engine->class),
 213                           engine->uabi_instance);
 214                 DRM_DEBUG_DRIVER("renamed %s to %s\n", old, engine->name);
 215
 216                 rb_link_node(&engine->uabi_node, prev, p);
 217                 rb_insert_color(&engine->uabi_node, &i915->uabi_engines);
 218
 219                 GEM_BUG_ON(intel_engine_lookup_user(i915,
 220                                                     engine->uabi_class,
 221                                                     engine->uabi_instance) != engine);
 222
 223                 /* Fix up the mapping to match default execbuf::user_map[] */
 224                 add_legacy_ring(&ring, engine);
 225
 226                 prev = &engine->uabi_node;
 227                 p = &prev->rb_right;
 228         }
 229
 230         if (IS_ENABLED(CONFIG_DRM_I915_SELFTESTS) &&
 231             IS_ENABLED(CONFIG_DRM_I915_DEBUG_GEM)) {
 232                 struct intel_engine_cs *engine;
 233                 unsigned int isolation;
 234                 int class, inst;
 235                 int errors = 0;
 236
 237                 for (class = 0; class < ARRAY_SIZE(uabi_instances); class++) {
 238                         for (inst = 0; inst < uabi_instances[class]; inst++) {
 239                                 engine = intel_engine_lookup_user(i915,
 240                                                                   class, inst);
 241                                 if (!engine) {
 242                                         pr_err("UABI engine not found for { class:%d, instance:%d }\n",
 243                                                class, inst);
 244                                         errors++;
 245                                         continue;
 246                                 }
 247
 248                                 if (engine->uabi_class != class ||
 249                                     engine->uabi_instance != inst) {
 250                                         pr_err("Wrong UABI engine:%s { class:%d, instance:%d } found for { class:%d, instance:%d }\n",
 251                                                engine->name,
 252                                                engine->uabi_class,
 253                                                engine->uabi_instance,
 254                                                class, inst);
 255                                         errors++;
 256                                         continue;
 257                                 }
 258                         }
 259                 }
 260
 261                 /*
 262                  * Make sure that classes with multiple engine instances all
 263                  * share the same basic configuration.
 264                  */
 265                 isolation = intel_engines_has_context_isolation(i915);
 266                 for_each_uabi_engine(engine, i915) {
 267                         unsigned int bit = BIT(engine->uabi_class);
 268                         unsigned int expected = engine->default_state ? bit : 0;
 269
 270                         if ((isolation & bit) != expected) {
 271                                 pr_err("mismatching default context state for class %d on engine %s\n",
 272                                        engine->uabi_class, engine->name);
 273                                 errors++;
 274                         }
 275                 }
 276
 277                 if (WARN(errors, "Invalid UABI engine mapping found"))
 278                         i915->uabi_engines = RB_ROOT;
 279         }
 280
 281         set_scheduler_caps(i915);
 282 }
 283
 284 unsigned int intel_engines_has_context_isolation(struct drm_i915_private *i915)
 285 {
 286         struct intel_engine_cs *engine;
 287         unsigned int which;
 288
 289         which = 0;
 290         for_each_uabi_engine(engine, i915)
 291                 if (engine->default_state)
 292                         which |= BIT(engine->uabi_class);
 293
 294         return which;
 295 }