xref: /qemu/rust/hw/char/pl011/src/device_class.rs (revision 24f0e8d818b931758b6dc47f973a6b1b80ecee1f)

// Copyright 2024, Linaro Limited
// Author(s): Manos Pitsidianakis <manos.pitsidianakis@linaro.org>
// SPDX-License-Identifier: GPL-2.0-or-later

use core::ptr::NonNull;
use std::os::raw::{c_int, c_void};

use qemu_api::{
    bindings::*, c_str, vmstate_clock, vmstate_fields, vmstate_of, vmstate_subsections,
    vmstate_unused, zeroable::Zeroable,
};

use crate::device::PL011State;

extern "C" fn pl011_clock_needed(opaque: *mut c_void) -> bool {
    unsafe {
        debug_assert!(!opaque.is_null());
        let state = NonNull::new_unchecked(opaque.cast::<PL011State>());
        state.as_ref().migrate_clock
    }
}

/// Migration subsection for [`PL011State`] clock.
pub static VMSTATE_PL011_CLOCK: VMStateDescription = VMStateDescription {
    name: c_str!("pl011/clock").as_ptr(),
    version_id: 1,
    minimum_version_id: 1,
    needed: Some(pl011_clock_needed),
    fields: vmstate_fields! {
        vmstate_clock!(PL011State, clock),
    },
    ..Zeroable::ZERO
};

extern "C" fn pl011_post_load(opaque: *mut c_void, version_id: c_int) -> c_int {
    unsafe {
        debug_assert!(!opaque.is_null());
        let mut state = NonNull::new_unchecked(opaque.cast::<PL011State>());
        let result = state.as_mut().post_load(version_id as u32);
        if result.is_err() {
            -1
        } else {
            0
        }
    }
}

pub static VMSTATE_PL011: VMStateDescription = VMStateDescription {
    name: c_str!("pl011").as_ptr(),
    version_id: 2,
    minimum_version_id: 2,
    post_load: Some(pl011_post_load),
    fields: vmstate_fields! {
        vmstate_unused!(core::mem::size_of::<u32>()),
        vmstate_of!(PL011State, flags),
        vmstate_of!(PL011State, line_control),
        vmstate_of!(PL011State, receive_status_error_clear),
        vmstate_of!(PL011State, control),
        vmstate_of!(PL011State, dmacr),
        vmstate_of!(PL011State, int_enabled),
        vmstate_of!(PL011State, int_level),
        vmstate_of!(PL011State, read_fifo),
        vmstate_of!(PL011State, ilpr),
        vmstate_of!(PL011State, ibrd),
        vmstate_of!(PL011State, fbrd),
        vmstate_of!(PL011State, ifl),
        vmstate_of!(PL011State, read_pos),
        vmstate_of!(PL011State, read_count),
        vmstate_of!(PL011State, read_trigger),
    },
    subsections: vmstate_subsections! {
        VMSTATE_PL011_CLOCK
    },
    ..Zeroable::ZERO
};

qemu_api::declare_properties! {
    PL011_PROPERTIES,
    qemu_api::define_property!(
        c_str!("chardev"),
        PL011State,
        char_backend,
        unsafe { &qdev_prop_chr },
        CharBackend
    ),
    qemu_api::define_property!(
        c_str!("migrate-clk"),
        PL011State,
        migrate_clock,
        unsafe { &qdev_prop_bool },
        bool,
        default = true
    ),
}