3 * Copyright 2017 Intel Corporation
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the
7 * "Software"), to deal in the Software without restriction, including
8 * without limitation the rights to use, copy, modify, merge, publish,
9 * distribute, sub license, and/or sell copies of the Software, and to
10 * permit persons to whom the Software is furnished to do so, subject to
11 * the following conditions:
13 * The above copyright notice and this permission notice (including the
14 * next paragraph) shall be included in all copies or substantial portions
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
20 * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
21 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
22 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
23 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
30 import xml
.etree
.cElementTree
as et
32 from mako
.template
import Template
34 MAX_API_VERSION
= '1.1.107'
37 def __init__(self
, name
, ext_version
, enable
):
39 self
.ext_version
= int(ext_version
)
43 self
.enable
= 'false';
47 # On Android, we disable all surface and swapchain extensions. Android's Vulkan
48 # loader implements VK_KHR_surface and VK_KHR_swapchain, and applications
49 # cannot access the driver's implementation. Moreoever, if the driver exposes
50 # the those extension strings, then tests dEQP-VK.api.info.instance.extensions
51 # and dEQP-VK.api.info.device fail due to the duplicated strings.
53 Extension('VK_ANDROID_external_memory_android_hardware_buffer', 3, 'RADV_SUPPORT_ANDROID_HARDWARE_BUFFER && device->rad_info.has_syncobj_wait_for_submit'),
54 Extension('VK_ANDROID_native_buffer', 5, 'ANDROID && device->rad_info.has_syncobj_wait_for_submit'),
55 Extension('VK_KHR_16bit_storage', 1, '!device->use_aco'),
56 Extension('VK_KHR_bind_memory2', 1, True),
57 Extension('VK_KHR_buffer_device_address', 1, True),
58 Extension('VK_KHR_create_renderpass2', 1, True),
59 Extension('VK_KHR_dedicated_allocation', 1, True),
60 Extension('VK_KHR_depth_stencil_resolve', 1, True),
61 Extension('VK_KHR_descriptor_update_template', 1, True),
62 Extension('VK_KHR_device_group', 1, True),
63 Extension('VK_KHR_device_group_creation', 1, True),
64 Extension('VK_KHR_draw_indirect_count', 1, True),
65 Extension('VK_KHR_driver_properties', 1, True),
66 Extension('VK_KHR_external_fence', 1, 'device->rad_info.has_syncobj_wait_for_submit'),
67 Extension('VK_KHR_external_fence_capabilities', 1, True),
68 Extension('VK_KHR_external_fence_fd', 1, 'device->rad_info.has_syncobj_wait_for_submit'),
69 Extension('VK_KHR_external_memory', 1, True),
70 Extension('VK_KHR_external_memory_capabilities', 1, True),
71 Extension('VK_KHR_external_memory_fd', 1, True),
72 Extension('VK_KHR_external_semaphore', 1, 'device->rad_info.has_syncobj'),
73 Extension('VK_KHR_external_semaphore_capabilities', 1, True),
74 Extension('VK_KHR_external_semaphore_fd', 1, 'device->rad_info.has_syncobj'),
75 Extension('VK_KHR_get_display_properties2', 1, 'VK_USE_PLATFORM_DISPLAY_KHR'),
76 Extension('VK_KHR_get_memory_requirements2', 1, True),
77 Extension('VK_KHR_get_physical_device_properties2', 1, True),
78 Extension('VK_KHR_get_surface_capabilities2', 1, 'RADV_HAS_SURFACE'),
79 Extension('VK_KHR_image_format_list', 1, True),
80 Extension('VK_KHR_imageless_framebuffer', 1, True),
81 Extension('VK_KHR_incremental_present', 1, 'RADV_HAS_SURFACE'),
82 Extension('VK_KHR_maintenance1', 1, True),
83 Extension('VK_KHR_maintenance2', 1, True),
84 Extension('VK_KHR_maintenance3', 1, True),
85 Extension('VK_KHR_pipeline_executable_properties', 1, True),
86 Extension('VK_KHR_push_descriptor', 1, True),
87 Extension('VK_KHR_relaxed_block_layout', 1, True),
88 Extension('VK_KHR_sampler_mirror_clamp_to_edge', 1, True),
89 Extension('VK_KHR_sampler_ycbcr_conversion', 1, True),
90 Extension('VK_KHR_separate_depth_stencil_layouts', 1, True),
91 Extension('VK_KHR_shader_atomic_int64', 1, 'LLVM_VERSION_MAJOR >= 9'),
92 Extension('VK_KHR_shader_clock', 1, True),
93 Extension('VK_KHR_shader_draw_parameters', 1, True),
94 Extension('VK_KHR_shader_float_controls', 1, True),
95 Extension('VK_KHR_shader_float16_int8', 1, '!device->use_aco'),
96 Extension('VK_KHR_shader_subgroup_extended_types', 1, True),
97 Extension('VK_KHR_spirv_1_4', 1, True),
98 Extension('VK_KHR_storage_buffer_storage_class', 1, True),
99 Extension('VK_KHR_surface', 25, 'RADV_HAS_SURFACE'),
100 Extension('VK_KHR_surface_protected_capabilities', 1, 'RADV_HAS_SURFACE'),
101 Extension('VK_KHR_swapchain', 68, 'RADV_HAS_SURFACE'),
102 Extension('VK_KHR_timeline_semaphore', 2, 'device->rad_info.has_syncobj_wait_for_submit'),
103 Extension('VK_KHR_uniform_buffer_standard_layout', 1, True),
104 Extension('VK_KHR_variable_pointers', 1, True),
105 Extension('VK_KHR_wayland_surface', 6, 'VK_USE_PLATFORM_WAYLAND_KHR'),
106 Extension('VK_KHR_xcb_surface', 6, 'VK_USE_PLATFORM_XCB_KHR'),
107 Extension('VK_KHR_xlib_surface', 6, 'VK_USE_PLATFORM_XLIB_KHR'),
108 Extension('VK_KHR_multiview', 1, True),
109 Extension('VK_KHR_display', 23, 'VK_USE_PLATFORM_DISPLAY_KHR'),
110 Extension('VK_KHR_8bit_storage', 1, 'device->rad_info.chip_class >= GFX8 && !device->use_aco'),
111 Extension('VK_EXT_direct_mode_display', 1, 'VK_USE_PLATFORM_DISPLAY_KHR'),
112 Extension('VK_EXT_acquire_xlib_display', 1, 'VK_USE_PLATFORM_XLIB_XRANDR_EXT'),
113 Extension('VK_EXT_buffer_device_address', 1, True),
114 Extension('VK_EXT_calibrated_timestamps', 1, True),
115 Extension('VK_EXT_conditional_rendering', 1, True),
116 Extension('VK_EXT_conservative_rasterization', 1, 'device->rad_info.chip_class >= GFX9'),
117 Extension('VK_EXT_display_surface_counter', 1, 'VK_USE_PLATFORM_DISPLAY_KHR'),
118 Extension('VK_EXT_display_control', 1, 'VK_USE_PLATFORM_DISPLAY_KHR'),
119 Extension('VK_EXT_debug_report', 9, True),
120 Extension('VK_EXT_depth_clip_enable', 1, True),
121 Extension('VK_EXT_depth_range_unrestricted', 1, True),
122 Extension('VK_EXT_descriptor_indexing', 2, True),
123 Extension('VK_EXT_discard_rectangles', 1, True),
124 Extension('VK_EXT_external_memory_dma_buf', 1, True),
125 Extension('VK_EXT_external_memory_host', 1, 'device->rad_info.has_userptr'),
126 Extension('VK_EXT_global_priority', 1, 'device->rad_info.has_ctx_priority'),
127 Extension('VK_EXT_host_query_reset', 1, True),
128 Extension('VK_EXT_index_type_uint8', 1, 'device->rad_info.chip_class >= GFX8'),
129 Extension('VK_EXT_inline_uniform_block', 1, True),
130 Extension('VK_EXT_memory_budget', 1, True),
131 Extension('VK_EXT_memory_priority', 1, True),
132 Extension('VK_EXT_pci_bus_info', 2, True),
133 Extension('VK_EXT_pipeline_creation_feedback', 1, True),
134 Extension('VK_EXT_post_depth_coverage', 1, 'device->rad_info.chip_class >= GFX10'),
135 Extension('VK_EXT_queue_family_foreign', 1, True),
136 Extension('VK_EXT_sample_locations', 1, True),
137 Extension('VK_EXT_sampler_filter_minmax', 1, 'device->rad_info.chip_class >= GFX7'),
138 Extension('VK_EXT_scalar_block_layout', 1, 'device->rad_info.chip_class >= GFX7'),
139 Extension('VK_EXT_shader_demote_to_helper_invocation',1, 'device->use_aco'),
140 Extension('VK_EXT_shader_viewport_index_layer', 1, True),
141 Extension('VK_EXT_shader_stencil_export', 1, True),
142 Extension('VK_EXT_shader_subgroup_ballot', 1, True),
143 Extension('VK_EXT_shader_subgroup_vote', 1, True),
144 Extension('VK_EXT_subgroup_size_control', 2, '!device->use_aco'),
145 Extension('VK_EXT_texel_buffer_alignment', 1, True),
146 Extension('VK_EXT_transform_feedback', 1, True),
147 Extension('VK_EXT_vertex_attribute_divisor', 3, True),
148 Extension('VK_EXT_ycbcr_image_arrays', 1, True),
149 Extension('VK_AMD_buffer_marker', 1, True),
150 Extension('VK_AMD_device_coherent_memory', 1, True),
151 Extension('VK_AMD_draw_indirect_count', 1, True),
152 Extension('VK_AMD_gcn_shader', 1, True),
153 Extension('VK_AMD_gpu_shader_half_float', 1, '!device->use_aco && device->rad_info.chip_class >= GFX9'),
154 Extension('VK_AMD_gpu_shader_int16', 1, '!device->use_aco && device->rad_info.chip_class >= GFX9'),
155 Extension('VK_AMD_rasterization_order', 1, 'device->rad_info.has_out_of_order_rast'),
156 Extension('VK_AMD_shader_ballot', 1, 'device->use_shader_ballot'),
157 Extension('VK_AMD_shader_core_properties', 1, True),
158 Extension('VK_AMD_shader_core_properties2', 1, True),
159 Extension('VK_AMD_shader_info', 1, True),
160 Extension('VK_AMD_shader_trinary_minmax', 1, True),
161 Extension('VK_GOOGLE_decorate_string', 1, True),
162 Extension('VK_GOOGLE_hlsl_functionality1', 1, True),
163 Extension('VK_NV_compute_shader_derivatives', 1, 'device->rad_info.chip_class >= GFX8'),
167 def __init__(self
, string
):
168 split
= string
.split('.')
169 self
.major
= int(split
[0])
170 self
.minor
= int(split
[1])
172 assert len(split
) == 3
173 self
.patch
= int(split
[2])
177 # Sanity check. The range bits are required by the definition of the
178 # VK_MAKE_VERSION macro
179 assert self
.major
< 1024 and self
.minor
< 1024
180 assert self
.patch
is None or self
.patch
< 4096
181 assert(str(self
) == string
)
184 ver_list
= [str(self
.major
), str(self
.minor
)]
185 if self
.patch
is not None:
186 ver_list
.append(str(self
.patch
))
187 return '.'.join(ver_list
)
189 def c_vk_version(self
):
190 patch
= self
.patch
if self
.patch
is not None else 0
191 ver_list
= [str(self
.major
), str(self
.minor
), str(patch
)]
192 return 'VK_MAKE_VERSION(' + ', '.join(ver_list
) + ')'
195 # This is just an expansion of VK_VERSION
196 patch
= self
.patch
if self
.patch
is not None else 0
197 return (self
.major
<< 22) |
(self
.minor
<< 12) | patch
199 def __gt__(self
, other
):
200 # If only one of them has a patch version, "ignore" it by making
201 # other's patch version match self.
202 if (self
.patch
is None) != (other
.patch
is None):
203 other
= copy
.copy(other
)
204 other
.patch
= self
.patch
206 return self
.__int
_ver
() > other
.__int
_ver
()
209 MAX_API_VERSION
= VkVersion(MAX_API_VERSION
)
211 def _init_exts_from_xml(xml
):
212 """ Walk the Vulkan XML and fill out extra extension information. """
217 for ext
in EXTENSIONS
:
218 ext_name_map
[ext
.name
] = ext
220 for ext_elem
in xml
.findall('.extensions/extension'):
221 ext_name
= ext_elem
.attrib
['name']
222 if ext_name
not in ext_name_map
:
225 ext
= ext_name_map
[ext_name
]
226 ext
.type = ext_elem
.attrib
['type']
227 ext
.promotedto
= ext_elem
.attrib
.get('promotedto', None)
229 ext
.requires
= ext_elem
.attrib
['requires'].split(',')
234 if ext
.type == 'instance':
235 check
= 'instance->enabled_extensions.{}'.format(ext
.name
[3:])
236 if ext
.promotedto
is not None:
237 # the xml contains values like VK_VERSION_1_1, but we need to
238 # translate them to VK_API_VERSION_1_1 for the apiVersion check
239 api_ver
= ext
.promotedto
.replace('VK_VER', 'VK_API_VER')
240 check
= '({} || instance->apiVersion >= {})'.format(check
, api_ver
)
244 for dep
in ext
.requires
:
245 deps |
= extra_deps(ext_name_map
[dep
])
249 for ext
in EXTENSIONS
:
250 if ext
.type == 'device':
251 for dep
in extra_deps(ext
):
252 ext
.enable
+= ' && ' + dep
254 _TEMPLATE_H
= Template(COPYRIGHT
+ """
255 #ifndef RADV_EXTENSIONS_H
256 #define RADV_EXTENSIONS_H
259 RADV_INSTANCE_EXTENSION_COUNT = ${len(instance_extensions)},
260 RADV_DEVICE_EXTENSION_COUNT = ${len(device_extensions)},
263 struct radv_instance_extension_table {
265 bool extensions[RADV_INSTANCE_EXTENSION_COUNT];
267 %for ext in instance_extensions:
268 bool ${ext.name[3:]};
274 struct radv_device_extension_table {
276 bool extensions[RADV_DEVICE_EXTENSION_COUNT];
278 %for ext in device_extensions:
279 bool ${ext.name[3:]};
285 extern const VkExtensionProperties radv_instance_extensions[RADV_INSTANCE_EXTENSION_COUNT];
286 extern const VkExtensionProperties radv_device_extensions[RADV_DEVICE_EXTENSION_COUNT];
287 extern const struct radv_instance_extension_table radv_supported_instance_extensions;
290 struct radv_physical_device;
292 void radv_fill_device_extension_table(const struct radv_physical_device *device,
293 struct radv_device_extension_table* table);
297 _TEMPLATE_C
= Template(COPYRIGHT
+ """
298 #include "radv_private.h"
302 /* Convert the VK_USE_PLATFORM_* defines to booleans */
303 %for platform in ['ANDROID_KHR', 'WAYLAND_KHR', 'XCB_KHR', 'XLIB_KHR', 'DISPLAY_KHR', 'XLIB_XRANDR_EXT']:
304 #ifdef VK_USE_PLATFORM_${platform}
305 # undef VK_USE_PLATFORM_${platform}
306 # define VK_USE_PLATFORM_${platform} true
308 # define VK_USE_PLATFORM_${platform} false
312 /* And ANDROID too */
315 # define ANDROID true
317 # define ANDROID false
320 #define RADV_HAS_SURFACE (VK_USE_PLATFORM_WAYLAND_KHR || \\
321 VK_USE_PLATFORM_XCB_KHR || \\
322 VK_USE_PLATFORM_XLIB_KHR || \\
323 VK_USE_PLATFORM_DISPLAY_KHR)
326 const VkExtensionProperties radv_instance_extensions[RADV_INSTANCE_EXTENSION_COUNT] = {
327 %for ext in instance_extensions:
328 {"${ext.name}", ${ext.ext_version}},
332 const VkExtensionProperties radv_device_extensions[RADV_DEVICE_EXTENSION_COUNT] = {
333 %for ext in device_extensions:
334 {"${ext.name}", ${ext.ext_version}},
338 const struct radv_instance_extension_table radv_supported_instance_extensions = {
339 %for ext in instance_extensions:
340 .${ext.name[3:]} = ${ext.enable},
344 void radv_fill_device_extension_table(const struct radv_physical_device *device,
345 struct radv_device_extension_table* table)
347 const struct radv_instance *instance = device->instance;
348 %for ext in device_extensions:
349 table->${ext.name[3:]} = ${ext.enable};
353 VkResult radv_EnumerateInstanceVersion(
354 uint32_t* pApiVersion)
356 *pApiVersion = ${MAX_API_VERSION.c_vk_version()};
361 radv_physical_device_api_version(struct radv_physical_device *dev)
363 uint32_t override = vk_get_version_override();
364 uint32_t version = VK_MAKE_VERSION(1, 0, 68);
365 if (dev->rad_info.has_syncobj_wait_for_submit)
366 version = ${MAX_API_VERSION.c_vk_version()};
368 return override ? MIN2(override, version) : version;
372 if __name__
== '__main__':
373 parser
= argparse
.ArgumentParser()
374 parser
.add_argument('--out-c', help='Output C file.', required
=True)
375 parser
.add_argument('--out-h', help='Output H file.', required
=True)
376 parser
.add_argument('--xml',
377 help='Vulkan API XML file.',
381 args
= parser
.parse_args()
383 for filename
in args
.xml_files
:
384 _init_exts_from_xml(filename
)
386 for ext
in EXTENSIONS
:
387 assert ext
.type == 'instance' or ext
.type == 'device'
390 'MAX_API_VERSION': MAX_API_VERSION
,
391 'instance_extensions': [e
for e
in EXTENSIONS
if e
.type == 'instance'],
392 'device_extensions': [e
for e
in EXTENSIONS
if e
.type == 'device'],
395 with
open(args
.out_c
, 'w') as f
:
396 f
.write(_TEMPLATE_C
.render(**template_env
))
397 with
open(args
.out_h
, 'w') as f
:
398 f
.write(_TEMPLATE_H
.render(**template_env
))