|
darius@60
|
1 |
/*
|
|
darius@60
|
2 |
* DS1307 headers
|
|
darius@60
|
3 |
*
|
|
darius@60
|
4 |
* Copyright (c) 2008
|
|
darius@60
|
5 |
* Daniel O'Connor <darius@dons.net.au>. All rights reserved.
|
|
darius@60
|
6 |
*
|
|
darius@60
|
7 |
* Redistribution and use in source and binary forms, with or without
|
|
darius@60
|
8 |
* modification, are permitted provided that the following conditions
|
|
darius@60
|
9 |
* are met:
|
|
darius@60
|
10 |
* 1. Redistributions of source code must retain the above copyright
|
|
darius@60
|
11 |
* notice, this list of conditions and the following disclaimer.
|
|
darius@60
|
12 |
* 2. Redistributions in binary form must reproduce the above copyright
|
|
darius@60
|
13 |
* notice, this list of conditions and the following disclaimer in the
|
|
darius@60
|
14 |
* documentation and/or other materials provided with the distribution.
|
|
darius@60
|
15 |
*
|
|
darius@60
|
16 |
* THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
darius@60
|
17 |
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
darius@60
|
18 |
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
darius@60
|
19 |
* ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
darius@60
|
20 |
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
darius@60
|
21 |
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
darius@60
|
22 |
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
darius@60
|
23 |
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
darius@60
|
24 |
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
darius@60
|
25 |
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
darius@60
|
26 |
* SUCH DAMAGE.
|
|
darius@60
|
27 |
*/
|
|
darius@60
|
28 |
|
|
darius@60
|
29 |
#define IIC_STFAIL -1
|
|
darius@60
|
30 |
#define IIC_FAILARB -2
|
|
darius@60
|
31 |
#define IIC_SLNAK -3
|
|
darius@60
|
32 |
#define IIC_NOREPLY -4
|
|
darius@60
|
33 |
#define IIC_UNKNOWN -99
|
|
darius@60
|
34 |
|
|
darius@60
|
35 |
#define DS1307_ADR 0xd0 // DS1307's TWI address
|
|
darius@60
|
36 |
|
|
darius@60
|
37 |
typedef struct {
|
|
darius@60
|
38 |
uint8_t year;
|
|
darius@60
|
39 |
uint8_t month;
|
|
darius@60
|
40 |
uint8_t day;
|
|
darius@60
|
41 |
uint8_t hour;
|
|
darius@60
|
42 |
uint8_t min;
|
|
darius@60
|
43 |
uint8_t sec;
|
|
darius@60
|
44 |
|
|
darius@60
|
45 |
uint8_t ctrl;
|
|
darius@60
|
46 |
uint8_t ram[56];
|
|
darius@60
|
47 |
} ds1307_t;
|
|
darius@60
|
48 |
|
|
darius@60
|
49 |
typedef union {
|
|
darius@60
|
50 |
uint8_t raw[8];
|
|
darius@60
|
51 |
struct {
|
|
darius@60
|
52 |
uint8_t sec : 4;
|
|
darius@60
|
53 |
uint8_t sec10 : 3; // Seconds (0-59)
|
|
darius@60
|
54 |
uint8_t ch : 1; // Clock enable (1 = off)
|
|
darius@60
|
55 |
|
|
darius@60
|
56 |
uint8_t min : 4;
|
|
darius@60
|
57 |
uint8_t min10 : 3; // Minutes (0-59)
|
|
darius@60
|
58 |
uint8_t pad0 : 1;
|
|
darius@60
|
59 |
|
|
darius@60
|
60 |
uint8_t hour : 4;
|
|
darius@60
|
61 |
uint8_t hour10 : 1; // Hours
|
|
darius@60
|
62 |
uint8_t pmam : 1; // AM/PM => 1 = PM or extra bit for hour10
|
|
darius@60
|
63 |
uint8_t s1224 : 1; // 1 = 12 hour mode
|
|
darius@60
|
64 |
uint8_t pad1 : 1;
|
|
darius@60
|
65 |
|
|
darius@60
|
66 |
uint8_t dow : 3; // Day of the week (1-7)
|
|
darius@60
|
67 |
uint8_t pad2 : 5;
|
|
darius@60
|
68 |
|
|
darius@60
|
69 |
uint8_t day : 4;
|
|
darius@60
|
70 |
uint8_t day10 : 2; // Day of the month (1-31)
|
|
darius@60
|
71 |
uint8_t pad3 : 2;
|
|
darius@60
|
72 |
|
|
darius@60
|
73 |
uint8_t month : 4;
|
|
darius@60
|
74 |
uint8_t month10 : 1;
|
|
darius@60
|
75 |
uint8_t pad4 : 3; // Month (1-12)
|
|
darius@60
|
76 |
|
|
darius@60
|
77 |
uint8_t year : 4;
|
|
darius@60
|
78 |
uint8_t year10 : 4; // Year (0-99)
|
|
darius@60
|
79 |
|
|
darius@60
|
80 |
uint8_t rs : 2; // Rate select
|
|
darius@60
|
81 |
uint8_t pad6 : 2;
|
|
darius@60
|
82 |
uint8_t sqwe : 1; // Square wave enable
|
|
darius@60
|
83 |
uint8_t pad5 : 2;
|
|
darius@60
|
84 |
uint8_t out : 1; // Output control enable
|
|
darius@60
|
85 |
} split;
|
|
darius@60
|
86 |
} ds1307raw_t;
|
|
darius@60
|
87 |
|
|
darius@60
|
88 |
int ds1307_init(void);
|
|
darius@60
|
89 |
int iic_read(uint8_t *data, uint8_t len, uint8_t adr, uint8_t sla);
|
|
darius@60
|
90 |
int iic_write(uint8_t *data, uint8_t len, uint8_t adr, uint8_t sla);
|
|
darius@60
|
91 |
int ds1307_gettod(ds1307raw_t *time);
|
|
darius@60
|
92 |
int ds1307_settod(char *date);
|
|
darius@60
|
93 |
void ds1307_printtime(char *leader, char *trailer);
|