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
15Building
16========
17
18Applications for the ``cortex_r8_virtual`` board target can be built
19using the standard build flow (see :ref:`build_an_application`):
20
21.. zephyr-app-commands::
22   :board: cortex_r8_virtual
23   :goals: build
24
25Flashing
26========
27
28Your software will run in simulation and you don't need to "flash" the board in a traditional way,
29but you can use this configuration to run Zephyr applications
30and kernel tests directly in Renode with the use of the ``run`` command.
31
32For example, with the :zephyr:code-sample:`synchronization` sample:
33
34.. zephyr-app-commands::
35   :zephyr-app: samples/synchronization
36   :host-os: unix
37   :board: cortex_r8_virtual
38   :goals: run
39
40This will build an image with the synchronization sample app, boot it using
41Renode, and display the following console output:
42
43.. code-block:: console
44
45        *** Booting Zephyr OS build v3.6.0-5689-g2a5c606abfa7 ***
46        thread_a: Hello World from cpu 0 on cortex_r8_virtual!
47        thread_b: Hello World from cpu 0 on cortex_r8_virtual!
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
51Exit Renode by pressing :kbd:`CTRL+C`.
52
53Debugging
54=========
55
56Refer to the detailed overview about :ref:`application_debugging`.
57
58Renode can serve as a GDB server. For more information, refer to the
59`Renode documentation about GDB debugging <https://renode.readthedocs.io/en/latest/debugging/gdb.html>`_.
60