784 lines
		
	
	
		
			27 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			784 lines
		
	
	
		
			27 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /**********************************************************************
 | |
| * $Id$      lpc17xx_rtc.c               2011-06-06
 | |
| *//**
 | |
| * @file     lpc17xx_rtc.c
 | |
| * @brief    Contains all functions support for RTC firmware library on LPC17xx
 | |
| * @version  3.1
 | |
| * @date     6. June. 2011
 | |
| * @author   NXP MCU SW Application Team
 | |
| *
 | |
| * Copyright(C) 2011, NXP Semiconductor
 | |
| * All rights reserved.
 | |
| *
 | |
| ***********************************************************************
 | |
| * Software that is described herein is for illustrative purposes only
 | |
| * which provides customers with programming information regarding the
 | |
| * products. This software is supplied "AS IS" without any warranties.
 | |
| * NXP Semiconductors assumes no responsibility or liability for the
 | |
| * use of the software, conveys no license or title under any patent,
 | |
| * copyright, or mask work right to the product. NXP Semiconductors
 | |
| * reserves the right to make changes in the software without
 | |
| * notification. NXP Semiconductors also make no representation or
 | |
| * warranty that such application will be suitable for the specified
 | |
| * use without further testing or modification.
 | |
| * Permission to use, copy, modify, and distribute this software and its
 | |
| * documentation is hereby granted, under NXP Semiconductors'
 | |
| * relevant copyright in the software, without fee, provided that it
 | |
| * is used in conjunction with NXP Semiconductors microcontrollers.  This
 | |
| * copyright, permission, and disclaimer notice must appear in all copies of
 | |
| * this code.
 | |
| **********************************************************************/
 | |
| 
 | |
| 
 | |
| /* Peripheral group ----------------------------------------------------------- */
 | |
| /** @addtogroup RTC
 | |
|  * @{
 | |
|  */
 | |
| 
 | |
| /* Includes ------------------------------------------------------------------- */
 | |
| #include "lpc17xx_rtc.h"
 | |
| #include "lpc17xx_clkpwr.h"
 | |
| 
 | |
| 
 | |
| /* If this source file built with example, the LPC17xx FW library configuration
 | |
|  * file in each example directory ("lpc17xx_libcfg.h") must be included,
 | |
|  * otherwise the default FW library configuration file must be included instead
 | |
|  */
 | |
| #ifdef __BUILD_WITH_EXAMPLE__
 | |
| #include "lpc17xx_libcfg.h"
 | |
| #else
 | |
| #include "lpc17xx_libcfg_default.h"
 | |
| #endif /* __BUILD_WITH_EXAMPLE__ */
 | |
| 
 | |
| 
 | |
| #ifdef _RTC
 | |
| 
 | |
| /* Public Functions ----------------------------------------------------------- */
 | |
| /** @addtogroup RTC_Public_Functions
 | |
|  * @{
 | |
|  */
 | |
| 
 | |
| /********************************************************************//**
 | |
|  * @brief       Initializes the RTC peripheral.
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @return      None
 | |
|  *********************************************************************/
 | |
| void RTC_Init (LPC_RTC_TypeDef *RTCx)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
| 
 | |
|     /* Set up clock and power for RTC module */
 | |
|     CLKPWR_ConfigPPWR (CLKPWR_PCONP_PCRTC, ENABLE);
 | |
| 
 | |
|     // Clear all register to be default
 | |
|     RTCx->ILR = 0x00;
 | |
|     RTCx->CCR = 0x00;
 | |
|     RTCx->CIIR = 0x00;
 | |
|     RTCx->AMR = 0xFF;
 | |
|     RTCx->CALIBRATION = 0x00;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       De-initializes the RTC peripheral registers to their
 | |
| *                  default reset values.
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_DeInit(LPC_RTC_TypeDef *RTCx)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
| 
 | |
|     RTCx->CCR = 0x00;
 | |
|     // Disable power and clock for RTC module
 | |
|     CLKPWR_ConfigPPWR (CLKPWR_PCONP_PCRTC, DISABLE);
 | |
| }
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Reset clock tick counter in RTC peripheral
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_ResetClockTickCounter(LPC_RTC_TypeDef *RTCx)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
| 
 | |
|     RTCx->CCR |= RTC_CCR_CTCRST;
 | |
