forked from bpg/DS3231
/
DS3231.h
108 lines (81 loc) · 3.21 KB
/
DS3231.h
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
// DS3231 Class is by Seeed Technology Inc(http://www.seeedstudio.com) and used
// in Seeeduino Stalker v2.1 for battery management(MCU power saving mode)
// & to generate timestamp for data logging. DateTime Class is a modified
// version supporting day-of-week.
// Original DateTime Class and its utility code is by Jean-Claude Wippler at JeeLabs
// http://jeelabs.net/projects/cafe/wiki/RTClib
// Released under MIT License http://opensource.org/licenses/mit-license.php
#ifndef DS3231_h
#define DS3231_h
// Changed the following to work on 1.0
//#include "WProgram.h"
#include <Arduino.h>
#include <Wire.h>
#define DS3231_ADDRESS 0x68 //I2C Slave address
/* DS3231 Registers. Refer Sec 8.2 of application manual */
#define DS3231_SEC_REG 0x00
#define DS3231_MIN_REG 0x01
#define DS3231_HOUR_REG 0x02
#define DS3231_WDAY_REG 0x03
#define DS3231_MDAY_REG 0x04
#define DS3231_MONTH_REG 0x05
#define DS3231_YEAR_REG 0x06
#define DS3231_AL1SEC_REG 0x07
#define DS3231_AL1MIN_REG 0x08
#define DS3231_AL1HOUR_REG 0x09
#define DS3231_AL1WDAY_REG 0x0A
#define DS3231_AL2MIN_REG 0x0B
#define DS3231_AL2HOUR_REG 0x0C
#define DS3231_AL2WDAY_REG 0x0D
#define DS3231_CONTROL_REG 0x0E
#define DS3231_STATUS_REG 0x0F
#define DS3231_AGING_OFFSET_REG 0x0F
#define DS3231_TMP_UP_REG 0x11
#define DS3231_TMP_LOW_REG 0x12
#define SECONDS_PER_DAY 86400L
#define SECONDS_FROM_1970_TO_2000 946684800
#define EverySecond 0x01
#define EveryMinute 0x02
#define EveryHour 0x03
// Simple general-purpose date/time class (no TZ / DST / leap second handling!)
class DateTime {
public:
DateTime (long t =0);
DateTime (uint16_t year, uint8_t month, uint8_t date, uint8_t hour, uint8_t min, uint8_t sec, uint8_t wday);
DateTime (const char* date, const char* time);
uint8_t second() const { return ss; }
uint8_t minute() const { return mm; }
uint8_t hour() const { return hh; }
uint8_t date() const { return d; }
uint8_t month() const { return m; }
uint16_t year() const { return 2000 + yOff; }
uint8_t dayOfWeek() const { return wday;} /*Su=0 Mo=1 Tu=3 We=4 Th=5 Fr=6 Sa=7 */
// 32-bit times as seconds since 1/1/2000
long secondstime() const;
// 32-bit times as seconds since 1/1/1970
uint32_t unixtime(void) const;
protected:
uint8_t yOff, m, d, hh, mm, ss, wday;
};
// RTC DS3231 chip connected via I2C and uses the Wire library.
// Only 24 Hour time format is supported in this implementation
class DS3231 {
public:
uint8_t begin(void);
uint8_t readRegister(uint8_t regaddress);
void writeRegister(uint8_t regaddress, uint8_t value);
void adjust(const DateTime& dt); //Changes the date-time
static DateTime now(); //Gets the current date-time
//Decides the /INT pin's output setting
//periodicity can be any of following defines: EverySecond, EveryMinute, EveryHour
void enableAlarm(uint8_t periodicity);
void enableAlarm(uint8_t hh24, uint8_t mm,uint8_t ss);
void enableAlarm(const DateTime& dt);
void disableAlarm();
void clearAlarm();
void convertTemperature();
float getTemperature();
protected:
uint8_t intType, intPeriodicity, intHH24, intMM;
};
#endif