SOPHGO EDK2

Build

1. Install dependencies.

sudo apt-get install autoconf automake autotools-dev curl python3 libmpc-dev libmpfr-dev libgmp-dev gawk build-essential bison flex texinfo gperf libtool patchutils bc zlib1g-dev libexpat-dev ninja-build uuid-dev gcc-riscv64-unknown-elf

2. Clone repository (maybe you have done this).

git clone https://github.com/sophgo/sophgo-edk2.git

3. Enter repository.

cd sophgo-edk2

4. Init submodules.

git submodule sync
git submodule update --init --recursive

5. Setup environments.

export WORKSPACE=`pwd`
export PACKAGES_PATH=$WORKSPACE/edk2:$WORKSPACE/edk2-platforms:$WORKSPACE/edk2-non-osi
export GCC5_RISCV64_PREFIX=riscv64-unknown-elf-
source edk2/edksetup.sh

6. Build base tools.

make -C edk2/BaseTools

7. Build binaries for SG2042.

   Final output is $WORKSPACE/Build/SG2042_EVB/DEBUG_GCC5/FV/SG2042.fd.

build -a RISCV64 -t GCC5 -p Platform/Sophgo/SG2042_EVB_Board/SG2042.dsc

8. Enable MultiArchUefiPkg for graphics cards supporting UEFI.

   Final output is $WORKSPACE/Build/SG2042_EVB/RELEASE_GCC5/FV/SG2042.fd.

build -a RISCV64 -t GCC5 -b RELEASE -D X64EMU_ENABLE -p Platform/Sophgo/SG2042_EVB_Board/SG2042.dsc

Note

• -D X64EMU_ENABLE is an option to enable MultiArchUefiPkg, an emulator for x64 OpRoms, or not. Please see the link https://github.com/intel/MultiArchUefiPkg for more details.
• If you use -b DEBUG to replace -b RELEASE to build, MultiArchUefiPkg maybe not work.

9. Enable ACPI for SG2042.

   Final output is $WORKSPACE/Build/SG2042_EVB/RELEASE_GCC5/FV/SG2042.fd.

build -a RISCV64 -t GCC5 -b RELEASE -D ACPI_ENABLE -p Platform/Sophgo/SG2042_EVB_Board/SG2042.dsc

Note

• -D ACPI_ENABLE is an option to enable ACPI. However, ACPI support is currently only provided for SG2042 x4 EVB.
• To enable the ACPI feature in the linux kernel on the SG2042 platform, see the link https://github.com/sophgo/linux-riscv/tree/sg2042-dev-6.6-acpi.

Deploy

1. Mount your SD card (assume your SD card is /dev/sdc on your PC).

sudo mount /dev/sdc1 /mnt

2. Copy SG2042.fd to your SD card in the 0:riscv64/ directory.

• Option 1: Replace riscv64_Image directly.

sudo cp SG2042.fd /mnt/riscv64/riscv64_Image

• Option 2: Write conf.ini in the 0:riscv64/ directory.

  The example is as follows:

[sophgo-config]

[devicetree]
name = mango-sophgo-x8evb.dtb
; name = mango-sophgo-x4evb.dtb
; name = mango-milkv-pioneer.dtb
; name = mango-sophgo-pisces.dtb

[kernel]
name = SG2042.fd

[eof]

3. Place grubriscv64.efi in the EFI partition of your SSD. Please see How to build and config GRUB2.
   • Ubuntu: place the grub.cfg in the EFI partition.
   • Fedora: modify grub.cfg in the BOOT partition of your SSD.

Run

1. Connect your serial port to RISC-V debug port (UART0).
2. Power on your board, wait untill entering the UEFI shell.
3. Boot Linux kernel using GRUB2. Type commands in the UEFI Shell as follows or put a startup.nsh file in the EFI partition of your SSD.

fs0:
grubriscv64.efi