|     RTCx->CCR &= (~RTC_CCR_CTCRST) & RTC_CCR_BITMASK;
 | |
| }
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Start/Stop RTC peripheral
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   NewState New State of this function, should be:
 | |
|  *              - ENABLE: The time counters are enabled
 | |
|  *              - DISABLE: The time counters are disabled
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_Cmd (LPC_RTC_TypeDef *RTCx, FunctionalState NewState)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
|     CHECK_PARAM(PARAM_FUNCTIONALSTATE(NewState));
 | |
| 
 | |
|     if (NewState == ENABLE)
 | |
|     {
 | |
|         RTCx->CCR |= RTC_CCR_CLKEN;
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|         RTCx->CCR &= (~RTC_CCR_CLKEN) & RTC_CCR_BITMASK;
 | |
|     }
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Enable/Disable Counter increment interrupt for each time type
 | |
|  *              in RTC peripheral
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   CntIncrIntType: Counter Increment Interrupt type,
 | |
|  *              an increment of this type value below will generates
 | |
|  *              an interrupt, should be:
 | |
|  *              - RTC_TIMETYPE_SECOND
 | |
|  *              - RTC_TIMETYPE_MINUTE
 | |
|  *              - RTC_TIMETYPE_HOUR
 | |
|  *              - RTC_TIMETYPE_DAYOFWEEK
 | |
|  *              - RTC_TIMETYPE_DAYOFMONTH
 | |
|  *              - RTC_TIMETYPE_DAYOFYEAR
 | |
|  *              - RTC_TIMETYPE_MONTH
 | |
|  *              - RTC_TIMETYPE_YEAR
 | |
|  * @param[in]   NewState New State of this function, should be:
 | |
|  *              - ENABLE: Counter Increment interrupt for this
 | |
|  *                  time type are enabled
 | |
|  *              - DISABLE: Counter Increment interrupt for this
 | |
|  *                  time type are disabled
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_CntIncrIntConfig (LPC_RTC_TypeDef *RTCx, uint32_t CntIncrIntType, \
 | |
|                                 FunctionalState NewState)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
|     CHECK_PARAM(PARAM_FUNCTIONALSTATE(NewState));
 | |
|     CHECK_PARAM(PARAM_RTC_TIMETYPE(CntIncrIntType));
 | |
| 
 | |
|     if (NewState ==  ENABLE)
 | |
|     {
 | |
|         switch (CntIncrIntType)
 | |
|         {
 | |
|         case RTC_TIMETYPE_SECOND:
 | |
|             RTCx->CIIR |= RTC_CIIR_IMSEC;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_MINUTE:
 | |
|             RTCx->CIIR |= RTC_CIIR_IMMIN;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_HOUR:
 | |
|             RTCx->CIIR |= RTC_CIIR_IMHOUR;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_DAYOFWEEK:
 | |
|             RTCx->CIIR |= RTC_CIIR_IMDOW;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_DAYOFMONTH:
 | |
|             RTCx->CIIR |= RTC_CIIR_IMDOM;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_DAYOFYEAR:
 | |
|             RTCx->CIIR |= RTC_CIIR_IMDOY;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_MONTH:
 | |
|             RTCx->CIIR |= RTC_CIIR_IMMON;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_YEAR:
 | |
|             RTCx->CIIR |= RTC_CIIR_IMYEAR;
 | |
|             break;
 | |
|         }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|         switch (CntIncrIntType)
 | |
|         {
 | |
|         case RTC_TIMETYPE_SECOND:
 | |
|             RTCx->CIIR &= (~RTC_CIIR_IMSEC) & RTC_CIIR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_MINUTE:
 | |
|             RTCx->CIIR &= (~RTC_CIIR_IMMIN) & RTC_CIIR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_HOUR:
 | |
|             RTCx->CIIR &= (~RTC_CIIR_IMHOUR) & RTC_CIIR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_DAYOFWEEK:
 | |
|             RTCx->CIIR &= (~RTC_CIIR_IMDOW) & RTC_CIIR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_DAYOFMONTH:
 | |
|             RTCx->CIIR &= (~RTC_CIIR_IMDOM) & RTC_CIIR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_DAYOFYEAR:
 | |
|             RTCx->CIIR &= (~RTC_CIIR_IMDOY) & RTC_CIIR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_MONTH:
 | |
|             RTCx->CIIR &= (~RTC_CIIR_IMMON) & RTC_CIIR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_YEAR:
 | |
|             RTCx->CIIR &= (~RTC_CIIR_IMYEAR) & RTC_CIIR_BITMASK;
 | |
|             break;
 | |
|         }
 | |
|     }
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Enable/Disable Alarm interrupt for each time type
 | |
