STM32 HAL库实战：DS18B20测温、数码管显示与EEPROM存储综合应用

1. 项目概述与备赛思路

最近在准备蓝桥杯嵌入式国赛，手头正好有块STM32G4的开发板，就想着把往届真题里那些经典的外设模块都过一遍。这届比赛，HAL库是绕不开的，官方推荐用它，虽然上手时觉得抽象层有点厚，不如标准库直接，但用熟了发现它的移植性和跨系列兼容性是真香。这次我重点练的是第10届真题里的一套组合拳：用DS18B20测温，数码管显示，串口收发数据，最后还得把关键数据存到EEPROM里。这几个模块单独拿出来都不算难，但组合在一起，对时序控制、中断管理、数据流设计的考验就上来了，非常贴近实际比赛和项目开发的场景。

DS18B20这个单总线数字温度传感器，是嵌入式比赛的常客，考的就是你对严格时序的理解和实现能力。数码管显示，无论是静态还是动态扫描，都涉及到GPIO的控制和刷新策略。串口通信则是调试和数据交互的基石，必须做到收发稳定、不丢数据。而EEPROM的读写，考验的是你对I2C或SPI等通信协议，以及非易失性存储管理的掌握。用STM32G4的HAL库把这些串起来，不仅能巩固外设驱动，更能深入理解HAL库的中断、回调、状态机这些编程思想，对备赛和日后做项目都大有裨益。

2. 核心模块驱动原理与HAL库适配

2.1 DS18B20单总线通信深度解析

DS18B20采用单总线协议，这意味着数据线DQ同时肩负着供电（寄生供电模式时）和通信的双重任务。它的通信基础是严格的时序，包括复位脉冲、存在脉冲、读写时隙。在标准库时代，我们常常用__nop()空指令或精确的延时函数来“硬抠”时序。但在HAL库环境下，特别是STM32G4这种带硬件定时器的高级芯片，我们有更优雅和可靠的选择。

首先，不推荐在HAL库项目里用软件死循环延时（比如while(i--);）来满足DS18B20的微秒级时序要求。这会阻塞CPU，影响系统实时性，在同时处理数码管扫描、串口接收时极易出问题。我的方案是使用一个基本定时器（如TIM6/TIM7）来产生精确的微秒延时。你可以在CubeMX里配置一个定时器，预分频器和自动重载值根据主频计算好，使其每计数一次对应1微秒。然后封装两个函数：DS18B20_Delay_us(uint16_t us)和DS18B20_Delay_ms(uint16_t ms)。前者用HAL_TIM_Base_Start和__HAL_TIM_GET_COUNTER配合循环等待实现高精度延时；后者可以直接调用HAL_Delay，因为HAL的毫秒延时基于SysTick，相对准确且不独占CPU。

驱动DS18B20的关键步骤是初始化和读写。初始化即复位和检测存在脉冲。写时隙分为写“0”和写“1”，核心都是在特定的时间窗口内将DQ线拉低或释放。读时隙则是主机先拉低DQ，再释放并采样。所有这些操作，底层都是对GPIO的“拉高”、“拉低”和“读取”操作。HAL库提供了HAL_GPIO_WritePin和HAL_GPIO_ReadPin函数，但直接调用它们会引入函数调用开销，可能破坏微妙时序。因此，在读写时序最关键的部位，我通常会直接操作GPIO的位设置/清除寄存器（BSRR）和输入数据寄存器（IDR）来达到最快的速度。例如，#define DS18B20_DQ_OUT_HIGH() (GPIOB->BSRR = GPIO_PIN_0)和#define DS18B20_DQ_IN() ((GPIOB->IDR & GPIO_PIN_0) != 0)。

注意：直接操作寄存器是追求极致时序稳定性的做法。务必确保你操作的引脚和寄存器地址正确，并且与CubeMX生成的初始化代码不冲突。最好将这部分代码放在独立的.c文件里，并做好注释。

2.2 数码管动态显示与HAL库定时器调度

数码管显示，尤其是多位数码管，通常采用动态扫描来节省IO口。原理是利用人眼的视觉暂留，快速轮流点亮每一位数码管。如果扫描间隔太长，就会看到闪烁；如果太短，可能亮度不足。常见的扫描周期在1-5ms之间。

