Struct emulator::instruction::Instruction

pub struct Instruction { /* fields omitted */ }

Instruction of the 2i.

Represents a 25 bit wide instruction that the 2i uses. Provides some conveniance methods to extract all different parts.

Methods

impl Instruction

pub fn new(instruction: u32) -> Result<Instruction>

Create a new Instruction from a u32. Fails if more than 25 bits are used.

pub fn new_from_string(string: &str) -> Result<Instruction>

Creat a new Instruction from a binary string (consisting only of ones and zeroes). Failes if more than 25 bits (characters) are used.

pub fn new_looping(address: usize) -> Result<Instruction>

pub fn get_instruction(&self) -> u32

Get the instruction as a 25 bit integer (the first 7 most significant bits of the u32 are always zero)

pub fn should_store_flags(&self) -> bool

MCHFLG

pub fn get_alu_instruction(&self) -> u8

MALUS0-3 (4 bit)

pub fn is_alu_input_b_const(&self) -> bool

MALUIB

pub fn is_alu_input_a_bus(&self) -> bool

MALUIA

pub fn should_write_register(&self) -> bool

MRGWE

pub fn should_write_register_b(&self) -> bool

MRGWS

pub fn get_register_address_b(&self) -> usize

MRGAB0-2 (3 bit)

pub fn get_constant_input(&self) -> u8

MRGAB0-3 (4 bit)

pub fn get_register_address_a(&self) -> usize

MRGAA0-2 (3 bit)

pub fn is_bus_enabled(&self) -> bool

BUSEN

pub fn is_bus_writable(&self) -> bool

BUSWR

pub fn get_next_instruction_address(&self) -> u8

NA0-4 (5 bit)

pub fn get_address_control(&self) -> u8

MAC0-1 (2 bit)

pub fn get_full_address_control(&self) -> u8

MAC1-0 + NA0 (3 bit)

pub fn to_mnemonic(&self, address: Option<usize>) -> String

Create a textual representation of the instruction

Optionally, the address of the instruction inside the program can be passed to simplify the resulting string in many cases.

Examples

use emulator::Instruction;

let inst = Instruction::new(0b00_00001_00_000_0110_01_01_0100_0).unwrap();
assert_eq!("R0 = R0 + 6", &inst.to_mnemonic(Some(0)));

Trait Implementations

impl PartialEq<Instruction> for Instruction

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Clone for Instruction

fn clone(&self) -> Instruction

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Instruction

impl Default for Instruction

fn default() -> Instruction

Returns the "default value" for a type.

impl Debug for Instruction

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

Formats the value using the given formatter.