mirror of
https://github.com/Motorhead1991/qemu.git
synced 2025-07-27 12:23:53 -06:00
d556226d69
Complete the conversion from the ClassInitImpl trait to class_init() methods. This will provide more freedom to split the qemu_api crate in separate parts. Reviewed-by: Zhao Liu <zhao1.liu@intel.com> Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
96 lines
3.2 KiB
Rust
96 lines
3.2 KiB
Rust
// Copyright 2024 Red Hat, Inc.
|
|
// Author(s): Paolo Bonzini <pbonzini@redhat.com>
|
|
// SPDX-License-Identifier: GPL-2.0-or-later
|
|
|
|
//! Bindings to access `sysbus` functionality from Rust.
|
|
|
|
use std::{ffi::CStr, ptr::addr_of_mut};
|
|
|
|
pub use bindings::{SysBusDevice, SysBusDeviceClass};
|
|
|
|
use crate::{
|
|
bindings,
|
|
cell::bql_locked,
|
|
irq::{IRQState, InterruptSource},
|
|
memory::MemoryRegion,
|
|
prelude::*,
|
|
qdev::{DeviceImpl, DeviceState},
|
|
qom::Owned,
|
|
};
|
|
|
|
unsafe impl ObjectType for SysBusDevice {
|
|
type Class = SysBusDeviceClass;
|
|
const TYPE_NAME: &'static CStr =
|
|
unsafe { CStr::from_bytes_with_nul_unchecked(bindings::TYPE_SYS_BUS_DEVICE) };
|
|
}
|
|
qom_isa!(SysBusDevice: DeviceState, Object);
|
|
|
|
// TODO: add virtual methods
|
|
pub trait SysBusDeviceImpl: DeviceImpl + IsA<SysBusDevice> {}
|
|
|
|
impl SysBusDeviceClass {
|
|
/// Fill in the virtual methods of `SysBusDeviceClass` based on the
|
|
/// definitions in the `SysBusDeviceImpl` trait.
|
|
pub fn class_init<T: SysBusDeviceImpl>(self: &mut SysBusDeviceClass) {
|
|
self.parent_class.class_init::<T>();
|
|
}
|
|
}
|
|
|
|
/// Trait for methods of [`SysBusDevice`] and its subclasses.
|
|
pub trait SysBusDeviceMethods: ObjectDeref
|
|
where
|
|
Self::Target: IsA<SysBusDevice>,
|
|
{
|
|
/// Expose a memory region to the board so that it can give it an address
|
|
/// in guest memory. Note that the ordering of calls to `init_mmio` is
|
|
/// important, since whoever creates the sysbus device will refer to the
|
|
/// region with a number that corresponds to the order of calls to
|
|
/// `init_mmio`.
|
|
fn init_mmio(&self, iomem: &MemoryRegion) {
|
|
assert!(bql_locked());
|
|
unsafe {
|
|
bindings::sysbus_init_mmio(self.as_mut_ptr(), iomem.as_mut_ptr());
|
|
}
|
|
}
|
|
|
|
/// Expose an interrupt source outside the device as a qdev GPIO output.
|
|
/// Note that the ordering of calls to `init_irq` is important, since
|
|
/// whoever creates the sysbus device will refer to the interrupts with
|
|
/// a number that corresponds to the order of calls to `init_irq`.
|
|
fn init_irq(&self, irq: &InterruptSource) {
|
|
assert!(bql_locked());
|
|
unsafe {
|
|
bindings::sysbus_init_irq(self.as_mut_ptr(), irq.as_ptr());
|
|
}
|
|
}
|
|
|
|
// TODO: do we want a type like GuestAddress here?
|
|
fn mmio_map(&self, id: u32, addr: u64) {
|
|
assert!(bql_locked());
|
|
let id: i32 = id.try_into().unwrap();
|
|
unsafe {
|
|
bindings::sysbus_mmio_map(self.as_mut_ptr(), id, addr);
|
|
}
|
|
}
|
|
|
|
// Owned<> is used here because sysbus_connect_irq (via
|
|
// object_property_set_link) adds a reference to the IRQState,
|
|
// which can prolong its life
|
|
fn connect_irq(&self, id: u32, irq: &Owned<IRQState>) {
|
|
assert!(bql_locked());
|
|
let id: i32 = id.try_into().unwrap();
|
|
unsafe {
|
|
bindings::sysbus_connect_irq(self.as_mut_ptr(), id, irq.as_mut_ptr());
|
|
}
|
|
}
|
|
|
|
fn sysbus_realize(&self) {
|
|
// TODO: return an Error
|
|
assert!(bql_locked());
|
|
unsafe {
|
|
bindings::sysbus_realize(self.as_mut_ptr(), addr_of_mut!(bindings::error_fatal));
|
|
}
|
|
}
|
|
}
|
|
|
|
impl<R: ObjectDeref> SysBusDeviceMethods for R where R::Target: IsA<SysBusDevice> {}
|