在HAL库中实现动态扫描，最佳实践是使用一个通用定时器（如TIM2）的中断。在CubeMX中配置定时器产生一个2ms的中断，然后在中断服务函数或者更推荐的在定时器周期溢出回调函数HAL_TIM_PeriodElapsedCallback中，进行位选和段选的操作。例如，用一个全局数组Display_Buffer[4]存放4位数码管要显示的数字，再用一个变量Digit_Index记录当前点亮的是第几位。在回调函数中，先关闭所有位选（消隐），然后根据Digit_Index设置对应的位选引脚为有效，再从Display_Buffer[Digit_Index]中取出数字，通过查表法（一个0-F对应的段码数组）得到段码值，输出到段选IO口，最后Digit_Index循环加1。

这样做的好处是，扫描时序由硬件定时器严格保证，非常精准，不占用主循环资源。主程序只需要更新Display_Buffer数组的内容，显示驱动在后台自动完成。这也是嵌入式系统常见的“前台后台”或“时间片轮询”思想的体现。

2.3 串口异步收发与DMA应用

串口是调试和通信的命脉。HAL库的串口收发有阻塞、中断和DMA三种模式。对于蓝桥杯比赛，中断模式是必须掌握的，因为它能高效处理不定长数据。而DMA模式则是处理大数据量或追求极致效率时的选择。

在CubeMX中使能串口后，需要开启全局中断。对于接收，我强烈推荐使用“空闲中断（Idle Interrupt）”配合DMA来接收不定长数据。STM32的USART在检测到总线空闲（一个字节时间内没有新数据）时，可以产生中断。配置步骤如下：

1. 在CubeMX中使能串口和对应的DMA通道（RX方向，循环模式）。
2. 在代码中调用HAL_UARTEx_ReceiveToIdle_DMA(&huart1, Rx_Buffer, BUFFER_SIZE)。这个函数会启动DMA接收，并在收到空闲帧时触发回调。
3. 重写回调函数HAL_UARTEx_RxEventCallback，在这里处理接收到的完整一帧数据。通过__HAL_DMA_GET_COUNTER可以计算出接收到的数据长度。

对于发送，简单的调试信息可以用阻塞模式HAL_UART_Transmit。但如果是在中断服务函数中，或者需要发送大量数据（如发送一帧传感器数据包），则应使用中断模式HAL_UART_Transmit_IT或DMA模式HAL_UART_Transmit_DMA，避免长时间阻塞。

注意：HAL_UART_Transmit函数中的Timeout参数，是以毫秒为单位的阻塞等待时间。可以填入HAL_MAX_DELAY（一直等待），或者一个具体的数值如1000（等待1秒）。在非阻塞应用中，要避免使用HAL_MAX_DELAY，防止程序卡死。对于确定性要求高的场景，建议使用带超时判断的循环查询状态标志位的方式。

2.4 EEPROM数据存储与I2C协议要点

开发板上的EEPROM（如AT24C02）通常通过I2C总线连接。HAL库的I2C驱动封装得比较好，但使用不当也会踩坑。核心函数是HAL_I2C_Mem_Write和HAL_I2C_Mem_Read，它们支持直接指定设备地址和内存地址。

写入数据时，需要注意EEPROM的页写限制。例如AT24C02的一页是8字节，如果你要连续写入10个字节，从地址0开始写，前8字节会成功写入第0页，但第9个字节会尝试写入第1页的首地址。如果写入速度太快，可能导致页面翻转错误。安全的做法是，在跨页写入时，先计算剩余空间，分两次调用写函数，中间加入足够的延时（查阅芯片手册，典型值为5ms）。

读取数据相对简单，没有页限制。但要注意I2C总线是开漏输出，必须接上拉电阻。HAL库的I2C通信函数也都有Timeout参数，处理方式和串口类似。在比赛环境中，如果读写失败，要有重试机制，比如循环尝试3次，每次失败后稍作延时。

一个常见的应用场景是存储系统参数或校准数据。例如，将DS18B20读取的温度值，取一个平均值后，连同时间戳一起存储到EEPROM的特定扇区。需要设计一个简单的存储结构体，并规划好各参数在EEPROM中的地址偏移，避免数据覆盖。

