.. _qemu_xtensa:

Xtensa Emulation (QEMU)
#######################

Overview
********

The QEMU board configuration is used to emulate the Xtensa architecture. This board
configuration provides support for the Xtensa simulation environment.

.. figure:: ../../../../../../../../../zephyr/boards/xtensa/qemu_xtensa/doc/qemu_xtensa.png
   :width: 600px
   :align: center
   :alt: Qemu

   Qemu (Credit: qemu.org)

Programming and Debugging
*************************

Use this configuration to run basic Zephyr applications and kernel tests in the QEMU
emulated environment, for example, with the :ref:`synchronization_sample`:

.. zephyr-app-commands::
   :zephyr-app: samples/synchronization
   :host-os: unix
   :board: qemu_xtensa
   :goals: run

This will build an image with the synchronization sample app, boot it using
QEMU, and display the following console output:

.. code-block:: console

        ***** BOOTING ZEPHYR OS v1.8.99 - BUILD: Jun 27 2017 13:09:26 *****
        threadA: Hello World from xtensa!
        threadB: Hello World from xtensa!
        threadA: Hello World from xtensa!
        threadB: Hello World from xtensa!
        threadA: Hello World from xtensa!
        threadB: Hello World from xtensa!
        threadA: Hello World from xtensa!
        threadB: Hello World from xtensa!
        threadA: Hello World from xtensa!
        threadB: Hello World from xtensa!

Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.

Debugging
=========

Refer to the detailed overview about :ref:`application_debugging`.