Skip to main content

Decoded

Struct Decoded 

Source
pub struct Decoded {
    pub op: Op,
    pub rs: u8,
    pub rt: u8,
    pub rd: u8,
    pub sa: u32,
    pub imm: u16,
    pub dest: u8,
    pub target: u32,
}
Expand description

A decoded instruction: the operation plus its raw encoded fields.

The fields are kept as encoded (rs, rt, rd, sa, imm) rather than resolved into “operands”, because the load-delay interlock matches on the fields whether or not they are used as sources (see crate::pipeline::load_interlocks). Resolving them away would make that check impossible to state correctly.

Fields§

§op: Op

The operation.

§rs: u8

rs field, bits 25..21.

§rt: u8

rt field, bits 20..16.

§rd: u8

rd field, bits 15..11.

§sa: u32

Shift amount, bits 10..6 — already adjusted by +32 for the *32 forms, so it is the effective amount the shift helpers expect.

§imm: u16

Immediate, bits 15..0, unextended.

§dest: u8

The general register this writes, or 0 for none. $zero is never actually written, so 0 doubles as “no destination”.

§target: u32

The J-type 26-bit target field, bits 25..0. Shifted left 2 and combined with the delay slot’s region bits to form the address.

Implementations§

Source§

impl Decoded

Source

pub const fn is_load(self) -> bool

Does this instruction load into a general register?

The load-delay interlock keys off this: only a load result is unavailable in time to bypass, which is why the interlock exists at all.

Source

pub const fn is_store_conditional(self) -> bool

Does this instruction write rt with a value the DC stage produces without going to memory for it?

SC/SCD are the only such forms: they write the success flag to rt whether or not the store happens (UM §16 p. 487, “A successful SC instruction sets the contents of general purpose register rt to 1; an unsuccessful SC instruction sets it to 0”). They are therefore stores that also have a register destination — a shape nothing else in the integer set has, and one that a is_load-vs-store dichotomy silently gets wrong in both directions.

Deliberately not folded into Self::is_load: the load-delay interlock exists because a memory result is not ready in time, and the SC flag is not a memory result. Treating it as a load would stall a cycle the hardware does not.

Source

pub const fn targets_fpr(self) -> bool

Does this instruction target a floating-point register?

Always false for the integer subset. Present because the load-delay interlock does not cross the GPR/FPR boundary, so the check needs to know which file a destination belongs to.

Trait Implementations§

Source§

impl Clone for Decoded

Source§

fn clone(&self) -> Decoded

Returns a duplicate of the value. Read more
1.0.0 · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for Decoded

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Default for Decoded

Source§

fn default() -> Decoded

Returns the “default value” for a type. Read more
Source§

impl<'de> Deserialize<'de> for Decoded

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl PartialEq for Decoded

Source§

fn eq(&self, other: &Decoded) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Serialize for Decoded

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl Copy for Decoded

Source§

impl Eq for Decoded

Source§

impl StructuralPartialEq for Decoded

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,