Skip to content

Fedora Support


Fedora is a well-known Linux operating system, a fast, stable, and powerful operating system for daily applications built by enthusiasts in the global community.

Fedora is currently supported on the D1 Nezha development board.

This power enhancement package is provided by our partner Red Hat -fuwei.

Original WiKi link:

Simple HOWTO

Prebuild Image

we have made the prebuild Fedora Image for Allwinner D1-H: Fedora-riscv64-D1-H-developer-xfce-with-esp-Rawhide-latest-sda.raw.zst

For booting it on D1-H, what you need to do just:


unzstd  Fedora-riscv64-d1-developer-xfce-with-esp-Rawhide-latest-sda.raw.zst

Flash into a SD card (>= 16GB)

sudo dd if=Fedora-riscv64-d1-developer-xfce-with-esp-Rawhide-latest-sda.raw of=/dev/sdX status=progress bs=4M

Insert the SD card and power up

  • default display is LCD (vertical):

Allwinner D1-H LCD.jpg

  • (optional) switch display to HDMI (1080p mode, vertical)
cd /sys/kernel/debug/dispdbg
echo disp0 > name; echo switch1 > command; echo 4 10 0 0 0x4 0x101 0 0 0 8 > param; echo 1 > start;

Hardware info

IP info

T-Head: XuanTie C906 RISC-V

Soc & Development boardinfo

Allwinner: D1 SoC Introduction

Sunxi: D1

Sunxi: Allwinner Nezha



Reference source code

Smaeul's REPO

Tekkaman REPOs for Fedora Image

Firmware Build order

Build order allwinner nezhe grub.png


boot0 or SPL (Secondary Program Loader) which the first stage after BootROM, it is responsible for initializing DRAM and loading next stage firmware from storage(Flash or SD).

Using Smaeul SPL directly.

Build binary
git clone
pushd sun20i_d1_spl
git checkout origin/mainline
make CROSS_COMPILE=riscv64-linux-gnu- p=sun20iw1p1 mmc
Flash to SD card
pushd sun20i_d1_spl
sudo dd if=nboot/boot0_sdcard_sun20iw1p1.bin of=/dev/sdX bs=512 seek=16


RISC-V Open Source Supervisor Binary Interface, like arm-TF

Using Smaeul's patches, but rebase to the latest upstream OpenSBI, and fix some issue.

Tekkaman's OpenSBI REPO

Build binary
git clone -b allwinner_d1
pushd opensbi
CROSS_COMPILE=riscv64-linux-gnu- PLATFORM=generic FW_PIC=y make

The build/platform/generic/firmware/fw_dynamic.bin will be used to make u-boot.toc1 below.


Using Smaeul's patches, but enable more features and add some default env for auto-booting into GRUB, and also rebase to the latest upstream U-boot.

Tekkaman's U-boot REPO

Build binary
git clone -b allwinner_d1
pushd u-boot
make CROSS_COMPILE=riscv64-linux-gnu- ARCH=riscv nezha_defconfig
make CROSS_COMPILE=riscv64-linux-gnu- ARCH=riscv menuconfig
make CROSS_COMPILE=riscv64-linux-gnu- ARCH=riscv u-boot.bin u-boot.dtb

The u-boot.bin and u-boot.dtb will be used to make u-boot.toc1 below.

Build u-boot.toc1

  • toc1.cfg:
file = fw_dynamic.bin
addr = 0x40000000
file = u-boot.dtb
addr = 0x44000000
file = u-boot.bin
addr = 0x4a000000
  • build command:
pushd u-boot
cp ${PATH_TO_TOC1_CFG}/toc1.cfg ${PATH_TO_OPENSBI}/fw_dynamic.bin .
tools/mkimage -T sunxi_toc1 -d toc1.cfg  u-boot.toc1

Flash u-boot.toc1 to SD card

pushd u-boot
sudo dd if=u-boot.toc1 of=/dev/sdX bs=512 seek=32800


Please reference to this page: Architectures/RISC-V/GRUB2

You can build a grubriscv64.efi by following the page above. Then put it into the /EFI/ dir of the EFI partition of SD card.


Some example files in the boot partition:


bootcmd=load mmc 0:2 0x58000000 /EFI/fedora/grubriscv64.efi; bootefi 0x58000000
bootcmd_mmc0=devnum=0; run mmc_boot


