annotate gsm-fw/include/condat/rtc.h @ 1023:cd6002e3aefb

doc/Freerunner-Howto: apparently some people still use SHR, so mention it too
author Mychaela Falconia <falcon@ivan.Harhan.ORG>
date Tue, 03 May 2016 13:48:39 +0000
parents a712c95b60c1
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
662
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
1 /*
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
2 +-----------------------------------------------------------------------------
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
3 | Project : GSM (6301)
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
4 | Modul :
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
5 +-----------------------------------------------------------------------------
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
6 | Copyright 2002 Texas Instruments Berlin, AG
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
7 | All rights reserved.
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
8 |
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
9 | This file is confidential and a trade secret of Texas
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
10 | Instruments Berlin, AG
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
11 | The receipt of or possession of this file does not convey
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
12 | any rights to reproduce or disclose its contents or to
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
13 | manufacture, use, or sell anything it may describe, in
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
14 | whole, or in part, without the specific written consent of
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
15 | Texas Instruments Berlin, AG.
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
16 +-----------------------------------------------------------------------------
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
17 | Purpose : Type definitions and function prototypes for the real time clock driver
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
18 | SPR 1725, re-wrote file for new RTC driver implementation.
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
19 +-----------------------------------------------------------------------------
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
20 */
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
21
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
22 #ifndef DEF_RTC__H
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
23 #define DEF_RTC__H
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
24 /*==== INCLUDES ===================================================*/
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
25 #include <string.h>
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
26 #include "typedefs.h"
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
27 #include "gdi.h"
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
28 #include "kbd.h"
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
29 /*==== EXPORT =====================================================*/
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
30 /*
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
31 * type definitions
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
32 */
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
33
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
34
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
35 typedef enum
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
36 {
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
37 RTC_TIME_FORMAT_12HOUR,
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
38 RTC_TIME_FORMAT_24HOUR
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
39 } T_RTC_TIME_FORMAT;
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
40
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
41 typedef struct {
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
42 UBYTE day;
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
43 UBYTE month;
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
44 USHORT year;
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
45 } T_RTC_DATE;
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
46
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
47
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
48 typedef struct
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
49 { UBYTE minute;
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
50 UBYTE hour;
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
51 UBYTE second;
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
52 T_RTC_TIME_FORMAT format;
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
53 BOOL PM_flag;
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
54 } T_RTC_TIME;
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
55
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
56 typedef void (*RtcCallback) (void*); /* RTC event handler */
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
57
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
58 /*
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
59 * Prototypes
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
60 */
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
61
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
62
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
63 BOOL rtc_clock_cleared();// wrapper for RTC_RtcReset();
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
64
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
65 UBYTE rtc_set_time_date(T_RTC_DATE* date, T_RTC_TIME* time); // wrapper for RTC_setTimeDate();
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
66
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
67 UBYTE rtc_get_time_date(T_RTC_DATE* date, T_RTC_TIME* time); // wrapper for RTC_getTimeDate();
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
68
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
69 UBYTE rtc_set_alarm(T_RTC_DATE* date , T_RTC_TIME* time, RtcCallback callback_func );//wrapper for RTC_setAlarm();
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
70
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
71 UBYTE rtc_get_alarm(T_RTC_DATE* date, T_RTC_TIME* time);//wrapper for RTC_getAlarm();
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
72
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
73 UBYTE rtc_unset_alarm();//wrapper for RTC_UnsetAlarm();
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
74
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
75 UBYTE rtc_set_time_format(T_RTC_TIME_FORMAT format);//wrapper for RTC_Set12HourMode();
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
76
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
77
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
78
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
79
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
80
a712c95b60c1 gsm-fw/include/condat: import of TI's g23m/condat/com/include
Michael Spacefalcon <msokolov@ivan.Harhan.ORG>
parents:
diff changeset
81 #endif /* #ifndef DEF_RTC_H */