lib: Update stm32f1 code to version 1.8.0

Update the stm32f1 code to the latest from ST.  Merge the
lib/cmsis-stm32f1/ and lib/hal-stm32f1/ into a single lib/stm32f1/
directory.  Document all the differences from the pristine upstream
code.

Signed-off-by: Kevin O'Connor <kevin@koconnor.net>

1 files changed, 0 insertions, 593 deletions

diff --git a/lib/hal-stm32f1/source/stm32f1xx_hal_rtc_ex.c b/lib/hal-stm32f1/source/stm32f1xx_hal_rtc_ex.c
deleted file mode 100644
index 541f71d1..00000000
--- a/lib/hal-stm32f1/source/stm32f1xx_hal_rtc_ex.c
+++ /dev/null
@@ -1,593 +0,0 @@
-/**

-  ******************************************************************************

-  * @file    stm32f1xx_hal_rtc_ex.c

-  * @author  MCD Application Team

-  * @version V1.1.1

-  * @date    12-May-2017

-  * @brief   Extended RTC HAL module driver.

-  *          This file provides firmware functions to manage the following 

-  *          functionalities of the Real Time Clock (RTC) Extension peripheral:

-  *           + RTC Tamper functions 

-  *           + Extension Control functions

-  *           + Extension RTC features functions    

-  *         

-  ******************************************************************************

-  * @attention

-  *

-  * <h2><center>&copy; COPYRIGHT(c) 2016 STMicroelectronics</center></h2>

-  *

-  * Redistribution and use in source and binary forms, with or without modification,

-  * are permitted provided that the following conditions are met:

-  *   1. Redistributions of source code must retain the above copyright notice,

-  *      this list of conditions and the following disclaimer.

-  *   2. Redistributions in binary form must reproduce the above copyright notice,

-  *      this list of conditions and the following disclaimer in the documentation

-  *      and/or other materials provided with the distribution.

-  *   3. Neither the name of STMicroelectronics nor the names of its contributors

-  *      may be used to endorse or promote products derived from this software

-  *      without specific prior written permission.

-  *

-  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"

-  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

-  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

-  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE

-  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

-  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR

-  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER

-  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,

-  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE

-  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

-  *

-  ******************************************************************************  

-  */ 

-

-/* Includes ------------------------------------------------------------------*/

-#include "stm32f1xx_hal.h"

-

-/** @addtogroup STM32F1xx_HAL_Driver

-  * @{

-  */

-  

-#ifdef HAL_RTC_MODULE_ENABLED

-

-/** @defgroup RTCEx RTCEx

-  * @brief RTC Extended HAL module driver

-  * @{

-  */

-  

-/* Private typedef -----------------------------------------------------------*/

-/* Private define ------------------------------------------------------------*/

-/* Private macro -------------------------------------------------------------*/

-/** @defgroup RTCEx_Private_Macros RTCEx Private Macros

-  * @{

-  */

-/**

-  * @}

-  */

-  

-/* Private variables ---------------------------------------------------------*/

-/* Private function prototypes -----------------------------------------------*/

-/* Private functions ---------------------------------------------------------*/

-

-/** @defgroup RTCEx_Exported_Functions RTCEx Exported Functions

-  * @{

-  */

-  

-/** @defgroup RTCEx_Exported_Functions_Group1 RTC Tamper functions

-  * @brief    RTC Tamper functions

-  *

-@verbatim   

- ===============================================================================

-                 ##### RTC Tamper functions #####

- ===============================================================================  

- 

- [..] This section provides functions allowing to configure Tamper feature

-

-@endverbatim

-  * @{

-  */

-

-/**

-  * @brief  Sets Tamper

-  * @note   By calling this API we disable the tamper interrupt for all tampers. 

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC.

-  * @param  sTamper: Pointer to Tamper Structure.

-  * @note   Tamper can be enabled only if ASOE and CCO bit are reset

-  * @retval HAL status

-  */

-HAL_StatusTypeDef HAL_RTCEx_SetTamper(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef* sTamper)

