Struct Cpu 

pub struct Cpu { /* private fields */ }

Implementations

impl Cpu

pub fn new() -> Cpu

Examples found in repository

examples/run.rs (line 9)

fn main() {
    let mut cpu = Cpu::new();

    // Override the disk content so task B prints something custom.
    cpu.set_disk_text("hello, aarch64-sim!\n");

    let _retired = cpu.run(4000);

    println!("system steps: {}", cpu.system_steps());
    println!("timer ticks:  {}", cpu.timer_ticks());
    println!("atomic ctr:   {}", cpu.atomic_counter());

    let aic = cpu.aic_state();
    println!("AIC acks:     {}", aic.total_acks);
    println!("IPIs sent:    {}", aic.total_ipis);

    println!("UART output:  {:?}", cpu.output());

    for c in cpu.state() {
        println!(
            "core {}  {}  pc={:#010x}  el={}  wfi={}",
            c.id, c.kind, c.pc, c.current_el, c.wfi_halted,
        );
    }
}

pub fn reset(&mut self)

pub fn step(&mut self) -> bool

Step every core once. On the way in: bump system_steps; if the timer is due, broadcast IRQ_TIMER to all cores via AIC. Each core then either takes a pending IRQ (when DAIF.I is clear) or executes one instruction.

pub fn step_core(&mut self, idx: u32) -> bool

Step a single core. Honours pending IRQs on that core (set either by the system timer in step() or by another core via IPI MMIO).

pub fn run(&mut self, max: u32) -> u32

Examples found in repository

examples/run.rs (line 14)

fn main() {
    let mut cpu = Cpu::new();

    // Override the disk content so task B prints something custom.
    cpu.set_disk_text("hello, aarch64-sim!\n");

    let _retired = cpu.run(4000);

    println!("system steps: {}", cpu.system_steps());
    println!("timer ticks:  {}", cpu.timer_ticks());
    println!("atomic ctr:   {}", cpu.atomic_counter());

    let aic = cpu.aic_state();
    println!("AIC acks:     {}", aic.total_acks);
    println!("IPIs sent:    {}", aic.total_ipis);

    println!("UART output:  {:?}", cpu.output());

    for c in cpu.state() {
        println!(
            "core {}  {}  pc={:#010x}  el={}  wfi={}",
            c.id, c.kind, c.pc, c.current_el, c.wfi_halted,
        );
    }
}

pub fn system_steps(&self) -> u64

Examples found in repository

examples/run.rs (line 16)

fn main() {
    let mut cpu = Cpu::new();

    // Override the disk content so task B prints something custom.
    cpu.set_disk_text("hello, aarch64-sim!\n");

    let _retired = cpu.run(4000);

    println!("system steps: {}", cpu.system_steps());
    println!("timer ticks:  {}", cpu.timer_ticks());
    println!("atomic ctr:   {}", cpu.atomic_counter());

    let aic = cpu.aic_state();
    println!("AIC acks:     {}", aic.total_acks);
    println!("IPIs sent:    {}", aic.total_ipis);

    println!("UART output:  {:?}", cpu.output());

    for c in cpu.state() {
        println!(
            "core {}  {}  pc={:#010x}  el={}  wfi={}",
            c.id, c.kind, c.pc, c.current_el, c.wfi_halted,
        );
    }
}

pub fn timer_period(&self) -> u64

pub fn timer_remaining(&self) -> u64

System steps until the next timer IRQ fires (0 if it’s due now).

pub fn timer_ticks(&self) -> u64

Examples found in repository

examples/run.rs (line 17)

fn main() {
    let mut cpu = Cpu::new();

    // Override the disk content so task B prints something custom.
    cpu.set_disk_text("hello, aarch64-sim!\n");

    let _retired = cpu.run(4000);

    println!("system steps: {}", cpu.system_steps());
    println!("timer ticks:  {}", cpu.timer_ticks());
    println!("atomic ctr:   {}", cpu.atomic_counter());

    let aic = cpu.aic_state();
    println!("AIC acks:     {}", aic.total_acks);
    println!("IPIs sent:    {}", aic.total_ipis);

    println!("UART output:  {:?}", cpu.output());

    for c in cpu.state() {
        println!(
            "core {}  {}  pc={:#010x}  el={}  wfi={}",
            c.id, c.kind, c.pc, c.current_el, c.wfi_halted,
        );
    }
}

pub fn aic_state(&self) -> AicState

Examples found in repository

examples/run.rs (line 20)

fn main() {
    let mut cpu = Cpu::new();

    // Override the disk content so task B prints something custom.
    cpu.set_disk_text("hello, aarch64-sim!\n");

    let _retired = cpu.run(4000);

    println!("system steps: {}", cpu.system_steps());
    println!("timer ticks:  {}", cpu.timer_ticks());
    println!("atomic ctr:   {}", cpu.atomic_counter());

    let aic = cpu.aic_state();
    println!("AIC acks:     {}", aic.total_acks);
    println!("IPIs sent:    {}", aic.total_ipis);

    println!("UART output:  {:?}", cpu.output());

    for c in cpu.state() {
        println!(
            "core {}  {}  pc={:#010x}  el={}  wfi={}",
            c.id, c.kind, c.pc, c.current_el, c.wfi_halted,
        );
    }
}

