1.. zephyr:board:: cortex_r8_virtual
2
3Overview
4********
5
6The Cortex-R8 Virtual board is a virtual platform that can be emulated with Renode.
7Edit the :zephyr_file:`boards/renode/cortex_r8_virtual/support/cortex_r8_virtual.repl` file to adapt the platform layout to your needs.
8
9Refer to the `Renode documentation <https://renode.readthedocs.io/en/latest/>`_
10to learn how to obtain Renode for your host.
11
12Programming and debugging
13*************************
14
15.. zephyr:board-supported-runners::
16
17Building
18========
19
20Applications for the ``cortex_r8_virtual`` board target can be built
21using the standard build flow (see :ref:`build_an_application`):
22
23.. zephyr-app-commands::
24   :board: cortex_r8_virtual
25   :goals: build
26
27Flashing
28========
29
30Your software will run in simulation and you don't need to "flash" the board in a traditional way,
31but you can use this configuration to run Zephyr applications
32and kernel tests directly in Renode with the use of the ``run`` command.
33
34For example, with the :zephyr:code-sample:`synchronization` sample:
35
36.. zephyr-app-commands::
37   :zephyr-app: samples/synchronization
38   :host-os: unix
39   :board: cortex_r8_virtual
40   :goals: run
41
42This will build an image with the synchronization sample app, boot it using
43Renode, and display the following console output:
44
45.. code-block:: console
46
47        *** Booting Zephyr OS build v3.6.0-5689-g2a5c606abfa7 ***
48        thread_a: Hello World from cpu 0 on cortex_r8_virtual!
49        thread_b: Hello World from cpu 0 on cortex_r8_virtual!
50        thread_a: Hello World from cpu 0 on cortex_r8_virtual!
51        thread_b: Hello World from cpu 0 on cortex_r8_virtual!
52
53Exit Renode by pressing :kbd:`CTRL+C`.
54
55Debugging
56=========
57
58Refer to the detailed overview about :ref:`application_debugging`.
59
60Renode can serve as a GDB server. For more information, refer to the
61`Renode documentation about GDB debugging <https://renode.readthedocs.io/en/latest/debugging/gdb.html>`_.
62