atagen

monolith

public
Star0
Watch0
e9ef7cdfe55ae04885f11cd22b81e4249b34a788
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,
d5eca1c82213atagen2026-10-16 13:56 UTC40
    /// Signalled fences kept for reuse, see `FenceInner`.
d5eca1c82213atagen2026-10-16 13:56 UTC41
    pub spare_fences: Mutex<Vec<vk::Fence>>,
824bf02b6e55atagen2026-10-16 09:15 UTC42
}
824bf02b6e55atagen2026-10-16 09:15 UTC43
824bf02b6e55atagen2026-10-16 09:15 UTC44
impl Drop for Device {
824bf02b6e55atagen2026-10-16 09:15 UTC45
    fn drop(&mut self) {
824bf02b6e55atagen2026-10-16 09:15 UTC46
        unsafe {
824bf02b6e55atagen2026-10-16 09:15 UTC47
            let _ = self.device.device_wait_idle();
d5eca1c82213atagen2026-10-16 13:56 UTC48
            for f in self
d5eca1c82213atagen2026-10-16 13:56 UTC49
                .spare_fences
d5eca1c82213atagen2026-10-16 13:56 UTC50
                .get_mut()
d5eca1c82213atagen2026-10-16 13:56 UTC51
                .unwrap_or_else(|e| e.into_inner())
d5eca1c82213atagen2026-10-16 13:56 UTC52
                .drain(..)
d5eca1c82213atagen2026-10-16 13:56 UTC53
            {
d5eca1c82213atagen2026-10-16 13:56 UTC54
                self.device.destroy_fence(f, None);
d5eca1c82213atagen2026-10-16 13:56 UTC55
            }
824bf02b6e55atagen2026-10-16 09:15 UTC56
            self.device.destroy_device(None);
824bf02b6e55atagen2026-10-16 09:15 UTC57
            self.instance.destroy_instance(None);
824bf02b6e55atagen2026-10-16 09:15 UTC58
        }
824bf02b6e55atagen2026-10-16 09:15 UTC59
    }
824bf02b6e55atagen2026-10-16 09:15 UTC60
}
824bf02b6e55atagen2026-10-16 09:15 UTC61
824bf02b6e55atagen2026-10-16 09:15 UTC62
impl Shared {
824bf02b6e55atagen2026-10-16 09:15 UTC63
    /// Opens the first suitable device, or the one whose name contains
f27fa4c2ade9atagen2026-10-16 12:59 UTC64
    /// `MONOLITH_VK_DEVICE` when that is set. With `node`, only the device
f27fa4c2ade9atagen2026-10-16 12:59 UTC65
    /// behind that DRM device number qualifies.
f27fa4c2ade9atagen2026-10-16 12:59 UTC66
    pub fn new(node: Option<u64>) -> Result<Self, Error> {
824bf02b6e55atagen2026-10-16 09:15 UTC67
        let entry = unsafe { ash::Entry::load()? };
824bf02b6e55atagen2026-10-16 09:15 UTC68
        let app = vk::ApplicationInfo::default()
824bf02b6e55atagen2026-10-16 09:15 UTC69
            .application_name(c"monolith")
824bf02b6e55atagen2026-10-16 09:15 UTC70
            .engine_name(c"monolith")
824bf02b6e55atagen2026-10-16 09:15 UTC71
            .api_version(vk::API_VERSION_1_3);
824bf02b6e55atagen2026-10-16 09:15 UTC72
        let instance = unsafe {
824bf02b6e55atagen2026-10-16 09:15 UTC73
            entry.create_instance(
824bf02b6e55atagen2026-10-16 09:15 UTC74
                &vk::InstanceCreateInfo::default().application_info(&app),
824bf02b6e55atagen2026-10-16 09:15 UTC75
                None,
824bf02b6e55atagen2026-10-16 09:15 UTC76
            )?
824bf02b6e55atagen2026-10-16 09:15 UTC77
        };
824bf02b6e55atagen2026-10-16 09:15 UTC78
        let wanted = std::env::var("MONOLITH_VK_DEVICE").ok();
f27fa4c2ade9atagen2026-10-16 12:59 UTC79
        let picked = unsafe { pick_physical(&instance, wanted.as_deref(), node) };
824bf02b6e55atagen2026-10-16 09:15 UTC80
        let Some((physical, queue_family, name)) = picked else {
824bf02b6e55atagen2026-10-16 09:15 UTC81
            unsafe { instance.destroy_instance(None) };
824bf02b6e55atagen2026-10-16 09:15 UTC82
            return Err(Error::NoSuitableDevice);
824bf02b6e55atagen2026-10-16 09:15 UTC83
        };
824bf02b6e55atagen2026-10-16 09:15 UTC84
        let priorities = [1.0];
824bf02b6e55atagen2026-10-16 09:15 UTC85
        let queues = [vk::DeviceQueueCreateInfo::default()
824bf02b6e55atagen2026-10-16 09:15 UTC86
            .queue_family_index(queue_family)
824bf02b6e55atagen2026-10-16 09:15 UTC87
            .queue_priorities(&priorities)];
7de49c2aa70batagen2026-10-16 09:27 UTC88
        let available: Vec<_> = unsafe { instance.enumerate_device_extension_properties(physical) }
7de49c2aa70batagen2026-10-16 09:27 UTC89
            .unwrap_or_default()
7de49c2aa70batagen2026-10-16 09:27 UTC90
            .iter()
7de49c2aa70batagen2026-10-16 09:27 UTC91
            .filter_map(|e| e.extension_name_as_c_str().ok().map(ToOwned::to_owned))
7de49c2aa70batagen2026-10-16 09:27 UTC92
            .collect();
7de49c2aa70batagen2026-10-16 09:27 UTC93
        let has_dmabuf = DMABUF_EXTENSIONS
7de49c2aa70batagen2026-10-16 09:27 UTC94
            .iter()
7de49c2aa70batagen2026-10-16 09:27 UTC95
            .all(|n| available.iter().any(|a| a.as_c_str() == *n));
7de49c2aa70batagen2026-10-16 09:27 UTC96
        let mut extensions = vec![ash::khr::push_descriptor::NAME.as_ptr()];
7de49c2aa70batagen2026-10-16 09:27 UTC97
        if has_dmabuf {
7de49c2aa70batagen2026-10-16 09:27 UTC98
            extensions.extend(DMABUF_EXTENSIONS.iter().map(|n| n.as_ptr()));
7de49c2aa70batagen2026-10-16 09:27 UTC99
        }
824bf02b6e55atagen2026-10-16 09:15 UTC100
        let mut features13 = vk::PhysicalDeviceVulkan13Features::default()
824bf02b6e55atagen2026-10-16 09:15 UTC101
            .dynamic_rendering(true)
824bf02b6e55atagen2026-10-16 09:15 UTC102
            .synchronization2(true);
824bf02b6e55atagen2026-10-16 09:15 UTC103
        let info = vk::DeviceCreateInfo::default()
824bf02b6e55atagen2026-10-16 09:15 UTC104
            .queue_create_infos(&queues)
824bf02b6e55atagen2026-10-16 09:15 UTC105
            .enabled_extension_names(&extensions)
824bf02b6e55atagen2026-10-16 09:15 UTC106
            .push_next(&mut features13);
824bf02b6e55atagen2026-10-16 09:15 UTC107
        let device = match unsafe { instance.create_device(physical, &info, None) } {
824bf02b6e55atagen2026-10-16 09:15 UTC108
            Ok(d) => d,
824bf02b6e55atagen2026-10-16 09:15 UTC109
            Err(e) => {
824bf02b6e55atagen2026-10-16 09:15 UTC110
                unsafe { instance.destroy_instance(None) };
824bf02b6e55atagen2026-10-16 09:15 UTC111
                return Err(e.into());
824bf02b6e55atagen2026-10-16 09:15 UTC112
            }
824bf02b6e55atagen2026-10-16 09:15 UTC113
        };
824bf02b6e55atagen2026-10-16 09:15 UTC114
        let queue = unsafe { device.get_device_queue(queue_family, 0) };
824bf02b6e55atagen2026-10-16 09:15 UTC115
        let push_descriptor = ash::khr::push_descriptor::Device::new(&instance, &device);
7de49c2aa70batagen2026-10-16 09:27 UTC116
        let dmabuf = has_dmabuf.then(|| DmabufExt {
7de49c2aa70batagen2026-10-16 09:27 UTC117
            memory_fd: ash::khr::external_memory_fd::Device::new(&instance, &device),
7de49c2aa70batagen2026-10-16 09:27 UTC118
            fence_fd: ash::khr::external_fence_fd::Device::new(&instance, &device),
7de49c2aa70batagen2026-10-16 09:27 UTC119
            modifier: ash::ext::image_drm_format_modifier::Device::new(&instance, &device),
7de49c2aa70batagen2026-10-16 09:27 UTC120
        });
824bf02b6e55atagen2026-10-16 09:15 UTC121
        let allocator = Allocator::new(&AllocatorCreateDesc {
824bf02b6e55atagen2026-10-16 09:15 UTC122
            instance: instance.clone(),
824bf02b6e55atagen2026-10-16 09:15 UTC123
            device: device.clone(),
824bf02b6e55atagen2026-10-16 09:15 UTC124
            physical_device: physical,
824bf02b6e55atagen2026-10-16 09:15 UTC125
            debug_settings: Default::default(),
824bf02b6e55atagen2026-10-16 09:15 UTC126
            buffer_device_address: false,
824bf02b6e55atagen2026-10-16 09:15 UTC127
            allocation_sizes: Default::default(),
824bf02b6e55atagen2026-10-16 09:15 UTC128
        });
824bf02b6e55atagen2026-10-16 09:15 UTC129
        let device = Device {
824bf02b6e55atagen2026-10-16 09:15 UTC130
            _entry: entry,
824bf02b6e55atagen2026-10-16 09:15 UTC131
            instance,
824bf02b6e55atagen2026-10-16 09:15 UTC132
            physical,
824bf02b6e55atagen2026-10-16 09:15 UTC133
            device,
824bf02b6e55atagen2026-10-16 09:15 UTC134
            queue: Mutex::new(queue),
824bf02b6e55atagen2026-10-16 09:15 UTC135
            queue_family,
824bf02b6e55atagen2026-10-16 09:15 UTC136
            push_descriptor,
7de49c2aa70batagen2026-10-16 09:27 UTC137
            dmabuf,
824bf02b6e55atagen2026-10-16 09:15 UTC138
            name,
d5eca1c82213atagen2026-10-16 13:56 UTC139
            spare_fences: Mutex::new(Vec::new()),
824bf02b6e55atagen2026-10-16 09:15 UTC140
        };
824bf02b6e55atagen2026-10-16 09:15 UTC141
        Ok(Self {
824bf02b6e55atagen2026-10-16 09:15 UTC142
            allocator: Mutex::new(allocator?),
824bf02b6e55atagen2026-10-16 09:15 UTC143
            device,
824bf02b6e55atagen2026-10-16 09:15 UTC144
        })
824bf02b6e55atagen2026-10-16 09:15 UTC145
    }
824bf02b6e55atagen2026-10-16 09:15 UTC146
}
824bf02b6e55atagen2026-10-16 09:15 UTC147
f27fa4c2ade9atagen2026-10-16 12:59 UTC148
/// Whether `physical` is the device behind DRM device number `node`, as its
f27fa4c2ade9atagen2026-10-16 12:59 UTC149
/// primary or render node.
f27fa4c2ade9atagen2026-10-16 12:59 UTC150
unsafe fn serves_node(instance: &ash::Instance, physical: vk::PhysicalDevice, node: u64) -> bool {
f27fa4c2ade9atagen2026-10-16 12:59 UTC151
    let mut drm = vk::PhysicalDeviceDrmPropertiesEXT::default();
f27fa4c2ade9atagen2026-10-16 12:59 UTC152
    let mut props = vk::PhysicalDeviceProperties2::default().push_next(&mut drm);
f27fa4c2ade9atagen2026-10-16 12:59 UTC153
    unsafe { instance.get_physical_device_properties2(physical, &mut props) };
f27fa4c2ade9atagen2026-10-16 12:59 UTC154
    let (major, minor) = (
f27fa4c2ade9atagen2026-10-16 12:59 UTC155
        rustix::fs::major(node) as i64,
f27fa4c2ade9atagen2026-10-16 12:59 UTC156
        rustix::fs::minor(node) as i64,
f27fa4c2ade9atagen2026-10-16 12:59 UTC157
    );
f27fa4c2ade9atagen2026-10-16 12:59 UTC158
    (drm.has_primary == vk::TRUE && (drm.primary_major, drm.primary_minor) == (major, minor))
f27fa4c2ade9atagen2026-10-16 12:59 UTC159
        || (drm.has_render == vk::TRUE && (drm.render_major, drm.render_minor) == (major, minor))
f27fa4c2ade9atagen2026-10-16 12:59 UTC160
}
f27fa4c2ade9atagen2026-10-16 12:59 UTC161
824bf02b6e55atagen2026-10-16 09:15 UTC162
unsafe fn pick_physical(
824bf02b6e55atagen2026-10-16 09:15 UTC163
    instance: &ash::Instance,
824bf02b6e55atagen2026-10-16 09:15 UTC164
    wanted: Option<&str>,
f27fa4c2ade9atagen2026-10-16 12:59 UTC165
    node: Option<u64>,
824bf02b6e55atagen2026-10-16 09:15 UTC166
) -> Option<(vk::PhysicalDevice, u32, String)> {
824bf02b6e55atagen2026-10-16 09:15 UTC167
    let devices = unsafe { instance.enumerate_physical_devices() }.ok()?;
824bf02b6e55atagen2026-10-16 09:15 UTC168
    let mut candidates = Vec::new();
824bf02b6e55atagen2026-10-16 09:15 UTC169
    for physical in devices {
824bf02b6e55atagen2026-10-16 09:15 UTC170
        let props = unsafe { instance.get_physical_device_properties(physical) };
824bf02b6e55atagen2026-10-16 09:15 UTC171
        if props.api_version < vk::API_VERSION_1_3 {
824bf02b6e55atagen2026-10-16 09:15 UTC172
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC173
        }
824bf02b6e55atagen2026-10-16 09:15 UTC174
        let name = props
824bf02b6e55atagen2026-10-16 09:15 UTC175
            .device_name_as_c_str()
824bf02b6e55atagen2026-10-16 09:15 UTC176
            .unwrap_or(c"unknown")
824bf02b6e55atagen2026-10-16 09:15 UTC177
            .to_string_lossy()
824bf02b6e55atagen2026-10-16 09:15 UTC178
            .into_owned();
824bf02b6e55atagen2026-10-16 09:15 UTC179
        if wanted.is_some_and(|w| !name.contains(w)) {
824bf02b6e55atagen2026-10-16 09:15 UTC180
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC181
        }
824bf02b6e55atagen2026-10-16 09:15 UTC182
        let mut f13 = vk::PhysicalDeviceVulkan13Features::default();
824bf02b6e55atagen2026-10-16 09:15 UTC183
        let mut f2 = vk::PhysicalDeviceFeatures2::default().push_next(&mut f13);
824bf02b6e55atagen2026-10-16 09:15 UTC184
        unsafe { instance.get_physical_device_features2(physical, &mut f2) };
824bf02b6e55atagen2026-10-16 09:15 UTC185
        if f13.dynamic_rendering == vk::FALSE || f13.synchronization2 == vk::FALSE {
824bf02b6e55atagen2026-10-16 09:15 UTC186
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC187
        }
f27fa4c2ade9atagen2026-10-16 12:59 UTC188
        let extensions =
f27fa4c2ade9atagen2026-10-16 12:59 UTC189
            unsafe { instance.enumerate_device_extension_properties(physical) }.unwrap_or_default();
f27fa4c2ade9atagen2026-10-16 12:59 UTC190
        let has = |n: &std::ffi::CStr| {
f27fa4c2ade9atagen2026-10-16 12:59 UTC191
            extensions
f27fa4c2ade9atagen2026-10-16 12:59 UTC192
                .iter()
f27fa4c2ade9atagen2026-10-16 12:59 UTC193
                .any(|e| e.extension_name_as_c_str().ok() == Some(n))
f27fa4c2ade9atagen2026-10-16 12:59 UTC194
        };
f27fa4c2ade9atagen2026-10-16 12:59 UTC195
        if !has(ash::khr::push_descriptor::NAME) {
f27fa4c2ade9atagen2026-10-16 12:59 UTC196
            continue;
f27fa4c2ade9atagen2026-10-16 12:59 UTC197
        }
f27fa4c2ade9atagen2026-10-16 12:59 UTC198
        if let Some(node) = node
f27fa4c2ade9atagen2026-10-16 12:59 UTC199
            && !(has(ash::ext::physical_device_drm::NAME)
f27fa4c2ade9atagen2026-10-16 12:59 UTC200
                && unsafe { serves_node(instance, physical, node) })
f27fa4c2ade9atagen2026-10-16 12:59 UTC201
        {
824bf02b6e55atagen2026-10-16 09:15 UTC202
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC203
        }
824bf02b6e55atagen2026-10-16 09:15 UTC204
        let families = unsafe { instance.get_physical_device_queue_family_properties(physical) };
824bf02b6e55atagen2026-10-16 09:15 UTC205
        let Some(family) = families
824bf02b6e55atagen2026-10-16 09:15 UTC206
            .iter()
824bf02b6e55atagen2026-10-16 09:15 UTC207
            .position(|f| f.queue_flags.contains(vk::QueueFlags::GRAPHICS))
824bf02b6e55atagen2026-10-16 09:15 UTC208
        else {
824bf02b6e55atagen2026-10-16 09:15 UTC209
            continue;
824bf02b6e55atagen2026-10-16 09:15 UTC210
        };
824bf02b6e55atagen2026-10-16 09:15 UTC211
        let rank = match props.device_type {
824bf02b6e55atagen2026-10-16 09:15 UTC212
            vk::PhysicalDeviceType::DISCRETE_GPU => 0,
824bf02b6e55atagen2026-10-16 09:15 UTC213
            vk::PhysicalDeviceType::INTEGRATED_GPU => 1,
824bf02b6e55atagen2026-10-16 09:15 UTC214
            vk::PhysicalDeviceType::VIRTUAL_GPU => 2,
824bf02b6e55atagen2026-10-16 09:15 UTC215
            _ => 3,
824bf02b6e55atagen2026-10-16 09:15 UTC216
        };
824bf02b6e55atagen2026-10-16 09:15 UTC217
        candidates.push((rank, physical, family as u32, name));
824bf02b6e55atagen2026-10-16 09:15 UTC218
    }
824bf02b6e55atagen2026-10-16 09:15 UTC219
    candidates.sort_by_key(|c| c.0);
824bf02b6e55atagen2026-10-16 09:15 UTC220
    candidates.into_iter().next().map(|(_, p, f, n)| (p, f, n))
824bf02b6e55atagen2026-10-16 09:15 UTC221
}