STM32使用HAL库驱动DS3231

1、STM32通讯口配置

启动IIC，默认配置即可。

2、头文件

#ifndef __DS3231_H
#define __DS3231_H

#include "main.h"

#define DS3231_COM_PORT hi2c1	/*通讯端口*/

/**************************** defines *******************************/
#define DS3231_ADDR			0xd0 /* DS3231 slave address (write) */

#define DS3231_SEC			0x00 //秒
#define DS3231_MIN			0x01 //分
#define DS3231_HOUR			0x02 //时
#define DS3231_DAY			0x03 //星期
#define DS3231_DATE			0x04 //日
#define DS3231_MONTH		0x05 //月
#define DS3231_YEAR			0x06 //年
//闹铃1
#define DS3231_Al1SEC		0x07 //秒
#define DS3231_AL1MIN		0x08 //分
#define DS3231_AL1HOUR		0x09 //时
#define DS3231_AL1DAY		0x0A //星期/日
//闹铃2
#define DS3231_AL2MIN		0x0b    //分
#define DS3231_AL2HOUR		0x0c    //时
#define DS3231_AL2DAY		0x0d    //星期/日
#define DS3231_CONTROL		0x0e    //控制寄存器
#define DS3231_STATUS		0x0f    //状态寄存器

#define BSY             2       //忙
#define OSF             7       //振荡器停止标志
#define DS3231_XTAL     0x10    //晶体老化寄存器
#define DS3231_TEMP_H   0x11    //温度寄存器高字节(8位)
#define DS3231_TEMP_L   0x12    //温度寄存器低字节(高2位)  

typedef struct
{
	uint8_t ucYear;
	uint8_t ucMonth;
	uint8_t ucDay;
	uint8_t ucWeek;
	uint8_t ucHour;
	uint8_t ucMinute;
	uint8_t ucSecond;
	float fTemp;
}timeType_T;

/*阴历日期*/
typedef struct
{
	uint8_t ucMonth;
	uint8_t ucDay;	
	uint8_t ucLeapMonth;/*润月标志*/
}lunarTimeType_T;


void DS3231_Init(void);								/*初始化*/
timeType_T DS3231_Readtime(void);					/*读取时间*/
void DS3231_SetTime(timeType_T _tTime);				/*设置时间*/
lunarTimeType_T Conver2Lunar(timeType_T _tTime);	/*公历转农历*/

#endif


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

3、C文件

#include "ds3231.h"
#include "i2c.h"

uint8_t BCD2HEX(uint8_t val);
uint8_t B_BCD(uint8_t val);


