1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
|
/*---------------------------------------------------------------------------------
ARM7 realtime clock
Copyright (C) 2005
Michael Noland (joat)
Jason Rogers (dovoto)
Dave Murphy (WinterMute)
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any
damages arising from the use of this software.
Permission is granted to anyone to use this software for any
purpose, including commercial applications, and to alter it and
redistribute it freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you
must not claim that you wrote the original software. If you use
this software in a product, an acknowledgment in the product
documentation would be appreciated but is not required.
2. Altered source versions must be plainly marked as such, and
must not be misrepresented as being the original software.
3. This notice may not be removed or altered from any source
distribution.
---------------------------------------------------------------------------------*/
#ifndef ARM7_CLOCK_INCLUDE
#define ARM7_CLOCK_INCLUDE
#ifndef ARM7
#error The clock is only available on the ARM7
#endif
#ifdef __cplusplus
extern "C" {
#endif
#include <nds/arm7/serial.h>
// RTC registers
#define WRITE_STATUS_REG1 0x60
#define READ_STATUS_REG1 0x61
/*
Status Register 1
0 W Reset (0=Normal, 1=Reset)
1 R/W 12/24 hour mode (0=12 hour, 1=24 hour)
2-3 R/W General purpose bits
4 R Interrupt 1 Flag (1=Yes) ;auto-cleared on read
5 R Interrupt 2 Flag (1=Yes) ;auto-cleared on read
6 R Power Low Flag (0=Normal, 1=Power is/was low) ;auto-cleared on read
7 R Power Off Flag (0=Normal, 1=Power was off) ;auto-cleared on read
Power off indicates that the battery was removed or fully discharged,
all registers are reset to 00h (or 01h), and must be re-initialized.
*/
#define STATUS_POC (1<<7) // read-only, cleared by reading (1 if just powered on)
#define STATUS_BLD (1<<6) // read-only, cleared by reading (1 if power dropped below the safety threshold)
#define STATUS_INT2 (1<<5) // read-only, INT2 has occured
#define STATUS_INT1 (1<<4) // read-only, INT1 has occured
#define STATUS_SC1 (1<<3) // R/W scratch bit
#define STATUS_SC0 (1<<2) // R/W scratch bit
#define STATUS_24HRS (1<<1) // 24 hour mode when 1, 12 hour mode when 0
#define STATUS_RESET (1<<0) // write-only, reset when 1 written
#define WRITE_STATUS_REG2 0x62
#define READ_STATUS_REG2 0x63
/*
Status Register 2
0-3 R/W INT1 Mode/Enable
0000b Disable
0x01b Selected Frequency steady interrupt
0x10b Per-minute edge interrupt
0011b Per-minute steady interrupt 1 (duty 30.0 secomds)
0100b Alarm 1 interrupt
0111b Per-minute steady interrupt 2 (duty 0.0079 secomds)
1xxxb 32kHz output
4-5 R/W General purpose bits
6 R/W INT2 Enable
0b Disable
1b Alarm 2 interrupt
7 R/W Test Mode (0=Normal, 1=Test, don't use) (cleared on Reset)
*/
#define STATUS_TEST (1<<7) //
#define STATUS_INT2AE (1<<6) //
#define STATUS_SC3 (1<<5) // R/W scratch bit
#define STATUS_SC2 (1<<4) // R/W scratch bit
#define STATUS_32kE (1<<3) // Interrupt mode bits
#define STATUS_INT1AE (1<<2) //
#define STATUS_INT1ME (1<<1) //
#define STATUS_INT1FE (1<<0) //
// full 7 bytes for time and date
#define WRITE_TIME_AND_DATE 0x64
#define READ_TIME_AND_DATE 0x65
// last 3 bytes of current time
#define WRITE_TIME 0x66
#define READ_TIME 0x67
#define WRITE_INT_REG1 0x68
#define READ_INT_REG1 0x69
#define READ_INT_REG2 0x6A
#define WRITE_INT_REG2 0x6B
#define READ_CLOCK_ADJUST_REG 0x6C
#define WRITE_CLOCK_ADJUST_REG 0x6D
// clock-adjustment register
#define READ_FREE_REG 0x6E
#define WRITE_FREE_REG 0x6F
void rtcReset(void);
void rtcTransaction(uint8 * command, uint32 commandLength, uint8 * result, uint32 resultLength);
void rtcGetTime(uint8 * time);
void rtcSetTime(uint8 * time);
void rtcGetTimeAndDate(uint8 * time);
void rtcSetTimeAndDate(uint8 * time);
void rtcGetData(uint8 * data, uint32 size);
void BCDToInteger(uint8 * data, uint32 length);
void integerToBCD(uint8 * data, uint32 length);
void initClockIRQ(void);
#ifdef __cplusplus
}
#endif
#endif
|
