flanfly / oreboot

oreboot is a fork of coreboot, with C removed, written in Rust.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

oreboot README

oreboot is a downstream fork of coreboot, i.e. oreboot is coreboot without 'c'.

oreboot will only target truly open systems requiring no binary blobs. oreboot is mostly written in Rust, with assembly where needed.

oreboot currently only plans to support LinuxBoot payloads.

Supported Hardware

oreboot supports almost nothing, and will support no systems that require C or binary blobs. For now, that means no x86.

Build Requirements

  • Rust

Building oreboot

We are still trying to figure this out but:

# Install rustup
curl https://sh.rustup.rs -sSf | sh

# Default to nightly on this directory
rustup override add nightly

# Install xargo and xbuild
rustup component add rust-src
cargo install xargo
cargo install cargo-xbuild

# Ocassionally run:
rustup update

# Build for ARMv7
cd src/mainboard/emulation/qemu-armv7
cargo xbuild

# Optimized build
cargo xbuild --release

# View disassembly
arm-none-eabi-objdump -S target/arm-none-eabihf/release/qemu-armv7

QEMU

# Create a headerless binary from the ELF
arm-none-eabi-objcopy -O binary target/arm-none-eabihf/release/qemu-armv7 bios.bin

# Run oreboot. Should print 'Welcome to oreboot'
qemu-system-arm -machine virt -bios bios.bin -nographic

# Quit qemu with CTRL-A X

Testing oreboot Without Modifying Your Hardware

Website and Mailing List

Not yet.

Ground Rules

  • The build tool is xargo; there will be no Makefiles.
  • Cargo.toml files are located in the src/mainboard/x/y directories. which will allow us to build all boards in parallel.
  • All code is auto-formatted with rustfmt with no exceptions. There are no vestiges of the 19th century such as line length limits.
  • There will be no C.
  • We will not run our own Gerrit. We are using Github for now, and the github Pull Request review mechanism.
  • We will not run our own Jenkins. We will use the most appropriate CI; for now, that is Azure but we will be flexible.

Copyright and License

The copyright on oreboot is owned by quite a large number of individual developers and companies. Please check the individual source files for details.

oreboot is licensed under the terms of the GNU General Public License (GPL). Some files are licensed under the "GPL (version 2, or any later version)", and some files are licensed under the "GPL, version 2". For some parts, which were derived from other projects, other (GPL-compatible) licenses may apply. Please check the individual source files for details.

This makes the resulting oreboot images licensed under the GPL, version 2.

About

oreboot is a fork of coreboot, with C removed, written in Rust.

License:GNU General Public License v2.0


Languages

Language:C 88.5%Language:C++ 5.0%Language:Makefile 1.6%Language:Perl 1.1%Language:Shell 0.9%Language:Assembly 0.8%Language:Python 0.7%Language:Objective-C 0.5%Language:Go 0.3%Language:Ada 0.2%Language:Yacc 0.1%Language:Roff 0.1%Language:Lex 0.0%Language:Dockerfile 0.0%Language:M4 0.0%Language:HTML 0.0%Language:Rust 0.0%Language:sed 0.0%