-{

-  /* Check input parameters */

-  if((hrtc == NULL) || (sTamper == NULL))

-  {

-     return HAL_ERROR;

-  }

-  

-  /* Check the parameters */

-  assert_param(IS_RTC_TAMPER(sTamper->Tamper));

-  assert_param(IS_RTC_TAMPER_TRIGGER(sTamper->Trigger));

-

-  /* Process Locked */

-  __HAL_LOCK(hrtc);

-

-  hrtc->State = HAL_RTC_STATE_BUSY;

-  

-  if (HAL_IS_BIT_SET(BKP->RTCCR,(BKP_RTCCR_CCO | BKP_RTCCR_ASOE)))

-  {

-    hrtc->State = HAL_RTC_STATE_ERROR;

-    

-    /* Process Unlocked */

-    __HAL_UNLOCK(hrtc);

-    

-    return HAL_ERROR;

-  }

-

-  MODIFY_REG(BKP->CR, (BKP_CR_TPE | BKP_CR_TPAL), (sTamper->Tamper | (sTamper->Trigger)));

-

-  hrtc->State = HAL_RTC_STATE_READY; 

-

-  /* Process Unlocked */

-  __HAL_UNLOCK(hrtc);

-

-  return HAL_OK;

-}

-

-/**

-  * @brief  Sets Tamper with interrupt.

-  * @note   By calling this API we force the tamper interrupt for all tampers.

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC.

-  * @param  sTamper: Pointer to RTC Tamper.

-  * @note   Tamper can be enabled only if ASOE and CCO bit are reset

-  * @retval HAL status

-  */

-HAL_StatusTypeDef HAL_RTCEx_SetTamper_IT(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef* sTamper)

-{

-  /* Check input parameters */

-  if((hrtc == NULL) || (sTamper == NULL))

-  {

-     return HAL_ERROR;

-  }

-  

-  /* Check the parameters */

-  assert_param(IS_RTC_TAMPER(sTamper->Tamper)); 

-  assert_param(IS_RTC_TAMPER_TRIGGER(sTamper->Trigger));

-

-  /* Process Locked */

-  __HAL_LOCK(hrtc);

-

-  hrtc->State = HAL_RTC_STATE_BUSY;

-

-  if (HAL_IS_BIT_SET(BKP->RTCCR,(BKP_RTCCR_CCO | BKP_RTCCR_ASOE)))

-  {

-    hrtc->State = HAL_RTC_STATE_ERROR;

-    

-    /* Process Unlocked */

-    __HAL_UNLOCK(hrtc);

-    

-    return HAL_ERROR;

-  }

-

-  MODIFY_REG(BKP->CR, (BKP_CR_TPE | BKP_CR_TPAL), (sTamper->Tamper | (sTamper->Trigger)));

-

-  /* Configure the Tamper Interrupt in the BKP->CSR */

-  __HAL_RTC_TAMPER_ENABLE_IT(hrtc, RTC_IT_TAMP1);

-

-  hrtc->State = HAL_RTC_STATE_READY;

-

-  /* Process Unlocked */

-  __HAL_UNLOCK(hrtc);

-

-  return HAL_OK;

-}

-

-/**

-  * @brief  Deactivates Tamper.

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC.

-  * @param  Tamper: Selected tamper pin.

-  *          This parameter can be a value of @ref RTCEx_Tamper_Pins_Definitions

-  * @retval HAL status

-  */

-HAL_StatusTypeDef HAL_RTCEx_DeactivateTamper(RTC_HandleTypeDef *hrtc, uint32_t Tamper)

-{

-  /* Check input parameters */

-  if(hrtc == NULL)

-  {

-     return HAL_ERROR;

-  }

-  /* Prevent unused argument(s) compilation warning */

-  UNUSED(Tamper);

-

-  assert_param(IS_RTC_TAMPER(Tamper));

-

-  /* Process Locked */

-  __HAL_LOCK(hrtc);

-

-  hrtc->State = HAL_RTC_STATE_BUSY;

-

-  /* Disable the selected Tamper pin */

-  CLEAR_BIT(BKP->CR, BKP_CR_TPE);

-  

-  /* Disable the Tamper Interrupt in the BKP->CSR */

-  /* Configure the Tamper Interrupt in the BKP->CSR */

-  __HAL_RTC_TAMPER_DISABLE_IT(hrtc, RTC_IT_TAMP1);

-  

-  /* Clear the Tamper interrupt pending bit */

-  __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc, RTC_FLAG_TAMP1F);

