Building manual

Intro

This documents describes the procedure for compiling Dasharo firmware compatible with MSI PRO Z690-A and MSI PRO Z790-P.

Requirements

• Ubuntu 20.04/21.04/22.04 as a host OS was tested
• Internet connection
• Docker installed
  • follow Install Docker Engine on Ubuntu
  • follow Post-installation steps for Linux
• Git, wget, unzip installed

sudo apt install git unzip wget

• UEFIExtract installed
  • this tool is used in the build.sh script to extract CPU microcode from the original MSI firmware

sudo apt install wget
wget https://github.com/LongSoft/UEFITool/releases/download/A59/UEFIExtract_NE_A59_linux_x86_64.zip
unzip UEFIExtract_NE_A59_linux_x86_64.zip
sudo cp ./UEFIExtract /usr/local/bin

Procedure

Obtain Dasharo source code:

PRO Z690-A (WIFI) DDR4PRO Z690-A (WIFI)PRO Z790-P (WIFI) DDR4PRO Z790-P (WIFI)

Replace the REVISION with one of the:

• msi_ms7d25_vVERSION tag for the given release VERSION (e.g. msi_ms7d25_v1.1.3), RECOMMENDED
• dasharo branch for a development version with unreleased changes past most recent release version
• msi_ms7d25/release branch for the release versions up to v1.1.2

Replace the REVISION with one of the:

• msi_ms7d25_vVERSION tag for the given release VERSION (e.g. msi_ms7d25_v1.1.3), RECOMMENDED
• dasharo branch for a development version with unreleased changes past most recent release version
• msi_ms7d25/release branch for the release versions up to v1.1.2

Replace the REVISION with one of the:

• msi_ms7e06_vVERSION tag for the given release VERSION (e.g. msi_ms7e06_v0.9.1), RECOMMENDED
• dasharo branch for a development version with unreleased changes past most recent release version
• msi_ms7d25/release branch for the release versions up to v0.9.0

Replace the REVISION with one of the:

• msi_ms7e06_vVERSION tag for the given release VERSION (e.g. msi_ms7e06_v0.9.1), RECOMMENDED
• dasharo branch for a development version with unreleased changes past most recent release version
• msi_ms7d25/release branch for the release versions up to v0.9.0

git clone https://github.com/Dasharo/coreboot.git -b REVISION
cd coreboot

Start the build process:

PRO Z690-A (WIFI) DDR4PRO Z690-A (WIFI)PRO Z790-P (WIFI) DDR4PRO Z790-P (WIFI)

For v1.1.1 and older:

./build.sh ddr4

For v1.1.2 and newer:

./build.sh z690a_ddr4

The resulting Dasharo firmware image will be placed at $PWD/msi_ms7d25_VERSION_ddr4.rom.

For v1.1.1 and older:

./build.sh ddr5

For v1.1.2 and newer:

./build.sh z690a_ddr5

The resulting Dasharo firmware image will be placed at $PWD/msi_ms7d25_VERSION_ddr5.rom.

./build.sh z790p_ddr4

The resulting Dasharo firmware image will be placed at $PWD/msi_ms7e06_VERSION_ddr4.rom.

./build.sh z790p_ddr5

The resulting Dasharo firmware image will be placed at $PWD/msi_ms7e06_VERSION_ddr4.rom.