Dasharo firmware building guide

Intro

This guide shows how to build Dasharo firmware compatible with ASRock Rack TURIND8UD-2T/X550.

Two firmware variants are available:

• coreboot+LinuxBoot: coreboot with LinuxBoot payload and u-root userland. Does not feature a setup menu. Compatible with Linux-based operating systems.
• coreboot+UEFI: coreboot with TianoCore EDK II as the payload. Exposes a standard UEFI boot loader and setup menu. Can boot UEFI-compatible OSes.

Requirements

• Docker
  • follow Install Docker Engine on Ubuntu
  • follow Post-installation steps for Linux
• Git
  • sudo apt-get install git

Building

To build a Dasharo firmware image, first clone the coreboot repository:

git clone https://github.com/Dasharo/coreboot.git

then follow the steps below:

1. To build a specific version checkout to the version's tag. Skip this step otherwise.

   LinuxBootUEFI

   cd coreboot
   git checkout asrock_turind8ud_linuxboot_<version>
   

   For example

   git checkout asrock_turind8ud_linuxboot_v0.9.0
   

   cd coreboot
   git checkout asrock_turind8ud_uefi_<version>
   

   For example

   git checkout asrock_turind8ud_uefi_v0.9.0
   

2. Checkout submodules:

   git submodule update --init --checkout
   

3. Download the package with necessary blobs and put it in proper directory:

I confirm that I have read and agree to the Dasharo Terms of Service and all applicable open-source licensing terms governing this firmware release.

• Unzip the package to the following directory:

  unzip Turin.zip -d 3rdparty/blobs/soc/amd/
  

Now build the firmware:

LinuxBootUEFI

./build.sh asrock_turind8ud_linuxboot

The resulting coreboot image will be placed in the coreboot directory as asrock_turind8ud_linuxboot_<version>.rom.

./build.sh asrock_turind8ud_uefi

The resulting coreboot image will be placed in the coreboot directory as asrock_turind8ud_uefi_<version>.rom.