bsps/stm32h7: update STM32 H7 HAL

This patch updates STM32 H7 HAL source files. The files are taken from two
STM projects from their github.com repositories:

(i)
https://github.com/STMicroelectronics/stm32h7xx_hal_driver.git

The project files are still available under BSD-3 license
and the version/commit used is:

d5fc8d05fc16fa2a2a2f948cf6c6ab39e78358e1

which represents post Release v1.11.1 development tree.

(ii)
https://github.com/STMicroelectronics/cmsis_device_h7.git

The project files were re-licensed from previous BSD-3 to Apache 2.0
license. Fortunately the project does not contain NOTICE file so no need
to do anything special when used in RTEMS.

The project version/commit imported is:

6d5ef249bec5177e0e2a0880ed62df2132874d99

which is code-wise Release v1.10.3 exactly.

1 files changed, 26 insertions, 42 deletions

diff --git a/bsps/arm/stm32h7/include/stm32h7xx_hal_mdma.h b/bsps/arm/stm32h7/include/stm32h7xx_hal_mdma.h
index d18e13ebfb..a39cc0d755 100644
--- a/bsps/arm/stm32h7/include/stm32h7xx_hal_mdma.h
+++ b/bsps/arm/stm32h7/include/stm32h7xx_hal_mdma.h
@@ -6,13 +6,12 @@
   ******************************************************************************
   * @attention
   *
-  * <h2><center>&copy; COPYRIGHT(c) 2017 STMicroelectronics.
-  * All rights reserved.</center></h2>
+  * Copyright (c) 2017 STMicroelectronics.
+  * All rights reserved.
   *
-  * This software component is licensed by ST under BSD 3-Clause license,
-  * the "License"; You may not use this file except in compliance with the
-  * License. You may obtain a copy of the License at:
-  *                        opensource.org/licenses/BSD-3-Clause
+  * This software is licensed under terms that can be found in the LICENSE file
+  * in the root directory of this software component.
+  * If no LICENSE file comes with this software, it is provided AS-IS.
   *
   ******************************************************************************
   */
@@ -39,7 +38,6 @@
 /* Exported types ------------------------------------------------------------*/
 
 /** @defgroup MDMA_Exported_Types MDMA Exported Types
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA Exported Types
   * @{
   */
@@ -83,7 +81,7 @@ typedef struct
                                           this is the number of bytes to be transferred in a single transfer (1 byte to 128 bytes)*/
 
   uint32_t SourceBurst;              /*!< Specifies the Burst transfer configuration for the source memory transfers.
-                                         It specifies the amount of data to be transferred in a single non interruptable
+                                         It specifies the amount of data to be transferred in a single non interruptible
                                          transaction.
                                          This parameter can be a value of @ref MDMA_Source_burst
                                          @note : the burst may be FIXED/INCR based on SourceInc value ,
@@ -91,7 +89,7 @@ typedef struct
                                          BufferTransferLength */
 
   uint32_t DestBurst;                 /*!< Specifies the Burst transfer configuration for the destination memory transfers.
-                                           It specifies the amount of data to be transferred in a single non interruptable
+                                           It specifies the amount of data to be transferred in a single non interruptible
                                            transaction.
                                            This parameter can be a value of @ref MDMA_Destination_burst
                                            @note : the burst may be FIXED/INCR based on DestinationInc value ,
@@ -249,13 +247,11 @@ typedef struct __MDMA_HandleTypeDef
 /* Exported constants --------------------------------------------------------*/
 
 /** @defgroup MDMA_Exported_Constants MDMA Exported Constants
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA Exported constants
   * @{
   */
 
 /** @defgroup MDMA_Error_Codes MDMA Error Codes
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA Error Codes
   * @{
   */
@@ -275,7 +271,6 @@ typedef struct __MDMA_HandleTypeDef
   */
 
 /** @defgroup MDMA_Request_selection MDMA Request selection
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA_Request_selection
   * @{
   */
@@ -340,7 +335,6 @@ typedef struct __MDMA_HandleTypeDef
   */
 
 /** @defgroup MDMA_Transfer_TriggerMode MDMA Transfer Trigger  Mode
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA Transfer Trigger Mode
   * @{
   */
@@ -354,7 +348,6 @@ typedef struct __MDMA_HandleTypeDef
   */
 
 /** @defgroup MDMA_Priority_level MDMA Priority level
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA Priority level
   * @{
   */
@@ -369,7 +362,6 @@ typedef struct __MDMA_HandleTypeDef
 
 
 /** @defgroup MDMA_Endianness MDMA Endianness
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA Endianness
   * @{
   */
@@ -383,7 +375,6 @@ typedef struct __MDMA_HandleTypeDef
   */
 
 /** @defgroup MDMA_Source_increment_mode MDMA Source increment mode
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA Source increment mode
   * @{
   */