|  *              in RTC peripheral
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   AlarmTimeType: Alarm Time Interrupt type,
 | |
|  *              an matching of this type value below with current time
 | |
|  *              in RTC will generates an interrupt, should be:
 | |
|  *              - RTC_TIMETYPE_SECOND
 | |
|  *              - RTC_TIMETYPE_MINUTE
 | |
|  *              - RTC_TIMETYPE_HOUR
 | |
|  *              - RTC_TIMETYPE_DAYOFWEEK
 | |
|  *              - RTC_TIMETYPE_DAYOFMONTH
 | |
|  *              - RTC_TIMETYPE_DAYOFYEAR
 | |
|  *              - RTC_TIMETYPE_MONTH
 | |
|  *              - RTC_TIMETYPE_YEAR
 | |
|  * @param[in]   NewState New State of this function, should be:
 | |
|  *              - ENABLE: Alarm interrupt for this
 | |
|  *                  time type are enabled
 | |
|  *              - DISABLE: Alarm interrupt for this
 | |
|  *                  time type are disabled
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_AlarmIntConfig (LPC_RTC_TypeDef *RTCx, uint32_t AlarmTimeType, \
 | |
|                                 FunctionalState NewState)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
|     CHECK_PARAM(PARAM_FUNCTIONALSTATE(NewState));
 | |
|     CHECK_PARAM(PARAM_RTC_TIMETYPE(AlarmTimeType));
 | |
| 
 | |
|     if (NewState == ENABLE)
 | |
|     {
 | |
|         switch (AlarmTimeType)
 | |
|         {
 | |
|         case RTC_TIMETYPE_SECOND:
 | |
|             RTCx->AMR &= (~RTC_AMR_AMRSEC) & RTC_AMR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_MINUTE:
 | |
|             RTCx->AMR &= (~RTC_AMR_AMRMIN) & RTC_AMR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_HOUR:
 | |
|             RTCx->AMR &= (~RTC_AMR_AMRHOUR) & RTC_AMR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_DAYOFWEEK:
 | |
|             RTCx->AMR &= (~RTC_AMR_AMRDOW) & RTC_AMR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_DAYOFMONTH:
 | |
|             RTCx->AMR &= (~RTC_AMR_AMRDOM) & RTC_AMR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_DAYOFYEAR:
 | |
|             RTCx->AMR &= (~RTC_AMR_AMRDOY) & RTC_AMR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_MONTH:
 | |
|             RTCx->AMR &= (~RTC_AMR_AMRMON) & RTC_AMR_BITMASK;
 | |
|             break;
 | |
|         case RTC_TIMETYPE_YEAR:
 | |
|             RTCx->AMR &= (~RTC_AMR_AMRYEAR) & RTC_AMR_BITMASK;
 | |
|             break;
 | |
|         }
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|         switch (AlarmTimeType)
 | |
|         {
 | |
|         case RTC_TIMETYPE_SECOND:
 | |
|             RTCx->AMR |= (RTC_AMR_AMRSEC);
 | |
|             break;
 | |
|         case RTC_TIMETYPE_MINUTE:
 | |
|             RTCx->AMR |= (RTC_AMR_AMRMIN);
 | |
|             break;
 | |
|         case RTC_TIMETYPE_HOUR:
 | |
|             RTCx->AMR |= (RTC_AMR_AMRHOUR);
 | |
|             break;
 | |
|         case RTC_TIMETYPE_DAYOFWEEK:
 | |
|             RTCx->AMR |= (RTC_AMR_AMRDOW);
 | |
|             break;
 | |
|         case RTC_TIMETYPE_DAYOFMONTH:
 | |
|             RTCx->AMR |= (RTC_AMR_AMRDOM);
 | |
|             break;
 | |
|         case RTC_TIMETYPE_DAYOFYEAR:
 | |
|             RTCx->AMR |= (RTC_AMR_AMRDOY);
 | |
|             break;
 | |
|         case RTC_TIMETYPE_MONTH:
 | |
|             RTCx->AMR |= (RTC_AMR_AMRMON);
 | |
|             break;
 | |
|         case RTC_TIMETYPE_YEAR:
 | |
|             RTCx->AMR |= (RTC_AMR_AMRYEAR);
 | |
|             break;
 | |
|         }
 | |
|     }
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Set current time value for each time type in RTC peripheral
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   Timetype: Time Type, should be:
 | |
