espressif_tinyusb/hw/mcu/nxp/lpc_chip_18xx/inc/rtc_ut.h

91 lines
2.8 KiB
C

/*
* @brief RTC tick to (a more) Universal Time
* Adds conversion functions to use an RTC that only provides a
* seconds capability to provide "struct tm" support.
*
* @note
* Copyright(C) NXP Semiconductors, 2014
* All rights reserved.
*
* @par
* Software that is described herein is for illustrative purposes only
* which provides customers with programming information regarding the
* LPC products. This software is supplied "AS IS" without any warranties of
* any kind, and NXP Semiconductors and its licenser disclaim any and
* all warranties, express or implied, including all implied warranties of
* merchantability, fitness for a particular purpose and non-infringement of
* intellectual property rights. NXP Semiconductors assumes no responsibility
* or liability for the use of the software, conveys no license or rights under any
* patent, copyright, mask work right, or any other intellectual property rights in
* or to any products. NXP Semiconductors reserves the right to make changes
* in the software without notification. NXP Semiconductors also makes no
* representation or warranty that such application will be suitable for the
* specified use without further testing or modification.
*
* @par
* Permission to use, copy, modify, and distribute this software and its
* documentation is hereby granted, under NXP Semiconductors' and its
* licensor's relevant copyrights 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.
*/
#ifndef __RTC_UT_H_
#define __RTC_UT_H_
#include "chip.h"
#include <stdlib.h>
#include <time.h>
#ifdef __cplusplus
extern "C" {
#endif
/** @defgroup RTC_UT CHIP: RTC tick to (a more) Universal Time conversion functions
* @ingroup CHIP_Common
* This driver converts between a RTC 1-second tick value and
* a Universal time format in a structure of type 'struct tm'.
* @{
*/
/* Starting year and starting day of week for the driver */
#define TM_YEAR_BASE (1900)
#define TM_DAYOFWEEK (1)
/**
* @brief Converts a RTC tick time to Universal time
* @param rtcTick : Current RTC time value
* @param pTime : Pointer to time structure to fill
* @return Nothing
* @note When setting time, the 'tm_wday', 'tm_yday', and 'tm_isdst'
* fields are not used.
*/
void ConvertRtcTime(uint32_t rtcTick, struct tm *pTime);
/**
* @brief Converts a Universal time to RTC tick time
* @param pTime : Pointer to time structure to use
* @param rtcTick : Pointer to RTC time value to fill
* @return Nothing
* @note When converting time, the 'tm_isdst' field is not
* populated by the conversion function.
*/
void ConvertTimeRtc(struct tm *pTime, uint32_t *rtcTick);
/**
* @}
*/
#ifdef __cplusplus
}
#endif
#endif /* __RTC_UT_H_ */