DS1307RTC时钟模块

DS1307是I2C实时时钟芯片(RTC)，它是一款低功耗，具有56字节非失性RAM的全BCD码时钟日历实时时钟芯片，地址和数据通过两线双向的串行总线的传输，芯片可以提供秒，分，小时等信息，每一个月的天数能自动调整。并且有闰年补偿功能。AM/PM 标志位决定时钟工作于24小时或12小时模式，芯片有一个内置的电源感应电路，具有掉电检测和电池切换功能。

模块来源

采购链接：
https://item.taobao.com/item.htm?spm=a1z10.3-c-s.w4002-24706531953.10.2b4a6a4bH7IysA&id=522553351753

资料下载链接：
https://pan.baidu.com/s/1BcLbfV5bCjKdAS4PL3BRnA
提取码：6uq7

规格参数

工作电压：4.5-5.5V
工作电流：1.5mA
模块尺寸：27mm28mm8.4mm
控制方式：IIC
实际使用管脚数量：4 Pin（2.54mm间距排针）

说明：带电池，具有掉电检测和电池切换功能

移植过程

我们的目标是在立创开发板GD32E230C8T6上能够实现设置时间与读取时间的功能。首先要获取资料，查看数据手册应如何实现，再移植至我们的工程。

查看资料

原理图说明

• 模块上带有两个芯片，分别是DS1307时钟芯片和AT24C32数据存储芯片，两者都是使用IIC通信，虽然使用的是同一个接口，但是其器件地址不同，因此可以同时操作。
• 模块上带有一个DS18B20数字温度传感器的接口，在模块上引出的DS引脚就是温度传感器的数据输出引脚，但是模块上并没有温度传感器，需要自行安装。
• 模块上的SQ引脚是是DS1307的方波输出引脚，通过内部寄存器控制，可以输出四个方波频率(1Hz, 4kHz, 8kHz, 32kHz)之一。需要注意的是 SQ引脚是开漏输出，需要一个外部上拉电阻。

相关读写步骤说明

我们主要实现的是时间的读取和时间的设置。关于IIC原理，这里不再进行说明，请自行查阅。

读时序：发送IIC起始信号->发送器件地址+0->等待模块应答->应答后发送寄存器地址->等待模块应答->应答后重新发送起始信号->发送器件地址+1->等待模块应答->读取数据->读取完毕主机发送非应答信号->发送IIC停止信号。

写时序： 发送IIC起始信号->发送器件地址+0->等待模块应答->应答后发送寄存器地址->等待模块应答->应答后发送数据->发送完毕等待模块应答->发送IIC停止信号。

相关寄存器说明

通过读取适当的寄存器字节来获得时间和日历信息。下图显示了RTC寄存器。时间和日历通过写入适当的寄存器字节来设置或初始化。时间寄存器和日历寄存器的内容采用BCD格式。与星期几对应的值是用户自定义的，但必须是连续的(例如，如果1等于星期日，那么2等于星期一，等等)。不合逻辑的时间和日期条目将导致未定义的操作。 寄存器00h的第7位(BIT 7)是时钟停止(CH)位。当这个位被设置为1时，振荡器被禁用。当清除到0时，振荡器被启用。

第一次给设备上电时，时间和日期寄存器通常重置为01/01/00 01 00:00:00 (MM/DD/YY DOW HH:MM:SS)。秒寄存器中的CH位将被设置为1。当不需要计时功能时，可以暂停时钟(给CH置1)，从而最小化输出电流。

示例：例如设置时间为 2023-4-7 - 星期5 -13:57:00

//add写入寄存器地址 dat写入数据
uint8_t Write1307(uint8_t add, uint8_t dat)
{
        unsigned char temp;

        /* 10进制转BCD码 */
        temp=dat/10;
        temp<<=4;
        temp=dat%10+temp;

        IIC_Start();//发送起始
        IIC_Write(0xD0); //发送器件地址0xD0

        //如果未应答
        if( IIC_Wait_Ack() == 1 )
        {
              return 1;
        }

        IIC_Write(add); //发送寄存器地址

        //如果未应答
        if( IIC_Wait_Ack() == 1 )
        {
              return 2;
        }
        IIC_Write(temp); //发送数据
        IIC_Wait_Ack();//等待应答
        IIC_Stop(); //发送停止信号
        return (0);
}

Write1307(0x00,0); //设置秒
Write1307(0x01,57); //设置分
Write1307(0x02,13); //设置时
Write1307(0x03,5); //设置周
Write1307(0x04,7); //设置日
Write1307(0x05,4); //设置月
Write1307(0x06,23); //设置年