|  *              - RTC_TIMETYPE_SECOND
 | |
|  *              - RTC_TIMETYPE_MINUTE
 | |
|  *              - RTC_TIMETYPE_HOUR
 | |
|  *              - RTC_TIMETYPE_DAYOFWEEK
 | |
|  *              - RTC_TIMETYPE_DAYOFMONTH
 | |
|  *              - RTC_TIMETYPE_DAYOFYEAR
 | |
|  *              - RTC_TIMETYPE_MONTH
 | |
|  *              - RTC_TIMETYPE_YEAR
 | |
|  * @param[in]   TimeValue Time value to set
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_SetTime (LPC_RTC_TypeDef *RTCx, uint32_t Timetype, uint32_t TimeValue)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
|     CHECK_PARAM(PARAM_RTC_TIMETYPE(Timetype));
 | |
| 
 | |
|     switch ( Timetype)
 | |
|     {
 | |
|     case RTC_TIMETYPE_SECOND:
 | |
|         CHECK_PARAM(TimeValue <= RTC_SECOND_MAX);
 | |
| 
 | |
|         RTCx->SEC = TimeValue & RTC_SEC_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_MINUTE:
 | |
|         CHECK_PARAM(TimeValue <= RTC_MINUTE_MAX);
 | |
| 
 | |
|         RTCx->MIN = TimeValue & RTC_MIN_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_HOUR:
 | |
|         CHECK_PARAM(TimeValue <= RTC_HOUR_MAX);
 | |
| 
 | |
|         RTCx->HOUR = TimeValue & RTC_HOUR_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_DAYOFWEEK:
 | |
|         CHECK_PARAM(TimeValue <= RTC_DAYOFWEEK_MAX);
 | |
| 
 | |
|         RTCx->DOW = TimeValue & RTC_DOW_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_DAYOFMONTH:
 | |
|         CHECK_PARAM((TimeValue <= RTC_DAYOFMONTH_MAX) \
 | |
|                 && (TimeValue >= RTC_DAYOFMONTH_MIN));
 | |
| 
 | |
|         RTCx->DOM = TimeValue & RTC_DOM_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_DAYOFYEAR:
 | |
|         CHECK_PARAM((TimeValue >= RTC_DAYOFYEAR_MIN) \
 | |
|                 && (TimeValue <= RTC_DAYOFYEAR_MAX));
 | |
| 
 | |
|         RTCx->DOY = TimeValue & RTC_DOY_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_MONTH:
 | |
|         CHECK_PARAM((TimeValue >= RTC_MONTH_MIN) \
 | |
|                 && (TimeValue <= RTC_MONTH_MAX));
 | |
| 
 | |
|         RTCx->MONTH = TimeValue & RTC_MONTH_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_YEAR:
 | |
|         CHECK_PARAM(TimeValue <= RTC_YEAR_MAX);
 | |
| 
 | |
|         RTCx->YEAR = TimeValue & RTC_YEAR_MASK;
 | |
|         break;
 | |
|     }
 | |
| }
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Get current time value for each type time type
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   Timetype: Time Type, should be:
 | |
|  *              - RTC_TIMETYPE_SECOND
 | |
|  *              - RTC_TIMETYPE_MINUTE
 | |
|  *              - RTC_TIMETYPE_HOUR
 | |
|  *              - RTC_TIMETYPE_DAYOFWEEK
 | |
|  *              - RTC_TIMETYPE_DAYOFMONTH
 | |
|  *              - RTC_TIMETYPE_DAYOFYEAR
 | |
|  *              - RTC_TIMETYPE_MONTH
 | |
|  *              - RTC_TIMETYPE_YEAR
 | |
|  * @return      Value of time according to specified time type
 | |
