/*
|
* Copyright (c) 2019-2023 Beijing Hanwei Innovation Technology Ltd. Co. and
|
* its subsidiaries and affiliates (collectly called MKSEMI).
|
*
|
* All rights reserved.
|
*
|
* 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, except as embedded into an MKSEMI
|
* integrated circuit in a product or a software update for such product,
|
* 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 MKSEMI nor the names of its contributors may be used
|
* to endorse or promote products derived from this software without
|
* specific prior written permission.
|
*
|
* 4. This software, with or without modification, must only be used with a
|
* MKSEMI integrated circuit.
|
*
|
* 5. Any software provided in binary form under this license must not be
|
* reverse engineered, decompiled, modified and/or disassembled.
|
*
|
* THIS SOFTWARE IS PROVIDED BY MKSEMI "AS IS" AND ANY EXPRESS OR IMPLIED
|
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
* MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
* DISCLAIMED. IN NO EVENT SHALL MKSEMI 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.
|
*/
|
|
#ifndef MK_RTC_H_
|
#define MK_RTC_H_
|
#include "mk_common.h"
|
|
/**
|
* @addtogroup MK8000_RTC
|
* @{
|
*/
|
|
#ifndef RTC_FREE_COUNTER_EN
|
#define RTC_FREE_COUNTER_EN (0)
|
#endif
|
|
#if RTC_FREE_COUNTER_EN
|
|
/* RTC device instance */
|
enum RTC_DEV_T
|
{
|
RTC_ID0 = 0,
|
RTC_MAX_NUM
|
};
|
|
struct RTC_HANDLE_T
|
{
|
RTC_TypeDef *const base;
|
const IRQn_Type alarm_irq;
|
drv_callback_t alarm_callback;
|
uint32_t rtc_open_flag;
|
};
|
|
#ifdef __cplusplus
|
extern "C" {
|
#endif
|
|
int rtc_open(enum RTC_DEV_T id);
|
int rtc_close(enum RTC_DEV_T id);
|
|
uint32_t rtc_get(enum RTC_DEV_T id);
|
|
int rtc_set_alarm(enum RTC_DEV_T id, uint32_t target, drv_callback_t callback);
|
void rtc_clear_alarm(enum RTC_DEV_T id);
|
void RTC_ALARM_IRQHandler(void);
|
|
#ifdef __cplusplus
|
}
|
#endif
|
|
#else
|
|
/* RTC device instance */
|
enum RTC_DEV_T
|
{
|
RTC_ID0 = 0,
|
RTC_MAX_NUM
|
};
|
|
struct RTC_TIME_T
|
{
|
uint16_t year; /*!< Range from 1970 to 2099.*/
|
uint8_t month; /*!< Range from 1 to 12.*/
|
uint8_t day; /*!< Range from 1 to 31 (depending on month).*/
|
uint8_t hour; /*!< Range from 0 to 23.*/
|
uint8_t minute; /*!< Range from 0 to 59.*/
|
uint8_t second; /*!< Range from 0 to 59.*/
|
uint8_t reserved;
|
};
|
|
struct RTC_HANDLE_T
|
{
|
RTC_TypeDef *const base;
|
const IRQn_Type tick_irq;
|
const IRQn_Type alarm_irq;
|
drv_callback_t tick_callback;
|
drv_callback_t alarm_callback;
|
uint16_t tick_int_en;
|
uint16_t rtc_open_flag;
|
};
|
|
#ifdef __cplusplus
|
extern "C" {
|
#endif
|
|
int rtc_open(enum RTC_DEV_T id, drv_callback_t callback);
|
int rtc_close(enum RTC_DEV_T id);
|
|
int rtc_set(enum RTC_DEV_T id, struct RTC_TIME_T *time);
|
int rtc_get(enum RTC_DEV_T id, struct RTC_TIME_T *time);
|
|
int rtc_set_alarm(enum RTC_DEV_T id, struct RTC_TIME_T *time, drv_callback_t callback);
|
void rtc_clear_alarm(enum RTC_DEV_T id);
|
|
void RTC_TICK_IRQHandler(void);
|
void RTC_ALARM_IRQHandler(void);
|
|
#ifdef __cplusplus
|
}
|
#endif
|
#endif
|
|
/* CLK 32K measurement time */
|
enum CLK32K_MEAS_TIME_T
|
{
|
CLK32K_MEAS_TIME_8_CYCLES = 0,
|
CLK32K_MEAS_TIME_16_CYCLES,
|
CLK32K_MEAS_TIME_32_CYCLES, // ~1ms
|
CLK32K_MEAS_TIME_64_CYCLES,
|
CLK32K_MEAS_TIME_128_CYCLES,
|
CLK32K_MEAS_TIME_256_CYCLES,
|
CLK32K_MEAS_TIME_512_CYCLES,
|
CLK32K_MEAS_TIME_1024_CYCLES,
|
};
|
|
void clk32k_ppm_calibrate(enum CLK32K_MEAS_TIME_T time);
|
void CLK32K_CAL_IRQHandler(void);
|
|
/**
|
* @}
|
*/
|
|
#endif /* MK_RTC_H_ */
|