Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sehraf/d1-riscv-arch-image-builder

RISC-V Archlinux D1 LicheeRV image builder
https://github.com/sehraf/d1-riscv-arch-image-builder

Last synced: about 1 month ago
JSON representation

RISC-V Archlinux D1 LicheeRV image builder

Awesome Lists containing this project

README 

        
# Image Builder for Archlinux on an Allwinner D1 / Sipeed Lichee RV

These scripts compile, copy, bake, unpack and flash a [ready](https://wiki.archlinux.org/title/installation_guide#Configure_the_system) to use RISC-V Archlinux.  

*With "ready to use" i mean that it boots, you still need to configure everything!*



Special thanks to **smaeul** for all their work!



Find a **precompiled image** under the [Actions](https://github.com/sehraf/riscv-arch-image-builder/actions) artifacts. The image has _no_ configuration or whatsoever!



Also have a look at the forks that have emerged over time or similar projects like a [make file based approch](https://github.com/hyx0329/riscv-archlinux-d1).



## Starfive Vision 2

There are multiple sources for an Archlinux image:

- https://forum.rvspace.org/t/arch-linux-image-for-visionfive-2/1459

- https://github.com/thefossguy/archlinux-visionfive2



## Components

- mainline OpenSBI

- U-Boot based on https://github.com/smaeul/u-boot.git

- mainline kernel

- WiFi driver (rtl8723ds) based on https://github.com/lwfinger/rtl8723ds

- RootFS based on https://archriscv.felixc.at (root password is ~~`sifive`~~ `archriscv`)



## How to build on ArchLinux

1. Install requirements: `pacman -Sy riscv64-linux-gnu-gcc swig cpio python3 python-setuptools base-devel bc`

   1. If you want to `chroot` into the RISC-V image, you also need `arch-install-scripts qemu-user-static qemu-user-static-binfmt`

1. Edit `consts.sh` to your needs. For example, you may want to select a [different DTB](https://github.com/sehraf/riscv-arch-image-builder/blob/5c450da98d578617781ae13f9d2b0850a61b21c4/consts.sh#L22) for a different board variant.

1. Run `1_compile.sh` which compiles everything into the `output` folder.

1. Run `2_create_sd.sh /dev/` to flash everything on the SD card.

1. Configure your Archlinux :rocket:



## How to build on Debian

1. Install requirements: `apt install -y gcc-riscv64-linux-gnu bison flex python3-dev libssl-dev swig cpio python3-setuptools build-essential bc`

   1. If you want to `chroot` into the RISC-V image, you also need `arch-install-scripts qemu-user-static`

1. Edit `consts.sh` to your needs. For example, you may want to select a [different DTB](https://github.com/sehraf/riscv-arch-image-builder/blob/5c450da98d578617781ae13f9d2b0850a61b21c4/consts.sh#L22) for a different board variant.

1. Run `1_compile.sh` which compiles everything into the `output` folder.

1. Run `2_create_sd.sh /dev/` to flash everything on the SD card.

1. Configure your Archlinux :rocket:



## Using loop image file instead of a SD card

Simply loop it using `sudo losetup -f -P ` and then use `/dev/loopX` as the target device.



## Notes

The second script requires `arch-install-scripts`, `qemu-user-static-bin` (AUR) and `binfmt-qemu-static` (AUR) for an architectural chroot.

If you don't want to use/do this, change `USE_CHROOT` to `0` in `consts.sh`.  

*Keep in mind, that this is just a extracted rootfs with **no** configuration. You probably want to update the system, install an editor and take care of network access/ssh*



Some commits are pinned, this means that in the future this script might stop working since often a git HEAD is checked out. This is intentional.



The second script uses `sudo` for root access. Like any random script from a random stranger from the internet, have a look at the code first and use at own risk!



Things are rebuild whenever the corresponding `output/` is missing. For example, the kernel is rebuilt when there is no `Image` file.



# Status



## 25.07.2023

- forgot to keep this up to date...

- mainline kernel fully supports the D1

- kernel updated to 6.4 (mainline)

- OpenSBI updated to 1.3



## 4.11.2022

- WiFi is working again



## 3.11.2022

- updated U-Boot and remove boot0 (handled by [U-Boot](https://github.com/smaeul/u-boot/releases/tag/d1-2022-10-31))

- updated kernel to 6.1.0-rc3

    - **THIS BRAKES BUILT-IN WIFI**



## 13.09.2022

- kernel is back at 5.18-rc1 due to being more reliable



## 14.06.2022

- kernel updated to 5.19-rc1

- added initramfs support (untested)

- added extlinux support



## 22.04.2022

- kernel includes modules for USB LAN adapter

- swap is enabled

## 09.04.2022

- HDMI, tested with LXDE/LXDM

## 07.04.2022

- WiFi \o/

## 06.04.2022

- Kernel is based on 5.18-rc1

- WiFi driver fails to build (linking error :feelsbadman:)

- Both kernel and U-Boot are using `nezha_defconfig` since i found them more reliable

    - With the [licheerv_linux_defconfig](https://andreas.welcomes-you.com/media/files/licheerv_linux_defconfig) from [here](https://andreas.welcomes-you.com/boot-sw-debian-risc-v-lichee-rv/) the kernel fails to find the sd card (or its partitions? not sure what exactly goes wrong)

- HDMI is not working (at least on the one screen i've tested it)



# Problems

## 06.04.2022

- ~no WiFi!~

- ~No HDMI (though, i'm unsure about the state of HDMI support in general)~