xref: /qemu/rust/qemu-api/src/qdev.rs (revision 5a5110d290c0f2dca3d98c608b0ec9a01d2181b9)
1*5a5110d2SManos Pitsidianakis // Copyright 2024, Linaro Limited
2*5a5110d2SManos Pitsidianakis // Author(s): Manos Pitsidianakis <manos.pitsidianakis@linaro.org>
3*5a5110d2SManos Pitsidianakis // SPDX-License-Identifier: GPL-2.0-or-later
4*5a5110d2SManos Pitsidianakis 
5*5a5110d2SManos Pitsidianakis use std::sync::OnceLock;
6*5a5110d2SManos Pitsidianakis 
7*5a5110d2SManos Pitsidianakis use crate::bindings::Property;
8*5a5110d2SManos Pitsidianakis 
9*5a5110d2SManos Pitsidianakis #[macro_export]
10*5a5110d2SManos Pitsidianakis macro_rules! device_class_init {
11*5a5110d2SManos Pitsidianakis     ($func:ident, props => $props:ident, realize_fn => $realize_fn:expr, legacy_reset_fn => $legacy_reset_fn:expr, vmsd => $vmsd:ident$(,)*) => {
12*5a5110d2SManos Pitsidianakis         #[no_mangle]
13*5a5110d2SManos Pitsidianakis         pub unsafe extern "C" fn $func(
14*5a5110d2SManos Pitsidianakis             klass: *mut $crate::bindings::ObjectClass,
15*5a5110d2SManos Pitsidianakis             _: *mut ::core::ffi::c_void,
16*5a5110d2SManos Pitsidianakis         ) {
17*5a5110d2SManos Pitsidianakis             let mut dc =
18*5a5110d2SManos Pitsidianakis                 ::core::ptr::NonNull::new(klass.cast::<$crate::bindings::DeviceClass>()).unwrap();
19*5a5110d2SManos Pitsidianakis             dc.as_mut().realize = $realize_fn;
20*5a5110d2SManos Pitsidianakis             dc.as_mut().vmsd = &$vmsd;
21*5a5110d2SManos Pitsidianakis             $crate::bindings::device_class_set_legacy_reset(dc.as_mut(), $legacy_reset_fn);
22*5a5110d2SManos Pitsidianakis             $crate::bindings::device_class_set_props(dc.as_mut(), $props.as_mut_ptr());
23*5a5110d2SManos Pitsidianakis         }
24*5a5110d2SManos Pitsidianakis     };
25*5a5110d2SManos Pitsidianakis }
26*5a5110d2SManos Pitsidianakis 
27*5a5110d2SManos Pitsidianakis #[macro_export]
28*5a5110d2SManos Pitsidianakis macro_rules! define_property {
29*5a5110d2SManos Pitsidianakis     ($name:expr, $state:ty, $field:expr, $prop:expr, $type:expr, default = $defval:expr$(,)*) => {
30*5a5110d2SManos Pitsidianakis         $crate::bindings::Property {
31*5a5110d2SManos Pitsidianakis             name: {
32*5a5110d2SManos Pitsidianakis                 #[used]
33*5a5110d2SManos Pitsidianakis                 static _TEMP: &::core::ffi::CStr = $name;
34*5a5110d2SManos Pitsidianakis                 _TEMP.as_ptr()
35*5a5110d2SManos Pitsidianakis             },
36*5a5110d2SManos Pitsidianakis             info: $prop,
37*5a5110d2SManos Pitsidianakis             offset: ::core::mem::offset_of!($state, $field)
38*5a5110d2SManos Pitsidianakis                 .try_into()
39*5a5110d2SManos Pitsidianakis                 .expect("Could not fit offset value to type"),
40*5a5110d2SManos Pitsidianakis             bitnr: 0,
41*5a5110d2SManos Pitsidianakis             bitmask: 0,
42*5a5110d2SManos Pitsidianakis             set_default: true,
43*5a5110d2SManos Pitsidianakis             defval: $crate::bindings::Property__bindgen_ty_1 { u: $defval.into() },
44*5a5110d2SManos Pitsidianakis             arrayoffset: 0,
45*5a5110d2SManos Pitsidianakis             arrayinfo: ::core::ptr::null(),
46*5a5110d2SManos Pitsidianakis             arrayfieldsize: 0,
47*5a5110d2SManos Pitsidianakis             link_type: ::core::ptr::null(),
48*5a5110d2SManos Pitsidianakis         }
49*5a5110d2SManos Pitsidianakis     };
50*5a5110d2SManos Pitsidianakis     ($name:expr, $state:ty, $field:expr, $prop:expr, $type:expr$(,)*) => {
51*5a5110d2SManos Pitsidianakis         $crate::bindings::Property {
52*5a5110d2SManos Pitsidianakis             name: {
53*5a5110d2SManos Pitsidianakis                 #[used]
54*5a5110d2SManos Pitsidianakis                 static _TEMP: &::core::ffi::CStr = $name;
55*5a5110d2SManos Pitsidianakis                 _TEMP.as_ptr()
56*5a5110d2SManos Pitsidianakis             },
57*5a5110d2SManos Pitsidianakis             info: $prop,
58*5a5110d2SManos Pitsidianakis             offset: ::core::mem::offset_of!($state, $field)
59*5a5110d2SManos Pitsidianakis                 .try_into()
60*5a5110d2SManos Pitsidianakis                 .expect("Could not fit offset value to type"),
61*5a5110d2SManos Pitsidianakis             bitnr: 0,
62*5a5110d2SManos Pitsidianakis             bitmask: 0,
63*5a5110d2SManos Pitsidianakis             set_default: false,
64*5a5110d2SManos Pitsidianakis             defval: $crate::bindings::Property__bindgen_ty_1 { i: 0 },
65*5a5110d2SManos Pitsidianakis             arrayoffset: 0,
66*5a5110d2SManos Pitsidianakis             arrayinfo: ::core::ptr::null(),
67*5a5110d2SManos Pitsidianakis             arrayfieldsize: 0,
68*5a5110d2SManos Pitsidianakis             link_type: ::core::ptr::null(),
69*5a5110d2SManos Pitsidianakis         }
70*5a5110d2SManos Pitsidianakis     };
71*5a5110d2SManos Pitsidianakis }
72*5a5110d2SManos Pitsidianakis 
73*5a5110d2SManos Pitsidianakis #[repr(C)]
74*5a5110d2SManos Pitsidianakis pub struct Properties<const N: usize>(pub OnceLock<[Property; N]>, pub fn() -> [Property; N]);
75*5a5110d2SManos Pitsidianakis 
76*5a5110d2SManos Pitsidianakis impl<const N: usize> Properties<N> {
77*5a5110d2SManos Pitsidianakis     pub fn as_mut_ptr(&mut self) -> *mut Property {
78*5a5110d2SManos Pitsidianakis         _ = self.0.get_or_init(self.1);
79*5a5110d2SManos Pitsidianakis         self.0.get_mut().unwrap().as_mut_ptr()
80*5a5110d2SManos Pitsidianakis     }
81*5a5110d2SManos Pitsidianakis }
82*5a5110d2SManos Pitsidianakis 
83*5a5110d2SManos Pitsidianakis #[macro_export]
84*5a5110d2SManos Pitsidianakis macro_rules! declare_properties {
85*5a5110d2SManos Pitsidianakis     ($ident:ident, $($prop:expr),*$(,)*) => {
86*5a5110d2SManos Pitsidianakis 
87*5a5110d2SManos Pitsidianakis         const fn _calc_prop_len() -> usize {
88*5a5110d2SManos Pitsidianakis             let mut len = 1;
89*5a5110d2SManos Pitsidianakis             $({
90*5a5110d2SManos Pitsidianakis                 _ = stringify!($prop);
91*5a5110d2SManos Pitsidianakis                 len += 1;
92*5a5110d2SManos Pitsidianakis             })*
93*5a5110d2SManos Pitsidianakis             len
94*5a5110d2SManos Pitsidianakis         }
95*5a5110d2SManos Pitsidianakis         const PROP_LEN: usize = _calc_prop_len();
96*5a5110d2SManos Pitsidianakis 
97*5a5110d2SManos Pitsidianakis         fn _make_properties() -> [$crate::bindings::Property; PROP_LEN] {
98*5a5110d2SManos Pitsidianakis             [
99*5a5110d2SManos Pitsidianakis                 $($prop),*,
100*5a5110d2SManos Pitsidianakis                     unsafe { ::core::mem::MaybeUninit::<$crate::bindings::Property>::zeroed().assume_init() },
101*5a5110d2SManos Pitsidianakis             ]
102*5a5110d2SManos Pitsidianakis         }
103*5a5110d2SManos Pitsidianakis 
104*5a5110d2SManos Pitsidianakis         #[no_mangle]
105*5a5110d2SManos Pitsidianakis         pub static mut $ident: $crate::device_class::Properties<PROP_LEN> = $crate::device_class::Properties(::std::sync::OnceLock::new(), _make_properties);
106*5a5110d2SManos Pitsidianakis     };
107*5a5110d2SManos Pitsidianakis }
108*5a5110d2SManos Pitsidianakis 
109*5a5110d2SManos Pitsidianakis #[macro_export]
110*5a5110d2SManos Pitsidianakis macro_rules! vm_state_description {
111*5a5110d2SManos Pitsidianakis     ($(#[$outer:meta])*
112*5a5110d2SManos Pitsidianakis      $name:ident,
113*5a5110d2SManos Pitsidianakis      $(name: $vname:expr,)*
114*5a5110d2SManos Pitsidianakis      $(unmigratable: $um_val:expr,)*
115*5a5110d2SManos Pitsidianakis     ) => {
116*5a5110d2SManos Pitsidianakis         #[used]
117*5a5110d2SManos Pitsidianakis         $(#[$outer])*
118*5a5110d2SManos Pitsidianakis         pub static $name: $crate::bindings::VMStateDescription = $crate::bindings::VMStateDescription {
119*5a5110d2SManos Pitsidianakis             $(name: {
120*5a5110d2SManos Pitsidianakis                 #[used]
121*5a5110d2SManos Pitsidianakis                 static VMSTATE_NAME: &::core::ffi::CStr = $vname;
122*5a5110d2SManos Pitsidianakis                 $vname.as_ptr()
123*5a5110d2SManos Pitsidianakis             },)*
124*5a5110d2SManos Pitsidianakis             unmigratable: true,
125*5a5110d2SManos Pitsidianakis             ..unsafe { ::core::mem::MaybeUninit::<$crate::bindings::VMStateDescription>::zeroed().assume_init() }
126*5a5110d2SManos Pitsidianakis         };
127*5a5110d2SManos Pitsidianakis     }
128*5a5110d2SManos Pitsidianakis }
129