1.. zephyr:board:: qemu_leon3
2
3Overview
4********
5
6The LEON3 QEMU board configuration is used to emulate the LEON3 processor.
7
8Programming and Debugging
9*************************
10
11Applications for the ``qemu_leon3`` board configuration can be built and run in
12the usual way for emulated boards (see :ref:`build_an_application` and
13:ref:`application_run` for more details).
14
15Flashing
16========
17
18While this board is emulated and you can't "flash" it, you can use this
19configuration to run basic Zephyr applications and kernel tests in the QEMU
20emulated environment. For example, with the :zephyr:code-sample:`synchronization` sample:
21
22.. zephyr-app-commands::
23   :zephyr-app: samples/synchronization
24   :host-os: unix
25   :board: qemu_leon3
26   :goals: run
27
28This will build an image with the synchronization sample app, boot it using
29QEMU, and display the following console output:
30
31.. code-block:: console
32
33        *** Booting Zephyr OS build zephyr-v2.4.0-27-g7b37fdd5303b  ***
34        threadA: Hello World from qemu_leon3!
35        threadB: Hello World from qemu_leon3!
36        threadA: Hello World from qemu_leon3!
37        threadB: Hello World from qemu_leon3!
38        threadA: Hello World from qemu_leon3!
39        threadB: Hello World from qemu_leon3!
40        threadA: Hello World from qemu_leon3!
41        threadB: Hello World from qemu_leon3!
42        threadA: Hello World from qemu_leon3!
43        threadB: Hello World from qemu_leon3!
44
45Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.
46
47Debugging
48=========
49
50Refer to the detailed overview about :ref:`application_debugging`.
51