代码收藏家 使用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
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 ;
}
3、注意：
芯片的年份是从00-99。里面的公历转农历代码，只需要传入00-99的年份即可，程序里面默认加了2000，如果是其他年份，请自行处理。
