zephyr/boards/xtensa/qemu_xtensa/doc/index.rst

52 lines
1.4 KiB
ReStructuredText

.. _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:: 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!
Debugging
=========
Refer to the detailed overview about :ref:`application_debugging`.