Struct Instruction 

#[repr(C)]
pub struct Instruction {
    pub opcode: Opcode,
    pub op_a: u8,
    pub op_b: u64,
    pub op_c: u64,
    pub imm_b: bool,
    pub imm_c: bool,
}

RISC-V 64IM Instruction.

The structure of the instruction differs from the RISC-V ISA. We do not encode the instructions as 32-bit words, but instead use a custom encoding that is more friendly to decode in the SP1 zkVM.

Fields

opcode: Opcode

The operation to execute.

op_a: u8

The first operand.

op_b: u64

The second operand.

op_c: u64

The third operand.

imm_b: bool

Whether the second operand is an immediate value.

imm_c: bool

Whether the third operand is an immediate value.

Implementations

impl Instruction

pub const fn from_r_type(opcode: Opcode, dec_insn: &RType) -> Self

Create a new Instruction from an R-type instruction.

pub const fn from_i_type(opcode: Opcode, dec_insn: &IType) -> Self

Create a new Instruction from an I-type instruction.

pub const fn from_i_type_shamt(opcode: Opcode, dec_insn: &ITypeShamt) -> Self

Create a new Instruction from an I-type instruction with a shamt.

pub const fn from_i_type_shamt_w(opcode: Opcode, dec_insn: &ITypeShamtW) -> Self

Create a new Instruction from an I-type instruction with a shamt_w.

pub const fn from_s_type(opcode: Opcode, dec_insn: &SType) -> Self

Create a new Instruction from an S-type instruction.

pub const fn from_b_type(opcode: Opcode, dec_insn: &BType) -> Self

Create a new Instruction from a B-type instruction.

pub const fn from_u_type(opcode: Opcode, dec_insn: &UType) -> Self

Create a new Instruction from an U-type instruction.

pub const fn unimp() -> Self

Create a new Instruction that is not implemented.

pub const fn is_r_type(&self) -> bool

Returns if the Instruction is an R-type instruction.

pub const fn is_i_type(&self) -> bool

Returns whether the Instruction is an I-type instruction.

pub fn r_type(&self) -> (Register, Register, Register)

Decode the Instruction in the R-type format.

pub fn i_type(&self) -> (Register, Register, u64)

Decode the Instruction in the I-type format.

pub fn s_type(&self) -> (Register, Register, u64)

Decode the Instruction in the S-type format.

pub fn b_type(&self) -> (Register, Register, u64)

Decode the Instruction in the B-type format.

pub fn j_type(&self) -> (Register, u64)

Decode the Instruction in the J-type format.

pub fn u_type(&self) -> (Register, u64)

Decode the Instruction in the U-type format.

impl Instruction

pub const fn new( opcode: Opcode, op_a: u8, op_b: u64, op_c: u64, imm_b: bool, imm_c: bool, ) -> Self

Create a new [RiscvInstruction].

pub const fn is_alu_instruction(&self) -> bool

Returns if the instruction is an ALU instruction.

pub const fn is_ecall_instruction(&self) -> bool

Returns if the instruction is a ecall instruction.

pub const fn is_memory_load_instruction(&self) -> bool

Returns if the instruction is a memory load instruction.

pub const fn is_memory_store_instruction(&self) -> bool

Returns if the instruction is a memory store instruction.

pub const fn is_branch_instruction(&self) -> bool

Returns if the instruction is a branch instruction.

pub const fn is_jump_instruction(&self) -> bool

Returns if the instruction is a jump instruction.

pub const fn is_jal_instruction(&self) -> bool

Returns if the instruction is a jal instruction.

pub const fn is_jalr_instruction(&self) -> bool

Returns if the instruction is a jalr instruction.

pub const fn is_utype_instruction(&self) -> bool

Returns if the instruction is a utype instruction.

pub const fn is_with_correct_next_pc(&self) -> bool

Returns if the instruction guarantees that the next_pc are with correct limbs.

pub const fn is_divrem_instruction(&self) -> bool

Returns if the instruction is a divrem instruction.

pub const fn is_ebreak_instruction(&self) -> bool

Returns if the instruction is an ebreak instruction.

pub const fn is_unimp_instruction(&self) -> bool

Returns if the instruction is an unimplemented instruction.

pub fn encode(&self) -> u32

Returns the encoded RISC-V instruction.

Trait Implementations

impl Clone for Instruction

fn clone(&self) -> Instruction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Instruction

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

Formats the value using the given formatter.

impl DeepSizeOf for Instruction

fn deep_size_of_children(&self, context: &mut Context) -> usize

Returns an estimation of the heap-managed storage of this object. This does not include the size of the object itself.

fn deep_size_of(&self) -> usize

Returns an estimation of a total size of memory owned by the object, including heap-managed storage.

impl<'de> Deserialize<'de> for Instruction

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Instruction

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Instruction