mpfs-pac 0.4.0

Peripheral Access Crate for PolarFire SoC
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79

#![no_std]

mod bindings;
pub use bindings::*;

mod clint;
pub use clint::*;

mod encoding;
pub use encoding::*;

mod ethernet;
pub use ethernet::*;
mod gpio;
pub use gpio::*;

mod sysreg;
pub use sysreg::*;

mod timer;
pub use timer::*;

mod uart;
pub use uart::*;

mod usb;
pub use usb::*;

pub mod spi;
pub use spi::{QSPI, SPI0, SPI1};

/// Add to a regular address to get the same address in uncached memory
#[cfg(feature = "upper-memory-layout")]
pub const UNCACHED_MEMORY_OFFSET: usize = 0x4_0000_0000;
#[cfg(not(feature = "upper-memory-layout"))]
pub const UNCACHED_MEMORY_OFFSET: usize = 0x1000_0000;

#[inline]
pub fn hart_id() -> usize {
    let mut hart_id: usize;
    unsafe {
        core::arch::asm!("csrr {}, mhartid", out(reg) hart_id);
    }
    hart_id
}

pub fn last_linked_address() -> usize {
    &raw mut __app_hart_common_end as usize
}

pub fn last_address() -> usize {
    let base_address = if cfg!(feature = "upper-memory-layout") {
        0x10_0000_0000
    } else {
        0x8000_0000
    };
    let size_ram = if cfg!(feature = "beaglev-fire") {
        // 2GB
        0x8000_0000
    } else {
        panic!("Unsupported board: No RAM size defined");
    };

    base_address + size_ram
}

pub fn heap_start() -> usize {
    last_linked_address()
}

pub fn heap_end() -> usize {
    let reserved_memory_size = match option_env!("MPFS_RESERVED_MEMORY_SIZE") {
        Some(size) => usize::from_str_radix(size, 16)
            .expect("MPFS_RESERVED_MEMORY_SIZE must be a valid hexadecimal number"),
        None => 0x0,
    };

    last_address() - reserved_memory_size
}