-  SET_BIT(BKP->CSR, BKP_CSR_CTE);

-  

-  hrtc->State = HAL_RTC_STATE_READY;

-

-  /* Process Unlocked */

-  __HAL_UNLOCK(hrtc);

-

-  return HAL_OK;

-}

-

-/**

-  * @brief  This function handles Tamper interrupt request.

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC.

-  * @retval None

-  */

-void HAL_RTCEx_TamperIRQHandler(RTC_HandleTypeDef *hrtc)

-{  

-  /* Get the status of the Interrupt */

-  if(__HAL_RTC_TAMPER_GET_IT_SOURCE(hrtc, RTC_IT_TAMP1))

-  {

-    /* Get the TAMPER Interrupt enable bit and pending bit */

-    if(__HAL_RTC_TAMPER_GET_FLAG(hrtc, RTC_FLAG_TAMP1F) != (uint32_t)RESET)

-    {

-      /* Tamper callback */ 

-      HAL_RTCEx_Tamper1EventCallback(hrtc);

-  

-      /* Clear the Tamper interrupt pending bit */

-      __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc,RTC_FLAG_TAMP1F);

-    }

-  }

-

-  /* Change RTC state */

-  hrtc->State = HAL_RTC_STATE_READY;

-}

-

-/**

-  * @brief  Tamper 1 callback. 

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC.

-  * @retval None

-  */

-__weak void HAL_RTCEx_Tamper1EventCallback(RTC_HandleTypeDef *hrtc)

-{

-  /* Prevent unused argument(s) compilation warning */

-  UNUSED(hrtc);

-  /* NOTE : This function Should not be modified, when the callback is needed,

-            the HAL_RTCEx_Tamper1EventCallback could be implemented in the user file

-   */

-}

-

-/**

-  * @brief  This function handles Tamper1 Polling.

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC.

-  * @param  Timeout: Timeout duration

-  * @retval HAL status

-  */

-HAL_StatusTypeDef HAL_RTCEx_PollForTamper1Event(RTC_HandleTypeDef *hrtc, uint32_t Timeout)

-{  

-  uint32_t tickstart = HAL_GetTick();

-

-  /* Check input parameters */

-  if(hrtc == NULL)

-  {

-     return HAL_ERROR;

-  }

-  

-  /* Get the status of the Interrupt */

-  while(__HAL_RTC_TAMPER_GET_FLAG(hrtc,RTC_FLAG_TAMP1F)== RESET)

-  {

-    if(Timeout != HAL_MAX_DELAY)

-    {

-      if((Timeout == 0U)||((HAL_GetTick() - tickstart ) > Timeout))

-      {

-        hrtc->State = HAL_RTC_STATE_TIMEOUT;

-        return HAL_TIMEOUT;

-      }

-    }

-  }

-

-  /* Clear the Tamper Flag */

-  __HAL_RTC_TAMPER_CLEAR_FLAG(hrtc,RTC_FLAG_TAMP1F);

-

-  /* Change RTC state */

-  hrtc->State = HAL_RTC_STATE_READY;

-

-  return HAL_OK;

-}

-

-/**

-  * @}

-  */

-  

-/** @defgroup RTCEx_Exported_Functions_Group2 RTC Second functions

-  * @brief    RTC Second functions

-  *

-@verbatim   

- ===============================================================================

-                 ##### RTC Second functions #####

- ===============================================================================  

- 

- [..] This section provides functions implementing second interupt handlers

-

-@endverbatim

-  * @{

-  */

-

-/**

-  * @brief  Sets Interrupt for second

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC.

-  * @retval HAL status

-  */

-HAL_StatusTypeDef HAL_RTCEx_SetSecond_IT(RTC_HandleTypeDef *hrtc)