|  **********************************************************************/
 | |
| uint32_t RTC_GetTime(LPC_RTC_TypeDef *RTCx, uint32_t Timetype)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
|     CHECK_PARAM(PARAM_RTC_TIMETYPE(Timetype));
 | |
| 
 | |
|     switch (Timetype)
 | |
|     {
 | |
|     case RTC_TIMETYPE_SECOND:
 | |
|         return (RTCx->SEC & RTC_SEC_MASK);
 | |
|     case RTC_TIMETYPE_MINUTE:
 | |
|         return (RTCx->MIN & RTC_MIN_MASK);
 | |
|     case RTC_TIMETYPE_HOUR:
 | |
|         return (RTCx->HOUR & RTC_HOUR_MASK);
 | |
|     case RTC_TIMETYPE_DAYOFWEEK:
 | |
|         return (RTCx->DOW & RTC_DOW_MASK);
 | |
|     case RTC_TIMETYPE_DAYOFMONTH:
 | |
|         return (RTCx->DOM & RTC_DOM_MASK);
 | |
|     case RTC_TIMETYPE_DAYOFYEAR:
 | |
|         return (RTCx->DOY & RTC_DOY_MASK);
 | |
|     case RTC_TIMETYPE_MONTH:
 | |
|         return (RTCx->MONTH & RTC_MONTH_MASK);
 | |
|     case RTC_TIMETYPE_YEAR:
 | |
|         return (RTCx->YEAR & RTC_YEAR_MASK);
 | |
|     default:
 | |
|         return (0);
 | |
|     }
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Set full of time in RTC peripheral
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   pFullTime Pointer to a RTC_TIME_Type structure that
 | |
|  *              contains time value in full.
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_SetFullTime (LPC_RTC_TypeDef *RTCx, RTC_TIME_Type *pFullTime)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
| 
 | |
|     RTCx->DOM = pFullTime->DOM & RTC_DOM_MASK;
 | |
|     RTCx->DOW = pFullTime->DOW & RTC_DOW_MASK;
 | |
|     RTCx->DOY = pFullTime->DOY & RTC_DOY_MASK;
 | |
|     RTCx->HOUR = pFullTime->HOUR & RTC_HOUR_MASK;
 | |
|     RTCx->MIN = pFullTime->MIN & RTC_MIN_MASK;
 | |
|     RTCx->SEC = pFullTime->SEC & RTC_SEC_MASK;
 | |
|     RTCx->MONTH = pFullTime->MONTH & RTC_MONTH_MASK;
 | |
|     RTCx->YEAR = pFullTime->YEAR & RTC_YEAR_MASK;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Get full of time in RTC peripheral
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   pFullTime Pointer to a RTC_TIME_Type structure that
 | |
|  *              will be stored time in full.
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_GetFullTime (LPC_RTC_TypeDef *RTCx, RTC_TIME_Type *pFullTime)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
| 
 | |
|     pFullTime->DOM = RTCx->DOM & RTC_DOM_MASK;
 | |
|     pFullTime->DOW = RTCx->DOW & RTC_DOW_MASK;
 | |
|     pFullTime->DOY = RTCx->DOY & RTC_DOY_MASK;
 | |
|     pFullTime->HOUR = RTCx->HOUR & RTC_HOUR_MASK;
 | |
|     pFullTime->MIN = RTCx->MIN & RTC_MIN_MASK;
 | |
|     pFullTime->SEC = RTCx->SEC & RTC_SEC_MASK;
 | |
|     pFullTime->MONTH = RTCx->MONTH & RTC_MONTH_MASK;
 | |
|     pFullTime->YEAR = RTCx->YEAR & RTC_YEAR_MASK;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Set alarm time value for each time type
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   Timetype: Time Type, should be:
 | |
|  *              - RTC_TIMETYPE_SECOND
 | |
|  *              - RTC_TIMETYPE_MINUTE
 | |
|  *              - RTC_TIMETYPE_HOUR
 | |
|  *              - RTC_TIMETYPE_DAYOFWEEK
 | |
|  *              - RTC_TIMETYPE_DAYOFMONTH
 | |
|  *              - RTC_TIMETYPE_DAYOFYEAR
 | |
|  *              - RTC_TIMETYPE_MONTH
 | |
