2 * Copyright 2014 The Chromium OS Authors. All rights reserved.
3 * Use of this source code is governed by a BSD-style license that can be
4 * found in the LICENSE file.
20 #define I915_CACHELINE_SIZE 64
21 #define I915_CACHELINE_MASK (I915_CACHELINE_SIZE - 1)
23 static const uint32_t render_target_formats[] = { DRM_FORMAT_ABGR8888, DRM_FORMAT_ARGB1555,
24 DRM_FORMAT_ARGB8888, DRM_FORMAT_RGB565,
25 DRM_FORMAT_XBGR2101010, DRM_FORMAT_XBGR8888,
26 DRM_FORMAT_XRGB1555, DRM_FORMAT_XRGB2101010,
27 DRM_FORMAT_XRGB8888 };
29 static const uint32_t tileable_texture_source_formats[] = { DRM_FORMAT_GR88, DRM_FORMAT_R8,
30 DRM_FORMAT_UYVY, DRM_FORMAT_YUYV };
32 static const uint32_t texture_source_formats[] = { DRM_FORMAT_YVU420, DRM_FORMAT_YVU420_ANDROID,
40 static uint32_t i915_get_gen(int device_id)
42 const uint16_t gen3_ids[] = { 0x2582, 0x2592, 0x2772, 0x27A2, 0x27AE,
43 0x29C2, 0x29B2, 0x29D2, 0xA001, 0xA011 };
45 for (i = 0; i < ARRAY_SIZE(gen3_ids); i++)
46 if (gen3_ids[i] == device_id)
52 static int i915_add_kms_item(struct driver *drv, const struct kms_item *item)
55 struct combination *combo;
58 * Older hardware can't scanout Y-tiled formats. Newer devices can, and
59 * report this functionality via format modifiers.
61 for (i = 0; i < drv_array_size(drv->combos); i++) {
62 combo = (struct combination *)drv_array_at_idx(drv->combos, i);
63 if (combo->format != item->format)
66 if (item->modifier == DRM_FORMAT_MOD_LINEAR &&
67 combo->metadata.tiling == I915_TILING_X) {
69 * FIXME: drv_query_kms() does not report the available modifiers
70 * yet, but we know that all hardware can scanout from X-tiled
71 * buffers, so let's add this to our combinations, except for
72 * cursor, which must not be tiled.
74 combo->use_flags |= item->use_flags & ~BO_USE_CURSOR;
77 if (combo->metadata.modifier == item->modifier)
78 combo->use_flags |= item->use_flags;
84 static int i915_add_combinations(struct driver *drv)
88 struct drv_array *kms_items;
89 struct format_metadata metadata;
90 uint64_t render_use_flags, texture_use_flags;
92 render_use_flags = BO_USE_RENDER_MASK;
93 texture_use_flags = BO_USE_TEXTURE_MASK;
95 metadata.tiling = I915_TILING_NONE;
96 metadata.priority = 1;
97 metadata.modifier = DRM_FORMAT_MOD_LINEAR;
99 drv_add_combinations(drv, render_target_formats, ARRAY_SIZE(render_target_formats),
100 &metadata, render_use_flags);
102 drv_add_combinations(drv, texture_source_formats, ARRAY_SIZE(texture_source_formats),
103 &metadata, texture_use_flags);
105 drv_add_combinations(drv, tileable_texture_source_formats,
106 ARRAY_SIZE(tileable_texture_source_formats), &metadata,
109 drv_modify_combination(drv, DRM_FORMAT_XRGB8888, &metadata, BO_USE_CURSOR | BO_USE_SCANOUT);
110 drv_modify_combination(drv, DRM_FORMAT_ARGB8888, &metadata, BO_USE_CURSOR | BO_USE_SCANOUT);
112 /* IPU3 camera ISP supports only NV12 output. */
113 drv_modify_combination(drv, DRM_FORMAT_NV12, &metadata,
114 BO_USE_CAMERA_READ | BO_USE_CAMERA_WRITE);
116 * R8 format is used for Android's HAL_PIXEL_FORMAT_BLOB and is used for JPEG snapshots
119 drv_modify_combination(drv, DRM_FORMAT_R8, &metadata,
120 BO_USE_CAMERA_READ | BO_USE_CAMERA_WRITE);
122 render_use_flags &= ~BO_USE_RENDERSCRIPT;
123 render_use_flags &= ~BO_USE_SW_WRITE_OFTEN;
124 render_use_flags &= ~BO_USE_SW_READ_OFTEN;
125 render_use_flags &= ~BO_USE_LINEAR;
127 texture_use_flags &= ~BO_USE_RENDERSCRIPT;
128 texture_use_flags &= ~BO_USE_SW_WRITE_OFTEN;
129 texture_use_flags &= ~BO_USE_SW_READ_OFTEN;
130 texture_use_flags &= ~BO_USE_LINEAR;
132 metadata.tiling = I915_TILING_X;
133 metadata.priority = 2;
134 metadata.modifier = I915_FORMAT_MOD_X_TILED;
136 drv_add_combinations(drv, render_target_formats, ARRAY_SIZE(render_target_formats),
137 &metadata, render_use_flags);
139 drv_add_combinations(drv, tileable_texture_source_formats,
140 ARRAY_SIZE(tileable_texture_source_formats), &metadata,
143 metadata.tiling = I915_TILING_Y;
144 metadata.priority = 3;
145 metadata.modifier = I915_FORMAT_MOD_Y_TILED;
147 drv_add_combinations(drv, render_target_formats, ARRAY_SIZE(render_target_formats),
148 &metadata, render_use_flags);
150 drv_add_combinations(drv, tileable_texture_source_formats,
151 ARRAY_SIZE(tileable_texture_source_formats), &metadata,
154 kms_items = drv_query_kms(drv);
158 for (i = 0; i < drv_array_size(kms_items); i++) {
159 ret = i915_add_kms_item(drv, (struct kms_item *)drv_array_at_idx(kms_items, i));
161 drv_array_destroy(kms_items);
166 drv_array_destroy(kms_items);
170 static int i915_align_dimensions(struct bo *bo, uint32_t tiling, uint32_t *stride,
171 uint32_t *aligned_height)
173 struct i915_device *i915 = bo->drv->priv;
174 uint32_t horizontal_alignment = 4;
175 uint32_t vertical_alignment = 4;
179 case I915_TILING_NONE:
180 horizontal_alignment = 64;
184 horizontal_alignment = 512;
185 vertical_alignment = 8;
189 if (i915->gen == 3) {
190 horizontal_alignment = 512;
191 vertical_alignment = 8;
193 horizontal_alignment = 128;
194 vertical_alignment = 32;
200 * The alignment calculated above is based on the full size luma plane and to have chroma
201 * planes properly aligned with subsampled formats, we need to multiply luma alignment by
202 * subsampling factor.
204 switch (bo->format) {
205 case DRM_FORMAT_YVU420_ANDROID:
206 case DRM_FORMAT_YVU420:
207 horizontal_alignment *= 2;
209 case DRM_FORMAT_NV12:
210 vertical_alignment *= 2;
214 *aligned_height = ALIGN(bo->height, vertical_alignment);
216 *stride = ALIGN(*stride, horizontal_alignment);
218 while (*stride > horizontal_alignment)
219 horizontal_alignment <<= 1;
221 *stride = horizontal_alignment;
224 if (i915->gen <= 3 && *stride > 8192)
230 static void i915_clflush(void *start, size_t size)
232 void *p = (void *)(((uintptr_t)start) & ~I915_CACHELINE_MASK);
233 void *end = (void *)((uintptr_t)start + size);
235 __builtin_ia32_mfence();
237 __builtin_ia32_clflush(p);
238 p = (void *)((uintptr_t)p + I915_CACHELINE_SIZE);
242 static int i915_init(struct driver *drv)
246 struct i915_device *i915;
247 drm_i915_getparam_t get_param;
249 i915 = calloc(1, sizeof(*i915));
253 memset(&get_param, 0, sizeof(get_param));
254 get_param.param = I915_PARAM_CHIPSET_ID;
255 get_param.value = &device_id;
256 ret = drmIoctl(drv->fd, DRM_IOCTL_I915_GETPARAM, &get_param);
258 fprintf(stderr, "drv: Failed to get I915_PARAM_CHIPSET_ID\n");
263 i915->gen = i915_get_gen(device_id);
265 memset(&get_param, 0, sizeof(get_param));
266 get_param.param = I915_PARAM_HAS_LLC;
267 get_param.value = &i915->has_llc;
268 ret = drmIoctl(drv->fd, DRM_IOCTL_I915_GETPARAM, &get_param);
270 fprintf(stderr, "drv: Failed to get I915_PARAM_HAS_LLC\n");
277 return i915_add_combinations(drv);
280 static int i915_bo_create_for_modifier(struct bo *bo, uint32_t width, uint32_t height,
281 uint32_t format, uint64_t modifier)
286 struct drm_i915_gem_create gem_create;
287 struct drm_i915_gem_set_tiling gem_set_tiling;
290 case DRM_FORMAT_MOD_LINEAR:
291 bo->tiling = I915_TILING_NONE;
293 case I915_FORMAT_MOD_X_TILED:
294 bo->tiling = I915_TILING_X;
296 case I915_FORMAT_MOD_Y_TILED:
297 bo->tiling = I915_TILING_Y;
301 bo->format_modifiers[0] = modifier;
303 stride = drv_stride_from_format(format, width, 0);
305 ret = i915_align_dimensions(bo, bo->tiling, &stride, &height);
310 * HAL_PIXEL_FORMAT_YV12 requires the buffer height not be aligned, but we need to keep
311 * total size as with aligned height to ensure enough padding space after each plane to
312 * satisfy GPU alignment requirements.
314 * We do it by first calling drv_bo_from_format() with aligned height and
315 * DRM_FORMAT_YVU420, which allows height alignment, saving the total size it calculates
316 * and then calling it again with requested parameters.
318 * This relies on the fact that i965 driver uses separate surfaces for each plane and
319 * contents of padding bytes is not affected, as it is only used to satisfy GPU cache
322 * This is enforced by Mesa in src/intel/isl/isl_gen8.c, inside
323 * isl_gen8_choose_image_alignment_el(), which is used for GEN9 and GEN8.
325 if (format == DRM_FORMAT_YVU420_ANDROID) {
326 uint32_t unaligned_height = bo->height;
329 drv_bo_from_format(bo, stride, height, DRM_FORMAT_YVU420);
330 total_size = bo->total_size;
331 drv_bo_from_format(bo, stride, unaligned_height, format);
332 bo->total_size = total_size;
334 drv_bo_from_format(bo, stride, height, format);
338 * Quoting Mesa ISL library:
340 * - For linear surfaces, additional padding of 64 bytes is required at
341 * the bottom of the surface. This is in addition to the padding
344 if (bo->tiling == I915_TILING_NONE)
345 bo->total_size += 64;
347 memset(&gem_create, 0, sizeof(gem_create));
348 gem_create.size = bo->total_size;
350 ret = drmIoctl(bo->drv->fd, DRM_IOCTL_I915_GEM_CREATE, &gem_create);
352 fprintf(stderr, "drv: DRM_IOCTL_I915_GEM_CREATE failed (size=%llu)\n",
357 for (plane = 0; plane < bo->num_planes; plane++)
358 bo->handles[plane].u32 = gem_create.handle;
360 memset(&gem_set_tiling, 0, sizeof(gem_set_tiling));
361 gem_set_tiling.handle = bo->handles[0].u32;
362 gem_set_tiling.tiling_mode = bo->tiling;
363 gem_set_tiling.stride = bo->strides[0];
365 ret = drmIoctl(bo->drv->fd, DRM_IOCTL_I915_GEM_SET_TILING, &gem_set_tiling);
367 struct drm_gem_close gem_close;
368 memset(&gem_close, 0, sizeof(gem_close));
369 gem_close.handle = bo->handles[0].u32;
370 drmIoctl(bo->drv->fd, DRM_IOCTL_GEM_CLOSE, &gem_close);
372 fprintf(stderr, "drv: DRM_IOCTL_I915_GEM_SET_TILING failed with %d", errno);
379 static int i915_bo_create(struct bo *bo, uint32_t width, uint32_t height, uint32_t format,
382 struct combination *combo;
384 combo = drv_get_combination(bo->drv, format, use_flags);
388 return i915_bo_create_for_modifier(bo, width, height, format, combo->metadata.modifier);
391 static int i915_bo_create_with_modifiers(struct bo *bo, uint32_t width, uint32_t height,
392 uint32_t format, const uint64_t *modifiers, uint32_t count)
394 static const uint64_t modifier_order[] = {
395 I915_FORMAT_MOD_Y_TILED,
396 I915_FORMAT_MOD_X_TILED,
397 DRM_FORMAT_MOD_LINEAR,
401 modifier = drv_pick_modifier(modifiers, count, modifier_order, ARRAY_SIZE(modifier_order));
403 return i915_bo_create_for_modifier(bo, width, height, format, modifier);
406 static void i915_close(struct driver *drv)
412 static int i915_bo_import(struct bo *bo, struct drv_import_fd_data *data)
415 struct drm_i915_gem_get_tiling gem_get_tiling;
417 ret = drv_prime_bo_import(bo, data);
421 /* TODO(gsingh): export modifiers and get rid of backdoor tiling. */
422 memset(&gem_get_tiling, 0, sizeof(gem_get_tiling));
423 gem_get_tiling.handle = bo->handles[0].u32;
425 ret = drmIoctl(bo->drv->fd, DRM_IOCTL_I915_GEM_GET_TILING, &gem_get_tiling);
427 drv_gem_bo_destroy(bo);
428 fprintf(stderr, "drv: DRM_IOCTL_I915_GEM_GET_TILING failed.");
432 bo->tiling = gem_get_tiling.tiling_mode;
436 static void *i915_bo_map(struct bo *bo, struct vma *vma, size_t plane, uint32_t map_flags)
441 if (bo->tiling == I915_TILING_NONE) {
442 struct drm_i915_gem_mmap gem_map;
443 memset(&gem_map, 0, sizeof(gem_map));
445 if ((bo->use_flags & BO_USE_SCANOUT) && !(bo->use_flags & BO_USE_RENDERSCRIPT))
446 gem_map.flags = I915_MMAP_WC;
448 gem_map.handle = bo->handles[0].u32;
450 gem_map.size = bo->total_size;
452 ret = drmIoctl(bo->drv->fd, DRM_IOCTL_I915_GEM_MMAP, &gem_map);
454 fprintf(stderr, "drv: DRM_IOCTL_I915_GEM_MMAP failed\n");
458 addr = (void *)(uintptr_t)gem_map.addr_ptr;
460 struct drm_i915_gem_mmap_gtt gem_map;
461 memset(&gem_map, 0, sizeof(gem_map));
463 gem_map.handle = bo->handles[0].u32;
465 ret = drmIoctl(bo->drv->fd, DRM_IOCTL_I915_GEM_MMAP_GTT, &gem_map);
467 fprintf(stderr, "drv: DRM_IOCTL_I915_GEM_MMAP_GTT failed\n");
471 addr = mmap(0, bo->total_size, drv_get_prot(map_flags), MAP_SHARED, bo->drv->fd,
475 if (addr == MAP_FAILED) {
476 fprintf(stderr, "drv: i915 GEM mmap failed\n");
480 vma->length = bo->total_size;
484 static int i915_bo_invalidate(struct bo *bo, struct mapping *mapping)
487 struct drm_i915_gem_set_domain set_domain;
489 memset(&set_domain, 0, sizeof(set_domain));
490 set_domain.handle = bo->handles[0].u32;
491 if (bo->tiling == I915_TILING_NONE) {
492 set_domain.read_domains = I915_GEM_DOMAIN_CPU;
493 if (mapping->vma->map_flags & BO_MAP_WRITE)
494 set_domain.write_domain = I915_GEM_DOMAIN_CPU;
496 set_domain.read_domains = I915_GEM_DOMAIN_GTT;
497 if (mapping->vma->map_flags & BO_MAP_WRITE)
498 set_domain.write_domain = I915_GEM_DOMAIN_GTT;
501 ret = drmIoctl(bo->drv->fd, DRM_IOCTL_I915_GEM_SET_DOMAIN, &set_domain);
503 fprintf(stderr, "drv: DRM_IOCTL_I915_GEM_SET_DOMAIN with %d\n", ret);
510 static int i915_bo_flush(struct bo *bo, struct mapping *mapping)
512 struct i915_device *i915 = bo->drv->priv;
513 if (!i915->has_llc && bo->tiling == I915_TILING_NONE)
514 i915_clflush(mapping->vma->addr, mapping->vma->length);
519 static uint32_t i915_resolve_format(uint32_t format, uint64_t use_flags)
522 case DRM_FORMAT_FLEX_IMPLEMENTATION_DEFINED:
523 /* KBL camera subsystem requires NV12. */
524 if (use_flags & (BO_USE_CAMERA_READ | BO_USE_CAMERA_WRITE))
525 return DRM_FORMAT_NV12;
526 /*HACK: See b/28671744 */
527 return DRM_FORMAT_XBGR8888;
528 case DRM_FORMAT_FLEX_YCbCr_420_888:
530 * KBL camera subsystem requires NV12. Our other use cases
532 * - Hardware video supports NV12,
533 * - USB Camera HALv3 supports NV12,
534 * - USB Camera HALv1 doesn't use this format.
535 * Moreover, NV12 is preferred for video, due to overlay
538 return DRM_FORMAT_NV12;
544 const struct backend backend_i915 = {
548 .bo_create = i915_bo_create,
549 .bo_create_with_modifiers = i915_bo_create_with_modifiers,
550 .bo_destroy = drv_gem_bo_destroy,
551 .bo_import = i915_bo_import,
552 .bo_map = i915_bo_map,
553 .bo_unmap = drv_bo_munmap,
554 .bo_invalidate = i915_bo_invalidate,
555 .bo_flush = i915_bo_flush,
556 .resolve_format = i915_resolve_format,