sparc-unknown-none-elf

层级：3

用于裸机 32 位 SPARC V7 和 V8 系统的 Rust，例如 Gaisler LEON3。

目标描述
sparc-unknown-none-elfSPARC V7 32 位（独立，硬浮点）

目标维护者

要求

此目标是交叉编译的。不支持 std。没有默认分配器，但可以通过提供分配器来使用 alloc。

默认情况下，使用此目标生成的代码应该在任何 SPARC 硬件上运行；启用其他目标功能可能会提高此基线。

  • -Ctarget-cpu=v8 添加了额外的 SPARC V8 指令。

  • -Ctarget-cpu=leon3 添加了 SPARC V8 指令，并设置了适合 Gaisler Leon3 的调度。

标记为 extern "C" 的函数使用 标准 SPARC 架构调用约定。

此目标生成 ELF 二进制文件。任何备用格式或二进制布局的特殊考虑因素将需要链接器选项或链接器脚本。

构建目标

您可以通过将目标添加到 config.toml 中的 target 列表中来构建支持该目标的 Rust。

[build]
build-stage = 1
host = ["<target for your host>"]
target = ["<target for your host>", "sparc-unknown-none-elf"]

将 <target for your host> 替换为 x86_64-unknown-linux-gnu 或适合您的主机机器的任何其他内容。

构建 Rust 程序

要使用此目标构建，请将其传递给 --target 参数，例如

cargo build --target sparc-unknown-none-elf

此目标使用 GCC 作为链接器，因此您需要一个合适的 GCC 兼容 sparc-unknown-none 工具链。默认链接器二进制文件是 sparc-elf-gcc，但您可以在项目配置中覆盖它，如下所示

.cargo/config.toml:

[target.sparc-unknown-none-elf]
linker = "sparc-custom-elf-gcc"

测试

由于 sparc-unknown-none-elf 支持各种不同的环境，并且不支持 std，因此此目标不支持运行 Rust 测试套件。

交叉编译工具链和 C 代码

此目标最初使用 Gaisler 的 BCC2 以及 TSIM Leon3 处理器模拟器进行测试。GCC 和 Clang 的 BCC2 都已证明有效。要使用这些工具，您的项目配置应包含类似以下内容

.cargo/config.toml:

[target.sparc-unknown-none-elf]
linker = "sparc-gaisler-elf-gcc"
runner = "tsim-leon3"

[build]
target = ["sparc-unknown-none-elf"]
rustflags = "-Ctarget-cpu=leon3"

使用此配置，运行 cargo run 将为 SPARC V8 兼容的 Gaisler Leon3 处理器编译您的代码，然后启动 tsim-leon3 模拟器。libcore 是在 rustc 编译过程中使用 SPARC V7 基线预编译的，但如果您使用的是 nightly 工具链，则可以使用 -Z build-std=core 选项从源代码重新构建 libcore。如果您想为 SPARC V8 编译它并利用额外的指令，这可能很有用。

.cargo/config.toml:

[target.sparc-unknown-none-elf]
linker = "sparc-gaisler-elf-gcc"
runner = "tsim-leon3"

[build]
target = ["sparc-unknown-none-elf"]
rustflags = "-Ctarget-cpu=leon3"

[unstable]
build-std = ["core"]

无论哪种方式，模拟器运行后，只需输入命令 run 即可开始在模拟器中执行代码。

默认的 C 工具链库已链接，因此使用 Gaisler 的 BCC2 工具链，并使用其默认的 Leon3 BSP，您可以使用调用 C putchar 函数及其朋友来输出到模拟器控制台。默认的链接器脚本也适合 Leon3 模拟器，因此不需要链接器脚本。

以下是一个使用上述配置文件的完整示例

#![no_std]
#![no_main]

extern "C" {
    fn putchar(ch: i32);
    fn _exit(code: i32) -> !;
}

#[no_mangle]
extern "C" fn main() -> i32 {
    let message = "Hello, this is Rust!";
    for b in message.bytes() {
        unsafe {
            putchar(b as i32);
        }
    }
    0
}

#[panic_handler]
fn panic(_panic: &core::panic::PanicInfo) -> ! {
    unsafe {
        _exit(1);
    }
}
$ cargo run --target=sparc-unknown-none-elf
   Compiling sparc-demo-rust v0.1.0 (/work/sparc-demo-rust)
    Finished dev [unoptimized + debuginfo] target(s) in 3.44s
     Running `tsim-leon3 target/sparc-unknown-none-elf/debug/sparc-demo-rust`

 TSIM3 LEON3 SPARC simulator, version 3.1.9 (evaluation version)

 Copyright (C) 2023, Frontgrade Gaisler - all rights reserved.
 This software may only be used with a valid license.
 For latest updates, go to https://www.gaisler.com/
 Comments or bug-reports to [email protected]

 This TSIM evaluation version will expire 2023-11-28

Number of CPUs: 2
system frequency: 50.000 MHz
icache: 1 * 4 KiB, 16 bytes/line (4 KiB total)
dcache: 1 * 4 KiB, 16 bytes/line (4 KiB total)
Allocated 8192 KiB SRAM memory, in 1 bank at 0x40000000
Allocated 32 MiB SDRAM memory, in 1 bank at 0x60000000
Allocated 8192 KiB ROM memory at 0x00000000
section: .text, addr: 0x40000000, size: 20528 bytes
section: .rodata, addr: 0x40005030, size: 128 bytes
section: .data, addr: 0x400050b0, size: 1176 bytes
read 347 symbols

tsim> run
  Initializing and starting from 0x40000000
Hello, this is Rust!

  Program exited normally on CPU 0.
tsim>