.. _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.

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`:

.. code-block:: console

        $ make -C samples/synchronization BOARD=qemu_xtensa 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!

Debugging
=========

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