lib/main/STM32H7/Drivers/STM32H7xx_HAL_Driver/Src/stm32h7xx_ll_fmac.c

   1 /**
   2   ******************************************************************************
   3   * @file    stm32h7xx_ll_fmac.c
   4   * @author  MCD Application Team
   5   * @brief   FMAC LL module driver.
   6   ******************************************************************************
   7   * @attention
   8   *
   9   * <h2><center>&copy; Copyright (c) 2017 STMicroelectronics.
  10   * All rights reserved.</center></h2>
  11   *
  12   * This software component is licensed by ST under BSD 3-Clause license,
  13   * the "License"; You may not use this file except in compliance with the
  14   * License. You may obtain a copy of the License at:
  15   *                        opensource.org/licenses/BSD-3-Clause
  16   *
  17   ******************************************************************************
  18   */
  19 #if defined(USE_FULL_LL_DRIVER)
  20
  21 /* Includes ------------------------------------------------------------------*/
  22 #include "stm32h7xx_ll_fmac.h"
  23 #include "stm32h7xx_ll_bus.h"
  24
  25 /** @addtogroup STM32H7xx_LL_Driver
  26   * @{
  27   */
  28
  29 #if defined(FMAC)
  30
  31 /** @addtogroup FMAC_LL
  32   * @{
  33   */
  34
  35 /* Private types -------------------------------------------------------------*/
  36 /* Private variables ---------------------------------------------------------*/
  37 /* Private constants ---------------------------------------------------------*/
  38 /* Private macros ------------------------------------------------------------*/
  39 /** @addtogroup FMAC_LL_Private_Macros
  40   * @{
  41   */
  42
  43 /** @brief  Check if the watermark value is a valid one.
  44   * @param  __VALUE__ Watermak value.
  45   * @retval SET (__VALUE__ is a valid value) or RESET (__VALUE__ is invalid)
  46   */
  47 #define IS_LL_FMAC_WM(__VALUE__) (((__VALUE__) == LL_FMAC_WM_0_THRESHOLD_1) \
  48                                   || ((__VALUE__) == LL_FMAC_WM_1_THRESHOLD_2) \
  49                                   || ((__VALUE__) == LL_FMAC_WM_2_THRESHOLD_4) \
  50                                   || ((__VALUE__) == LL_FMAC_WM_3_THRESHOLD_8))
  51
  52 /** @brief  Check if the function ID is a valid one.
  53   * @param  __VALUE__ Function ID.
  54   * @retval SET (__VALUE__ is a valid value) or RESET (__VALUE__ is invalid)
  55   */
  56 #define IS_LL_FMAC_FUNC(__VALUE__) (((__VALUE__) == LL_FMAC_FUNC_LOAD_X1) \
  57                                     || ((__VALUE__) == LL_FMAC_FUNC_LOAD_X2) \
  58                                     || ((__VALUE__) == LL_FMAC_FUNC_LOAD_Y) \
  59                                     || ((__VALUE__) == LL_FMAC_FUNC_CONVO_FIR) \
  60                                     || ((__VALUE__) == LL_FMAC_FUNC_IIR_DIRECT_FORM_1))
  61
  62
  63 /**
  64   * @}
  65   */
  66
  67 /* Private function prototypes -----------------------------------------------*/
  68
  69 /* Exported functions --------------------------------------------------------*/
  70 /** @addtogroup FMAC_LL_Exported_Functions
  71   * @{
  72   */
  73
  74 /** @addtogroup FMAC_LL_EF_Init
  75   * @{
  76   */
  77
  78 /**
  79   * @brief  Initialize FMAC peripheral registers to their default reset values.
  80   * @param  FMACx FMAC Instance
  81   * @retval An ErrorStatus enumeration value:
  82   *          - SUCCESS: FMAC registers are initialized
  83   *          - ERROR: FMAC registers are not initialized
  84   */
  85 ErrorStatus LL_FMAC_Init(FMAC_TypeDef *FMACx)
  86 {
  87   ErrorStatus status = SUCCESS;
  88
  89   /* Check the parameters */
  90   assert_param(IS_FMAC_ALL_INSTANCE(FMACx));
  91
  92   if (FMACx == FMAC)
  93   {
  94     /* Perform the reset */
  95     LL_FMAC_EnableReset(FMACx);
  96
  97     /* Wait until flag is reset */
  98     while (LL_FMAC_IsEnabledReset(FMACx) != 0UL)
  99     {
 100     }
 101   }
 102   else
 103   {
 104     status = ERROR;
 105   }
 106
 107   return (status);
 108 }
 109
 110 /**
 111   * @brief  De-Initialize FMAC peripheral registers to their default reset values.
 112   * @param  FMACx FMAC Instance
 113   * @retval An ErrorStatus enumeration value:
 114   *          - SUCCESS: FMAC registers are de-initialized
 115   *          - ERROR: FMAC registers are not de-initialized
 116   */
 117 ErrorStatus LL_FMAC_DeInit(FMAC_TypeDef *FMACx)
 118 {
 119   ErrorStatus status = SUCCESS;
 120
 121   /* Check the parameters */
 122   assert_param(IS_FMAC_ALL_INSTANCE(FMACx));
 123
 124   if (FMACx == FMAC)
 125   {
 126     /* Force FMAC reset */
 127     LL_AHB2_GRP1_ForceReset(LL_AHB2_GRP1_PERIPH_FMAC);
 128
 129     /* Release FMAC reset */
 130     LL_AHB2_GRP1_ReleaseReset(LL_AHB2_GRP1_PERIPH_FMAC);
 131   }
 132   else
 133   {
 134     status = ERROR;
 135   }
 136
 137   return (status);
 138 }
 139
 140
 141
 142 /**
 143   * @}
 144   */
 145
 146 /**
 147   * @}
 148   */
 149
 150 /**
 151   * @}
 152   */
 153
 154 #endif /* defined(FMAC) */
 155
 156 /**
 157   * @}
 158   */
 159
 160 #endif /* USE_FULL_LL_DRIVER */
 161
 162 /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/