Running system on riscv64-generic-qemu#

This version is designated for RISC-V 64 processors based virtual machine implemented by qemu-system-riscv64. To launch this version two files should be provided - phoenix.disk file integrated with SBI firmware with embedded PLO, kernel, UART16550 interface and virtio-blk drivers, dummyfs filesystem and the psh shell and rootfs.disk image with the ext2 filesystem.

The files are created as the final artifact of the phoenix-rtos-project building and are located in the _boot directory. See how to build the Phoenix-RTOS system image.

Running image under QEMU#

Firstly, you need to install QEMU emulator.

How to get QEMU (Ubuntu)
  • Install the required packages

    sudo apt-get update && \
    sudo apt-get install qemu-kvm \
    qemu virt-manager \
    virt-viewer libvirt-clients \
    libvirt-daemon-system \
    bridge-utils virtinst \
    libvirt-daemon \
    qemu-system-misc
    
  • Check if QEMU is properly installed:

    qemu-system-riscv64 --version
    
    ~$ qemu-system-riscv64 --version
    QEMU emulator version 4.2.1 (Debian 1:4.2-3ubuntu6.24)
    Copyright (c) 2003-2019 Fabrice Bellard and the QEMU Project developers
    ~$
    
How to get QEMU (macOS)
  • Install the required packages

    brew update && \
    brew install qemu
    
  • Check if QEMU is properly installed:

    qemu-system-riscv64 --version
    
    ~$ qemu-system-riscv64 --version
    QEMU emulator version 8.0.0
    Copyright (c) 2003-2022 Fabrice Bellard and the QEMU Project developers
    ~$
    
  • To run the image under QEMU you should type:

    ./scripts/riscv64-generic-qemu.sh
    

    Image
    Image

    Using Phoenix-RTOS#

    Phoenix-RTOS will be launched and the psh shell command prompt will appear in the terminal. To get the available command list please type:

    help
    

    Image

    To get the list of working processes please type:

    ps
    

    Image

    See also#

    1. Running system on targets

    2. Table of Contents