[PATCH] user: Document arm/fvp BSP

[Chris Johns]

Ok to push

Thanks
Chris

On 9/9/2022 3:49 pm, Sebastian Huber wrote:
> Close #4202.
> ---
>  user/bsps/arm/fvp.rst  | 39 +++++++++++++++++++++++++++++++++++++++
>  user/bsps/bsps-arm.rst |  1 +
>  2 files changed, 40 insertions(+)
>  create mode 100644 user/bsps/arm/fvp.rst
> 
> diff --git a/user/bsps/arm/fvp.rst b/user/bsps/arm/fvp.rst
> new file mode 100644
> index 0000000..a1e186a
> --- /dev/null
> +++ b/user/bsps/arm/fvp.rst
> @@ -0,0 +1,39 @@
> +.. SPDX-License-Identifier: CC-BY-SA-4.0
> +
> +.. Copyright (C) 2022 embedded brains GmbH
> +
> +fvp (Fixed Virtual Platform)
> +============================
> +
> +The BSP for the
> +`Arm Fixed Virtual Platforms <https://developer.arm.com/Tools%20and%20Software/Fixed%20Virtual%20Platforms>`_
> +offers one variant.  You need a license from Arm to run the simulator.  The
> +`fvp_cortex_r52` variant supports a simulation of the Cortex-R52 processor.
> +The BSP supports the SMP configuration.
> +
> +Run an Executable
> +-----------------
> +
> +To run an executable on a single Cortex-R52 processor use:
> +
> +.. code-block:: none
> +
> +    FVP_BaseR_Cortex-R52x1 -C bp.vis.disable_visualisation=1 -a build/arm/fvp_cortex_r52/testsuites/samples/ticker.exe
> +
> +To run an executable on a four Cortex-R52 processors use:
> +
> +.. code-block:: none
> +
> +    FVP_BaseR_Cortex-R52x4 -C bp.vis.disable_visualisation=1 -a build/arm/fvp_cortex_r52/testsuites/samples/ticker.exe
> +
> +Clock Driver
> +------------
> +
> +The clock driver uses the `ARMv7-AR Generic Timer`.
> +
> +Console Driver
> +--------------
> +
> +The console driver uses the
> +`semihosting <https://developer.arm.com/documentation/dui0471/g/Semihosting/Semihosting-operations?lang=en>`_
> +``SYS_READC`` and ``SYS_WRITEC`` system calls.
> diff --git a/user/bsps/bsps-arm.rst b/user/bsps/bsps-arm.rst
> index f1113e3..d9b5d01 100644
> --- a/user/bsps/bsps-arm.rst
> +++ b/user/bsps/bsps-arm.rst
> @@ -14,6 +14,7 @@ arm (ARM)
>    arm/csb336.rst
>    arm/csb337.rst
>    arm/edb7312.rst
> +  arm/fvp.rst
>    arm/gumstix.rst
>    arm/imx.rst
>    arm/imxrt.rst