STM32语音万年历实战：OLED显示+DS3231+语音合成

1. 项目缘起与整体设计思路

1.1 为什么选择"语音+万年历+OLED"这个组合

做单片机项目的人都有一个共同的痛点：功能太单一，做出来只能自己玩两天就吃灰。按键时钟、温度计、流水灯这类入门项目，代码量小、逻辑简单，但实用性几乎为零。而"S002E-基于STM32单片机语音万年历（OLED显示）"这个项目，恰好踩在了一个很舒服的平衡点上——它既有足够的复杂度让你把STM32的多个外设（I2C、UART、定时器、GPIO）全部串起来练一遍，又能真正做成一个放在桌面上天天用的东西。

我最初做这个项目的动机很朴素：家里老人眼神不好，看手机上的时间费劲，普通的电子钟又只能看不能听。于是就想做一个能"报时"的万年历——按一下按键，它就用语音告诉你现在是几点几分、星期几、农历几月初几。这个需求听起来简单，但真正落地时会涉及好几个技术模块的协同：RTC实时时钟走时、OLED多级菜单显示、语音合成模块串口通信、按键中断处理、掉电走时（后备电池）等等。

从学习价值来看，这个项目覆盖了STM32开发中最核心的几类技能。I2C通信用来驱动OLED和DS3231时钟芯片，UART串口用来和语音模块对话，定时器中断用来做1秒基准和按键消抖，GPIO用来做按键输入和LED指示。把这四样吃透，基本上STM32的常用外设你就掌握了七成。而且这个项目有一个天然的优势：它的每一个模块都可以独立调试，OLED不亮不影响语音，语音不响不影响走时，这种"模块化可拆分"的特性对新手极其友好。

1.2 核心器件选型与背后的取舍逻辑

选型这件事，新手最容易犯的错就是"看别人用什么我就用什么"，结果买回来发现引脚不够、电压不匹配、库不会用。我把这个项目里几个关键器件的选型逻辑拆开讲。

主控芯片：STM32F103C8T6。这是绕不开的选择。它属于F103系列的中容量型号，64KB Flash、20KB SRAM，对于万年历这种应用绰绰有余。更重要的是它的生态极其成熟——标准外设库、HAL库、各种教程铺天盖地，遇到问题一搜就有答案。有人会问为什么不选STM32F401或者G0系列，我的看法是：F103C8T6的"最小系统板"（俗称蓝板）价格便宜、引脚引出完整、5V tolerant的IO多，接各种模块不容易烧。对于这个项目，性能过剩没有意义，稳定和好调试才是第一位的。

显示方案：0.96寸OLED（SSD1306驱动，I2C接口）。为什么不用LCD1602？因为1602只能显示两行字符，做万年历要显示年月日时分秒星期农历，根本不够用。OLED是自发光，对比度高，晚上看也不刺眼，而且I2C接口只占两个引脚（SCL、SDA），省下来的引脚可以给按键和语音模块。0.96寸128x64的分辨率，用8x16的汉字字库，一行能显示8个汉字，四行就是32个字，足够把时间、日期、星期、农历全部铺开。

时钟芯片：DS3231。这是整个项目里我最想强调的一个选型。很多教程用STM32内部的RTC，但内部RTC的精度受晶振和温度影响很大，一天差几秒很正常，一个月下来可能差好几分钟。DS3231是带温度补偿的高精度时钟芯片，精度可以达到±2ppm，也就是一年误差不超过1分钟。它内置纽扣电池供电，主电源断了也能继续走时。对于"万年历"这个定位，走时精度是底线，DS3231多花的那几块钱完全值得。

语音模块：SYN6288或XFS5152。这两个都是常见的串口中英文语音合成模块，通过UART发送文本，模块直接读出声音。选它们的理由是：不需要预先录音，想报什么就发什么文本，灵活度极高。比如"现在是2024年5月20日，星期一，农历四月十三，下午3点25分"，直接拼成字符串发过去就行。相比之下，用WT588D那种需要事先烧录音频的方案，改一个字就要重新录，太死板。

按键方案：3个独立按键。一个"模式"键用来切换显示页面，一个"加"键一个"减"键用来调整时间。用外部中断或者定时器轮询都可以，我后面会讲两种方式的取舍。

1.3 系统整体架构与数据流