-{

-  /* Check input parameters */

-  if(hrtc == NULL)

-  {

-     return HAL_ERROR;

-  }

-  

-  /* Process Locked */

-  __HAL_LOCK(hrtc);

-

-  hrtc->State = HAL_RTC_STATE_BUSY;

-

-  /* Enable Second interuption */

-  __HAL_RTC_SECOND_ENABLE_IT(hrtc, RTC_IT_SEC);

-  

-  hrtc->State = HAL_RTC_STATE_READY;

-

-  /* Process Unlocked */

-  __HAL_UNLOCK(hrtc);

-

-  return HAL_OK;

-}

-

-/**

-  * @brief  Deactivates Second.

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC.

-  * @retval HAL status

-  */

-HAL_StatusTypeDef HAL_RTCEx_DeactivateSecond(RTC_HandleTypeDef *hrtc)

-{

-  /* Check input parameters */

-  if(hrtc == NULL)

-  {

-     return HAL_ERROR;

-  }

-  

-  /* Process Locked */

-  __HAL_LOCK(hrtc);

-

-  hrtc->State = HAL_RTC_STATE_BUSY;

-

-  /* Deactivate Second interuption*/ 

-  __HAL_RTC_SECOND_DISABLE_IT(hrtc, RTC_IT_SEC);

-  

-  hrtc->State = HAL_RTC_STATE_READY;

-

-  /* Process Unlocked */

-  __HAL_UNLOCK(hrtc);

-

-  return HAL_OK;

-}

-

-/**

-  * @brief  This function handles second interrupt request.

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC.

-  * @retval None

-  */

-void HAL_RTCEx_RTCIRQHandler(RTC_HandleTypeDef* hrtc)

-{

-  if(__HAL_RTC_SECOND_GET_IT_SOURCE(hrtc, RTC_IT_SEC))

-  {

-    /* Get the status of the Interrupt */

-    if(__HAL_RTC_SECOND_GET_FLAG(hrtc, RTC_FLAG_SEC))

-    {

-      /* Check if Overrun occurred */

-      if (__HAL_RTC_SECOND_GET_FLAG(hrtc, RTC_FLAG_OW))

-      {

-        /* Second error callback */ 

-        HAL_RTCEx_RTCEventErrorCallback(hrtc);

-        

-        /* Clear flag Second */

-        __HAL_RTC_OVERFLOW_CLEAR_FLAG(hrtc, RTC_FLAG_OW);

-        

-        /* Change RTC state */

-        hrtc->State = HAL_RTC_STATE_ERROR; 

-      }

-      else 

-      {

-        /* Second callback */ 

-        HAL_RTCEx_RTCEventCallback(hrtc);

-        

-        /* Change RTC state */

-        hrtc->State = HAL_RTC_STATE_READY; 

-      }

-      

-      /* Clear flag Second */

-      __HAL_RTC_SECOND_CLEAR_FLAG(hrtc, RTC_FLAG_SEC);

-    }

-  }

-}

-

-/**

-  * @brief  Second event callback.

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC.

-  * @retval None

-  */

-__weak void HAL_RTCEx_RTCEventCallback(RTC_HandleTypeDef *hrtc)

-{

-  /* Prevent unused argument(s) compilation warning */

-  UNUSED(hrtc);

-  /* NOTE : This function Should not be modified, when the callback is needed,

-            the HAL_RTCEx_RTCEventCallback could be implemented in the user file

-   */

-}

-

-/**

-  * @brief  Second event error callback.

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC.

-  * @retval None

-  */

-__weak void HAL_RTCEx_RTCEventErrorCallback(RTC_HandleTypeDef *hrtc)

-{

-  /* Prevent unused argument(s) compilation warning */

-  UNUSED(hrtc);

-  /* NOTE : This function Should not be modified, when the callback is needed,

-            the HAL_RTCEx_RTCEventErrorCallback could be implemented in the user file

-   */

-}

-

-/**

-  * @}

-  */

-  

-/** @defgroup RTCEx_Exported_Functions_Group3 Extended Peripheral Control functions

-  * @brief    Extended Peripheral Control functions

-  *

-@verbatim   

- ===============================================================================

-              ##### Extension Peripheral Control functions #####

- ===============================================================================  

-    [..]

-    This subsection provides functions allowing to

-      (+) Writes a data in a specified RTC Backup data register

-      (+) Read a data in a specified RTC Backup data register

-      (+) Sets the Smooth calibration parameters.

-

-@endverbatim

-  * @{

-  */

