xref: /qemu/rust/qemu-api/src/sysbus.rs (revision 4ed4da164c957a4475b9d075206f33113a69abda)
1*4ed4da16SPaolo Bonzini // Copyright 2024 Red Hat, Inc.
2*4ed4da16SPaolo Bonzini // Author(s): Paolo Bonzini <pbonzini@redhat.com>
3*4ed4da16SPaolo Bonzini // SPDX-License-Identifier: GPL-2.0-or-later
4*4ed4da16SPaolo Bonzini 
5*4ed4da16SPaolo Bonzini use std::ptr::addr_of;
6*4ed4da16SPaolo Bonzini 
7*4ed4da16SPaolo Bonzini pub use bindings::{SysBusDevice, SysBusDeviceClass};
8*4ed4da16SPaolo Bonzini 
9*4ed4da16SPaolo Bonzini use crate::{bindings, cell::bql_locked, irq::InterruptSource};
10*4ed4da16SPaolo Bonzini 
11*4ed4da16SPaolo Bonzini impl SysBusDevice {
12*4ed4da16SPaolo Bonzini     /// Return `self` cast to a mutable pointer, for use in calls to C code.
13*4ed4da16SPaolo Bonzini     const fn as_mut_ptr(&self) -> *mut SysBusDevice {
14*4ed4da16SPaolo Bonzini         addr_of!(*self) as *mut _
15*4ed4da16SPaolo Bonzini     }
16*4ed4da16SPaolo Bonzini 
17*4ed4da16SPaolo Bonzini     /// Expose an interrupt source outside the device as a qdev GPIO output.
18*4ed4da16SPaolo Bonzini     /// Note that the ordering of calls to `init_irq` is important, since
19*4ed4da16SPaolo Bonzini     /// whoever creates the sysbus device will refer to the interrupts with
20*4ed4da16SPaolo Bonzini     /// a number that corresponds to the order of calls to `init_irq`.
21*4ed4da16SPaolo Bonzini     pub fn init_irq(&self, irq: &InterruptSource) {
22*4ed4da16SPaolo Bonzini         assert!(bql_locked());
23*4ed4da16SPaolo Bonzini         unsafe {
24*4ed4da16SPaolo Bonzini             bindings::sysbus_init_irq(self.as_mut_ptr(), irq.as_ptr());
25*4ed4da16SPaolo Bonzini         }
26*4ed4da16SPaolo Bonzini     }
27*4ed4da16SPaolo Bonzini }
28