把上面这些器件串起来，整个系统的数据流是这样的：DS3231通过I2C每秒把时间数据送给STM32，STM32在定时器中断里维护一个时间结构体，主循环里不断刷新OLED显示，同时检测按键状态。当用户按下"报时"键时，STM32把当前时间结构体格式化成中文文本，通过UART发给语音模块，语音模块合成语音播放出来。

这里有一个设计上的关键点：时间数据的唯一权威来源是DS3231，STM32内部不维护独立的走时逻辑，只是定期从DS3231读取。这样做的好处是，无论STM32复位多少次，时间永远准确。如果让STM32自己走时，一旦复位时间就归零了，还得重新设置，体验很差。

另一个关键点是农历转换。公历转农历需要一张农历数据表，通常是把1900年到2100年的农历信息压缩成一个数组，每年用一个16位或32位数表示闰月、大小月等信息。这个算法网上有成熟的开源实现，直接移植即可，不需要自己从头推导。我在代码里用的是常见的"农历数据表+查表计算"方案，后面会给出核心代码。

2. 核心模块的细节解析与实操要点

2.1 DS3231高精度时钟的驱动与避坑

DS3231通过I2C通信，7位地址是0x68。它的寄存器是BCD码格式，这一点新手特别容易踩坑——你写进去的十进制数，读出来会变成奇怪的十六进制。比如你想设置25分，直接写25（0x19）进去，读出来会变成0x19对应的BCD码，显示就乱了。所以读写的时候必须做BCD和十进制的转换。

设置时间的流程是这样的：先解除写保护（其实DS3231没有写保护，直接写就行），然后依次写入秒、分、时、星期、日、月、年的寄存器。注意年份寄存器只存后两位，比如2024年存24。星期寄存器是1到7，具体哪天是1由你自己定义，我习惯把周日设为1。

// BCD转十进制 uint8_t BCD2DEC(uint8_t bcd) { return (bcd >> 4) * 10 + (bcd & 0x0F); } // 十进制转BCD uint8_t DEC2BCD(uint8_t dec) { return ((dec / 10) << 4) | (dec % 10); }

读取时间的时候，建议一次性把7个寄存器连续读出来，而不是一个一个读。因为如果读秒和读分之间刚好跨了一分钟，你读到的数据就是"59秒+新分钟"，逻辑上不一致。连续读虽然也不能完全避免这个问题，但概率小得多。更严谨的做法是读两次，如果两次的秒值相同就认为数据有效。

注意：DS3231的I2C总线上必须接上拉电阻，通常4.7K到10K。很多模块板已经自带了，但如果你是自己画的板子，忘了上拉电阻会导致通信时好时坏，这个坑我踩过。

还有一个细节：DS3231的INT/SQW引脚可以输出方波，但在这个项目里用不到，悬空即可。如果你想让STM32通过中断来读取秒信号，可以把SQW配置成1Hz输出，接到STM32的外部中断引脚上，这样就不用在主循环里轮询了。不过对于万年历来说，轮询完全够用，没必要增加复杂度。

2.2 OLED显示驱动的移植与汉字显示

OLED用SSD1306驱动芯片，I2C地址通常是0x78（8位地址）或0x3C（7位地址）。这里有个常见的困惑：不同库用的地址格式不一样，有的用7位有的用8位，搞混了就死活点不亮。判断方法很简单：如果地址是0x78，那7位地址就是0x3C；如果代码里用的是HAL库的I2C函数，通常传7位地址，也就是0x3C左移一位变成0x78。

驱动OLED的核心是三个函数：写命令、写数据、刷新显存。SSD1306内部有一块128x64bit的显存（GDDRAM），你先把要显示的内容写到STM32的一个缓冲区数组里，然后一次性把整个缓冲区刷到OLED上。这样做的好处是刷新速度快，不会看到逐行扫描的闪烁。

uint8_t OLED_GRAM[128][8]; // 显存缓冲区 void OLED_Refresh(void) { for(uint8_t i = 0; i < 8; i++) { OLED_WriteCmd(0xB0 + i); // 设置页地址 OLED_WriteCmd(0x00); // 设置列低地址 OLED_WriteCmd(0x10); // 设置列高地址 for(uint8_t j = 0; j < 128; j++) { OLED_WriteData(OLED_GRAM[j][i]); } } }

