STM32F429驱动DS1307：I2C实时时钟芯片驱动开发与调试实战

简介：围绕STM32F429与DS1307实时时钟芯片的I2C通信例程，面向嵌入式初学者及需要快速上手STM32外设开发的工程师。内容涵盖GPIO复用模式配置、I2C外设初始化、读写时序实现，以及通过HAL库完成时间设置与读取的完整思路，可作为学习I2C协议和RTC驱动设计的实践参考。资源包共1437个文件，以C源码、头文件、启动文件及SVD描述文件为主，另有PDF说明、工程配置、编译库与文档，整体体积84.33MB，目录结构清晰，便于对照查阅和移植到其他STM32项目。当前已有100人学习下载，适合想深入理解嵌入式时间管理、外设驱动编写及HAL库用法的人群，是一份兼顾原理讲解与工程实操的典型例程。

1. 接上DS1307之前，先想清楚这颗RTC芯片在你的F429工程里处于什么位置

很多用STM32F429做电子时钟的初学者，代码能跑、数码管能跳，但一掉电时间就回到初始值，问题几乎都出在“主控断电后没人走秒”。DS1307就是为此存在的：一颗I2C接口的实时时钟芯片，靠备用电池在掉电后继续计时，主控上电后通过I2C总线把时间读回来。它和F429搭配的难点不在芯片本身，而在I2C的时序、BCD码换算和总线出错时的恢复手段。这篇按外设例程最常见的工程结构来拆：先确认硬件接法和寄存器布局，再写可复用的驱动骨架，最后落到状态机与调试参数。适合已经点亮过F429、手头有DS1307模块或想把时钟功能做进课程设计的人。代码统一用STM32标准库写，容易移植到F1/F4系列。

2. 硬件连接与寄存器布局：DS1307和F429的I2C1为什么需要外部上拉电阻

2.1 极简接线：DS1307只占F429两个引脚

DS1307是8引脚DIP/SOIC封装，与F429通信只需两根线：SCL时钟和SDA数据。以I2C1为例，STM32F429的PB6复用为I2C1_SCL，PB7复用为I2C1_SDA。其余引脚按数据手册接即可：

提示：市场上很多DS1307模块直接带电池座和晶振，接到开发板时确认模块上的上拉电阻是否为4.7kΩ。如果用的是裸芯片，SCL和SDA必须自行接上拉电阻到VCC，否则I2C通信会间歇性失败。

2.2 寄存器地址和BCD编码：读出来的“秒”不是你想的秒

DS1307内部时间寄存器从0x00到0x06，分别是秒、分、时、星期、日、月、年，末尾0x07是控制寄存器。一个反直觉的地方是时间数据用BCD码存储：例如秒寄存器读到0x59，不代表十进制的59秒，而是十位是5、个位是9的编码——直接拿这个数字往串口发，显示出来就是十进制的89。所以驱动里必须做BCD转十进制的换算。

寄存器0x00的bit7是CH位（Clock Halt），这一位为1时芯片内部振荡器停振，时间不走。市面上某些模块出厂时CH位是1，读出来的时间永远是固定值，这是“掉电后不走时”之外最常见的翻车点。新芯片首次上电后，写秒寄存器前把CH位置0，芯片才会开始计时。

0x02小时寄存器的bit6是12/24小时制标志，bit5是AM/PM位。驱动里建议固定用24小时制，写小时寄存器时要保证该位为0，否则读回的小时数会带11小时偏差。0x06年份寄存器只有低7位，范围0~99，软件需要自行加2000换算。

2.3 F429的I2C外设初始化：标准库必调的三个寄存器组

F429的I2C外设挂在APB1总线上，初始化分成三步：开时钟、配GPIO复用、调I2C参数。GPIO配置成复用开漏，外设内部不提供上拉，所以必须依赖外部电阻：