const unsigned int LunarCalendarTable[199] =
{
    0x04AE53,0x0A5748,0x5526BD,0x0D2650,0x0D9544,0x46AAB9,0x056A4D,0x09AD42,0x24AEB6,0x04AE4A,/*1901-1910*/
    0x6A4DBE,0x0A4D52,0x0D2546,0x5D52BA,0x0B544E,0x0D6A43,0x296D37,0x095B4B,0x749BC1,0x049754,/*1911-1920*/
    0x0A4B48,0x5B25BC,0x06A550,0x06D445,0x4ADAB8,0x02B64D,0x095742,0x2497B7,0x04974A,0x664B3E,/*1921-1930*/
    0x0D4A51,0x0EA546,0x56D4BA,0x05AD4E,0x02B644,0x393738,0x092E4B,0x7C96BF,0x0C9553,0x0D4A48,/*1931-1940*/
    0x6DA53B,0x0B554F,0x056A45,0x4AADB9,0x025D4D,0x092D42,0x2C95B6,0x0A954A,0x7B4ABD,0x06CA51,/*1941-1950*/
    0x0B5546,0x555ABB,0x04DA4E,0x0A5B43,0x352BB8,0x052B4C,0x8A953F,0x0E9552,0x06AA48,0x6AD53C,/*1951-1960*/
    0x0AB54F,0x04B645,0x4A5739,0x0A574D,0x052642,0x3E9335,0x0D9549,0x75AABE,0x056A51,0x096D46,/*1961-1970*/
    0x54AEBB,0x04AD4F,0x0A4D43,0x4D26B7,0x0D254B,0x8D52BF,0x0B5452,0x0B6A47,0x696D3C,0x095B50,/*1971-1980*/
    0x049B45,0x4A4BB9,0x0A4B4D,0xAB25C2,0x06A554,0x06D449,0x6ADA3D,0x0AB651,0x093746,0x5497BB,/*1981-1990*/
    0x04974F,0x064B44,0x36A537,0x0EA54A,0x86B2BF,0x05AC53,0x0AB647,0x5936BC,0x092E50,0x0C9645,/*1991-2000*/
    0x4D4AB8,0x0D4A4C,0x0DA541,0x25AAB6,0x056A49,0x7AADBD,0x025D52,0x092D47,0x5C95BA,0x0A954E,/*2001-2010*/
    0x0B4A43,0x4B5537,0x0AD54A,0x955ABF,0x04BA53,0x0A5B48,0x652BBC,0x052B50,0x0A9345,0x474AB9,/*2011-2020*/
    0x06AA4C,0x0AD541,0x24DAB6,0x04B64A,0x69573D,0x0A4E51,0x0D2646,0x5E933A,0x0D534D,0x05AA43,/*2021-2030*/
    0x36B537,0x096D4B,0xB4AEBF,0x04AD53,0x0A4D48,0x6D25BC,0x0D254F,0x0D5244,0x5DAA38,0x0B5A4C,/*2031-2040*/
    0x056D41,0x24ADB6,0x049B4A,0x7A4BBE,0x0A4B51,0x0AA546,0x5B52BA,0x06D24E,0x0ADA42,0x355B37,/*2041-2050*/
    0x09374B,0x8497C1,0x049753,0x064B48,0x66A53C,0x0EA54F,0x06B244,0x4AB638,0x0AAE4C,0x092E42,/*2051-2060*/
    0x3C9735,0x0C9649,0x7D4ABD,0x0D4A51,0x0DA545,0x55AABA,0x056A4E,0x0A6D43,0x452EB7,0x052D4B,/*2061-2070*/
    0x8A95BF,0x0A9553,0x0B4A47,0x6B553B,0x0AD54F,0x055A45,0x4A5D38,0x0A5B4C,0x052B42,0x3A93B6,/*2071-2080*/
    0x069349,0x7729BD,0x06AA51,0x0AD546,0x54DABA,0x04B64E,0x0A5743,0x452738,0x0D264A,0x8E933E,/*2081-2090*/
    0x0D5252,0x0DAA47,0x66B53B,0x056D4F,0x04AE45,0x4A4EB9,0x0A4D4C,0x0D1541,0x2D92B5          /*2091-2099*/
};

const unsigned int  MonthAdd[12] = {0,31,59,90,120,151,181,212,243,273,304,334};

