boards: qemu: adopt new zephyr:board directive and role
This updates the documentation of all the Qemu boards to use the new `zephyr:board::` directive. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
This commit is contained in:
parent
f2c2cc334d
commit
bcfbcc00af
21 changed files with 24 additions and 68 deletions
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_arc:
|
.. zephyr:board:: qemu_arc
|
||||||
|
|
||||||
ARCv2 & ARCv3 Emulation (QEMU)
|
|
||||||
###############################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_cortex_a53:
|
.. zephyr:board:: qemu_cortex_a53
|
||||||
|
|
||||||
ARM Cortex-A53 Emulation (QEMU)
|
|
||||||
###############################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_cortex_m0:
|
.. zephyr:board:: qemu_cortex_m0
|
||||||
|
|
||||||
ARM Cortex-M0 Emulation (QEMU)
|
|
||||||
##############################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_cortex_m3:
|
.. zephyr:board:: qemu_cortex_m3
|
||||||
|
|
||||||
ARM Cortex-M3 Emulation (QEMU)
|
|
||||||
##############################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_cortex_r5:
|
.. zephyr:board:: qemu_cortex_r5
|
||||||
|
|
||||||
ARM Cortex-R5 Emulation (QEMU)
|
|
||||||
##############################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_kvm_arm64:
|
.. zephyr:board:: qemu_kvm_arm64
|
||||||
|
|
||||||
ARM AArch64 Virt KVM Emulation (QEMU)
|
|
||||||
#####################################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_leon3:
|
.. zephyr:board:: qemu_leon3
|
||||||
|
|
||||||
LEON3 Emulation (QEMU)
|
|
||||||
######################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_malta:
|
.. zephyr:board:: qemu_malta
|
||||||
|
|
||||||
MIPS Malta Emulation (QEMU)
|
|
||||||
###########################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_nios2:
|
.. zephyr:board:: qemu_nios2
|
||||||
|
|
||||||
Altera Nios-II Emulation (QEMU)
|
|
||||||
###############################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_riscv32:
|
.. zephyr:board:: qemu_riscv32
|
||||||
|
|
||||||
RISCV32 Emulation (QEMU)
|
|
||||||
########################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_riscv32_xip:
|
.. zephyr:board:: qemu_riscv32_xip
|
||||||
|
|
||||||
RISCV32 XIP Emulation (QEMU)
|
|
||||||
############################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
board:
|
board:
|
||||||
name: qemu_riscv32e
|
name: qemu_riscv32e
|
||||||
full_name: QEMU Emulation for RISCV32E Emulation
|
full_name: QEMU Emulation for RISCV32E
|
||||||
vendor: qemu
|
vendor: qemu
|
||||||
socs:
|
socs:
|
||||||
- name: qemu_virt_riscv32e
|
- name: qemu_virt_riscv32e
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_riscv32e:
|
.. zephyr:board:: qemu_riscv32e
|
||||||
|
|
||||||
RISCV32E Emulation (QEMU)
|
|
||||||
#########################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_riscv64:
|
.. zephyr:board:: qemu_riscv64
|
||||||
|
|
||||||
RISCV64 Emulation (QEMU)
|
|
||||||
########################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_x86:
|
.. zephyr:board:: qemu_x86
|
||||||
|
|
||||||
X86 Emulation (QEMU)
|
|
||||||
####################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,4 @@
|
||||||
.. _qemu_xtensa:
|
.. zephyr:board:: qemu_xtensa
|
||||||
|
|
||||||
Xtensa Emulation (QEMU)
|
|
||||||
#######################
|
|
||||||
|
|
||||||
Overview
|
Overview
|
||||||
********
|
********
|
||||||
|
|
|
||||||
3
doc/build/dts/howtos.rst
vendored
3
doc/build/dts/howtos.rst
vendored
|
|
@ -26,7 +26,8 @@ application and open the :file:`zephyr.dts` file in the build directory.
|
||||||
You can build :zephyr:code-sample:`hello_world` to see the "base" devicetree for your board
|
You can build :zephyr:code-sample:`hello_world` to see the "base" devicetree for your board
|
||||||
without any additional changes from :ref:`overlay files <dt-input-files>`.
|
without any additional changes from :ref:`overlay files <dt-input-files>`.
|
||||||
|
|
||||||
For example, using the :ref:`qemu_cortex_m3` board to build :zephyr:code-sample:`hello_world`:
|
For example, using the :zephyr:board:`qemu_cortex_m3` board to build
|
||||||
|
:zephyr:code-sample:`hello_world`:
|
||||||
|
|
||||||
.. code-block:: sh
|
.. code-block:: sh
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -42,7 +42,7 @@ Boards supported:
|
||||||
- :zephyr:board:`sam_e70_xplained`
|
- :zephyr:board:`sam_e70_xplained`
|
||||||
- :ref:`native_sim` (only usable for simple testing, limited capabilities
|
- :ref:`native_sim` (only usable for simple testing, limited capabilities
|
||||||
due to lack of hardware clock)
|
due to lack of hardware clock)
|
||||||
- :ref:`qemu_x86` (emulated, limited capabilities due to lack of hardware clock)
|
- :zephyr:board:`qemu_x86` (emulated, limited capabilities due to lack of hardware clock)
|
||||||
|
|
||||||
Enabling the stack
|
Enabling the stack
|
||||||
******************
|
******************
|
||||||
|
|
|
||||||
|
|
@ -145,8 +145,8 @@ Setting the Build System Target
|
||||||
To specify the build system target to run, use ``--target`` (or ``-t``).
|
To specify the build system target to run, use ``--target`` (or ``-t``).
|
||||||
|
|
||||||
For example, on host platforms with QEMU, you can use the ``run`` target to
|
For example, on host platforms with QEMU, you can use the ``run`` target to
|
||||||
build and run the :zephyr:code-sample:`hello_world` sample for the emulated :ref:`qemu_x86
|
build and run the :zephyr:code-sample:`hello_world` sample for the emulated
|
||||||
<qemu_x86>` board in one command::
|
:zephyr:board:`qemu_x86 <qemu_x86>` board in one command::
|
||||||
|
|
||||||
west build -b qemu_x86 -t run samples/hello_world
|
west build -b qemu_x86 -t run samples/hello_world
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -90,7 +90,7 @@ Example
|
||||||
-------
|
-------
|
||||||
|
|
||||||
This example uses the log module backend tied to serial console.
|
This example uses the log module backend tied to serial console.
|
||||||
This was done on :ref:`qemu_x86` where a null pointer was dereferenced.
|
This was done on :zephyr:board:`qemu_x86` where a null pointer was dereferenced.
|
||||||
|
|
||||||
This is the core dump log from the serial console, and is stored
|
This is the core dump log from the serial console, and is stored
|
||||||
in :file:`coredump.log`:
|
in :file:`coredump.log`:
|
||||||
|
|
|
||||||
|
|
@ -30,8 +30,8 @@ Requirements
|
||||||
************
|
************
|
||||||
|
|
||||||
A board with a supported llext architecture and console. This can also be
|
A board with a supported llext architecture and console. This can also be
|
||||||
executed in QEMU emulation on the :ref:`qemu_xtensa <qemu_xtensa>` or
|
executed in QEMU emulation on the :zephyr:board:`qemu_xtensa <qemu_xtensa>` or
|
||||||
:ref:`qemu_cortex_r5 <qemu_cortex_r5>` virtual boards.
|
:zephyr:board:`qemu_cortex_r5 <qemu_cortex_r5>` virtual boards.
|
||||||
|
|
||||||
Building and running
|
Building and running
|
||||||
********************
|
********************
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue