STM32F103驱动DS1302时钟模块，手把手教你用GPIO模拟时序（附OLED显示完整代码）

STM32F103驱动DS1302时钟模块实战指南：从GPIO时序模拟到OLED显示

1. 项目背景与硬件准备

在嵌入式开发中，实时时钟（RTC）模块是许多项目的核心组件。DS1302作为一款经典的实时时钟芯片，以其低成本、高可靠性和简单的三线接口而广受欢迎。不同于常见的I2C或SPI接口设备，DS1302采用独特的同步串行通信协议，这给许多初学者带来了挑战。

所需硬件清单：

• STM32F103C8T6开发板（蓝板）
• DS1302时钟模块（含32.768kHz晶振）
• 0.96寸OLED显示屏（7针SPI接口）
• 3V纽扣电池（用于DS1302备用电源）
• 杜邦线若干

提示：DS1302模块上的VCC2引脚务必连接纽扣电池，这样在主电源断开时仍能保持计时。我曾因忽略这点导致每次上电都需要重新设置时间。

2. DS1302通信协议深度解析

2.1 引脚功能与电气特性

DS1302采用5引脚设计，关键引脚功能如下表所示：

2.2 通信时序关键点

DS1302的通信协议既不是I2C也不是SPI，而是需要精确模拟的同步串行协议。以下是几个关键时序特征：

1. 单字节写时序：

   • 先发送8位命令字节（LSB first）
   • 再发送8位数据字节
   • 所有数据在SCLK上升沿被DS1302采样

2. 单字节读时序：

   • 发送8位命令字节后
   • DS1302在SCLK下降沿输出数据
   • 主机在SCLK上升沿读取数据

// 典型写时序代码片段 void DS1302_WriteByte(uint8_t cmd, uint8_t data) { CE_HIGH(); for(int i=0; i<8; i++) { SCLK_LOW(); GPIO_WriteBit(IO_PORT, IO_PIN, (cmd>>i) & 0x01); SCLK_HIGH(); // 上升沿锁存数据 } // 重复上述过程发送data CE_LOW(); }

3. STM32 GPIO模拟实现

3.1 硬件连接方案

推荐以下连接方式，可最大限度减少信号干扰：

3.2 精确延时实现

DS1302对时序要求严格，需实现微秒级延时。以下是两种实现方案对比：

方案对比表：

推荐使用系统滴答定时器实现：

void Delay_us(uint32_t us) { uint32_t ticks = us * (SystemCoreClock / 1000000); uint32_t start = DWT->CYCCNT; while((DWT->CYCCNT - start) < ticks); }

4. 完整工程代码剖析

4.1 寄存器操作封装

DS1302的所有功能都通过寄存器访问实现，关键寄存器如下：

// 寄存器地址定义 #define SEC_REG 0x80 #define MIN_REG 0x82 #define HR_REG 0x84 #define DATE_REG 0x86 #define MONTH_REG 0x88 #define DAY_REG 0x8A #define YEAR_REG 0x8C #define WP_REG 0x8E // 写保护寄存器 // BCD码转换宏 #define BCD2DEC(bcd) (((bcd)>>4)*10 + ((bcd)&0x0F)) #define DEC2BCD(dec) ((((dec)/10)<<4) | ((dec)%10))

4.2 时间设置与读取流程

完整的RTC操作应遵循以下步骤：

1. 初始化序列：

   • 关闭写保护（WP_REG写入0x00）
   • 停止时钟（SEC_REG的CH位设为1）
   • 写入各时间寄存器
   • 启动时钟（SEC_REG的CH位设为0）
   • 开启写保护（WP_REG写入0x80）

2. 读取时间示例：

void DS1302_GetTime(TimeStruct *time) { time->seconds = BCD2DEC(DS1302_ReadRegister(SEC_REG) & 0x7F); time->minutes = BCD2DEC(DS1302_ReadRegister(MIN_REG)); // ...读取其他字段 }

5. OLED显示集成与优化

5.1 SPI驱动配置

STM32硬件SPI配置要点：

void SPI_Config(void) { SPI_InitTypeDef SPI_InitStructure; SPI_InitStructure.SPI_Direction = SPI_Direction_1Line_Tx; SPI_InitStructure.SPI_Mode = SPI_Mode_Master; SPI_InitStructure.SPI_DataSize = SPI_DataSize_8b; SPI_InitStructure.SPI_CPOL = SPI_CPOL_High; SPI_InitStructure.SPI_CPHA = SPI_CPHA_2Edge; SPI_InitStructure.SPI_NSS = SPI_NSS_Soft; SPI_InitStructure.SPI_BaudRatePrescaler = SPI_BaudRatePrescaler_4; SPI_Init(SPI1, &SPI_InitStructure); SPI_Cmd(SPI1, ENABLE); }

5.2 显示界面设计

推荐的时间显示布局方案：

+-------------------------------+ | 2023-07-15 周五 | | | | 12:30:45 | | | | 电池状态：● | +-------------------------------+

实现代码片段：

void OLED_ShowTime(TimeStruct time) { OLED_ShowNum(30, 2, time.hour, 2, 16); OLED_ShowString(54, 2, ":"); OLED_ShowNum(60, 2, time.minute, 2, 16); // 显示其他信息... }

6. 常见问题与调试技巧

问题1：读取的时间数据全为0

• 检查CE引脚是否在传输期间保持高电平
• 确认SCLK频率不超过DS1302的2MHz限制
• 测量VCC1电压是否在2.0V-5.5V范围内

问题2：时间走时不准

• 更换32.768kHz晶振，选择负载电容匹配的型号
• 在X1和X2引脚添加6pF的负载电容
• 检查电源稳定性，电压波动会影响晶振精度

注意：调试时建议先用示波器检查SCLK和I/O信号波形，确保时序符合DS1302规格书要求。我曾遇到因GPIO配置错误导致信号上升沿过缓的问题，通过降低GPIO速度设置解决。

7. 项目进阶与扩展

完成基础功能后，可以考虑以下增强功能：

1. 闹钟功能：

   • 利用STM32的RTC或定时器实现
   • 通过蜂鸣器或LED提供视觉/听觉提示

2. 温度补偿：

   void ApplyTempCompensation(float temp) { // 根据温度调整计时补偿值 // 典型值：-0.035ppm/℃² }

3. 低功耗优化：

   • 在电池供电时关闭OLED
   • 使用STM32的停止模式
   • 动态调整系统时钟频率

实际测试发现，完整系统在3.3V供电时的工作电流：

• 全速运行：约25mA
• 仅DS1302工作：约300μA
• 备用电池模式：<1μA

8. 完整工程代码结构

最终项目应包含以下文件：

/DS1302_OLED ├── Core │ ├── Src │ │ ├── main.c │ │ └── stm32f1xx_it.c ├── Drivers │ ├── DS1302 │ │ ├── ds1302.c │ │ └── ds1302.h │ └── OLED │ ├── oled.c │ ├── oled.h │ └── oledfont.h └── STM32F1xx_HAL_Driver

在移植到其他STM32系列时，主要需要修改的是GPIO和SPI的初始化部分。例如，对于STM32F4系列，需要调整时钟使能方式和SPI配置参数。