/*****************************************************************************
* 说明：转换公历到阴历
* 输入：无
* 输出：阴历，包含月，日，闰月标志
*****************************************************************************/
lunarTimeType_T Conver2Lunar(timeType_T _tTime)
{
	lunarTimeType_T tLunarTime;
	unsigned int LunarCalendarDay;
	int year = _tTime.ucYear+2000,month = _tTime.ucMonth,day = _tTime.ucDay;
    int Spring_NY,Sun_NY,StaticDayCount;
    int index,flag;
    //Spring_NY 记录春节离当年元旦的天数。
    //Sun_NY 记录阳历日离当年元旦的天数。
    if ( ((LunarCalendarTable[year-1901] & 0x0060) >> 5) == 1)
        Spring_NY = (LunarCalendarTable[year-1901] & 0x001F) - 1;
    else
        Spring_NY = (LunarCalendarTable[year-1901] & 0x001F) - 1 + 31;
    Sun_NY = MonthAdd[month-1] + day - 1;
    if ( (!(year % 4)) && (month > 2))
        Sun_NY++;
    //StaticDayCount记录大小月的天数 29 或30
    //index 记录从哪个月开始来计算。
    //flag 是用来对闰月的特殊处理。
    //判断阳历日在春节前还是春节后
    if (Sun_NY >= Spring_NY)//阳历日在春节后（含春节那天）
    {
        Sun_NY -= Spring_NY;
        month = 1;
        index = 1;
        flag = 0;
        if ( ( LunarCalendarTable[year - 1901] & (0x80000 >> (index-1)) ) ==0)
            StaticDayCount = 29;
        else
            StaticDayCount = 30;
        while (Sun_NY >= StaticDayCount)
        {
            Sun_NY -= StaticDayCount;
            index++;
            if (month == ((LunarCalendarTable[year - 1901] & 0xF00000) >> 20) )
            {
                flag = ~flag;
                if (flag == 0)
                    month++;
            }
            else
                month++;
            if ( ( LunarCalendarTable[year - 1901] & (0x80000 >> (index-1)) ) ==0)
                StaticDayCount=29;
            else
                StaticDayCount=30;
        }
        day = Sun_NY + 1;
    }
    else //阳历日在春节前
    {
        Spring_NY -= Sun_NY;
        year--;
        month = 12;
        if ( ((LunarCalendarTable[year - 1901] & 0xF00000) >> 20) == 0)
            index = 12;
        else
            index = 13;
        flag = 0;
        if ( ( LunarCalendarTable[year - 1901] & (0x80000 >> (index-1)) ) ==0)
            StaticDayCount = 29;
        else
            StaticDayCount = 30;
        while (Spring_NY > StaticDayCount)
        {
            Spring_NY -= StaticDayCount;
            index--;
            if (flag == 0)
                month--;
            if (month == ((LunarCalendarTable[year - 1901] & 0xF00000) >> 20))
                flag = ~flag;
            if ( ( LunarCalendarTable[year - 1901] & (0x80000 >> (index-1)) ) ==0)
                StaticDayCount = 29;
            else
                StaticDayCount = 30;
        }
        day = StaticDayCount - Spring_NY + 1;
    }
    LunarCalendarDay |= day;
    LunarCalendarDay |= (month << 6);
    if (month == ((LunarCalendarTable[year - 1901] & 0xF00000) >> 20))
        tLunarTime.ucLeapMonth = 1;
    else
        tLunarTime.ucLeapMonth = 0;
	tLunarTime.ucDay = day;
	tLunarTime.ucMonth = month;
	return tLunarTime;
}




//-------------------------------------------------------------------
/*****************************************************************************
* 说明：写一个字节
* 输入：无
* 输出：无
*****************************************************************************/
void DS3231_WriteOneByte(unsigned char Waddr,unsigned char Data)
{
	HAL_I2C_Mem_Write(&DS3231_COM_PORT,DS3231_ADDR,Waddr,I2C_MEMADD_SIZE_8BIT,&Data,1,10);
}
//-------------------------------------------------------------------
/*****************************************************************************
* 说明：读一个字节
* 输入：无
* 输出：无
*****************************************************************************/
unsigned char DS3231_ReadOneByte(unsigned char Waddr)
{
	uint8_t dat;
	HAL_I2C_Mem_Read(&DS3231_COM_PORT,DS3231_ADDR,Waddr,I2C_MEMADD_SIZE_8BIT,&dat,1,10);
	return dat;
}

/*****************************************************************************
* 说明：初始化
* 输入：无
* 输出：无
*****************************************************************************/
void DS3231_Init()
{
    DS3231_WriteOneByte(DS3231_AL1DAY,0x81);    //A1M4置位，时分秒匹配时闹钟响应
    DS3231_WriteOneByte(DS3231_AL2DAY,0x81);    //A2M4置位，时分匹配时闹钟响应
    DS3231_WriteOneByte(DS3231_CONTROL,0x04);    //中断允许，闹钟1和2关闭
    DS3231_WriteOneByte(DS3231_STATUS,0x00);    //32KHZ输出禁止，闹钟标志位清零
}
//
uint8_t BCD2HEX(uint8_t val) //BCD转换为Byte
{
    return    ((val>>4)*10)+(val&0x0f);
}

uint8_t B_BCD(uint8_t val)//Byte码转换为BCD码
{
    return    (((val%100)/10)<<4)|(val%10);
}
//
//
///***********将一个字节写入DS3231指定的地址***********/
//void DS3231_WriteOneByte(uint8_t addr,uint8_t dat)
//{
    HAL_I2C_Mem_Write(&hi2c1,ADDRTC,addr,I2C_MEMADD_SIZE_8BIT,&dat,1,100);
