File content as of revision 0:1063a091a062:

/**
 * @file    : lpc17xx_rtc.c
 * @brief    : Contains all functions support for RTC firmware library on LPC17xx
 * @version    : 1.0
 * @date    : 23. Apr. 2009
 * @author    : HieuNguyen
 **************************************************************************
 * 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 ------------------------------ */