3. 系统整合与数据流设计实战

3.1 外设初始化与任务调度框架

拿到一个综合性的题目，第一步不是在CubeMX里乱点一通，而是先画一个系统框图，理清数据流。以这个练习为例：DS18B20定时采集温度 -> 主程序处理数据（如滤波） -> 更新数码管显示缓冲区 -> 定时器中断负责扫描显示 -> 同时，主程序判断是否达到上报条件（如每5秒）-> 通过串口发送数据 -> 另外，系统上电或收到特定串口命令时，从EEPROM读取历史数据或配置。

在CubeMX中的配置顺序也有讲究：

1. 时钟树（Clock Configuration）：这是重中之重。先根据外部晶振频率（如果使用），配置好系统主频（HCLK）。STM32G4性能强劲，但比赛时未必需要跑到最高频率，稳定优先。确保给所用定时器、串口、I2C的时钟源（APB1/APB2）使能并分配合适的频率。
2. GPIO：将DS18B20的DQ、数码管的段选和位选、I2C的SCL/SDA、串口的TX/RX等引脚配置好。注意推挽输出、开漏输出、上拉输入模式的选择。DS18B20的DQ引脚在程序中需要动态切换输入输出模式，初始可以设为开漏输出并上拉。
3. 定时器：至少需要两个。一个基本定时器（TIM6/7）用于DS18B20的微妙延时。一个通用定时器（TIM2/3/4）用于数码管动态扫描中断。配置好预分频和周期，计算中断时间。
4. 串口：配置波特率、数据位、停止位、校验位。务必开启串口全局中断。如果使用DMA接收，还要配置DMA通道。
5. I2C：配置速度模式（标准模式100kHz或快速模式400kHz），地址模式（7位）。

生成代码后，在main.c的/* USER CODE BEGIN 2 */和/* USER CODE END 2 */之间集中进行外设的启动初始化，如启动定时器、启动串口DMA接收、初始化显示缓冲区等。

3.2 温度采集与显示线程实现

DS18B20的读取不能放在主循环里漫无目的地跑，最好也由定时器触发。我们可以再启用一个定时器（或者复用已有的扫描定时器，但周期更长，比如1秒），在其回调函数中启动一次温度转换和读取流程。

由于DS18B20的转换需要时间（最大750ms），我们不能在中断回调里死等。正确的做法是采用状态机。在定时器回调中，我们只是设置一个标志位，如Temperature_Update_Flag = 1。在主循环中查询这个标志位，如果置位，则执行一个非阻塞的DS18B20读取状态机。这个状态机可以包含几个状态：START_CONVERT（发送转换命令）、WAIT_CONVERT（等待转换完成，这里可以延时或查询）、READ_TEMP（读取温度寄存器）、PROCESS_DATA（处理数据，如转换格式、滤波）。完成一次读取后，清除标志位，并更新Display_Buffer。

数码管显示则完全由另一个定时器中断驱动，如前面所述，主程序只负责更新缓冲区Display_Buffer。这里有一个细节：温度值可能是浮点数（如25.12°C），而数码管只能显示数字。我们需要将其分离成整数部分和小数部分，分别存入缓冲区的不同位置。同时，要处理好负温度和百位数的显示，可能需要动态关闭不用的数码管位。

3.3 串口命令解析与数据存储联动

串口不仅是输出，更是输入和控制通道。我们可以设计一个简单的文本协议，例如：

• READ_TEMP：返回当前温度。
• SAVE_TO_EEPROM：将当前温度值保存到EEPROM的下一个地址。
• READ_EEPROM [addr]：读取指定EEPROM地址的数据并返回。

在HAL_UARTEx_RxEventCallback回调中，我们收到了一帧完整的字符数据。接下来需要解析。一个健壮的解析器应该能处理空格、回车换行符（\r\n），并识别不同的命令。可以使用sscanf或自己编写字符串比较函数。解析出命令后，设置相应的任务标志位，如Cmd_Save_Flag，然后在主循环中执行对应的EEPROM写入或读取操作。

EEPROM的写入操作比较耗时，且期间可能会禁用中断，因此不宜在串口接收回调函数中直接执行。同样，采用“标志位+主循环处理”的模式。当需要保存温度时，将温度值拷贝到一个临时变量，并设置Eeprom_Write_Flag。在主循环中检测到该标志，则调用HAL_I2C_Mem_Write函数，写入成功后清除标志，并通过串口发送确认信息。

