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_riscv64/doc/index.rst

70 lines
2.0 KiB
ReStructuredText
Raw Normal View History

riscv: add a qemu_riscv64 board This emulates a RISC-V in 64-bit mode on a SiFive FE310 dev board. Memory is tight so a few tests had to be disabled due to the extra memory usage compared to qemu_riscv32. Signed-off-by: Nicolas Pitre <npitre@baylibre.com>
2019-07-19 11:07:45 +08:00
.. _qemu_riscv64:
RISCV64 Emulation (QEMU)
########################
Overview
********
The RISCV64 QEMU board configuration is used to emulate the RISCV64 architecture.
.. figure:: qemu_riscv64.png
:width: 600px
:align: center
:alt: QEMU
QEMU (Credit: qemu.org)
Get the Toolchain and QEMU
**************************
The minimum version of the `Zephyr SDK tools
<https://www.zephyrproject.org/developers/#downloads>`_
with toolchain and QEMU support for the RISV64 architecture is v0.10.2.
doc: fix broken doc links The project's README.rst references the support board docs with an URL that's not working these days (see https://github.com/zephyrproject-rtos/infrastructure/issues/134) so fix that URL reference. While looking for other similar linking cases, I found a hard URL references that should be using :ref: role, and a release notes reference to a (now) broken link (fixing that in the /latest/ version of the 1.10 release notes). Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
2019-08-31 05:06:14 +08:00
Please see the :ref:`installation instructions <install-required-tools>`
riscv: add a qemu_riscv64 board This emulates a RISC-V in 64-bit mode on a SiFive FE310 dev board. Memory is tight so a few tests had to be disabled due to the extra memory usage compared to qemu_riscv32. Signed-off-by: Nicolas Pitre <npitre@baylibre.com>
2019-07-19 11:07:45 +08:00
for more details.
Programming and Debugging
*************************
Applications for the ``qemu_riscv64`` 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_riscv64
: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 riscv64!
threadB: Hello World from riscv64!
threadA: Hello World from riscv64!
threadB: Hello World from riscv64!
threadA: Hello World from riscv64!
threadB: Hello World from riscv64!
threadA: Hello World from riscv64!
threadB: Hello World from riscv64!
threadA: Hello World from riscv64!
threadB: Hello World from riscv64!
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`.
riscv: add a qemu_riscv64 board This emulates a RISC-V in 64-bit mode on a SiFive FE310 dev board. Memory is tight so a few tests had to be disabled due to the extra memory usage compared to qemu_riscv32. Signed-off-by: Nicolas Pitre <npitre@baylibre.com>
2019-07-19 11:07:45 +08:00
Debugging
=========
Refer to the detailed overview about :ref:`application_debugging`.