1.. zephyr:board:: qemu_riscv32
2
3Overview
4********
5
6The RISCV32 QEMU board configuration is used to emulate the RISCV32 architecture.
7
8Programming and Debugging
9*************************
10
11Applications for the ``qemu_riscv32`` 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_riscv32
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 v1.8.99 - BUILD: Jun 27 2017 13:09:26 *****
34        threadA: Hello World from riscv32!
35        threadB: Hello World from riscv32!
36        threadA: Hello World from riscv32!
37        threadB: Hello World from riscv32!
38        threadA: Hello World from riscv32!
39        threadB: Hello World from riscv32!
40        threadA: Hello World from riscv32!
41        threadB: Hello World from riscv32!
42        threadA: Hello World from riscv32!
43        threadB: Hello World from riscv32!
44
45Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.
46
47Debugging
48=========
49
50Refer to the detailed overview about :ref:`application_debugging`.
51