基于立创GD32E230开发板的DS3231高精度RTC模块I2C驱动移植与时间管理实战

基于立创GD32E230开发板的DS3231高精度RTC模块I2C驱动移植与时间管理实战最近在做一个需要精确计时的小项目用到了DS3231这个高精度实时时钟模块。我发现很多朋友在把这类模块和国产的GD32E230开发板搭配使用时总会卡在I2C通信和驱动移植上。今天我就以立创的GD32E230C8T6开发板为例手把手带你从零开始把DS3231模块驱动起来实现时间的设置和读取。整个过程我会把原理讲透代码给全保证你跟着做一遍就能搞定。1. 认识一下我们的主角DS3231模块在动手写代码之前咱们先花几分钟了解一下DS3231到底是个啥以及为什么要用它。DS3231是一个通过I2C总线通信的高精度实时时钟芯片。说人话它就是一个特别准的电子表而且自带一个纽扣电池插座。就算你把开发板的主电源拔了它靠自带的电池也能继续走时数据一点都不会丢。这对于需要记录事件发生时间、做定时任务或者任何离不开准确时间的项目来说简直是神器。它的核心优点有几个精度高官方数据是±0.432秒/天比那种几块钱的DS1307准太多了。自带温度补偿芯片内部能感知环境温度变化并自动修正时钟的走时误差所以才能做到这么准。完全集成年、月、日、星期、时、分、秒信息全部管好连闰年都自动算好了我们直接用就行。接口简单就靠I2C两根线SDA数据线、SCL时钟线和单片机“聊天”占用引脚非常少。模块通常长这样引出了4个引脚VCC电源、GND地、SDA、SCL。工作电压很宽2.3V到5.5V都行所以和咱们3.3V的GD32E230可以直接连接不用担心电平不匹配。注意虽然DS3231是5V兼容的但为了保险起见我们在程序里会把GD32的I2C引脚配置为开漏输出模式这样即使两边电压不同也能安全通信。2. 硬件连接与工程准备2.1 连线图把模块和开发板连起来非常简单就四根线DS3231模块引脚立创GD32E230开发板引脚说明VCC3.3V电源正极GNDGND电源地SDAPA2I2C数据线SCLPA1I2C时钟线提示在提供的驱动代码中SDA和SCL默认就是用的PA2和PA1。如果你想换到其他引脚只需要修改头文件bsp_ds3231.h里的宏定义即可。2.2 创建工程文件在开始编程前我们需要在工程里新建两个文件bsp_ds3231.c存放所有DS3231的驱动函数。bsp_ds3231.h存放引脚定义、函数声明和数据结构。然后把这两个文件添加到你的MDK Keil或者你用的IDE的工程项目中。接下来咱们就一步步把代码填进去。3. 从零编写I2C底层驱动DS3231通过I2C协议通信但GD32E230的硬件I2C外设配置起来有点繁琐而且时序控制不够灵活。在实际项目里特别是调试阶段我更习惯用GPIO引脚来“模拟”I2C的时序也就是常说的“软件I2C”。这样做的好处是引脚可以任意选调试时用逻辑分析仪抓波形也一目了然哪里时序不对一眼就能看出来。3.1 引脚初始化与宏定义首先在头文件bsp_ds3231.h里我们把要用到的引脚和操作定义好。#ifndef _BSP_DS3231_H_ #define _BSP_DS3231_H_ #include gd32e23x.h // 定义I2C引脚对应的时钟、端口和引脚号 #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 // 快速切换SDA引脚为输入或输出模式读取数据时需要输入写入时需要输出 #define SDA_IN() {gpio_mode_set(PORT_SDA, GPIO_MODE_INPUT, GPIO_PUPD_PULLUP, GPIO_SDA);} #define SDA_OUT() {gpio_mode_set(PORT_SDA, GPIO_MODE_OUTPUT, GPIO_PUPD_PULLUP, GPIO_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; // 年后两位如23代表2023 } _time_struct_; extern _time_struct_ RTC_Time; // 声明一个全局的时间结构体变量 // 函数声明 void DS3231_GPIO_Init(void); 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); #endif接着在bsp_ds3231.c文件中实现引脚的初始化函数。关键点来了一定要把引脚模式设置为GPIO_OTYPE_OD开漏输出并启用内部上拉电阻GPIO_PUPD_PULLUP。这是3.3V单片机与5V模块安全通信的保障。void DS3231_GPIO_Init(void) { // 1. 打开GPIOA端口的时钟因为PA1和PA2在这个端口上 rcu_periph_clock_enable(RCU_SCL); rcu_periph_clock_enable(RCU_SDA); // 2. 配置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); gpio_bit_write(PORT_SCL, GPIO_SCL, SET); // 初始化为高电平 // 3. 配置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); // 初始化为高电平 }3.2 手把手实现I2C时序I2C通信就像两个人打电话有一套固定的“礼貌用语”时序。下面这几个函数就是这套用语的具体实现。起始信号 (Start)告诉DS3231“喂我要开始说话了。”void IIC_Start(void) { SDA_OUT(); // 确保SDA是输出模式 SDA(1); // SDA和SCL先都拉高 SCL(1); delay_1us(5); // 保持一段时间 SDA(0); // 在SCL高电平期间SDA产生一个下降沿这就是起始信号 delay_1us(5); SCL(0); // 随后拉低SCL准备传输数据 }停止信号 (Stop)告诉DS3231“我说完了挂电话了。”void IIC_Stop(void) { SDA_OUT(); SCL(0); SDA(0); // 先确保SDA是低 delay_1us(5); SCL(1); // 拉高SCL delay_1us(5); SDA(1); // 在SCL高电平期间SDA产生一个上升沿这就是停止信号 }发送一个字节 (Write)把8位数据从最高位(MSB)开始一位一位地发出去。void IIC_Write(unsigned char dat) { int i 0; SDA_OUT(); SCL(0); // 拉低时钟线允许数据变化 for(i 0; i 8; i ) { // 取出最高位右移7位后不是1就是0然后设置到SDA线上 SDA( (dat 0x80) 7 ); delay_1us(2); dat 1; // 数据左移准备发送下一位 delay_1us(6); SCL(1); // 拉高SCLDS3231在此时钟上升沿读取SDA的数据 delay_1us(4); SCL(0); // 拉低SCL为发送下一位数据做准备 delay_1us(4); } }读取一个字节 (Read)从DS3231那里读取8位数据。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); // 拉高SCLDS3231会把数据位放到SDA线上 delay_1us(5); receive 1; // 左移为接收新数据位腾出空间 if( GETSDA() ) // 读取SDA引脚的电平 { receive | 1; // 如果是高电平就把最低位置1 } delay_1us(5); } return receive; }等待应答 (Wait_Ack)发送完地址或数据后等待对方回复“收到”(ACK)。unsigned char IIC_Wait_Ack(void) { char ack 0; unsigned char ack_flag 10; // 超时计数 SDA_IN(); // 设置为输入等待DS3231拉低SDA SDA(1); // 先释放SDA通过上拉电阻为高 delay_1us(5); SCL(1); // 拉高SCL delay_1us(5); // 循环等待SDA被拉低ACK信号 while( (GETSDA() 1) ( ack_flag ) ) { ack_flag--; delay_1us(5); } if( ack_flag 0 ) // 超时了没收到应答 { IIC_Stop(); // 发生错误发送停止信号 return 1; // 返回1表示失败 } else // 收到了应答 { SCL(0); // 拉低SCL SDA_OUT(); // 切换回输出模式准备后续操作 } return 0; // 返回0表示成功 }发送应答 (Send_Ack)作为主机在读取数据后告诉从机“我收到了”(ACK)或“不用再发了”(NACK)。void IIC_Send_Ack(unsigned char ack) { SDA_OUT(); SCL(0); SDA(0); // 先拉低如果是ACK就保持低如果是NACK就在后面拉高 delay_1us(5); if(!ack) SDA(0); // ack0发送应答信号低电平 else SDA(1); // ack1发送非应答信号高电平 SCL(1); delay_1us(5); SCL(0); SDA(1); // 释放SDA }4. 攻克DS3231的核心读写时间寄存器有了底层的I2C“电话拨号”功能现在我们可以和DS3231进行有内容的对话了。对话的核心就是读写它的时间寄存器。4.1 时间寄存器地图DS3231内部有一系列寄存器像表格一样存放着时间信息。我们最常用的是前7个寄存器地址内容范围BCD码0x00秒00-590x01分00-590x02时00-23 (24小时制) 或 01-12 (12小时制)0x03星期01-07 (用户自定义但需连续)0x04日01-310x05月01-120x06年00-99注意DS3231存储的时间是BCD码不是我们直接用的十进制数。比如十进制数23在BCD码里是0x23二进制0010 0011。所以我们需要进行转换。4.2 写入时间设置时钟设置时间本质上就是向上面这些地址写入数据。流程是起始信号 - 发送器件写地址(0xD0) - 发送要写的寄存器地址 - 发送数据BCD格式- 停止信号。unsigned char Write_DS3231(unsigned char addr, unsigned char dat) { unsigned char temp; /* 第一步十进制转BCD码 */ temp dat / 10; // 取十位例如23得到2 temp 4; // 左移4位变成 0010 0000 temp temp | (dat % 10); // 加上个位例如 0010 0000 | 0011 0010 0011 即0x23 /* 第二步I2C通信流程 */ IIC_Start(); IIC_Write(0xD0); // 器件地址 写标志(0) if( IIC_Wait_Ack() 1 ) return 1; // 失败 IIC_Write(addr); // 寄存器地址 if( IIC_Wait_Ack() 1 ) return 2; // 失败 IIC_Write(temp); // 写入BCD码数据 IIC_Wait_Ack(); // 等待应答这个必须有严格遵循时序 IIC_Stop(); return 0; // 成功 }4.3 读取时间获取当前时间读取时间稍微复杂一点因为I2C读操作需要先“告诉”芯片要读哪个地址然后再发起一次起始信号进行读操作。流程是起始信号 - 发送器件写地址(0xD0) - 发送要读的寄存器地址 -重复起始信号- 发送器件读地址(0xD1) - 读取数据 - 发送非应答(NACK) - 停止信号。unsigned char Read_DS3231(unsigned char addr) { int i 0; unsigned char temp; unsigned char dat; IIC_Start(); IIC_Write(0xD0); // 器件地址 写标志(0) if( IIC_Wait_Ack() 1 ) return 255; IIC_Write(addr); // 要读取的寄存器地址 if( IIC_Wait_Ack() 1 ) return 255; // 这里有时需要等待芯片准备数据用一个循环加重复起始信号 do { i; if(i 20) return 255; // 超时退出 delay_1ms(1); IIC_Start(); // 重复起始信号 IIC_Write(0xD1); // 器件地址 读标志(1) } while(IIC_Wait_Ack() 1); // 等待DS3231应答 dat IIC_Read(); // 读取一个字节数据BCD码 IIC_Send_Ack(1); // 发送非应答(NACK)表示读取结束 IIC_Stop(); /* 第三步BCD码转回十进制 */ temp dat / 16; // 取高4位例如0x23得到2 dat dat % 16; // 取低4位得到3 dat dat temp * 10; // 2*10 3 23 return dat; }4.4 封装易用的时间函数有了最底层的读写函数我们可以封装两个超级好用的函数一个用于设置所有时间一个用于获取所有时间。// 设置RTC时间 // 参数都是十进制的普通数字函数内部会帮你转换 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) { Write_DS3231(0x00, sec); //设置秒 Write_DS3231(0x01, min); //设置分 Write_DS3231(0x02, hour); //设置时 Write_DS3231(0x03, week); //设置周 Write_DS3231(0x04, date); //设置日 Write_DS3231(0x05, month); //设置月 Write_DS3231(0x06, year); //设置年 } // 获取RTC时间 // 读取的结果会存入全局结构体变量 RTC_Time 中 void Get_RTC_Time(void) { RTC_Time.sec Read_DS3231(0x00); RTC_Time.min Read_DS3231(0x01); RTC_Time.hour Read_DS3231(0x02); RTC_Time.week Read_DS3231(0x03); RTC_Time.date Read_DS3231(0x04); RTC_Time.month Read_DS3231(0x05); RTC_Time.year Read_DS3231(0x06); }5. 实战演练在主函数中测试所有代码都准备好了现在让我们在main函数里把它们用起来看看效果。#include gd32e23x.h #include systick.h #include bsp_usart.h #include stdio.h #include bsp_ds3231.h int main(void) { systick_config(); // 初始化系统滴答定时器用于delay_ms函数 usart_gpio_config(115200U); // 初始化串口用于打印信息 DS3231_GPIO_Init(); // 初始化连接DS3231的I2C引脚 printf(DS3231 RTC Demo Start \r\n); // 重要第一次给模块上电或者更换电池后需要设置一次时间。 // 设置时间为2023年11月14日星期二17点02分00秒 Set_RTC_Time(23, 11, 14, 2, 17, 2, 0); while(1) { Get_RTC_Time(); // 从DS3231读取当前时间 // 通过串口打印出日期和时间 printf(Date: 20%d-%d-%d, Week: %d\r\n, RTC_Time.year, RTC_Time.month, RTC_Time.date, RTC_Time.week); printf(Time: %d:%d:%d\r\n\r\n, RTC_Time.hour, RTC_Time.min, RTC_Time.sec); delay_1ms(1000); // 每隔1秒读取并打印一次 } }把程序编译下载到立创GD32E230开发板打开串口助手波特率115200你就能看到时间一秒一秒地跳动输出了。第一次运行后你可以把Set_RTC_Time这行代码注释掉然后复位开发板。你会发现即使单片机重新上电DS3231模块依然能提供准确的时间这就是它内置电池的功劳。6. 调试心得与常见问题通信失败读回来全是255首先检查硬件VCC、GND、SDA、SCL四根线是否接对、接牢。用万用表量一下电压。检查引脚配置确保bsp_ds3231.h里的引脚定义和你实际的接线一致。检查上拉电阻软件I2C必须依赖外部或内部上拉电阻。代码里我们启用了内部上拉(GPIO_PUPD_PULLUP)如果通信距离较长或干扰大建议在SDA和SCL线上各加一个4.7kΩ的外部上拉电阻到3.3V。用逻辑分析仪抓波形这是最直接的调试方法。看看起始信号、停止信号、地址、数据位的波形是否符合I2C时序图。时间设置后读取不对检查BCD码转换最容易出错的地方就是十进制和BCD码的互相转换。仔细对照代码里的转换算法。确认时间格式DS3231的时寄存器有位用于设置12/24小时制。我们的代码默认使用24小时制。如果你发现小时数不对检查一下时寄存器地址0x02的最高位BIT6确保它是024小时制。为什么用软件I2C而不用硬件I2C就像前面说的软件I2C在项目初期和调试阶段灵活性更高不依赖特定的硬件引脚时序完全可控。对于DS3231这种标准低速器件软件模拟完全够用。等项目稳定后如果想节省CPU资源可以再考虑移植到硬件I2C上。把这个驱动移植到你的GD32E230工程里你就能获得一个高精度、不掉电的实时时钟了。无论是做数据记录仪、智能闹钟还是任何需要时间戳的项目它都是一个非常可靠的选择。希望这篇教程能帮你扫清障碍如果移植过程中遇到问题欢迎在社区里交流讨论。