You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
122 lines
4.0 KiB
Rust
122 lines
4.0 KiB
Rust
// SPDX-License-Identifier: MIT OR Apache-2.0
|
|
//
|
|
// Copyright (c) 2018-2021 Andre Richter <andre.o.richter@gmail.com>
|
|
|
|
//! BSP Memory Management.
|
|
|
|
pub mod mmu;
|
|
|
|
use core::{cell::UnsafeCell, ops::RangeInclusive};
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
// Private Definitions
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
// Symbols from the linker script.
|
|
extern "Rust" {
|
|
static __bss_start: UnsafeCell<u64>;
|
|
static __bss_end_inclusive: UnsafeCell<u64>;
|
|
static __ro_start: UnsafeCell<()>;
|
|
static __ro_end: UnsafeCell<()>;
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
// Public Definitions
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/// The board's memory map.
|
|
#[rustfmt::skip]
|
|
pub(super) mod map {
|
|
/// The inclusive end address of the memory map.
|
|
///
|
|
/// End address + 1 must be power of two.
|
|
///
|
|
/// # Note
|
|
///
|
|
/// RPi3 and RPi4 boards can have different amounts of RAM. To make our code lean for
|
|
/// educational purposes, we set the max size of the address space to 4 GiB regardless of board.
|
|
/// This way, we can map the entire range that we need (end of MMIO for RPi4) in one take.
|
|
///
|
|
/// However, making this trade-off has the downside of making it possible for the CPU to assert a
|
|
/// physical address that is not backed by any DRAM (e.g. accessing an address close to 4 GiB on
|
|
/// an RPi3 that comes with 1 GiB of RAM). This would result in a crash or other kind of error.
|
|
pub const END_INCLUSIVE: usize = 0xFFFF_FFFF;
|
|
|
|
pub const BOOT_CORE_STACK_END: usize = 0x8_0000;
|
|
|
|
pub const GPIO_OFFSET: usize = 0x0020_0000;
|
|
pub const UART_OFFSET: usize = 0x0020_1000;
|
|
|
|
/// Physical devices.
|
|
#[cfg(feature = "bsp_rpi3")]
|
|
pub mod mmio {
|
|
use super::*;
|
|
|
|
pub const START: usize = 0x3F00_0000;
|
|
pub const GPIO_START: usize = START + GPIO_OFFSET;
|
|
pub const PL011_UART_START: usize = START + UART_OFFSET;
|
|
pub const END_INCLUSIVE: usize = 0x4000_FFFF;
|
|
}
|
|
|
|
/// Physical devices.
|
|
#[cfg(feature = "bsp_rpi4")]
|
|
pub mod mmio {
|
|
use super::*;
|
|
|
|
pub const START: usize = 0xFE00_0000;
|
|
pub const GPIO_START: usize = START + GPIO_OFFSET;
|
|
pub const PL011_UART_START: usize = START + UART_OFFSET;
|
|
pub const END_INCLUSIVE: usize = 0xFF84_FFFF;
|
|
}
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
// Private Code
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/// Start address of the Read-Only (RO) range.
|
|
///
|
|
/// # Safety
|
|
///
|
|
/// - Value is provided by the linker script and must be trusted as-is.
|
|
#[inline(always)]
|
|
fn ro_start() -> usize {
|
|
unsafe { __ro_start.get() as usize }
|
|
}
|
|
|
|
/// Size of the Read-Only (RO) range of the kernel binary.
|
|
///
|
|
/// # Safety
|
|
///
|
|
/// - Value is provided by the linker script and must be trusted as-is.
|
|
#[inline(always)]
|
|
fn ro_end() -> usize {
|
|
unsafe { __ro_end.get() as usize }
|
|
}
|
|
|
|
//--------------------------------------------------------------------------------------------------
|
|
// Public Code
|
|
//--------------------------------------------------------------------------------------------------
|
|
|
|
/// Exclusive end address of the boot core's stack.
|
|
#[inline(always)]
|
|
pub fn boot_core_stack_end() -> usize {
|
|
map::BOOT_CORE_STACK_END
|
|
}
|
|
|
|
/// Return the inclusive range spanning the .bss section.
|
|
///
|
|
/// # Safety
|
|
///
|
|
/// - Values are provided by the linker script and must be trusted as-is.
|
|
/// - The linker-provided addresses must be u64 aligned.
|
|
pub fn bss_range_inclusive() -> RangeInclusive<*mut u64> {
|
|
let range;
|
|
unsafe {
|
|
range = RangeInclusive::new(__bss_start.get(), __bss_end_inclusive.get());
|
|
}
|
|
assert!(!range.is_empty());
|
|
|
|
range
|
|
}
|