xref: /qemu/rust/qemu-api/src/sysbus.rs (revision 7bd8e3ef63330e870cf4644d21c285cce35c703d)
14ed4da16SPaolo Bonzini // Copyright 2024 Red Hat, Inc.
24ed4da16SPaolo Bonzini // Author(s): Paolo Bonzini <pbonzini@redhat.com>
34ed4da16SPaolo Bonzini // SPDX-License-Identifier: GPL-2.0-or-later
44ed4da16SPaolo Bonzini 
5*7bd8e3efSPaolo Bonzini use std::{ffi::CStr, ptr::addr_of};
64ed4da16SPaolo Bonzini 
74ed4da16SPaolo Bonzini pub use bindings::{SysBusDevice, SysBusDeviceClass};
84ed4da16SPaolo Bonzini 
9*7bd8e3efSPaolo Bonzini use crate::{bindings, cell::bql_locked, irq::InterruptSource, prelude::*};
10*7bd8e3efSPaolo Bonzini 
11*7bd8e3efSPaolo Bonzini unsafe impl ObjectType for SysBusDevice {
12*7bd8e3efSPaolo Bonzini     type Class = SysBusDeviceClass;
13*7bd8e3efSPaolo Bonzini     const TYPE_NAME: &'static CStr =
14*7bd8e3efSPaolo Bonzini         unsafe { CStr::from_bytes_with_nul_unchecked(bindings::TYPE_SYS_BUS_DEVICE) };
15*7bd8e3efSPaolo Bonzini }
164ed4da16SPaolo Bonzini 
174ed4da16SPaolo Bonzini impl SysBusDevice {
184ed4da16SPaolo Bonzini     /// Return `self` cast to a mutable pointer, for use in calls to C code.
194ed4da16SPaolo Bonzini     const fn as_mut_ptr(&self) -> *mut SysBusDevice {
204ed4da16SPaolo Bonzini         addr_of!(*self) as *mut _
214ed4da16SPaolo Bonzini     }
224ed4da16SPaolo Bonzini 
234ed4da16SPaolo Bonzini     /// Expose an interrupt source outside the device as a qdev GPIO output.
244ed4da16SPaolo Bonzini     /// Note that the ordering of calls to `init_irq` is important, since
254ed4da16SPaolo Bonzini     /// whoever creates the sysbus device will refer to the interrupts with
264ed4da16SPaolo Bonzini     /// a number that corresponds to the order of calls to `init_irq`.
274ed4da16SPaolo Bonzini     pub fn init_irq(&self, irq: &InterruptSource) {
284ed4da16SPaolo Bonzini         assert!(bql_locked());
294ed4da16SPaolo Bonzini         unsafe {
304ed4da16SPaolo Bonzini             bindings::sysbus_init_irq(self.as_mut_ptr(), irq.as_ptr());
314ed4da16SPaolo Bonzini         }
324ed4da16SPaolo Bonzini     }
334ed4da16SPaolo Bonzini }
34