rtc.h

周立功2103开发板CD资料

/*********************************************************************************************************
**文件名称： RTC.h
**功能说明： RTC操作软件包头文件
**使用说明： 
********************************************************************************************************/


//RTC时间结构体定义
typedef struct _rtctime
{
    uint8 sec;      //秒 0～59
    uint8 min;		//分 0～59
    uint8 hour;     //时 0～23
    uint8 day;		//天 1～28、29、30或31
    uint8 week;		//星期值  0～6
    uint8 month;    //月份 1～12
    uint16 year;    //年份 0～4095
    
}RTCtime;



/*********************************************************************************************************
**函数名称：void RTCInit(uint8 clksrc)
**函数功能：RTC初始化操作
**入口参数：clksrc        RTC时钟源选择。 0 :时钟源为VBP    >0 : 时钟源为外部晶振
**出口参数：无
**说明：
********************************************************************************************************/
extern void RTCInit(uint8 clksrc);

/*********************************************************************************************************
**函数名称：uint8 SetRTCtime(RTCtime time)
**函数功能：设置RTC的时间
**入口参数：time        时间值结构体
**出口参数：0 :参数错误
**          1 :操作成功 
**说明：
********************************************************************************************************/
extern uint8 SetRTCtime(RTCtime time);


/*********************************************************************************************************
**函数名称：void GetRTCtime(RTCtime *ptime)
**函数功能：获取RTC的时间
**入口参数：*ptime        时间值结构体指针
**出口参数：无 
**说明：
********************************************************************************************************/
extern void GetRTCtime(RTCtime *ptime);


/*********************************************************************************************************
**函数名称：void SetAMR(uint8 val)
**函数功能：设置报警屏蔽
**入口参数：val   报警屏蔽控制字节，按位操作
                                    bit0   1---屏蔽秒值	          0---不屏蔽秒值
                                    bit1   1---屏蔽分值			  0---不屏蔽分值
                                    bit2   1---屏蔽小时值		  0---不屏蔽小时值
                                    bit3   1---屏蔽日期（月）值	  0---不屏蔽日期（月）值
                                    bit4   1---屏蔽星期值		  0---不屏蔽星期值
                                    bit5   1---屏蔽日期（年）值	  0---不屏蔽日期（年）值
                                    bit6   1---屏蔽月值           0---不屏蔽月值
                                    bit7   1---屏蔽年值           0---不屏蔽年值 
**出口参数：无 
**说明：
********************************************************************************************************/
extern void SetAMR(uint8 val);


/*********************************************************************************************************
**函数名称：uint8 SetAlarmTime(uint8 type, uint32 time)
**函数功能：设置报警时间值
**入口参数：type    时间类型。取值如下：0：秒    
                                        1：分  
                                        2：时                                        
                                        3：日期（月）
                                        4：星期
                                        5：日期（年）
                                        6：月
                                        7：年
                                        
            time    时间值。根据类型不同，时间值的范围也不同。
**出口参数：0 :参数错误
**          1 :操作成功  
**说明：
********************************************************************************************************/
extern uint8 SetAlarmTime(uint8 type, uint32 time);


/*********************************************************************************************************
**函数名称：uint8 SetCIIR(uint8 type)
**函数功能：设置计数增量中断类型
**入口参数：type    增量中断类型。按位操作:
                    bit0：1 使能秒增量中断    	    0  禁止
                    bit1：1 使能分增量中断  	    0  禁止
                    bit2：1 使能时增量中断          0  禁止                                
                    bit3：1 使能日期（月）增量中断  0  禁止
                    bit4：1 使能星期增量中断	    0  禁止
                    bit5：1 使能日期（年）增量中断  0  禁止
                    bit6：1 使能月增量中断		    0  禁止
                    bit7：1 使能年增量中断          0  禁止
**出口参数：0 :参数错误
**          1 :操作成功  
**说明：
********************************************************************************************************/
extern uint8 SetCIIR(uint8 type);


/*********************************************************************************************************
**函数名称：uint8 IsIncInt(void)
**函数功能：判断是否增量中断产生
**入口参数：无
**出口参数：0 :无增量中断产生
**          1 :有增量中断产生  
**说明：
********************************************************************************************************/
extern uint8 IsIncInt(void);


/*********************************************************************************************************
**函数名称：void CleanIncInt(void)
**函数功能：清零增量中断标志
**入口参数：无
**出口参数：无  
**说明：
********************************************************************************************************/
extern void CleanIncInt(void);


/*********************************************************************************************************
**函数名称：uint8 IsAlarmInt(void)
**函数功能：判断是否报警中断产生
**入口参数：无
**出口参数：0 :无报警中断产生
**          1 :有报警中断产生  
**说明：
********************************************************************************************************/
extern uint8 IsAlarmInt(void);


/*********************************************************************************************************
**函数名称：void CleanAlarmInt(void)
**函数功能：清零报警中断标志
**入口参数：无
**出口参数：无  
**说明：
********************************************************************************************************/
extern void CleanAlarmInt(void);