70 lines
2.0 KiB
ReStructuredText
70 lines
2.0 KiB
ReStructuredText
.. _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://github.com/zephyrproject-rtos/sdk-ng/releases>`_
|
|
with toolchain and QEMU support for the RISCV64 architecture is v0.10.2.
|
|
Please see the :ref:`installation instructions <install-required-tools>`
|
|
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!
|
|
|
|
Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.
|
|
|
|
Debugging
|
|
=========
|
|
|
|
Refer to the detailed overview about :ref:`application_debugging`.
|