xref: /openbmc/qemu/rust/qemu-api/src/device_class.rs (revision 03a573b9)
15a5110d2SManos Pitsidianakis // Copyright 2024, Linaro Limited
25a5110d2SManos Pitsidianakis // Author(s): Manos Pitsidianakis <manos.pitsidianakis@linaro.org>
35a5110d2SManos Pitsidianakis // SPDX-License-Identifier: GPL-2.0-or-later
45a5110d2SManos Pitsidianakis 
55a5110d2SManos Pitsidianakis use std::sync::OnceLock;
65a5110d2SManos Pitsidianakis 
75a5110d2SManos Pitsidianakis use crate::bindings::Property;
85a5110d2SManos Pitsidianakis 
95a5110d2SManos Pitsidianakis #[macro_export]
105a5110d2SManos Pitsidianakis macro_rules! device_class_init {
115a5110d2SManos Pitsidianakis     ($func:ident, props => $props:ident, realize_fn => $realize_fn:expr, legacy_reset_fn => $legacy_reset_fn:expr, vmsd => $vmsd:ident$(,)*) => {
125a5110d2SManos Pitsidianakis         pub unsafe extern "C" fn $func(
135a5110d2SManos Pitsidianakis             klass: *mut $crate::bindings::ObjectClass,
145a5110d2SManos Pitsidianakis             _: *mut ::core::ffi::c_void,
155a5110d2SManos Pitsidianakis         ) {
165a5110d2SManos Pitsidianakis             let mut dc =
175a5110d2SManos Pitsidianakis                 ::core::ptr::NonNull::new(klass.cast::<$crate::bindings::DeviceClass>()).unwrap();
187b72c7ddSPaolo Bonzini             unsafe {
195a5110d2SManos Pitsidianakis                 dc.as_mut().realize = $realize_fn;
205a5110d2SManos Pitsidianakis                 dc.as_mut().vmsd = &$vmsd;
215a5110d2SManos Pitsidianakis                 $crate::bindings::device_class_set_legacy_reset(dc.as_mut(), $legacy_reset_fn);
225a5110d2SManos Pitsidianakis                 $crate::bindings::device_class_set_props(dc.as_mut(), $props.as_mut_ptr());
235a5110d2SManos Pitsidianakis             }
247b72c7ddSPaolo Bonzini         }
255a5110d2SManos Pitsidianakis     };
265a5110d2SManos Pitsidianakis }
275a5110d2SManos Pitsidianakis 
285a5110d2SManos Pitsidianakis #[macro_export]
295a5110d2SManos Pitsidianakis macro_rules! define_property {
305a5110d2SManos Pitsidianakis     ($name:expr, $state:ty, $field:expr, $prop:expr, $type:expr, default = $defval:expr$(,)*) => {
315a5110d2SManos Pitsidianakis         $crate::bindings::Property {
32*03a573b9SPaolo Bonzini             // use associated function syntax for type checking
33*03a573b9SPaolo Bonzini             name: ::core::ffi::CStr::as_ptr($name),
345a5110d2SManos Pitsidianakis             info: $prop,
355a5110d2SManos Pitsidianakis             offset: ::core::mem::offset_of!($state, $field)
365a5110d2SManos Pitsidianakis                 .try_into()
375a5110d2SManos Pitsidianakis                 .expect("Could not fit offset value to type"),
385a5110d2SManos Pitsidianakis             set_default: true,
39*03a573b9SPaolo Bonzini             defval: $crate::bindings::Property__bindgen_ty_1 { u: $defval as u64 },
40*03a573b9SPaolo Bonzini             ..unsafe { ::core::mem::MaybeUninit::<$crate::bindings::Property>::zeroed().assume_init() }
415a5110d2SManos Pitsidianakis         }
425a5110d2SManos Pitsidianakis     };
435a5110d2SManos Pitsidianakis     ($name:expr, $state:ty, $field:expr, $prop:expr, $type:expr$(,)*) => {
445a5110d2SManos Pitsidianakis         $crate::bindings::Property {
45*03a573b9SPaolo Bonzini             // use associated function syntax for type checking
46*03a573b9SPaolo Bonzini             name: ::core::ffi::CStr::as_ptr($name),
475a5110d2SManos Pitsidianakis             info: $prop,
485a5110d2SManos Pitsidianakis             offset: ::core::mem::offset_of!($state, $field)
495a5110d2SManos Pitsidianakis                 .try_into()
505a5110d2SManos Pitsidianakis                 .expect("Could not fit offset value to type"),
515a5110d2SManos Pitsidianakis             set_default: false,
52*03a573b9SPaolo Bonzini             ..unsafe { ::core::mem::MaybeUninit::<$crate::bindings::Property>::zeroed().assume_init() }
535a5110d2SManos Pitsidianakis         }
545a5110d2SManos Pitsidianakis     };
555a5110d2SManos Pitsidianakis }
565a5110d2SManos Pitsidianakis 
575a5110d2SManos Pitsidianakis #[repr(C)]
585a5110d2SManos Pitsidianakis pub struct Properties<const N: usize>(pub OnceLock<[Property; N]>, pub fn() -> [Property; N]);
595a5110d2SManos Pitsidianakis 
605a5110d2SManos Pitsidianakis impl<const N: usize> Properties<N> {
615a5110d2SManos Pitsidianakis     pub fn as_mut_ptr(&mut self) -> *mut Property {
625a5110d2SManos Pitsidianakis         _ = self.0.get_or_init(self.1);
635a5110d2SManos Pitsidianakis         self.0.get_mut().unwrap().as_mut_ptr()
645a5110d2SManos Pitsidianakis     }
655a5110d2SManos Pitsidianakis }
665a5110d2SManos Pitsidianakis 
675a5110d2SManos Pitsidianakis #[macro_export]
685a5110d2SManos Pitsidianakis macro_rules! declare_properties {
695a5110d2SManos Pitsidianakis     ($ident:ident, $($prop:expr),*$(,)*) => {
705a5110d2SManos Pitsidianakis 
715a5110d2SManos Pitsidianakis         const fn _calc_prop_len() -> usize {
725a5110d2SManos Pitsidianakis             let mut len = 1;
735a5110d2SManos Pitsidianakis             $({
745a5110d2SManos Pitsidianakis                 _ = stringify!($prop);
755a5110d2SManos Pitsidianakis                 len += 1;
765a5110d2SManos Pitsidianakis             })*
775a5110d2SManos Pitsidianakis             len
785a5110d2SManos Pitsidianakis         }
795a5110d2SManos Pitsidianakis         const PROP_LEN: usize = _calc_prop_len();
805a5110d2SManos Pitsidianakis 
815a5110d2SManos Pitsidianakis         fn _make_properties() -> [$crate::bindings::Property; PROP_LEN] {
825a5110d2SManos Pitsidianakis             [
835a5110d2SManos Pitsidianakis                 $($prop),*,
845a5110d2SManos Pitsidianakis                     unsafe { ::core::mem::MaybeUninit::<$crate::bindings::Property>::zeroed().assume_init() },
855a5110d2SManos Pitsidianakis             ]
865a5110d2SManos Pitsidianakis         }
875a5110d2SManos Pitsidianakis 
885a5110d2SManos Pitsidianakis         pub static mut $ident: $crate::device_class::Properties<PROP_LEN> = $crate::device_class::Properties(::std::sync::OnceLock::new(), _make_properties);
895a5110d2SManos Pitsidianakis     };
905a5110d2SManos Pitsidianakis }
915a5110d2SManos Pitsidianakis 
925a5110d2SManos Pitsidianakis #[macro_export]
935a5110d2SManos Pitsidianakis macro_rules! vm_state_description {
945a5110d2SManos Pitsidianakis     ($(#[$outer:meta])*
955a5110d2SManos Pitsidianakis      $name:ident,
965a5110d2SManos Pitsidianakis      $(name: $vname:expr,)*
975a5110d2SManos Pitsidianakis      $(unmigratable: $um_val:expr,)*
985a5110d2SManos Pitsidianakis     ) => {
995a5110d2SManos Pitsidianakis         #[used]
1005a5110d2SManos Pitsidianakis         $(#[$outer])*
1015a5110d2SManos Pitsidianakis         pub static $name: $crate::bindings::VMStateDescription = $crate::bindings::VMStateDescription {
1025a5110d2SManos Pitsidianakis             $(name: {
1035a5110d2SManos Pitsidianakis                 #[used]
1045a5110d2SManos Pitsidianakis                 static VMSTATE_NAME: &::core::ffi::CStr = $vname;
1055a5110d2SManos Pitsidianakis                 $vname.as_ptr()
1065a5110d2SManos Pitsidianakis             },)*
1075a5110d2SManos Pitsidianakis             unmigratable: true,
1085a5110d2SManos Pitsidianakis             ..unsafe { ::core::mem::MaybeUninit::<$crate::bindings::VMStateDescription>::zeroed().assume_init() }
1095a5110d2SManos Pitsidianakis         };
1105a5110d2SManos Pitsidianakis     }
1115a5110d2SManos Pitsidianakis }
112