60 releases (6 breaking)

new 0.7.6 Mar 27, 2025
0.6.4 Mar 19, 2025
0.3.19 Dec 30, 2024
0.3.12 Nov 29, 2024

#42 in Operating systems

Download history 378/week @ 2024-12-06 44/week @ 2024-12-13 3/week @ 2024-12-20 137/week @ 2024-12-27 539/week @ 2025-01-03 415/week @ 2025-01-10 282/week @ 2025-01-17 156/week @ 2025-01-24 152/week @ 2025-01-31 61/week @ 2025-02-07 16/week @ 2025-02-14 9/week @ 2025-02-21 219/week @ 2025-02-28 251/week @ 2025-03-07 229/week @ 2025-03-14 433/week @ 2025-03-21

1,135 downloads per month

MIT/Apache

68KB
2K SLoC

ostool

Check, Build and Test

Rust开发OS的工具集,可以方便的通过 Qemu 和 U-Boot 启动。

使用

cargo install ostool
ostool --help

配置文件

ArceOS为例

进入工作目录

# 生成默认配置文件
ostool defconfig

.project.toml:

[compile]
target = "aarch64-unknown-none"

[compile.build.Custom]
# 编译命令,可多条
shell = ["make ARCH=aarch64 A=examples/helloworld FEATURES=page-alloc-4g"]
# 要启动的内核
kernel = "examples/helloworld/helloworld_aarch64-qemu-virt.bin"

[qemu]
machine = "virt"
cpu = "cortex-a57"
graphic = false
args = ""

Qemu启动

ostool run qemu
# debug
ostool run qemu -d

U-Boot 启动

linux tftp 使用69端口,为特权接口,需要为应用授予权限:

sudo setcap cap_net_bind_service=+eip $(which ostool)
ostool run uboot

远程构建示例

# remote_build.ps1

# 定义远程服务器的连接信息
$remoteHost = "{ip}"
$username = "{name}"
$remotePath = "/home/arceos/"
$makeCommand = "make A=examples/helloworld PLATFORM=aarch64-phytium-pi "
$remoteFile = "$remotePath/examples/helloworld/helloworld_aarch64-phytium-pi.bin"
$localTargetFile = "./target/kernel_raw.bin"

# 使用 SSH 连接到远程服务器并执行命令
ssh "$username@$remoteHost" "cd $remotePath;. ~/.profile;$makeCommand"

if ($?) {
    Write-Host "remote build ok"

}
else {
    Write-Host "remote build fail"
    exit 1
}

# 使用 SCP 将远程文件拷贝到本地目标路径并重命名为 kernel.elf
$cmd = "scp $username@${remoteHost}:${remoteFile} $localTargetFile"
Write-Host "exec: $cmd"
Invoke-Expression $cmd
if ($?) {
    Write-Host "copy ok"
}
else {
    Write-Host "copy fail"
    exit 1
}

.project.toml

[compile]
target = "aarch64-unknown-none-softfloat"

[compile.build.Custom]
shell = [
    "pwsh -f ./remote_build.ps1",
]
kernel = "target/kernel_raw.bin"

[qemu]
machine = "virt"
cpu = "cortex-a53"
graphic = false
args = "-smp 2"

[uboot]
serial = "COM3"
baud_rate = 115200
dtb_file = "tools/phytium_pi/phytiumpi_firefly.dtb"

Dependencies

~14–26MB
~409K SLoC