引脚选择

移植至工程

移植步骤中的导入.c和.h文件与上一节相同，只是将.c和.h文件更改为bsp_ds1307.c与bsp_ds1307.h。移植完成后面修改相关代码。

详细可见【TTP224触摸传感器】中的移植至工程目录。这里不再过多讲述。移植完成后面修改相关代码。

工程参考入门手册工程模板

在文件bsp_ds1307.c中，编写如下代码。

 /******************************************************************************
   * 测试硬件：立创开发板·GD32E230C8T6    使用主频72Mhz    晶振8Mhz
   * 版 本 号: V1.0
   * 修改作者: www.lckfb.com
   * 修改日期: 2023年11月02日
   * 功能介绍:
   *****************************************************************************
   * 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
   * 开发板官网：www.lckfb.com
   * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
   * 立创论坛：club.szlcsc.com
   * 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
   * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/

#include "bsp_ds1307.h"
#include "systick.h"
#include "stdio.h"

//时间数据结构体
_time_struct_ RTC_Time;

/******************************************************************
 * 函 数 名 称：DS1307_GPIO_Init
 * 函 数 说 明：对IIC引脚初始化
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：必须开漏输出，因DS1307是5V，而GD32是3.3V
******************************************************************/
void DS1307_GPIO_Init(void)
{
        //打开SDA与SCL的引脚时钟
        rcu_periph_clock_enable(RCU_SCL);
        rcu_periph_clock_enable(RCU_SDA);

        //设置SCL引脚模式为上拉输出
        gpio_mode_set(PORT_SCL, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_SCL);
        //设置引脚为开漏模式，翻转速度2MHz
        gpio_output_options_set(PORT_SCL, GPIO_OTYPE_OD, GPIO_OSPEED_2MHZ, GPIO_SCL);
        //设置引脚输出高电平SCL等待信号
        gpio_bit_write(PORT_SCL, GPIO_SCL, SET);

        //设置SDA引脚
        gpio_mode_set(PORT_SDA, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_SDA);
        gpio_output_options_set(PORT_SDA, GPIO_OTYPE_OD, GPIO_OSPEED_2MHZ, GPIO_SDA);
        gpio_bit_write(PORT_SDA, GPIO_SDA, SET);
}



//
/******************************************************************
 * 函 数 名 称：IIC_Start
 * 函 数 说 明：IIC起始信号
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void IIC_Start(void)
{
        SDA_OUT();

        SDA(1);
        delay_1us(5);
        SCL(1);
        delay_1us(5);

        SDA(0);
        delay_1us(5);
        SCL(0);
        delay_1us(5);

}
/******************************************************************
 * 函 数 名 称：IIC_Stop
 * 函 数 说 明：IIC停止信号
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void IIC_Stop(void)
{
        SDA_OUT();
        SCL(0);
        SDA(0);

        SCL(1);
        delay_1us(5);
        SDA(1);
        delay_1us(5);

}
/******************************************************************
 * 函 数 名 称：IIC_Send_Ack
 * 函 数 说 明：主机发送应答
 * 函 数 形 参：0应答  1非应答
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void IIC_Send_Ack(unsigned char ack)
{
        SDA_OUT();
        SCL(0);
        SDA(0);
        delay_1us(5);
        if(!ack) SDA(0);
        else         SDA(1);
        SCL(1);
        delay_1us(5);
        SCL(0);
        SDA(1);
}
/******************************************************************
 * 函 数 名 称：IIC_Wait_Ack
 * 函 数 说 明：等待从机应答
 * 函 数 形 参：无
 * 函 数 返 回：1=无应答   0=有应答
 * 作       者：LC
 * 备       注：无
******************************************************************/