@@ -402,7 +393,6 @@ typedef struct __MDMA_HandleTypeDef
   */
 
 /** @defgroup MDMA_Destination_increment_mode MDMA Destination increment mode
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA Destination increment mode
   * @{
   */
@@ -421,7 +411,6 @@ typedef struct __MDMA_HandleTypeDef
   */
 
 /** @defgroup MDMA_Source_data_size MDMA Source data size
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA Source data size
   * @{
   */
@@ -435,7 +424,6 @@ typedef struct __MDMA_HandleTypeDef
   */
 
 /** @defgroup MDMA_Destination_data_size MDMA Destination data size
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA Destination data size
   * @{
   */
@@ -449,7 +437,6 @@ typedef struct __MDMA_HandleTypeDef
   */
 
 /** @defgroup MDMA_data_Alignment MDMA data alignment
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA data alignment
   * @{
   */
@@ -465,7 +452,6 @@ typedef struct __MDMA_HandleTypeDef
   */
 
 /** @defgroup MDMA_Source_burst MDMA Source burst
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA Source burst
   * @{
   */
@@ -483,7 +469,6 @@ typedef struct __MDMA_HandleTypeDef
   */
 
 /** @defgroup MDMA_Destination_burst MDMA Destination burst
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA Destination burst
   * @{
   */
@@ -501,7 +486,6 @@ typedef struct __MDMA_HandleTypeDef
   */
 
 /** @defgroup MDMA_interrupt_enable_definitions MDMA interrupt enable definitions
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA interrupt enable definitions
   * @{
   */
@@ -516,7 +500,6 @@ typedef struct __MDMA_HandleTypeDef
   */
 
 /** @defgroup MDMA_flag_definitions MDMA flag definitions
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    MDMA flag definitions
   * @{
   */
@@ -525,7 +508,7 @@ typedef struct __MDMA_HandleTypeDef
 #define MDMA_FLAG_BRT   ((uint32_t)MDMA_CISR_BRTIF) /*!< Block Repeat Transfer complete flag */
 #define MDMA_FLAG_BT    ((uint32_t)MDMA_CISR_BTIF)  /*!< Block Transfer complete flag        */
 #define MDMA_FLAG_BFTC  ((uint32_t)MDMA_CISR_TCIF)  /*!< BuFfer Transfer complete flag       */
-#define MDMA_FLAG_CRQA  ((uint32_t)MDMA_CISR_CRQA)  /*!< Channel ReQest Active flag          */
+#define MDMA_FLAG_CRQA  ((uint32_t)MDMA_CISR_CRQA)  /*!< Channel request Active flag          */
 
 /**
   * @}
@@ -538,7 +521,6 @@ typedef struct __MDMA_HandleTypeDef
 /* Exported macro ------------------------------------------------------------*/
 
 /** @defgroup MDMA_Exported_Macros MDMA Exported Macros
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @{
   */
 
@@ -566,7 +548,7 @@ typedef struct __MDMA_HandleTypeDef
   *            @arg MDMA_FLAG_BRT  : Block Repeat Transfer flag.
   *            @arg MDMA_FLAG_BT   : Block Transfer complete flag.
   *            @arg MDMA_FLAG_BFTC : BuFfer Transfer Complete flag.
-  *            @arg MDMA_FLAG_CRQA : Channel ReQest Active flag.
+  *            @arg MDMA_FLAG_CRQA : Channel request Active flag.
   * @retval The state of FLAG (SET or RESET).
   */
 #define __HAL_MDMA_GET_FLAG(__HANDLE__, __FLAG__)  ((__HANDLE__)->Instance->CISR & (__FLAG__))