-

-/**

-  * @brief  Writes a data in a specified RTC Backup data register.

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC. 

-  * @param  BackupRegister: RTC Backup data Register number.

-  *          This parameter can be: RTC_BKP_DRx where x can be from 1 to 10 (or 42) to 

-  *                                 specify the register (depending devices).

-  * @param  Data: Data to be written in the specified RTC Backup data register.                     

-  * @retval None

-  */

-void HAL_RTCEx_BKUPWrite(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister, uint32_t Data)

-{

-  uint32_t tmp = 0U;

-

-  /* Prevent unused argument(s) compilation warning */

-  UNUSED(hrtc);

-

-  /* Check the parameters */

-  assert_param(IS_RTC_BKP(BackupRegister));

-  

-  tmp = (uint32_t)BKP_BASE; 

-  tmp += (BackupRegister * 4U);

-

-  *(__IO uint32_t *) tmp = (Data & BKP_DR1_D);

-}

-

-/**

-  * @brief  Reads data from the specified RTC Backup data Register.

-  * @param  hrtc: pointer to a RTC_HandleTypeDef structure that contains

-  *                the configuration information for RTC. 

-  * @param  BackupRegister: RTC Backup data Register number.

-  *          This parameter can be: RTC_BKP_DRx where x can be from 1 to 10 (or 42) to 

-  *                                 specify the register (depending devices).

-  * @retval Read value

-  */

-uint32_t HAL_RTCEx_BKUPRead(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister)

-{

-  uint32_t backupregister = 0U;

-  uint32_t pvalue = 0U;

-

-  /* Prevent unused argument(s) compilation warning */

-  UNUSED(hrtc);

-

-  /* Check the parameters */

-  assert_param(IS_RTC_BKP(BackupRegister));

-

-  backupregister = (uint32_t)BKP_BASE; 

-  backupregister += (BackupRegister * 4U);

-  

-  pvalue = (*(__IO uint32_t *)(backupregister)) & BKP_DR1_D;

-

-  /* Read the specified register */

-  return pvalue;

-}

-

-

-/**

-  * @brief  Sets the Smooth calibration parameters.

-  * @param  hrtc: RTC handle  

-  * @param  SmoothCalibPeriod: Not used (only present for compatibility with another families)

-  * @param  SmoothCalibPlusPulses: Not used (only present for compatibility with another families)

-  * @param  SmouthCalibMinusPulsesValue: specifies the RTC Clock Calibration value.

-  *          This parameter must be a number between 0 and 0x7F.

-  * @retval HAL status

-  */

-HAL_StatusTypeDef HAL_RTCEx_SetSmoothCalib(RTC_HandleTypeDef* hrtc, uint32_t SmoothCalibPeriod, uint32_t SmoothCalibPlusPulses, uint32_t SmouthCalibMinusPulsesValue)

-{

-  /* Check input parameters */

-  if(hrtc == NULL)

-  {

-     return HAL_ERROR;

-  }

-  /* Prevent unused argument(s) compilation warning */

-  UNUSED(SmoothCalibPeriod);

-  UNUSED(SmoothCalibPlusPulses);

-

-  /* Check the parameters */

-  assert_param(IS_RTC_SMOOTH_CALIB_MINUS(SmouthCalibMinusPulsesValue));

-  

-  /* Process Locked */

-  __HAL_LOCK(hrtc);

-

-  hrtc->State = HAL_RTC_STATE_BUSY;

-

-  /* Sets RTC Clock Calibration value.*/

-  MODIFY_REG(BKP->RTCCR, BKP_RTCCR_CAL, SmouthCalibMinusPulsesValue);

-

-  /* Change RTC state */

-  hrtc->State = HAL_RTC_STATE_READY;

-

-  /* Process Unlocked */

-  __HAL_UNLOCK(hrtc);

-

-  return HAL_OK;

-}

-

-/**

-  * @}

-  */

-

-/**

-  * @}

-  */

-  

-/**

-  * @}

-  */

-

-#endif /* HAL_RTC_MODULE_ENABLED */

-

-/**

-  * @}

-  */

-

-/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/

-