|  *              - RTC_TIMETYPE_YEAR
 | |
|  * @param[in]   ALValue Alarm time value to set
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_SetAlarmTime (LPC_RTC_TypeDef *RTCx, uint32_t Timetype, uint32_t ALValue)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
| 
 | |
|     switch (Timetype)
 | |
|     {
 | |
|     case RTC_TIMETYPE_SECOND:
 | |
|         CHECK_PARAM(ALValue <= RTC_SECOND_MAX);
 | |
| 
 | |
|         RTCx->ALSEC = ALValue & RTC_SEC_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_MINUTE:
 | |
|         CHECK_PARAM(ALValue <= RTC_MINUTE_MAX);
 | |
| 
 | |
|         RTCx->ALMIN = ALValue & RTC_MIN_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_HOUR:
 | |
|         CHECK_PARAM(ALValue <= RTC_HOUR_MAX);
 | |
| 
 | |
|         RTCx->ALHOUR = ALValue & RTC_HOUR_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_DAYOFWEEK:
 | |
|         CHECK_PARAM(ALValue <= RTC_DAYOFWEEK_MAX);
 | |
| 
 | |
|         RTCx->ALDOW = ALValue & RTC_DOW_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_DAYOFMONTH:
 | |
|         CHECK_PARAM((ALValue <= RTC_DAYOFMONTH_MAX) \
 | |
|                 && (ALValue >= RTC_DAYOFMONTH_MIN));
 | |
| 
 | |
|         RTCx->ALDOM = ALValue & RTC_DOM_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_DAYOFYEAR:
 | |
|         CHECK_PARAM((ALValue >= RTC_DAYOFYEAR_MIN) \
 | |
|                 && (ALValue <= RTC_DAYOFYEAR_MAX));
 | |
| 
 | |
|         RTCx->ALDOY = ALValue & RTC_DOY_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_MONTH:
 | |
|         CHECK_PARAM((ALValue >= RTC_MONTH_MIN) \
 | |
|                 && (ALValue <= RTC_MONTH_MAX));
 | |
| 
 | |
|         RTCx->ALMON = ALValue & RTC_MONTH_MASK;
 | |
|         break;
 | |
| 
 | |
|     case RTC_TIMETYPE_YEAR:
 | |
|         CHECK_PARAM(ALValue <= RTC_YEAR_MAX);
 | |
| 
 | |
|         RTCx->ALYEAR = ALValue & RTC_YEAR_MASK;
 | |
|         break;
 | |
|     }
 | |
| }
 | |
| 
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Get alarm time value for each time type
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   Timetype: Time Type, should be:
 | |
|  *              - RTC_TIMETYPE_SECOND
 | |
|  *              - RTC_TIMETYPE_MINUTE
 | |
|  *              - RTC_TIMETYPE_HOUR
 | |
|  *              - RTC_TIMETYPE_DAYOFWEEK
 | |
|  *              - RTC_TIMETYPE_DAYOFMONTH
 | |
|  *              - RTC_TIMETYPE_DAYOFYEAR
 | |
|  *              - RTC_TIMETYPE_MONTH
 | |
|  *              - RTC_TIMETYPE_YEAR
 | |
|   * @return     Value of Alarm time according to specified time type
 | |
|  **********************************************************************/
 | |
| uint32_t RTC_GetAlarmTime (LPC_RTC_TypeDef *RTCx, uint32_t Timetype)
 | |
