atagen

monolith

public
Star0
Watch0
9c83f07146b1a23cd3041447d1296410cfbf65d6
1
ssh://brewery@pls.lobotomise.me:33/atagen/monolith.git

Blame: crates/render-vk/src/device.rs

824bf02b6e55atagen2026-10-16 09:15 UTC1
use crate::Error;
824bf02b6e55atagen2026-10-16 09:15 UTC2
use ash::vk;
824bf02b6e55atagen2026-10-16 09:15 UTC3
use gpu_allocator::vulkan::{Allocator, AllocatorCreateDesc};
824bf02b6e55atagen2026-10-16 09:15 UTC4
use std::sync::Mutex;
824bf02b6e55atagen2026-10-16 09:15 UTC5
824bf02b6e55atagen2026-10-16 09:15 UTC6
/// Everything that must outlive every Vulkan object the renderer hands out.
824bf02b6e55atagen2026-10-16 09:15 UTC7
/// Fields drop in declaration order, so the allocator frees its memory before
824bf02b6e55atagen2026-10-16 09:15 UTC8
/// the device is destroyed.
824bf02b6e55atagen2026-10-16 09:15 UTC9
pub(crate) struct Shared {
824bf02b6e55atagen2026-10-16 09:15 UTC10
    pub allocator: Mutex<Allocator>,
824bf02b6e55atagen2026-10-16 09:15 UTC11
    pub device: Device,
824bf02b6e55atagen2026-10-16 09:15 UTC12
}
824bf02b6e55atagen2026-10-16 09:15 UTC13
7de49c2aa70batagen2026-10-16 09:27 UTC14
/// Loaders for the extensions that dmabuf import, export and fence export
7de49c2aa70batagen2026-10-16 09:27 UTC15
/// need. Absent when the device lacks any of them.
7de49c2aa70batagen2026-10-16 09:27 UTC16
pub(crate) struct DmabufExt {
7de49c2aa70batagen2026-10-16 09:27 UTC17
    pub memory_fd: ash::khr::external_memory_fd::Device,
7de49c2aa70batagen2026-10-16 09:27 UTC18
    pub fence_fd: ash::khr::external_fence_fd::Device,
7de49c2aa70batagen2026-10-16 09:27 UTC19
    pub modifier: ash::ext::image_drm_format_modifier::Device,
7de49c2aa70batagen2026-10-16 09:27 UTC20
}
7de49c2aa70batagen2026-10-16 09:27 UTC21
7de49c2aa70batagen2026-10-16 09:27 UTC22
const DMABUF_EXTENSIONS: [&std::ffi::CStr; 5] = [
7de49c2aa70batagen2026-10-16 09:27 UTC23
    ash::khr::external_memory_fd::NAME,
7de49c2aa70batagen2026-10-16 09:27 UTC24
    ash::ext::external_memory_dma_buf::NAME,
7de49c2aa70batagen2026-10-16 09:27 UTC25
    ash::ext::image_drm_format_modifier::NAME,
7de49c2aa70batagen2026-10-16 09:27 UTC26
    ash::ext::queue_family_foreign::NAME,
7de49c2aa70batagen2026-10-16 09:27 UTC27
    ash::khr::external_fence_fd::NAME,
7de49c2aa70batagen2026-10-16 09:27 UTC28
];
7de49c2aa70batagen2026-10-16 09:27 UTC29
824bf02b6e55atagen2026-10-16 09:15 UTC30
pub(crate) struct Device {
824bf02b6e55atagen2026-10-16 09:15 UTC31
    pub _entry: ash::Entry,
824bf02b6e55atagen2026-10-16 09:15 UTC32
    pub instance: ash::Instance,
824bf02b6e55atagen2026-10-16 09:15 UTC33
    pub physical: vk::PhysicalDevice,
824bf02b6e55atagen2026-10-16 09:15 UTC34
    pub device: ash::Device,
824bf02b6e55atagen2026-10-16 09:15 UTC35
    pub queue: Mutex<vk::Queue>,
824bf02b6e55atagen2026-10-16 09:15 UTC36
    pub queue_family: u32,
824bf02b6e55atagen2026-10-16 09:15 UTC37
    pub push_descriptor: ash::khr::push_descriptor::Device,
7de49c2aa70batagen2026-10-16 09:27 UTC38
    pub dmabuf: Option<DmabufExt>,
824bf02b6e55atagen2026-10-16 09:15 UTC39
    pub name: String,
824bf02b6e55atagen2026-10-16 09:15 UTC40
}
824bf02b6e55atagen2026-10-16 09:15 UTC41
824bf02b6e55atagen2026-10-16 09:15 UTC42
impl Drop for Device {
824bf02b6e55atagen2026-10-16 09:15 UTC43
    fn drop(&mut self) {
824bf02b6e55atagen2026-10-16 09:15 UTC44
        unsafe {
824bf02b6e55atagen2026-10-16 09:15 UTC45
            let _ = self.device.device_wait_idle();
824bf02b6e55atagen2026-10-16 09:15 UTC46
            self.device.destroy_device(None);
824bf02b6e55atagen2026-10-16 09:15 UTC47
            self.instance.destroy_instance(None);
824bf02b6e55atagen2026-10-16 09:15 UTC48
        }
824bf02b6e55atagen2026-10-16 09:15 UTC49
    }
824bf02b6e55atagen2026-10-16 09:15 UTC50
}
824bf02b6e55atagen2026-10-16 09:15 UTC51
824bf02b6e55atagen2026-10-16 09:15 UTC52
impl Shared {
824bf02b6e55atagen2026-10-16 09:15 UTC53
    /// Opens the first suitable device, or the one whose name contains
f27fa4c2ade9atagen2026-10-16 12:59 UTC54
    /// `MONOLITH_VK_DEVICE` when that is set. With `node`, only the device
f27fa4c2ade9atagen2026-10-16 12:59 UTC55
    /// behind that DRM device number qualifies.
f27fa4c2ade9atagen2026-10-16 12:59 UTC56
    pub fn new(node: Option<u64>) -> Result<Self, Error> {
824bf02b6e55atagen2026-10-16 09:15 UTC57
        let entry = unsafe { ash::Entry::load()? };
824bf02b6e55atagen2026-10-16 09:15 UTC58
        let app = vk::ApplicationInfo::default()
824bf02b6e55atagen2026-10-16 09:15 UTC59
            .application_name(c"monolith")
824bf02b6e55atagen2026-10-16 09:15 UTC60
            .engine_name(c"monolith")
824bf02b6e55atagen2026-10-16 09:15 UTC61
            .api_version(vk::API_VERSION_1_3);
824bf02b6e55atagen2026-10-16 09:15 UTC62
        let instance = unsafe {
824bf02b6e55atagen2026-10-16 09:15 UTC63
            entry.create_instance(
824bf02b6e55atagen2026-10-16 09:15 UTC64
                &vk::InstanceCreateInfo::default().application_info(&app),
824bf02b6e55atagen2026-10-16 09:15 UTC65
                None,
824bf02b6e55atagen2026-10-16 09:15 UTC66
            )?
824bf02b6e55atagen2026-10-16 09:15 UTC67
        };
824bf02b6e55atagen2026-10-16 09:15 UTC68
        let wanted = std::env::var("MONOLITH_VK_DEVICE").ok();
f27fa4c2ade9atagen2026-10-16 12:59 UTC69
        let picked = unsafe { pick_physical(&instance, wanted.as_deref(), node) };
824bf02b6e55atagen2026-10-16 09:15 UTC70
        let Some((physical, queue_family, name)) = picked else {
824bf02b6e55atagen2026-10-16 09:15 UTC71
            unsafe { instance.destroy_instance(None) };
824bf02b6e55atagen2026-10-16 09:15 UTC72
            return Err(Error::NoSuitableDevice);
824bf02b6e55atagen2026-10-16 09:15 UTC73
        };
824bf02b6e55atagen2026-10-16 09:15 UTC74
        let priorities = [1.0];
824bf02b6e55atagen2026-10-16 09:15 UTC75
        let queues = [vk::DeviceQueueCreateInfo::default()
824bf02b6e55atagen2026-10-16 09:15 UTC76
            .queue_family_index(queue_family)
824bf02b6e55atagen2026-10-16 09:15 UTC77
            .queue_priorities(&priorities)];
7de49c2aa70batagen2026-10-16 09:27 UTC78
        let available: Vec<_> = unsafe { instance.enumerate_device_extension_properties(physical) }
7de49c2aa70batagen2026-10-16 09:27 UTC79
            .unwrap_or_default()
7de49c2aa70batagen2026-10-16 09:27 UTC80
            .iter()
7de49c2aa70batagen2026-10-16 09:27 UTC81
            .filter_map(|e| e.extension_name_as_c_str().ok().map(ToOwned::to_owned))
7de49c2aa70batagen2026-10-16 09:27 UTC82
            .collect();
7de49c2aa70batagen2026-10-16 09:27 UTC83
        let has_dmabuf = DMABUF_EXTENSIONS
7de49c2aa70batagen2026-10-16 09:27 UTC84
            .iter()
7de49c2aa70batagen2026-10-16 09:27 UTC85
            .all(|n| available.iter().any(|a| a.as_c_str() == *n));
7de49c2aa70batagen2026-10-16 09:27 UTC86
        let mut extensions = vec![ash::khr::push_descriptor::NAME.as_ptr()];
7de49c2aa70batagen2026-10-16 09:27 UTC87
        if has_dmabuf {
7de49c2aa70batagen2026-10-16 09:27 UTC88
            extensions.extend(DMABUF_EXTENSIONS.iter().map(|n| n.as_ptr()));
7de49c2aa70batagen2026-10-16 09:27 UTC89
        }
824bf02b6e55atagen2026-10-16 09:15 UTC90
        let mut features13 = vk::PhysicalDeviceVulkan13Features::default()
824bf02b6e55atagen2026-10-16 09:15 UTC91
            .dynamic_rendering(true)
824bf02b6e55atagen2026-10-16 09:15 UTC92
            .synchronization2(true);
824bf02b6e55atagen2026-10-16 09:15 UTC93
        let info = vk::DeviceCreateInfo::default()
824bf02b6e55atagen2026-10-16 09:15 UTC94
            .queue_create_infos(&queues)
824bf02b6e55atagen2026-10-16 09:15 UTC95
            .enabled_extension_names(&extensions)
824bf02b6e55atagen2026-10-16 09:15 UTC96
            .push_next(&mut features13);
824bf02b6e55atagen2026-10-16 09:15 UTC97
        let device = match unsafe { instance.create_device(physical, &info, None) } {
824bf02b6e55atagen2026-10-16 09:15 UTC98
            Ok(d) => d,
824bf02b6e55atagen2026-10-16 09:15 UTC99
            Err(e) => {
824bf02b6e55atagen2026-10-16 09:15 UTC100
                unsafe { instance.destroy_instance(None) };
824bf02b6e55atagen2026-10-16 09:15 UTC101
                return Err(e.into());
824bf02b6e55atagen2026-10-16 09:15 UTC102
            }
824bf02b6e55atagen2026-10-16 09:15 UTC103
        };
824bf02b6e55atagen2026-10-16 09:15 UTC104
        let queue = unsafe { device.get_device_queue(queue_family, 0) };
824bf02b6e55atagen2026-10-16 09:15 UTC105
        let push_descriptor = ash::khr::push_descriptor::Device::new(&instance, &device);
7de49c2aa70batagen2026-10-16 09:27 UTC106
        let dmabuf = has_dmabuf.then(|| DmabufExt {
7de49c2aa70batagen2026-10-16 09:27 UTC107
            memory_fd: ash::khr::external_memory_fd::Device::new(&instance, &device),
7de49c2aa70batagen2026-10-16 09:27 UTC108
            fence_fd: ash::khr::external_fence_fd::Device::new(&instance, &device),
7de49c2aa70batagen2026-10-16 09:27 UTC109
            modifier: ash::ext::image_drm_format_modifier::Device::new(&instance, &device),
7de49c2aa70batagen2026-10-16 09:27 UTC110
        });
824bf02b6e55atagen2026-10-16 09:15 UTC111
        let allocator = Allocator::new(&AllocatorCreateDesc {
824bf02b6e55atagen2026-10-16 09:15 UTC112
            instance: instance.clone(),
824bf02b6e55atagen2026-10-16 09:15 UTC113
            device: device.clone(),
824bf02b6e55atagen2026-10-16 09:15 UTC114
            physical_device: physical,
824bf02b6e55atagen2026-10-16 09:15 UTC115
            debug_settings: Default::default(),
824bf02b6e55atagen2026-10-16 09:15 UTC116
            buffer_device_address: false,
824bf02b6e55atagen2026-10-16 09:15 UTC117
            allocation_sizes: Default::default(),
824bf02b6e55atagen2026-10-16 09:15 UTC118
        });
824bf02b6e55atagen2026-10-16 09:15 UTC119
        let device = Device {
824bf02b6e55atagen2026-10-16 09:15 UTC120
            _entry: entry,
824bf02b6e55atagen2026-10-16 09:15 UTC121
            instance,
824bf02b6e55atagen2026-10-16 09:15 UTC122
            physical,
824bf02b6e55atagen2026-10-16 09:15 UTC123
            device,
824bf02b6e55atagen2026-10-16 09:15 UTC124
            queue: Mutex::new(queue),
824bf02b6e55atagen2026-10-16 09:15 UTC125
            queue_family,
824bf02b6e55atagen2026-10-16 09:15 UTC126
            push_descriptor,
7de49c2aa70batagen2026-10-16 09:27 UTC127
            dmabuf,
824bf02b6e55atagen2026-10-16 09:15 UTC128
            name,
824bf02b6e55atagen2026-10-16 09:15 UTC129
        };
824bf02b6e55atagen2026-10-16 09:15 UTC130
        Ok(Self {
824bf02b6e55atagen2026-10-16 09:15 UTC131
            allocator: Mutex::new(allocator?),
824bf02b6e55atagen2026-10-16 09:15 UTC132
            device,
824bf02b6e55atagen2026-10-16 09:15 UTC133
        })
824bf02b6e55atagen2026-10-16 09:15 UTC134
    }
824bf02b6e55atagen2026-10-16 09:15 UTC135
}
824bf02b6e55atagen2026-10-16 09:15 UTC136
f27fa4c2ade9atagen2026-10-16 12:59 UTC137
/// Whether `physical` is the device behind DRM device number `node`, as its
f27fa4c2ade9atagen2026-10-16 12:59 UTC138
/// primary or render node.
f27fa4c2ade9atagen2026-10-16 12:59 UTC139
unsafe fn serves_node(instance: &ash::Instance, physical: vk::PhysicalDevice, node: u64) -> bool {
f27fa4c2ade9atagen2026-10-16 12:59 UTC140
    let mut drm = vk::PhysicalDeviceDrmPropertiesEXT::default();
f27fa4c2ade9atagen2026-10-16 12:59 UTC141
    let mut props = vk::PhysicalDeviceProperties2::default().push_next(&mut drm);
f27fa4c2ade9atagen2026-10-16 12:59 UTC142
    unsafe { instance.get_physical_device_properties2(physical, &mut props) };
f27fa4c2ade9atagen2026-10-16 12:59 UTC143
    let (major, minor) = (
f27fa4c2ade9atagen2026-10-16 12:59 UTC144
        rustix::fs::major(node) as i64,
f27fa4c2ade9atagen2026-10-16 12:59 UTC145
        rustix::fs::minor(node) as i64,
f27fa4c2ade9atagen2026-10-16 12:59 UTC146
    );
f27fa4c2ade9atagen2026-10-16 12:59 UTC147
    (drm.has_primary == vk::TRUE && (drm.primary_major, drm.primary_minor) == (major, minor))
f27fa4c2ade9atagen2026-10-16 12:59 UTC148
        || (drm.has_render == vk::TRUE && (drm.render_major, drm.render_minor) == (major, minor))
f27fa4c2ade9atagen2026-10-16 12:59 UTC149
}
f27fa4c2ade9atagen2026-10-16 12:59 UTC150
824bf02b6e55atagen2026-10-16 09:15 UTC151
unsafe fn pick_physical(
824bf02b6e55atagen2026-10-16 09:15 UTC152
    instance: &ash::Instance,
824bf02b6e55atagen2026-10-16 09:15 UTC153
    wanted: Option<&str>,
f27fa4c2ade9atagen2026-10-16 12:59 UTC154
    node: Option<u64>,
824bf02b6e55atagen2026-10-16 09:15 UTC155
) -> Option<(vk::PhysicalDevice, u32, String)> {
824bf02b6e55atagen2026-10-16 09:15 UTC156
    let devices = unsafe { instance.enumerate_physical_devices() }.ok()?;
824bf02b6e55atagen2026-10-16 09:15 UTC157
    let mut candidates = Vec::new();
824bf02b6e55atagen2026-10-16 09:15 UTC158
    for physical in devices {
824bf02b6e55atagen2026-10-16 09:15 UTC159
        let props = unsafe { instance.get_physical_device_properties(physical) };
824bf02b6e55atagen2026-10-16 09:15 UTC160
        if props.api_version < vk::API_VERSION_1_3 {
824bf02b6e55atagen2026-10-16 09:15 UTC161
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC162
        }
824bf02b6e55atagen2026-10-16 09:15 UTC163
        let name = props
824bf02b6e55atagen2026-10-16 09:15 UTC164
            .device_name_as_c_str()
824bf02b6e55atagen2026-10-16 09:15 UTC165
            .unwrap_or(c"unknown")
824bf02b6e55atagen2026-10-16 09:15 UTC166
            .to_string_lossy()
824bf02b6e55atagen2026-10-16 09:15 UTC167
            .into_owned();
824bf02b6e55atagen2026-10-16 09:15 UTC168
        if wanted.is_some_and(|w| !name.contains(w)) {
824bf02b6e55atagen2026-10-16 09:15 UTC169
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC170
        }
824bf02b6e55atagen2026-10-16 09:15 UTC171
        let mut f13 = vk::PhysicalDeviceVulkan13Features::default();
824bf02b6e55atagen2026-10-16 09:15 UTC172
        let mut f2 = vk::PhysicalDeviceFeatures2::default().push_next(&mut f13);
824bf02b6e55atagen2026-10-16 09:15 UTC173
        unsafe { instance.get_physical_device_features2(physical, &mut f2) };
824bf02b6e55atagen2026-10-16 09:15 UTC174
        if f13.dynamic_rendering == vk::FALSE || f13.synchronization2 == vk::FALSE {
824bf02b6e55atagen2026-10-16 09:15 UTC175
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC176
        }
f27fa4c2ade9atagen2026-10-16 12:59 UTC177
        let extensions =
f27fa4c2ade9atagen2026-10-16 12:59 UTC178
            unsafe { instance.enumerate_device_extension_properties(physical) }.unwrap_or_default();
f27fa4c2ade9atagen2026-10-16 12:59 UTC179
        let has = |n: &std::ffi::CStr| {
f27fa4c2ade9atagen2026-10-16 12:59 UTC180
            extensions
f27fa4c2ade9atagen2026-10-16 12:59 UTC181
                .iter()
f27fa4c2ade9atagen2026-10-16 12:59 UTC182
                .any(|e| e.extension_name_as_c_str().ok() == Some(n))
f27fa4c2ade9atagen2026-10-16 12:59 UTC183
        };
f27fa4c2ade9atagen2026-10-16 12:59 UTC184
        if !has(ash::khr::push_descriptor::NAME) {
f27fa4c2ade9atagen2026-10-16 12:59 UTC185
            continue;
f27fa4c2ade9atagen2026-10-16 12:59 UTC186
        }
f27fa4c2ade9atagen2026-10-16 12:59 UTC187
        if let Some(node) = node
f27fa4c2ade9atagen2026-10-16 12:59 UTC188
            && !(has(ash::ext::physical_device_drm::NAME)
f27fa4c2ade9atagen2026-10-16 12:59 UTC189
                && unsafe { serves_node(instance, physical, node) })
f27fa4c2ade9atagen2026-10-16 12:59 UTC190
        {
824bf02b6e55atagen2026-10-16 09:15 UTC191
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC192
        }
824bf02b6e55atagen2026-10-16 09:15 UTC193
        let families = unsafe { instance.get_physical_device_queue_family_properties(physical) };
824bf02b6e55atagen2026-10-16 09:15 UTC194
        let Some(family) = families
824bf02b6e55atagen2026-10-16 09:15 UTC195
            .iter()
824bf02b6e55atagen2026-10-16 09:15 UTC196
            .position(|f| f.queue_flags.contains(vk::QueueFlags::GRAPHICS))
824bf02b6e55atagen2026-10-16 09:15 UTC197
        else {
824bf02b6e55atagen2026-10-16 09:15 UTC198
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC199
        };
824bf02b6e55atagen2026-10-16 09:15 UTC200
        let rank = match props.device_type {
824bf02b6e55atagen2026-10-16 09:15 UTC201
            vk::PhysicalDeviceType::DISCRETE_GPU => 0,
824bf02b6e55atagen2026-10-16 09:15 UTC202
            vk::PhysicalDeviceType::INTEGRATED_GPU => 1,
824bf02b6e55atagen2026-10-16 09:15 UTC203
            vk::PhysicalDeviceType::VIRTUAL_GPU => 2,
824bf02b6e55atagen2026-10-16 09:15 UTC204
            _ => 3,
824bf02b6e55atagen2026-10-16 09:15 UTC205
        };
824bf02b6e55atagen2026-10-16 09:15 UTC206
        candidates.push((rank, physical, family as u32, name));
824bf02b6e55atagen2026-10-16 09:15 UTC207
    }
824bf02b6e55atagen2026-10-16 09:15 UTC208
    candidates.sort_by_key(|c| c.0);
824bf02b6e55atagen2026-10-16 09:15 UTC209
    candidates.into_iter().next().map(|(_, p, f, n)| (p, f, n))
824bf02b6e55atagen2026-10-16 09:15 UTC210
}