tm_stm32_rtc.h

#ifndef TM_RTC_H
#define TM_RTC_H 100

/* C++ detection */
#ifdef __cplusplus
extern "C" {
#endif

#include "stm32fxxx_hal.h"
#include "defines.h"
#include "attributes.h"

/* RTC clock is: f_clk = RTCCLK(LSI or LSE) / ((RTC_SYNC_PREDIV + 1) * (RTC_ASYNC_PREDIV + 1)) */
/* Sync pre division for clock */
#ifndef RTC_SYNC_PREDIV
#define RTC_SYNC_PREDIV                 0x3FF
#endif
/* Async pre division for clock */
#ifndef RTC_ASYNC_PREDIV
#define RTC_ASYNC_PREDIV                0x1F
#endif
/* NVIC global Priority set */
#ifndef RTC_NVIC_PRIORITY
#define RTC_NVIC_PRIORITY               0x04
#endif
/* Sub priority for wakeup trigger */
#ifndef RTC_NVIC_WAKEUP_SUBPRIORITY
#define RTC_NVIC_WAKEUP_SUBPRIORITY     0x00
#endif
/* Sub priority for alarm trigger */
#ifndef RTC_NVIC_ALARM_SUBPRIORITY
#define RTC_NVIC_ALARM_SUBPRIORITY      0x01
#endif

typedef struct {
    uint8_t Seconds;     
    uint16_t Subseconds; 
    uint8_t Minutes;     
    uint8_t Hours;       
    uint8_t WeekDay;     
    uint8_t Day;         
    uint8_t Month;       
    uint8_t Year;        
    uint32_t Unix;       
} TM_RTC_t;

typedef enum {
    TM_RTC_Result_Ok,   
    TM_RTC_Result_Error 
} TM_RTC_Result_t;

typedef enum {
    TM_RTC_Format_BIN = 0x00, 
    TM_RTC_Format_BCD         
} TM_RTC_Format_t;

typedef enum {
    TM_RTC_Int_Disable = 0x00, 
    TM_RTC_Int_60s,            
    TM_RTC_Int_30s,            
    TM_RTC_Int_15s,            
    TM_RTC_Int_10s,            
    TM_RTC_Int_5s,             
    TM_RTC_Int_2s,             
    TM_RTC_Int_1s,             
    TM_RTC_Int_500ms,          
    TM_RTC_Int_250ms,          
    TM_RTC_Int_125ms           
} TM_RTC_Int_t;

typedef enum {
    TM_RTC_ClockSource_Internal = 0x00, 
    TM_RTC_ClockSource_External         
} TM_RTC_ClockSource_t;

typedef enum {
    TM_RTC_AlarmType_DayInWeek, 
    TM_RTC_AlarmType_DayInMonth 
} TM_RTC_AlarmType_t;

typedef enum {
    TM_RTC_Alarm_A = 0x00, 
    TM_RTC_Alarm_B         
} TM_RTC_Alarm_t;

typedef struct {
    TM_RTC_AlarmType_t Type; 
    uint8_t Seconds;         
    uint8_t Minutes;         
    uint8_t Hours;           
    uint8_t Day;             
} TM_RTC_AlarmTime_t;

uint32_t TM_RTC_Init(TM_RTC_ClockSource_t source);

uint32_t TM_RTC_GetUnixTimeStamp(TM_RTC_t* data);

TM_RTC_Result_t TM_RTC_GetDateTimeFromUnix(TM_RTC_t* data, uint32_t unix);

TM_RTC_Result_t TM_RTC_Interrupts(TM_RTC_Int_t int_value);

TM_RTC_Result_t TM_RTC_SetDateTime(TM_RTC_t* data, TM_RTC_Format_t format);

TM_RTC_Result_t TM_RTC_SetDateTimeString(char* str);

TM_RTC_Result_t TM_RTC_GetDateTime(TM_RTC_t* data, TM_RTC_Format_t format);

uint8_t TM_RTC_GetDaysInMonth(uint8_t month, uint8_t year);

uint16_t TM_RTC_GetDaysInYear(uint8_t year);

void TM_RTC_WriteBackupRegister(uint8_t location, uint32_t value);

uint32_t TM_RTC_ReadBackupRegister(uint8_t location);

TM_RTC_Result_t TM_RTC_EnableAlarm(TM_RTC_Alarm_t Alarm, TM_RTC_AlarmTime_t* AlarmTime, TM_RTC_Format_t format);

TM_RTC_Result_t TM_RTC_DisableAlarm(TM_RTC_Alarm_t Alarm);

void TM_RTC_WakeupHandler(void);

void TM_RTC_AlarmAHandler(void);

void TM_RTC_AlarmBHandler(void);

/* C++ detection */
#ifdef __cplusplus
}
#endif

#endif