ahcbb6/baremetal-helloqemu

Baremetal QEMU examples

Baremetal-HelloQEMU

Baremetal QEMU examples

These are introductory examples to showcase the use of QEMU to run baremetal applications.

Build Status

master
kirkstone
dunfell

Usage: The Yocto Project & OpenEmbedded

While these examples can easily be built manually using a toolchain from the host system, its purpose is to serve as examples for baremetal application programming on The Yocto Project and OpenEmbedded which allow users to build and run these examples, along with the required toolchain and QEMU easily using the following steps:

1.- Clone the required repositories (Use -b dunfell or -b kirkstone if you want a stable release)

$ git clone https://git.yoctoproject.org/git/poky
$ cd poky

2.- Source the build environment file

$ source oe-init-build-env

3.- Add the required variables to your local.conf (Supported MACHINES are qemuarm64,qemuarm,armuarmv5)

$ echo "MACHINE = \"qemuarm64\"" >> ./conf/local.conf
$ echo "TCLIBC = \"baremetal\"" >> ./conf/local.conf

4.- Build the application

$ bitbake baremetal-helloworld

5.- Run the baremetal application on QEMU:

$ runqemu nographic

Example output:

runqemu - INFO - Running bitbake -e ...
runqemu - INFO - Continuing with the following parameters:
KERNEL: [tmp/deploy/images/qemuarm64/baremetal-helloworld-qemuarm64.bin]
MACHINE: [qemuarm64]
FSTYPE: [bin]
ROOTFS: [tmp/deploy/images/qemuarm64/baremetal-helloworld-qemuarm64.bin]
CONFFILE: [tmp/deploy/images/qemuarm64/baremetal-helloworld-qemuarm64.qemuboot.conf]

Hello OpenEmbedded!

License & Credit

This work is based on what was done on:

Qemu versatile baremetal and qemu-sandbox by Francesco B.

It was initially licensed as CC-BY-SA but the author has agreed to use the MIT License instead.

The above supported the versatilepb architecture, and this code has been rewritten to work properly on newer architectures such as cortex-a15 (virt and vexpress), cortex-a57, cortex-a53, cortex-a72 (virt), etc.