unsigned char IIC_Wait_Ack(void)
{

        char ack = 0;
        unsigned char ack_flag = 10;
        SDA_IN();
                SDA(1);
        delay_1us(5);
        SCL(1);
        delay_1us(5);
        while( (GETSDA()==1) && ( ack_flag ) )
        {
                ack_flag--;
                delay_1us(5);
        }

        if( ack_flag <= 0 )
        {
                IIC_Stop();
                return 1;
        }
        else
        {
                SCL(0);
                SDA_OUT();
        }
        return ack;
}
/******************************************************************
 * 函 数 名 称：IIC_Write
 * 函 数 说 明：IIC写一个字节
 * 函 数 形 参：dat写入的数据
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void IIC_Write(unsigned char dat)
{
        int i = 0;
        SDA_OUT();
        SCL(0);//拉低时钟开始数据传输

        for( i = 0; i < 8; i++ )
        {
                        SDA( (dat & 0x80) >> 7 );
                        delay_1us(2);
                        dat<<=1;
                        delay_1us(6);
                        SCL(1);
                        delay_1us(4);
                        SCL(0);
                        delay_1us(4);

        }
}

/******************************************************************
 * 函 数 名 称：IIC_Read
 * 函 数 说 明：IIC读1个字节
 * 函 数 形 参：无
 * 函 数 返 回：读出的1个字节数据
 * 作       者：LC
 * 备       注：无
******************************************************************/
unsigned char IIC_Read(void)
{
        unsigned char i,receive=0;
    SDA_IN();//SDA设置为输入
    for(i=0;i<8;i++ )
        {
        SCL(0);
        delay_1us(5);
        SCL(1);
        delay_1us(5);
        receive<<=1;
        if( GETSDA() )
        {
            receive|=1;
        }
        delay_1us(5);
    }
  return receive;
}

/******************************************************************
 * 函 数 名 称：Write1307
 * 函 数 说 明：向DS1307的add地址写入dat数据
 * 函 数 形 参：add写入寄存器地址    dat写入数据
 * 函 数 返 回：0写入成功    1写入器件地址无应答      2写入寄存器地址无应答
 * 作       者：LC
 * 备       注：器件地址=0xD0
******************************************************************/
unsigned char Write1307(unsigned char add,unsigned char dat)
{
        unsigned char temp;

        /* 10进制转BCD码 */
        temp=dat/10;
        temp<<=4;
        temp=dat%10+temp;

        IIC_Start();
        IIC_Write(0xD0);
        if( IIC_Wait_Ack() == 1 )
        {
           return 1;
        }
        IIC_Write(add);
        if( IIC_Wait_Ack() == 1 )
        {
          return 2;
        }
        IIC_Write(temp);
        IIC_Wait_Ack();//必须加，必须严格按照时序
        IIC_Stop();
        return (0);
}

/******************************************************************
 * 函 数 名 称：Read1307
 * 函 数 说 明：读取DS1307的时间数据
 * 函 数 形 参：add读取的寄存器地址
 * 函 数 返 回：255-读取失败  其他-读取成功
 * 作       者：LC
 * 备       注：无
******************************************************************/
unsigned char Read1307(unsigned char add)
{
        int i =0;
        unsigned char temp;
        unsigned char dat;
        IIC_Start();
        IIC_Write(0xD0);
        if( IIC_Wait_Ack() == 1 ) return 255;
        IIC_Write(add);
        if( IIC_Wait_Ack() == 1 ) return 255;
        do
        {
        //超时判断
        i++;
        if( i > 20 ) return 255;
        delay_1ms(1);

        IIC_Start();
        IIC_Write(0xD1);//读

        }while(IIC_Wait_Ack() == 1);        //读取到温湿度数据则结束读命令

        dat=IIC_Read();
        IIC_Send_Ack(1);//非应答
        IIC_Stop();

        /* BCD码转19进制 */
        temp=dat/16;
        dat=dat%16;
        dat=dat+temp*10;

        return(dat);
}


/******************************************************************
 * 函 数 名 称：get_RTC_time
 * 函 数 说 明：获取DS1307的时间
 * 函 数 形 参：无
 * 函 数 返 回：无
 * 作       者：LC
 * 备       注：无
******************************************************************/
void Get_RTC_Time(void)
{
    RTC_Time.sec     = Read1307(0x00);
    RTC_Time.min     = Read1307(0x01);
    RTC_Time.hour    = Read1307(0x02);
    RTC_Time.week    = Read1307(0x03);
    RTC_Time.date    = Read1307(0x04);
    RTC_Time.month   = Read1307(0x05);
    RTC_Time.year    = Read1307(0x06);
}
/******************************************************************
 * 函 数 名 称：set_RTC_time
 * 函 数 说 明：设置RTC时间
 * 函 数 形 参：year=年份      范围00-99(年数后两位)
 *              month=月份     范围01-12
 *              date=日期      范围01-31
 *              week=星期      范围01-07
 *              hour=小时      范围01-12 or 00-23
 *              min =分钟      范围00-59
 *              sec =秒数      范围00-59
 * 函 数 返 回：
 * 作       者：LC
 * 备       注：例如设置时间  2023-4-7 - 星期5 -13:57:00
 *              set_RTC_time(23, 4, 7, 5, 13，57, 0)
******************************************************************/
void Set_RTC_Time(uint8_t year,uint8_t month,uint8_t date,uint8_t week,uint8_t hour,uint8_t min,uint8_t sec)
{
    Write1307(0x00,sec);    //设置秒
    Write1307(0x01,min);    //设置分
    Write1307(0x02,hour);   //设置时
    Write1307(0x03,week);   //设置周
    Write1307(0x04,date);   //设置日
    Write1307(0x05,month);  //设置月
    Write1307(0x06,year);   //设置年
}