这种“中断触发、标志位通信、主循环调度”的模式，是保持系统响应性和稳定性的关键。它避免了在中断中执行耗时操作，也使得各个功能模块相对独立，便于调试和维护。

4. 调试技巧与常见问题排查实录

4.1 模块独立测试与联调策略

在整合系统前，务必对每个模块进行独立测试，这是最高效的排错方法。

1. DS18B20测试：编写一个最简单的测试程序，只做一件事：循环读取温度并通过串口打印（用printf重定向）。如果读出来全是0xFF或0x00，首先检查硬件连接（上拉电阻是否接了？通常需要4.7kΩ上拉到VCC）。然后用逻辑分析仪或示波器抓取DQ线的波形，对照DS18B20的时序图，看复位脉冲、读写时隙的时间是否达标。没有仪器的话，可以尝试调整延时函数中的微秒数，一点点试。
2. 数码管测试：写一个固定显示“1234”的程序。如果全不亮，检查位选和段选的共阳/共阴类型是否搞反，驱动电流是否足够（可能需要三极管驱动）。如果显示乱码，检查段码表是否正确，GPIO引脚是否映射对了。如果闪烁严重，调整动态扫描的定时器中断周期。
3. 串口测试：使用串口助手，先测试发送。如果收不到，检查波特率、线序（TX接RX）。再测试接收，在串口助手发送数据，看是否能进入接收中断回调函数。如果使用空闲中断+DMA，要确保HAL_UARTEx_ReceiveToIdle_DMA在初始化后只调用一次，它会自动重装。
4. EEPROM测试：先写一个字节（如0xAA）到地址0，然后立刻读回来验证。如果不成功，检查I2C地址（AT24C02通常是0xA0），用逻辑分析仪看I2C总线是否有起始信号、地址应答。注意I2C的上拉电阻（通常4.7kΩ）必不可少。

所有模块单独调通后，再进行两两联调，最后整合。整合时最常见的问题是中断冲突或资源竞争。例如，DS18B20的延时函数如果用了阻塞式，可能会打断数码管扫描定时器中断，导致显示异常。这时就要坚持使用定时器产生延时。

4.2 典型问题排查速查表

下面表格整理了我调试过程中遇到的一些典型问题及解决方法：

4.3 性能优化与稳定性提升心得

在确保功能正确后，可以进一步优化系统，这对于比赛争取高分和实际项目都很有用。

1. 降低功耗：STM32G4有丰富的低功耗模式。在等待用户命令或传感器采集间隔期间，如果没有其他任务，可以让主循环进入__WFI()（等待中断）指令，或使用HAL库的HAL_PWR_EnterSLEEPMode函数进入睡眠模式。DS18B20完成温度转换后，可以将其设置为掉电模式（发送0xB4命令，但注意唤醒需要重新初始化）。
2. 提高采集精度：DS18B20本身精度不错，但可以软件滤波。比如连续读取10次，去掉最大最小值后求平均。注意滤波算法会增加延迟，需权衡。
3. 增强通信可靠性：串口数据包可以增加帧头、帧尾和校验和（如CRC8）。在接收解析时，先校验再处理，丢弃错误包。对于EEPROM存储，可以设计存储“版本号”或“魔法数字”，上电时校验，防止读到非法数据。
4. 代码模块化与可移植性：将DS18B20、数码管、EEPROM的驱动分别写成独立的.c/.h文件。硬件相关的引脚定义、延时函数接口，通过宏或函数指针来抽象。这样，换一块不同引脚布局的开发板，你只需要修改头文件里的配置，而不需要改动驱动逻辑。这正是HAL库倡导的思想。

调试这样的综合系统，逻辑分析仪几乎是必备的。它能同时抓取多路数字信号（如DQ线、位选信号、I2C的SCL/SDA），让你清晰地看到各个模块的时序交互，定位问题是硬件时序不对还是软件逻辑错误，效率比串口打印高得多。如果没有，也要善用开发板上的LED和串口打印关键标志位状态，采用“二分法”逐步缩小问题范围。