Diff: libs/LPC17xx/LPC17xxLib/src/lpc17xx_rtc.c

Revision:

2:1df0b61d3b5a

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/libs/LPC17xx/LPC17xxLib/src/lpc17xx_rtc.c	Fri Feb 28 18:52:52 2014 -0800
@@ -0,0 +1,780 @@
+#ifdef __LPC17XX__
+
+/**********************************************************************
+* $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.
+**********************************************************************/
+
+
+/* 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 - 1) & 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)
+{
+	volatile uint32_t *preg;
+
+	CHECK_PARAM(PARAM_RTCx(RTCx));
+	CHECK_PARAM(PARAM_RTC_GPREG_CH(Channel));
+
+	preg = (volatile 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)
+{
+	volatile uint32_t *preg;
+	uint32_t value;
+
+	CHECK_PARAM(PARAM_RTCx(RTCx));
+	CHECK_PARAM(PARAM_RTC_GPREG_CH(Channel));
+
+	preg = (volatile uint32_t *)&RTCx->GPREG0;
+	preg += Channel;
+	value = *preg;
+	return (value);
+}
+
+/**
+ * @}
+ */
+
+#endif /* _RTC */
+
+/**
+ * @}
+ */
+
+/* --------------------------------- End Of File ------------------------------ */
+
+#endif /* __LPC17XX__ */