This page explains how to get Fedora 44 running on the SiFive HiFive Unmatched board in three steps:
- Obtain the “firmware” for the board. Here firmware refers to the U-Boot boot loader and its related files.
- Build an image containing the firmware that is compatible with the expectations of the board, and place this image on an SD card. The boot process with read the firmware, load U-Boot, and finish booting using the kernel and root filesystem from an NVMe disk (next step).
- Install an image containing a GPT partition table and a UEFI, boot, and root partitions on an NVMe disk in the SiFive HiFive Unmatched.
Aside from the SiFive HiFive Unmatched board, these instructions require a second computer running Linux, a USB cable capable of connecting to the board's serial port, and two micro SD cards.
The SiFive HiFive Unmatched has a USB-based serial port that you can interact with using minicom or another terminal emulator. Ensure the terminal emulator is configured to use the following parameters:
- Baud Rate: 115200
- Data Bits: 8
- Parity: None
- Stop Bits: 1
- Flow Control: None
Connecting the serial port to another computer using a USB cable often results in a device named /dev/ttyUSB1 on the connected computer.
These instructions assume your SiFive HiFive Unmatched board is configured to boot its firmware from its SD card reader. Refer to the manufacturer's getting started guide (section titled “Boot Mode Select DIP Switch”, see references below) for the DIP switch settings necessary for this. Another option is to boot from SPI-NOR, but the author has found the removable SD card more convenient for maintenance.
Obtaining the firmware
You can perform this step on a computer of any architecture running Fedora, which the instructions refer to as the build computer. Download the latest uboot-images-riscv64 RPM. At the time of writing, this was available at https://riscv-koji.fedoraproject.org/koji/buildinfo?buildID=62808. The uboot-images-riscv64 RPM contains firmware for several RISC-V boards, including the SiFive HiFive Unmatched.
Extract the files from the RPM on the build computer without installing it. Assuming you downloaded the RPM version referred above, run rpm2cpio uboot-images-riscv64-2026.01-3.0.riscv64.fc43.noarch.rpm | cpio -idmv. The next step in these instructions use usr/share/uboot/sifive_unmatched/spl/u-boot-spl.bin and usr/share/uboot/sifive_unmatched/u-boot.itb.
Building the firmware image
Perform the following steps on the build computer to create a disk image around the files you downloaded above. These steps write directly to an SD card, which you can then insert into the SiFive HiFive Unmatched's reader.
- Insert an SD card into the build computer.
- Run
sudo sgdisk -g --clear -a 1 --new=1:34:2081 --change-name=1:uboot-spl --typecode=1:5B193300-FC78-40CD-8002-E86C45580B47 --new=2:2082:10273 --change-name=2:uboot --typecode=2:2E54B353-1271-4842-806F-E436D6AF6985 /dev/DEVICEon the build computer, where/dev/DEVICEis the name of your SD card device. On the author's computer, this was/dev/mmcblk0. Selecting the wrong device name might corrupt the build computer's disk. - From
usr/share/uboot/sifive_unmatched/on the build computer, runsudo dd if=spl/u-boot-spl.bin of=/dev/DEVICE seek=34to placespl/u-boot-spl.binin the image. - Run
sudo dd if=u-boot.itb of=/dev/DEVICE seek=2082on the build computer to placeu-boot.itbin the image. - Run
sudo syncon the build computer.
Installing the boot/root image
Install a NVMe drive in the SiFive HiFive Unmatched.
Download the bootable image of Fedora 38 from https://dl.fedoraproject.org/pub/alt/risc-v/archive/disk_images/Fedora-Developer-38-20230519.n.0.SiFive.Unmatched.and.QEMU/, and copy this image to a second SD card. Boot the SD card on the SiFive HiFive Unmatched. This should result in an instance of Fedora 38 running on the SiFive HiFive Unmatched. The default username and password of this image is root and fedora_rocks!, respectively.
Using the serial terminal, sign into the SiFive HiFive Unmatched with the username and password listed above. Download the file at https://dl.fedoraproject.org/pub/alt/risc-v/release/44/Server/riscv64/images/Fedora-Server-Host-Generic-44-20260604.0.riscv64.raw.xz to the SiFive HiFive Unmatched using curl. Uncompress the file using unxz, and copy it to the board's /dev/nvme0n1 using dd.
Shutdown the SiFive HiFive Unmatched, remove the SD card containing the bootable image of Fedora 38, and replace it with the second SD card containing the Fedora 44 firmware, which you just created. Turn on the SiFive HiFive Unmatched. The board should boot into Fedora 44. The default username and password is fedora and linux, respectively.
Note that you can instead prepare the NVMe drive by first attaching it to the build computer and then later install it in the SiFive HiFive Unmatched. This would obviate the need to boot the old Fedora 38 image to prepare the drive on the device. The tradeoff is that this requires a free NVMe interface on the build computer, and it involves more physical movement to perform a reinstall.
References
- Manufacturer's getting started guide: https://sifive.cdn.prismic.io/sifive/Z5KCu5bqstJ99zIu_hifive-unmatched-revb-gsg-v1p6_EN.pdf
- Manufacturer's software manual: https://www.sifive.com/document-file/hifive-unmatched-software-reference-manual
- HiFive Unmatched part of U-Boot manual: https://docs.u-boot.org/en/v2026.01/board/sifive/unmatched.html
