This is a fork of GNU ARM Eclipse QEMU, which is a project intended to provide support for Cortex-M emulation in QEMU.
First, grab the dependencies you'll need:
sudo apt-get install libfdt-dev libsdl2-image-2.0-0 libsdl2-2.0-0
Note that you'll need to be on a system that has a GUI (i.e not a default Ubuntu Server installation), due to the libsdl dependency requiring a context on qemu startup.
Clone the repository and switch to the correct branch:
git clone https://github.com/echronos/qemu echronos-qemu
cd echronos-qemu
git checkout echronos-qemu
Add our qemu binary to the PATH (you can do this permanently if you want):
export PATH=`pwd`/path:$PATH
This path directory just contains a script that allows you to run echronos-qemu-system-arm anywhere on your machine.
Note, when you load a kernel with this qemu, that the path to our kernel MUST be absolute as the qemu binary must be run with the CWD in it's binary folder. If you are in the eChronos repo, this means you will want to prefix elf files with `pwd`/out/....
We're ready to run a system! Say we already built an example gatria system for the stm32 (see official eChronos readme):
echronos-qemu-system-arm -mcu STM32F407VG -s --kernel `pwd`/out/machine-stm32f4-discovery/example/gatria-system/system
....
task b
task a
task b
b blocking
task a
task a
unblocking b
task b
task a
task b
task a
task b
task a
task b
b blocking
task a
Also note that in the above example we are not using the -S option which indicates that we will wait for a debugger to attach to the qemu machine.
To build a binary, read on.
On debian-derivatives you will need:
sudo apt-get install git zlib1g-dev libsdl2-dev libpixman-1-dev libsdl2-image-dev libfdt-dev
NOTE: Ubuntu 14.04 has a bug in it's distribution of libfdt-dev which will cause compilation to fail - see section near end of this readme for the fix.
First, clone the repository and switch to the correct branch:
git clone https://github.com/echronos/qemu echronos-qemu
cd echronos-qemu
git checkout echronos-qemu
Now we'll configure the build. Make sure to modify the SDL2 include path below to correspond to the your SDL2 headers. (this line should be fine on debian-derivatives)
./configure --target-list=gnuarmeclipse-softmmu --extra-cflags="-g -I/usr/include/SDL2/ -I/usr/include/" --disable-werror
We're ready to build it:
make
Now copy the binaries, device support files and images to our binary distribution folder:
cp gnuarmeclipse/devices/*.json bin-dist
cp gnuarmeclipse/graphics/*.jpg bin-dist
cp gnuarmeclipse-softmmu/qemu-system-gnuarmeclipse bin-dist
And now bin-dist contains fresh binaries that can be used in the same fashion as those at the start of this readme.
Ubuntu 14.04 is distributed with an old version of libfdt-dev, so you'll need to compile it yourself. First, make sure to uninstall libfdt-dev if you have already installed it.
After cloning the echronos-qemu repository, you'll also need the dependencies:
sudo apt-get install bison flex
Now fetch the dtc submodule on the repository:
git submodule update --init dtc
cd dtc
Now, open up the makefile and change the PREFIX variable value from:
PREFIX = $(HOME)
to
PREFIX = /usr
Now we can make and install libfdt:
make
sudo make install
Now, when building qemu with this libfdt, you'll have to make a small modification to the configure command - instead of:
./configure --target-list=gnuarmeclipse-softmmu --extra-cflags="-g -I/usr/include/SDL2/ -I/usr/include/" --disable-werror
You need to link to the version of fdt that you just installed by adding an additional cflag -lfdt:
./configure --target-list=gnuarmeclipse-softmmu --extra-cflags="-g -I/usr/include/SDL2/ -I/usr/include/ -lfdt" --disable-werror
All the ordinary build instructions remain the same.