Installing and Starting the QEMU Emulator
for use with FreeRTOS demos applications
This page describes how to install QEMU for use with
FreeRTOS demo applications that target the QEMU emulator, rather than physical chips.
Note: At the time of writing all demo projects that target QEMU were developed and tested on Windows hosts.
-
Download and install QEMU - there is a separate download page
for pre-built QEMU Windows executables.
-
Build the demo application by following the instructions on the relevant demo specific documentation page, and note the name of the resultant executable. The rest of this page assumes the executable is called RTOSDemo.elf.
-
Start QEMU using the following command:
qemu-system-<TARGET_ARCHITECTURE> -kernel <PATH_TO>/RTOSDemo.elf -S -s -machine <TARGET_MACHINE>
-
Once running, QEMU will display a window as shown below. Leave the window open. At this point QEMU is waiting for a GDB connection - return to the demo specific documentation page for information on starting a debug session. Note: It is necessary to restart QEMU each time the RTOS executable is rebuilt.
QEMU Emulator
Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.