Running system on
ia32-generic (PC based on IA32 processor)
This version is designated for generic PC based on the IA32 processor. To launch this version the final disk image should be provided. The image is created as the final artifact of the
phoenix-rtos-project building and is located in the
_boot directory. The image consists of the bootloader (plo), kernel, TTY VGA driver, ATA driver with ext2 filesystem.
Running image under qemu
Firstly, you need to install qemu emulator.
How to get qemu (Ubuntu 20.04)
- Install the required packages
sudo apt-get update && \
sudo apt-get install qemu-kvm \
qemu virt-manager \
virt-viewer libvirt-clients \
bridge-utils virtinst \
- Check if qemu is properly installed:
To run the system image under qemu you should type the following command (launched from
Phoenix-RTOS will be launched and the
psh shell command prompt will appear in the terminal.
To get the available command list please type:
In order to run one of the user applications you should type
/usr/bin/appname, for example:
The result is presented below.
You can press
ctrl + c to quit the voxeldemo app.
To get the list of working processes please type:
There is a possibility to run the ash shell, it can be launched using the following command.
Phoenix-RTOS image can be also launched on multiple processor cores. To do this please define the number of cores (e.g. 4) using the following command (launched from the
qemu-system-i386 -hda _boot/phoenix-ia32-generic.disk -smp 4
The number of detected cores is presented during kernel initialization.
Running image on regular hardware
To run the image on regular hardware please be sure that a target system is equipped with an ATA disk supporting the PATA interface. The image should be copied to the boot disk using the
dd command (it is assumed that the target disk is represented by /dev/sda block device).
dd if=_boot/phoenix-ia32-generic.disk of=/dev/sda