显示汉字需要字库。常用的方案是用PCtoLCD2002软件取模，设置成"阴码、逐列式、顺向"，每个16x16的汉字占32个字节。取模的时候要注意，OLED的显存是按页组织的，每页8行，一个16x16的汉字占两页。写显示函数的时候，要把汉字的32个字节分别写到对应的两页里。

实操心得：字库不要全部放在RAM里，128x64的显存已经占了1KB，如果再把几百个汉字的字库放RAM，20KB的SRAM很快就满了。正确的做法是把字库放在Flash里，用const修饰，需要显示的时候直接从Flash读取。我一开始没注意这个，加了农历字库之后程序直接跑飞了，查了半天才发现是RAM溢出。

2.3 语音合成模块的串口通信与文本格式化

语音模块的通信协议通常是这样的：发送一帧数据，包含帧头、数据长度、命令字、文本内容、校验和。以SYN6288为例，帧格式是：0xFD + 长度高字节 + 长度低字节 + 0x01（命令字）+ 文本内容 + 校验和。校验和是前面所有字节的累加和取低8位。

void Voice_Speak(char *text) { uint8_t len = strlen(text); uint8_t frame[100]; frame[0] = 0xFD; frame[1] = (len + 3) >> 8; frame[2] = (len + 3) & 0xFF; frame[3] = 0x01; memcpy(&frame[4], text, len); uint8_t sum = 0; for(uint8_t i = 0; i < len + 4; i++) { sum += frame[i]; } frame[len + 4] = sum; HAL_UART_Transmit(&huart1, frame, len + 5, 1000); }

文本格式化是这个模块最有意思的地方。你要把时间结构体拼成一句自然的中文。比如"现在是下午3点25分，星期一，农历四月十三"。这里有几个细节：上午下午的判断（小时小于12是上午，大于等于12是下午），农历月份的读法（正月、二月……冬月、腊月），日期的读法（初一、初二……初十、十一……二十、廿一……三十）。这些都需要写专门的格式化函数。

注意：语音模块的波特率通常是9600，但有些模块默认是115200，买回来第一件事就是确认波特率。我就遇到过发了半天没反应，最后发现波特率不对的情况。另外，语音模块的供电要充足，播放时电流可能达到200mA，如果和STM32共用USB供电，可能会因为电流不足导致播放断断续续或者复位。

2.4 按键处理：中断还是轮询

按键处理有两种方案：外部中断和定时器轮询。外部中断的优点是响应快、不占CPU，但缺点是机械按键的抖动会导致一次按下触发多次中断，必须在中断里做延时消抖，而延时又会阻塞其他中断。定时器轮询的优点是可以在定时器中断里统一做消抖，逻辑清晰，缺点是占用一点CPU时间。

我最终选择了定时器轮询方案。具体做法是：配置一个1ms的定时器中断，在中断里对每个按键做计数。如果检测到按键按下，计数器加一；如果计数器达到20（也就是20ms），就认为按键稳定按下，触发按键事件；如果检测到按键松开，计数器清零。这样既完成了消抖，又不会阻塞任何东西。

// 1ms定时器中断里的按键扫描 void Key_Scan(void) { static uint8_t key_cnt[3] = {0, 0, 0}; static uint8_t key_last[3] = {1, 1, 1}; uint8_t key_now[3]; key_now[0] = HAL_GPIO_ReadPin(KEY1_GPIO_Port, KEY1_Pin); key_now[1] = HAL_GPIO_ReadPin(KEY2_GPIO_Port, KEY2_Pin); key_now[2] = HAL_GPIO_ReadPin(KEY3_GPIO_Port, KEY3_Pin); for(uint8_t i = 0; i < 3; i++) { if(key_now[i] == 0) { // 按下 if(key_cnt[i] < 20) key_cnt[i]++; if(key_cnt[i] == 20 && key_last[i] == 1) { key_last[i] = 0; Key_Event(i); // 触发按键事件 } } else { // 松开 key_cnt[i] = 0; key_last[i] = 1; } } }

这个方案还有一个好处：很容易实现长按功能。比如按住"加"键不放，可以让时间快速增加。只需要在计数器达到20之后，继续计数，每达到100（也就是100ms）就再触发一次按键事件。

3. 完整实操流程与核心代码实现

3.1 硬件连接与供电方案

