feat(runtime): add optional pause and resume lifecycle hooks
Intrepid/Prometeu/Runtime/pipeline/pr-master Build started...
Intrepid/Prometeu/Runtime/pipeline/pr-master Build started...
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
use crate::CrashReport;
|
||||
use crate::os::{GameLifecycleEvent, SystemOS};
|
||||
use crate::task::TaskId;
|
||||
use crate::vm_session::VmSession;
|
||||
use crate::vm_session::{LifecycleTransition, VmSession};
|
||||
use crate::{RenderWorkerConfig, RenderWorkerController};
|
||||
use prometeu_hal::app_mode::AppMode;
|
||||
use prometeu_hal::telemetry::{CertificationConfig, TelemetryFrame};
|
||||
@@ -9,6 +9,7 @@ use prometeu_hal::{
|
||||
FrameId, InputSignals, RenderOwnership, RenderWorkerBackend, RenderWorkerError,
|
||||
RenderWorkerFrameSink, RuntimePlatform,
|
||||
};
|
||||
use prometeu_vm::LogicalFrameEndingReason;
|
||||
use std::sync::atomic::Ordering;
|
||||
|
||||
pub struct VmFacade<'a> {
|
||||
@@ -22,6 +23,12 @@ impl<'a> VmFacade<'a> {
|
||||
signals: &InputSignals,
|
||||
platform: &mut dyn RuntimePlatform,
|
||||
) -> Option<CrashReport> {
|
||||
if self.os.lifecycle().task_state(task_id) != Some(crate::task::TaskState::Foreground) {
|
||||
return None;
|
||||
}
|
||||
if self.os.vm_sessions.for_task(task_id).is_some_and(|s| s.lifecycle_transition.is_some()) {
|
||||
return self.drive_lifecycle(task_id, platform, false).err();
|
||||
}
|
||||
self.deliver_pending_game_lifecycle_events_to_session(task_id);
|
||||
|
||||
let Some(session) = self.os.vm_sessions.for_task_mut(task_id) else {
|
||||
@@ -44,6 +51,104 @@ impl<'a> VmFacade<'a> {
|
||||
)
|
||||
}
|
||||
|
||||
/// Firmware polls this before dispatching ordinary Game/Shell updates.
|
||||
pub fn poll_pending_lifecycle(
|
||||
&mut self,
|
||||
platform: &mut dyn RuntimePlatform,
|
||||
) -> Option<(TaskId, Result<(), CrashReport>)> {
|
||||
let task_id = self.os.foreground_stack.resident_game_task()?;
|
||||
self.os.vm_sessions.for_task(task_id)?.lifecycle_transition?;
|
||||
Some((task_id, self.drive_lifecycle(task_id, platform, false)))
|
||||
}
|
||||
|
||||
fn drive_lifecycle(
|
||||
&mut self,
|
||||
task_id: TaskId,
|
||||
platform: &mut dyn RuntimePlatform,
|
||||
single_step: bool,
|
||||
) -> Result<(), CrashReport> {
|
||||
self.deliver_pending_game_lifecycle_events_to_session(task_id);
|
||||
let session = self.os.vm_sessions.for_task_mut(task_id).expect("pending lifecycle session");
|
||||
let transition = session.lifecycle_transition.expect("pending lifecycle transition");
|
||||
let role = transition.role();
|
||||
// A fatal hook remains failed even if a caller tries to tick the same session again.
|
||||
if let Some(report) = &session.runtime.last_crash_report {
|
||||
return Err(report.clone());
|
||||
}
|
||||
let reason = if !session.lifecycle_started {
|
||||
session.lifecycle_started = true;
|
||||
match session.vm.begin_lifecycle(role) {
|
||||
Ok(true) => None,
|
||||
Ok(false) => Some(LogicalFrameEndingReason::LifecycleComplete),
|
||||
Err(error) => Some(LogicalFrameEndingReason::Panic(format!("{error:?}"))),
|
||||
}
|
||||
} else {
|
||||
None
|
||||
};
|
||||
let reason = reason.unwrap_or_else(|| {
|
||||
session.runtime.tick_lifecycle(
|
||||
&mut self.os.log_service,
|
||||
&mut self.os.fs,
|
||||
&mut session.fs_state,
|
||||
&mut self.os.memcard,
|
||||
&mut session.open_files,
|
||||
&mut session.next_handle,
|
||||
&mut session.vm,
|
||||
platform,
|
||||
single_step,
|
||||
)
|
||||
});
|
||||
match reason {
|
||||
LogicalFrameEndingReason::BudgetExhausted | LogicalFrameEndingReason::Breakpoint => {
|
||||
Ok(())
|
||||
}
|
||||
LogicalFrameEndingReason::LifecycleComplete => {
|
||||
session.lifecycle_transition = None;
|
||||
session.lifecycle_started = false;
|
||||
match transition {
|
||||
LifecycleTransition::PauseToHub => {
|
||||
session.pause_hook_complete = true;
|
||||
self.os.lifecycle().suspend_task(task_id).expect("validated suspension");
|
||||
}
|
||||
LifecycleTransition::PauseToShell(shell) => {
|
||||
session.pause_hook_complete = true;
|
||||
self.os
|
||||
.lifecycle()
|
||||
.set_shell_foreground_task(shell)
|
||||
.expect("validated Shell transition");
|
||||
}
|
||||
LifecycleTransition::Resume => {
|
||||
self.os
|
||||
.foreground_stack
|
||||
.complete_resume_game(task_id)
|
||||
.expect("validated resume");
|
||||
}
|
||||
}
|
||||
Ok(())
|
||||
}
|
||||
LogicalFrameEndingReason::Halted => {
|
||||
// HALT ends the session; it must never restore or resume gameplay.
|
||||
session.lifecycle_transition = None;
|
||||
self.os.lifecycle().close_task(task_id).expect("validated task");
|
||||
Ok(())
|
||||
}
|
||||
failure => {
|
||||
let report = match failure {
|
||||
LogicalFrameEndingReason::Trap(mut trap) => {
|
||||
trap.message = format!("{role:?}: {}", trap.message);
|
||||
CrashReport::VmTrap { trap }
|
||||
}
|
||||
other => CrashReport::VmPanic {
|
||||
message: format!("{role:?} lifecycle failed: {other:?}"),
|
||||
pc: Some(session.vm.pc() as u32),
|
||||
},
|
||||
};
|
||||
session.runtime.last_crash_report = Some(report.clone());
|
||||
Err(report)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
fn deliver_pending_game_lifecycle_events_to_session(&mut self, task_id: TaskId) {
|
||||
let Some(session) = self.os.vm_sessions.for_task(task_id) else {
|
||||
return;
|
||||
@@ -85,6 +190,12 @@ impl<'a> VmFacade<'a> {
|
||||
pc: None,
|
||||
});
|
||||
};
|
||||
if self.os.lifecycle().task_state(task_id) != Some(crate::task::TaskState::Foreground) {
|
||||
return None;
|
||||
}
|
||||
if self.os.vm_sessions.for_task(task_id).is_some_and(|s| s.lifecycle_transition.is_some()) {
|
||||
return self.drive_lifecycle(task_id, platform, true).err();
|
||||
}
|
||||
let Some(session) = self.os.vm_sessions.for_task_mut(task_id) else {
|
||||
return Some(CrashReport::VmPanic {
|
||||
message: format!("active debug task {:?} has no VM session", task_id),
|
||||
|
||||
Reference in New Issue
Block a user