qemu_vp-docker

Modified from https://github.com/z4yx/petalinux-docker

Builds a full qemu-systemc cosimulation virtual platform

Main advantage over https://hub.docker.com/repository/docker/asultan123/qemu_vp_light is that you can build new kernels/ modify rootfs with petalinux. If you can use Yocto you don't need this.

Requirements

Need to download petalinux 2019.2: https://www.xilinx.com/member/forms/download/xef.html?filename=petalinux-v2019.2-final-installer.run and the Xilinx ZCU102 BSP: https://www.xilinx.com/member/forms/download/xef.html?filename=xilinx-zcu102-v2019.2-final.bsp from Xilinx's website. Once downloaded place in ./build/ directory

Please note that an account with Xilinx is needed to download the above files, additionally, they can only be downloaded by IPs from specific countries, otherwise the website will spit out an export control violation and prevent the download from happening. If you're attempting to download from an unauthorized area, reach out to your institution/ university.

Build Steps

1. Rename petalinux install to petalinux_2019.run after moving it to the build directory

2. To build run: docker build -t qemu_vp:PLATFORM .

Run Steps

These step also forward external port 2222 to container internal port 22 for ssh and scp

1. docker run --hostname builder -it qemu_vp:PLATFORM -p 2222:22
2. su peta (password is 123456789)

To detach from container press CTRL+p CTRL+q

Virtual Enviornment Launch Steps

Either use tmux or ssh from two terminals

First Terminal

1. cd systemctlm-cosim-demo
2. ./launch.sh

Second Terminal

1. cd xilinx-zcu102-2019.2
2. ./launch

Second terminal will use petalinux to launch a qemu instance running kernel compiled for aarch64 in ultrascale There's nothing special about petalinux here. You can get xilinx's fork of qemu here https://github.com/Xilinx/qemu and duplicate the command petalinux runs (some args added by petalinux might be deprecated) with relevant kernel files referenced in the qemu launch command.

Note on Debugging

To debug systemc side you can use gdb within the container or connect to the process with gdb server To debug kernel userspace code running in qemu you can connect to a process with gdbserver there normally, kernel boots by default with gdbserver installed

SSH access for development with desired IDE

After running container run the command: sudo service ssh start

Add the following the your ~/.ssh/config file

Host qemu_vp
    	Hostname localhost
	Port 2222
    	User peta
    	UserKnownHostsFile /dev/null
    	StrictHostKeyChecking no

Then upload your sshkey using ssh-copy-id peta@qemu_vp

Now you access the container via ssh with the command ssh peta@qemu_vp

The container has one user "peta" who's password is 123456789

Note on building

Total build time is around 30 minutes on an i7-9700k with 32 GB ram. Post build size balloons to 50 GB so keep that in mind.

Compiling aarch64 binaries for kernel running on qemu

Since qemu simulates an arm processor in the ultrascale x86 binaries won't execute there. You need to compile binaries for aarch64. To compile aarch64 binaries within the container you must download the linerao aarch64 gcc compiler (Will be included by default in future commits)

1. ssh into container
2. cd ~
3. wget https://releases.linaro.org/components/toolchain/binaries/latest-7/aarch64-linux-gnu/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz
4. sudo sudo tar -xvzf gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz /usr/bin
5. sudo chmod -R u+rwx /usr/bin/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/

/usr/bin should be in path by default but if the compiler doesn't show up right away, just:

1. echo "export PATH=$PATH:/usr/bin" >> ~/.bashrc
2. source ~/.bashrc