OrgZephyr/zephyr
OrgZephyr
/
zephyr
mirror of https://github.com/zephyrproject-rtos/zephyr.git
1
0
Fork 0
Code Issues Releases Wiki Activity
zephyr/boards/riscv/qemu_riscv32/doc/index.rst

61 lines
1.6 KiB
ReStructuredText
Raw Normal View History

doc: add qemu_riscv32 brief documentation Very brief documentation of the board as a placeholder, more info on supported features will follow. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-02-09 22:49:56 +08:00
.. _qemu_riscv32:
RISCV32 Emulation (QEMU)
########################
Overview
********
The RISCV32 QEMU board configuration is used to emulate the RISCV32 architecture.
boards: qemu: add image to qemu boards Add Qemu logo to qemu boards and expand intro. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2019-02-10 23:57:07 +08:00
.. figure:: qemu_riscv32.png
:width: 600px
:align: center
:alt: Qemu
Qemu (Credit: qemu.org)
doc: add qemu_riscv32 brief documentation Very brief documentation of the board as a placeholder, more info on supported features will follow. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-02-09 22:49:56 +08:00
Programming and Debugging
*************************
Applications for the ``qemu_riscv32`` board configuration can be built and run in
the usual way for emulated boards (see :ref:`build_an_application` and
:ref:`application_run` for more details).
Flashing
========
While this board is emulated and you can't "flash" it, you can 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_riscv32
: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 riscv32!
threadB: Hello World from riscv32!
threadA: Hello World from riscv32!
threadB: Hello World from riscv32!
threadA: Hello World from riscv32!
threadB: Hello World from riscv32!
threadA: Hello World from riscv32!
threadB: Hello World from riscv32!
threadA: Hello World from riscv32!
threadB: Hello World from riscv32!
doc: add how to exit from QEMU in samples While trying out the hello_world sample built for QEMU, I was expecting the sample app to exit and I'd return to a command prompt. Nope. You need to exit QEMU manually, so add that step to the sample instructions. Looking around, there are more uses of QEMU like this that could use this added step after running the sample app. Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
2019-08-29 06:46:09 +08:00
Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.
doc: add qemu_riscv32 brief documentation Very brief documentation of the board as a placeholder, more info on supported features will follow. Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2018-02-09 22:49:56 +08:00
Debugging
=========
Refer to the detailed overview about :ref:`application_debugging`.