| {
 | |
|     switch (Timetype)
 | |
|     {
 | |
|     case RTC_TIMETYPE_SECOND:
 | |
|         return (RTCx->ALSEC & RTC_SEC_MASK);
 | |
|     case RTC_TIMETYPE_MINUTE:
 | |
|         return (RTCx->ALMIN & RTC_MIN_MASK);
 | |
|     case RTC_TIMETYPE_HOUR:
 | |
|         return (RTCx->ALHOUR & RTC_HOUR_MASK);
 | |
|     case RTC_TIMETYPE_DAYOFWEEK:
 | |
|         return (RTCx->ALDOW & RTC_DOW_MASK);
 | |
|     case RTC_TIMETYPE_DAYOFMONTH:
 | |
|         return (RTCx->ALDOM & RTC_DOM_MASK);
 | |
|     case RTC_TIMETYPE_DAYOFYEAR:
 | |
|         return (RTCx->ALDOY & RTC_DOY_MASK);
 | |
|     case RTC_TIMETYPE_MONTH:
 | |
|         return (RTCx->ALMON & RTC_MONTH_MASK);
 | |
|     case RTC_TIMETYPE_YEAR:
 | |
|         return (RTCx->ALYEAR & RTC_YEAR_MASK);
 | |
|     default:
 | |
|         return (0);
 | |
|     }
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Set full of alarm time in RTC peripheral
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   pFullTime Pointer to a RTC_TIME_Type structure that
 | |
|  *              contains alarm time value in full.
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_SetFullAlarmTime (LPC_RTC_TypeDef *RTCx, RTC_TIME_Type *pFullTime)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
| 
 | |
|     RTCx->ALDOM = pFullTime->DOM & RTC_DOM_MASK;
 | |
|     RTCx->ALDOW = pFullTime->DOW & RTC_DOW_MASK;
 | |
|     RTCx->ALDOY = pFullTime->DOY & RTC_DOY_MASK;
 | |
|     RTCx->ALHOUR = pFullTime->HOUR & RTC_HOUR_MASK;
 | |
|     RTCx->ALMIN = pFullTime->MIN & RTC_MIN_MASK;
 | |
|     RTCx->ALSEC = pFullTime->SEC & RTC_SEC_MASK;
 | |
|     RTCx->ALMON = pFullTime->MONTH & RTC_MONTH_MASK;
 | |
|     RTCx->ALYEAR = pFullTime->YEAR & RTC_YEAR_MASK;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Get full of alarm time in RTC peripheral
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   pFullTime Pointer to a RTC_TIME_Type structure that
 | |
|  *              will be stored alarm time in full.
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_GetFullAlarmTime (LPC_RTC_TypeDef *RTCx, RTC_TIME_Type *pFullTime)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
| 
 | |
|     pFullTime->DOM = RTCx->ALDOM & RTC_DOM_MASK;
 | |
|     pFullTime->DOW = RTCx->ALDOW & RTC_DOW_MASK;
 | |
|     pFullTime->DOY = RTCx->ALDOY & RTC_DOY_MASK;
 | |
|     pFullTime->HOUR = RTCx->ALHOUR & RTC_HOUR_MASK;
 | |
|     pFullTime->MIN = RTCx->ALMIN & RTC_MIN_MASK;
 | |
|     pFullTime->SEC = RTCx->ALSEC & RTC_SEC_MASK;
 | |
|     pFullTime->MONTH = RTCx->ALMON & RTC_MONTH_MASK;
 | |
|     pFullTime->YEAR = RTCx->ALYEAR & RTC_YEAR_MASK;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Check whether if specified Location interrupt in
 | |
|  *              RTC peripheral is set or not
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   IntType Interrupt location type, should be:
 | |
|  *                      - RTC_INT_COUNTER_INCREASE: Counter Increment Interrupt
 | |
|  *                          block generated an interrupt.
 | |
|  *                      - RTC_INT_ALARM: Alarm generated an
 | |
|  *                          interrupt.
 | |
|  * @return      New state of specified Location interrupt in RTC peripheral
 | |
|  *              (SET or RESET)
 | |
|  **********************************************************************/
 | |
| IntStatus RTC_GetIntPending (LPC_RTC_TypeDef *RTCx, uint32_t IntType)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
|     CHECK_PARAM(PARAM_RTC_INT(IntType));
 | |
| 
 | |
|     return ((RTCx->ILR & IntType) ? SET : RESET);
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Clear specified Location interrupt pending in
 | |
|  *              RTC peripheral
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   IntType Interrupt location type, should be:
 | |
|  *                      - RTC_INT_COUNTER_INCREASE: Clear Counter Increment
 | |
|  *                      Interrupt pending.
 | |
|  *                      - RTC_INT_ALARM: Clear alarm interrupt pending
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_ClearIntPending (LPC_RTC_TypeDef *RTCx, uint32_t IntType)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
|     CHECK_PARAM(PARAM_RTC_INT(IntType));
 | |
| 
 | |
|     RTCx->ILR |= IntType;
 | |
| }
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Enable/Disable calibration counter in RTC peripheral
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   NewState New State of this function, should be:
 | |
