system76-firmware-open/README.md

firmware-open

System76 Open Source Firmware

Dependencies

Install toolchain

sudo apt-get install \
  build-essential \
  bison \
  ccache \
  flex \
  git-lfs \
  gnat \
  mtools \
  nasm \
  uuid-dev \
  zlib1g-dev

Make sure git lfs is set up

git lfs install
git lfs pull

Install rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs \
  | sh -s -- -y --default-toolchain "$(cat rust-toolchain)"

Load cargo environment (or optionally reboot)

source ~/.cargo/env

Install cargo-xbuild

cargo install cargo-xbuild

Build firmware, replace darp5 with your model (look in the models directory for examples)

./scripts/build.sh darp5

Flashing firmware manually is not recommended for the normal user. For the advanced user, there is a script flash.sh which takes the same arguments as build.sh

Contents

• apps - Applications
• coreboot - coreboot README
• edk2 - EDK II Project
• edk2-non-osi
• edk2-platforms - This branch holds all platforms actively maintained against the
• FSP - Intel® Firmware Support Package (Intel® FSP) Binaries
• libs - Libraries
• models - Models
• scripts
• tools - Tools