简介面向STM32开发者的PCF8563实时时钟驱动库软件包以库函数方式实现了I²C通信并附带串口调试相关代码适合嵌入式开发者、尤其是使用STM32标准外设库的初中级开发者在项目中快速接入低功耗RTC芯片完成日期时间读取、闹钟设置等操作。压缩包共190个文件体积4.66MB包含.c/.h源码、Keil工程文件.uvprojx/.uvoptx、编译产物.o/.axf/.hex/.map以及.bak备份等目录结构完整便于二次编译和对比学习。已有691人学习/下载。资源内除PCF8563基础驱动外还可见stm32f10x_i2c、stm32f10x_rcc等标准外设库文件保留了可参考的驱动程序适合理解GPIO配置、IIC时序与串口打印的完整流程。借助该软件包可快速搭建STM32与PCF8563的通信工程减少底层寄存器配置工作量代码中已包含RCC时钟配置、I2C通信时序和串口重定向等关键模块注释较完整可读性较好也可用于学习STM32标准外设库调用方式、对照调试或移植到其他项目。1. 串口调 RTC拆一个 STM32F103 PCF8563 库函数工程的套路STM32F103 片内自带 RTC但做计时产品时它并不是首选掉电要单独伺候 VBAT校准要算补偿值而且一旦主控复位时间源也跟着不可信。这个工程走的是另一条路——外挂 PCF8563用硬件 I2C1 读写再用串口把时间打出来、把设置命令送进去。编译产物里能看到 stm32f10x_i2c.c、stm32f10x_usart 相关文件被一起链进来说明 I2C 和串口是同一套代码里两条并行的主线。对刚接触标准外设库的人这份代码的价值在于它能一次讲清楚三件事I2C 事件状态机怎么用、PCF8563 的 BCD 寄存器怎么换算、printf 怎么从串口吐出来。2. PCF8563 寄存器映射与 STM32 I2C 初始化细节2.1 为什么选 PCF8563 而不是片内 RTC 或 DS1302片内 RTC 的优势是零成本但它依赖 VBAT 引脚独立供电且 F1 系列没有晶振频率微调寄存器走快了只能靠软件每秒补偿。DS1302 是另一种常见方案三线接口但时序要自己模拟代码量不小。PCF8563 走 I2C两根线就能挂总线上地址固定读时间只要连续读几个寄存器驱动代码控制在 200 行以内。方案通信接口掉电保持精度修正占用引脚典型成本STM32 片内 RTCAPB1 内部外设需 VBAT 32.768kHz软件补偿2 VBAT0DS1302自定义 3 线需后备电池一般不调32~3 元PCF8563I2C需后备电池外部晶振电容微调21~3 元这个工程选 PCF8563 还有个隐性原因它的闹钟寄存器支持掩码匹配可以只匹配「分钟 小时」而不关心日期做每天定点开关机、定时上报这类功能时不用在主控里写复杂的定时判断。2.2 PCF8563 寄存器映射哪几位必须掩掉再读PCF8563 从地址 0x00 开始是一组连续的寄存器时间部分从 0x02 秒开始到 0x08 年结束全部是 BCD 码。所谓 BCD 码就是一个字节的高四位表示十位、低四位表示个位比如 0x59 代表 59 秒而不是十进制 89。换算公式只有两行#define BCD2DEC(bcd) (((bcd) 4) * 10 ((bcd) 0x0F)) #define DEC2BCD(dec) ((((dec) / 10) 4) | ((dec) % 10))两个宏的作用方向相反读写寄存器时都要经过它们。注意 DEC2BCD 的输入必须保证是合法的十进制数比如分钟传 75 进去算出来是 0x75写进芯片后时间会停走或显示异常调用前要自己做范围检查。寄存器地址功能关键位0x00控制/状态 1bit5 STOP置 1 停钟0x01控制/状态 2bit3 AIE 闹钟中断使能bit2 AF 闹钟标志0x02秒bit7 VL 电压低标志读到 1 要警告0x03分钟无特殊位0x04小时24 小时制bit7 是掩码位0x05日bit7 保留0x06星期0~60x07月/世纪bit7 是世纪位 C0x08年00~99BCD 码0x09~0x0C闹钟分/时/日/星期bit71 表示该字段不参与匹配0x0D~0x0E定时器时钟源与倒计数值最容易踩坑的是 0x02 秒寄存器的 bit7 VL 位。芯片刚上电或后备电池没电时这个位会变成 1表示内部振荡器停过、时间不可信。直接读回来转 BCD 会出现秒数大于 59 的怪值。标准做法是读 0x02 时先 0x7F把标志位剥掉同时在应用层单独检查这个 bit一旦置位就在串口打印时间失效警告。2.3 STM32 I2C 外设初始化开漏、100k、事件等待初始化 I2C1 之前要先配 GPIO。SCL 和 SDA 必须配成开漏复用模式因为 I2C 是线与逻辑总线空闲时靠上拉电阻拉高任何设备拉低都能产生响应。内部推挽输出会把总线钳死这是新手最常见的硬件配置错误。标准库代码按下面这样写void I2C_Config(void) { GPIO_InitTypeDef gpio; I2C_InitTypeDef i2c; RCC_APB1PeriphClockCmd(RCC_APB1Periph_I2C1, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); gpio.GPIO_Pin GPIO_Pin_6 | GPIO_Pin_7; /* PB6SCL, PB7SDA */ gpio.GPIO_Mode GPIO_Mode_AF_OD; /* 复用开漏 */ gpio.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOB, gpio); i2c.I2C_Mode I2C_Mode_I2C; i2c.I2C_Ack I2C_Ack_Enable; i2c.I2C_OwnAddress2 0; i2c.I2C_ClockSpeed 100000; /* 标准模式 100k */ i2c.I2C_DutyCycle I2C_DutyCycle_2; i2c.I2C_AcknowledgedAddress I2C_AcknowledgedAddress_7bit; I2C_Init(I2C1, i2c); I2C_Cmd(I2C1, ENABLE); }PCF8563 数据手册标称支持最高 400k 快速模式但工程里用的 100k 是更稳的选择原因有两个一是走线长或上拉电阻偏大时 400k 容易触发时钟延展超时二是用空闲的 GPIO 模拟时序调试时100k 的波形用逻辑分析仪看更清晰。等总线稳定了想提速直接把I2C_ClockSpeed改成 400000同时把上拉电阻从 10k 换成 4.7k。事件等待是标准库 I2C 编程的核心思路每次操作外设后都要轮询事件寄存器确认硬件已经完成了一步再进入下一步。后面会看到这个等待必须封装成带超时的函数否则一条 SDA 被拉的故障线上程序会永远卡在 while 循环里。3. 库函数 I2C 读写封装与时间/闹钟设置实现3.1 I2C 读寄存器函数事件状态机与 ACK 关闭时机读 PCF8563 的单个寄存器需要先发一个起始位把从机地址和寄存器地址写进去然后再次发起始位改成读方向把数据读出来。这种「先写后读」的格式是 I2C 规范里的常规操作对应到标准库就是一段连续的事件等待#define PCF8563_ADDR_W 0xA2 /* 7bit 地址 0x51 左移 1 位 */ #define PCF8563_ADDR_R 0xA3 static uint8_t I2C_WaitEvent(I2C_TypeDef *I2Cx, uint32_t event, uint32_t timeout) { while (timeout--) { if (I2C_CheckEvent(I2Cx, event)) { return 0; } } return 1; /* 超时返回 1调用方据此做错误处理 */ } static uint8_t PCF8563_ReadReg(uint8_t reg) { uint8_t value 0; I2C_GenerateSTART(I2C1, ENABLE); if (I2C_WaitEvent(I2C1, I2C_EVENT_MASTER_MODE_SELECT, 10000)) goto exit; I2C_Send7bitAddress(I2C1, PCF8563_ADDR_W, I2C_Direction_Transmitter); if (I2C_WaitEvent(I2C1, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED, 10000)) goto exit; I2C_SendData(I2C1, reg); if (I2C_WaitEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED, 10000)) goto exit; I2C_GenerateSTART(I2C1, ENABLE); if (I2C_WaitEvent(I2C1, I2C_EVENT_MASTER_MODE_SELECT, 10000)) goto exit; I2C_Send7bitAddress(I2C1, PCF8563_ADDR_R, I2C_Direction_Receiver); if (I2C_WaitEvent(I2C1, I2C_EVENT_MASTER_RECEIVER_MODE_SELECTED, 10000)) goto exit; I2C_AcknowledgeConfig(I2C1, DISABLE); /* 最后一个字节前关 ACK */ if (I2C_WaitEvent(I2C1, I2C_EVENT_MASTER_BYTE_RECEIVED, 10000)) goto exit; value I2C_ReceiveData(I2C1); I2C_GenerateSTOP(I2C1, ENABLE); exit: I2C_AcknowledgeConfig(I2C1, ENABLE); return value; }关 ACK 那行是整个函数里最关键的一步。I2C 读多字节时主设备在收到每个字节后都要回一个 ACK 表示「继续发」只有最后一个字节前要回 NACK 告诉从机「别再发了」。如果读单字节也开着 ACK从机可能多吐一个字节总线状态就乱了。标准库对这种细节没有自动处理只能代码里手动关。超时值 10000 是随意给的轮询次数实际经验是正常通信几十次循环内就能等到事件一旦超时说明总线上有问题与其死等不如跳出去复位外设。3.2 PCF8563_GetTimeVL 位与读撕裂读时间看起来是连续读 7 个寄存器但有个隐藏问题秒寄存器刚好进位时分钟已经变成新值而秒可能还是 59读出来的时间就会跳变。处理办法是连续读两遍比对分钟值一致才采用typedef struct { uint8_t sec; uint8_t min; uint8_t hour; uint8_t day; uint8_t weekday; uint8_t month; uint8_t year; } RTC_Time_t; uint8_t PCF8563_GetTime(RTC_Time_t *t) { uint8_t sec1, sec2; do { sec1 PCF8563_ReadReg(0x02) 0x7F; /* 剥掉 VL 位 */ t-sec BCD2DEC(sec1); t-min BCD2DEC(PCF8563_ReadReg(0x03)); t-hour BCD2DEC(PCF8563_ReadReg(0x04)); t-day BCD2DEC(PCF8563_ReadReg(0x05) 0x3F); t-weekday BCD2DEC(PCF8563_ReadReg(0x06)); t-month BCD2DEC(PCF8563_ReadReg(0x07) 0x1F); /* bit7 是世纪位 */ t-year BCD2DEC(PCF8563_ReadReg(0x08)); sec2 PCF8563_ReadReg(0x02) 0x7F; } while (sec1 ! sec2); /* 秒没变说明分钟字段是稳定的 */ if (sec1 0x80) { return 1; /* VL1时间无效 */ } return 0; }这套「读两次比对」的思路在多字节 I2C 传感器里很通用。如果你用连续读函数一次把 7 个字节全读回来芯片内部地址是自动递增的同样存在边界一致性问题还是得读两遍。月寄存器的 0x1F 掩码是为了去掉世纪位日寄存器的高位在 D7 是保留位也顺手掩掉。3.3 PCF8563_SetTime先停钟再写避免半更新状态写时间之前要把控制/状态 1 寄存器的 STOP 位置 1停掉秒计数所有字段写完后再启动。否则写分钟和写小时之间芯片还在走可能把刚写的半成品数据带到下一秒导致时间错乱。void PCF8563_SetTime(const RTC_Time_t *t) { uint8_t ctrl PCF8563_ReadReg(0x00); PCF8563_WriteReg(0x00, ctrl | 0x20); /* STOP1 停钟 */ PCF8563_WriteReg(0x02, DEC2BCD(t-sec) 0x7F); PCF8563_WriteReg(0x03, DEC2BCD(t-min)); PCF8563_WriteReg(0x04, DEC2BCD(t-hour) 0x3F); PCF8563_WriteReg(0x05, DEC2BCD(t-day)); PCF8563_WriteReg(0x06, DEC2BCD(t-weekday)); PCF8563_WriteReg(0x07, DEC2BCD(t-month)); /* 注意保留 bit7 世纪位 */ PCF8563_WriteReg(0x08, DEC2BCD(t-year)); PCF8563_WriteReg(0x00, ctrl ~0x20); /* STOP0 起振 */ }STOP 位是 0x00 的 bit5写 1 停写 0 走。这个位只在控制/状态 1 寄存器里存在不会因为之前读出来的 ctrl 值带其他状态位而被冲掉。PCF8563 到货后第一次上电时间默认是 00:00:00 且可能没起振必须走一遍 SetTime 流程才能正常走时。3.4 闹钟寄存器的掩码匹配与中断使能PCF8563 的闹钟由 0x09~0x0C 四个寄存器组成每个寄存器的 bit7 是掩码位置 1 表示该字段不参与匹配置 0 表示必须匹配。想实现「每天 08:30 报警」就把分、时设为实际值日、星期掩码掉void PCF8563_SetAlarm(uint8_t hour, uint8_t min) { uint8_t ctrl2 PCF8563_ReadReg(0x01); PCF8563_WriteReg(0x01, ctrl2 ~0x08); /* 先关 AIE */ PCF8563_WriteReg(0x09, DEC2BCD(min) 0x7F); /* 分钟匹配 */ PCF8563_WriteReg(0x0A, DEC2BCD(hour) 0x3F); /* 小时匹配 */ PCF8563_WriteReg(0x0B, 0x80); /* 日不匹配 */ PCF8563_WriteReg(0x0C, 0x80); /* 星期不匹配 */ ctrl2 PCF8563_ReadReg(0x01); ctrl2 ~0x04; /* 清 AF 标志 */ ctrl2 | 0x08; /* 开 AIE */ PCF8563_WriteReg(0x01, ctrl2); }清 AF 标志和开中断的顺序不能反。如果 AIE 先打开AF 又还挂着INT 引脚会立刻拉低一次造成误报警。闹钟触发后 AF 位会置 1中断服务程序里读 0x01 寄存器后要写 0 清掉它。这里补充一句PCF8563 的 INT 引脚是开漏输出外部必须接上拉电阻才能检测到下降沿。4. 串口重定向、命令行调试与 Keil 工程模块整合4.1 printf 重定向到 USART1 与串口初始化串口在这份代码里承担调试通道的角色。标准库工程里让 printf 直接走串口需要重定义 fputc 函数并勾选 Keil 魔术棒 Target 页的 Use MicroLIB否则 printf 会进半主机模式程序卡死在 BKPT 指令上int fputc(int ch, FILE *f) { USART_SendData(USART1, (uint8_t)ch); while (USART_GetFlagStatus(USART1, USART_FLAG_TXE) RESET); return ch; } void UART1_Config(uint32_t baud) { GPIO_InitTypeDef gpio; USART_InitTypeDef usart; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_USART1, ENABLE); gpio.GPIO_Pin GPIO_Pin_9; /* TX */ gpio.GPIO_Mode GPIO_Mode_AF_PP; gpio.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, gpio); gpio.GPIO_Pin GPIO_Pin_10; /* RX */ gpio.GPIO_Mode GPIO_Mode_IN_FLOATING; GPIO_Init(GPIOA, gpio); usart.USART_BaudRate baud; usart.USART_WordLength USART_WordLength_8b; usart.USART_StopBits USART_StopBits_1; usart.USART_Parity USART_Parity_No; usart.USART_HardwareFlowControl USART_HardwareFlowControl_None; usart.USART_Mode USART_Mode_Rx | USART_Mode_Tx; USART_Init(USART1, usart); USART_Cmd(USART1, ENABLE); }波特率用 115200PCF8563 的读操作耗时约几百微秒打印不会拖垮主循环。如果接的是 RS485 总线注意 DE 方向脚要在每次发送前拉高发送完拉低这也解释了为什么很多工控项目里串口调试和 RS485 通讯会出现在同一套代码里——收发链路是同一根线只是多了方向控制。4.2 命令行解析READ 回显、TIME 对时光打印还不够调试时最好能直接改时间、查时间。在串口中断里攒一帧数据收到换行符后丢给解析函数uint8_t uart_buf[64]; uint8_t uart_len 0; void USART1_IRQHandler(void) { if (USART_GetITStatus(USART1, USART_IT_RXNE)) { uint8_t ch USART_ReceiveData(USART1); if (ch \r || ch \n) { uart_buf[uart_len] 0; UART_CommandHandle(uart_buf, uart_len); uart_len 0; } else if (uart_len sizeof(uart_buf) - 1) { uart_buf[uart_len] ch; } } } void UART_CommandHandle(uint8_t *buf, uint16_t len) { RTC_Time_t t; if (strncmp((char *)buf, READ, 4) 0) { if (PCF8563_GetTime(t) 0) { printf(20%02d-%02d-%02d %02d:%02d:%02d WK%d\r\n, t.year, t.month, t.day, t.hour, t.min, t.sec, t.weekday); } else { printf(RTC invalid! Check VL bit.\r\n); } } else if (strncmp((char *)buf, TIME, 4) 0) { sscanf((char *)buf 5, %d-%d-%d %d:%d:%d, t.year, t.month, t.day, t.hour, t.min, t.sec); t.year - 2000; PCF8563_SetTime(t); printf(time set ok\r\n); } }收到 READ 就把时间按可读格式打出来收到 TIME 就解析后面的时间字符串并写进芯片。sscanf 的格式串和 printf 是对称的20%02d只打了年份的后两位所以在 TIME 命令里t.year - 2000转成 00~99。这就是「串口对时」的完整实现很多 4G 模块、Wi-Fi 模块拿到 NTP 时间后走的也是先解析字符串再调 SetTime 这条路径。4.3 工程文件清单与各外设模块的角色打开这个工程的源文件列表会发现它把 STM32 标准库的多个外设源文件都编了进来但真正跑 RTC 功能用不到那么多。逐一看源文件作用在工程中的角色stm32f10x_rcc.c时钟树配置开启 I2C1、USART1、GPIO 时钟stm32f10x_i2c.cI2C 外设驱动PCF8563 通信的唯一通道stm32f10x_usart.c串口驱动printf 和命令行输入stm32f10x_tim.c通用定时器生成 1 秒轮询节拍或延时辅助stm32f10x_flash.c片内 Flash保存定时校准参数断电不丢stm32f10x_adc.cADC 采集可扩展检测后备电池电压stm32f10x_flash.c 在这里有个很实用的扩展方向把每日走时误差存进 Flash主控每天固定时刻读回来自动补偿。比如实测一天快 3 秒就在每天 00:00:30 把分钟拨慢 3 秒。这个思路比片内 RTC 的软件补偿更通用而且 Flash 写入次数按一天一次算十年才写三千多次远低于擦写寿命。stm32f10x_adc.c 则对应一个隐藏需求PCF8563 的 VL 位只能说明停过振但想知道电池是不是快没电了还得量 VBAT 电压ADC 通道就是干这个的。4.4 移植到新项目时的注意点把这份工程抄到新板子上常见的坑有三个。第一Keil 打开工程报找不到芯片先去 Pack Installer 里装 STM32F1xx 的器件支持包也就是常说的 stm32 芯片包。第二代码里用了标准外设库但新工程的宏定义STM32F10X_MD或STM32F10X_HD要和芯片型号匹配不匹配时 RCC 和外设地址会错位最典型的现象是串口乱码、I2C 死等。第三下载后调不通先看板子上有没有给 I2C 上拉电阻PCF8563 模块一般自带 4.7k 上拉但如果你直接把裸芯片飞线接单片机SCL 和 SDA 浮空通信必然失败。5. 硬件 I2C 死锁恢复、晶振负载电容与时间校验5.1 总线死锁怎么复位硬件 I2C 最恶心的故障是总线死锁SDA 被某个从机拉低不放主控发什么都不响应。触发原因通常是主控复位瞬间从机正好在输出数据位或者调试时在中断里打断了 I2C 事件等待。标准库对这种情况没有自动恢复机制常见做法是用 GPIO 模拟 9 个时钟脉冲把从机状态机推到头void I2C1_BusRecover(void) { GPIO_InitTypeDef gpio; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); gpio.GPIO_Pin GPIO_Pin_6 | GPIO_Pin_7; gpio.GPIO_Mode GPIO_Mode_Out_OD; gpio.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOB, gpio); GPIO_SetBits(GPIOB, GPIO_Pin_6 | GPIO_Pin_7); Delay_us(10); for (int i 0; i 9; i) { GPIO_ResetBits(GPIOB, GPIO_Pin_6); Delay_us(5); GPIO_SetBits(GPIOB, GPIO_Pin_6); Delay_us(5); } I2C_Config(); /* 恢复硬件模式 */ }9 个脉冲是 I2C 规范里的标准恢复动作能让卡在中间状态的从机走完剩余的数据位和 ACK 位释放 SDA。执行完再重新调用 I2C_Config 把外设初始化回来通信就恢复正常了。代码里有一个值得注意的地方GPIO 模式配成开漏输出后不影响外部的上拉电阻把总线拉高所以不用在代码里额外置位 SDA。5.2 32.768kHz 晶振负载电容计算PCF8563 的时间基准来自外接的 32.768kHz 晶振晶振选型除了频率还要匹配负载电容。负载电容不匹配时频率会偏表现出来的就是一天快十几秒或慢十几秒。计算公式CL (C1 × C2) / (C1 C2) CstrayC1、C2 是晶振两脚对地的电容Cstray 是 PCB 走线和引脚带来的寄生电容通常取 2~3pF。PCF8563 常见配套晶振有 7pF 和 12.5pF 两个版本。以 7pF 晶振为例板上两个电容各取 10pF代入公式得到 CL 5 2 7pF刚好匹配。如果误用了 15pFCL 7.5 2 9.5pF偏高约 2.5pF晶振频率会偏快日差可能到 5 秒量级。做批量产品时可以用频率计直接测 PCF8563 的 CLKOUT 引脚这个引脚默认输出 32.768kHz测出来的频率就是晶振实际振荡频率。日差和 ppm 的换算关系是1ppm 等于每天误差 0.0864 秒偏差 5ppm 就是一天快 0.43 秒一个月快 13 秒对上位机做时间戳的应用足够造成明显跳变。5.3 与 HAL 库的 I2C 代码互译现在新项目多用 HAL 库这份工程的标准库代码在换库后对应关系很直接标准库事件等待写法HAL 库等价 APII2C_GenerateSTART CheckEventHAL_I2C_Master_TransmitI2C_Send7bitAddressHAL_I2C_Mem_Write / HAL_I2C_Mem_ReadI2C_AcknowledgeConfig(DISABLE)HAL_I2C_Mem_Read 内部自动处理 NACKI2C_WaitEvent 超时HAL_I2C_WaitOnFlagUntilTimeoutHAL 把事件状态机封装进了HAL_I2C_Mem_Read这类函数里参数里多了超时毫秒值和重试次数。调试时如果 HAL 版读时间失败错误码通常停在HAL_BUSY或HAL_TIMEOUT这时候用逻辑分析仪抓 SCL、SDA 波形对比标准库版本的事件顺序能更快定位是地址错、ACK 错还是时钟延展超时。5.4 十次连续读数验证通信和换算代码改完、板子能跑之后先别急着校验时间准不准要验证的是「读回来的数据自洽」。写一个循环连续打印十次时间for (int i 0; i 10; i) { if (PCF8563_GetTime(t) 0) { printf(%02d:%02d:%02d\r\n, t.hour, t.min, t.sec); } Delay_ms(100); }正常情况下每次打印的秒值单调递增且相邻两次差 1 或 2 秒——100ms 循环本身耗时加打印耗时差值不应超过 2。如果出现秒值倒退优先检查读撕裂处理那段比对逻辑是否生效如果分钟出现 60 以上的值检查 BCD2DEC 宏或是否忘了掩掉 VL 位。这个十连读套路放在每次改完驱动后跑一遍比直接对表看误差更快暴露问题。时间能稳定递增后再挂机跑 24 小时用第 4 章的 READ 命令和标准时间源对比做一次日差修正基本就能把误差压进 1 秒以内。本文还有配套的精品资源点击获取