简介这份资源面向STM32初学者与嵌入式课程学习者提供基于HAL库的DS3231实时时钟模块完整读写方案重点解决如何用硬件I²C接口与外部时钟芯片通讯、完成时间设置与读取的问题。压缩包共91个文件约311KB以60个h头文件与23个c源文件为主体另含CubeMX配置文件、MDK工程文件、启动汇编及说明文本覆盖驱动层、CMSIS与HAL库等模块便于快速复现工程。目前已有585人学习下载。读者可从中获得可直接编译运行的DS3231驱动代码、时钟设置与读取逻辑、温度监测实现以及串口助手实时显示日期时间的完整链路注释详尽、层次清晰既能作为I²C协议与HAL库编程的练手案例也可扩展为DIY桌面时钟等实际项目对掌握外设模块应用有较大帮助。1. 从一块走时不准的板子说起STM32 接 DS3231 到底难在哪手头有块 STM32 的板子想加个靠谱的实时时钟很多人第一反应是上 DS3231。这颗芯片在圈子里口碑很稳内置温补晶振常温下走时精度能到 ±2ppm比 STM32 内部那个 RTC 强太多——内部 RTC 用 LSI 的话一天飘个几十秒是常事做数据记录、定时开关、日志打时间戳根本没法看。但真把 DS3231 焊上去、用 HAL 库去读翻车的概率并不低读出来全是 0xFF、秒数不动、I2C 卡死在 while 等待、写进去的时间断电就丢。问题往往不在 DS3231 本身而在 STM32 的硬件 I2C 配置和 HAL 库的调用姿势上。这篇就把 STM32 DS3231 的硬件 I2C 读写从头拆一遍从 CubeMX 配置到读写函数封装再到几个高频坑点目标是让你照着能跑通、断电不丢时间、读出来的 BCD 码能正确转成十进制。适合刚上手 HAL 库的嵌入式新手也适合被软件模拟 I2C 时序折磨过、想换硬件 I2C 的老手。2. 硬件 I2C 与 DS3231 的寄存器模型先把底层逻辑理清2.1 为什么优先用硬件 I2C 而不是软件模拟软件模拟 I2C 的好处是引脚随便选、时序自己控但代价是占用 CPU、时序靠延时凑主频一变或者中断一多就容易出错。硬件 I2C 由外设自己产生时钟和数据CPU 只管填数据寄存器、等标志位时序精度由外设保证。STM32 的硬件 I2C 在 F1 系列上确实有过一些历史遗留问题但在 F4、G0、G4、L4 这些较新的系列上已经稳定很多。DS3231 支持标准模式 100kHz 和快速模式 400kHz硬件 I2C 跑 100kHz 完全够用读一次 7 个字节的时间寄存器也就几百微秒。选硬件 I2C 的另一个理由是 HAL 库已经把底层时序封装好了HAL_I2C_Mem_Read和HAL_I2C_Mem_Write直接按「设备地址 寄存器地址 数据」的方式操作代码量比软件模拟少一半。2.2 DS3231 的寄存器地址与 BCD 编码DS3231 的寄存器是 BCD 编码的这点必须先搞清楚否则读出来的 0x23 你以为是 23其实是十进制的 35。时间寄存器从 0x00 到 0x06依次是秒、分、时、星期、日、月、年。秒寄存器 bit7 是时钟停止标志上电后如果没清秒不走。小时寄存器 bit6 是 12/24 小时制选择位bit5 在 24 小时制下是 20 小时位。这些位不处理读出来的时间就是错的。寄存器地址名称BCD 范围特殊位0x00秒00-59bit7 CH 时钟停止0x01分00-59无0x02时00-23bit6 12/24 制0x03星期1-7无0x04日01-31无0x05月01-12bit7 世纪位0x06年00-99无DS3231 的 7 位设备地址是 0x68HAL 库函数里要左移一位变成 0xD0写和 0xD1读但HAL_I2C_Mem_Read的DevAddress参数要求传 8 位地址所以直接填0x68 1即 0xD0。这一点很多人第一次用会填错填成 0x68 就读不到数据。2.3 CubeMX 里 I2C 外设的关键配置项在 CubeMX 里选好 I2C 外设后几个参数要盯一下。Clock Speed 设 100000对应 100kHz。Duty Cycle 在 100kHz 下选 2:1 就行。Analog Filter 和 Digital Filter 保持默认开启能滤掉一些毛刺。Own Address 随便填一个不冲突的主机模式下其实用不到。最关键的是 GPIO 引脚I2C 的 SCL 和 SDA 必须配置为开漏输出加外部上拉DS3231 模块板上一般自带 4.7k 上拉电阻如果自己画板子这两个电阻不能省。没有上拉I2C 总线拉不高读出来全是 0xFF 或者直接超时。/* I2C1 初始化片段CubeMX 生成后一般不用改但要知道每项含义 */ hi2c1.Instance I2C1; hi2c1.Init.ClockSpeed 100000; // 100kHz 标准模式 hi2c1.Init.DutyCycle I2C_DUTYCYCLE_2; // 占空比 2:1 hi2c1.Init.OwnAddress1 0; // 主机模式忽略 hi2c1.Init.AddressingMode I2C_ADDRESSINGMODE_7BIT; hi2c1.Init.DualAddressMode I2C_DUALADDRESS_DISABLE; hi2c1.Init.GeneralCallMode I2C_GENERALCALL_DISABLE; hi2c1.Init.NoStretchMode I2C_NOSTRETCH_DISABLE; // 允许时钟拉伸NoStretchMode建议保持 DISABLE也就是允许从机拉伸时钟。DS3231 在转换温度或者写 EEPROM 时会拉低 SCL如果禁止拉伸主机不等从机数据就会错。这个参数在 F1 的 HAL 里可能没有新系列都有。3. 读写函数封装从 BCD 转换到时间结构体3.1 BCD 与十进制互转的两个小函数BCD 码一个字节存两位十进制数高四位是十位低四位是个位。0x23 表示十进制 23。转换逻辑很简单但必须封装成函数不然每次读写都手写位运算容易错。/* BCD 转十进制0x23 - 23 */ uint8_t bcd_to_dec(uint8_t bcd) { return (bcd 4) * 10 (bcd 0x0F); } /* 十进制转 BCD23 - 0x23 */ uint8_t dec_to_bcd(uint8_t dec) { return ((dec / 10) 4) | (dec % 10); }这两个函数是后面所有读写的基础。注意dec_to_bcd里先除后取模顺序不能反。如果传入的 dec 大于 99结果会溢出所以调用前要保证时间值在合法范围内。3.2 用 HAL_I2C_Mem_Read 一次读出 7 个时间寄存器DS3231 的 0x00 到 0x06 地址连续可以一次读 7 个字节减少 I2C 起始停止的次数。HAL 库的HAL_I2C_Mem_Read正好支持这种连续读。/* DS3231 设备地址7 位地址 0x68 左移一位 */ #define DS3231_ADDR (0x68 1) /* 时间结构体 */ typedef struct { uint8_t sec; uint8_t min; uint8_t hour; uint8_t weekday; uint8_t day; uint8_t month; uint8_t year; } DS3231_Time; /* 一次读出 7 个寄存器并转成十进制 */ HAL_StatusTypeDef DS3231_GetTime(DS3231_Time *t) { uint8_t buf[7]; HAL_StatusTypeDef ret; ret HAL_I2C_Mem_Read(hi2c1, DS3231_ADDR, 0x00, I2C_MEMADD_SIZE_8BIT, buf, 7, 100); if (ret ! HAL_OK) { return ret; // 读失败直接返回调用方处理 } t-sec bcd_to_dec(buf[0] 0x7F); // 屏蔽 CH 位 t-min bcd_to_dec(buf[1] 0x7F); t-hour bcd_to_dec(buf[2] 0x3F); // 24 小时制屏蔽 bit6 t-weekday bcd_to_dec(buf[3] 0x07); t-day bcd_to_dec(buf[4] 0x3F); t-month bcd_to_dec(buf[5] 0x1F); // 屏蔽世纪位 t-year bcd_to_dec(buf[6]); return HAL_OK; }HAL_I2C_Mem_Read的参数依次是I2C 句柄、设备地址8 位、寄存器地址、寄存器地址长度DS3231 是 8 位、接收缓冲区、读取长度、超时毫秒。超时给 100ms 足够给太长卡死时等得久给太短正常读取可能不够。屏蔽位那几行是血泪经验不屏蔽 CH 位秒读出来会多 0x80不屏蔽小时 bit612 小时制下读出来会多 0x40。3.3 写入时间并清除时钟停止位写时间比读多一步要确保秒寄存器的 bit7CH 位为 0否则 DS3231 的时钟不走。上电后第一次写时间必须清这个位。HAL_StatusTypeDef DS3231_SetTime(DS3231_Time *t) { uint8_t buf[7]; buf[0] dec_to_bcd(t-sec) 0x7F; // 清 CH 位启动时钟 buf[1] dec_to_bcd(t-min); buf[2] dec_to_bcd(t-hour) 0x3F; // 24 小时制 buf[3] dec_to_bcd(t-weekday); buf[4] dec_to_bcd(t-day); buf[5] dec_to_bcd(t-month) 0x1F; buf[6] dec_to_bcd(t-year); return HAL_I2C_Mem_Write(hi2c1, DS3231_ADDR, 0x00, I2C_MEMADD_SIZE_8BIT, buf, 7, 100); }写入时buf[0]的 0x7F是关键它把 bit7 强制清零。如果只写dec_to_bcd(t-sec)而秒值恰好大于 79bit7 可能被置 1时钟就停了。写完建议立刻回读一次验证确认写入成功。3.4 温度寄存器与闹钟寄存器的扩展读法DS3231 还有温度寄存器和两个闹钟。温度在 0x11 和 0x12高字节是整数部分低字节高两位是小数部分分辨率 0.25 度。读温度可以单独读两个字节。float DS3231_GetTemp(void) { uint8_t buf[2]; if (HAL_I2C_Mem_Read(hi2c1, DS3231_ADDR, 0x11, I2C_MEMADD_SIZE_8BIT, buf, 2, 100) ! HAL_OK) { return -999.0f; // 错误标志 } int8_t integer (int8_t)buf[0]; uint8_t frac (buf[1] 6) 0x03; return integer frac * 0.25f; }温度值是有符号的buf[0]要强转int8_t否则零下温度会读成很大的正数。小数部分只取高两位乘以 0.25。这个函数在需要做温度补偿或者监控板子温度时很有用。4. 避坑与排查硬件 I2C 读 DS3231 的五个高频翻车点4.1 读出来全是 0xFF 或 0x00现象调用DS3231_GetTime返回 HAL_OK但 buf 里全是 0xFF 或者全 0。原因通常是 I2C 总线上没有从机应答或者上拉电阻缺失。DS3231 模块如果没接 VCC或者 SDA/SCL 接反主机发地址后收不到 ACKHAL 库在某些系列上会返回错误但在另一些系列上可能返回 OK 但数据是空的。解决先用万用表量 SDA 和 SCL 对 VCC 的电压空闲时应该是高电平接近 3.3V。如果只有 0.几伏说明上拉没起作用检查模块上的 4.7k 电阻或者自己补焊。再确认设备地址填的是0x68 1而不是 0x68。4.2 HAL_I2C_Mem_Read 卡死在 while 循环现象程序跑起来后卡在HAL_I2C_Mem_Read里出不来看门狗复位。原因多半是 I2C 总线被拉死某个从机在传输中途掉电或者复位把 SDA 拉低不放。解决在初始化后加一个总线恢复函数手动发 9 个时钟脉冲把从机状态机打回空闲。另外检查NoStretchMode是不是设成了 ENABLE设成 ENABLE 时从机拉伸时钟会被忽略容易出错。超时参数也别给 0xFFFF给 100 就行卡住能及时返回。/* I2C 总线恢复SCL 手动发 9 个脉冲 */ void I2C_Bus_Recover(void) { GPIO_InitTypeDef gpio {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); gpio.Pin GPIO_PIN_6 | GPIO_PIN_7; // 假设 SCLPB6, SDAPB7 gpio.Mode GPIO_MODE_OUTPUT_OD; gpio.Pull GPIO_PULLUP; gpio.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, gpio); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_SET); for (int i 0; i 9; i) { HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_RESET); HAL_Delay(1); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_SET); HAL_Delay(1); } /* 恢复后重新初始化 I2C 外设 */ MX_I2C1_Init(); }这个函数在HAL_I2C_Mem_Read返回错误后调用一次能把大部分拉死的情况救回来。注意恢复完要重新调MX_I2C1_Init不然 GPIO 还停在手动模式。4.3 时间不走秒数一直不变现象读出来的时间每次都一样秒数不递增。原因有两个一是 CH 位没清时钟处于停止状态二是写时间时秒值没写对或者根本没写成功。解决先读一次秒寄存器看 bit7 是不是 1。如果是 1调用DS3231_SetTime重新写一遍确保buf[0] 0x7F。如果写完后秒还不走检查晶振有没有起振DS3231 模块上的 32.768kHz 晶振如果虚焊芯片内部振荡器不工作时间自然不走。可以用示波器量晶振引脚正常应该有正弦波。4.4 断电后时间丢失现象断电再上电读出来的时间是 2000 年 1 月 1 日或者全 0。原因DS3231 有备用电池引脚 VBAT如果没接电池或者电池没电主电源掉电后寄存器内容丢失。解决在 VBAT 引脚接一颗 CR2032 纽扣电池注意正负极。电池座焊接时别烫太久CR2032 怕热。如果接了电池还丢量一下 VBAT 电压低于 2.0V 就该换了。另外有些模块把 VBAT 和 VCC 短接了这种模块断电必丢买的时候看清楚。4.5 BCD 转换后时间数值偏大或偏小现象读出来的分钟是 35实际是 23或者小时是 18实际是 12。原因BCD 转换函数用错或者屏蔽位没做。比如小时寄存器在 12 小时制下 bit6 是 1不屏蔽直接转 BCD0x52 会转成 52实际是 12。解决确认bcd_to_dec的输入已经屏蔽了特殊位。秒屏蔽 0x7F分屏蔽 0x7F时屏蔽 0x3F日屏蔽 0x3F月屏蔽 0x1F。星期寄存器只有低三位有效屏蔽 0x07。把这些屏蔽位写死在读取函数里别指望调用方处理。5. 进阶技巧用闹钟中断做周期唤醒与时间校验5.1 配置闹钟 1 实现每秒或每分钟中断DS3231 的闹钟 1 寄存器在 0x07 到 0x0A可以配置成匹配秒、分、时、日任意组合。做低功耗周期唤醒时把闹钟配成每秒触发一次DS3231 的 INT/SQW 引脚会拉低接在 STM32 的外部中断引脚上就能把 MCU 从 STOP 模式唤醒。配置闹钟的关键是掩码位寄存器 bit7 是掩码位置 1 表示该位不参与匹配。比如要每秒触发秒、分、时、日的掩码都置 1只靠秒寄存器变化触发。/* 配置闹钟 1 每秒触发一次 */ void DS3231_SetAlarm1_PerSec(void) { uint8_t buf[4]; buf[0] 0x80; // 秒掩码置 1不匹配秒 buf[1] 0x80; // 分掩码 buf[2] 0x80; // 时掩码 buf[3] 0x80; // 日掩码 HAL_I2C_Mem_Write(hi2c1, DS3231_ADDR, 0x07, I2C_MEMADD_SIZE_8BIT, buf, 4, 100); /* 清闹钟标志使能闹钟中断 */ uint8_t ctrl 0x05; // A1IE1, INTCN1 HAL_I2C_Mem_Write(hi2c1, DS3231_ADDR, 0x0E, I2C_MEMADD_SIZE_8BIT, ctrl, 1, 100); }控制寄存器 0x0E 的 bit0 是 A1IEbit2 是 INTCN。INTCN 置 1 时 INT/SQW 引脚才输出中断而不是方波。闹钟触发后要读 0x0F 状态寄存器清标志否则中断不会再次触发。5.2 用温度值做走时精度自检DS3231 内部温度每 64 秒更新一次温度变化会影响晶振频率。如果发现走时偏快或偏慢可以读温度值对照 DS3231 数据手册里的温度-频率曲线估算偏差。更实用的做法是用 STM32 的定时器做一个 1 秒基准和 DS3231 的秒中断对比连续测 24 小时算出每天偏差多少秒。如果偏差超过 2 秒检查晶振负载电容是否匹配DS3231 要求 6pF 负载电容模块上一般已经配好自己画板子要算准。5.3 时间校验写入后回读比对写完时间后立刻回读一次逐字段比对不一致就重写。这个习惯能挡掉大部分写入失败的情况。我一般会在DS3231_SetTime后面加一个DS3231_VerifyTime把写入的结构体和回读的结构体逐项比较任何一项不等就返回错误上层决定是否重试。重试三次还失败就点亮一个错误 LED 或者记录到日志。这个校验逻辑在量产测试时特别有用能筛出焊接不良或者芯片损坏的板子。/* 写入后回读校验返回 0 表示一致 */ int DS3231_VerifyTime(DS3231_Time *expect) { DS3231_Time actual; if (DS3231_GetTime(actual) ! HAL_OK) return -1; if (actual.sec ! expect-sec) return -2; if (actual.min ! expect-min) return -3; if (actual.hour ! expect-hour) return -4; if (actual.day ! expect-day) return -5; if (actual.month ! expect-month) return -6; if (actual.year ! expect-year) return -7; return 0; }从那以后我每次写完 DS3231 的时间都强制走一遍回读校验不通过就重写最多三次。这个习惯帮我省掉了很多「现场时间不对」的售后麻烦。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/15 11:21:15 · 阅读 1.2k STM32硬件I2C驱动DS3231实战：从配置到避坑
简介这份资源面向STM32初学者与嵌入式课程学习者提供基于HAL库的DS3231实时时钟模块完整读写方案重点解决如何用硬件I²C接口与外部时钟芯片通讯、完成时间设置与读取的问题。压缩包共91个文件约311KB以60个h头文件与23个c源文件为主体另含CubeMX配置文件、MDK工程文件、启动汇编及说明文本覆盖驱动层、CMSIS与HAL库等模块便于快速复现工程。目前已有585人学习下载。读者可从中获得可直接编译运行的DS3231驱动代码、时钟设置与读取逻辑、温度监测实现以及串口助手实时显示日期时间的完整链路注释详尽、层次清晰既能作为I²C协议与HAL库编程的练手案例也可扩展为DIY桌面时钟等实际项目对掌握外设模块应用有较大帮助。1. 从一块走时不准的板子说起STM32 接 DS3231 到底难在哪手头有块 STM32 的板子想加个靠谱的实时时钟很多人第一反应是上 DS3231。这颗芯片在圈子里口碑很稳内置温补晶振常温下走时精度能到 ±2ppm比 STM32 内部那个 RTC 强太多——内部 RTC 用 LSI 的话一天飘个几十秒是常事做数据记录、定时开关、日志打时间戳根本没法看。但真把 DS3231 焊上去、用 HAL 库去读翻车的概率并不低读出来全是 0xFF、秒数不动、I2C 卡死在 while 等待、写进去的时间断电就丢。问题往往不在 DS3231 本身而在 STM32 的硬件 I2C 配置和 HAL 库的调用姿势上。这篇就把 STM32 DS3231 的硬件 I2C 读写从头拆一遍从 CubeMX 配置到读写函数封装再到几个高频坑点目标是让你照着能跑通、断电不丢时间、读出来的 BCD 码能正确转成十进制。适合刚上手 HAL 库的嵌入式新手也适合被软件模拟 I2C 时序折磨过、想换硬件 I2C 的老手。2. 硬件 I2C 与 DS3231 的寄存器模型先把底层逻辑理清2.1 为什么优先用硬件 I2C 而不是软件模拟软件模拟 I2C 的好处是引脚随便选、时序自己控但代价是占用 CPU、时序靠延时凑主频一变或者中断一多就容易出错。硬件 I2C 由外设自己产生时钟和数据CPU 只管填数据寄存器、等标志位时序精度由外设保证。STM32 的硬件 I2C 在 F1 系列上确实有过一些历史遗留问题但在 F4、G0、G4、L4 这些较新的系列上已经稳定很多。DS3231 支持标准模式 100kHz 和快速模式 400kHz硬件 I2C 跑 100kHz 完全够用读一次 7 个字节的时间寄存器也就几百微秒。选硬件 I2C 的另一个理由是 HAL 库已经把底层时序封装好了HAL_I2C_Mem_Read和HAL_I2C_Mem_Write直接按「设备地址 寄存器地址 数据」的方式操作代码量比软件模拟少一半。2.2 DS3231 的寄存器地址与 BCD 编码DS3231 的寄存器是 BCD 编码的这点必须先搞清楚否则读出来的 0x23 你以为是 23其实是十进制的 35。时间寄存器从 0x00 到 0x06依次是秒、分、时、星期、日、月、年。秒寄存器 bit7 是时钟停止标志上电后如果没清秒不走。小时寄存器 bit6 是 12/24 小时制选择位bit5 在 24 小时制下是 20 小时位。这些位不处理读出来的时间就是错的。寄存器地址名称BCD 范围特殊位0x00秒00-59bit7 CH 时钟停止0x01分00-59无0x02时00-23bit6 12/24 制0x03星期1-7无0x04日01-31无0x05月01-12bit7 世纪位0x06年00-99无DS3231 的 7 位设备地址是 0x68HAL 库函数里要左移一位变成 0xD0写和 0xD1读但HAL_I2C_Mem_Read的DevAddress参数要求传 8 位地址所以直接填0x68 1即 0xD0。这一点很多人第一次用会填错填成 0x68 就读不到数据。2.3 CubeMX 里 I2C 外设的关键配置项在 CubeMX 里选好 I2C 外设后几个参数要盯一下。Clock Speed 设 100000对应 100kHz。Duty Cycle 在 100kHz 下选 2:1 就行。Analog Filter 和 Digital Filter 保持默认开启能滤掉一些毛刺。Own Address 随便填一个不冲突的主机模式下其实用不到。最关键的是 GPIO 引脚I2C 的 SCL 和 SDA 必须配置为开漏输出加外部上拉DS3231 模块板上一般自带 4.7k 上拉电阻如果自己画板子这两个电阻不能省。没有上拉I2C 总线拉不高读出来全是 0xFF 或者直接超时。/* I2C1 初始化片段CubeMX 生成后一般不用改但要知道每项含义 */ hi2c1.Instance I2C1; hi2c1.Init.ClockSpeed 100000; // 100kHz 标准模式 hi2c1.Init.DutyCycle I2C_DUTYCYCLE_2; // 占空比 2:1 hi2c1.Init.OwnAddress1 0; // 主机模式忽略 hi2c1.Init.AddressingMode I2C_ADDRESSINGMODE_7BIT; hi2c1.Init.DualAddressMode I2C_DUALADDRESS_DISABLE; hi2c1.Init.GeneralCallMode I2C_GENERALCALL_DISABLE; hi2c1.Init.NoStretchMode I2C_NOSTRETCH_DISABLE; // 允许时钟拉伸NoStretchMode建议保持 DISABLE也就是允许从机拉伸时钟。DS3231 在转换温度或者写 EEPROM 时会拉低 SCL如果禁止拉伸主机不等从机数据就会错。这个参数在 F1 的 HAL 里可能没有新系列都有。3. 读写函数封装从 BCD 转换到时间结构体3.1 BCD 与十进制互转的两个小函数BCD 码一个字节存两位十进制数高四位是十位低四位是个位。0x23 表示十进制 23。转换逻辑很简单但必须封装成函数不然每次读写都手写位运算容易错。/* BCD 转十进制0x23 - 23 */ uint8_t bcd_to_dec(uint8_t bcd) { return (bcd 4) * 10 (bcd 0x0F); } /* 十进制转 BCD23 - 0x23 */ uint8_t dec_to_bcd(uint8_t dec) { return ((dec / 10) 4) | (dec % 10); }这两个函数是后面所有读写的基础。注意dec_to_bcd里先除后取模顺序不能反。如果传入的 dec 大于 99结果会溢出所以调用前要保证时间值在合法范围内。3.2 用 HAL_I2C_Mem_Read 一次读出 7 个时间寄存器DS3231 的 0x00 到 0x06 地址连续可以一次读 7 个字节减少 I2C 起始停止的次数。HAL 库的HAL_I2C_Mem_Read正好支持这种连续读。/* DS3231 设备地址7 位地址 0x68 左移一位 */ #define DS3231_ADDR (0x68 1) /* 时间结构体 */ typedef struct { uint8_t sec; uint8_t min; uint8_t hour; uint8_t weekday; uint8_t day; uint8_t month; uint8_t year; } DS3231_Time; /* 一次读出 7 个寄存器并转成十进制 */ HAL_StatusTypeDef DS3231_GetTime(DS3231_Time *t) { uint8_t buf[7]; HAL_StatusTypeDef ret; ret HAL_I2C_Mem_Read(hi2c1, DS3231_ADDR, 0x00, I2C_MEMADD_SIZE_8BIT, buf, 7, 100); if (ret ! HAL_OK) { return ret; // 读失败直接返回调用方处理 } t-sec bcd_to_dec(buf[0] 0x7F); // 屏蔽 CH 位 t-min bcd_to_dec(buf[1] 0x7F); t-hour bcd_to_dec(buf[2] 0x3F); // 24 小时制屏蔽 bit6 t-weekday bcd_to_dec(buf[3] 0x07); t-day bcd_to_dec(buf[4] 0x3F); t-month bcd_to_dec(buf[5] 0x1F); // 屏蔽世纪位 t-year bcd_to_dec(buf[6]); return HAL_OK; }HAL_I2C_Mem_Read的参数依次是I2C 句柄、设备地址8 位、寄存器地址、寄存器地址长度DS3231 是 8 位、接收缓冲区、读取长度、超时毫秒。超时给 100ms 足够给太长卡死时等得久给太短正常读取可能不够。屏蔽位那几行是血泪经验不屏蔽 CH 位秒读出来会多 0x80不屏蔽小时 bit612 小时制下读出来会多 0x40。3.3 写入时间并清除时钟停止位写时间比读多一步要确保秒寄存器的 bit7CH 位为 0否则 DS3231 的时钟不走。上电后第一次写时间必须清这个位。HAL_StatusTypeDef DS3231_SetTime(DS3231_Time *t) { uint8_t buf[7]; buf[0] dec_to_bcd(t-sec) 0x7F; // 清 CH 位启动时钟 buf[1] dec_to_bcd(t-min); buf[2] dec_to_bcd(t-hour) 0x3F; // 24 小时制 buf[3] dec_to_bcd(t-weekday); buf[4] dec_to_bcd(t-day); buf[5] dec_to_bcd(t-month) 0x1F; buf[6] dec_to_bcd(t-year); return HAL_I2C_Mem_Write(hi2c1, DS3231_ADDR, 0x00, I2C_MEMADD_SIZE_8BIT, buf, 7, 100); }写入时buf[0]的 0x7F是关键它把 bit7 强制清零。如果只写dec_to_bcd(t-sec)而秒值恰好大于 79bit7 可能被置 1时钟就停了。写完建议立刻回读一次验证确认写入成功。3.4 温度寄存器与闹钟寄存器的扩展读法DS3231 还有温度寄存器和两个闹钟。温度在 0x11 和 0x12高字节是整数部分低字节高两位是小数部分分辨率 0.25 度。读温度可以单独读两个字节。float DS3231_GetTemp(void) { uint8_t buf[2]; if (HAL_I2C_Mem_Read(hi2c1, DS3231_ADDR, 0x11, I2C_MEMADD_SIZE_8BIT, buf, 2, 100) ! HAL_OK) { return -999.0f; // 错误标志 } int8_t integer (int8_t)buf[0]; uint8_t frac (buf[1] 6) 0x03; return integer frac * 0.25f; }温度值是有符号的buf[0]要强转int8_t否则零下温度会读成很大的正数。小数部分只取高两位乘以 0.25。这个函数在需要做温度补偿或者监控板子温度时很有用。4. 避坑与排查硬件 I2C 读 DS3231 的五个高频翻车点4.1 读出来全是 0xFF 或 0x00现象调用DS3231_GetTime返回 HAL_OK但 buf 里全是 0xFF 或者全 0。原因通常是 I2C 总线上没有从机应答或者上拉电阻缺失。DS3231 模块如果没接 VCC或者 SDA/SCL 接反主机发地址后收不到 ACKHAL 库在某些系列上会返回错误但在另一些系列上可能返回 OK 但数据是空的。解决先用万用表量 SDA 和 SCL 对 VCC 的电压空闲时应该是高电平接近 3.3V。如果只有 0.几伏说明上拉没起作用检查模块上的 4.7k 电阻或者自己补焊。再确认设备地址填的是0x68 1而不是 0x68。4.2 HAL_I2C_Mem_Read 卡死在 while 循环现象程序跑起来后卡在HAL_I2C_Mem_Read里出不来看门狗复位。原因多半是 I2C 总线被拉死某个从机在传输中途掉电或者复位把 SDA 拉低不放。解决在初始化后加一个总线恢复函数手动发 9 个时钟脉冲把从机状态机打回空闲。另外检查NoStretchMode是不是设成了 ENABLE设成 ENABLE 时从机拉伸时钟会被忽略容易出错。超时参数也别给 0xFFFF给 100 就行卡住能及时返回。/* I2C 总线恢复SCL 手动发 9 个脉冲 */ void I2C_Bus_Recover(void) { GPIO_InitTypeDef gpio {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); gpio.Pin GPIO_PIN_6 | GPIO_PIN_7; // 假设 SCLPB6, SDAPB7 gpio.Mode GPIO_MODE_OUTPUT_OD; gpio.Pull GPIO_PULLUP; gpio.Speed GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, gpio); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_7, GPIO_PIN_SET); for (int i 0; i 9; i) { HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_RESET); HAL_Delay(1); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6, GPIO_PIN_SET); HAL_Delay(1); } /* 恢复后重新初始化 I2C 外设 */ MX_I2C1_Init(); }这个函数在HAL_I2C_Mem_Read返回错误后调用一次能把大部分拉死的情况救回来。注意恢复完要重新调MX_I2C1_Init不然 GPIO 还停在手动模式。4.3 时间不走秒数一直不变现象读出来的时间每次都一样秒数不递增。原因有两个一是 CH 位没清时钟处于停止状态二是写时间时秒值没写对或者根本没写成功。解决先读一次秒寄存器看 bit7 是不是 1。如果是 1调用DS3231_SetTime重新写一遍确保buf[0] 0x7F。如果写完后秒还不走检查晶振有没有起振DS3231 模块上的 32.768kHz 晶振如果虚焊芯片内部振荡器不工作时间自然不走。可以用示波器量晶振引脚正常应该有正弦波。4.4 断电后时间丢失现象断电再上电读出来的时间是 2000 年 1 月 1 日或者全 0。原因DS3231 有备用电池引脚 VBAT如果没接电池或者电池没电主电源掉电后寄存器内容丢失。解决在 VBAT 引脚接一颗 CR2032 纽扣电池注意正负极。电池座焊接时别烫太久CR2032 怕热。如果接了电池还丢量一下 VBAT 电压低于 2.0V 就该换了。另外有些模块把 VBAT 和 VCC 短接了这种模块断电必丢买的时候看清楚。4.5 BCD 转换后时间数值偏大或偏小现象读出来的分钟是 35实际是 23或者小时是 18实际是 12。原因BCD 转换函数用错或者屏蔽位没做。比如小时寄存器在 12 小时制下 bit6 是 1不屏蔽直接转 BCD0x52 会转成 52实际是 12。解决确认bcd_to_dec的输入已经屏蔽了特殊位。秒屏蔽 0x7F分屏蔽 0x7F时屏蔽 0x3F日屏蔽 0x3F月屏蔽 0x1F。星期寄存器只有低三位有效屏蔽 0x07。把这些屏蔽位写死在读取函数里别指望调用方处理。5. 进阶技巧用闹钟中断做周期唤醒与时间校验5.1 配置闹钟 1 实现每秒或每分钟中断DS3231 的闹钟 1 寄存器在 0x07 到 0x0A可以配置成匹配秒、分、时、日任意组合。做低功耗周期唤醒时把闹钟配成每秒触发一次DS3231 的 INT/SQW 引脚会拉低接在 STM32 的外部中断引脚上就能把 MCU 从 STOP 模式唤醒。配置闹钟的关键是掩码位寄存器 bit7 是掩码位置 1 表示该位不参与匹配。比如要每秒触发秒、分、时、日的掩码都置 1只靠秒寄存器变化触发。/* 配置闹钟 1 每秒触发一次 */ void DS3231_SetAlarm1_PerSec(void) { uint8_t buf[4]; buf[0] 0x80; // 秒掩码置 1不匹配秒 buf[1] 0x80; // 分掩码 buf[2] 0x80; // 时掩码 buf[3] 0x80; // 日掩码 HAL_I2C_Mem_Write(hi2c1, DS3231_ADDR, 0x07, I2C_MEMADD_SIZE_8BIT, buf, 4, 100); /* 清闹钟标志使能闹钟中断 */ uint8_t ctrl 0x05; // A1IE1, INTCN1 HAL_I2C_Mem_Write(hi2c1, DS3231_ADDR, 0x0E, I2C_MEMADD_SIZE_8BIT, ctrl, 1, 100); }控制寄存器 0x0E 的 bit0 是 A1IEbit2 是 INTCN。INTCN 置 1 时 INT/SQW 引脚才输出中断而不是方波。闹钟触发后要读 0x0F 状态寄存器清标志否则中断不会再次触发。5.2 用温度值做走时精度自检DS3231 内部温度每 64 秒更新一次温度变化会影响晶振频率。如果发现走时偏快或偏慢可以读温度值对照 DS3231 数据手册里的温度-频率曲线估算偏差。更实用的做法是用 STM32 的定时器做一个 1 秒基准和 DS3231 的秒中断对比连续测 24 小时算出每天偏差多少秒。如果偏差超过 2 秒检查晶振负载电容是否匹配DS3231 要求 6pF 负载电容模块上一般已经配好自己画板子要算准。5.3 时间校验写入后回读比对写完时间后立刻回读一次逐字段比对不一致就重写。这个习惯能挡掉大部分写入失败的情况。我一般会在DS3231_SetTime后面加一个DS3231_VerifyTime把写入的结构体和回读的结构体逐项比较任何一项不等就返回错误上层决定是否重试。重试三次还失败就点亮一个错误 LED 或者记录到日志。这个校验逻辑在量产测试时特别有用能筛出焊接不良或者芯片损坏的板子。/* 写入后回读校验返回 0 表示一致 */ int DS3231_VerifyTime(DS3231_Time *expect) { DS3231_Time actual; if (DS3231_GetTime(actual) ! HAL_OK) return -1; if (actual.sec ! expect-sec) return -2; if (actual.min ! expect-min) return -3; if (actual.hour ! expect-hour) return -4; if (actual.day ! expect-day) return -5; if (actual.month ! expect-month) return -6; if (actual.year ! expect-year) return -7; return 0; }从那以后我每次写完 DS3231 的时间都强制走一遍回读校验不通过就重写最多三次。这个习惯帮我省掉了很多「现场时间不对」的售后麻烦。希望帮到你。本文还有配套的精品资源点击获取