|  *              - ENABLE: The calibration counter is enabled and counting
 | |
|  *              - DISABLE: The calibration counter is disabled and reset to zero
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_CalibCounterCmd(LPC_RTC_TypeDef *RTCx, FunctionalState NewState)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
|     CHECK_PARAM(PARAM_FUNCTIONALSTATE(NewState));
 | |
| 
 | |
|     if (NewState == ENABLE)
 | |
|     {
 | |
|         RTCx->CCR &= (~RTC_CCR_CCALEN) & RTC_CCR_BITMASK;
 | |
|     }
 | |
|     else
 | |
|     {
 | |
|         RTCx->CCR |= RTC_CCR_CCALEN;
 | |
|     }
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Configures Calibration in RTC peripheral
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   CalibValue Calibration value, should be in range from
 | |
|  *                  0 to 131,072
 | |
|  * @param[in]   CalibDir Calibration Direction, should be:
 | |
|  *                  - RTC_CALIB_DIR_FORWARD: Forward calibration
 | |
|  *                  - RTC_CALIB_DIR_BACKWARD: Backward calibration
 | |
|  * @return      None
 | |
|  **********************************************************************/
 | |
| void RTC_CalibConfig(LPC_RTC_TypeDef *RTCx, uint32_t CalibValue, uint8_t CalibDir)
 | |
| {
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
|     CHECK_PARAM(PARAM_RTC_CALIB_DIR(CalibDir));
 | |
|     CHECK_PARAM(CalibValue < RTC_CALIBRATION_MAX);
 | |
| 
 | |
|     RTCx->CALIBRATION = ((CalibValue) & RTC_CALIBRATION_CALVAL_MASK) \
 | |
|             | ((CalibDir == RTC_CALIB_DIR_BACKWARD) ? RTC_CALIBRATION_LIBDIR : 0);
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Write value to General purpose registers
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   Channel General purpose registers Channel number,
 | |
|  *              should be in range from 0 to 4.
 | |
|  * @param[in]   Value Value to write
 | |
|  * @return      None
 | |
|  * Note: These General purpose registers can be used to store important
 | |
|  * information when the main power supply is off. The value in these
 | |
|  * registers is not affected by chip reset.
 | |
|  **********************************************************************/
 | |
| void RTC_WriteGPREG (LPC_RTC_TypeDef *RTCx, uint8_t Channel, uint32_t Value)
 | |
| {
 | |
|     uint32_t *preg;
 | |
| 
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
|     CHECK_PARAM(PARAM_RTC_GPREG_CH(Channel));
 | |
| 
 | |
|     preg = (uint32_t *)&RTCx->GPREG0;
 | |
|     preg += Channel;
 | |
|     *preg = Value;
 | |
| }
 | |
| 
 | |
| 
 | |
| /*********************************************************************//**
 | |
|  * @brief       Read value from General purpose registers
 | |
|  * @param[in]   RTCx    RTC peripheral selected, should be LPC_RTC
 | |
|  * @param[in]   Channel General purpose registers Channel number,
 | |
|  *              should be in range from 0 to 4.
 | |
|  * @return      Read Value
 | |
|  * Note: These General purpose registers can be used to store important
 | |
|  * information when the main power supply is off. The value in these
 | |
|  * registers is not affected by chip reset.
 | |
|  **********************************************************************/
 | |
| uint32_t RTC_ReadGPREG (LPC_RTC_TypeDef *RTCx, uint8_t Channel)
 | |
| {
 | |
|     uint32_t *preg;
 | |
|     uint32_t value;
 | |
| 
 | |
|     CHECK_PARAM(PARAM_RTCx(RTCx));
 | |
|     CHECK_PARAM(PARAM_RTC_GPREG_CH(Channel));
 | |
| 
 | |
|     preg = (uint32_t *)&RTCx->GPREG0;
 | |
|     preg += Channel;
 | |
|     value = *preg;
 | |
|     return (value);
 | |
| }
 | |
| 
 | |
| /**
 | |
|  * @}
 | |
|  */
 | |
| 
 | |
| #endif /* _RTC */
 | |
| 
 | |
| /**
 | |
|  * @}
 | |
|  */
 | |
| 
 | |
| /* --------------------------------- End Of File ------------------------------ */
 | |
| 
 | 
