1 /* 2 * Copyright 2016 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 #ifndef LIBVULKAN_DRIVER_H 18 #define LIBVULKAN_DRIVER_H 1 19 20 #include <inttypes.h> 21 22 #include <bitset> 23 #include <type_traits> 24 25 #include <log/log.h> 26 27 #include <vulkan/vulkan.h> 28 #include <hardware/hwvulkan.h> 29 30 #include "api_gen.h" 31 #include "driver_gen.h" 32 #include "debug_report.h" 33 #include "swapchain.h" 34 35 namespace vulkan { 36 37 // This is here so that we can embed api::{Instance,Device}Data in 38 // driver::{Instance,Device}Data to avoid pointer chasing. They are 39 // considered opaque to the driver layer. 40 namespace api { 41 42 struct InstanceData { 43 InstanceDispatchTable dispatch; 44 45 // LayerChain::ActiveLayer array 46 void* layers; 47 uint32_t layer_count; 48 49 // debug.vulkan.enable_callback 50 PFN_vkDestroyDebugReportCallbackEXT destroy_debug_callback; 51 VkDebugReportCallbackEXT debug_callback; 52 }; 53 54 struct DeviceData { 55 DeviceDispatchTable dispatch; 56 }; 57 58 } // namespace api 59 60 namespace driver { 61 62 VK_DEFINE_HANDLE(InstanceDispatchable) 63 VK_DEFINE_HANDLE(DeviceDispatchable) 64 65 struct InstanceData { 66 explicit InstanceData(const VkAllocationCallbacks& alloc) 67 : opaque_api_data(), 68 allocator(alloc), 69 driver(), 70 get_device_proc_addr(nullptr) { 71 hook_extensions.set(ProcHook::EXTENSION_CORE); 72 } 73 74 api::InstanceData opaque_api_data; 75 76 const VkAllocationCallbacks allocator; 77 78 std::bitset<ProcHook::EXTENSION_COUNT> hook_extensions; 79 80 InstanceDriverTable driver; 81 PFN_vkGetDeviceProcAddr get_device_proc_addr; 82 83 DebugReportCallbackList debug_report_callbacks; 84 }; 85 86 struct DeviceData { 87 DeviceData(const VkAllocationCallbacks& alloc, 88 const DebugReportCallbackList& debug_report_callbacks_) 89 : opaque_api_data(), 90 allocator(alloc), 91 debug_report_callbacks(debug_report_callbacks_), 92 driver() { 93 hook_extensions.set(ProcHook::EXTENSION_CORE); 94 } 95 96 api::DeviceData opaque_api_data; 97 98 const VkAllocationCallbacks allocator; 99 const DebugReportCallbackList& debug_report_callbacks; 100 101 std::bitset<ProcHook::EXTENSION_COUNT> hook_extensions; 102 103 VkDevice driver_device; 104 DeviceDriverTable driver; 105 uint32_t driver_version; 106 }; 107 108 bool Debuggable(); 109 bool OpenHAL(); 110 const VkAllocationCallbacks& GetDefaultAllocator(); 111 112 bool QueryPresentationProperties( 113 VkPhysicalDevice physicalDevice, 114 VkPhysicalDevicePresentationPropertiesANDROID *presentation_properties); 115 116 // clang-format off 117 VKAPI_ATTR PFN_vkVoidFunction GetInstanceProcAddr(VkInstance instance, const char* pName); 118 VKAPI_ATTR PFN_vkVoidFunction GetDeviceProcAddr(VkDevice device, const char* pName); 119 VKAPI_ATTR VkResult EnumerateInstanceExtensionProperties(const char* pLayerName, uint32_t* pPropertyCount, VkExtensionProperties* pProperties); 120 121 VKAPI_ATTR VkResult EnumerateDeviceExtensionProperties(VkPhysicalDevice physicalDevice, const char* pLayerName, uint32_t* pPropertyCount, VkExtensionProperties* pProperties); 122 123 VKAPI_ATTR VkResult CreateInstance(const VkInstanceCreateInfo* pCreateInfo, const VkAllocationCallbacks* pAllocator, VkInstance* pInstance); 124 VKAPI_ATTR void DestroyInstance(VkInstance instance, const VkAllocationCallbacks* pAllocator); 125 VKAPI_ATTR VkResult CreateDevice(VkPhysicalDevice physicalDevice, const VkDeviceCreateInfo* pCreateInfo, const VkAllocationCallbacks* pAllocator, VkDevice* pDevice); 126 VKAPI_ATTR void DestroyDevice(VkDevice device, const VkAllocationCallbacks* pAllocator); 127 128 VKAPI_ATTR VkResult EnumeratePhysicalDevices(VkInstance instance, uint32_t* pPhysicalDeviceCount, VkPhysicalDevice* pPhysicalDevices); 129 VKAPI_ATTR VkResult EnumeratePhysicalDeviceGroups(VkInstance instance, uint32_t* pPhysicalDeviceGroupCount, VkPhysicalDeviceGroupProperties* pPhysicalDeviceGroupProperties); 130 131 VKAPI_ATTR void GetDeviceQueue(VkDevice device, uint32_t queueFamilyIndex, uint32_t queueIndex, VkQueue* pQueue); 132 VKAPI_ATTR void GetDeviceQueue2(VkDevice device, const VkDeviceQueueInfo2* pQueueInfo, VkQueue* pQueue); 133 VKAPI_ATTR VkResult AllocateCommandBuffers(VkDevice device, const VkCommandBufferAllocateInfo* pAllocateInfo, VkCommandBuffer* pCommandBuffers); 134 // clang-format on 135 136 template <typename DispatchableType> 137 void StaticAssertDispatchable(DispatchableType) { 138 static_assert( 139 std::is_same<DispatchableType, VkInstance>::value || 140 std::is_same<DispatchableType, VkPhysicalDevice>::value || 141 std::is_same<DispatchableType, VkDevice>::value || 142 std::is_same<DispatchableType, InstanceDispatchable>::value || 143 std::is_same<DispatchableType, VkQueue>::value || 144 std::is_same<DispatchableType, VkCommandBuffer>::value || 145 std::is_same<DispatchableType, DeviceDispatchable>::value, 146 "unrecognized dispatchable type"); 147 } 148 149 template <typename DispatchableType> 150 bool SetDataInternal(DispatchableType dispatchable, const void* data) { 151 StaticAssertDispatchable(dispatchable); 152 153 hwvulkan_dispatch_t* dispatch = 154 reinterpret_cast<hwvulkan_dispatch_t*>(dispatchable); 155 // must be magic or already set 156 if (dispatch->magic != HWVULKAN_DISPATCH_MAGIC && dispatch->vtbl != data) { 157 ALOGE("invalid dispatchable object magic 0x%" PRIxPTR, dispatch->magic); 158 return false; 159 } 160 161 dispatch->vtbl = data; 162 163 return true; 164 } 165 166 template <typename DispatchableType> 167 void* GetDataInternal(DispatchableType dispatchable) { 168 StaticAssertDispatchable(dispatchable); 169 170 const hwvulkan_dispatch_t* dispatch = 171 reinterpret_cast<const hwvulkan_dispatch_t*>(dispatchable); 172 173 return const_cast<void*>(dispatch->vtbl); 174 } 175 176 inline bool SetData(VkInstance instance, const InstanceData& data) { 177 return SetDataInternal(instance, &data); 178 } 179 180 inline bool SetData(VkPhysicalDevice physical_dev, const InstanceData& data) { 181 return SetDataInternal(physical_dev, &data); 182 } 183 184 inline bool SetData(InstanceDispatchable dispatchable, 185 const InstanceData& data) { 186 return SetDataInternal(dispatchable, &data); 187 } 188 189 inline bool SetData(VkDevice dev, const DeviceData& data) { 190 return SetDataInternal(dev, &data); 191 } 192 193 inline bool SetData(VkQueue queue, const DeviceData& data) { 194 return SetDataInternal(queue, &data); 195 } 196 197 inline bool SetData(VkCommandBuffer cmd, const DeviceData& data) { 198 return SetDataInternal(cmd, &data); 199 } 200 201 inline bool SetData(DeviceDispatchable dispatchable, const DeviceData& data) { 202 return SetDataInternal(dispatchable, &data); 203 } 204 205 inline InstanceData& GetData(VkInstance instance) { 206 return *reinterpret_cast<InstanceData*>(GetDataInternal(instance)); 207 } 208 209 inline InstanceData& GetData(VkPhysicalDevice physical_dev) { 210 return *reinterpret_cast<InstanceData*>(GetDataInternal(physical_dev)); 211 } 212 213 inline InstanceData& GetData(InstanceDispatchable dispatchable) { 214 return *reinterpret_cast<InstanceData*>(GetDataInternal(dispatchable)); 215 } 216 217 inline DeviceData& GetData(VkDevice dev) { 218 return *reinterpret_cast<DeviceData*>(GetDataInternal(dev)); 219 } 220 221 inline DeviceData& GetData(VkQueue queue) { 222 return *reinterpret_cast<DeviceData*>(GetDataInternal(queue)); 223 } 224 225 inline DeviceData& GetData(VkCommandBuffer cmd) { 226 return *reinterpret_cast<DeviceData*>(GetDataInternal(cmd)); 227 } 228 229 inline DeviceData& GetData(DeviceDispatchable dispatchable) { 230 return *reinterpret_cast<DeviceData*>(GetDataInternal(dispatchable)); 231 } 232 233 template <typename DispatchableType> 234 const DebugReportLogger Logger(DispatchableType dispatchable) { 235 return DebugReportLogger(GetData(dispatchable).debug_report_callbacks); 236 } 237 238 } // namespace driver 239 } // namespace vulkan 240 241 #endif // LIBVULKAN_DRIVER_H 242