Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

aarch64-rt

Крейт aarch64-rt предоставляет ассемблерную точку входа и вектор исключений, которые мы реализовали раньше. Нам нужно лишь пометить нашу функцию main макросом entry!.

Он также предоставляет макрос initial_pagetable!, позволяющий определить начальную статическую таблицу страниц на Rust, а не на ассемблере, как мы делали раньше.

Также можно использовать драйвер UART из крейта arm-pl011-uart, вместо того чтобы писать свой.

// Copyright 2025 Google LLC
// SPDX-License-Identifier: Apache-2.0

#![no_main]
#![no_std]

mod exceptions_rt;

use aarch64_paging::descriptor::El1Attributes;
use aarch64_rt::{InitialPagetable, entry, initial_pagetable};
use arm_pl011_uart::{PL011Registers, Uart, UniqueMmioPointer};
use core::fmt::Write;
use core::panic::PanicInfo;
use core::ptr::NonNull;
use smccc::Hvc;
use smccc::psci::system_off;

/// Базовый адрес основного UART PL011.
const PL011_BASE_ADDRESS: NonNull<PL011Registers> =
    NonNull::new(0x900_0000 as _).unwrap();

/// Атрибуты, используемые для памяти устройств в начальном тождественном отображении.
const DEVICE_ATTRIBUTES: El1Attributes = El1Attributes::VALID
    .union(El1Attributes::ATTRIBUTE_INDEX_0)
    .union(El1Attributes::ACCESSED)
    .union(El1Attributes::UXN);

/// Атрибуты, используемые для обычной памяти в начальном тождественном отображении.
const MEMORY_ATTRIBUTES: El1Attributes = El1Attributes::VALID
    .union(El1Attributes::ATTRIBUTE_INDEX_1)
    .union(El1Attributes::INNER_SHAREABLE)
    .union(El1Attributes::ACCESSED)
    .union(El1Attributes::NON_GLOBAL);

initial_pagetable!({
    let mut idmap = [0; 512];
    // 1 GiB памяти устройств.
    idmap[0] = DEVICE_ATTRIBUTES.bits();
    // 1 GiB обычной памяти.
    idmap[1] = MEMORY_ATTRIBUTES.bits() | 0x40000000;
    // Ещё 1 GiB памяти устройств, начиная с 256 GiB.
    idmap[256] = DEVICE_ATTRIBUTES.bits() | 0x4000000000;
    InitialPagetable(idmap)
});

entry!(main);
fn main(x0: u64, x1: u64, x2: u64, x3: u64) -> ! {
    // SAFETY: `PL011_BASE_ADDRESS` --- базовый адрес устройства PL011, и
    // никто другой не обращается к этому диапазону адресов.
    let mut uart = unsafe { Uart::new(UniqueMmioPointer::new(PL011_BASE_ADDRESS)) };

    writeln!(uart, "main({x0:#x}, {x1:#x}, {x2:#x}, {x3:#x})").unwrap();

    system_off::<Hvc>().unwrap();
    panic!("system_off returned");
}

#[panic_handler]
fn panic(_info: &PanicInfo) -> ! {
    system_off::<Hvc>().unwrap();
    loop {}
}
  • Запустите пример в QEMU командой make qemu_rt в каталоге src/bare-metal/aps/examples.