[PATCH] Updated stm32h7 docs

Gedare Bloom gedare at rtems.org
Sun Jan 10 15:23:09 UTC 2021


Hi Robin,

Thank you for providing the documentation for the variant. I guess it may
evolve slightly due to the patch review on the code, but I have a couple of
notes for you below.

On Wed, Jan 6, 2021 at 9:08 AM Robin.Mueller <robin.mueller.m at gmail.com>
wrote:

> More informaion on where to find adaption points to different
> board variations and also instructions on how to configure
> the BSP build for a certain board variation
> ---
>  user/bsps/arm/stm32h7.rst | 11 ++++++++++-
>  1 file changed, 10 insertions(+), 1 deletion(-)
>
> diff --git a/user/bsps/arm/stm32h7.rst b/user/bsps/arm/stm32h7.rst
> index 3eee511..a373e70 100644
> --- a/user/bsps/arm/stm32h7.rst
> +++ b/user/bsps/arm/stm32h7.rst
> @@ -11,16 +11,25 @@ This BSP supports the
>  The BSP is known to run on these boards:
>
>  * `STM32H743I-EVAL 2 <
> https://www.st.com/en/evaluation-tools/stm32h743i-eval.html>`_
> +* `STM32H743ZI-Nucleo <
> https://www.st.com/en/evaluation-tools/nucleo-h743zi.html>`_
>
>  Clock Driver
>  ------------
>
> -The clock driver uses the `ARMv7-M Systick` module.
> +The clock driver uses the `ARMv7-M Systick` module. The HSE (external
> oscillator) value can also be different for different evaluation or custom
> boards, so it is recommended to check the default values of the BSP.
>
>
Please break your lines in the docs also at 80 characters, here and below.



>  Console Driver
>  --------------
>
>  The console driver supports the on-chip UART and USART modules.
> +Different board variations use different GPIO pins and blocks for the
> default communication UART and it is recommended to check whetheer the
> default configuration provided is valid in the BSP.
> +
>
s/whetheer/whether


> +To specify that the BSP should be built for the STM32H743ZI-Nucleo board,
> +users can supply ``STM32H743ZI_NUCLEO == True`` to ``config.ini`` when
> building the
> +BSP.
> +
> +Alternatively, users can supply the configuration structs defined in
> ``hal.h``
> +in the applicaton for other boards. For the console driver, the
> ``stm32h7_usartX_config`` structs are used to configure the GPIO pins and
> other parameters. The default implementations can be found in
> ``bsps/arm/stm32ht/console`` in the RTEMS sources.
>
>  Network Interface Driver
>  ------------------------
> --
> 2.25.1
>
> _______________________________________________
> devel mailing list
> devel at rtems.org
> http://lists.rtems.org/mailman/listinfo/devel
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.rtems.org/pipermail/devel/attachments/20210110/2bb8d69a/attachment-0001.html>


More information about the devel mailing list