先把硬件连起来。我用的是STM32F103C8T6最小系统板，配合几个模块。连接关系如下表：

OLED和DS3231共用I2C总线是没问题的，因为它们的地址不同（OLED是0x3C，DS3231是0x68），不会冲突。但要注意总线上拉电阻的问题，如果两个模块都自带上拉电阻，并联之后阻值会变小，可能导致上升沿太陡产生振铃。一般来说4.7K并联成2.35K问题不大，但如果通信不稳定，可以去掉一个模块的上拉电阻。

供电方面，整个系统用5V USB供电，STM32板上有3.3V稳压器给OLED和DS3231供电。语音模块通常需要5V供电，直接从USB取电。这里要注意：语音模块的电流较大，如果USB线质量不好，播放时电压会跌落，导致STM32复位。我的做法是在语音模块的电源脚旁边并一个1000uF的电解电容，效果很明显。

3.2 工程搭建与CubeMX配置

用STM32CubeMX配置工程可以省去大量初始化代码。具体配置步骤如下：

1. 时钟配置：选择外部晶振HSE，配置PLL倍频到72MHz。这是F103的最高主频，性能拉满。
2. I2C1配置：模式选I2C，速度选400KHz（快速模式）。标准模式100KHz也能用，但400KHz刷新OLED更快。
3. UART1配置：波特率9600，8位数据，1位停止，无校验。这是语音模块的默认参数。
4. 定时器配置：选TIM2，预分频器设为71，自动重装载值设为999，这样定时器频率是72MHz/(71+1)/1000 = 1KHz，也就是1ms中断一次。
5. GPIO配置：按键引脚设为输入上拉，LED引脚设为推挽输出。
6. 中断配置：使能TIM2中断，优先级设为中等。

生成代码后，你会得到一个完整的工程框架。接下来要做的就是把各个模块的驱动代码加进去。

实操心得：CubeMX生成的代码里，I2C的读写函数是HAL_I2C_Mem_Write和HAL_I2C_Mem_Read，用起来很方便。但要注意超时时间不要设太长，否则I2C出问题的时候程序会卡死。我一般设100ms，超时就返回错误，让程序继续跑。

3.3 公历转农历的核心算法

农历转换是这个项目里算法含量最高的部分。核心思路是：把1900年到2100年的农历数据压缩成一个数组，每年用一个32位整数表示。这个整数的不同位段分别表示闰月月份、闰月天数、以及13个月的大小月信息。

// 农历数据表（1900-2100） const uint32_t LunarData[] = { 0x04AE53, 0x0A5748, 0x5526BD, // ... 省略中间数据 }; // 公历转农历 void SolarToLunar(uint16_t year, uint8_t month, uint8_t day, uint8_t *lunarYear, uint8_t *lunarMonth, uint8_t *lunarDay, uint8_t *isLeap) { // 计算从1900年1月31日到目标日期的天数 uint32_t offset = 0; for(uint16_t i = 1900; i < year; i++) { offset += 365; if(IsLeapYear(i)) offset++; } // 加上当年的天数 uint8_t daysInMonth[] = {31,28,31,30,31,30,31,31,30,31,30,31}; if(IsLeapYear(year)) daysInMonth[1] = 29; for(uint8_t i = 0; i < month - 1; i++) { offset += daysInMonth[i]; } offset += day - 1; // 减去1900年1月31日之前的天数 offset -= 30; // 1900年1月1日到1月31日是30天 // 从农历数据表推算 uint16_t lunarY = 1900; while(offset > 0) { uint16_t daysInLunarYear = 0; uint8_t leapMonth = LunarData[lunarY - 1900] & 0x0F; for(uint8_t m = 1; m <= 12; m++) { daysInLunarYear += 29; if(LunarData[lunarY - 1900] & (1 << (16 - m))) { daysInLunarYear++; } } if(leapMonth > 0) { daysInLunarYear += 29; if(LunarData[lunarY - 1900] & (1 << (16 - 13))) { daysInLunarYear++; } } if(offset < daysInLunarYear) break; offset -= daysInLunarYear; lunarY++; } // 继续推算月份和日期... }

这段代码看起来复杂，但逻辑其实很直接：先算出公历日期距离1900年1月31日有多少天，然后一年一年地减，减到不够减为止，剩下的天数就是农历年内的偏移，再逐月减就能得到农历月和日。闰月的处理稍微麻烦一点，需要判断当年是否有闰月以及闰月是大月还是小月。

