手把手教你用STM32 HAL库驱动TMP117温度传感器（I2C接口，附完整代码）

STM32 HAL库驱动TMP117高精度温度传感器实战指南

在嵌入式开发中，温度监测是一个基础但至关重要的功能。TMP117作为TI推出的高精度数字温度传感器，以其±0.1°C的测量精度和低功耗特性，成为医疗设备、工业控制等场景的理想选择。相比传统的模拟温度传感器，TMP117通过I2C接口直接输出数字信号，大大简化了硬件设计和软件处理流程。

本文将重点介绍如何利用STM32CubeMX和HAL库快速搭建TMP117的驱动环境，避免底层时序调试的繁琐工作。与传统的模拟I2C实现方式不同，我们将充分利用STM32硬件I2C外设的稳定性和HAL库的便捷性，让开发者能够更专注于业务逻辑的实现。

1. 硬件准备与CubeMX配置

1.1 硬件连接要点

TMP117采用标准的I2C接口，与STM32的连接仅需四条线：

• VCC（3.3V）
• GND
• SCL（时钟线）
• SDA（数据线）

特别注意：TMP117的I2C地址可通过ADDR引脚配置，默认地址为0x48（ADDR接地）。若需要连接多个传感器，可通过改变ADDR引脚电平来设置不同地址。

1.2 CubeMX工程配置步骤

1. 打开STM32CubeMX，创建新工程并选择您的STM32型号
2. 在"Pinout & Configuration"标签页中：
   • 启用I2C外设（通常为I2C1）
   • 配置SCL和SDA引脚（如PB6和PB7）
   • 设置I2C模式为"Standard Mode"（100kHz）或"Fast Mode"（400kHz）
3. 在"Project Manager"标签页中：
   • 设置工具链为您的开发环境（如MDK-ARM）
   • 勾选"Generate peripheral initialization as a pair of .c/.h files"
4. 生成代码

提示：初次使用CubeMX时，建议保持默认配置，待基础功能验证通过后再进行优化调整。

2. HAL库I2C通信基础

2.1 HAL库I2C函数解析

HAL库提供了完善的I2C通信接口，主要函数包括：

HAL_StatusTypeDef HAL_I2C_Master_Transmit(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout); HAL_StatusTypeDef HAL_I2C_Master_Receive(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint8_t *pData, uint16_t Size, uint32_t Timeout); HAL_StatusTypeDef HAL_I2C_Mem_Write(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout); HAL_StatusTypeDef HAL_I2C_Mem_Read(I2C_HandleTypeDef *hi2c, uint16_t DevAddress, uint16_t MemAddress, uint16_t MemAddSize, uint8_t *pData, uint16_t Size, uint32_t Timeout);

对于TMP117这类寄存器型设备，HAL_I2C_Mem_Read/Write是最常用的函数，它们可以直接操作设备内部寄存器。

2.2 通信超时处理

HAL库函数中的Timeout参数需要合理设置：

3. TMP117驱动实现

3.1 寄存器定义与初始化

TMP117的关键寄存器如下：

#define TMP117_REG_TEMP 0x00 // 温度值寄存器 #define TMP117_REG_CONFIG 0x01 // 配置寄存器 #define TMP117_REG_HIGH_LIMIT 0x02 // 温度上限报警 #define TMP117_REG_LOW_LIMIT 0x03 // 温度下限报警 #define TMP117_REG_DEVICE_ID 0x0F // 设备ID寄存器 #define TMP117_DEVICE_ADDR 0x48 // 默认I2C地址

初始化函数示例：

void TMP117_Init(I2C_HandleTypeDef *hi2c) { uint16_t config = 0x0220; // 连续转换模式，8次平均 HAL_I2C_Mem_Write(hi2c, TMP117_DEVICE_ADDR, TMP117_REG_CONFIG, I2C_MEMADD_SIZE_16BIT, (uint8_t*)&config, 2, 100); }

3.2 温度读取实现

温度读取函数需要考虑TMP117的数据格式：

float TMP117_ReadTemperature(I2C_HandleTypeDef *hi2c) { uint8_t data[2]; int16_t temp_raw; float temperature; // 读取温度寄存器 HAL_I2C_Mem_Read(hi2c, TMP117_DEVICE_ADDR, TMP117_REG_TEMP, I2C_MEMADD_SIZE_16BIT, data, 2, 100); // 组合原始数据 temp_raw = (data[0] << 8) | data[1]; // 转换为实际温度值 temperature = temp_raw * 0.0078125f; // LSB = 7.8125m°C return temperature; }

4. 高级功能与优化

4.1 低功耗模式配置

TMP117支持多种工作模式以适应不同功耗需求：

单次转换模式配置示例：

void TMP117_SetOneShotMode(I2C_HandleTypeDef *hi2c) { uint16_t config = 0x0240; // 单次转换模式 HAL_I2C_Mem_Write(hi2c, TMP117_DEVICE_ADDR, TMP117_REG_CONFIG, I2C_MEMADD_SIZE_16BIT, (uint8_t*)&config, 2, 100); }

4.2 温度报警功能

TMP117内置硬件比较器，可在不依赖MCU的情况下实现温度监控：

void TMP117_SetAlarmThresholds(I2C_HandleTypeDef *hi2c, float high, float low) { uint16_t high_raw = (uint16_t)(high / 0.0078125f); uint16_t low_raw = (uint16_t)(low / 0.0078125f); HAL_I2C_Mem_Write(hi2c, TMP117_DEVICE_ADDR, TMP117_REG_HIGH_LIMIT, I2C_MEMADD_SIZE_16BIT, (uint8_t*)&high_raw, 2, 100); HAL_I2C_Mem_Write(hi2c, TMP117_DEVICE_ADDR, TMP117_REG_LOW_LIMIT, I2C_MEMADD_SIZE_16BIT, (uint8_t*)&low_raw, 2, 100); }

5. 常见问题排查

5.1 I2C通信失败排查步骤

1. 检查硬件连接

   • 确认电源电压（3.3V）
   • 检查上拉电阻（通常4.7kΩ）
   • 验证SCL/SDA线序

2. 验证I2C总线

   • 使用逻辑分析仪或示波器观察信号波形
   • 检查时钟频率是否匹配

3. 调试技巧

   • 先尝试读取设备ID寄存器（0x0F），应返回0x0117
   • 逐步增加超时时间测试
   • 检查HAL库版本是否最新

5.2 精度优化建议

• PCB布局：

  • 尽量缩短传感器与MCU的距离
  • 避免将TMP117放置在发热元件附近
  • 使用独立的电源滤波电容

• 软件滤波：

  #define FILTER_SAMPLES 8 float TMP117_ReadFilteredTemperature(I2C_HandleTypeDef *hi2c) { float sum = 0; for(int i=0; i<FILTER_SAMPLES; i++) { sum += TMP117_ReadTemperature(hi2c); HAL_Delay(20); } return sum / FILTER_SAMPLES; }

在实际项目中，我发现TMP117的硬件I2C接口相比软件模拟方案更加稳定可靠，特别是在电磁环境复杂的工业场景中。通过合理配置HAL库参数，可以轻松实现高达400kHz的通信速率，满足大多数应用需求。