@@ -615,8 +597,8 @@ typedef struct __MDMA_HandleTypeDef
 
 /**
   * @brief  Checks whether the specified MDMA Channel interrupt is enabled or not.
-  * @param  __HANDLE__: DMA handle
-  * @param  __INTERRUPT__: specifies the DMA interrupt source to check.
+  * @param  __HANDLE__: MDMA handle
+  * @param  __INTERRUPT__: specifies the MDMA interrupt source to check.
   *            @arg MDMA_IT_TE   :  Transfer Error interrupt mask
   *            @arg MDMA_IT_CTC  :  Channel Transfer Complete interrupt mask
   *            @arg MDMA_IT_BRT  :  Block Repeat Transfer interrupt mask
@@ -627,18 +609,31 @@ typedef struct __MDMA_HandleTypeDef
 #define __HAL_MDMA_GET_IT_SOURCE(__HANDLE__, __INTERRUPT__)  (((__HANDLE__)->Instance->CCR & (__INTERRUPT__)))
 
 /**
+  * @brief  Writes the number of data in bytes to be transferred on the MDMA Channelx.
+  * @param  __HANDLE__ : MDMA handle
+  * @param  __COUNTER__: Number of data in bytes to be transferred.
+  * @retval None
+  */
+#define __HAL_MDMA_SET_COUNTER(__HANDLE__, __COUNTER__)  ((__HANDLE__)->Instance->CBNDTR |= ((__COUNTER__) & MDMA_CBNDTR_BNDT))
+
+/**
+  * @brief  Returns the number of remaining data in bytes in the current MDMA Channelx transfer.
+  * @param  __HANDLE__ : MDMA handle
+  * @retval The number of remaining data in bytes in the current MDMA Channelx transfer.
+  */
+#define __HAL_MDMA_GET_COUNTER(__HANDLE__) ((__HANDLE__)->Instance->CBNDTR & MDMA_CBNDTR_BNDT)
+
+/**
   * @}
   */
 
 /* Exported functions --------------------------------------------------------*/
 /** @defgroup MDMA_Exported_Functions  MDMA Exported Functions
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @{
   */
 
 /* Initialization and de-initialization functions *****************************/
 /** @defgroup MDMA_Exported_Functions_Group1 Initialization and de-initialization functions
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief   Initialization and de-initialization functions
   * @{
   */
@@ -655,7 +650,6 @@ HAL_StatusTypeDef HAL_MDMA_UnRegisterCallback(MDMA_HandleTypeDef *hmdma, HAL_MDM
 
 /* Linked list operation functions ********************************************/
 /** @defgroup MDMA_Exported_Functions_Group2 Linked List operation functions
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief   Linked list operation functions
   * @{
   */
@@ -673,7 +667,6 @@ HAL_StatusTypeDef HAL_MDMA_LinkedList_DisableCircularMode(MDMA_HandleTypeDef *hm
 
 /* IO operation functions *****************************************************/
 /** @defgroup MDMA_Exported_Functions_Group3 I/O operation functions
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief   I/O operation functions
   * @{
   */
@@ -691,7 +684,6 @@ void HAL_MDMA_IRQHandler(MDMA_HandleTypeDef *hmdma);
 
 /* Peripheral State and Error functions ***************************************/
 /** @defgroup MDMA_Exported_Functions_Group4 Peripheral State functions
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @brief    Peripheral State functions
   * @{
   */
@@ -708,7 +700,6 @@ uint32_t              HAL_MDMA_GetError(MDMA_HandleTypeDef *hmdma);
 
 /* Private types -------------------------------------------------------------*/
 /** @defgroup MDMA_Private_Types MDMA Private Types
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @{
   */
 
@@ -718,7 +709,6 @@ uint32_t              HAL_MDMA_GetError(MDMA_HandleTypeDef *hmdma);
 
 /* Private defines -----------------------------------------------------------*/
 /** @defgroup MDMA_Private_Defines MDMA Private Defines
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @{
   */
 
@@ -728,7 +718,6 @@ uint32_t              HAL_MDMA_GetError(MDMA_HandleTypeDef *hmdma);
 
 /* Private variables ---------------------------------------------------------*/
 /** @defgroup MDMA_Private_Variables MDMA Private Variables
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @{
   */
 
@@ -738,7 +727,6 @@ uint32_t              HAL_MDMA_GetError(MDMA_HandleTypeDef *hmdma);
 
 /* Private constants ---------------------------------------------------------*/
 /** @defgroup MDMA_Private_Constants MDMA Private Constants
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @{
   */
 
@@ -748,7 +736,6 @@ uint32_t              HAL_MDMA_GetError(MDMA_HandleTypeDef *hmdma);
 
 /* Private macros ------------------------------------------------------------*/
 /** @defgroup MDMA_Private_Macros MDMA Private Macros
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @{
   */
 
@@ -849,7 +836,6 @@ uint32_t              HAL_MDMA_GetError(MDMA_HandleTypeDef *hmdma);
 
 /* Private functions prototypes ----------------------------------------------*/
 /** @defgroup MDMA_Private_Functions_Prototypes MDMA Private Functions Prototypes
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @{
   */
 
@@ -859,7 +845,6 @@ uint32_t              HAL_MDMA_GetError(MDMA_HandleTypeDef *hmdma);
 
 /* Private functions ---------------------------------------------------------*/
 /** @defgroup MDMA_Private_Functions MDMA Private Functions
-  * @ingroup RTEMSBSPsARMSTM32H7
   * @{
   */
 
@@ -881,4 +866,3 @@ uint32_t              HAL_MDMA_GetError(MDMA_HandleTypeDef *hmdma);
 
 #endif /* STM32H7xx_HAL_MDMA_H */
 
-/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/