From 6cdb6e30f5deafa936afc26afd7b1e11ecd2117b Mon Sep 17 00:00:00 2001 From: bunnie Date: Mon, 30 Oct 2023 23:58:08 +0800 Subject: [PATCH 1/5] revert patch-out of xous-api --- Cargo.toml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Cargo.toml b/Cargo.toml index 598364241..10f2c6b66 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -187,7 +187,7 @@ path = "./svd2utra" # path = "./api/xous-api-names" # [patch.crates-io.xous-api-susres] # path = "./api/xous-api-susres" -[patch.crates-io.xous-api-log] -path = "./api/xous-api-log" +# [patch.crates-io.xous-api-log] +# path = "./api/xous-api-log" # [patch.crates-io.xous-api-ticktimer] # path = "./api/xous-api-ticktimer" From 57c00987b822c1092e6c3025759faf90c7b69f69 Mon Sep 17 00:00:00 2001 From: bunnie Date: Mon, 30 Oct 2023 23:58:40 +0800 Subject: [PATCH 2/5] cleanup formatting; terminate process on panic; add missing unsafe{} this is some general clean-up on the code to get it in line with the rest of the guidelines in the system + addresses some of @xobs comments. --- apps/app-loader/spawn/src/main.rs | 155 +++++---- apps/app-loader/src/api.rs | 541 ++++++++++++++++++++---------- apps/app-loader/src/main.rs | 48 +-- apps/app-loader/src/spawn.bin | Bin 23536 -> 21452 bytes 4 files changed, 477 insertions(+), 267 deletions(-) diff --git a/apps/app-loader/spawn/src/main.rs b/apps/app-loader/spawn/src/main.rs index 4369a7b7d..699725170 100644 --- a/apps/app-loader/spawn/src/main.rs +++ b/apps/app-loader/spawn/src/main.rs @@ -11,7 +11,7 @@ impl From for StartupCommand { fn from(src: xous::MessageId) -> StartupCommand { match src { 1 => StartupCommand::LoadElf, - 2 => StartupCommand::PingResponse, + 2 => StartupCommand::PingResponse, _ => StartupCommand::Unhandled, } } @@ -20,7 +20,7 @@ impl From for StartupCommand { #[panic_handler] fn handle_panic(arg: &core::panic::PanicInfo) -> ! { log::info!("{arg}"); - loop {} + xous::terminate_process(1); } #[no_mangle] @@ -29,18 +29,27 @@ pub extern "C" fn init(server1: u32, server2: u32, server3: u32, server4: u32) - // recreate the extra sections that were cut out of the stub { - let mut memory = xous::map_memory( - None, - core::num::NonZeroUsize::new(0x40000000), - 0x1000, - xous::MemoryFlags::R | xous::MemoryFlags::W - ).unwrap(); - let connection = core::sync::atomic::AtomicU32::new(0); - let slice = unsafe { core::slice::from_raw_parts(&connection as *const _ as *const u8, core::mem::size_of::()) }; - for (dest, src) in memory.as_slice_mut::().iter_mut().skip(8).zip(slice) { - *dest = *src; - } - // everything should drop now + let mut memory = xous::map_memory( + None, + core::num::NonZeroUsize::new(0x40000000), + 0x1000, + xous::MemoryFlags::R | xous::MemoryFlags::W, + ) + .unwrap(); + let connection = core::sync::atomic::AtomicU32::new(0); + let slice = unsafe { + core::slice::from_raw_parts( + &connection as *const _ as *const u8, + core::mem::size_of::(), + ) + }; + // safety: memory is freshly allocated by map_memory, should be aligned and init'd to 0 + unsafe { + for (dest, src) in memory.as_slice_mut::().iter_mut().skip(8).zip(slice) { + *dest = *src; + } + } + // everything should drop now } log_server::init_wait().unwrap(); @@ -52,12 +61,12 @@ pub extern "C" fn init(server1: u32, server2: u32, server3: u32, server4: u32) - { match envelope.id().into() { StartupCommand::LoadElf => { - let entry_point = read_elf(envelope.body.memory_message_mut()); - drop(envelope); // we have to get rid of all messages to destroy the server - // destroy the server - xous::destroy_server(server).expect("Couldn't destroy spawn server"); - jump(entry_point); - }, + let entry_point = read_elf(envelope.body.memory_message_mut()); + drop(envelope); // we have to get rid of all messages to destroy the server + // destroy the server + xous::destroy_server(server).expect("Couldn't destroy spawn server"); + jump(entry_point); + } StartupCommand::PingResponse => ping_response(envelope), _ => panic!("Unsupported"), } @@ -80,7 +89,8 @@ fn read_elf(memory: Option<&mut xous::MemoryMessage>) -> usize { }; // get the elf binary from the message - let mut bin = memory.buf.as_slice::(); + // safety: buf should be aligned and correctly sized inside the MemoryMessage + let mut bin = unsafe {memory.buf.as_slice::()}; // go to the beginning of the ELF file using the provided offset bin = &bin[memory.offset.and_then(|n| Some(n.get())).unwrap_or(0)..]; @@ -92,17 +102,17 @@ fn read_elf(memory: Option<&mut xous::MemoryMessage>) -> usize { // a helper function to get a region of the file as a usize let to_usize = |start, size| { - if size == 1 { - return bin[start] as usize; - } - if size == 2 { - // assumes little endianness - return u16::from_le_bytes(bin[start..start+size].try_into().unwrap()) as usize; - } - if size == 4 { - return u32::from_le_bytes(bin[start..start+size].try_into().unwrap()) as usize; - } - panic!("Tried to get usize of invalid size!"); + if size == 1 { + return bin[start] as usize; + } + if size == 2 { + // assumes little endianness + return u16::from_le_bytes(bin[start..start + size].try_into().unwrap()) as usize; + } + if size == 4 { + return u32::from_le_bytes(bin[start..start + size].try_into().unwrap()) as usize; + } + panic!("Tried to get usize of invalid size!"); }; // some basic stuff to know @@ -113,40 +123,59 @@ fn read_elf(memory: Option<&mut xous::MemoryMessage>) -> usize { // add the segments we should load for i in 0..ph_count { - let start = ph_start + i * ph_size; - // only load PT_LOAD segments - if to_usize(start, 4) == 0x00000001 { - let src_addr = to_usize(start+0x04, 4); - let vaddr = to_usize(start+0x08, 4); - let padding = if vaddr & 0xFFF == 0 { 0 } else { vaddr & 0xFFF }; - let file_size = to_usize(start+0x10, 4); - let mem_size = to_usize(start+0x14, 4); - let mem_size = mem_size + padding; - let mem_size = mem_size + if mem_size & 0xFFF == 0 { 0 } else { 0x1000 - (mem_size & 0xFFF) }; + let start = ph_start + i * ph_size; + // only load PT_LOAD segments + if to_usize(start, 4) == 0x00000001 { + let src_addr = to_usize(start + 0x04, 4); + let vaddr = to_usize(start + 0x08, 4); + let padding = if vaddr & 0xFFF == 0 { 0 } else { vaddr & 0xFFF }; + let file_size = to_usize(start + 0x10, 4); + let mem_size = to_usize(start + 0x14, 4); + let mem_size = mem_size + padding; + let mem_size = mem_size + + if mem_size & 0xFFF == 0 { + 0 + } else { + 0x1000 - (mem_size & 0xFFF) + }; - assert_eq!(0, mem_size & 0xFFF); - assert_eq!(0, (vaddr - padding) & 0xFFF); + assert_eq!(0, mem_size & 0xFFF); + assert_eq!(0, (vaddr - padding) & 0xFFF); - log::info!("Loading offset {} to virtual address {} with memory size {}", src_addr, vaddr, mem_size); - let mut target_memory = xous::map_memory( - None, - core::num::NonZeroUsize::new(vaddr-padding), - mem_size, - xous::MemoryFlags::R | xous::MemoryFlags::W | xous::MemoryFlags::X, - ) - .unwrap(); + log::info!( + "Loading offset {} to virtual address {} with memory size {}", + src_addr, + vaddr, + mem_size + ); + let mut target_memory = xous::map_memory( + None, + core::num::NonZeroUsize::new(vaddr - padding), + mem_size, + xous::MemoryFlags::R | xous::MemoryFlags::W | xous::MemoryFlags::X, + ) + .unwrap(); - for (dest, src) in target_memory.as_slice_mut().iter_mut().skip(padding) - .zip(bin[src_addr..core::cmp::min(max, src_addr+file_size)].iter()) - { - *dest = *src; - } - for dest in target_memory.as_slice_mut().iter_mut().skip(padding+file_size) - .take(mem_size-file_size-padding) - { - *dest = 0; - } - } + // TODO: rationalize why this is safe + unsafe { + for (dest, src) in target_memory + .as_slice_mut() + .iter_mut() + .skip(padding) + .zip(bin[src_addr..core::cmp::min(max, src_addr + file_size)].iter()) + { + *dest = *src; + } + for dest in target_memory + .as_slice_mut() + .iter_mut() + .skip(padding + file_size) + .take(mem_size - file_size - padding) + { + *dest = 0; + } + } + } } memory.offset = None; diff --git a/apps/app-loader/src/api.rs b/apps/app-loader/src/api.rs index b2761f4b3..9a8a39101 100644 --- a/apps/app-loader/src/api.rs +++ b/apps/app-loader/src/api.rs @@ -1,9 +1,12 @@ -use std::io::Read; -use gam::{Gam, MenuItem, UxRegistration, menu_matic, APP_NAME_APP_LOADER, APP_MENU_0_APP_LOADER, APP_MENU_1_APP_LOADER, MenuMatic, TextEntryPayload}; +use crate::SERVER_NAME_APP_LOADER; +use gam::{ + menu_matic, Gam, MenuItem, MenuMatic, TextEntryPayload, UxRegistration, APP_MENU_0_APP_LOADER, + APP_MENU_1_APP_LOADER, APP_NAME_APP_LOADER, +}; +use locales::t; use modals::Modals; use num_traits::ToPrimitive; -use locales::t; -use crate::SERVER_NAME_APP_LOADER; +use std::io::Read; pub(crate) struct AppLoader { gam: Gam, @@ -21,229 +24,405 @@ pub(crate) struct AppLoader { impl AppLoader { pub(crate) fn new(xns: &xous_names::XousNames, sid: &xous::SID) -> AppLoader { - // gam - let gam = Gam::new(xns).expect("can't connect to GAM"); + // gam + let gam = Gam::new(xns).expect("can't connect to GAM"); - // the gam token - let auth = gam.register_ux(UxRegistration { - app_name: xous_ipc::String::from_str(APP_NAME_APP_LOADER), - ux_type: gam::UxType::Modal, - predictor: None, - listener: sid.to_array(), - redraw_id: Opcode::Redraw.to_u32().unwrap(), - gotinput_id: None, - audioframe_id: None, - focuschange_id: None, - rawkeys_id: None - }).expect("Couldn't register").expect("Didn't get an auth token"); + // the gam token + let auth = gam + .register_ux(UxRegistration { + app_name: xous_ipc::String::from_str(APP_NAME_APP_LOADER), + ux_type: gam::UxType::Modal, + predictor: None, + listener: sid.to_array(), + redraw_id: Opcode::Redraw.to_u32().unwrap(), + gotinput_id: None, + audioframe_id: None, + focuschange_id: None, + rawkeys_id: None, + }) + .expect("Couldn't register") + .expect("Didn't get an auth token"); - let modals = Modals::new(xns).expect("Couldn't get modals"); + let modals = Modals::new(xns).expect("Couldn't get modals"); - // a connection to the server - let conn = xns.request_connection_blocking(SERVER_NAME_APP_LOADER).expect("Couldn't connect to server"); + // a connection to the server + let conn = xns + .request_connection_blocking(SERVER_NAME_APP_LOADER) + .expect("Couldn't connect to server"); - // the ticktimer - let ticktimer = ticktimer_server::Ticktimer::new().expect("Couldn't connect to Ticktimer"); + // the ticktimer + let ticktimer = ticktimer_server::Ticktimer::new().expect("Couldn't connect to Ticktimer"); - // the menu - let set_server_item = MenuItem{ name: xous_ipc::String::from_str(t!("apploader.menu.setserver", locales::LANG)), - action_conn: Some(conn), - action_opcode: Opcode::SetServer.to_u32().unwrap(), - action_payload: gam::MenuPayload::Scalar([0, 0, 0, 0]), - close_on_select: true }; - let close_item = MenuItem{ name: xous_ipc::String::from_str(t!("apploader.close", locales::LANG)), - action_conn: None, - action_opcode: 0, - action_payload: gam::MenuPayload::Scalar([0, 0, 0, 0]), - close_on_select: true }; - let menu = menu_matic(vec![set_server_item, close_item.clone()], APP_MENU_0_APP_LOADER, Some(xous::create_server().unwrap())).expect("Couldn't create menu"); - let load_menu = menu_matic(vec![close_item.clone()], APP_MENU_1_APP_LOADER, Some(xous::create_server().unwrap())).expect("Couldn't create menu"); + // the menu + let set_server_item = MenuItem { + name: xous_ipc::String::from_str(t!("apploader.menu.setserver", locales::LANG)), + action_conn: Some(conn), + action_opcode: Opcode::SetServer.to_u32().unwrap(), + action_payload: gam::MenuPayload::Scalar([0, 0, 0, 0]), + close_on_select: true, + }; + let close_item = MenuItem { + name: xous_ipc::String::from_str(t!("apploader.close", locales::LANG)), + action_conn: None, + action_opcode: 0, + action_payload: gam::MenuPayload::Scalar([0, 0, 0, 0]), + close_on_select: true, + }; + let menu = menu_matic( + vec![set_server_item, close_item.clone()], + APP_MENU_0_APP_LOADER, + Some(xous::create_server().unwrap()), + ) + .expect("Couldn't create menu"); + let load_menu = menu_matic( + vec![close_item.clone()], + APP_MENU_1_APP_LOADER, + Some(xous::create_server().unwrap()), + ) + .expect("Couldn't create menu"); - AppLoader{ gam, modals, auth, conn, ticktimer, menu, load_menu, apps: Vec::new(), possible_apps: Vec::new(), server: None, current_menu: APP_MENU_0_APP_LOADER.to_string() } + AppLoader { + gam, + modals, + auth, + conn, + ticktimer, + menu, + load_menu, + apps: Vec::new(), + possible_apps: Vec::new(), + server: None, + current_menu: APP_MENU_0_APP_LOADER.to_string(), + } } pub(crate) fn add_app(&mut self, index: usize) { - let (name, menus) = self.possible_apps[index]; + let (name, menus) = self.possible_apps[index]; - self.modals.start_progress(t!("apploader.addapp.loading", locales::LANG), 0, 3, 0).expect("Couldn't set up progress bar"); + self.modals + .start_progress(t!("apploader.addapp.loading", locales::LANG), 0, 3, 0) + .expect("Couldn't set up progress bar"); - ////////////////////////// - // The downloading part // - ////////////////////////// - let response = match ureq::get(&format!("{}/{}", self.server.as_ref().expect("AddApp was somehow called without a server!"), name)).call() { - Ok(response) => response, - Err(e) => { - self.modals.show_notification(&format!("{}{}", t!("apploader.addapp.server_error", locales::LANG), e), None).expect("Couldn't show modal"); - return; - } - }; + ////////////////////////// + // The downloading part // + ////////////////////////// + let response = match ureq::get(&format!( + "{}/{}", + self.server + .as_ref() + .expect("AddApp was somehow called without a server!"), + name + )) + .call() + { + Ok(response) => response, + Err(e) => { + self.modals + .show_notification( + &format!( + "{}{}", + t!("apploader.addapp.server_error", locales::LANG), + e + ), + None, + ) + .expect("Couldn't show modal"); + return; + } + }; - let len = match response.header("Content-Length") { - Some(len) => len.parse::().expect("Couldn't parse Content-Length header"), - None => { - self.modals.show_notification(t!("apploader.addapp.content_length_error", locales::LANG), None).expect("Couldn't show modal"); - return; - } - }; + let len = match response.header("Content-Length") { + Some(len) => len + .parse::() + .expect("Couldn't parse Content-Length header"), + None => { + self.modals + .show_notification( + t!("apploader.addapp.content_length_error", locales::LANG), + None, + ) + .expect("Couldn't show modal"); + return; + } + }; + let mut memory = xous::map_memory( + None, + None, + len + if len & 0xFFF == 0 { + 0 + } else { + 0x1000 - (len & 0xFFF) + }, + xous::MemoryFlags::R | xous::MemoryFlags::W, + ) + .expect("Couldn't map memory"); + response + .into_reader() + .read_exact(&mut unsafe { memory.as_slice_mut() }[..len]) + .expect("Couldn't read"); - let mut memory = xous::map_memory(None, None, len + if len & 0xFFF == 0 { 0 } else { 0x1000 - (len & 0xFFF) }, xous::MemoryFlags::R | xous::MemoryFlags::W).expect("Couldn't map memory"); - response.into_reader().read_exact(&mut unsafe{ memory.as_slice_mut() }[..len]).expect("Couldn't read"); + self.modals + .update_progress(1) + .expect("Couldn't update progress"); + ////////////////////// + // The loading part // + ////////////////////// - self.modals.update_progress(1).expect("Couldn't update progress"); - ////////////////////// - // The loading part // - ////////////////////// + // create the spawn process + let stub = include_bytes!("spawn.bin"); + let args = xous::ProcessArgs::new( + stub, + xous::MemoryAddress::new(0x2050_1000).unwrap(), + xous::MemoryAddress::new(0x2050_1000).unwrap(), + ); + let spawn = xous::create_process(args).expect("Couldn't create spawn process"); + log::info!("Spawn PID: {}, Spawn CID: {}", spawn.pid, spawn.cid); - // create the spawn process - let stub = include_bytes!("spawn.bin"); - let args = xous::ProcessArgs::new(stub, xous::MemoryAddress::new(0x2050_1000).unwrap(), xous::MemoryAddress::new(0x2050_1000).unwrap()); - let spawn = xous::create_process(args).expect("Couldn't create spawn process"); - log::info!("Spawn PID: {}, Spawn CID: {}", spawn.pid, spawn.cid); + // perform a ping to make sure that spawn is running + let result = + xous::send_message(spawn.cid, xous::Message::new_blocking_scalar(2, 1, 2, 3, 4)) + .unwrap(); + assert_eq!(xous::Result::Scalar1(2), result); - // perform a ping to make sure that spawn is running - let result = xous::send_message( - spawn.cid, - xous::Message::new_blocking_scalar(2, 1, 2, 3, 4), - ) - .unwrap(); - assert_eq!(xous::Result::Scalar1(2), result); + self.modals + .update_progress(2) + .expect("Couldn't update progress"); - self.modals.update_progress(2).expect("Couldn't update progress"); + // load the app from the binary file + let res = xous::send_message( + spawn.cid, + xous::Message::new_lend_mut(1, memory, None, None), + ) + .expect("Couldn't send a message to spawn"); + // we are just going to do some very basic error handling: if the "offset" is None, we are good, otherwise there was a problem + // TODO: make this better. Perhaps Buffer::from_raw_parts? + match res { + xous::Result::MemoryReturned(None, _) => self + .modals + .update_progress(3) + .expect("Couldn't update progress"), + _ => { + self.modals + .finish_progress() + .expect("Couldn't close progressbar"); + self.modals + .show_notification(t!("apploader.addapp.error", locales::LANG), None) + .expect("Couldn't show modal"); + return; + } + } - // load the app from the binary file - let res = xous::send_message(spawn.cid, xous::Message::new_lend_mut(1, memory, None, None)).expect("Couldn't send a message to spawn"); - // we are just going to do some very basic error handling: if the "offset" is None, we are good, otherwise there was a problem - // TODO: make this better. Perhaps Buffer::from_raw_parts? - match res { - xous::Result::MemoryReturned(None, _) => self.modals.update_progress(3).expect("Couldn't update progress"), - _ => { - self.modals.finish_progress().expect("Couldn't close progressbar"); - self.modals.show_notification(t!("apploader.addapp.error", locales::LANG), None).expect("Couldn't show modal"); - return; - } - } + ////////////////////// + // back to graphics // + ////////////////////// - ////////////////////// - // back to graphics // - ////////////////////// + // add its name to GAM + self.gam + .register_name(name.to_str(), self.auth) + .expect("Couldn't register name"); + for menu in 0..menus { + self.gam + .register_name(&format!("{} Submenu {}", name, menu), self.auth) + .expect("Couldn't register name"); + } - // add its name to GAM - self.gam.register_name(name.to_str(), self.auth).expect("Couldn't register name"); - for menu in 0..menus { - self.gam.register_name(&format!("{} Submenu {}", name, menu), self.auth).expect("Couldn't register name"); - } + // add it to the menu + self.menu.insert_item( + MenuItem { + name, + action_conn: Some(self.conn), + action_opcode: Opcode::DispatchApp.to_u32().unwrap(), + action_payload: gam::MenuPayload::Scalar([ + self.apps.len().try_into().unwrap(), + 0, + 0, + 0, + ]), + close_on_select: true, + }, + 0, + ); + self.apps.push(name); - // add it to the menu - self.menu.insert_item(MenuItem { name, - action_conn: Some(self.conn), - action_opcode: Opcode::DispatchApp.to_u32().unwrap(), - action_payload: gam::MenuPayload::Scalar([self.apps.len().try_into().unwrap(), 0, 0, 0]), - close_on_select: true }, 0); - self.apps.push(name); + log::info!("Added app `{}'!", name); - log::info!("Added app `{}'!", name); - - self.modals.finish_progress().expect("Couldn't close progressbar"); - let _ = self.gam.switch_to_app(APP_NAME_APP_LOADER, self.auth); // try to switch back to the menu + self.modals + .finish_progress() + .expect("Couldn't close progressbar"); + let _ = self.gam.switch_to_app(APP_NAME_APP_LOADER, self.auth); // try to switch back to the menu } pub(crate) fn set_server(&mut self) { - let payload = self.modals.alert_builder("Server Address") - .field(Some("e.g. http://ip:port".to_string()), Some(|payload: TextEntryPayload| match url::Url::parse(payload.as_str()) { - Ok(_) => None, - Err(e) => Some(xous_ipc::String::from_str(&format!("{}{}", t!("apploader.setserver.error", locales::LANG), e))), - })) - .build() - .ok(); + let payload = self + .modals + .alert_builder("Server Address") + .field( + Some("e.g. http://ip:port".to_string()), + Some( + |payload: TextEntryPayload| match url::Url::parse(payload.as_str()) { + Ok(_) => None, + Err(e) => Some(xous_ipc::String::from_str(&format!( + "{}{}", + t!("apploader.setserver.error", locales::LANG), + e + ))), + }, + ), + ) + .build() + .ok(); - if self.server.is_none() && payload.is_some() { - self.menu.insert_item(MenuItem { name: xous_ipc::String::from_str(t!("apploader.menu.reloadapplist", locales::LANG)), - action_conn: Some(self.conn), - action_opcode: Opcode::ReloadAppList.to_u32().unwrap(), - action_payload: gam::MenuPayload::Scalar([0, 0, 0, 0]), - close_on_select: true }, 0); - self.menu.insert_item(MenuItem { name: xous_ipc::String::from_str(t!("apploader.menu.addapp", locales::LANG)), - action_conn: Some(self.conn), - action_opcode: Opcode::AddAppMenu.to_u32().unwrap(), - action_payload: gam::MenuPayload::Scalar([0, 0, 0, 0]), - close_on_select: true }, 0); - } + if self.server.is_none() && payload.is_some() { + self.menu.insert_item( + MenuItem { + name: xous_ipc::String::from_str(t!( + "apploader.menu.reloadapplist", + locales::LANG + )), + action_conn: Some(self.conn), + action_opcode: Opcode::ReloadAppList.to_u32().unwrap(), + action_payload: gam::MenuPayload::Scalar([0, 0, 0, 0]), + close_on_select: true, + }, + 0, + ); + self.menu.insert_item( + MenuItem { + name: xous_ipc::String::from_str(t!("apploader.menu.addapp", locales::LANG)), + action_conn: Some(self.conn), + action_opcode: Opcode::AddAppMenu.to_u32().unwrap(), + action_payload: gam::MenuPayload::Scalar([0, 0, 0, 0]), + close_on_select: true, + }, + 0, + ); + } - self.server = payload.and_then(|p| Some(p.first().as_str().to_string())); - self.reload_app_list(); + self.server = payload.and_then(|p| Some(p.first().as_str().to_string())); + self.reload_app_list(); } pub(crate) fn open_load_menu(&mut self) { - self.current_menu = APP_MENU_1_APP_LOADER.to_string(); - let _ = self.gam.switch_to_app(APP_NAME_APP_LOADER, self.auth); + self.current_menu = APP_MENU_1_APP_LOADER.to_string(); + let _ = self.gam.switch_to_app(APP_NAME_APP_LOADER, self.auth); } pub(crate) fn reload_app_list(&mut self) { - // without a path, the server responds with a JSON list of strings representing the list of app names - self.modals.start_progress(t!("apploader.reloadapplist.loading", locales::LANG), 0, 3, 0).expect("Couldn't start progressbar"); + // without a path, the server responds with a JSON list of strings representing the list of app names + self.modals + .start_progress( + t!("apploader.reloadapplist.loading", locales::LANG), + 0, + 3, + 0, + ) + .expect("Couldn't start progressbar"); - let old = self.possible_apps.clone(); + let old = self.possible_apps.clone(); - // this... disgusting error handling is so that if there is an error on the server side there isn't a panic - self.possible_apps = match - match ureq::get(&self.server.as_ref().expect("ReloadAppList was somehow called without a server!")).call() { - Ok(c) => { self.modals.update_progress(1).expect("Couldn't update progress"); c }, - Err(e) => { - self.modals.show_notification(&format!("{}{}", t!("apploader.reloadapplist.connection_error", locales::LANG), e), None).expect("Couldn't show modal"); - return; - } - } - .into_json::>() - { - Ok(json) => { self.modals.update_progress(2).expect("Couldn't update progress"); json }, - Err(e) => { - self.modals.show_notification(&format!("{}{}", t!("apploader.reloadapplist.json_error", locales::LANG), e), None).expect("Couldn't show modal"); - return; - } - } - .iter() - .map(|(name, menus)| (xous_ipc::String::<64>::from_str(&name), *menus)) - .collect(); + // this... disgusting error handling is so that if there is an error on the server side there isn't a panic + self.possible_apps = match match ureq::get( + &self + .server + .as_ref() + .expect("ReloadAppList was somehow called without a server!"), + ) + .call() + { + Ok(c) => { + self.modals + .update_progress(1) + .expect("Couldn't update progress"); + c + } + Err(e) => { + self.modals + .show_notification( + &format!( + "{}{}", + t!("apploader.reloadapplist.connection_error", locales::LANG), + e + ), + None, + ) + .expect("Couldn't show modal"); + return; + } + } + .into_json::>() + { + Ok(json) => { + self.modals + .update_progress(2) + .expect("Couldn't update progress"); + json + } + Err(e) => { + self.modals + .show_notification( + &format!( + "{}{}", + t!("apploader.reloadapplist.json_error", locales::LANG), + e + ), + None, + ) + .expect("Couldn't show modal"); + return; + } + } + .iter() + .map(|(name, menus)| (xous_ipc::String::<64>::from_str(&name), *menus)) + .collect(); - for (old_name, _) in old { - self.load_menu.delete_item(old_name.as_str().unwrap()); - } + for (old_name, _) in old { + self.load_menu.delete_item(old_name.as_str().unwrap()); + } - for (i, (app, _)) in self.possible_apps.iter().enumerate() { - self.load_menu.insert_item(MenuItem { name: xous_ipc::String::from_str(app.to_str()), - action_conn: Some(self.conn), - action_opcode: Opcode::AddApp.to_u32().unwrap(), - action_payload: gam::MenuPayload::Scalar([i.try_into().unwrap(), 0, 0, 0]), - close_on_select: true }, 0); - } - self.modals.finish_progress().expect("Couldn't close progress bar"); + for (i, (app, _)) in self.possible_apps.iter().enumerate() { + self.load_menu.insert_item( + MenuItem { + name: xous_ipc::String::from_str(app.to_str()), + action_conn: Some(self.conn), + action_opcode: Opcode::AddApp.to_u32().unwrap(), + action_payload: gam::MenuPayload::Scalar([i.try_into().unwrap(), 0, 0, 0]), + close_on_select: true, + }, + 0, + ); + } + self.modals + .finish_progress() + .expect("Couldn't close progress bar"); - let _ = self.gam.switch_to_app(APP_NAME_APP_LOADER, self.auth); // try to switch back to the menu + let _ = self.gam.switch_to_app(APP_NAME_APP_LOADER, self.auth); // try to switch back to the menu } pub(crate) fn dispatch_app(&self, index: usize) { - if index < self.apps.len() { - let name: xous_ipc::String<64> = self.apps[index]; - log::info!("Switching to app `{}'", name); - self.gam.switch_to_app(name.as_ref(), self.auth).expect(&format!("Could not dispatch app `{}'", name)); - } else { - panic!("Unrecognized app index"); - } + if index < self.apps.len() { + let name: xous_ipc::String<64> = self.apps[index]; + log::info!("Switching to app `{}'", name); + self.gam + .switch_to_app(name.as_ref(), self.auth) + .expect(&format!("Could not dispatch app `{}'", name)); + } else { + panic!("Unrecognized app index"); + } } pub(crate) fn redraw(&mut self) { - // Properly close the app menu - // for anyone who needs this I found this in Menu::key_event - self.gam.relinquish_focus().unwrap(); - xous::yield_slice(); + // Properly close the app menu + // for anyone who needs this I found this in Menu::key_event + self.gam.relinquish_focus().unwrap(); + xous::yield_slice(); - self.ticktimer.sleep_ms(100).ok(); // yield for a moment to allow the previous menu to close + self.ticktimer.sleep_ms(100).ok(); // yield for a moment to allow the previous menu to close - // open the submenu if possible - let _ = self.gam.raise_menu(&self.current_menu); - // we only ever need the other menu for one thing - self.current_menu = APP_MENU_0_APP_LOADER.to_string(); + // open the submenu if possible + let _ = self.gam.raise_menu(&self.current_menu); + // we only ever need the other menu for one thing + self.current_menu = APP_MENU_0_APP_LOADER.to_string(); } } @@ -265,5 +444,5 @@ pub(crate) enum Opcode { DispatchApp, /// Redraw the UI - Redraw + Redraw, } diff --git a/apps/app-loader/src/main.rs b/apps/app-loader/src/main.rs index 06eb68e6e..f7fd08f2d 100644 --- a/apps/app-loader/src/main.rs +++ b/apps/app-loader/src/main.rs @@ -10,34 +10,36 @@ fn main() -> ! { log::info!("my PID is {}", xous::process::id()); let xns = xous_names::XousNames::new().unwrap(); - let sid = xns.register_name(SERVER_NAME_APP_LOADER, None).expect("Couldn't create server"); + let sid = xns + .register_name(SERVER_NAME_APP_LOADER, None) + .expect("Couldn't create server"); // start off by adding hello world let mut app_loader = AppLoader::new(&xns, &sid); loop { - let msg = xous::receive_message(sid).unwrap(); + let msg = xous::receive_message(sid).unwrap(); match FromPrimitive::from_usize(msg.body.id()).expect("Couldn't load message") { - Opcode::SetServer => { - app_loader.set_server(); - }, - Opcode::ReloadAppList => { - app_loader.reload_app_list(); - }, - Opcode::AddAppMenu => { - app_loader.open_load_menu(); - }, - Opcode::AddApp => { - let index = msg.body.scalar_message().expect("Not a scalar").arg1; - app_loader.add_app(index); - }, - Opcode::DispatchApp => { - let index = msg.body.scalar_message().expect("Not a scalar").arg1; - app_loader.dispatch_app(index); - }, - Opcode::Redraw => { - app_loader.redraw(); - }, - } + Opcode::SetServer => { + app_loader.set_server(); + } + Opcode::ReloadAppList => { + app_loader.reload_app_list(); + } + Opcode::AddAppMenu => { + app_loader.open_load_menu(); + } + Opcode::AddApp => { + let index = msg.body.scalar_message().expect("Not a scalar").arg1; + app_loader.add_app(index); + } + Opcode::DispatchApp => { + let index = msg.body.scalar_message().expect("Not a scalar").arg1; + app_loader.dispatch_app(index); + } + Opcode::Redraw => { + app_loader.redraw(); + } + } } } diff --git a/apps/app-loader/src/spawn.bin b/apps/app-loader/src/spawn.bin index 80e8c51fd3577f339e8b2d59d52d4e86409350a4..b479ecd844feea7185d62efb22a4b4c92c5361d7 100644 GIT binary patch literal 21452 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 From c3464858329aa775417732700343137f3f8e4830 Mon Sep 17 00:00:00 2001 From: bunnie Date: Tue, 31 Oct 2023 00:18:42 +0800 Subject: [PATCH 3/5] isolate unsafe app loading features behind `unsafe-app-loading` feature gate --- services/gam/Cargo.toml | 1 + services/gam/src/api.rs | 4 +++- services/gam/src/contexts.rs | 3 ++- services/gam/src/lib.rs | 15 +++++++------- services/gam/src/main.rs | 14 ++++++++----- services/gam/src/tokens.rs | 40 +++++++++++++++++++++++------------- 6 files changed, 49 insertions(+), 28 deletions(-) diff --git a/services/gam/Cargo.toml b/services/gam/Cargo.toml index ec9b4d837..f14d489d4 100644 --- a/services/gam/Cargo.toml +++ b/services/gam/Cargo.toml @@ -52,3 +52,4 @@ tts = [] # default = ["debugprint"] # "debugprint" default = [] ditherpunk = [] +unsafe-app-loading = [] # allow new contexts to be registered dynamically - this is unsafe and should not be set for release builds. diff --git a/services/gam/src/api.rs b/services/gam/src/api.rs index 82b79e999..ff995df69 100644 --- a/services/gam/src/api.rs +++ b/services/gam/src/api.rs @@ -110,6 +110,7 @@ pub struct UxRegistration { /// If the LayoutType is not an App, this field is ignored and does nothing pub focuschange_id: Option, } +#[cfg(feature="unsafe-app-loading")] #[derive(Debug, rkyv::Archive, rkyv::Serialize, rkyv::Deserialize, Copy, Clone)] pub struct NameRegistration { pub name: String::<128>, @@ -217,7 +218,8 @@ pub(crate) enum Opcode { /// This resolves race conditions that depend upon the PDDB configurations. AllowMainMenu = 33, - /// Register a name that can aquire a token. This is only intended to be used with pre-registered apps + /// Register a name that can acquire a token. This is only intended to be used with pre-registered apps + #[cfg(feature="unsafe-app-loading")] RegisterName = 34, } diff --git a/services/gam/src/contexts.rs b/services/gam/src/contexts.rs index e27e5ad34..4ef21dcfd 100644 --- a/services/gam/src/contexts.rs +++ b/services/gam/src/contexts.rs @@ -130,8 +130,9 @@ impl ContextManager { pub(crate) fn claim_token(&mut self, name: &str) -> Option<[u32; 4]> { self.tm.claim_token(name) } + #[cfg(feature="unsafe-app-loading")] pub(crate) fn register_name(&mut self, name: &str, auth_token: &[u32; 4]) { - self.tm.register_name(name, auth_token); + self.tm.register_name(name, auth_token); } pub(crate) fn allow_untrusted_code(&self) -> bool { self.tm.allow_untrusted_code() diff --git a/services/gam/src/lib.rs b/services/gam/src/lib.rs index 88ce6d5ee..5ead4ecd3 100644 --- a/services/gam/src/lib.rs +++ b/services/gam/src/lib.rs @@ -311,14 +311,15 @@ impl Gam { Ok(returned_claim.token) } + #[cfg(feature="unsafe-app-loading")] pub fn register_name(&self, name: &str, auth_token: [u32; 4]) -> Result<(), xous::Error> { - let name_registration = NameRegistration { - name: String::<128>::from_str(name), - auth_token - }; - let buf = Buffer::into_buf(name_registration).or(Err(xous::Error::InternalError))?; - buf.lend(self.conn, Opcode::RegisterName.to_u32().unwrap()).or(Err(xous::Error::InternalError))?; - Ok(()) + let name_registration = NameRegistration { + name: String::<128>::from_str(name), + auth_token + }; + let buf = Buffer::into_buf(name_registration).or(Err(xous::Error::InternalError))?; + buf.lend(self.conn, Opcode::RegisterName.to_u32().unwrap()).or(Err(xous::Error::InternalError))?; + Ok(()) } pub fn set_predictor_api_token(&self, api_token: [u32; 4], gam_token: [u32; 4]) -> Result<(), xous::Error> { let at = ApiToken { diff --git a/services/gam/src/main.rs b/services/gam/src/main.rs index 69b248ece..c9667ab20 100644 --- a/services/gam/src/main.rs +++ b/services/gam/src/main.rs @@ -567,6 +567,9 @@ fn wrapped_main() -> ! { // set before the leaving state due to interior-mutability issues (see the block under the debug statement // titled "resolving visibility rules"). The fix is to simply not issue a context switch if it's the same app. // It saves CPU thrashing and also works around this problem. (see issue #145) + #[cfg(not(feature="unsafe-app-loading"))] + let authorized_switchers = vec![MAIN_MENU_NAME, ROOTKEY_MODAL_NAME, gam::STATUS_BAR_NAME]; + #[cfg(feature="unsafe-app-loading")] let authorized_switchers = [&[MAIN_MENU_NAME, ROOTKEY_MODAL_NAME, gam::STATUS_BAR_NAME], gam::EXPECTED_APP_CONTEXTS].concat().to_vec(); for switchers in authorized_switchers { if let Some(auth_token) = context_mgr.find_app_token_by_name(switchers) { @@ -670,11 +673,12 @@ fn wrapped_main() -> ! { context_mgr.allow_mainmenu(); xous::return_scalar(msg.sender, 0).ok(); } - Some(Opcode::RegisterName) => { - let buffer = unsafe { Buffer::from_memory_message(msg.body.memory_message().unwrap()) }; - let registration = buffer.to_original::().unwrap(); - context_mgr.register_name(registration.name.to_str(), ®istration.auth_token); - } + #[cfg(feature="unsafe-app-loading")] + Some(Opcode::RegisterName) => { + let buffer = unsafe { Buffer::from_memory_message(msg.body.memory_message().unwrap()) }; + let registration = buffer.to_original::().unwrap(); + context_mgr.register_name(registration.name.to_str(), ®istration.auth_token); + } Some(Opcode::Quit) => break, None => {log::error!("unhandled message {:?}", msg);} } diff --git a/services/gam/src/tokens.rs b/services/gam/src/tokens.rs index d4c917570..083629ae0 100644 --- a/services/gam/src/tokens.rs +++ b/services/gam/src/tokens.rs @@ -18,6 +18,7 @@ pub(crate) struct NamedToken { } pub(crate) struct TokenManager { tokens: Vec::, + #[cfg(feature="unsafe-app-loading")] extra_names: Vec, trng: trng::Trng, } @@ -25,13 +26,18 @@ impl<'a> TokenManager { pub(crate) fn new(xns: &xous_names::XousNames) -> TokenManager { TokenManager { tokens: Vec::new(), - extra_names: Vec::new(), + #[cfg(feature="unsafe-app-loading")] + extra_names: Vec::new(), trng: trng::Trng::new(&xns).unwrap(), } } /// checks to see if all the slots have been occupied. We can't allow untrusted code to run until all slots have checked in pub(crate) fn allow_untrusted_code(&self) -> bool { - if self.tokens.len() == (EXPECTED_BOOT_CONTEXTS.len() + EXPECTED_APP_CONTEXTS.len() + self.extra_names.len()) { + #[cfg(feature="unsafe-app-loading")] + let expected_len = EXPECTED_BOOT_CONTEXTS.len() + EXPECTED_APP_CONTEXTS.len() + self.extra_names.len(); + #[cfg(not(feature="unsafe-app-loading"))] + let expected_len = EXPECTED_BOOT_CONTEXTS.len() + EXPECTED_APP_CONTEXTS.len(); + if self.tokens.len() == expected_len { true } else { // throw a bone to the dev who has to debug this error. This typically only triggers after a major @@ -53,9 +59,10 @@ impl<'a> TokenManager { if EXPECTED_APP_CONTEXTS.iter().find(|&&context| context == name).is_some() { found = true; } - if self.extra_names.iter().find(|&context| context == name).is_some() { - found = true; - } + #[cfg(feature="unsafe-app-loading")] + if self.extra_names.iter().find(|&context| context == name).is_some() { + found = true; + } if !found { log::error!("Server {} is not pre-registered in gam/lib.rs/EXPECTED_BOOT_CONTEXTS or apps.rs/EXPECTED_APP_CONTEXTS. Did you forget to register it?", name); return None @@ -96,15 +103,20 @@ impl<'a> TokenManager { None } /// Register a new name that can then claim a token. Note that only pre-registered applications are allowed to do this. + #[cfg(feature="unsafe-app-loading")] pub(crate) fn register_name(&mut self, name: &str, auth_token: &[u32; 4]) { - if let Some(registrant) = self.lookup_name(auth_token) { - if EXPECTED_BOOT_CONTEXTS.iter().find(|&&context| context == registrant).is_some() || EXPECTED_APP_CONTEXTS.iter().find(|&&context| context == registrant).is_some() { - self.extra_names.push(name.to_string()); - } else { - log::error!("`{}' does not have permission to register a new name because it is not pre-registered", registrant); - } - } else { - log::error!("Token {:?} does not correspond with a name", auth_token); - } + if let Some(registrant) = self.lookup_name(auth_token) { + if EXPECTED_BOOT_CONTEXTS.iter() + .find( + |&&context| context == registrant).is_some() + || EXPECTED_APP_CONTEXTS.iter() + .find(|&&context| context == registrant).is_some() { + self.extra_names.push(name.to_string()); + } else { + log::error!("`{}' does not have permission to register a new name because it is not pre-registered", registrant); + } + } else { + log::error!("Token {:?} does not correspond with a name", auth_token); + } } } From bd8537f874912f295982989a2f8ae6d323cc2a14 Mon Sep 17 00:00:00 2001 From: bunnie Date: Tue, 31 Oct 2023 00:19:05 +0800 Subject: [PATCH 4/5] update README to note the need for the `unsafe-app-loading` feature --- apps/app-loader/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apps/app-loader/README.md b/apps/app-loader/README.md index 02469a907..0bb974ab4 100644 --- a/apps/app-loader/README.md +++ b/apps/app-loader/README.md @@ -9,7 +9,7 @@ Note that at the moment you can only load apps once each time the device runs si First, add the app loader to your device's image as you would with any other app: ``` -$ cargo xtask app-image-xip --app app-loader +$ cargo xtask app-image-xip --app app-loader --feature unsafe-app-loading $ sudo python3 tools/usb_update.py -k target/riscv32imac-unknown-xous-elf/release/xous.img -l target/riscv32imac-unknown-xous-elf/release/loader.bin ``` Then, compile the apps you would like on your device and start the app server. For example, if you would like to serve the apps `hello`, `ball`, and `vault` on port 8000, run: From 699372d8d3a2c1214b1e90218dcd3f430b062938 Mon Sep 17 00:00:00 2001 From: bunnie Date: Tue, 31 Oct 2023 00:42:25 +0800 Subject: [PATCH 5/5] add hashmarks to the status bar when a new name is registered we can't guarantee that we're running only signed code at this point, so create a visual indicator of this. --- services/gam/src/main.rs | 1 + 1 file changed, 1 insertion(+) diff --git a/services/gam/src/main.rs b/services/gam/src/main.rs index c9667ab20..fbe88933b 100644 --- a/services/gam/src/main.rs +++ b/services/gam/src/main.rs @@ -677,6 +677,7 @@ fn wrapped_main() -> ! { Some(Opcode::RegisterName) => { let buffer = unsafe { Buffer::from_memory_message(msg.body.memory_message().unwrap()) }; let registration = buffer.to_original::().unwrap(); + gfx.set_devboot(); // indicate to users that we are no longer in a codebase that is exclusively trusted code context_mgr.register_name(registration.name.to_str(), ®istration.auth_token); } Some(Opcode::Quit) => break,