mirror of
https://github.com/saymrwulf/xous-core.git
synced 2026-11-15 08:30:02 +00:00
67fc21fbdd
In general, hosted mode is assumed "by default" if the target is not Xous. This allows packages to be built cleanly on command lines that don't know to pass a --feature flag to specify a target. However, an explicit "hosted" flag is still retained so that we can confirm the build system intent. This saves us from the failure mode that we thought we were building for target A, but accidentally ommitted the flag, and instead we've been silently building for "hosted" mode without any warning. The main consumer of the "hosted" flag is now just the build.rs script inside of the utralib.
93 lines
3.3 KiB
Rust
93 lines
3.3 KiB
Rust
pub(crate) const SERVER_NAME_SPINOR: &str = "_SPINOR Hardware Interface Server_";
|
|
|
|
#[cfg(any(feature="precursor", feature="renode"))]
|
|
pub const SPINOR_SIZE_BYTES: u32 = 128 * 1024 * 1024; // physical size of the device, used for hardware sanity checks on requests
|
|
#[cfg_attr(not(target_os = "xous"), allow(dead_code))]
|
|
pub const SPINOR_ERASE_SIZE: u32 = 0x1000; // this is the smallest sector size.
|
|
// note: logical lengths of regions are in xous::definitions
|
|
#[allow(dead_code)]
|
|
pub const SPINOR_BULK_ERASE_SIZE: u32 = 0x1_0000; // this is the bulk erase size.
|
|
|
|
#[derive(num_derive::FromPrimitive, num_derive::ToPrimitive, Debug)]
|
|
pub(crate) enum Opcode {
|
|
/// writes are split into multiple transactions. Must acquire exclusive rights before initiation
|
|
AcquireExclusive = 0,
|
|
ReleaseExclusive = 1,
|
|
/// a special token is reserved for writing to the SoC region, only one service is allowed to do that
|
|
RegisterSocToken = 2,
|
|
/// the SocToken holder can allow for writes to the staging area by other processes
|
|
SetStagingWriteProtect = 3,
|
|
ClearStagingWriteProtect = 4,
|
|
/// program a region. Erase is accomplished by calling WriteRegion with all 0xFF's as data.
|
|
WriteRegion = 5,
|
|
/// bulk erase a region. Has fewer safety checks, used for accelerating the bulk clear of the PDDB for init.
|
|
BulkErase = 6,
|
|
|
|
/// allow the susres manager to prevent new ops from happening during a suspend
|
|
AcquireSuspendLock = 7,
|
|
ReleaseSuspendLock = 8,
|
|
|
|
/// intra-thread messages for suspend and resume
|
|
SuspendInner = 9,
|
|
ResumeInner = 10,
|
|
|
|
/// internal interrupt handler ops
|
|
EccError = 11,
|
|
|
|
/// read out the ECC log
|
|
EccLog = 12,
|
|
}
|
|
// Erase/Write are uninterruptable operations. Split suspend/resume
|
|
// into a separate server to asynchronously manage this.
|
|
#[derive(num_derive::FromPrimitive, num_derive::ToPrimitive, Debug)]
|
|
pub(crate) enum SusResOps {
|
|
/// Suspend/resume callback
|
|
SuspendResume,
|
|
/// exit the thread
|
|
Quit,
|
|
}
|
|
|
|
#[derive(Debug, rkyv::Archive, rkyv::Serialize, rkyv::Deserialize, Clone, Copy)]
|
|
pub(crate) struct WriteRegion {
|
|
/// the exclusive access ID
|
|
pub id: [u32; 4],
|
|
/// start address for the write; address 0 is start of FLASH.
|
|
pub start: u32,
|
|
/// set if the sector was checked to be erased already
|
|
pub clean_patch: bool,
|
|
/// length of data to write
|
|
pub len: u32,
|
|
/// return code
|
|
pub result: Option<SpinorError>,
|
|
/// data to write - up to one page
|
|
pub data: [u8; 4096],
|
|
}
|
|
|
|
#[derive(Debug, rkyv::Archive, rkyv::Serialize, rkyv::Deserialize, Clone, Copy)]
|
|
pub(crate) struct BulkErase {
|
|
/// the exclusive access ID
|
|
pub id: [u32; 4],
|
|
/// start address for the erase; address 0 is start of FLASH. WARNING: This will get rounded down to the nearest 64kiB boundary.
|
|
pub start: u32,
|
|
/// length of data to erase. WARNING: This will always get rounded up to the nearest 64kiB.
|
|
pub len: u32,
|
|
/// return code
|
|
pub result: Option<SpinorError>,
|
|
}
|
|
|
|
#[derive(Debug, rkyv::Archive, rkyv::Serialize, rkyv::Deserialize, Clone, Copy, num_derive::FromPrimitive, num_derive::ToPrimitive)]
|
|
pub enum SpinorError {
|
|
NoError,
|
|
AbortNotErased,
|
|
EraseFailed,
|
|
WriteFailed,
|
|
VerifyFailed,
|
|
InvalidRequest,
|
|
ImplementationError,
|
|
AlignmentError,
|
|
IpcError,
|
|
BusyTryAgain,
|
|
IdMismatch,
|
|
NoId,
|
|
AccessDenied,
|
|
}
|