set default=0
set timeout_style=menu
set timeout=3

set debug="linux,loader,mm"
set term="vt100"

menuentry 'Fedora vmlinux-5.15.0-rc1' {
        linux /vmlinuz-5.15.0-rc1 earlyprintk=sunxi-uart,0x02500000 console=ttyS0,115200 console=tty0 loglevel=8  root=/dev/mmcblk0p4 selinux=0 rhgb LANG=en_US.UTF-8
        devicetree /sun20i-d1-nezha.dtb
    initrd /initramfs-5.15.0-rc1.img

Linux kernel for Nezha D1-H (WIP)

Using the patches from Smaeul/Ren Guo(T-HEAD)/Allwinner Engineers, enable almost all the features for Fedora,and also rebase to the latest upstream kernel master branch.

Important reference
WIP for Fedora

Tekkaman's Linux kernel REPO

Note: We are still working on this for Fedora Image

Build Linux Kernel for D1-H
Checkout Source
git clone
pushd linux
git checkout origin/allwinner_nezha_d1_devel
pushd linux
make CROSS_COMPILE=riscv64-linux-gnu- ARCH=riscv nezha_fedora_defconfig
make CROSS_COMPILE=riscv64-linux-gnu- ARCH=riscv menuconfig
Cross Build and install
# RISCV_ROOTFS_BOOT is the mount point of the boot partition in SD card 
# RISCV_ROOTFS_BOOT=/run/media/../boot
# RISCV_ROOTFS  is the mount point of the Fedora rootfs partition in SD card 
# RISCV_ROOTFS=/run/media/../rootfs
pushd linux
make CROSS_COMPILE=riscv64-linux-gnu- ARCH=riscv
make CROSS_COMPILE=riscv64-linux-gnu- ARCH=riscv INSTALL_PATH=${RISCV_ROOTFS_BOOT} zinstall
make CROSS_COMPILE=riscv64-linux-gnu- ARCH=riscv INSTALL_MOD_PATH=${RISCV_ROOTFS} modules_install

How to Build RPM package for D1-H

using rpmbuild on QEMU

How to boot Fedora on QEMU, please reference Architectures/RISC-V/Build Bootable Image#Run_Fedora_on_QEMU

  • Boot into Fedora on QEMU, then:

  • prepare directory tree: Put spec file to /rpmbuild/SPECS and all source files to /rpmbuild/SOURCES

  • For building RPM package:
#From spec file
$ rpmbuild -ba ~/rpmbuild/SPECS/pakcage.spec

#'''OR''' to build from an existing SRPM file:
$ rpmbuild -ra package.src.rpm

Please reference to How to Create a GNU Hello World RPM Package for more RPM info.

Using mock with Qemu usermod

We also can build riscv64 RPMS on x86_64 machine by mock and Qemu usermode.[WIP]

How to Build your own Fedora Remix Image

Please reference to RISC-V: Build Bootable Image

How to make D1-H as a Koji Builder

If we have already deployed a koji hub(like openkoji and oepkg),then we can add a Nezha D1 as koji builder.

For example:

Please follow the simple instruction below:

  • NEED: koji CA certificate and builder authentication certificate: They are provided by koji hub admin.
  • Install necessary packages
# dnf install koji-builder
  • Modifying /etc/kojid.conf
1. server=<koji hub XMLRPC server URL>
2. topurl=<koji HTT file share URL>
3. allowed_scms=<SCM repo rules>
4. cert=<builder certificate>
5. serverca=<koji CA certificate>
  • Trust koji hub's CA cert
cp koji_ca_cert.crt /etc/pki/ca-trust/source/anchors/
  • add host on koji hub (operated by koji hub admin)
koji add-host <hostname> riscv64
#The *hostname* should be same in authentication certificate.
  • Enable and start kojid
systemctl enable --now kojid
  • Verify koji builder online on koji hub (operated by koji hub admin):
koji list-hosts
# After initialization: The new added builder's status should be ready in the list.
  • NOTICE:* builder won't ready until free space on /var/lib/mock is greater than 8GiB, and /var/lib/mock on NFS is not supported. Thus, using a high capacity SD card for builder and resize root file system to adapt all free space on SD is necessary.

(This article was updated on 20210910, the original wiki is constantly being updated, and the latest developments are subject to the updated content of the original wiki)