RISC-V
|
Size: 1330
Comment:
|
Size: 4056
Comment: capitalize QEMU
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| = RISC-V = | Ubuntu provides the riscv64 architecture for the RISC-V platform since the release of Ubuntu 20.04 LTS. |
| Line 3: | Line 3: |
| Ubuntu provides riscv64 architecture for the RISC-V platform since Focal release. | == Images == |
| Line 5: | Line 5: |
| One can boot it on any system with qemu-system, or on bare-metal board such as those built by SiFive. | === Preinstalled SD-card Images === |
| Line 7: | Line 7: |
| == Booting with qemu == | * Ubuntu 20.04.4 preinstalled SD-card images for the SiFive HiFive Unmatched and the SiFive HiFive Unleashed boards are available at https://cdimage.ubuntu.com/releases/20.04.4/release/. |
| Line 9: | Line 9: |
| * Machine type `virt` aka `-machine virt` * Bios is OpenSBI (`apt install opensbi`) `-bios /usr/lib/riscv64-linux-gnu/opensbi/generic/fw_jump.elf` * "kernel" is qemu smode uboot (`apt install u-boot-qemu`) `-kernel /usr/lib/u-boot/qemu-riscv64_smode/uboot.elf` * And just the cloud image from http://cloud-images.ubuntu.com/ |
* A Ubuntu 22.04 preinstalled SD-card image for the SiFive HiFive board is available at https://cdimage.ubuntu.com/releases/22.04/release/. The riscv64+unmatched image can also be used on QEMU. === Server Install Image === If you want to install Ubuntu on a disk drive, use the server install image. * A Ubuntu 22.04 server install image supporting the SiFive HiFive Unmatched board and QEMU is available at https://cdimage.ubuntu.com/releases/22.04/release/. == Forums == You can discuss Ubuntu on RISC-V over at the [[https://discourse.ubuntu.com/c/server/17|Ubuntu Server forums]]. == Booting with QEMU == Prerequisites: * apt install qemu-system-misc opensbi u-boot-qemu qemu-utils After installing the above prerequisites, one can use any of the above images to boot virtual machine. First unpack the image {{{ xz -dk ubuntu-22.04-preinstalled-server-riscv64+unmatched.img.xz }}} Optionally, if you want larger disk, you can expand the disk (filesystem will be automatically resized too). {{{ qemu-img resize -f raw ubuntu-22.04-preinstalled-server-riscv64+unmatched.img +5G }}} Next use OpenSBI bootloader & u-boot-qemu to boot the virtual machine |
| Line 16: | Line 48: |
| `` | {{{ |
| Line 18: | Line 50: |
| -machine virt -m 2048 -smp 4 \ -bios /usr/lib/riscv64-linux-gnu/opensbi/generic/fw_jump.elf -kernel /usr/lib/u-boot/qemu-riscv64_smode/uboot.elf \ -device virtio-blk-device,drive=vda -drive file=livecd.ubuntu-cpc.img,id=vda -device virtio-net-device,netdev=eth0 -netdev user,id=eth0 ``` |
-machine virt -nographic -m 2048 -smp 4 \ -bios /usr/lib/riscv64-linux-gnu/opensbi/generic/fw_jump.elf \ -kernel /usr/lib/u-boot/qemu-riscv64_smode/uboot.elf \ -device virtio-net-device,netdev=eth0 -netdev user,id=eth0 \ -drive file=ubuntu-22.04-preinstalled-server-riscv64+unmatched.img,format=raw,if=virtio }}} |
| Line 23: | Line 57: |
| Adjust to taste as needed. The image has a fallback cloud-init datasource that configures sudo user `ubuntu` with password `ubuntu`. Alternatively, you can provide a config drive (or tweak the first partitions `/var/lib/cloud/seed/nocloud/*` files) to setup anything else using cloud-init. For example ssh keys, disabling interactive login, and so on. See https://cloudinit.readthedocs.io/en/latest | The important options to use are: * Machine type `virt` aka `-machine virt` * Bios is OpenSBI `-bios /usr/lib/riscv64-linux-gnu/opensbi/generic/fw_jump.elf` * "kernel" is qemu smode uboot `-kernel /usr/lib/u-boot/qemu-riscv64_smode/uboot.elf` One can use pass through networking, adjust memory (`-m`) & cpu counts (`-smp`) as needed. Switch to the serial console, wait for cloud-init to complete, then login using `ubuntu:ubuntu`. See the cloud-init section below to further customise the first boot behaviour with cloud-init. == Booting on SiFive HiFive Unmatched board == The above image has U-Boot SPL loader as well as SiFive U-Boot to boot on the board. Set jumpers to boot from the microSD by setting `MSEL=1011` (MSEL2 to the outside of the board, the rest to the inside). You can then use "Gnome Disks" app to restore `img.xz` image onto the microSD card, plug it into the board and boot. You can also use cmdline to extract the image and dd it. {{{ xz -dk ubuntu-22.04-preinstalled-server-riscv64+unmatched.img.xz dd if=ubuntu-22.04-preinstalled-server-riscv64+unmatched.img of=/dev/disk/by-id/<TAB><TAB>complete-to-sdcard-device }}} Monitor serial console, wait for cloud-init to complete, then login using `ubuntu:ubuntu`. See the cloud-init section below to further customise the first boot behaviour with cloud-init. == cloud-init integration == The image has a fallback cloud-init datasource that configures sudo user `ubuntu` with password `ubuntu` and DHCP networking. You will be asked to change the password on first login. The image has `CIDATA` partition which can be used as a valid datasource to adjust cloud-config metadata. If you wish to customize user password, networking information, add ssh keys, etc. Please mount `CIDATA` partition rename `meta-data` and `user-data` files and adjust them to taste. You can use network-info to configure networking if something more sophisticated than just DHCP is desired. For example ssh keys, disabling interactive login, and so on. See https://cloudinit.readthedocs.io/en/latest |
Ubuntu provides the riscv64 architecture for the RISC-V platform since the release of Ubuntu 20.04 LTS.
Images
Preinstalled SD-card Images
Ubuntu 20.04.4 preinstalled SD-card images for the SiFive HiFive Unmatched and the SiFive HiFive Unleashed boards are available at https://cdimage.ubuntu.com/releases/20.04.4/release/.
A Ubuntu 22.04 preinstalled SD-card image for the SiFive HiFive board is available at https://cdimage.ubuntu.com/releases/22.04/release/.
The riscv64+unmatched image can also be used on QEMU.
Server Install Image
If you want to install Ubuntu on a disk drive, use the server install image.
A Ubuntu 22.04 server install image supporting the SiFive HiFive Unmatched board and QEMU is available at https://cdimage.ubuntu.com/releases/22.04/release/.
Forums
You can discuss Ubuntu on RISC-V over at the Ubuntu Server forums.
Booting with QEMU
Prerequisites:
- apt install qemu-system-misc opensbi u-boot-qemu qemu-utils
After installing the above prerequisites, one can use any of the above images to boot virtual machine.
First unpack the image
xz -dk ubuntu-22.04-preinstalled-server-riscv64+unmatched.img.xz
Optionally, if you want larger disk, you can expand the disk (filesystem will be automatically resized too).
qemu-img resize -f raw ubuntu-22.04-preinstalled-server-riscv64+unmatched.img +5G
Next use OpenSBI bootloader & u-boot-qemu to boot the virtual machine
Working example with all the options is:
qemu-system-riscv64 \ -machine virt -nographic -m 2048 -smp 4 \ -bios /usr/lib/riscv64-linux-gnu/opensbi/generic/fw_jump.elf \ -kernel /usr/lib/u-boot/qemu-riscv64_smode/uboot.elf \ -device virtio-net-device,netdev=eth0 -netdev user,id=eth0 \ -drive file=ubuntu-22.04-preinstalled-server-riscv64+unmatched.img,format=raw,if=virtio
The important options to use are:
Machine type virt aka -machine virt
Bios is OpenSBI -bios /usr/lib/riscv64-linux-gnu/opensbi/generic/fw_jump.elf
"kernel" is qemu smode uboot -kernel /usr/lib/u-boot/qemu-riscv64_smode/uboot.elf
One can use pass through networking, adjust memory (-m) & cpu counts (-smp) as needed.
Switch to the serial console, wait for cloud-init to complete, then login using ubuntu:ubuntu. See the cloud-init section below to further customise the first boot behaviour with cloud-init.
Booting on SiFive HiFive Unmatched board
The above image has U-Boot SPL loader as well as SiFive U-Boot to boot on the board.
Set jumpers to boot from the microSD by setting MSEL=1011 (MSEL2 to the outside of the board, the rest to the inside).
You can then use "Gnome Disks" app to restore img.xz image onto the microSD card, plug it into the board and boot.
You can also use cmdline to extract the image and dd it.
xz -dk ubuntu-22.04-preinstalled-server-riscv64+unmatched.img.xz dd if=ubuntu-22.04-preinstalled-server-riscv64+unmatched.img of=/dev/disk/by-id/<TAB><TAB>complete-to-sdcard-device
Monitor serial console, wait for cloud-init to complete, then login using ubuntu:ubuntu. See the cloud-init section below to further customise the first boot behaviour with cloud-init.
cloud-init integration
The image has a fallback cloud-init datasource that configures sudo user ubuntu with password ubuntu and DHCP networking. You will be asked to change the password on first login.
The image has CIDATA partition which can be used as a valid datasource to adjust cloud-config metadata. If you wish to customize user password, networking information, add ssh keys, etc. Please mount CIDATA partition rename meta-data and user-data files and adjust them to taste. You can use network-info to configure networking if something more sophisticated than just DHCP is desired.
For example ssh keys, disabling interactive login, and so on. See https://cloudinit.readthedocs.io/en/latest
RISC-V (last edited 2025-02-07 13:36:10 by adrianoco)