注意：农历数据表的数据量不小，1900到2100年共201个32位整数，占804字节的Flash。对于64KB的STM32来说完全不是问题，但如果你用的是Flash很小的芯片，就要考虑压缩存储了。

3.4 主循环逻辑与显示刷新策略

主循环的结构很清晰：读取时间、刷新显示、处理按键、检查是否需要报时。但这里有一个性能问题：OLED刷新如果太频繁，会占用大量CPU时间，导致按键响应变慢。我的做法是每200ms刷新一次显示，而不是每1ms都刷。200ms的刷新率人眼看起来已经很流畅了，而且CPU有足够的时间处理其他任务。

int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); MX_USART1_UART_Init(); MX_TIM2_Init(); OLED_Init(); DS3231_Init(); HAL_TIM_Base_Start_IT(&htim2); uint32_t last_refresh = 0; Time_t now; while(1) { // 每200ms刷新一次显示 if(HAL_GetTick() - last_refresh >= 200) { last_refresh = HAL_GetTick(); DS3231_ReadTime(&now); OLED_ShowTime(&now); } // 处理按键事件 if(key_event != KEY_NONE) { HandleKey(key_event); key_event = KEY_NONE; } } }

显示页面的设计我做了三页：第一页显示公历时间（年月日时分秒星期），第二页显示农历和温度（DS3231自带温度传感器），第三页显示一些系统信息（比如运行时间、版本号）。按"模式"键切换页面，按"报时"键触发语音播报。

3.5 语音播报的文本拼接与播放

语音播报的文本拼接需要处理很多细节。比如"现在是2024年5月20日，星期一，农历四月十三，下午3点25分"。这里有几个格式化函数：

void FormatTime(Time_t *t, char *buf) { char week[][4] = {"日","一","二","三","四","五","六"}; char ampm[][5] = {"上午","下午"}; uint8_t hour12 = t->hour % 12; if(hour12 == 0) hour12 = 12; sprintf(buf, "现在是%d年%d月%d日，星期%s，%s%d点%d分", t->year, t->month, t->day, week[t->week], ampm[t->hour >= 12], hour12, t->minute); }

农历的格式化更麻烦，因为农历的月份和日期有特殊的读法。月份要读成"正月、二月……冬月、腊月"，日期要读成"初一、初二……初十、十一……二十、廿一……三十"。我写了一个专门的函数来处理：

void FormatLunar(uint8_t month, uint8_t day, uint8_t isLeap, char *buf) { char monthName[][5] = {"正","二","三","四","五","六", "七","八","九","十","冬","腊"}; char dayName[][5] = {"初一","初二","初三","初四","初五", "初六","初七","初八","初九","初十", "十一","十二","十三","十四","十五", "十六","十七","十八","十九","二十", "廿一","廿二","廿三","廿四","廿五", "廿六","廿七","廿八","廿九","三十"}; sprintf(buf, "农历%s%s月%s", isLeap ? "闰" : "", monthName[month - 1], dayName[day - 1]); }

实操心得：语音模块对文本长度有限制，一般不超过200字节。如果你把公历、农历、温度全部拼在一起，可能会超长。我的做法是分两次播报，先报公历，再报农历。另外，语音模块对某些多音字处理不好，比如"重"在"重阳"里读chong，但模块可能读成zhong。遇到这种情况，可以用同音字替换，比如把"重阳"写成"虫阳"，虽然看起来奇怪，但读出来是对的。

4. 常见问题排查与实战避坑指南

4.1 OLED不亮的排查思路

OLED不亮是最常见的问题，原因可能有很多。我整理了一个排查流程，按顺序检查可以快速定位问题。

我最常遇到的问题是I2C地址搞混。有些OLED模块背面标的是0x78，有些标的是0x3C，其实0x78是8位地址，0x3C是7位地址，本质是同一个。如果你用HAL库的I2C函数，传7位地址0x3C；如果你用软件模拟I2C，可能传8位地址0x78。搞不清楚的时候，写一个I2C扫描程序，把所有地址都试一遍，能收到ACK的就是正确地址。

另一个坑是初始化序列。SSD1306的初始化命令有几十条，少一条可能就不亮。网上有很多版本的初始化代码，建议直接用芯片手册里的推荐序列，不要自己删减。我试过删掉几条看起来"不重要"的命令，结果屏幕就是不亮，加回去就好了。

4.2 DS3231走时不准或数据异常

DS3231本身精度很高，如果你发现走时不准，大概率是以下几个原因：

第一，晶振问题。DS3231需要外接32.768KHz晶振，如果晶振质量不好或者负载电容不匹配，精度会大打折扣。建议用6pF负载电容的晶振，这是DS3231手册推荐的。有些便宜的模块为了省成本，用的是12.5pF的晶振，精度会差一些。

第二，电池问题。DS3231的备用电池通常是CR2032纽扣电池，电压3V。如果电池没电了，主电源断开后时间就会丢失。测一下电池电压，低于2.5V就该换了。另外，有些模块的电池座接触不良，也会导致同样的问题。

第三，I2C通信干扰。如果DS3231和OLED共用I2C总线，OLED刷新时产生的大量数据可能会干扰DS3231的通信。我的做法是在每次读取DS3231之前，先发送一个STOP条件，确保总线空闲。另外，I2C的速率不要设太高，400KHz虽然能用，但100KHz更稳定。

注意：DS3231的温度寄存器每64秒更新一次，如果你频繁读取温度，可能会读到旧数据。这不是bug，是芯片的设计。需要实时温度的话，可以手动触发一次温度转换（写0x3F寄存器的CONV位），等200ms后再读。

4.3 语音模块不发声或声音异常

语音模块的问题通常出在串口通信上。首先确认波特率，SYN6288默认9600，XFS5152默认9600，但有些模块出厂时被设置成了115200。如果你发数据没反应，先试试改波特率。

其次确认帧格式。不同模块的帧头可能不一样，SYN6288是0xFD，XFS5152是0xFD，但有些模块是0xAA。校验和的计算方式也可能不同，有的是累加和，有的是异或和。最可靠的方法是看模块的数据手册，或者用串口助手手动发一帧数据测试。

如果模块能发声但声音异常，比如断断续续、有杂音，通常是供电问题。语音模块播放时电流较大，如果电源滤波不好，电压会波动。在模块的电源脚旁边并一个100uF到1000uF的电解电容，再并一个0.1uF的陶瓷电容，基本上能解决大部分问题。

还有一个容易被忽略的问题：文本编码。语音模块通常支持GB2312编码的中文，如果你发送的是UTF-8编码，读出来就是乱码。在Keil里，源文件的编码默认可能是UTF-8，需要在设置里改成GB2312，或者手动把中文字符串转成GB2312编码。

4.4 按键不灵敏或误触发

按键问题通常有两个原因：硬件抖动和软件消抖不当。硬件上，按键两端并一个0.1uF的电容可以滤除大部分高频抖动。软件上，我前面讲的20ms计数器消抖方案已经足够可靠。

如果按键偶尔误触发，检查一下按键引脚是否配置了上拉电阻。STM32内部有上拉电阻，但阻值较大（约40K），如果按键引线较长，容易受到干扰。建议在按键引脚外部再接一个10K的上拉电阻，增强抗干扰能力。

还有一种情况是按键按下后没有反应。这通常是按键事件的处理逻辑有问题。比如你在中断里设置了按键标志，但主循环里忘记检查这个标志，或者检查了但忘记清除标志，导致一次按键触发多次事件。我的做法是用一个全局变量key_event来传递按键事件，主循环处理完后立即清零。

4.5 程序下载失败与调试技巧

STM32下载失败是新手经常遇到的问题。常见原因和解决方法如下：

我遇到最多的是BOOT引脚问题。STM32F103的BOOT0决定启动模式，接GND是从Flash启动，接VCC是从系统存储器启动。如果你下载完程序发现没反应，先检查BOOT0是不是接GND了。另外，有些最小系统板的BOOT0引脚没有下拉电阻，悬空时可能被干扰，建议手动接一个10K的下拉电阻到GND。

调试的时候，善用串口打印。在关键位置加printf，通过串口助手查看程序运行状态，比单步调试效率高得多。但要注意，printf会占用串口资源，如果你用UART1和语音模块通信，printf就要改用UART2或者用SWO输出。

实操心得：Keil的调试功能很强大，但有时候断点打多了会导致程序时序混乱，特别是涉及I2C和UART通信的时候。我的习惯是先用串口打印确认逻辑正确，再用断点调试细节。另外，Keil的"Watch"窗口可以实时查看变量值，比反复打印方便。

5. 功能扩展与个人经验总结

5.1 可以继续加什么功能

这个项目的框架很开放，加功能很容易。我列几个我试过或者觉得有意思的扩展方向：

加温度显示和语音播报。DS3231自带温度传感器，精度±3°C，虽然不算高，但看个大概够了。在OLED第二页显示温度，语音播报的时候加一句"当前温度25度"。

加整点报时。在定时器中断里判断分钟是否为0，如果是就触发语音播报。注意要加一个标志位，防止一分钟内重复触发。

加闹钟功能。用DS3231的ALARM寄存器，可以设置两个闹钟。到时间了DS3231的INT引脚会拉低，接到STM32的外部中断上，触发语音播报。这个功能很实用，相当于一个语音闹钟。

加红外遥控。用VS1838B红外接收头，配一个红外遥控器，可以实现远程报时、切换显示页面。红外解码用定时器捕获或者外部中断都可以。

加WiFi对时。用ESP8266或者ESP32模块，通过NTP协议获取网络时间，定期校准DS3231。这样就不怕DS3231走时误差累积了。不过这个功能涉及网络编程，复杂度会高不少。

5.2 我在这个项目里踩过的坑

第一个坑是RAM溢出。前面提过，我把农历字库和显示缓冲区都放在RAM里，结果程序跑飞。后来把字库改成const放在Flash里，问题解决。这个教训让我养成了习惯：凡是不会修改的常量数据，一律加const。

第二个坑是I2C死锁。有一次调试的时候，OLED突然不亮了，重启也没用。后来发现是I2C总线被拉低了，因为某次通信过程中STM32复位了，但从设备还在等待时钟信号，导致SDA一直被拉低。解决方法是：在I2C初始化之前，先把SCL和SDA配置成普通GPIO，手动发送几个时钟脉冲，让从设备释放总线。

第三个坑是语音模块的电源干扰。语音模块播放时，电流突变导致电源电压波动，STM32的ADC读数跳变，DS3231也偶尔通信失败。加了滤波电容之后好多了，但彻底解决是在语音模块的电源线上串了一个磁珠，抑制高频干扰。

第四个坑是农历数据表的边界问题。我测试的时候只测了2024年，没问题。后来用户反馈说2099年显示不对，我才发现农历数据表只到2100年，而且我的算法在边界年份有越界访问。修复方法是加一个范围检查，超出范围就显示"超出范围"。

5.3 给新手的几点建议

如果你正准备做这个项目，我有几个建议可以帮你少走弯路。

先分模块调试，再整体联调。不要一上来就把所有模块接在一起，那样出了问题很难定位。先单独调OLED，确保能显示字符；再单独调DS3231，确保能读写时间；再单独调语音模块，确保能发声；最后再合在一起。

善用现成的库和代码。OLED驱动、DS3231驱动、农历转换算法，网上都有成熟的开源代码。不要什么都自己从头写，站在别人的肩膀上效率更高。但要注意，抄代码要理解代码，否则出了问题你都不知道从哪查。

注意电源设计。这个项目里既有数字电路（STM32），又有模拟电路（语音模块的功放），还有射频电路（如果有WiFi模块）。电源设计不好，各种干扰问题会让你崩溃。我的经验是：每个模块的电源脚旁边都并一个0.1uF的陶瓷电容，语音模块再并一个大电解电容，基本上能解决大部分电源干扰问题。

留出调试接口。在PCB上留出SWD调试接口和串口接口，调试的时候会方便很多。不要为了省空间把调试接口去掉，到时候想调试都调不了。

写文档和注释。这个项目涉及的模块多，代码量大，如果不写注释，过一个月你自己都看不懂。我的习惯是每个函数上面写清楚功能、参数、返回值，每个模块的驱动文件开头写清楚硬件连接和注意事项。

最后说一句，这个项目虽然叫"万年历"，但它的价值远不止看时间。它是一个很好的学习平台，把STM32的常用外设都串起来了。你在这个项目里学到的I2C通信、UART通信、定时器中断、状态机设计，在以后做其他项目的时候都能直接用上。我做完这个项目之后，再做其他STM32项目，明显感觉顺手多了。