axvm 0.5.26

Virtual Machine resource management crate for ArceOS's hypervisor variant.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

//! Device-graph factory for the x86 CMOS platform device.

use axdevice::*;
use axvm_types::VmMemMappingType;

use crate::{AxVmResult, config::AxVMConfig};

pub(super) fn guest_low_memory_size(config: &AxVMConfig) -> AxVmResult<u64> {
    config
        .memory_regions()
        .iter()
        .filter(|region| region.map_type == VmMemMappingType::MapAlloc && region.gpa == 0)
        .map(|region| {
            u64::try_from(region.size)
                .map_err(|_| crate::AxVmError::invalid_config("x86 guest RAM size exceeds 64 bits"))
        })
        .next()
        .transpose()?
        .ok_or_else(|| crate::AxVmError::invalid_config("x86 firmware requires guest RAM at GPA 0"))
}

pub(super) struct X86CmosModel {
    low_memory_size: u64,
}

impl X86CmosModel {
    pub(super) const fn new(low_memory_size: u64) -> Self {
        Self { low_memory_size }
    }
}

impl DeviceModel for X86CmosModel {
    fn requirements(&self) -> DeviceManagerResult<DeviceRequirements> {
        DeviceRequirements::new().with_pio(
            ResourceSlot::new("registers")?,
            2,
            1,
            ResourceRequest::Fixed(0x70),
        )
    }

    fn build(&self, context: &mut DeviceBuildContext<'_>) -> DeviceManagerResult<DeviceBundle> {
        let range = context.pio(&ResourceSlot::new("registers")?)?;
        if range != (0x70, 2) {
            return Err(DeviceManagerError::InvalidConfig {
                operation: "build x86 CMOS",
                detail: "planned CMOS range must be 0x70..=0x71".into(),
            });
        }
        Ok(DeviceBundle::from_registration(DeviceRegistration::Device(
            std::sync::Arc::new(axdevice::X86CmosDevice::new(self.low_memory_size)),
        )))
    }
}