rust/qemu-api/src/sysbus.rs


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

// Copyright 2024 Red Hat, Inc.
// Author(s): Paolo Bonzini <pbonzini@redhat.com>
// SPDX-License-Identifier: GPL-2.0-or-later

use std::ptr::addr_of;

pub use bindings::{SysBusDevice, SysBusDeviceClass};

use crate::{bindings, cell::bql_locked, irq::InterruptSource};

impl SysBusDevice {
    /// Return `self` cast to a mutable pointer, for use in calls to C code.
    const fn as_mut_ptr(&self) -> *mut SysBusDevice {
        addr_of!(*self) as *mut _
    }

    /// 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`.
    pub fn init_irq(&self, irq: &InterruptSource) {
        assert!(bql_locked());
        unsafe {
            bindings::sysbus_init_irq(self.as_mut_ptr(), irq.as_ptr());
        }
    }
}