2 * Copyright © 2015 Intel Corporation
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
11 * The above copyright notice and this permission notice (including the next
12 * paragraph) shall be included in all copies or substantial portions of the
15 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
18 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
28 #include <sys/sysinfo.h>
33 #include "anv_private.h"
34 #include "util/strtod.h"
35 #include "util/debug.h"
36 #include "util/build_id.h"
37 #include "util/mesa-sha1.h"
38 #include "util/vk_util.h"
40 #include "genxml/gen7_pack.h"
43 compiler_debug_log(void *data
, const char *fmt
, ...)
47 compiler_perf_log(void *data
, const char *fmt
, ...)
52 if (unlikely(INTEL_DEBUG
& DEBUG_PERF
))
53 vfprintf(stderr
, fmt
, args
);
59 anv_compute_heap_size(int fd
, uint64_t *heap_size
)
62 if (anv_gem_get_context_param(fd
, 0, I915_CONTEXT_PARAM_GTT_SIZE
,
64 /* If, for whatever reason, we can't actually get the GTT size from the
65 * kernel (too old?) fall back to the aperture size.
67 anv_perf_warn("Failed to get I915_CONTEXT_PARAM_GTT_SIZE: %m");
69 if (anv_gem_get_aperture(fd
, >t_size
) == -1) {
70 return vk_errorf(VK_ERROR_INITIALIZATION_FAILED
,
71 "failed to get aperture size: %m");
75 /* Query the total ram from the system */
79 uint64_t total_ram
= (uint64_t)info
.totalram
* (uint64_t)info
.mem_unit
;
81 /* We don't want to burn too much ram with the GPU. If the user has 4GiB
82 * or less, we use at most half. If they have more than 4GiB, we use 3/4.
84 uint64_t available_ram
;
85 if (total_ram
<= 4ull * 1024ull * 1024ull * 1024ull)
86 available_ram
= total_ram
/ 2;
88 available_ram
= total_ram
* 3 / 4;
90 /* We also want to leave some padding for things we allocate in the driver,
91 * so don't go over 3/4 of the GTT either.
93 uint64_t available_gtt
= gtt_size
* 3 / 4;
95 *heap_size
= MIN2(available_ram
, available_gtt
);
101 anv_physical_device_init_uuids(struct anv_physical_device
*device
)
103 const struct build_id_note
*note
= build_id_find_nhdr("libvulkan_intel.so");
105 return vk_errorf(VK_ERROR_INITIALIZATION_FAILED
,
106 "Failed to find build-id");
109 unsigned build_id_len
= build_id_length(note
);
110 if (build_id_len
< 20) {
111 return vk_errorf(VK_ERROR_INITIALIZATION_FAILED
,
112 "build-id too short. It needs to be a SHA");
115 struct mesa_sha1 sha1_ctx
;
117 STATIC_ASSERT(VK_UUID_SIZE
<= sizeof(sha1
));
119 /* The pipeline cache UUID is used for determining when a pipeline cache is
120 * invalid. It needs both a driver build and the PCI ID of the device.
122 _mesa_sha1_init(&sha1_ctx
);
123 _mesa_sha1_update(&sha1_ctx
, build_id_data(note
), build_id_len
);
124 _mesa_sha1_update(&sha1_ctx
, &device
->chipset_id
,
125 sizeof(device
->chipset_id
));
126 _mesa_sha1_final(&sha1_ctx
, sha1
);
127 memcpy(device
->pipeline_cache_uuid
, sha1
, VK_UUID_SIZE
);
129 /* The driver UUID is used for determining sharability of images and memory
130 * between two Vulkan instances in separate processes. People who want to
131 * share memory need to also check the device UUID (below) so all this
132 * needs to be is the build-id.
134 memcpy(device
->driver_uuid
, build_id_data(note
), VK_UUID_SIZE
);
136 /* The device UUID uniquely identifies the given device within the machine.
137 * Since we never have more than one device, this doesn't need to be a real
138 * UUID. However, on the off-chance that someone tries to use this to
139 * cache pre-tiled images or something of the like, we use the PCI ID and
140 * some bits of ISL info to ensure that this is safe.
142 _mesa_sha1_init(&sha1_ctx
);
143 _mesa_sha1_update(&sha1_ctx
, &device
->chipset_id
,
144 sizeof(device
->chipset_id
));
145 _mesa_sha1_update(&sha1_ctx
, &device
->isl_dev
.has_bit6_swizzling
,
146 sizeof(device
->isl_dev
.has_bit6_swizzling
));
147 _mesa_sha1_final(&sha1_ctx
, sha1
);
148 memcpy(device
->device_uuid
, sha1
, VK_UUID_SIZE
);
154 anv_physical_device_init(struct anv_physical_device
*device
,
155 struct anv_instance
*instance
,
161 fd
= open(path
, O_RDWR
| O_CLOEXEC
);
163 return vk_error(VK_ERROR_INCOMPATIBLE_DRIVER
);
165 device
->_loader_data
.loaderMagic
= ICD_LOADER_MAGIC
;
166 device
->instance
= instance
;
168 assert(strlen(path
) < ARRAY_SIZE(device
->path
));
169 strncpy(device
->path
, path
, ARRAY_SIZE(device
->path
));
171 device
->chipset_id
= anv_gem_get_param(fd
, I915_PARAM_CHIPSET_ID
);
172 if (!device
->chipset_id
) {
173 result
= vk_error(VK_ERROR_INCOMPATIBLE_DRIVER
);
177 device
->name
= gen_get_device_name(device
->chipset_id
);
178 if (!gen_get_device_info(device
->chipset_id
, &device
->info
)) {
179 result
= vk_error(VK_ERROR_INCOMPATIBLE_DRIVER
);
183 if (device
->info
.is_haswell
) {
184 fprintf(stderr
, "WARNING: Haswell Vulkan support is incomplete\n");
185 } else if (device
->info
.gen
== 7 && !device
->info
.is_baytrail
) {
186 fprintf(stderr
, "WARNING: Ivy Bridge Vulkan support is incomplete\n");
187 } else if (device
->info
.gen
== 7 && device
->info
.is_baytrail
) {
188 fprintf(stderr
, "WARNING: Bay Trail Vulkan support is incomplete\n");
189 } else if (device
->info
.gen
>= 8) {
190 /* Broadwell, Cherryview, Skylake, Broxton, Kabylake is as fully
191 * supported as anything */
193 result
= vk_errorf(VK_ERROR_INCOMPATIBLE_DRIVER
,
194 "Vulkan not yet supported on %s", device
->name
);
198 device
->cmd_parser_version
= -1;
199 if (device
->info
.gen
== 7) {
200 device
->cmd_parser_version
=
201 anv_gem_get_param(fd
, I915_PARAM_CMD_PARSER_VERSION
);
202 if (device
->cmd_parser_version
== -1) {
203 result
= vk_errorf(VK_ERROR_INITIALIZATION_FAILED
,
204 "failed to get command parser version");
209 if (!anv_gem_get_param(fd
, I915_PARAM_HAS_WAIT_TIMEOUT
)) {
210 result
= vk_errorf(VK_ERROR_INITIALIZATION_FAILED
,
211 "kernel missing gem wait");
215 if (!anv_gem_get_param(fd
, I915_PARAM_HAS_EXECBUF2
)) {
216 result
= vk_errorf(VK_ERROR_INITIALIZATION_FAILED
,
217 "kernel missing execbuf2");
221 if (!device
->info
.has_llc
&&
222 anv_gem_get_param(fd
, I915_PARAM_MMAP_VERSION
) < 1) {
223 result
= vk_errorf(VK_ERROR_INITIALIZATION_FAILED
,
224 "kernel missing wc mmap");
228 device
->supports_48bit_addresses
= anv_gem_supports_48b_addresses(fd
);
230 result
= anv_compute_heap_size(fd
, &device
->heap_size
);
231 if (result
!= VK_SUCCESS
)
234 device
->has_exec_async
= anv_gem_get_param(fd
, I915_PARAM_HAS_EXEC_ASYNC
);
236 bool swizzled
= anv_gem_get_bit6_swizzle(fd
, I915_TILING_X
);
238 /* GENs prior to 8 do not support EU/Subslice info */
239 if (device
->info
.gen
>= 8) {
240 device
->subslice_total
= anv_gem_get_param(fd
, I915_PARAM_SUBSLICE_TOTAL
);
241 device
->eu_total
= anv_gem_get_param(fd
, I915_PARAM_EU_TOTAL
);
243 /* Without this information, we cannot get the right Braswell
244 * brandstrings, and we have to use conservative numbers for GPGPU on
245 * many platforms, but otherwise, things will just work.
247 if (device
->subslice_total
< 1 || device
->eu_total
< 1) {
248 fprintf(stderr
, "WARNING: Kernel 4.1 required to properly"
249 " query GPU properties.\n");
251 } else if (device
->info
.gen
== 7) {
252 device
->subslice_total
= 1 << (device
->info
.gt
- 1);
255 if (device
->info
.is_cherryview
&&
256 device
->subslice_total
> 0 && device
->eu_total
> 0) {
257 /* Logical CS threads = EUs per subslice * 7 threads per EU */
258 uint32_t max_cs_threads
= device
->eu_total
/ device
->subslice_total
* 7;
260 /* Fuse configurations may give more threads than expected, never less. */
261 if (max_cs_threads
> device
->info
.max_cs_threads
)
262 device
->info
.max_cs_threads
= max_cs_threads
;
265 brw_process_intel_debug_variable();
267 device
->compiler
= brw_compiler_create(NULL
, &device
->info
);
268 if (device
->compiler
== NULL
) {
269 result
= vk_error(VK_ERROR_OUT_OF_HOST_MEMORY
);
272 device
->compiler
->shader_debug_log
= compiler_debug_log
;
273 device
->compiler
->shader_perf_log
= compiler_perf_log
;
275 isl_device_init(&device
->isl_dev
, &device
->info
, swizzled
);
277 result
= anv_physical_device_init_uuids(device
);
278 if (result
!= VK_SUCCESS
)
281 result
= anv_init_wsi(device
);
282 if (result
!= VK_SUCCESS
) {
283 ralloc_free(device
->compiler
);
287 device
->local_fd
= fd
;
296 anv_physical_device_finish(struct anv_physical_device
*device
)
298 anv_finish_wsi(device
);
299 ralloc_free(device
->compiler
);
300 close(device
->local_fd
);
303 static const VkExtensionProperties global_extensions
[] = {
305 .extensionName
= VK_KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_EXTENSION_NAME
,
309 .extensionName
= VK_KHR_SURFACE_EXTENSION_NAME
,
312 #ifdef VK_USE_PLATFORM_WAYLAND_KHR
314 .extensionName
= VK_KHR_WAYLAND_SURFACE_EXTENSION_NAME
,
318 #ifdef VK_USE_PLATFORM_XCB_KHR
320 .extensionName
= VK_KHR_XCB_SURFACE_EXTENSION_NAME
,
324 #ifdef VK_USE_PLATFORM_XLIB_KHR
326 .extensionName
= VK_KHR_XLIB_SURFACE_EXTENSION_NAME
,
331 .extensionName
= VK_KHX_EXTERNAL_MEMORY_CAPABILITIES_EXTENSION_NAME
,
335 .extensionName
= VK_KHX_EXTERNAL_SEMAPHORE_CAPABILITIES_EXTENSION_NAME
,
340 static const VkExtensionProperties device_extensions
[] = {
342 .extensionName
= VK_KHR_DESCRIPTOR_UPDATE_TEMPLATE_EXTENSION_NAME
,
346 .extensionName
= VK_KHR_INCREMENTAL_PRESENT_EXTENSION_NAME
,
350 .extensionName
= VK_KHR_MAINTENANCE1_EXTENSION_NAME
,
354 .extensionName
= VK_KHR_PUSH_DESCRIPTOR_EXTENSION_NAME
,
358 .extensionName
= VK_KHR_SAMPLER_MIRROR_CLAMP_TO_EDGE_EXTENSION_NAME
,
362 .extensionName
= VK_KHR_SHADER_DRAW_PARAMETERS_EXTENSION_NAME
,
366 .extensionName
= VK_KHR_SWAPCHAIN_EXTENSION_NAME
,
370 .extensionName
= VK_KHX_EXTERNAL_MEMORY_EXTENSION_NAME
,
374 .extensionName
= VK_KHX_EXTERNAL_MEMORY_FD_EXTENSION_NAME
,
378 .extensionName
= VK_KHX_EXTERNAL_SEMAPHORE_EXTENSION_NAME
,
382 .extensionName
= VK_KHX_EXTERNAL_SEMAPHORE_FD_EXTENSION_NAME
,
386 .extensionName
= VK_KHX_MULTIVIEW_EXTENSION_NAME
,
392 default_alloc_func(void *pUserData
, size_t size
, size_t align
,
393 VkSystemAllocationScope allocationScope
)
399 default_realloc_func(void *pUserData
, void *pOriginal
, size_t size
,
400 size_t align
, VkSystemAllocationScope allocationScope
)
402 return realloc(pOriginal
, size
);
406 default_free_func(void *pUserData
, void *pMemory
)
411 static const VkAllocationCallbacks default_alloc
= {
413 .pfnAllocation
= default_alloc_func
,
414 .pfnReallocation
= default_realloc_func
,
415 .pfnFree
= default_free_func
,
418 VkResult
anv_CreateInstance(
419 const VkInstanceCreateInfo
* pCreateInfo
,
420 const VkAllocationCallbacks
* pAllocator
,
421 VkInstance
* pInstance
)
423 struct anv_instance
*instance
;
425 assert(pCreateInfo
->sType
== VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO
);
427 uint32_t client_version
;
428 if (pCreateInfo
->pApplicationInfo
&&
429 pCreateInfo
->pApplicationInfo
->apiVersion
!= 0) {
430 client_version
= pCreateInfo
->pApplicationInfo
->apiVersion
;
432 client_version
= VK_MAKE_VERSION(1, 0, 0);
435 if (VK_MAKE_VERSION(1, 0, 0) > client_version
||
436 client_version
> VK_MAKE_VERSION(1, 0, 0xfff)) {
437 return vk_errorf(VK_ERROR_INCOMPATIBLE_DRIVER
,
438 "Client requested version %d.%d.%d",
439 VK_VERSION_MAJOR(client_version
),
440 VK_VERSION_MINOR(client_version
),
441 VK_VERSION_PATCH(client_version
));
444 for (uint32_t i
= 0; i
< pCreateInfo
->enabledExtensionCount
; i
++) {
446 for (uint32_t j
= 0; j
< ARRAY_SIZE(global_extensions
); j
++) {
447 if (strcmp(pCreateInfo
->ppEnabledExtensionNames
[i
],
448 global_extensions
[j
].extensionName
) == 0) {
454 return vk_error(VK_ERROR_EXTENSION_NOT_PRESENT
);
457 instance
= vk_alloc2(&default_alloc
, pAllocator
, sizeof(*instance
), 8,
458 VK_SYSTEM_ALLOCATION_SCOPE_INSTANCE
);
460 return vk_error(VK_ERROR_OUT_OF_HOST_MEMORY
);
462 instance
->_loader_data
.loaderMagic
= ICD_LOADER_MAGIC
;
465 instance
->alloc
= *pAllocator
;
467 instance
->alloc
= default_alloc
;
469 instance
->apiVersion
= client_version
;
470 instance
->physicalDeviceCount
= -1;
474 VG(VALGRIND_CREATE_MEMPOOL(instance
, 0, false));
476 *pInstance
= anv_instance_to_handle(instance
);
481 void anv_DestroyInstance(
482 VkInstance _instance
,
483 const VkAllocationCallbacks
* pAllocator
)
485 ANV_FROM_HANDLE(anv_instance
, instance
, _instance
);
490 if (instance
->physicalDeviceCount
> 0) {
491 /* We support at most one physical device. */
492 assert(instance
->physicalDeviceCount
== 1);
493 anv_physical_device_finish(&instance
->physicalDevice
);
496 VG(VALGRIND_DESTROY_MEMPOOL(instance
));
500 vk_free(&instance
->alloc
, instance
);
504 anv_enumerate_devices(struct anv_instance
*instance
)
506 /* TODO: Check for more devices ? */
507 drmDevicePtr devices
[8];
508 VkResult result
= VK_ERROR_INCOMPATIBLE_DRIVER
;
511 instance
->physicalDeviceCount
= 0;
513 max_devices
= drmGetDevices2(0, devices
, sizeof(devices
));
515 return VK_ERROR_INCOMPATIBLE_DRIVER
;
517 for (unsigned i
= 0; i
< (unsigned)max_devices
; i
++) {
518 if (devices
[i
]->available_nodes
& 1 << DRM_NODE_RENDER
&&
519 devices
[i
]->bustype
== DRM_BUS_PCI
&&
520 devices
[i
]->deviceinfo
.pci
->vendor_id
== 0x8086) {
522 result
= anv_physical_device_init(&instance
->physicalDevice
,
524 devices
[i
]->nodes
[DRM_NODE_RENDER
]);
525 if (result
!= VK_ERROR_INCOMPATIBLE_DRIVER
)
530 if (result
== VK_SUCCESS
)
531 instance
->physicalDeviceCount
= 1;
537 VkResult
anv_EnumeratePhysicalDevices(
538 VkInstance _instance
,
539 uint32_t* pPhysicalDeviceCount
,
540 VkPhysicalDevice
* pPhysicalDevices
)
542 ANV_FROM_HANDLE(anv_instance
, instance
, _instance
);
543 VK_OUTARRAY_MAKE(out
, pPhysicalDevices
, pPhysicalDeviceCount
);
546 if (instance
->physicalDeviceCount
< 0) {
547 result
= anv_enumerate_devices(instance
);
548 if (result
!= VK_SUCCESS
&&
549 result
!= VK_ERROR_INCOMPATIBLE_DRIVER
)
553 if (instance
->physicalDeviceCount
> 0) {
554 assert(instance
->physicalDeviceCount
== 1);
555 vk_outarray_append(&out
, i
) {
556 *i
= anv_physical_device_to_handle(&instance
->physicalDevice
);
560 return vk_outarray_status(&out
);
563 void anv_GetPhysicalDeviceFeatures(
564 VkPhysicalDevice physicalDevice
,
565 VkPhysicalDeviceFeatures
* pFeatures
)
567 ANV_FROM_HANDLE(anv_physical_device
, pdevice
, physicalDevice
);
569 *pFeatures
= (VkPhysicalDeviceFeatures
) {
570 .robustBufferAccess
= true,
571 .fullDrawIndexUint32
= true,
572 .imageCubeArray
= true,
573 .independentBlend
= true,
574 .geometryShader
= true,
575 .tessellationShader
= true,
576 .sampleRateShading
= true,
577 .dualSrcBlend
= true,
579 .multiDrawIndirect
= true,
580 .drawIndirectFirstInstance
= true,
582 .depthBiasClamp
= true,
583 .fillModeNonSolid
= true,
584 .depthBounds
= false,
588 .multiViewport
= true,
589 .samplerAnisotropy
= true,
590 .textureCompressionETC2
= pdevice
->info
.gen
>= 8 ||
591 pdevice
->info
.is_baytrail
,
592 .textureCompressionASTC_LDR
= pdevice
->info
.gen
>= 9, /* FINISHME CHV */
593 .textureCompressionBC
= true,
594 .occlusionQueryPrecise
= true,
595 .pipelineStatisticsQuery
= true,
596 .fragmentStoresAndAtomics
= true,
597 .shaderTessellationAndGeometryPointSize
= true,
598 .shaderImageGatherExtended
= true,
599 .shaderStorageImageExtendedFormats
= true,
600 .shaderStorageImageMultisample
= false,
601 .shaderStorageImageReadWithoutFormat
= false,
602 .shaderStorageImageWriteWithoutFormat
= true,
603 .shaderUniformBufferArrayDynamicIndexing
= true,
604 .shaderSampledImageArrayDynamicIndexing
= true,
605 .shaderStorageBufferArrayDynamicIndexing
= true,
606 .shaderStorageImageArrayDynamicIndexing
= true,
607 .shaderClipDistance
= true,
608 .shaderCullDistance
= true,
609 .shaderFloat64
= pdevice
->info
.gen
>= 8,
610 .shaderInt64
= pdevice
->info
.gen
>= 8,
611 .shaderInt16
= false,
612 .shaderResourceMinLod
= false,
613 .variableMultisampleRate
= false,
614 .inheritedQueries
= true,
617 /* We can't do image stores in vec4 shaders */
618 pFeatures
->vertexPipelineStoresAndAtomics
=
619 pdevice
->compiler
->scalar_stage
[MESA_SHADER_VERTEX
] &&
620 pdevice
->compiler
->scalar_stage
[MESA_SHADER_GEOMETRY
];
623 void anv_GetPhysicalDeviceFeatures2KHR(
624 VkPhysicalDevice physicalDevice
,
625 VkPhysicalDeviceFeatures2KHR
* pFeatures
)
627 anv_GetPhysicalDeviceFeatures(physicalDevice
, &pFeatures
->features
);
629 vk_foreach_struct(ext
, pFeatures
->pNext
) {
630 switch (ext
->sType
) {
631 case VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MULTIVIEW_FEATURES_KHX
: {
632 VkPhysicalDeviceMultiviewFeaturesKHX
*features
=
633 (VkPhysicalDeviceMultiviewFeaturesKHX
*)ext
;
634 features
->multiview
= true;
635 features
->multiviewGeometryShader
= true;
636 features
->multiviewTessellationShader
= true;
641 anv_debug_ignored_stype(ext
->sType
);
647 void anv_GetPhysicalDeviceProperties(
648 VkPhysicalDevice physicalDevice
,
649 VkPhysicalDeviceProperties
* pProperties
)
651 ANV_FROM_HANDLE(anv_physical_device
, pdevice
, physicalDevice
);
652 const struct gen_device_info
*devinfo
= &pdevice
->info
;
654 /* See assertions made when programming the buffer surface state. */
655 const uint32_t max_raw_buffer_sz
= devinfo
->gen
>= 7 ?
656 (1ul << 30) : (1ul << 27);
658 VkSampleCountFlags sample_counts
=
659 isl_device_get_sample_counts(&pdevice
->isl_dev
);
661 VkPhysicalDeviceLimits limits
= {
662 .maxImageDimension1D
= (1 << 14),
663 .maxImageDimension2D
= (1 << 14),
664 .maxImageDimension3D
= (1 << 11),
665 .maxImageDimensionCube
= (1 << 14),
666 .maxImageArrayLayers
= (1 << 11),
667 .maxTexelBufferElements
= 128 * 1024 * 1024,
668 .maxUniformBufferRange
= (1ul << 27),
669 .maxStorageBufferRange
= max_raw_buffer_sz
,
670 .maxPushConstantsSize
= MAX_PUSH_CONSTANTS_SIZE
,
671 .maxMemoryAllocationCount
= UINT32_MAX
,
672 .maxSamplerAllocationCount
= 64 * 1024,
673 .bufferImageGranularity
= 64, /* A cache line */
674 .sparseAddressSpaceSize
= 0,
675 .maxBoundDescriptorSets
= MAX_SETS
,
676 .maxPerStageDescriptorSamplers
= 64,
677 .maxPerStageDescriptorUniformBuffers
= 64,
678 .maxPerStageDescriptorStorageBuffers
= 64,
679 .maxPerStageDescriptorSampledImages
= 64,
680 .maxPerStageDescriptorStorageImages
= 64,
681 .maxPerStageDescriptorInputAttachments
= 64,
682 .maxPerStageResources
= 128,
683 .maxDescriptorSetSamplers
= 256,
684 .maxDescriptorSetUniformBuffers
= 256,
685 .maxDescriptorSetUniformBuffersDynamic
= MAX_DYNAMIC_BUFFERS
/ 2,
686 .maxDescriptorSetStorageBuffers
= 256,
687 .maxDescriptorSetStorageBuffersDynamic
= MAX_DYNAMIC_BUFFERS
/ 2,
688 .maxDescriptorSetSampledImages
= 256,
689 .maxDescriptorSetStorageImages
= 256,
690 .maxDescriptorSetInputAttachments
= 256,
691 .maxVertexInputAttributes
= MAX_VBS
,
692 .maxVertexInputBindings
= MAX_VBS
,
693 .maxVertexInputAttributeOffset
= 2047,
694 .maxVertexInputBindingStride
= 2048,
695 .maxVertexOutputComponents
= 128,
696 .maxTessellationGenerationLevel
= 64,
697 .maxTessellationPatchSize
= 32,
698 .maxTessellationControlPerVertexInputComponents
= 128,
699 .maxTessellationControlPerVertexOutputComponents
= 128,
700 .maxTessellationControlPerPatchOutputComponents
= 128,
701 .maxTessellationControlTotalOutputComponents
= 2048,
702 .maxTessellationEvaluationInputComponents
= 128,
703 .maxTessellationEvaluationOutputComponents
= 128,
704 .maxGeometryShaderInvocations
= 32,
705 .maxGeometryInputComponents
= 64,
706 .maxGeometryOutputComponents
= 128,
707 .maxGeometryOutputVertices
= 256,
708 .maxGeometryTotalOutputComponents
= 1024,
709 .maxFragmentInputComponents
= 128,
710 .maxFragmentOutputAttachments
= 8,
711 .maxFragmentDualSrcAttachments
= 1,
712 .maxFragmentCombinedOutputResources
= 8,
713 .maxComputeSharedMemorySize
= 32768,
714 .maxComputeWorkGroupCount
= { 65535, 65535, 65535 },
715 .maxComputeWorkGroupInvocations
= 16 * devinfo
->max_cs_threads
,
716 .maxComputeWorkGroupSize
= {
717 16 * devinfo
->max_cs_threads
,
718 16 * devinfo
->max_cs_threads
,
719 16 * devinfo
->max_cs_threads
,
721 .subPixelPrecisionBits
= 4 /* FIXME */,
722 .subTexelPrecisionBits
= 4 /* FIXME */,
723 .mipmapPrecisionBits
= 4 /* FIXME */,
724 .maxDrawIndexedIndexValue
= UINT32_MAX
,
725 .maxDrawIndirectCount
= UINT32_MAX
,
726 .maxSamplerLodBias
= 16,
727 .maxSamplerAnisotropy
= 16,
728 .maxViewports
= MAX_VIEWPORTS
,
729 .maxViewportDimensions
= { (1 << 14), (1 << 14) },
730 .viewportBoundsRange
= { INT16_MIN
, INT16_MAX
},
731 .viewportSubPixelBits
= 13, /* We take a float? */
732 .minMemoryMapAlignment
= 4096, /* A page */
733 .minTexelBufferOffsetAlignment
= 1,
734 .minUniformBufferOffsetAlignment
= 16,
735 .minStorageBufferOffsetAlignment
= 4,
736 .minTexelOffset
= -8,
738 .minTexelGatherOffset
= -32,
739 .maxTexelGatherOffset
= 31,
740 .minInterpolationOffset
= -0.5,
741 .maxInterpolationOffset
= 0.4375,
742 .subPixelInterpolationOffsetBits
= 4,
743 .maxFramebufferWidth
= (1 << 14),
744 .maxFramebufferHeight
= (1 << 14),
745 .maxFramebufferLayers
= (1 << 11),
746 .framebufferColorSampleCounts
= sample_counts
,
747 .framebufferDepthSampleCounts
= sample_counts
,
748 .framebufferStencilSampleCounts
= sample_counts
,
749 .framebufferNoAttachmentsSampleCounts
= sample_counts
,
750 .maxColorAttachments
= MAX_RTS
,
751 .sampledImageColorSampleCounts
= sample_counts
,
752 .sampledImageIntegerSampleCounts
= VK_SAMPLE_COUNT_1_BIT
,
753 .sampledImageDepthSampleCounts
= sample_counts
,
754 .sampledImageStencilSampleCounts
= sample_counts
,
755 .storageImageSampleCounts
= VK_SAMPLE_COUNT_1_BIT
,
756 .maxSampleMaskWords
= 1,
757 .timestampComputeAndGraphics
= false,
758 .timestampPeriod
= devinfo
->timebase_scale
,
759 .maxClipDistances
= 8,
760 .maxCullDistances
= 8,
761 .maxCombinedClipAndCullDistances
= 8,
762 .discreteQueuePriorities
= 1,
763 .pointSizeRange
= { 0.125, 255.875 },
764 .lineWidthRange
= { 0.0, 7.9921875 },
765 .pointSizeGranularity
= (1.0 / 8.0),
766 .lineWidthGranularity
= (1.0 / 128.0),
767 .strictLines
= false, /* FINISHME */
768 .standardSampleLocations
= true,
769 .optimalBufferCopyOffsetAlignment
= 128,
770 .optimalBufferCopyRowPitchAlignment
= 128,
771 .nonCoherentAtomSize
= 64,
774 *pProperties
= (VkPhysicalDeviceProperties
) {
775 .apiVersion
= VK_MAKE_VERSION(1, 0, 42),
778 .deviceID
= pdevice
->chipset_id
,
779 .deviceType
= VK_PHYSICAL_DEVICE_TYPE_INTEGRATED_GPU
,
781 .sparseProperties
= {0}, /* Broadwell doesn't do sparse. */
784 strcpy(pProperties
->deviceName
, pdevice
->name
);
785 memcpy(pProperties
->pipelineCacheUUID
,
786 pdevice
->pipeline_cache_uuid
, VK_UUID_SIZE
);
789 void anv_GetPhysicalDeviceProperties2KHR(
790 VkPhysicalDevice physicalDevice
,
791 VkPhysicalDeviceProperties2KHR
* pProperties
)
793 ANV_FROM_HANDLE(anv_physical_device
, pdevice
, physicalDevice
);
795 anv_GetPhysicalDeviceProperties(physicalDevice
, &pProperties
->properties
);
797 vk_foreach_struct(ext
, pProperties
->pNext
) {
798 switch (ext
->sType
) {
799 case VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PUSH_DESCRIPTOR_PROPERTIES_KHR
: {
800 VkPhysicalDevicePushDescriptorPropertiesKHR
*properties
=
801 (VkPhysicalDevicePushDescriptorPropertiesKHR
*) ext
;
803 properties
->maxPushDescriptors
= MAX_PUSH_DESCRIPTORS
;
807 case VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_ID_PROPERTIES_KHX
: {
808 VkPhysicalDeviceIDPropertiesKHX
*id_props
=
809 (VkPhysicalDeviceIDPropertiesKHX
*)ext
;
810 memcpy(id_props
->deviceUUID
, pdevice
->device_uuid
, VK_UUID_SIZE
);
811 memcpy(id_props
->driverUUID
, pdevice
->driver_uuid
, VK_UUID_SIZE
);
812 /* The LUID is for Windows. */
813 id_props
->deviceLUIDValid
= false;
817 case VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MULTIVIEW_PROPERTIES_KHX
: {
818 VkPhysicalDeviceMultiviewPropertiesKHX
*properties
=
819 (VkPhysicalDeviceMultiviewPropertiesKHX
*)ext
;
820 properties
->maxMultiviewViewCount
= 16;
821 properties
->maxMultiviewInstanceIndex
= UINT32_MAX
/ 16;
826 anv_debug_ignored_stype(ext
->sType
);
832 /* We support exactly one queue family. */
833 static const VkQueueFamilyProperties
834 anv_queue_family_properties
= {
835 .queueFlags
= VK_QUEUE_GRAPHICS_BIT
|
836 VK_QUEUE_COMPUTE_BIT
|
837 VK_QUEUE_TRANSFER_BIT
,
839 .timestampValidBits
= 36, /* XXX: Real value here */
840 .minImageTransferGranularity
= { 1, 1, 1 },
843 void anv_GetPhysicalDeviceQueueFamilyProperties(
844 VkPhysicalDevice physicalDevice
,
846 VkQueueFamilyProperties
* pQueueFamilyProperties
)
848 VK_OUTARRAY_MAKE(out
, pQueueFamilyProperties
, pCount
);
850 vk_outarray_append(&out
, p
) {
851 *p
= anv_queue_family_properties
;
855 void anv_GetPhysicalDeviceQueueFamilyProperties2KHR(
856 VkPhysicalDevice physicalDevice
,
857 uint32_t* pQueueFamilyPropertyCount
,
858 VkQueueFamilyProperties2KHR
* pQueueFamilyProperties
)
861 VK_OUTARRAY_MAKE(out
, pQueueFamilyProperties
, pQueueFamilyPropertyCount
);
863 vk_outarray_append(&out
, p
) {
864 p
->queueFamilyProperties
= anv_queue_family_properties
;
866 vk_foreach_struct(s
, p
->pNext
) {
867 anv_debug_ignored_stype(s
->sType
);
872 void anv_GetPhysicalDeviceMemoryProperties(
873 VkPhysicalDevice physicalDevice
,
874 VkPhysicalDeviceMemoryProperties
* pMemoryProperties
)
876 ANV_FROM_HANDLE(anv_physical_device
, physical_device
, physicalDevice
);
878 if (physical_device
->info
.has_llc
) {
879 /* Big core GPUs share LLC with the CPU and thus one memory type can be
880 * both cached and coherent at the same time.
882 pMemoryProperties
->memoryTypeCount
= 1;
883 pMemoryProperties
->memoryTypes
[0] = (VkMemoryType
) {
884 .propertyFlags
= VK_MEMORY_PROPERTY_DEVICE_LOCAL_BIT
|
885 VK_MEMORY_PROPERTY_HOST_VISIBLE_BIT
|
886 VK_MEMORY_PROPERTY_HOST_COHERENT_BIT
|
887 VK_MEMORY_PROPERTY_HOST_CACHED_BIT
,
891 /* The spec requires that we expose a host-visible, coherent memory
892 * type, but Atom GPUs don't share LLC. Thus we offer two memory types
893 * to give the application a choice between cached, but not coherent and
894 * coherent but uncached (WC though).
896 pMemoryProperties
->memoryTypeCount
= 2;
897 pMemoryProperties
->memoryTypes
[0] = (VkMemoryType
) {
898 .propertyFlags
= VK_MEMORY_PROPERTY_DEVICE_LOCAL_BIT
|
899 VK_MEMORY_PROPERTY_HOST_VISIBLE_BIT
|
900 VK_MEMORY_PROPERTY_HOST_COHERENT_BIT
,
903 pMemoryProperties
->memoryTypes
[1] = (VkMemoryType
) {
904 .propertyFlags
= VK_MEMORY_PROPERTY_DEVICE_LOCAL_BIT
|
905 VK_MEMORY_PROPERTY_HOST_VISIBLE_BIT
|
906 VK_MEMORY_PROPERTY_HOST_CACHED_BIT
,
911 pMemoryProperties
->memoryHeapCount
= 1;
912 pMemoryProperties
->memoryHeaps
[0] = (VkMemoryHeap
) {
913 .size
= physical_device
->heap_size
,
914 .flags
= VK_MEMORY_HEAP_DEVICE_LOCAL_BIT
,
918 void anv_GetPhysicalDeviceMemoryProperties2KHR(
919 VkPhysicalDevice physicalDevice
,
920 VkPhysicalDeviceMemoryProperties2KHR
* pMemoryProperties
)
922 anv_GetPhysicalDeviceMemoryProperties(physicalDevice
,
923 &pMemoryProperties
->memoryProperties
);
925 vk_foreach_struct(ext
, pMemoryProperties
->pNext
) {
926 switch (ext
->sType
) {
928 anv_debug_ignored_stype(ext
->sType
);
934 PFN_vkVoidFunction
anv_GetInstanceProcAddr(
938 return anv_lookup_entrypoint(NULL
, pName
);
941 /* With version 1+ of the loader interface the ICD should expose
942 * vk_icdGetInstanceProcAddr to work around certain LD_PRELOAD issues seen in apps.
945 VKAPI_ATTR PFN_vkVoidFunction VKAPI_CALL
vk_icdGetInstanceProcAddr(
950 VKAPI_ATTR PFN_vkVoidFunction VKAPI_CALL
vk_icdGetInstanceProcAddr(
954 return anv_GetInstanceProcAddr(instance
, pName
);
957 PFN_vkVoidFunction
anv_GetDeviceProcAddr(
961 ANV_FROM_HANDLE(anv_device
, device
, _device
);
962 return anv_lookup_entrypoint(&device
->info
, pName
);
966 anv_queue_init(struct anv_device
*device
, struct anv_queue
*queue
)
968 queue
->_loader_data
.loaderMagic
= ICD_LOADER_MAGIC
;
969 queue
->device
= device
;
970 queue
->pool
= &device
->surface_state_pool
;
974 anv_queue_finish(struct anv_queue
*queue
)
978 static struct anv_state
979 anv_state_pool_emit_data(struct anv_state_pool
*pool
, size_t size
, size_t align
, const void *p
)
981 struct anv_state state
;
983 state
= anv_state_pool_alloc(pool
, size
, align
);
984 memcpy(state
.map
, p
, size
);
986 anv_state_flush(pool
->block_pool
.device
, state
);
991 struct gen8_border_color
{
996 /* Pad out to 64 bytes */
1001 anv_device_init_border_colors(struct anv_device
*device
)
1003 static const struct gen8_border_color border_colors
[] = {
1004 [VK_BORDER_COLOR_FLOAT_TRANSPARENT_BLACK
] = { .float32
= { 0.0, 0.0, 0.0, 0.0 } },
1005 [VK_BORDER_COLOR_FLOAT_OPAQUE_BLACK
] = { .float32
= { 0.0, 0.0, 0.0, 1.0 } },
1006 [VK_BORDER_COLOR_FLOAT_OPAQUE_WHITE
] = { .float32
= { 1.0, 1.0, 1.0, 1.0 } },
1007 [VK_BORDER_COLOR_INT_TRANSPARENT_BLACK
] = { .uint32
= { 0, 0, 0, 0 } },
1008 [VK_BORDER_COLOR_INT_OPAQUE_BLACK
] = { .uint32
= { 0, 0, 0, 1 } },
1009 [VK_BORDER_COLOR_INT_OPAQUE_WHITE
] = { .uint32
= { 1, 1, 1, 1 } },
1012 device
->border_colors
= anv_state_pool_emit_data(&device
->dynamic_state_pool
,
1013 sizeof(border_colors
), 64,
1017 VkResult
anv_CreateDevice(
1018 VkPhysicalDevice physicalDevice
,
1019 const VkDeviceCreateInfo
* pCreateInfo
,
1020 const VkAllocationCallbacks
* pAllocator
,
1023 ANV_FROM_HANDLE(anv_physical_device
, physical_device
, physicalDevice
);
1025 struct anv_device
*device
;
1027 assert(pCreateInfo
->sType
== VK_STRUCTURE_TYPE_DEVICE_CREATE_INFO
);
1029 for (uint32_t i
= 0; i
< pCreateInfo
->enabledExtensionCount
; i
++) {
1031 for (uint32_t j
= 0; j
< ARRAY_SIZE(device_extensions
); j
++) {
1032 if (strcmp(pCreateInfo
->ppEnabledExtensionNames
[i
],
1033 device_extensions
[j
].extensionName
) == 0) {
1039 return vk_error(VK_ERROR_EXTENSION_NOT_PRESENT
);
1042 device
= vk_alloc2(&physical_device
->instance
->alloc
, pAllocator
,
1044 VK_SYSTEM_ALLOCATION_SCOPE_DEVICE
);
1046 return vk_error(VK_ERROR_OUT_OF_HOST_MEMORY
);
1048 device
->_loader_data
.loaderMagic
= ICD_LOADER_MAGIC
;
1049 device
->instance
= physical_device
->instance
;
1050 device
->chipset_id
= physical_device
->chipset_id
;
1051 device
->lost
= false;
1054 device
->alloc
= *pAllocator
;
1056 device
->alloc
= physical_device
->instance
->alloc
;
1058 /* XXX(chadv): Can we dup() physicalDevice->fd here? */
1059 device
->fd
= open(physical_device
->path
, O_RDWR
| O_CLOEXEC
);
1060 if (device
->fd
== -1) {
1061 result
= vk_error(VK_ERROR_INITIALIZATION_FAILED
);
1065 device
->context_id
= anv_gem_create_context(device
);
1066 if (device
->context_id
== -1) {
1067 result
= vk_error(VK_ERROR_INITIALIZATION_FAILED
);
1071 device
->info
= physical_device
->info
;
1072 device
->isl_dev
= physical_device
->isl_dev
;
1074 /* On Broadwell and later, we can use batch chaining to more efficiently
1075 * implement growing command buffers. Prior to Haswell, the kernel
1076 * command parser gets in the way and we have to fall back to growing
1079 device
->can_chain_batches
= device
->info
.gen
>= 8;
1081 device
->robust_buffer_access
= pCreateInfo
->pEnabledFeatures
&&
1082 pCreateInfo
->pEnabledFeatures
->robustBufferAccess
;
1084 if (pthread_mutex_init(&device
->mutex
, NULL
) != 0) {
1085 result
= vk_error(VK_ERROR_INITIALIZATION_FAILED
);
1086 goto fail_context_id
;
1089 pthread_condattr_t condattr
;
1090 if (pthread_condattr_init(&condattr
) != 0) {
1091 result
= vk_error(VK_ERROR_INITIALIZATION_FAILED
);
1094 if (pthread_condattr_setclock(&condattr
, CLOCK_MONOTONIC
) != 0) {
1095 pthread_condattr_destroy(&condattr
);
1096 result
= vk_error(VK_ERROR_INITIALIZATION_FAILED
);
1099 if (pthread_cond_init(&device
->queue_submit
, NULL
) != 0) {
1100 pthread_condattr_destroy(&condattr
);
1101 result
= vk_error(VK_ERROR_INITIALIZATION_FAILED
);
1104 pthread_condattr_destroy(&condattr
);
1106 anv_bo_pool_init(&device
->batch_bo_pool
, device
);
1108 result
= anv_bo_cache_init(&device
->bo_cache
);
1109 if (result
!= VK_SUCCESS
)
1110 goto fail_batch_bo_pool
;
1112 result
= anv_state_pool_init(&device
->dynamic_state_pool
, device
, 16384);
1113 if (result
!= VK_SUCCESS
)
1116 result
= anv_state_pool_init(&device
->instruction_state_pool
, device
,
1118 if (result
!= VK_SUCCESS
)
1119 goto fail_dynamic_state_pool
;
1121 result
= anv_state_pool_init(&device
->surface_state_pool
, device
, 4096);
1122 if (result
!= VK_SUCCESS
)
1123 goto fail_instruction_state_pool
;
1125 result
= anv_bo_init_new(&device
->workaround_bo
, device
, 1024);
1126 if (result
!= VK_SUCCESS
)
1127 goto fail_surface_state_pool
;
1129 anv_scratch_pool_init(device
, &device
->scratch_pool
);
1131 anv_queue_init(device
, &device
->queue
);
1133 switch (device
->info
.gen
) {
1135 if (!device
->info
.is_haswell
)
1136 result
= gen7_init_device_state(device
);
1138 result
= gen75_init_device_state(device
);
1141 result
= gen8_init_device_state(device
);
1144 result
= gen9_init_device_state(device
);
1147 /* Shouldn't get here as we don't create physical devices for any other
1149 unreachable("unhandled gen");
1151 if (result
!= VK_SUCCESS
)
1152 goto fail_workaround_bo
;
1154 anv_device_init_blorp(device
);
1156 anv_device_init_border_colors(device
);
1158 *pDevice
= anv_device_to_handle(device
);
1163 anv_queue_finish(&device
->queue
);
1164 anv_scratch_pool_finish(device
, &device
->scratch_pool
);
1165 anv_gem_munmap(device
->workaround_bo
.map
, device
->workaround_bo
.size
);
1166 anv_gem_close(device
, device
->workaround_bo
.gem_handle
);
1167 fail_surface_state_pool
:
1168 anv_state_pool_finish(&device
->surface_state_pool
);
1169 fail_instruction_state_pool
:
1170 anv_state_pool_finish(&device
->instruction_state_pool
);
1171 fail_dynamic_state_pool
:
1172 anv_state_pool_finish(&device
->dynamic_state_pool
);
1174 anv_bo_cache_finish(&device
->bo_cache
);
1176 anv_bo_pool_finish(&device
->batch_bo_pool
);
1177 pthread_cond_destroy(&device
->queue_submit
);
1179 pthread_mutex_destroy(&device
->mutex
);
1181 anv_gem_destroy_context(device
, device
->context_id
);
1185 vk_free(&device
->alloc
, device
);
1190 void anv_DestroyDevice(
1192 const VkAllocationCallbacks
* pAllocator
)
1194 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1199 anv_device_finish_blorp(device
);
1201 anv_queue_finish(&device
->queue
);
1203 #ifdef HAVE_VALGRIND
1204 /* We only need to free these to prevent valgrind errors. The backing
1205 * BO will go away in a couple of lines so we don't actually leak.
1207 anv_state_pool_free(&device
->dynamic_state_pool
, device
->border_colors
);
1210 anv_scratch_pool_finish(device
, &device
->scratch_pool
);
1212 anv_gem_munmap(device
->workaround_bo
.map
, device
->workaround_bo
.size
);
1213 anv_gem_close(device
, device
->workaround_bo
.gem_handle
);
1215 anv_state_pool_finish(&device
->surface_state_pool
);
1216 anv_state_pool_finish(&device
->instruction_state_pool
);
1217 anv_state_pool_finish(&device
->dynamic_state_pool
);
1219 anv_bo_cache_finish(&device
->bo_cache
);
1221 anv_bo_pool_finish(&device
->batch_bo_pool
);
1223 pthread_cond_destroy(&device
->queue_submit
);
1224 pthread_mutex_destroy(&device
->mutex
);
1226 anv_gem_destroy_context(device
, device
->context_id
);
1230 vk_free(&device
->alloc
, device
);
1233 VkResult
anv_EnumerateInstanceExtensionProperties(
1234 const char* pLayerName
,
1235 uint32_t* pPropertyCount
,
1236 VkExtensionProperties
* pProperties
)
1238 if (pProperties
== NULL
) {
1239 *pPropertyCount
= ARRAY_SIZE(global_extensions
);
1243 *pPropertyCount
= MIN2(*pPropertyCount
, ARRAY_SIZE(global_extensions
));
1244 typed_memcpy(pProperties
, global_extensions
, *pPropertyCount
);
1246 if (*pPropertyCount
< ARRAY_SIZE(global_extensions
))
1247 return VK_INCOMPLETE
;
1252 VkResult
anv_EnumerateDeviceExtensionProperties(
1253 VkPhysicalDevice physicalDevice
,
1254 const char* pLayerName
,
1255 uint32_t* pPropertyCount
,
1256 VkExtensionProperties
* pProperties
)
1258 if (pProperties
== NULL
) {
1259 *pPropertyCount
= ARRAY_SIZE(device_extensions
);
1263 *pPropertyCount
= MIN2(*pPropertyCount
, ARRAY_SIZE(device_extensions
));
1264 typed_memcpy(pProperties
, device_extensions
, *pPropertyCount
);
1266 if (*pPropertyCount
< ARRAY_SIZE(device_extensions
))
1267 return VK_INCOMPLETE
;
1272 VkResult
anv_EnumerateInstanceLayerProperties(
1273 uint32_t* pPropertyCount
,
1274 VkLayerProperties
* pProperties
)
1276 if (pProperties
== NULL
) {
1277 *pPropertyCount
= 0;
1281 /* None supported at this time */
1282 return vk_error(VK_ERROR_LAYER_NOT_PRESENT
);
1285 VkResult
anv_EnumerateDeviceLayerProperties(
1286 VkPhysicalDevice physicalDevice
,
1287 uint32_t* pPropertyCount
,
1288 VkLayerProperties
* pProperties
)
1290 if (pProperties
== NULL
) {
1291 *pPropertyCount
= 0;
1295 /* None supported at this time */
1296 return vk_error(VK_ERROR_LAYER_NOT_PRESENT
);
1299 void anv_GetDeviceQueue(
1301 uint32_t queueNodeIndex
,
1302 uint32_t queueIndex
,
1305 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1307 assert(queueIndex
== 0);
1309 *pQueue
= anv_queue_to_handle(&device
->queue
);
1313 anv_device_query_status(struct anv_device
*device
)
1315 /* This isn't likely as most of the callers of this function already check
1316 * for it. However, it doesn't hurt to check and it potentially lets us
1319 if (unlikely(device
->lost
))
1320 return VK_ERROR_DEVICE_LOST
;
1322 uint32_t active
, pending
;
1323 int ret
= anv_gem_gpu_get_reset_stats(device
, &active
, &pending
);
1325 /* We don't know the real error. */
1326 device
->lost
= true;
1327 return vk_errorf(VK_ERROR_DEVICE_LOST
, "get_reset_stats failed: %m");
1331 device
->lost
= true;
1332 return vk_errorf(VK_ERROR_DEVICE_LOST
,
1333 "GPU hung on one of our command buffers");
1334 } else if (pending
) {
1335 device
->lost
= true;
1336 return vk_errorf(VK_ERROR_DEVICE_LOST
,
1337 "GPU hung with commands in-flight");
1344 anv_device_bo_busy(struct anv_device
*device
, struct anv_bo
*bo
)
1346 /* Note: This only returns whether or not the BO is in use by an i915 GPU.
1347 * Other usages of the BO (such as on different hardware) will not be
1348 * flagged as "busy" by this ioctl. Use with care.
1350 int ret
= anv_gem_busy(device
, bo
->gem_handle
);
1352 return VK_NOT_READY
;
1353 } else if (ret
== -1) {
1354 /* We don't know the real error. */
1355 device
->lost
= true;
1356 return vk_errorf(VK_ERROR_DEVICE_LOST
, "gem wait failed: %m");
1359 /* Query for device status after the busy call. If the BO we're checking
1360 * got caught in a GPU hang we don't want to return VK_SUCCESS to the
1361 * client because it clearly doesn't have valid data. Yes, this most
1362 * likely means an ioctl, but we just did an ioctl to query the busy status
1363 * so it's no great loss.
1365 return anv_device_query_status(device
);
1369 anv_device_wait(struct anv_device
*device
, struct anv_bo
*bo
,
1372 int ret
= anv_gem_wait(device
, bo
->gem_handle
, &timeout
);
1373 if (ret
== -1 && errno
== ETIME
) {
1375 } else if (ret
== -1) {
1376 /* We don't know the real error. */
1377 device
->lost
= true;
1378 return vk_errorf(VK_ERROR_DEVICE_LOST
, "gem wait failed: %m");
1381 /* Query for device status after the wait. If the BO we're waiting on got
1382 * caught in a GPU hang we don't want to return VK_SUCCESS to the client
1383 * because it clearly doesn't have valid data. Yes, this most likely means
1384 * an ioctl, but we just did an ioctl to wait so it's no great loss.
1386 return anv_device_query_status(device
);
1389 VkResult
anv_DeviceWaitIdle(
1392 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1393 if (unlikely(device
->lost
))
1394 return VK_ERROR_DEVICE_LOST
;
1396 struct anv_batch batch
;
1399 batch
.start
= batch
.next
= cmds
;
1400 batch
.end
= (void *) cmds
+ sizeof(cmds
);
1402 anv_batch_emit(&batch
, GEN7_MI_BATCH_BUFFER_END
, bbe
);
1403 anv_batch_emit(&batch
, GEN7_MI_NOOP
, noop
);
1405 return anv_device_submit_simple_batch(device
, &batch
);
1409 anv_bo_init_new(struct anv_bo
*bo
, struct anv_device
*device
, uint64_t size
)
1411 uint32_t gem_handle
= anv_gem_create(device
, size
);
1413 return vk_error(VK_ERROR_OUT_OF_DEVICE_MEMORY
);
1415 anv_bo_init(bo
, gem_handle
, size
);
1417 if (device
->instance
->physicalDevice
.supports_48bit_addresses
)
1418 bo
->flags
|= EXEC_OBJECT_SUPPORTS_48B_ADDRESS
;
1420 if (device
->instance
->physicalDevice
.has_exec_async
)
1421 bo
->flags
|= EXEC_OBJECT_ASYNC
;
1426 VkResult
anv_AllocateMemory(
1428 const VkMemoryAllocateInfo
* pAllocateInfo
,
1429 const VkAllocationCallbacks
* pAllocator
,
1430 VkDeviceMemory
* pMem
)
1432 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1433 struct anv_device_memory
*mem
;
1434 VkResult result
= VK_SUCCESS
;
1436 assert(pAllocateInfo
->sType
== VK_STRUCTURE_TYPE_MEMORY_ALLOCATE_INFO
);
1438 /* The Vulkan 1.0.33 spec says "allocationSize must be greater than 0". */
1439 assert(pAllocateInfo
->allocationSize
> 0);
1441 /* We support exactly one memory heap. */
1442 assert(pAllocateInfo
->memoryTypeIndex
== 0 ||
1443 (!device
->info
.has_llc
&& pAllocateInfo
->memoryTypeIndex
< 2));
1445 /* The kernel relocation API has a limitation of a 32-bit delta value
1446 * applied to the address before it is written which, in spite of it being
1447 * unsigned, is treated as signed . Because of the way that this maps to
1448 * the Vulkan API, we cannot handle an offset into a buffer that does not
1449 * fit into a signed 32 bits. The only mechanism we have for dealing with
1450 * this at the moment is to limit all VkDeviceMemory objects to a maximum
1451 * of 2GB each. The Vulkan spec allows us to do this:
1453 * "Some platforms may have a limit on the maximum size of a single
1454 * allocation. For example, certain systems may fail to create
1455 * allocations with a size greater than or equal to 4GB. Such a limit is
1456 * implementation-dependent, and if such a failure occurs then the error
1457 * VK_ERROR_OUT_OF_DEVICE_MEMORY should be returned."
1459 * We don't use vk_error here because it's not an error so much as an
1460 * indication to the application that the allocation is too large.
1462 if (pAllocateInfo
->allocationSize
> (1ull << 31))
1463 return VK_ERROR_OUT_OF_DEVICE_MEMORY
;
1465 /* FINISHME: Fail if allocation request exceeds heap size. */
1467 mem
= vk_alloc2(&device
->alloc
, pAllocator
, sizeof(*mem
), 8,
1468 VK_SYSTEM_ALLOCATION_SCOPE_OBJECT
);
1470 return vk_error(VK_ERROR_OUT_OF_HOST_MEMORY
);
1472 mem
->type_index
= pAllocateInfo
->memoryTypeIndex
;
1476 const VkImportMemoryFdInfoKHX
*fd_info
=
1477 vk_find_struct_const(pAllocateInfo
->pNext
, IMPORT_MEMORY_FD_INFO_KHX
);
1479 /* The Vulkan spec permits handleType to be 0, in which case the struct is
1482 if (fd_info
&& fd_info
->handleType
) {
1483 /* At the moment, we only support the OPAQUE_FD memory type which is
1484 * just a GEM buffer.
1486 assert(fd_info
->handleType
==
1487 VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_FD_BIT_KHX
);
1489 result
= anv_bo_cache_import(device
, &device
->bo_cache
,
1490 fd_info
->fd
, pAllocateInfo
->allocationSize
,
1492 if (result
!= VK_SUCCESS
)
1495 result
= anv_bo_cache_alloc(device
, &device
->bo_cache
,
1496 pAllocateInfo
->allocationSize
,
1498 if (result
!= VK_SUCCESS
)
1502 *pMem
= anv_device_memory_to_handle(mem
);
1507 vk_free2(&device
->alloc
, pAllocator
, mem
);
1512 VkResult
anv_GetMemoryFdKHX(
1514 VkDeviceMemory memory_h
,
1515 VkExternalMemoryHandleTypeFlagBitsKHX handleType
,
1518 ANV_FROM_HANDLE(anv_device
, dev
, device_h
);
1519 ANV_FROM_HANDLE(anv_device_memory
, mem
, memory_h
);
1521 /* We support only one handle type. */
1522 assert(handleType
== VK_EXTERNAL_MEMORY_HANDLE_TYPE_OPAQUE_FD_BIT_KHX
);
1524 return anv_bo_cache_export(dev
, &dev
->bo_cache
, mem
->bo
, pFd
);
1527 VkResult
anv_GetMemoryFdPropertiesKHX(
1529 VkExternalMemoryHandleTypeFlagBitsKHX handleType
,
1531 VkMemoryFdPropertiesKHX
* pMemoryFdProperties
)
1533 /* The valid usage section for this function says:
1535 * "handleType must not be one of the handle types defined as opaque."
1537 * Since we only handle opaque handles for now, there are no FD properties.
1539 return VK_ERROR_INVALID_EXTERNAL_HANDLE_KHX
;
1542 void anv_FreeMemory(
1544 VkDeviceMemory _mem
,
1545 const VkAllocationCallbacks
* pAllocator
)
1547 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1548 ANV_FROM_HANDLE(anv_device_memory
, mem
, _mem
);
1554 anv_UnmapMemory(_device
, _mem
);
1556 anv_bo_cache_release(device
, &device
->bo_cache
, mem
->bo
);
1558 vk_free2(&device
->alloc
, pAllocator
, mem
);
1561 VkResult
anv_MapMemory(
1563 VkDeviceMemory _memory
,
1564 VkDeviceSize offset
,
1566 VkMemoryMapFlags flags
,
1569 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1570 ANV_FROM_HANDLE(anv_device_memory
, mem
, _memory
);
1577 if (size
== VK_WHOLE_SIZE
)
1578 size
= mem
->bo
->size
- offset
;
1580 /* From the Vulkan spec version 1.0.32 docs for MapMemory:
1582 * * If size is not equal to VK_WHOLE_SIZE, size must be greater than 0
1583 * assert(size != 0);
1584 * * If size is not equal to VK_WHOLE_SIZE, size must be less than or
1585 * equal to the size of the memory minus offset
1588 assert(offset
+ size
<= mem
->bo
->size
);
1590 /* FIXME: Is this supposed to be thread safe? Since vkUnmapMemory() only
1591 * takes a VkDeviceMemory pointer, it seems like only one map of the memory
1592 * at a time is valid. We could just mmap up front and return an offset
1593 * pointer here, but that may exhaust virtual memory on 32 bit
1596 uint32_t gem_flags
= 0;
1597 if (!device
->info
.has_llc
&& mem
->type_index
== 0)
1598 gem_flags
|= I915_MMAP_WC
;
1600 /* GEM will fail to map if the offset isn't 4k-aligned. Round down. */
1601 uint64_t map_offset
= offset
& ~4095ull;
1602 assert(offset
>= map_offset
);
1603 uint64_t map_size
= (offset
+ size
) - map_offset
;
1605 /* Let's map whole pages */
1606 map_size
= align_u64(map_size
, 4096);
1608 void *map
= anv_gem_mmap(device
, mem
->bo
->gem_handle
,
1609 map_offset
, map_size
, gem_flags
);
1610 if (map
== MAP_FAILED
)
1611 return vk_error(VK_ERROR_MEMORY_MAP_FAILED
);
1614 mem
->map_size
= map_size
;
1616 *ppData
= mem
->map
+ (offset
- map_offset
);
1621 void anv_UnmapMemory(
1623 VkDeviceMemory _memory
)
1625 ANV_FROM_HANDLE(anv_device_memory
, mem
, _memory
);
1630 anv_gem_munmap(mem
->map
, mem
->map_size
);
1637 clflush_mapped_ranges(struct anv_device
*device
,
1639 const VkMappedMemoryRange
*ranges
)
1641 for (uint32_t i
= 0; i
< count
; i
++) {
1642 ANV_FROM_HANDLE(anv_device_memory
, mem
, ranges
[i
].memory
);
1643 if (ranges
[i
].offset
>= mem
->map_size
)
1646 anv_clflush_range(mem
->map
+ ranges
[i
].offset
,
1647 MIN2(ranges
[i
].size
, mem
->map_size
- ranges
[i
].offset
));
1651 VkResult
anv_FlushMappedMemoryRanges(
1653 uint32_t memoryRangeCount
,
1654 const VkMappedMemoryRange
* pMemoryRanges
)
1656 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1658 if (device
->info
.has_llc
)
1661 /* Make sure the writes we're flushing have landed. */
1662 __builtin_ia32_mfence();
1664 clflush_mapped_ranges(device
, memoryRangeCount
, pMemoryRanges
);
1669 VkResult
anv_InvalidateMappedMemoryRanges(
1671 uint32_t memoryRangeCount
,
1672 const VkMappedMemoryRange
* pMemoryRanges
)
1674 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1676 if (device
->info
.has_llc
)
1679 clflush_mapped_ranges(device
, memoryRangeCount
, pMemoryRanges
);
1681 /* Make sure no reads get moved up above the invalidate. */
1682 __builtin_ia32_mfence();
1687 void anv_GetBufferMemoryRequirements(
1690 VkMemoryRequirements
* pMemoryRequirements
)
1692 ANV_FROM_HANDLE(anv_buffer
, buffer
, _buffer
);
1693 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1695 /* The Vulkan spec (git aaed022) says:
1697 * memoryTypeBits is a bitfield and contains one bit set for every
1698 * supported memory type for the resource. The bit `1<<i` is set if and
1699 * only if the memory type `i` in the VkPhysicalDeviceMemoryProperties
1700 * structure for the physical device is supported.
1702 * We support exactly one memory type on LLC, two on non-LLC.
1704 pMemoryRequirements
->memoryTypeBits
= device
->info
.has_llc
? 1 : 3;
1706 pMemoryRequirements
->size
= buffer
->size
;
1707 pMemoryRequirements
->alignment
= 16;
1710 void anv_GetImageMemoryRequirements(
1713 VkMemoryRequirements
* pMemoryRequirements
)
1715 ANV_FROM_HANDLE(anv_image
, image
, _image
);
1716 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1718 /* The Vulkan spec (git aaed022) says:
1720 * memoryTypeBits is a bitfield and contains one bit set for every
1721 * supported memory type for the resource. The bit `1<<i` is set if and
1722 * only if the memory type `i` in the VkPhysicalDeviceMemoryProperties
1723 * structure for the physical device is supported.
1725 * We support exactly one memory type on LLC, two on non-LLC.
1727 pMemoryRequirements
->memoryTypeBits
= device
->info
.has_llc
? 1 : 3;
1729 pMemoryRequirements
->size
= image
->size
;
1730 pMemoryRequirements
->alignment
= image
->alignment
;
1733 void anv_GetImageSparseMemoryRequirements(
1736 uint32_t* pSparseMemoryRequirementCount
,
1737 VkSparseImageMemoryRequirements
* pSparseMemoryRequirements
)
1739 *pSparseMemoryRequirementCount
= 0;
1742 void anv_GetDeviceMemoryCommitment(
1744 VkDeviceMemory memory
,
1745 VkDeviceSize
* pCommittedMemoryInBytes
)
1747 *pCommittedMemoryInBytes
= 0;
1750 VkResult
anv_BindBufferMemory(
1753 VkDeviceMemory _memory
,
1754 VkDeviceSize memoryOffset
)
1756 ANV_FROM_HANDLE(anv_device_memory
, mem
, _memory
);
1757 ANV_FROM_HANDLE(anv_buffer
, buffer
, _buffer
);
1760 buffer
->bo
= mem
->bo
;
1761 buffer
->offset
= memoryOffset
;
1770 VkResult
anv_QueueBindSparse(
1772 uint32_t bindInfoCount
,
1773 const VkBindSparseInfo
* pBindInfo
,
1776 ANV_FROM_HANDLE(anv_queue
, queue
, _queue
);
1777 if (unlikely(queue
->device
->lost
))
1778 return VK_ERROR_DEVICE_LOST
;
1780 return vk_error(VK_ERROR_FEATURE_NOT_PRESENT
);
1785 VkResult
anv_CreateEvent(
1787 const VkEventCreateInfo
* pCreateInfo
,
1788 const VkAllocationCallbacks
* pAllocator
,
1791 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1792 struct anv_state state
;
1793 struct anv_event
*event
;
1795 assert(pCreateInfo
->sType
== VK_STRUCTURE_TYPE_EVENT_CREATE_INFO
);
1797 state
= anv_state_pool_alloc(&device
->dynamic_state_pool
,
1800 event
->state
= state
;
1801 event
->semaphore
= VK_EVENT_RESET
;
1803 if (!device
->info
.has_llc
) {
1804 /* Make sure the writes we're flushing have landed. */
1805 __builtin_ia32_mfence();
1806 __builtin_ia32_clflush(event
);
1809 *pEvent
= anv_event_to_handle(event
);
1814 void anv_DestroyEvent(
1817 const VkAllocationCallbacks
* pAllocator
)
1819 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1820 ANV_FROM_HANDLE(anv_event
, event
, _event
);
1825 anv_state_pool_free(&device
->dynamic_state_pool
, event
->state
);
1828 VkResult
anv_GetEventStatus(
1832 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1833 ANV_FROM_HANDLE(anv_event
, event
, _event
);
1835 if (unlikely(device
->lost
))
1836 return VK_ERROR_DEVICE_LOST
;
1838 if (!device
->info
.has_llc
) {
1839 /* Invalidate read cache before reading event written by GPU. */
1840 __builtin_ia32_clflush(event
);
1841 __builtin_ia32_mfence();
1845 return event
->semaphore
;
1848 VkResult
anv_SetEvent(
1852 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1853 ANV_FROM_HANDLE(anv_event
, event
, _event
);
1855 event
->semaphore
= VK_EVENT_SET
;
1857 if (!device
->info
.has_llc
) {
1858 /* Make sure the writes we're flushing have landed. */
1859 __builtin_ia32_mfence();
1860 __builtin_ia32_clflush(event
);
1866 VkResult
anv_ResetEvent(
1870 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1871 ANV_FROM_HANDLE(anv_event
, event
, _event
);
1873 event
->semaphore
= VK_EVENT_RESET
;
1875 if (!device
->info
.has_llc
) {
1876 /* Make sure the writes we're flushing have landed. */
1877 __builtin_ia32_mfence();
1878 __builtin_ia32_clflush(event
);
1886 VkResult
anv_CreateBuffer(
1888 const VkBufferCreateInfo
* pCreateInfo
,
1889 const VkAllocationCallbacks
* pAllocator
,
1892 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1893 struct anv_buffer
*buffer
;
1895 assert(pCreateInfo
->sType
== VK_STRUCTURE_TYPE_BUFFER_CREATE_INFO
);
1897 buffer
= vk_alloc2(&device
->alloc
, pAllocator
, sizeof(*buffer
), 8,
1898 VK_SYSTEM_ALLOCATION_SCOPE_OBJECT
);
1900 return vk_error(VK_ERROR_OUT_OF_HOST_MEMORY
);
1902 buffer
->size
= pCreateInfo
->size
;
1903 buffer
->usage
= pCreateInfo
->usage
;
1907 *pBuffer
= anv_buffer_to_handle(buffer
);
1912 void anv_DestroyBuffer(
1915 const VkAllocationCallbacks
* pAllocator
)
1917 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1918 ANV_FROM_HANDLE(anv_buffer
, buffer
, _buffer
);
1923 vk_free2(&device
->alloc
, pAllocator
, buffer
);
1927 anv_fill_buffer_surface_state(struct anv_device
*device
, struct anv_state state
,
1928 enum isl_format format
,
1929 uint32_t offset
, uint32_t range
, uint32_t stride
)
1931 isl_buffer_fill_state(&device
->isl_dev
, state
.map
,
1933 .mocs
= device
->default_mocs
,
1938 anv_state_flush(device
, state
);
1941 void anv_DestroySampler(
1944 const VkAllocationCallbacks
* pAllocator
)
1946 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1947 ANV_FROM_HANDLE(anv_sampler
, sampler
, _sampler
);
1952 vk_free2(&device
->alloc
, pAllocator
, sampler
);
1955 VkResult
anv_CreateFramebuffer(
1957 const VkFramebufferCreateInfo
* pCreateInfo
,
1958 const VkAllocationCallbacks
* pAllocator
,
1959 VkFramebuffer
* pFramebuffer
)
1961 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1962 struct anv_framebuffer
*framebuffer
;
1964 assert(pCreateInfo
->sType
== VK_STRUCTURE_TYPE_FRAMEBUFFER_CREATE_INFO
);
1966 size_t size
= sizeof(*framebuffer
) +
1967 sizeof(struct anv_image_view
*) * pCreateInfo
->attachmentCount
;
1968 framebuffer
= vk_alloc2(&device
->alloc
, pAllocator
, size
, 8,
1969 VK_SYSTEM_ALLOCATION_SCOPE_OBJECT
);
1970 if (framebuffer
== NULL
)
1971 return vk_error(VK_ERROR_OUT_OF_HOST_MEMORY
);
1973 framebuffer
->attachment_count
= pCreateInfo
->attachmentCount
;
1974 for (uint32_t i
= 0; i
< pCreateInfo
->attachmentCount
; i
++) {
1975 VkImageView _iview
= pCreateInfo
->pAttachments
[i
];
1976 framebuffer
->attachments
[i
] = anv_image_view_from_handle(_iview
);
1979 framebuffer
->width
= pCreateInfo
->width
;
1980 framebuffer
->height
= pCreateInfo
->height
;
1981 framebuffer
->layers
= pCreateInfo
->layers
;
1983 *pFramebuffer
= anv_framebuffer_to_handle(framebuffer
);
1988 void anv_DestroyFramebuffer(
1991 const VkAllocationCallbacks
* pAllocator
)
1993 ANV_FROM_HANDLE(anv_device
, device
, _device
);
1994 ANV_FROM_HANDLE(anv_framebuffer
, fb
, _fb
);
1999 vk_free2(&device
->alloc
, pAllocator
, fb
);
2002 /* vk_icd.h does not declare this function, so we declare it here to
2003 * suppress Wmissing-prototypes.
2005 PUBLIC VKAPI_ATTR VkResult VKAPI_CALL
2006 vk_icdNegotiateLoaderICDInterfaceVersion(uint32_t* pSupportedVersion
);
2008 PUBLIC VKAPI_ATTR VkResult VKAPI_CALL
2009 vk_icdNegotiateLoaderICDInterfaceVersion(uint32_t* pSupportedVersion
)
2011 /* For the full details on loader interface versioning, see
2012 * <https://github.com/KhronosGroup/Vulkan-LoaderAndValidationLayers/blob/master/loader/LoaderAndLayerInterface.md>.
2013 * What follows is a condensed summary, to help you navigate the large and
2014 * confusing official doc.
2016 * - Loader interface v0 is incompatible with later versions. We don't
2019 * - In loader interface v1:
2020 * - The first ICD entrypoint called by the loader is
2021 * vk_icdGetInstanceProcAddr(). The ICD must statically expose this
2023 * - The ICD must statically expose no other Vulkan symbol unless it is
2024 * linked with -Bsymbolic.
2025 * - Each dispatchable Vulkan handle created by the ICD must be
2026 * a pointer to a struct whose first member is VK_LOADER_DATA. The
2027 * ICD must initialize VK_LOADER_DATA.loadMagic to ICD_LOADER_MAGIC.
2028 * - The loader implements vkCreate{PLATFORM}SurfaceKHR() and
2029 * vkDestroySurfaceKHR(). The ICD must be capable of working with
2030 * such loader-managed surfaces.
2032 * - Loader interface v2 differs from v1 in:
2033 * - The first ICD entrypoint called by the loader is
2034 * vk_icdNegotiateLoaderICDInterfaceVersion(). The ICD must
2035 * statically expose this entrypoint.
2037 * - Loader interface v3 differs from v2 in:
2038 * - The ICD must implement vkCreate{PLATFORM}SurfaceKHR(),
2039 * vkDestroySurfaceKHR(), and other API which uses VKSurfaceKHR,
2040 * because the loader no longer does so.
2042 *pSupportedVersion
= MIN2(*pSupportedVersion
, 3u);