.. _apps_run: Run an Application ################## The kernel's built-in simulator is QEMU. It creates an environment where you can run and test an application virtually, before (or in lieu of) loading and running it on actual target hardware. Procedures ********** .. _run_app_qemu: Running an Application using QEMU ================================= Run your application in QEMU for testing and demonstration purposes. Prerequisites ------------- * You must have already generated a .elf image file for a QEMU-supported board configuration, such as qemu_cortex_m3 or qemu_x86. * The environment variable must be set for each console terminal using :ref:`apps_common_procedures`. Steps ----- 1. Open a terminal console and navigate to the application directory :file:`~/appDir`. 2. Enter the following command to build and run an application in QEMU: .. code-block:: console $ make qemu The application begins running in the terminal console. 3. Press :kbd:`Ctrl A, X` to stop the application from running in QEMU. The application stops running and the terminal console prompt redisplays. .. _loading_on_target: Loading and Running an Application on Target Hardware ===================================================== An application image is loaded on the target based on functionality available on the hardware device. Loading instructions are often unique to the particular target board. For this reason, loading instructions reside with the board-specific documentation. For more information see :ref:`board`.