Arch Linux riscv64 image builder

Build your own custom riscv64 Arch linux image. Whilst this image aims to be minimal, the configuration is customisable allowing you to tailor it to your needs.

The configuration here targets the StarFive VisionFive 2 SBC however with a different kernel, firmware and u-boot, you could potentially support other devices.

This is a very minimal image that may not even display anything over HDMI. This image is used for "server-like" applications where you already have a serial conosole (over UART).

Please refer to the releases section and make sure that your board firmware matches with what is expected.

Instructions

Build your own .img file using the create-image.sh shell script. sudo is necessary as the creation of the image requires mounting filesystems and chroot.

sudo ./create-image.sh

Thereafter, just dd the provided image like so:

sudo dd conv=sync status=progress if=IMAGE_NAME \
    of=DEVICE_PATH

You will still need to expand the last (root) partition.

To do so, run the post-dd.sh shell script using only the device path (not the partition number).

For example, if your drive is called /dev/sdz, do this:

sudo ./post-dd.sh /dev/sdz

User accounts

username: riscv
password: changeme

The default username is riscv and specified in image.conf as CONF_USER The default password is changeme and also specific in image.conf as CONF_PASSWORD. Upon first login, you'll be prompted to change this password.

Root access

The root account is disabled as a security measure. To elevate to root, you need to use sudo

Out of the box setup

The image is configured to setup networking via ethernet and the ssh server is started on boot. This should provide headless access via ssh out of the box. The default machine name is archlinux-riscv but this can be customised via image.conf.

Custom configuration

The default configuration for the image is stored in image.conf. The create-image.sh script accepts an argument allowing you to specify your own config. If a config file is not provided, the script will default to image.conf. To use your own config, run:

sudo ./create-image.sh [<CONFIG>]

Configuration parameters

Parameter	Description
`CONF_TIMEZONE`	Timezone.
`CONF_LOCALE`	Locale
`CONF_HOSTNAME`	Name of machine on the network.
`CONF_USER`	Username of sudo-capable user.
`CONF_USER_PASSWORD`	Initial password for user. Forced change on login.
`CONF_GROUPS`	Groups that the user is a part of. `wheel` for sudo
`CONF_PKGS_TO_INSTALL`	Installed pacakges within image.
`LFS_REL_URL`	Base location for SPL (firmware) and U-Boot files.
`KERN_REL_URL`	Where to get kernel packages, if not in `lfs` dir.
`SPL_PART`	SPL firmware filename. Look in `lfs` dir first.
`SPL_PART_SHA512SUM`	SPL sha512 checksum.
`UBOOT_PART`	U-Boot filename. Look in `lfs` dir first.
`UBOOT_PART_SHA512SUM`	U-Boot sha512 checksum.
`KERNEL_PKG`	Kernel package filename. Look in `lfs` dir first.
`KERNEL_PKG_SHA512SUM`	Kernel package sha512 checksum.
`KERNEL_HEADER_PKG`	Kernel headers package. Look in `lfs` dir first.
`KERNEL_HEADER_PKG_SHA512SUM`	Kernel headers package sha512 checksum.
`IMAGE_NAME`	Filename of image to be created.

sehraf / archlinux-visionfive2