void ds1307_i2c_init(void) { GPIO_InitTypeDef gpio; I2C_InitTypeDef i2c; RCC_APB1PeriphClockCmd(RCC_APB1Periph_I2C1, ENABLE); // I2C1时钟 RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOB, ENABLE); // PB6/PB7时钟 gpio.GPIO_Mode = GPIO_Mode_AF; // 复用功能 gpio.GPIO_OType = GPIO_OType_OD; // 开漏输出 gpio.GPIO_PuPd = GPIO_PuPd_UP; // 内部上拉，弱 gpio.GPIO_Speed = GPIO_Speed_50MHz; gpio.GPIO_Pin = GPIO_Pin_6 | GPIO_Pin_7; GPIO_Init(GPIOB, &gpio); GPIO_PinAFConfig(GPIOB, GPIO_PinSource6, GPIO_AF_I2C1); // PB6 -> I2C1_SCL GPIO_PinAFConfig(GPIOB, GPIO_PinSource7, GPIO_AF_I2C1); // PB7 -> I2C1_SDA I2C_DeInit(I2C1); // 先复位外设，清掉残留错误标志 i2c.I2C_Mode = I2C_Mode_I2C; i2c.I2C_ClockSpeed = 400000; // 快速模式 i2c.I2C_DutyCycle = I2C_DutyCycle_2; // 占空比 2:1，配合400kHz i2c.I2C_OwnAddress1= 0x0A; // 主机地址，任意非0即可 i2c.I2C_Ack = I2C_Ack_Enable; i2c.I2C_AcknowledgedAddress = I2C_AcknowledgedAddress_7bit; I2C_Init(I2C1, &i2c); I2C_Cmd(I2C1, ENABLE); }

逻辑说明：GPIO_PuPd_UP只是辅助上拉，阻值在30~50kΩ量级，只能防止输入悬浮，不足以满足400kHz快速模式下的上升沿要求。真实通信质量依赖外部4.7kΩ电阻，这也是很多人把速率降到100kHz后“突然能用了”的原因——不是代码变对了，而是慢速模式下对上升沿要求变宽了。

2.4 I2C总线死锁与外部上拉电阻的实测边界

I2C协议里，如果主机在传输中途复位，而从机仍在输出低电平，SDA会被一直拉低，总线进入死锁状态。F429没有硬件自动恢复机制，代码里需要在每次通信前检查I2C_GetFlagStatus(I2C1, I2C_FLAG_BUSY)，若持续忙则做软件复位：I2C_Cmd(I2C1, DISABLE)后置位I2C_SWSTRT，再重新使能外设。这一招能解决大部分总线卡死问题，但前提是外部上拉电阻存在；没有上拉时软件反复复位也没用，因为SDA根本拉不回来。

3. 写一个可移植的bsp_ds1307.c：单字节读写、BCD换算和时间结构体

3.1 头文件与引脚宏：把硬件约束写进bsp_ds1307.h

例程里一般把驱动拆成bsp_ds1307.h和bsp_ds1307.c两个文件。头文件里定义I2C外设、引脚、设备地址和时间结构体，方便以后换到I2C2或其他F4型号时只改一处：

#ifndef __BSP_DS1307_H #define __BSP_DS1307_H #include "stm32f4xx.h" #define DS1307_I2C I2C1 #define DS1307_I2C_CLK RCC_APB1Periph_I2C1 #define DS1307_I2C_GPIO GPIOB #define DS1307_I2C_GPIO_CLK RCC_AHB1Periph_GPIOB #define DS1307_I2C_SCL_PIN GPIO_Pin_6 #define DS1307_I2C_SDA_PIN GPIO_Pin_7 #define DS1307_ADDR_W 0xD0 // 7位地址0x68左移1位 + 写位 #define DS1307_ADDR_R 0xD1 // 7位地址0x68左移1位 + 读位 typedef struct { uint8_t sec; uint8_t min; uint8_t hour; uint8_t week; uint8_t day; uint8_t month; uint16_t year; } ds1307_time_t; void ds1307_init(void); uint8_t ds1307_read_byte(uint8_t reg); void ds1307_write_byte(uint8_t reg, uint8_t val); uint8_t ds1307_get_time(ds1307_time_t *t); uint8_t ds1307_set_time(ds1307_time_t *t); #endif

说明：DS1307的7位从机地址是0x68，左移一位后加上读写位得到0xD0和0xD1。标准库的I2C_Send7bitAddress需要传入完整8位地址，所以直接定义这两个宏，避免在读写函数里反复移位造成笔误。

3.2 单字节读写函数：从起始条件到停止条件的完整状态机

F429的标准库I2C驱动是阻塞式的，每步都要用while等待事件标志。DS1307是慢速设备，400kHz下没问题，但要注意超时保护——用变量倒计时代替死等，否则总线异常时程序会卡死在while里：

uint8_t ds1307_write_byte(uint8_t reg, uint8_t val) { uint16_t timeout = 1000; while (I2C_GetFlagStatus(DS1307_I2C, I2C_FLAG_BUSY)) if (--timeout == 0) return 1; // 总线忙超时 I2C_GenerateSTART(DS1307_I2C, ENABLE); timeout = 1000; while (!I2C_CheckEvent(DS1307_I2C, I2C_EVENT_MASTER_MODE_SELECT)) if (--timeout == 0) return 1; I2C_Send7bitAddress(DS1307_I2C, DS1307_ADDR_W, I2C_Direction_Transmitter); timeout = 1000; while (!I2C_CheckEvent(DS1307_I2C, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED)) if (--timeout == 0) return 1; I2C_SendData(DS1307_I2C, reg); timeout = 1000; while (!I2C_CheckEvent(DS1307_I2C, I2C_EVENT_MASTER_BYTE_TRANSMITTED)) if (--timeout == 0) return 1; I2C_SendData(DS1307_I2C, val); timeout = 1000; while (!I2C_CheckEvent(DS1307_I2C, I2C_EVENT_MASTER_BYTE_TRANSMITTED)) if (--timeout == 0) return 1; I2C_GenerateSTOP(DS1307_I2C, ENABLE); return 0; }

参数说明：第一次等待的EVENT_MASTER_BYTE_TRANSMITTED是“地址+寄存器地址发送完成”，第二次才是“数据字节发送完成”。如果只等一次事件就发数据，会在从机还未释放SDA时报错。所有事件等待都带超时退出，返回值非0表示通信失败，调用方可以据此做错误计数或重试。

读单字节比写多一个重复起始条件：先发设备写地址和寄存器号，不产生停止条件，随后再发一次起始条件，切换为读方向：

uint8_t ds1307_read_byte(uint8_t reg) { uint16_t timeout = 1000; uint8_t val = 0; while (I2C_GetFlagStatus(DS1307_I2C, I2C_FLAG_BUSY)) if (--timeout == 0) return 0xFF; I2C_GenerateSTART(DS1307_I2C, ENABLE); while (!I2C_CheckEvent(DS1307_I2C, I2C_EVENT_MASTER_MODE_SELECT)) if (--timeout == 0) return 0xFF; I2C_Send7bitAddress(DS1307_I2C, DS1307_ADDR_W, I2C_Direction_Transmitter); while (!I2C_CheckEvent(DS1307_I2C, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED)) if (--timeout == 0) return 0xFF; I2C_SendData(DS1307_I2C, reg); while (!I2C_CheckEvent(DS1307_I2C, I2C_EVENT_MASTER_BYTE_TRANSMITTED)) if (--timeout == 0) return 0xFF; // 重复起始，方向切到读 I2C_GenerateSTART(DS1307_I2C, ENABLE); while (!I2C_CheckEvent(DS1307_I2C, I2C_EVENT_MASTER_MODE_SELECT)) if (--timeout == 0) return 0xFF; I2C_Send7bitAddress(DS1307_I2C, DS1307_ADDR_R, I2C_Direction_Receiver); while (!I2C_CheckEvent(DS1307_I2C, I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED)) if (--timeout == 0) return 0xFF; // 在接收前关闭ACK，配合最后一次读取自动停止 I2C_AcknowledgeConfig(DS1307_I2C, DISABLE); while (!I2C_CheckEvent(DS1307_I2C, I2C_EVENT_MASTER_BYTE_RECEIVED)) if (--timeout == 0) return 0xFF; val = I2C_ReceiveData(DS1307_I2C); I2C_GenerateSTOP(DS1307_I2C, ENABLE); I2C_AcknowledgeConfig(DS1307_I2C, ENABLE); return val; }

提示：读取最后一个字节前必须关闭ACK，否则从机会认为主机还要继续收数据，停止条件发出后总线时序会乱掉。标准库的I2C_EVENT_MASTER_BYTE_RECEIVED在关闭ACK模式下依然有效，实测在F429上可以正常读到末字节。

3.3 时间转换与读写接口：BCD互转、年份低两位和CH位处理

时间结构体里的year用uint16_t存完整公元年份，写入DS1307时只取低两位并转成BCD，读出时再转回完整年份：

static uint8_t bcd2dec(uint8_t bcd) { return (bcd >> 4) * 10 + (bcd & 0x0F); } static uint8_t dec2bcd(uint8_t dec) { return ((dec / 10) << 4) | (dec % 10); } uint8_t ds1307_get_time(ds1307_time_t *t) { uint8_t raw; raw = ds1307_read_byte(0x00); if (raw == 0xFF) return 1; // 读失败 if (raw & 0x80) return 2; // CH位为1，时钟停振 t->sec = bcd2dec(raw & 0x7F); t->min = bcd2dec(ds1307_read_byte(0x01) & 0x7F); t->hour = bcd2dec(ds1307_read_byte(0x02) & 0x3F); t->week = bcd2dec(ds1307_read_byte(0x03) & 0x07); t->day = bcd2dec(ds1307_read_byte(0x04) & 0x3F); t->month = bcd2dec(ds1307_read_byte(0x05) & 0x1F); t->year = 2000 + bcd2dec(ds1307_read_byte(0x06)); return 0; } uint8_t ds1307_set_time(ds1307_time_t *t) { if (t->year < 2000) t->year = 2000; ds1307_write_byte(0x00, dec2bcd(t->sec) & 0x7F); // CH位置0，启动振荡器 ds1307_write_byte(0x01, dec2bcd(t->min) & 0x7F); ds1307_write_byte(0x02, dec2bcd(t->hour) & 0x3F); // 强制24小时制 ds1307_write_byte(0x03, dec2bcd(t->week) & 0x07); ds1307_write_byte(0x04, dec2bcd(t->day) & 0x3F); ds1307_write_byte(0x05, dec2bcd(t->month) & 0x1F); ds1307_write_byte(0x06, dec2bcd(t->year - 2000) & 0x7F); return 0; }

逻辑说明：写秒寄存器时用0x7F掩码，把CH位固定为0，这是驱动首次上电后的关键动作——不写这一位，芯片时间可能停在00:00:00不动。小时写0x3F保证bit6为0，即始终24小时制。

4. 例程实战：按键扫描状态机、时间设置流程和I2C卡死的定位

4.1 把读时间从主循环里摘出去：状态机在这里的价值

DS1307读一次时间要连续读7个寄存器，I2C是半双工总线，通信期间如果有中断服务函数里也碰I2C，数据必然错乱。例程主循环应当设计成“按键扫描→按需读时间→刷新显示”三步，而不是每轮循环都去读一遍RTC：

typedef enum { STATE_SHOW, STATE_SET_YEAR, STATE_SET_MONTH, STATE_SET_DAY, STATE_SET_HOUR, STATE_SET_MIN, STATE_SET_SEC, STATE_SAVE } clock_state_t; clock_state_t state = STATE_SHOW; ds1307_time_t cur; while (1) { key = key_scan(); // 非阻塞按键，返回键值 switch (state) { case STATE_SHOW: if (key == KEY_OK) state = STATE_SET_YEAR; else if (key == KEY_REFRESH || tick_500ms) ds1307_get_time(&cur); // 500ms刷新一次，降低总线占用 break; case STATE_SET_YEAR: if (key == KEY_UP) cur.year++; if (key == KEY_DOWN) cur.year--; if (key == KEY_OK) state = STATE_SET_MONTH; break; // 其余set状态类似，操作同一个cur结构体 case STATE_SAVE: ds1307_set_time(&cur); state = STATE_SHOW; break; } lcd_show_clock(&cur, state); }

逻辑说明：状态机把“设置状态”和“显示状态”分离，设置过程中不会触发读RTC，避免写入过程中被读操作打断。显示状态中500ms读一次已经很充足，因为DS1307的秒精度足够，不需要每帧都读总线。刷新标志用定时器置位，配合按键扫描在同一个主循环里完成。

4.2 总线卡死怎么定位：从逻辑分析仪波形到软件复位

I2C问题最隐蔽的是“上电时好，运行一段时间后偶尔卡死”。此时程序会停在I2C_CheckEvent的等待循环里。处理步骤按优先级排列：先看SDA电平是否被拉低，再查从机地址是否有应答，最后查是否有遗漏的读序列。逻辑分析仪抓I2C波形时，如果起始条件之后只有地址没有后续数据，说明主机发完地址但没有收到从机ACK，重点检查DS1307的电源和SDA上拉；如果波形停在中间某位，说明从机拉低了时钟线进行时钟拉伸，此时需要等待而不是复位。

void ds1307_bus_reset(void) { GPIO_InitTypeDef gpio; uint16_t timeout; // 先把PB6/PB7切回普通推挽输出，手动翻转模拟起始/停止条件 gpio.GPIO_Mode = GPIO_Mode_OUT; gpio.GPIO_OType = GPIO_OType_PP; gpio.GPIO_Pin = GPIO_Pin_6 | GPIO_Pin_7; gpio.GPIO_Speed = GPIO_Speed_2MHz; GPIO_Init(GPIOB, &gpio); GPIO_SetBits(GPIOB, GPIO_Pin_6 | GPIO_Pin_7); for (timeout = 0; timeout < 5; timeout++) { delay_us(5); } // 9个SCL脉冲，给从机释放SDA的机会 for (timeout = 0; timeout < 9; timeout++) { GPIO_ResetBits(GPIOB, GPIO_Pin_6); delay_us(5); GPIO_SetBits(GPIOB, GPIO_Pin_6); delay_us(5); } // 恢复复用开漏 ds1307_i2c_init(); }

参数说明：GPIO速度降到2MHz是为了让手动翻转的边沿更缓，避免在总线上产生振铃导致DS1307误识别。9个时钟脉冲是I2C规范里标准的恢复手段，实际遇到0x68地址完全无响应时，这个函数往往比单纯调大上拉电阻更管用。

4.3 例程关键参数表：上拉、速率、晶振与备用电池的合理取值

5. 把DS1307调“准”的三个手段：CH位、SQW秒脉冲与备份寄存器校验

5.1 用SQW引脚输出秒脉冲，校准晶振偏差

DS1307的0x07控制寄存器里，RS1/RS0两位可以选择SQW输出频率：00=1Hz，01=4096Hz，10=8192Hz，11=32768Hz。把SQW设成1Hz输出，用F429的输入捕获引脚测量两次上升沿之间的间隔，就能算出当前晶振快慢：

ds1307_write_byte(0x07, 0x10); // SQWE=1, RS1=0, RS0=0, 输出1Hz // 配置PA0为输入捕获上升沿，测两次捕获值的差值 // 捕获值差 / 定时器频率 = 实际走秒时长 // 若测得1.0002s，说明RTC每天快约17秒

实测中如果每天偏差稳定，可以用软件补偿：每秒叠加一个校正值，或者在设置时间时把秒数偏移半秒。这是不改晶振电容的前提下最实用的做法。

5.2 读秒后再写时间：先停振再写，避免秒跳变

直接向秒寄存器写入数值时，如果芯片正好在边界处进位，可能出现“写入59秒，下一秒变00分00秒”这种错乱。常见做法是把控制寄存器0x07的bit7（原本是OUT位）当普通IO用不行，所以要先用CH位停振，再写全部时间寄存器，最后置CH位为0恢复走时：

uint8_t raw; raw = ds1307_read_byte(0x00); ds1307_write_byte(0x00, raw | 0x80); // CH=1，停振 // 依次写 分 时 日 月 年 ds1307_write_byte(0x01, dec2bcd(min)); ds1307_write_byte(0x02, dec2bcd(hour) & 0x3F); ds1307_write_byte(0x04, dec2bcd(day)); ds1307_write_byte(0x05, dec2bcd(month)); ds1307_write_byte(0x06, dec2bcd(year)); ds1307_write_byte(0x00, dec2bcd(sec) & 0x7F); // CH=0，恢复走时

5.3 把写入结果读回来，用F429备份寄存器做验证

Ds1307没有写保护位，但也意味着一处误写就会破坏时间数据。一个实用技巧是写完后立刻读回比较，同时把比较结果存进F429的备份寄存器（RTC_BKP）。掉电再上电后在初始化阶段检查备份值，如果不是预期魔数，就认为外部时间芯片不可信，重新要求用户设置时间：

uint8_t tmp = ds1307_read_byte(0x02) & 0x3F; if (tmp != (dec2bcd(cur.hour) & 0x3F)) { tmp = ds1307_read_byte(0x00); ds1307_write_byte(0x00, tmp | 0x80); // 停振后重写 ds1307_set_time(&cur); } if (PWR_GetFlagStatus(PWR_FLAG_BKP) == RESET) // 备份域刚经历掉电 { PWR_BackupAccessCmd(ENABLE); RTC_WriteBackupRegister(RTC_BKP_DR0, 0xA5A5); // 写入校验魔数 }

注意备份寄存器不属于DS1307例程的直接范围，但这是工程上判断“RTC数据是否可信”的常见做法。靠CH位判断只能看出振荡器是否停过，看不出时间内容是否被意外改写。备份寄存器校验能把“外部RTC没电了”和“主控重启了”区分开，调试时少走很多弯路。

本文还有配套的精品资源，点击获取