| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851 |
- /**
- ******************************************************************************
- * @file stm32wbxx_hal.c
- * @author MCD Application Team
- * @brief HAL module driver.
- * This is the common part of the HAL initialization
- ******************************************************************************
- * @attention
- *
- * Copyright (c) 2019 STMicroelectronics.
- * All rights reserved.
- *
- * 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.
- *
- ******************************************************************************
- @verbatim
- ==============================================================================
- ##### How to use this driver #####
- ==============================================================================
- [..]
- The common HAL driver contains a set of generic and common APIs that can be
- used by the PPP peripheral drivers and the user to start using the HAL.
- [..]
- The HAL contains two APIs' categories:
- (+) Common HAL APIs
- (+) Services HAL APIs
- @endverbatim
- ******************************************************************************
- */
- /* Includes ------------------------------------------------------------------*/
- #include "stm32wbxx_hal.h"
- /** @addtogroup STM32WBxx_HAL_Driver
- * @{
- */
- /** @addtogroup HAL
- * @brief HAL module driver
- * @{
- */
- #ifdef HAL_MODULE_ENABLED
- /* Private typedef -----------------------------------------------------------*/
- /* Private define ------------------------------------------------------------*/
- /** @defgroup HAL_Private_Constants HAL Private Constants
- * @{
- */
- /**
- * @brief STM32WBxx HAL Driver version number
- */
- #define __STM32WBxx_HAL_VERSION_MAIN (0x01U) /*!< [31:24] main version */
- #define __STM32WBxx_HAL_VERSION_SUB1 (0x0CU) /*!< [23:16] sub1 version */
- #define __STM32WBxx_HAL_VERSION_SUB2 (0x00U) /*!< [15:8] sub2 version */
- #define __STM32WBxx_HAL_VERSION_RC (0x00U) /*!< [7:0] release candidate */
- #define __STM32WBxx_HAL_VERSION ((__STM32WBxx_HAL_VERSION_MAIN << 24U)\
- |(__STM32WBxx_HAL_VERSION_SUB1 << 16U)\
- |(__STM32WBxx_HAL_VERSION_SUB2 << 8U )\
- |(__STM32WBxx_HAL_VERSION_RC))
- #if defined(VREFBUF)
- #define VREFBUF_TIMEOUT_VALUE 10U /* 10 ms */
- #endif /* VREFBUF */
- /**
- * @}
- */
- /* Private macro -------------------------------------------------------------*/
- /* Exported variables ---------------------------------------------------------*/
- /** @defgroup HAL_Exported_Variables HAL Exported Variables
- * @{
- */
- __IO uint32_t uwTick;
- uint32_t uwTickPrio = (1UL << __NVIC_PRIO_BITS); /* Invalid PRIO */
- HAL_TickFreqTypeDef uwTickFreq = HAL_TICK_FREQ_DEFAULT; /* 1KHz */
- /**
- * @}
- */
- /* Private function prototypes -----------------------------------------------*/
- /* Exported functions --------------------------------------------------------*/
- /** @addtogroup HAL_Exported_Functions
- * @{
- */
- /** @addtogroup HAL_Exported_Functions_Group1
- * @brief HAL Initialization and Configuration functions
- *
- @verbatim
- ===============================================================================
- ##### HAL Initialization and Configuration functions #####
- ===============================================================================
- [..] This section provides functions allowing to:
- (+) Initialize the Flash interface the NVIC allocation and initial time base
- clock configuration.
- (+) De-initialize common part of the HAL.
- (+) Configure the time base source to have 1ms time base with a dedicated
- Tick interrupt priority.
- (++) SysTick timer is used by default as source of time base, but user
- can eventually implement his proper time base source (a general purpose
- timer for example or other time source), keeping in mind that Time base
- duration should be kept 1ms since PPP_TIMEOUT_VALUEs are defined and
- handled in milliseconds basis.
- (++) Time base configuration function (HAL_InitTick ()) is called automatically
- at the beginning of the program after reset by HAL_Init() or at any time
- when clock is configured, by HAL_RCC_ClockConfig().
- (++) Source of time base is configured to generate interrupts at regular
- time intervals. Care must be taken if HAL_Delay() is called from a
- peripheral ISR process, the Tick interrupt line must have higher priority
- (numerically lower) than the peripheral interrupt. Otherwise the caller
- ISR process will be blocked.
- (++) functions affecting time base configurations are declared as __weak
- to make override possible in case of other implementations in user file.
- @endverbatim
- * @{
- */
- /**
- * @brief This function is used to initialize the HAL Library; it must be the first
- * instruction to be executed in the main program (before to call any other
- * HAL function), it performs the following:
- * Configure the Flash prefetch, instruction and Data caches.
- * Configures the SysTick to generate an interrupt each 1 millisecond,
- * which is clocked by the MSI (at this stage, the clock is not yet
- * configured and thus the system is running from the internal MSI at 4 MHz).
- * Set NVIC Group Priority to 4.
- * Calls the HAL_MspInit() callback function defined in user file
- * "stm32wbxx_hal_msp.c" to do the global low level hardware initialization
- *
- * @note SysTick is used as time base for the HAL_Delay() function, the application
- * need to ensure that the SysTick time base is always set to 1 millisecond
- * to have correct HAL operation.
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_Init(void)
- {
- HAL_StatusTypeDef status = HAL_OK;
- /* Configure Flash prefetch, Instruction cache, Data cache */
- /* Default configuration at reset is: */
- /* - Prefetch disabled */
- /* - Instruction cache enabled */
- /* - Data cache enabled */
- #if (INSTRUCTION_CACHE_ENABLE == 0U)
- __HAL_FLASH_INSTRUCTION_CACHE_DISABLE();
- #endif /* INSTRUCTION_CACHE_ENABLE */
- #if (DATA_CACHE_ENABLE == 0U)
- __HAL_FLASH_DATA_CACHE_DISABLE();
- #endif /* DATA_CACHE_ENABLE */
- #if (PREFETCH_ENABLE != 0U)
- __HAL_FLASH_PREFETCH_BUFFER_ENABLE();
- #endif /* PREFETCH_ENABLE */
- /* Set Interrupt Group Priority */
- HAL_NVIC_SetPriorityGrouping(NVIC_PRIORITYGROUP_4);
- /* Use SysTick as time base source and configure 1ms tick (default clock after Reset is MSI) */
- if (HAL_InitTick(TICK_INT_PRIORITY) != HAL_OK)
- {
- status = HAL_ERROR;
- }
- else
- {
- /* Init the low level hardware */
- HAL_MspInit();
- }
- /* Return function status */
- return status;
- }
- /**
- * @brief This function de-Initializes common part of the HAL and stops the source of time base.
- * @note This function is optional.
- * @retval HAL status
- */
- HAL_StatusTypeDef HAL_DeInit(void)
- {
- /* Reset of all peripherals */
- __HAL_RCC_APB1_FORCE_RESET();
- __HAL_RCC_APB1_RELEASE_RESET();
- __HAL_RCC_APB2_FORCE_RESET();
- __HAL_RCC_APB2_RELEASE_RESET();
- __HAL_RCC_APB3_FORCE_RESET();
- __HAL_RCC_APB3_RELEASE_RESET();
- __HAL_RCC_AHB1_FORCE_RESET();
- __HAL_RCC_AHB1_RELEASE_RESET();
- __HAL_RCC_AHB2_FORCE_RESET();
- __HAL_RCC_AHB2_RELEASE_RESET();
- __HAL_RCC_AHB3_FORCE_RESET();
- __HAL_RCC_AHB3_RELEASE_RESET();
- /* De-Init the low level hardware */
- HAL_MspDeInit();
- /* Return function status */
- return HAL_OK;
- }
- /**
- * @brief Initialize the MSP.
- * @retval None
- */
- __weak void HAL_MspInit(void)
- {
- /* NOTE : This function should not be modified, when the callback is needed,
- the HAL_MspInit could be implemented in the user file
- */
- }
- /**
- * @brief DeInitializes the MSP.
- * @retval None
- */
- __weak void HAL_MspDeInit(void)
- {
- /* NOTE : This function should not be modified, when the callback is needed,
- the HAL_MspDeInit could be implemented in the user file
- */
- }
- /**
- * @brief This function configures the source of the time base:
- * The time source is configured to have 1ms time base with a dedicated
- * Tick interrupt priority.
- * @note This function is called automatically at the beginning of program after
- * reset by HAL_Init() or at any time when clock is reconfigured by HAL_RCC_ClockConfig().
- * @note In the default implementation, SysTick timer is the source of time base.
- * It is used to generate interrupts at regular time intervals.
- * Care must be taken if HAL_Delay() is called from a peripheral ISR process,
- * The SysTick interrupt must have higher priority (numerically lower)
- * than the peripheral interrupt. Otherwise the caller ISR process will be blocked.
- * The function is declared as __weak to be overwritten in case of other
- * implementation in user file.
- * @param TickPriority Tick interrupt priority.
- * @retval HAL status
- */
- __weak HAL_StatusTypeDef HAL_InitTick(uint32_t TickPriority)
- {
- HAL_StatusTypeDef status = HAL_OK;
- if ((uint32_t)uwTickFreq != 0U)
- {
- /*Configure the SysTick to have interrupt in 1ms time basis*/
- if (HAL_SYSTICK_Config(HAL_RCC_GetHCLKFreq() / (1000U / (uint32_t)uwTickFreq)) == 0U)
- {
- /* Configure the SysTick IRQ priority */
- if (TickPriority < (1UL << __NVIC_PRIO_BITS))
- {
- HAL_NVIC_SetPriority(SysTick_IRQn, TickPriority, 0U);
- uwTickPrio = TickPriority;
- }
- else
- {
- status = HAL_ERROR;
- }
- }
- else
- {
- status = HAL_ERROR;
- }
- }
- else
- {
- status = HAL_ERROR;
- }
- /* Return function status */
- return status;
- }
- /**
- * @}
- */
- /** @addtogroup HAL_Exported_Functions_Group2
- * @brief HAL Control functions
- *
- @verbatim
- ===============================================================================
- ##### HAL Control functions #####
- ===============================================================================
- [..] This section provides functions allowing to:
- (+) Provide a tick value in millisecond
- (+) Provide a blocking delay in millisecond
- (+) Suspend the time base source interrupt
- (+) Resume the time base source interrupt
- (+) Get the HAL API driver version
- (+) Get the device revision identifier
- (+) Get the device identifier
- (+) Get the unique device identifier
- @endverbatim
- * @{
- */
- /**
- * @brief This function is called to increment a global variable "uwTick"
- * used as application time base.
- * @note In the default implementation, this variable is incremented each 1ms
- * in SysTick ISR.
- * @note This function is declared as __weak to be overwritten in case of other
- * implementations in user file.
- * @retval None
- */
- __weak void HAL_IncTick(void)
- {
- uwTick += (uint32_t)uwTickFreq;
- }
- /**
- * @brief Provides a tick value in millisecond.
- * @note This function is declared as __weak to be overwritten in case of other
- * implementations in user file.
- * @retval tick value
- */
- __weak uint32_t HAL_GetTick(void)
- {
- return uwTick;
- }
- /**
- * @brief This function returns a tick priority.
- * @retval tick priority
- */
- uint32_t HAL_GetTickPrio(void)
- {
- return uwTickPrio;
- }
- /**
- * @brief Set new tick Freq.
- * @retval Status
- */
- HAL_StatusTypeDef HAL_SetTickFreq(HAL_TickFreqTypeDef Freq)
- {
- HAL_StatusTypeDef status = HAL_OK;
- HAL_TickFreqTypeDef prevTickFreq;
- assert_param(IS_TICKFREQ(Freq));
- if (uwTickFreq != Freq)
- {
- /* Back up uwTickFreq frequency */
- prevTickFreq = uwTickFreq;
- /* Update uwTickFreq global variable used by HAL_InitTick() */
- uwTickFreq = Freq;
- /* Apply the new tick Freq */
- status = HAL_InitTick(uwTickPrio);
- if (status != HAL_OK)
- {
- /* Restore previous tick frequency */
- uwTickFreq = prevTickFreq;
- }
- }
- return status;
- }
- /**
- * @brief Return tick frequency.
- * @retval tick period in Hz
- */
- HAL_TickFreqTypeDef HAL_GetTickFreq(void)
- {
- return uwTickFreq;
- }
- /**
- * @brief This function provides minimum delay (in milliseconds) based
- * on variable incremented.
- * @note In the default implementation , SysTick timer is the source of time base.
- * It is used to generate interrupts at regular time intervals where uwTick
- * is incremented.
- * @note This function is declared as __weak to be overwritten in case of other
- * implementations in user file.
- * @param Delay specifies the delay time length, in milliseconds.
- * @retval None
- */
- __weak void HAL_Delay(uint32_t Delay)
- {
- uint32_t tickstart = HAL_GetTick();
- uint32_t wait = Delay;
- /* Add a freq to guarantee minimum wait */
- if (wait < HAL_MAX_DELAY)
- {
- wait += (uint32_t)(uwTickFreq);
- }
- while ((HAL_GetTick() - tickstart) < wait)
- {
- }
- }
- /**
- * @brief Suspend Tick increment.
- * @note In the default implementation , SysTick timer is the source of time base. It is
- * used to generate interrupts at regular time intervals. Once HAL_SuspendTick()
- * is called, the SysTick interrupt will be disabled and so Tick increment
- * is suspended.
- * @note This function is declared as __weak to be overwritten in case of other
- * implementations in user file.
- * @retval None
- */
- __weak void HAL_SuspendTick(void)
- {
- /* Disable SysTick Interrupt */
- CLEAR_BIT(SysTick->CTRL, SysTick_CTRL_TICKINT_Msk);
- }
- /**
- * @brief Resume Tick increment.
- * @note In the default implementation , SysTick timer is the source of time base. It is
- * used to generate interrupts at regular time intervals. Once HAL_ResumeTick()
- * is called, the SysTick interrupt will be enabled and so Tick increment
- * is resumed.
- * @note This function is declared as __weak to be overwritten in case of other
- * implementations in user file.
- * @retval None
- */
- __weak void HAL_ResumeTick(void)
- {
- /* Enable SysTick Interrupt */
- SET_BIT(SysTick->CTRL, SysTick_CTRL_TICKINT_Msk);
- }
- /**
- * @brief Returns the HAL revision
- * @retval version : 0xXYZR (8bits for each decimal, R for RC)
- */
- uint32_t HAL_GetHalVersion(void)
- {
- return __STM32WBxx_HAL_VERSION;
- }
- /**
- * @brief Returns the device revision identifier.
- * @retval Device revision identifier
- */
- uint32_t HAL_GetREVID(void)
- {
- return (LL_DBGMCU_GetRevisionID());
- }
- /**
- * @brief Returns the device identifier.
- * @retval Device identifier
- */
- uint32_t HAL_GetDEVID(void)
- {
- return (LL_DBGMCU_GetDeviceID());
- }
- /**
- * @brief Return the first word of the unique device identifier (UID based on 96 bits)
- * @retval Device identifier
- */
- uint32_t HAL_GetUIDw0(void)
- {
- return (READ_REG(*((uint32_t *)UID_BASE)));
- }
- /**
- * @brief Return the second word of the unique device identifier (UID based on 96 bits)
- * @retval Device identifier
- */
- uint32_t HAL_GetUIDw1(void)
- {
- return (READ_REG(*((uint32_t *)(UID_BASE + 4U))));
- }
- /**
- * @brief Return the third word of the unique device identifier (UID based on 96 bits)
- * @retval Device identifier
- */
- uint32_t HAL_GetUIDw2(void)
- {
- return (READ_REG(*((uint32_t *)(UID_BASE + 8U))));
- }
- /**
- * @}
- */
- /** @addtogroup HAL_Exported_Functions_Group3
- * @brief HAL Debug functions
- *
- @verbatim
- ===============================================================================
- ##### HAL Debug functions #####
- ===============================================================================
- [..] This section provides functions allowing to:
- (+) Enable/Disable Debug module during SLEEP mode
- (+) Enable/Disable Debug module during STOP mode
- (+) Enable/Disable Debug module during STANDBY mode
- @endverbatim
- * @{
- */
- /**
- * @brief Enable the Debug Module during SLEEP mode
- * @retval None
- */
- void HAL_DBGMCU_EnableDBGSleepMode(void)
- {
- LL_DBGMCU_EnableDBGSleepMode();
- }
- /**
- * @brief Disable the Debug Module during SLEEP mode
- * @retval None
- */
- void HAL_DBGMCU_DisableDBGSleepMode(void)
- {
- LL_DBGMCU_DisableDBGSleepMode();
- }
- /**
- * @brief Enable the Debug Module during STOP mode
- * @retval None
- */
- void HAL_DBGMCU_EnableDBGStopMode(void)
- {
- LL_DBGMCU_EnableDBGStopMode();
- }
- /**
- * @brief Disable the Debug Module during STOP mode
- * @retval None
- */
- void HAL_DBGMCU_DisableDBGStopMode(void)
- {
- LL_DBGMCU_DisableDBGStopMode();
- }
- /**
- * @brief Enable the Debug Module during STANDBY mode
- * @retval None
- */
- void HAL_DBGMCU_EnableDBGStandbyMode(void)
- {
- LL_DBGMCU_EnableDBGStandbyMode();
- }
- /**
- * @brief Disable the Debug Module during STANDBY mode
- * @retval None
- */
- void HAL_DBGMCU_DisableDBGStandbyMode(void)
- {
- LL_DBGMCU_DisableDBGStandbyMode();
- }
- /**
- * @}
- */
- /** @defgroup HAL_Exported_Functions_Group4 HAL System Configuration functions
- * @brief HAL System Configuration functions
- *
- @verbatim
- ===============================================================================
- ##### HAL system configuration functions #####
- ===============================================================================
- [..] This section provides functions allowing to:
- (+) Start a hardware SRAM2 erase operation
- (+) Disable CPU2 SRAM fetch (execution)
- (+) Configure the Voltage reference buffer
- (+) Enable/Disable the Voltage reference buffer
- (+) Enable/Disable the I/O analog switch voltage booster
- (+) Enable/Disable the access for security IP (AES1, AES2, PKA, RNG)
- (+) Enable/Disable the access for security IP (AES2, PKA, RNG)
- @endverbatim
- * @{
- */
- /**
- * @brief Start a hardware SRAM2 erase operation.
- * @note As long as SRAM2 is not erased the SRAM2ER bit will be set.
- * This bit is automatically reset at the end of the SRAM2 erase operation.
- * @retval None
- */
- void HAL_SYSCFG_SRAM2Erase(void)
- {
- /* unlock the write protection of the SRAM2ER bit */
- __HAL_SYSCFG_SRAM2_WRP_UNLOCK();
- /* Starts a hardware SRAM2 erase operation*/
- __HAL_SYSCFG_SRAM2_ERASE();
- }
- /**
- * @brief Disable CPU2 SRAM fetch (execution) (This bit can be set by Firmware
- * and will only be reset by a Hardware reset, including a reset after Standby.)
- * @note Firmware writing 0 has no effect.
- * @retval None
- */
- void HAL_SYSCFG_DisableSRAMFetch(void)
- {
- LL_SYSCFG_DisableSRAMFetch();
- }
- /**
- * @brief Check if CPU2 SRAM fetch is enabled
- * @retval State of bit (1 or 0).
- */
- uint32_t HAL_SYSCFG_IsEnabledSRAMFetch(void)
- {
- return (LL_SYSCFG_IsEnabledSRAMFetch());
- }
- #if defined(VREFBUF)
- /**
- * @brief Configure the internal voltage reference buffer voltage scale.
- * @param VoltageScaling specifies the output voltage to achieve
- * This parameter can be one of the following values:
- * @arg @ref SYSCFG_VREFBUF_VOLTAGE_SCALE0 : VREF_OUT1 around 2.048 V.
- * This requires VDDA equal to or higher than 2.4 V.
- * @arg @ref SYSCFG_VREFBUF_VOLTAGE_SCALE1 : VREF_OUT1 around 2.5 V.
- * This requires VDDA equal to or higher than 2.8 V.
- * @note Retrieve the TrimmingValue from factory located at
- * VREFBUF_SC0_CAL_ADDR or VREFBUF_SC1_CAL_ADDR addresses.
- * @retval None
- */
- void HAL_SYSCFG_VREFBUF_VoltageScalingConfig(uint32_t VoltageScaling)
- {
- uint32_t TrimmingValue;
- /* Check the parameters */
- assert_param(IS_SYSCFG_VREFBUF_VOLTAGE_SCALE(VoltageScaling));
- LL_VREFBUF_SetVoltageScaling(VoltageScaling);
- /* Restrieve Calibration data and store them into trimming field */
- if (VoltageScaling == SYSCFG_VREFBUF_VOLTAGE_SCALE0)
- {
- TrimmingValue = ((uint32_t) * VREFBUF_SC0_CAL_ADDR) & 0x3FU;
- }
- else
- {
- TrimmingValue = ((uint32_t) * VREFBUF_SC1_CAL_ADDR) & 0x3FU;
- }
- assert_param(IS_SYSCFG_VREFBUF_TRIMMING(TrimmingValue));
- HAL_SYSCFG_VREFBUF_TrimmingConfig(TrimmingValue);
- }
- /**
- * @brief Configure the internal voltage reference buffer high impedance mode.
- * @param Mode specifies the high impedance mode
- * This parameter can be one of the following values:
- * @arg @ref SYSCFG_VREFBUF_HIGH_IMPEDANCE_DISABLE : VREF+ pin is internally connect to VREFINT output.
- * @arg @ref SYSCFG_VREFBUF_HIGH_IMPEDANCE_ENABLE : VREF+ pin is high impedance.
- * @retval HAL_OK/HAL_TIMEOUT
- */
- void HAL_SYSCFG_VREFBUF_HighImpedanceConfig(uint32_t Mode)
- {
- /* Check the parameters */
- assert_param(IS_SYSCFG_VREFBUF_HIGH_IMPEDANCE(Mode));
- MODIFY_REG(VREFBUF->CSR, VREFBUF_CSR_HIZ, Mode);
- }
- /**
- * @brief Tune the Internal Voltage Reference buffer (VREFBUF).
- * @note Each VrefBuf voltage scale is calibrated in production for each device,
- * data stored in flash memory.
- * Function @ref HAL_SYSCFG_VREFBUF_VoltageScalingConfig retrieves and
- * applies this calibration data as trimming value at each scale change.
- * Therefore, optionally, function @ref HAL_SYSCFG_VREFBUF_TrimmingConfig
- * can be used in a second time to fine tune the trimming.
- * @param TrimmingValue specifies trimming code for VREFBUF calibration
- * This parameter can be a number between Min_Data = 0x00 and Max_Data = 0x3F
- * @retval None
- */
- void HAL_SYSCFG_VREFBUF_TrimmingConfig(uint32_t TrimmingValue)
- {
- /* Check the parameters */
- assert_param(IS_SYSCFG_VREFBUF_TRIMMING(TrimmingValue));
- LL_VREFBUF_SetTrimming(TrimmingValue);
- }
- /**
- * @brief Enable the Internal Voltage Reference buffer (VREFBUF).
- * @retval HAL_OK/HAL_TIMEOUT
- */
- HAL_StatusTypeDef HAL_SYSCFG_EnableVREFBUF(void)
- {
- uint32_t tickstart;
- LL_VREFBUF_Enable();
- /* Get Start Tick*/
- tickstart = HAL_GetTick();
- /* Wait for VRR bit */
- while (READ_BIT(VREFBUF->CSR, VREFBUF_CSR_VRR) == 0U)
- {
- if ((HAL_GetTick() - tickstart) > VREFBUF_TIMEOUT_VALUE)
- {
- return HAL_TIMEOUT;
- }
- }
- return HAL_OK;
- }
- /**
- * @brief Disable the Internal Voltage Reference buffer (VREFBUF).
- *
- * @retval None
- */
- void HAL_SYSCFG_DisableVREFBUF(void)
- {
- LL_VREFBUF_Disable();
- }
- #endif /* VREFBUF */
- /**
- * @brief Enable the I/O analog switch voltage booster
- *
- * @retval None
- */
- void HAL_SYSCFG_EnableIOBooster(void)
- {
- LL_SYSCFG_EnableAnalogBooster();
- }
- /**
- * @brief Disable the I/O analog switch voltage booster
- *
- * @retval None
- */
- void HAL_SYSCFG_DisableIOBooster(void)
- {
- LL_SYSCFG_DisableAnalogBooster();
- }
- #if defined(SYSCFG_CFGR1_ANASWVDD)
- /**
- * @brief Enable the I/O analog switch supplied by VDD
- * @note To be used when I/O analog switch voltage booster is not enabled
- * @retval None
- */
- void HAL_SYSCFG_EnableIOVdd(void)
- {
- LL_SYSCFG_EnableAnalogGpioSwitch();
- }
- /**
- * @brief Disable the I/O analog switch supplied by VDD
- *
- * @retval None
- */
- void HAL_SYSCFG_DisableIOVdd(void)
- {
- LL_SYSCFG_DisableAnalogGpioSwitch();
- }
- #endif /* SYSCFG_CFGR1_ANASWVDD */
- /**
- * @brief Enable the access for security IP
- * @note When the system is secure (ESE = 1), this register provides write access security and can
- * only be written by the CPU2. A write access from the CPU1 will be ignored and a bus error
- * is generated.
- * @param SecurityAccess This parameter can be a combination of the following values:
- * @arg @ref HAL_SYSCFG_SECURE_ACCESS_AES1
- * @arg @ref HAL_SYSCFG_SECURE_ACCESS_AES2
- * @arg @ref HAL_SYSCFG_SECURE_ACCESS_PKA
- * @arg @ref HAL_SYSCFG_SECURE_ACCESS_RNG
- * @retval None
- */
- void HAL_SYSCFG_EnableSecurityAccess(uint32_t SecurityAccess)
- {
- /* Check the parameters */
- assert_param(IS_SYSCFG_SECURITY_ACCESS(SecurityAccess));
- LL_SYSCFG_EnableSecurityAccess(SecurityAccess);
- }
- /**
- * @brief Disable the access for security IP
- * @note When the system is secure (ESE = 1), this register provides write access security and can
- * only be written by the CPU2. A write access from the CPU1 will be ignored and a bus error
- * is generated.
- * @param SecurityAccess This parameter can be a combination of the following values:
- * @arg @ref HAL_SYSCFG_SECURE_ACCESS_AES1
- * @arg @ref HAL_SYSCFG_SECURE_ACCESS_AES2
- * @arg @ref HAL_SYSCFG_SECURE_ACCESS_PKA
- * @arg @ref HAL_SYSCFG_SECURE_ACCESS_RNG
- * @retval None
- */
- void HAL_SYSCFG_DisableSecurityAccess(uint32_t SecurityAccess)
- {
- /* Check the parameters */
- assert_param(IS_SYSCFG_SECURITY_ACCESS(SecurityAccess));
- LL_SYSCFG_DisableSecurityAccess(SecurityAccess);
- }
- /**
- * @brief Indicate if access for security IP is enabled
- * @param SecurityAccess This parameter can be one of the following values:
- * @arg @ref HAL_SYSCFG_SECURE_ACCESS_AES1
- * @arg @ref HAL_SYSCFG_SECURE_ACCESS_AES2
- * @arg @ref HAL_SYSCFG_SECURE_ACCESS_PKA
- * @arg @ref HAL_SYSCFG_SECURE_ACCESS_RNG
- * @retval State of bit (1 or 0).
- */
- uint32_t HAL_SYSCFG_IsEnabledSecurityAccess(uint32_t SecurityAccess)
- {
- return (LL_SYSCFG_IsEnabledSecurityAccess(SecurityAccess));
- }
- /**
- * @}
- */
- /**
- * @}
- */
- #endif /* HAL_MODULE_ENABLED */
- /**
- * @}
- */
- /**
- * @}
- */
|