在文件bsp_ds1307.h中，编写如下代码。

 /******************************************************************************
   * 测试硬件：立创开发板·GD32E230C8T6    使用主频72Mhz    晶振8Mhz
   * 版 本 号: V1.0
   * 修改作者: www.lckfb.com
   * 修改日期: 2023年11月02日
   * 功能介绍:
   *****************************************************************************
   * 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
   * 开发板官网：www.lckfb.com
   * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
   * 立创论坛：club.szlcsc.com
   * 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
   * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/

#ifndef _BSP_DS1307_H_
#define _BSP_DS1307_H_

#include "gd32e23x.h"


#define RCU_SCL  RCU_GPIOA
#define PORT_SCL GPIOA
#define GPIO_SCL GPIO_PIN_1

#define RCU_SDA  RCU_GPIOA
#define PORT_SDA GPIOA
#define GPIO_SDA GPIO_PIN_2


#define SDA_IN()  {gpio_mode_set(PORT_SDA, GPIO_MODE_INPUT,  GPIO_PUPD_PULLUP, GPIO_SDA);}  //SDA输入模式
#define SDA_OUT() {gpio_mode_set(PORT_SDA, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_SDA);}  //SDA输出模式

#define SCL(BIT)  gpio_bit_write( PORT_SCL, GPIO_SCL, BIT?SET:RESET)
#define SDA(BIT)  gpio_bit_write( PORT_SDA, GPIO_SDA, BIT?SET:RESET)
#define GETSDA()  gpio_input_bit_get( PORT_SDA, GPIO_SDA)


typedef struct _RTC_TIME_STRUCT_ {
    unsigned char sec;
    unsigned char min;
    unsigned char hour;
    unsigned char week;
    unsigned char date;
    unsigned char month;
    unsigned char year;
}_time_struct_;

extern _time_struct_ RTC_Time;




void DS1307_GPIO_Init(void);//引脚初始化
unsigned char Write1307(unsigned char add,unsigned char dat);//写入一个字节
unsigned char Read1307(unsigned char add);//读取一个字节
void Set_RTC_Time(uint8_t year,uint8_t month,uint8_t date,uint8_t week,uint8_t hour,uint8_t min,uint8_t sec);//设置初始时间
void Get_RTC_Time(void);//获取RTC时间

#endif

移植验证

在自己工程中的main主函数中，编写如下。

 /******************************************************************************
   * 测试硬件：立创开发板·GD32E230C8T6    使用主频72Mhz    晶振8Mhz
   * 版 本 号: V1.0
   * 修改作者: www.lckfb.com
   * 修改日期: 2023年11月02日
   * 功能介绍:
   *****************************************************************************
   * 梁山派软硬件资料与相关扩展板软硬件资料官网全部开源
   * 开发板官网：www.lckfb.com
   * 技术支持常驻论坛，任何技术问题欢迎随时交流学习
   * 立创论坛：club.szlcsc.com
   * 其余模块移植手册：【立创·GD32E230C8T6开发板】模块移植手册
   * 关注bilibili账号：【立创开发板】，掌握我们的最新动态！
   * 不靠卖板赚钱，以培养中国工程师为己任
  ******************************************************************************/
#include "gd32e23x.h"
#include "systick.h"
#include "bsp_usart.h"
#include "stdio.h"
#include "bsp_ds1307.h"

int main(void)
{
        systick_config();                //滴答定时器初始化 1ms
        usart_gpio_config(115200U);
        DS1307_GPIO_Init();
        Set_RTC_Time(23, 11, 14, 2, 16, 46, 8);  //第一次上电设置时间才使用
        printf("RTC demo start\r\n");

        while(1)
        {
                Get_RTC_Time();//获取时间
                printf("%d-%d-%d-星期%d\r\n", RTC_Time.year,RTC_Time.month,RTC_Time.date,RTC_Time.week);
                printf("%d:%d:%d\r\n",RTC_Time.hour,RTC_Time.min,RTC_Time.sec);
                delay_1ms(1000);
        }
}

移植现象：串口输出年月日周时分秒的时间。

文件下载

📌 资料下载中心（点击跳转）

📌 在 资料下载中心->【模块移植手册资料下载】 里面的本章节压缩包中。