Milk-V Duo 256M

SG2002 RISC-V SoC

The SG2002 is a high-performance, low-power 64-bit RISC-V/ARM SoC from Sophgo.

Mainline support

The support for following drivers are already enabled:

  1. ns16550 UART Driver.

  2. Synopsys Designware MSHC Driver.

  3. Synopsys Designware Ethernet Controller.

Building

  1. Add the RISC-V toolchain to your PATH.

  2. Setup ARCH & cross compilation environment variable:

export CROSS_COMPILE=<riscv64 toolchain prefix>
cd <U-Boot-dir>
make milkv_duo_256m_defconfig
make

This will generate u-boot.bin

Booting

Currently, we rely on vendor FSBL (First Stage Boot Loader) to initialize the clock and load OpenSBI and the u-boot image, then bootup from it.

To run u-boot.bin on top of FSBL, follow these steps:

  1. Generate a compatible u-boot.bin using U-Boot with the Milk-V Duo 256M default configuration.

  2. Use mainline OpenSBI with a newer version than 1.5 to generate fw_dynamic. Use FDT_FW_PATH to point to sg2002-milkv-duo256m.dtb device tree file while compiling fw_dynamic. Example:

cd open-sbi
PLATFORM=generic FW_FDT_PATH=../u-boot/arch/riscv/dts/sg2002-milkv-duo256m.dtb make

This will generate build/platform/generic/firmware/fw_dynamic.bin.

  1. Use the vendor-provided tool [1] to create a unified fip.bin file containing FSBL, OpenSBI, and U-Boot. Note that you will have to use the file cv181x.bin as the FSBL.

  2. Place the generated fip.bin file into the FAT partition of the SD card.

  3. Insert the SD card into the board and power it on.

The board will automatically execute the FSBL from the fip.bin file. Subsequently, it will transition to OpenSBI, and finally, OpenSBI will invoke U-Boot.

[1]: https://github.com/sophgo/fiptool

Sample boot log from Milk-V 256M Duo board

U-Boot 2026.07-00002-g0b690770386f-dirty (Jul 07 2026 - 13:33:36 -0300)milkv_duo_256m

DRAM:  256 MiB
Core:  20 devices, 13 uclasses, devicetree: separate
MMC:   mmc@4310000: 0
Loading Environment from nowhere... OK
In:    serial@4140000
Out:   serial@4140000
Err:   serial@4140000
Net:
Warning: ethernet@4070000 (eth0) using random MAC address - 0a:f3:23:40:7e:55
eth0: ethernet@4070000
Hit any key to stop autoboot: 0
milkv_duo_256m#