pub fn block_state(&self) -> BlockState

pub fn set_disk_text(&mut self, text: &str)

Replace disk sector 0 with the given UTF-8 text (padded with zeros to SECTOR_SIZE bytes). Also patches the live disk-buffer page at PA 0x6000 so task B’s printer reflects the change without a reset.

Examples found in repository

examples/run.rs (line 12)

fn main() {
    let mut cpu = Cpu::new();

    // Override the disk content so task B prints something custom.
    cpu.set_disk_text("hello, aarch64-sim!\n");

    let _retired = cpu.run(4000);

    println!("system steps: {}", cpu.system_steps());
    println!("timer ticks:  {}", cpu.timer_ticks());
    println!("atomic ctr:   {}", cpu.atomic_counter());

    let aic = cpu.aic_state();
    println!("AIC acks:     {}", aic.total_acks);
    println!("IPIs sent:    {}", aic.total_ipis);

    println!("UART output:  {:?}", cpu.output());

    for c in cpu.state() {
        println!(
            "core {}  {}  pc={:#010x}  el={}  wfi={}",
            c.id, c.kind, c.pc, c.current_el, c.wfi_halted,
        );
    }
}

pub fn disk_text(&self) -> String

pub fn state(&self) -> Vec<CoreState>

Returns one CoreState per core.

Examples found in repository

examples/run.rs (line 26)

fn main() {
    let mut cpu = Cpu::new();

    // Override the disk content so task B prints something custom.
    cpu.set_disk_text("hello, aarch64-sim!\n");

    let _retired = cpu.run(4000);

    println!("system steps: {}", cpu.system_steps());
    println!("timer ticks:  {}", cpu.timer_ticks());
    println!("atomic ctr:   {}", cpu.atomic_counter());

    let aic = cpu.aic_state();
    println!("AIC acks:     {}", aic.total_acks);
    println!("IPIs sent:    {}", aic.total_ipis);

    println!("UART output:  {:?}", cpu.output());

    for c in cpu.state() {
        println!(
            "core {}  {}  pc={:#010x}  el={}  wfi={}",
            c.id, c.kind, c.pc, c.current_el, c.wfi_halted,
        );
    }
}

pub fn mem_slice(&self, start: u32, len: u32) -> Vec<u8>

pub fn output(&self) -> String

Examples found in repository

examples/run.rs (line 24)

fn main() {
    let mut cpu = Cpu::new();

    // Override the disk content so task B prints something custom.
    cpu.set_disk_text("hello, aarch64-sim!\n");

    let _retired = cpu.run(4000);

    println!("system steps: {}", cpu.system_steps());
    println!("timer ticks:  {}", cpu.timer_ticks());
    println!("atomic ctr:   {}", cpu.atomic_counter());

    let aic = cpu.aic_state();
    println!("AIC acks:     {}", aic.total_acks);
    println!("IPIs sent:    {}", aic.total_ipis);

    println!("UART output:  {:?}", cpu.output());

    for c in cpu.state() {
        println!(
            "core {}  {}  pc={:#010x}  el={}  wfi={}",
            c.id, c.kind, c.pc, c.current_el, c.wfi_halted,
        );
    }
}

pub fn translate(&self, va: u64, core_idx: u32) -> Option<TranslationResult>

Walk page tables for va using the sysregs of core_idx. Returns None if core_idx is out of range.

pub fn entry_pc(&self) -> u64

pub fn uart_addr(&self) -> u64

pub fn l1_table_pa(&self) -> u64

pub fn num_cores(&self) -> u32

pub fn atomic_counter(&self) -> u64

Reads the shared u64 atomic counter at PA 0x6FF8 — task A’s LDXR/STXR loop bumps it once per scheduling round.

Examples found in repository

examples/run.rs (line 18)

fn main() {
    let mut cpu = Cpu::new();

    // Override the disk content so task B prints something custom.
    cpu.set_disk_text("hello, aarch64-sim!\n");

    let _retired = cpu.run(4000);

    println!("system steps: {}", cpu.system_steps());
    println!("timer ticks:  {}", cpu.timer_ticks());
    println!("atomic ctr:   {}", cpu.atomic_counter());

    let aic = cpu.aic_state();
    println!("AIC acks:     {}", aic.total_acks);
    println!("IPIs sent:    {}", aic.total_ipis);

    println!("UART output:  {:?}", cpu.output());

    for c in cpu.state() {
        println!(
            "core {}  {}  pc={:#010x}  el={}  wfi={}",
            c.id, c.kind, c.pc, c.current_el, c.wfi_halted,
        );
    }
}

Trait Implementations

impl Default for Cpu

fn default() -> Self

Returns the “default value” for a type.