简介STM32F429 外设例程中的 DS1307 实时时钟方案定位于嵌入式初学者与进阶开发者用于解决单片机与 I2C 接口 RTC 芯片的驱动接入问题。例程基于 HAL 库完成 GPIO 复用功能配置、I2C 外设初始化和主从通信按照起始信号、从机地址、读写控制等协议时序实现时间数据的写入与读取并覆盖中断触发、错误检测与恢复策略能够帮助读者建立外设驱动的完整调试思路。资源包为 84.33MB 的 RAR 压缩包内部共 1437 个文件以 663 个 C 源文件、612 个头文件为核心附带启动汇编文件、SVD 设备描述、STemWin 等库文件及 MDK 工程配置同时提供 CHM 和 PDF 文档便于查阅寄存器定义与 API 说明。项目目录按外设功能划分结构清晰可以直接导入工程查看代码、定位指定外设驱动也方便移植到自己的电路板。已有 100 人学习下载适合配合 STM32F429 开发板进行 I2C、RTC 专题训练也可作为毕业设计或项目开发中“读取/设置系统时间”功能模块的参考范例。1. 给STM32F429单片机挂DS1307先别急着写I2C读写函数反直觉的一点是DS1307这颗芯片本身并不难难的往往是STM32F429单片机的硬件I2C外设上那一堆事件标志。F429主频最高168MHz处理1字节I2C传输只要几微秒可当你读回的时间始终停在同一个值、或者总线上拉死SDA时问题几乎都出在总线状态恢复上。下面顺着“寄存器映射 → I2C时序 → 读写函数 → BCD校验 → 走时验证”这条路径把一套可以直接编译跑起来的外设例程讲清楚寄存器为什么那样排、HAL函数参数怎么设、以及掉电之后DS1307到底靠什么记住时间。想让第一块RTC一次跑通或者想看看别人在F429上怎么处理硬件I2C坑的都适合往下看。2. 先搞懂DS1307的I2C时序再谈STM32F429的硬件I2C2.1 DS1307的寄存器映射与地址字节先弄清0x68和0xD0的关系DS1307是8引脚的I2C RTC芯片7位从机地址固定为0x68。主机发送时要把地址左移一位得到0xD0写和0xD1读。第一次接触这个芯片的人容易把0x68直接填进HAL_I2C_Mem_Read的DevAddress参数结果Ack失败实际上HAL库要求的是8位地址也就是0x68 1。这个细节属于“看着手册就会真调起来必翻车”的典型坑。时间寄存器从0x00到0x06按秒、分、时、星期、日、月、年排列全部以BCD码存储。0x07是控制寄存器负责方波输出和OUT引脚电平0x08到0x3F是56字节用户RAM可以在掉电前存少量配置参数。表2-1列出时间寄存器的位域后面写读函数时直接按位掩码取数。地址位7位6位5位4~位0含义0x00CH十秒2位秒4位秒 00–590x010十分3位分4位分 00–590x02012/24AM/PM或20小时位时6位时 1–12/0–230x03000星期3位1–70x0400十日2位日4位日 1–310x05世纪0十月1位月4位月 1–120x06十年4位年4位年 0–99I2C读时序和写时序都是标准流程起始条件、发设备地址、等ACK、发寄存器地址、读操作时再来一次起始、收数据、最后NACK加STOP。DS1307只支持标准模式100kHz挂在400kHz快速模式总线上偶尔会丢ACK所以F429例程里一般把DS1307单独放一条I2C总线或者把总线速率降到100kHz。2.2 硬件I2C还是模拟I2CSTM32F429的I2C事件模型2.2.1 硬件I2C的时钟与事件链F429的I2C1挂在APB1上最大42MHz。CubeMX里选标准模式、100kHz并填上升时间后CCR和TRISE两个寄存器的值会自动算好。真正需要手工处理的是I2C外设的状态机SR1寄存器里的SB、ADDR、BTF、RxNE、TxE标志在HAL库里由HAL_I2C_Mem_Read和HAL_I2C_Mem_Write封装完成。这两条函数是阻塞式的内部靠超时变量退出。例程里超时参数我一般给100ms。100kHz下传输7个字节的数据不到1ms100ms能覆盖总线仲裁和从机时钟延展的极端情况又不会让故障隐藏太久。硬件I2C最常见的问题是EV5阶段卡住也就是发出起始条件后SB一直不置位。原因通常是GPIO刚上电方向不定或者上一帧STOP没发干净导致总线忙。此时HAL_I2C_GetError返回HAL_I2C_ERROR_BUSY最直接的做法是执行一次总线恢复再重新初始化外设。2.2.2 模拟I2C的适用场景很多老工程师在F1/F4上宁愿用GPIO模拟I2C核心原因是硬件外设的状态机一旦进入奇怪状态复位动作比模拟实现麻烦得多。模拟I2C的好处是不依赖外设事件标志时序延迟用循环掐算就能控制移植到其它单片机也方便。代价是CPU占用高、不支持多主机仲裁时钟延展也要自己处理。对DS1307这种低速设备模拟I2C完全够用。无论是硬件I2C还是模拟I2C总线死锁后的恢复逻辑是一样的把SCL拉低连续输出9个下降沿让从机释放SDA最后给一个STOP。static void I2C_Bus_Reset_After_Deadlock(GPIO_TypeDef *port, uint16_t scl_pin) { // 将SCL临时配置为开漏输出SDA保持外部上拉 HAL_GPIO_WritePin(port, scl_pin, GPIO_PIN_RESET); for (int i 0; i 9; i) { HAL_GPIO_WritePin(port, scl_pin, GPIO_PIN_RESET); HAL_Delay(1); HAL_GPIO_WritePin(port, scl_pin, GPIO_PIN_SET); HAL_Delay(1); } // 发出STOPSDA在SCL高电平期间拉高 }逻辑说明I2C从机靠SCL时钟边沿释放总线9个脉冲足够覆盖DS1307内部状态不深的情况。参数里的port、scl_pin要对应实际接线HAL_Delay(1)在100kHz场景够用追求时序精度时可以换成微秒级延迟。恢复期间SDA引脚要配置成浮空输入或开漏输出不能是推挽输出否则会干扰从机释放总线。表2-2给出两种方式的对比。对比项硬件I2C模拟I2C传输速率最高400kHzDS1307限100kHz取决于GPIO翻转速度多主机仲裁支持不支持调试难度需处理事件标志逐位可控CPU占用低高3. 在STM32F429上搭建DS1307例程CubeMX参数与寄存器读写全流程3.1 用STM32CubeMX生成I2C1基础工程标准模式100kHzCubeMX里选STM32F429ZIT6SYS打开Serial Wire方便调试RCC用外部晶振并将频率按板子实际值配置。I2C1使能后参数面板里三个值最关键。参数名推荐值作用I2C Speed ModeStandard Mode匹配DS1307最高100kHzI2C Clock Speed100000SCL频率单位HzI2C Rise Time1000 ns标准模式上升时间上限这三个值背后对应F429参考手册里的CCR和TRISE寄存器。标准模式下SCL低电平最短4.7μs、高电平最短4.0μs100kHz是DS1307规格书的上限再提速没有收益反而容易在总线竞争时丢数据。生成代码后i2c.c里会出现一个hi2c1句柄地址和超时参数留给调用端填。值得确认的是GPIO复用。F429上I2C1默认在PB6SCL、PB7SDA部分板子或重映射配置会到PB8、PB9这两组都是AF4开漏复用。开漏输出是必须的不能配推挽推挽输出会让多个设备驱动总线时直接短路SDA拉不高也拉不低。生成代码后检查一下MX_GPIO_Init里对应引脚的模式开漏且带上拉即可。3.2 编写DS1307读写函数HAL库调用与参数逐项解释I2C基础工程就绪后封装DS1307自己的驱动。下面先给出头文件里的时间结构体和单字节读函数。typedef struct { uint8_t year; // 0-992000年偏移 uint8_t month; // 1-12 uint8_t date; // 1-31 uint8_t week; // 1-7对应周日到周六 uint8_t hour; // 0-2324小时制 uint8_t minute; // 0-59 uint8_t second; // 0-59 } DS1307_Time_t; uint8_t DS1307_ReadByte(uint8_t reg) { uint8_t val 0; // DevAddress必须是8位地址0x68左移一位得到0xD0 if (HAL_I2C_Mem_Read(hi2c1, 0x68 1, reg, I2C_MEMADD_SIZE_8BIT, val, 1, 100) ! HAL_OK) { // 读失败时先恢复总线再重新初始化I2C1 I2C_Bus_Reset_After_Deadlock(GPIOB, GPIO_PIN_6); HAL_I2C_DeInit(hi2c1); HAL_I2C_Init(hi2c1); } return val; }逻辑说明HAL_I2C_Mem_Read是完整的主机读函数内部先发START再写设备地址和寄存器地址然后发第二次START最后以NACK加STOP收尾。失败时总线上状态未知所以先恢复总线再重新初始化外设。I2C_MEMADD_SIZE_8BIT表示寄存器地址是一个字节超时100ms是这个字节本应在1ms内完成传输的宽松上限。DS1307支持从起始地址连续读读到0x3F后自动回卷。读时间函数一次把7个时间寄存器搬到结构体里。void DS1307_GetTime(DS1307_Time_t *t) { uint8_t buf[7] {0}; HAL_I2C_Mem_Read(hi2c1, 0x68 1, 0x00, I2C_MEMADD_SIZE_8BIT, buf, 7, 100); t-second BCD2DEC(buf[0] 0x7F); // 掩掉CH位 t-minute BCD2DEC(buf[1] 0x7F); t-hour BCD2DEC(buf[2] 0x3F); // 掩掉12/24位和20小时位 t-week BCD2DEC(buf[3] 0x07); t-date BCD2DEC(buf[4] 0x3F); t-month BCD2DEC(buf[5] 0x1F); t-year BCD2DEC(buf[6]); }这里的每次掩码都很关键原因在下一章详细讲但写例程时最好现在就带上。读7字节的参数含义buf是接收缓冲区7是要读的长度100是超时毫秒数。DS1307的地址指针在每次STOP后归零所以每次都必须从0x00起始如果读到一半总线出错下一次调用仍从0x00发起不会因为指针错位读到RAM区。写时间时用HAL_I2C_Mem_Write从0x00连续写7字节注意新芯片的CH位必须先清0否则时间永远不走。4. 时间寄存器里的BCD码与停振位DS1307例程最容易犯的错4.1 BCD码转换、CH停振标志和12/24小时制读回乱码的排查顺序DS1307内部时间以BCD码存储比如十二点五十九分三十一秒存的是0x01、0x59、0x31。如果直接把寄存器里的十六进制数当十进制打印新手常常以为读到了异常值。0x59在BCD里就是十进制59只是用8位二进制表示成了01011001。读写转换靠下面两个函数。static uint8_t BCD2DEC(uint8_t bcd) { // 高4位是十位低4位是个位 return (bcd 4) * 10 (bcd 0x0F); } static uint8_t DEC2BCD(uint8_t dec) { // 十进制的十位放进高4位个位放进低4位 return ((dec / 10) 4) | (dec % 10); }BCD2DEC的错误版本很常见比如写成(bcd 0xF0) (bcd 0x0F)0x59算出来是0x59当成十进制打印就成了89。另一个方向是DEC2BCD里先移个位再除以10结果完全乱套。所以这两个函数写完先做一轮单元验证把0x00、0x59、0x99都跑一遍。真正让时间不走的第一个坑是CH位。地址0x00的bit7叫CH出厂默认是1表示振荡器停振。新拿到的DS1307直接读秒寄存器会看到0x80以上的值而且时间不动。写时间函数时必须在写秒的同时把CH清零或单独向0x00写0x00。调试时先读0x00看原始值高于等于0x80就先清位再读。第二个坑是小时寄存器的bit6。bit6为1时按12小时制解释时间bit5变成AM/PM标志bit6为0时按24小时制解释bit5是20小时位。例程里通常固定用24小时制让bit6保持0读小时时统一掩掉0x3F。如果你读回的小时总是差12或者一直是12的倍数先检查是不是12小时制没按位处理。两处掩码组合起来调不过时间的排查顺序是先读秒寄存器看CH再读小时寄存器看bit6接着写一组已知时间比如0x00、0x59、0x23再立即读回看往返是否一致。不一致就往地址字节和I2C时序上想一致但下次上电变乱就往掉电保持方向查。4.2 掉电后的默认行为与VBAT电源策略如何确认时间还在走DS1307主电源VCC掉电后只要VBAT引脚上挂着纽扣电池或法拉电容振荡器和寄存器就继续运行RAM数据保留。VBAT电压不能比VCC高出太多否则芯片内部电源选择逻辑可能误判。参考手册建议VBAT在2.0到3.5V常用一颗CR1220串个1kΩ电阻接入。新出厂芯片CH1意味着振荡器从来没启动过如果你拆掉跳线帽直接给VCC供电不接VBAT时间照样走只是掉电后时间归零并恢复CH1。所以例程要有一个时钟初始化函数写入一次合法时间并把CH清0。校验是否在走时间隔一段时间读两次秒寄存器就行。uint8_t sec1 DS1307_ReadByte(0x00) 0x7F; HAL_Delay(1500); uint8_t sec2 DS1307_ReadByte(0x00) 0x7F; if (sec1 sec2) { // 秒值没变多半CH1停振或者总线异常 DS1307_WriteByte(0x00, DS1307_ReadByte(0x00) 0x7F); // 清除CH }这段代码是上电后的快速自检不是替代中断。HAL_Delay(1500)用1.5秒的余量避免临界时间误判比较两次秒值若相同则说明振荡器没走此时把0x00寄存器当前值写回并清掉CH位相当于给振荡器一个重启信号。参数说明0x00是秒寄存器地址 0x7F是清CH位写回时保留秒数值不变。5. SQW方波验证走时一分钟法看误差软件校时技巧5.1 让DS1307的SQW输出1Hz方波不用示波器也能确认振荡器比反复读秒寄存器更直观的办法是把0x07控制寄存器的SQWE位置1、RS位设成00让SQW引脚输出1Hz方波。该引脚是开漏输出F429这边接一个10kΩ上拉到3.3V再串一个LED或接到F429的EXTI引脚。LED每秒闪一次就能确认振荡器在工作如果不闪优先查CH位和晶振引脚上的负载电容。void DS1307_EnableSquareWave1Hz(void) { // SQWE1, RS0b00输出1Hz DS1307_WriteByte(0x07, 0x00 | 0x10); }逻辑说明0x07的bit4是SQWEbit1:bit0是RS。写0x10后SQW引脚输出由内部4.096kHz基准分频到1Hz。参数0x00保留OUT位默认低电平。更严谨的做法是先读旧值再只改相关位掩码但对DS1307直接写0x10通常也没问题。5.2 一分钟法测误差利用SQW方波做秒校准走时误差来自外部32.768kHz晶振的初始偏差典型值±20ppm一天约1.7秒。快速粗测方法对好当前时间等真实世界秒针对齐时读DS1307秒值并记录与串口打印的偏差。比如60秒后DS1307显示59说明每天慢约1秒。要更精确就数SQW引脚上的脉冲数在一分钟内直接统计真实秒数误差能压到毫秒级。硬件上想提精度就换负载电容匹配更好的晶振或温补晶振软件上则做每日校时在固定定时任务里把预设秒偏移加到寄存器上。实际使用中我会把SQW的1Hz信号接到F429的PA0上用HAL_EXTI_Callback累加一个秒计数串口每10秒打印一次当前时间戳。这样即使DS1307的振荡器突然停振一秒内就能从秒计数停滞发现异常。CH位的状态还可以在每次校时前回读一次防止设备长时间下电后时间回到出厂默认值。本文还有配套的精品资源点击获取 STM32F429驱动DS1307：硬件I2C时序与RTC例程详解
简介STM32F429 外设例程中的 DS1307 实时时钟方案定位于嵌入式初学者与进阶开发者用于解决单片机与 I2C 接口 RTC 芯片的驱动接入问题。例程基于 HAL 库完成 GPIO 复用功能配置、I2C 外设初始化和主从通信按照起始信号、从机地址、读写控制等协议时序实现时间数据的写入与读取并覆盖中断触发、错误检测与恢复策略能够帮助读者建立外设驱动的完整调试思路。资源包为 84.33MB 的 RAR 压缩包内部共 1437 个文件以 663 个 C 源文件、612 个头文件为核心附带启动汇编文件、SVD 设备描述、STemWin 等库文件及 MDK 工程配置同时提供 CHM 和 PDF 文档便于查阅寄存器定义与 API 说明。项目目录按外设功能划分结构清晰可以直接导入工程查看代码、定位指定外设驱动也方便移植到自己的电路板。已有 100 人学习下载适合配合 STM32F429 开发板进行 I2C、RTC 专题训练也可作为毕业设计或项目开发中“读取/设置系统时间”功能模块的参考范例。1. 给STM32F429单片机挂DS1307先别急着写I2C读写函数反直觉的一点是DS1307这颗芯片本身并不难难的往往是STM32F429单片机的硬件I2C外设上那一堆事件标志。F429主频最高168MHz处理1字节I2C传输只要几微秒可当你读回的时间始终停在同一个值、或者总线上拉死SDA时问题几乎都出在总线状态恢复上。下面顺着“寄存器映射 → I2C时序 → 读写函数 → BCD校验 → 走时验证”这条路径把一套可以直接编译跑起来的外设例程讲清楚寄存器为什么那样排、HAL函数参数怎么设、以及掉电之后DS1307到底靠什么记住时间。想让第一块RTC一次跑通或者想看看别人在F429上怎么处理硬件I2C坑的都适合往下看。2. 先搞懂DS1307的I2C时序再谈STM32F429的硬件I2C2.1 DS1307的寄存器映射与地址字节先弄清0x68和0xD0的关系DS1307是8引脚的I2C RTC芯片7位从机地址固定为0x68。主机发送时要把地址左移一位得到0xD0写和0xD1读。第一次接触这个芯片的人容易把0x68直接填进HAL_I2C_Mem_Read的DevAddress参数结果Ack失败实际上HAL库要求的是8位地址也就是0x68 1。这个细节属于“看着手册就会真调起来必翻车”的典型坑。时间寄存器从0x00到0x06按秒、分、时、星期、日、月、年排列全部以BCD码存储。0x07是控制寄存器负责方波输出和OUT引脚电平0x08到0x3F是56字节用户RAM可以在掉电前存少量配置参数。表2-1列出时间寄存器的位域后面写读函数时直接按位掩码取数。地址位7位6位5位4~位0含义0x00CH十秒2位秒4位秒 00–590x010十分3位分4位分 00–590x02012/24AM/PM或20小时位时6位时 1–12/0–230x03000星期3位1–70x0400十日2位日4位日 1–310x05世纪0十月1位月4位月 1–120x06十年4位年4位年 0–99I2C读时序和写时序都是标准流程起始条件、发设备地址、等ACK、发寄存器地址、读操作时再来一次起始、收数据、最后NACK加STOP。DS1307只支持标准模式100kHz挂在400kHz快速模式总线上偶尔会丢ACK所以F429例程里一般把DS1307单独放一条I2C总线或者把总线速率降到100kHz。2.2 硬件I2C还是模拟I2CSTM32F429的I2C事件模型2.2.1 硬件I2C的时钟与事件链F429的I2C1挂在APB1上最大42MHz。CubeMX里选标准模式、100kHz并填上升时间后CCR和TRISE两个寄存器的值会自动算好。真正需要手工处理的是I2C外设的状态机SR1寄存器里的SB、ADDR、BTF、RxNE、TxE标志在HAL库里由HAL_I2C_Mem_Read和HAL_I2C_Mem_Write封装完成。这两条函数是阻塞式的内部靠超时变量退出。例程里超时参数我一般给100ms。100kHz下传输7个字节的数据不到1ms100ms能覆盖总线仲裁和从机时钟延展的极端情况又不会让故障隐藏太久。硬件I2C最常见的问题是EV5阶段卡住也就是发出起始条件后SB一直不置位。原因通常是GPIO刚上电方向不定或者上一帧STOP没发干净导致总线忙。此时HAL_I2C_GetError返回HAL_I2C_ERROR_BUSY最直接的做法是执行一次总线恢复再重新初始化外设。2.2.2 模拟I2C的适用场景很多老工程师在F1/F4上宁愿用GPIO模拟I2C核心原因是硬件外设的状态机一旦进入奇怪状态复位动作比模拟实现麻烦得多。模拟I2C的好处是不依赖外设事件标志时序延迟用循环掐算就能控制移植到其它单片机也方便。代价是CPU占用高、不支持多主机仲裁时钟延展也要自己处理。对DS1307这种低速设备模拟I2C完全够用。无论是硬件I2C还是模拟I2C总线死锁后的恢复逻辑是一样的把SCL拉低连续输出9个下降沿让从机释放SDA最后给一个STOP。static void I2C_Bus_Reset_After_Deadlock(GPIO_TypeDef *port, uint16_t scl_pin) { // 将SCL临时配置为开漏输出SDA保持外部上拉 HAL_GPIO_WritePin(port, scl_pin, GPIO_PIN_RESET); for (int i 0; i 9; i) { HAL_GPIO_WritePin(port, scl_pin, GPIO_PIN_RESET); HAL_Delay(1); HAL_GPIO_WritePin(port, scl_pin, GPIO_PIN_SET); HAL_Delay(1); } // 发出STOPSDA在SCL高电平期间拉高 }逻辑说明I2C从机靠SCL时钟边沿释放总线9个脉冲足够覆盖DS1307内部状态不深的情况。参数里的port、scl_pin要对应实际接线HAL_Delay(1)在100kHz场景够用追求时序精度时可以换成微秒级延迟。恢复期间SDA引脚要配置成浮空输入或开漏输出不能是推挽输出否则会干扰从机释放总线。表2-2给出两种方式的对比。对比项硬件I2C模拟I2C传输速率最高400kHzDS1307限100kHz取决于GPIO翻转速度多主机仲裁支持不支持调试难度需处理事件标志逐位可控CPU占用低高3. 在STM32F429上搭建DS1307例程CubeMX参数与寄存器读写全流程3.1 用STM32CubeMX生成I2C1基础工程标准模式100kHzCubeMX里选STM32F429ZIT6SYS打开Serial Wire方便调试RCC用外部晶振并将频率按板子实际值配置。I2C1使能后参数面板里三个值最关键。参数名推荐值作用I2C Speed ModeStandard Mode匹配DS1307最高100kHzI2C Clock Speed100000SCL频率单位HzI2C Rise Time1000 ns标准模式上升时间上限这三个值背后对应F429参考手册里的CCR和TRISE寄存器。标准模式下SCL低电平最短4.7μs、高电平最短4.0μs100kHz是DS1307规格书的上限再提速没有收益反而容易在总线竞争时丢数据。生成代码后i2c.c里会出现一个hi2c1句柄地址和超时参数留给调用端填。值得确认的是GPIO复用。F429上I2C1默认在PB6SCL、PB7SDA部分板子或重映射配置会到PB8、PB9这两组都是AF4开漏复用。开漏输出是必须的不能配推挽推挽输出会让多个设备驱动总线时直接短路SDA拉不高也拉不低。生成代码后检查一下MX_GPIO_Init里对应引脚的模式开漏且带上拉即可。3.2 编写DS1307读写函数HAL库调用与参数逐项解释I2C基础工程就绪后封装DS1307自己的驱动。下面先给出头文件里的时间结构体和单字节读函数。typedef struct { uint8_t year; // 0-992000年偏移 uint8_t month; // 1-12 uint8_t date; // 1-31 uint8_t week; // 1-7对应周日到周六 uint8_t hour; // 0-2324小时制 uint8_t minute; // 0-59 uint8_t second; // 0-59 } DS1307_Time_t; uint8_t DS1307_ReadByte(uint8_t reg) { uint8_t val 0; // DevAddress必须是8位地址0x68左移一位得到0xD0 if (HAL_I2C_Mem_Read(hi2c1, 0x68 1, reg, I2C_MEMADD_SIZE_8BIT, val, 1, 100) ! HAL_OK) { // 读失败时先恢复总线再重新初始化I2C1 I2C_Bus_Reset_After_Deadlock(GPIOB, GPIO_PIN_6); HAL_I2C_DeInit(hi2c1); HAL_I2C_Init(hi2c1); } return val; }逻辑说明HAL_I2C_Mem_Read是完整的主机读函数内部先发START再写设备地址和寄存器地址然后发第二次START最后以NACK加STOP收尾。失败时总线上状态未知所以先恢复总线再重新初始化外设。I2C_MEMADD_SIZE_8BIT表示寄存器地址是一个字节超时100ms是这个字节本应在1ms内完成传输的宽松上限。DS1307支持从起始地址连续读读到0x3F后自动回卷。读时间函数一次把7个时间寄存器搬到结构体里。void DS1307_GetTime(DS1307_Time_t *t) { uint8_t buf[7] {0}; HAL_I2C_Mem_Read(hi2c1, 0x68 1, 0x00, I2C_MEMADD_SIZE_8BIT, buf, 7, 100); t-second BCD2DEC(buf[0] 0x7F); // 掩掉CH位 t-minute BCD2DEC(buf[1] 0x7F); t-hour BCD2DEC(buf[2] 0x3F); // 掩掉12/24位和20小时位 t-week BCD2DEC(buf[3] 0x07); t-date BCD2DEC(buf[4] 0x3F); t-month BCD2DEC(buf[5] 0x1F); t-year BCD2DEC(buf[6]); }这里的每次掩码都很关键原因在下一章详细讲但写例程时最好现在就带上。读7字节的参数含义buf是接收缓冲区7是要读的长度100是超时毫秒数。DS1307的地址指针在每次STOP后归零所以每次都必须从0x00起始如果读到一半总线出错下一次调用仍从0x00发起不会因为指针错位读到RAM区。写时间时用HAL_I2C_Mem_Write从0x00连续写7字节注意新芯片的CH位必须先清0否则时间永远不走。4. 时间寄存器里的BCD码与停振位DS1307例程最容易犯的错4.1 BCD码转换、CH停振标志和12/24小时制读回乱码的排查顺序DS1307内部时间以BCD码存储比如十二点五十九分三十一秒存的是0x01、0x59、0x31。如果直接把寄存器里的十六进制数当十进制打印新手常常以为读到了异常值。0x59在BCD里就是十进制59只是用8位二进制表示成了01011001。读写转换靠下面两个函数。static uint8_t BCD2DEC(uint8_t bcd) { // 高4位是十位低4位是个位 return (bcd 4) * 10 (bcd 0x0F); } static uint8_t DEC2BCD(uint8_t dec) { // 十进制的十位放进高4位个位放进低4位 return ((dec / 10) 4) | (dec % 10); }BCD2DEC的错误版本很常见比如写成(bcd 0xF0) (bcd 0x0F)0x59算出来是0x59当成十进制打印就成了89。另一个方向是DEC2BCD里先移个位再除以10结果完全乱套。所以这两个函数写完先做一轮单元验证把0x00、0x59、0x99都跑一遍。真正让时间不走的第一个坑是CH位。地址0x00的bit7叫CH出厂默认是1表示振荡器停振。新拿到的DS1307直接读秒寄存器会看到0x80以上的值而且时间不动。写时间函数时必须在写秒的同时把CH清零或单独向0x00写0x00。调试时先读0x00看原始值高于等于0x80就先清位再读。第二个坑是小时寄存器的bit6。bit6为1时按12小时制解释时间bit5变成AM/PM标志bit6为0时按24小时制解释bit5是20小时位。例程里通常固定用24小时制让bit6保持0读小时时统一掩掉0x3F。如果你读回的小时总是差12或者一直是12的倍数先检查是不是12小时制没按位处理。两处掩码组合起来调不过时间的排查顺序是先读秒寄存器看CH再读小时寄存器看bit6接着写一组已知时间比如0x00、0x59、0x23再立即读回看往返是否一致。不一致就往地址字节和I2C时序上想一致但下次上电变乱就往掉电保持方向查。4.2 掉电后的默认行为与VBAT电源策略如何确认时间还在走DS1307主电源VCC掉电后只要VBAT引脚上挂着纽扣电池或法拉电容振荡器和寄存器就继续运行RAM数据保留。VBAT电压不能比VCC高出太多否则芯片内部电源选择逻辑可能误判。参考手册建议VBAT在2.0到3.5V常用一颗CR1220串个1kΩ电阻接入。新出厂芯片CH1意味着振荡器从来没启动过如果你拆掉跳线帽直接给VCC供电不接VBAT时间照样走只是掉电后时间归零并恢复CH1。所以例程要有一个时钟初始化函数写入一次合法时间并把CH清0。校验是否在走时间隔一段时间读两次秒寄存器就行。uint8_t sec1 DS1307_ReadByte(0x00) 0x7F; HAL_Delay(1500); uint8_t sec2 DS1307_ReadByte(0x00) 0x7F; if (sec1 sec2) { // 秒值没变多半CH1停振或者总线异常 DS1307_WriteByte(0x00, DS1307_ReadByte(0x00) 0x7F); // 清除CH }这段代码是上电后的快速自检不是替代中断。HAL_Delay(1500)用1.5秒的余量避免临界时间误判比较两次秒值若相同则说明振荡器没走此时把0x00寄存器当前值写回并清掉CH位相当于给振荡器一个重启信号。参数说明0x00是秒寄存器地址 0x7F是清CH位写回时保留秒数值不变。5. SQW方波验证走时一分钟法看误差软件校时技巧5.1 让DS1307的SQW输出1Hz方波不用示波器也能确认振荡器比反复读秒寄存器更直观的办法是把0x07控制寄存器的SQWE位置1、RS位设成00让SQW引脚输出1Hz方波。该引脚是开漏输出F429这边接一个10kΩ上拉到3.3V再串一个LED或接到F429的EXTI引脚。LED每秒闪一次就能确认振荡器在工作如果不闪优先查CH位和晶振引脚上的负载电容。void DS1307_EnableSquareWave1Hz(void) { // SQWE1, RS0b00输出1Hz DS1307_WriteByte(0x07, 0x00 | 0x10); }逻辑说明0x07的bit4是SQWEbit1:bit0是RS。写0x10后SQW引脚输出由内部4.096kHz基准分频到1Hz。参数0x00保留OUT位默认低电平。更严谨的做法是先读旧值再只改相关位掩码但对DS1307直接写0x10通常也没问题。5.2 一分钟法测误差利用SQW方波做秒校准走时误差来自外部32.768kHz晶振的初始偏差典型值±20ppm一天约1.7秒。快速粗测方法对好当前时间等真实世界秒针对齐时读DS1307秒值并记录与串口打印的偏差。比如60秒后DS1307显示59说明每天慢约1秒。要更精确就数SQW引脚上的脉冲数在一分钟内直接统计真实秒数误差能压到毫秒级。硬件上想提精度就换负载电容匹配更好的晶振或温补晶振软件上则做每日校时在固定定时任务里把预设秒偏移加到寄存器上。实际使用中我会把SQW的1Hz信号接到F429的PA0上用HAL_EXTI_Callback累加一个秒计数串口每10秒打印一次当前时间戳。这样即使DS1307的振荡器突然停振一秒内就能从秒计数停滞发现异常。CH位的状态还可以在每次校时前回读一次防止设备长时间下电后时间回到出厂默认值。本文还有配套的精品资源点击获取