//}

/************从DS3231指定地址读一个字节************/
//uint8_t DS3231_ReadOneByte(uint8_t addr)
//{
//    uint8_t dat;
    HAL_I2C_Mem_Read(&hi2c1,ADDRTC,addr,I2C_MEMADD_SIZE_8BIT,&dat,1,100);
//    return dat;
//}
//
/*****************************************************************************
* 说明：设置时间，年份为00-99，
* 输入：年月日，星期，时分秒
* 输出：无
*****************************************************************************/
void DS3231_SetTime(timeType_T date)
{
    uint8_t tmp;
    tmp=B_BCD(date.ucYear);
    DS3231_WriteOneByte(DS3231_YEAR,tmp);
    tmp=B_BCD(date.ucMonth);
    DS3231_WriteOneByte(DS3231_MONTH,tmp);
    tmp=B_BCD(date.ucDay);
    DS3231_WriteOneByte(DS3231_DATE,tmp);
    tmp=B_BCD(date.ucWeek);
    DS3231_WriteOneByte(DS3231_DAY,tmp);
    tmp=B_BCD(date.ucHour);
    DS3231_WriteOneByte(DS3231_HOUR,tmp);
    tmp=B_BCD(date.ucMinute);
    DS3231_WriteOneByte(DS3231_MIN,tmp);
    tmp=B_BCD(date.ucSecond);
    DS3231_WriteOneByte(DS3231_SEC,tmp);
}
/*****************************************************************************
* 说明：读取时间
* 输入：无
* 输出：其中年份为00-99，温度为浮点数
*****************************************************************************/
timeType_T DS3231_Readtime(void)
{
    uint8_t tmp;
	int8_t temp0,temp1;
	
    timeType_T date;

    tmp=DS3231_ReadOneByte(DS3231_SEC);//秒
    date.ucSecond=(int)BCD2HEX(tmp);
    //sec=2;
    tmp=DS3231_ReadOneByte(DS3231_MIN);//分
    date.ucMinute=BCD2HEX(tmp);
    tmp=DS3231_ReadOneByte(DS3231_HOUR);  //时
    //temp&=0x3F;
    date.ucHour=BCD2HEX(tmp);
    date.ucWeek=DS3231_ReadOneByte(DS3231_DAY);//星期
    tmp=DS3231_ReadOneByte(DS3231_DATE);  //日
    date.ucDay=BCD2HEX(tmp);
    tmp=DS3231_ReadOneByte(DS3231_MONTH); //月
    date.ucMonth=BCD2HEX(tmp);
    tmp=DS3231_ReadOneByte(DS3231_YEAR);  //年
    date.ucYear=BCD2HEX(tmp);
	
	/*温度存储格式
	DS3231_TEMP_H（0x11，整数部分）
	BIT7	BIT6	BIT5	BIT4	BIT3	BIT2	BIT1	BIT0
	SIGN	DATA	DATA	DATA	DATA	DATA	DATA	DATA
	----------------------------------------------------------------
	DS3231_TEMP_L(0X12，小数部分0.25℃/bit)
	BIT7	BIT6	BIT5	BIT4	BIT3	BIT2	BIT1	BIT0
	DATA	DATA	0		0		0		0		0		0	
	----------------------------------------------------------------
	例：0x11 = 0b 0001 1001
		0x12 = 0b 0100 0000
	则表示温度为+25.25摄氏度
	*/
    temp0  = DS3231_ReadOneByte(DS3231_TEMP_H);//温度
	temp1 = DS3231_ReadOneByte(DS3231_TEMP_L);//温度
	if(temp0 < 0)/*负温度*/
	{
		date.fTemp = (float)temp0 - (temp1>>6)*0.25F;
	}
	else
	{
		date.fTemp = (float)temp0 + (temp1>>6)*0.25F;
	}

	return date ;
}
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
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268

3、注意：

芯片的年份是从00-99。里面的公历转农历代码，只需要传入00-99的年份即可，程序里面默认加了2000，如果是其他年份，请自行处理。