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

54 lines
1.4 KiB
ReStructuredText
Raw Normal View History

doc: add qemu_xtensa board instructions Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2017-06-27 21:41:17 +08:00
.. _qemu_xtensa:
Xtensa Emulation (QEMU)
#######################
Overview
********
The QEMU board configuration is used to emulate the Xtensa architecture. This board
configuration provides support for the Xtensa simulation environment.
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_xtensa.png
:width: 600px
:align: center
:alt: Qemu
Qemu (Credit: qemu.org)
doc: add qemu_xtensa board instructions Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2017-06-27 21:41:17 +08:00
Programming and Debugging
*************************
Use this configuration to run basic Zephyr applications and kernel tests in the QEMU
emulated environment, for example, with the :ref:`synchronization_sample`:
doc: boards: xtensa: convert make to cmake Use zephyr-app-commands appropriately. Signed-off-by: Marti Bolivar <marti@opensourcefoundries.com>
2017-11-11 02:01:27 +08:00
.. zephyr-app-commands::
:zephyr-app: samples/synchronization
doc: getting_started: Support multi-OS instructions In order to be able to document the build on Windows and UNIX systems, slight variations are required on the app commands that are used throughout the documentation system. This includes getting rid of the prompt symbol and providing commands for both UNIX and Windows operating systems. Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2018-01-18 00:32:31 +08:00
:host-os: unix
doc: boards: xtensa: convert make to cmake Use zephyr-app-commands appropriately. Signed-off-by: Marti Bolivar <marti@opensourcefoundries.com>
2017-11-11 02:01:27 +08:00
:board: qemu_xtensa
:goals: run
doc: add qemu_xtensa board instructions Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2017-06-27 21:41:17 +08:00
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 xtensa!
threadB: Hello World from xtensa!
threadA: Hello World from xtensa!
threadB: Hello World from xtensa!
threadA: Hello World from xtensa!
threadB: Hello World from xtensa!
threadA: Hello World from xtensa!
threadB: Hello World from xtensa!
threadA: Hello World from xtensa!
threadB: Hello World from xtensa!
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_xtensa board instructions Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2017-06-27 21:41:17 +08:00
Debugging
=========
Refer to the detailed overview about :ref:`application_debugging`.