1.. zephyr:board:: qemu_xtensa
2
3Overview
4********
5
6The QEMU board configuration is used to emulate the Xtensa architecture. This board
7configuration provides support for the Xtensa simulation environment.
8
9Programming and Debugging
10*************************
11
12Use this configuration to run basic Zephyr applications and kernel tests in the QEMU
13emulated environment, for example, with the :zephyr:code-sample:`synchronization` sample:
14
15.. zephyr-app-commands::
16   :zephyr-app: samples/synchronization
17   :host-os: unix
18   :board: qemu_xtensa/dc233c
19   :goals: run
20
21This will build an image with the synchronization sample app, boot it using
22QEMU, and display the following console output:
23
24.. code-block:: console
25
26        ***** BOOTING ZEPHYR OS v1.8.99 - BUILD: Jun 27 2017 13:09:26 *****
27        threadA: Hello World from xtensa!
28        threadB: Hello World from xtensa!
29        threadA: Hello World from xtensa!
30        threadB: Hello World from xtensa!
31        threadA: Hello World from xtensa!
32        threadB: Hello World from xtensa!
33        threadA: Hello World from xtensa!
34        threadB: Hello World from xtensa!
35        threadA: Hello World from xtensa!
36        threadB: Hello World from xtensa!
37
38Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.
39
40Debugging
41=========
42
43Refer to the detailed overview about :ref:`application_debugging`.
44