STM32 单片机开发 - I2C 总线协议与温湿度传感器实战

1. I2C总线协议：嵌入式开发的"双人对话"艺术

我第一次接触I2C总线时，感觉就像在学一门新的语言。不过别担心，这门语言其实很简单，只有两根线就能让多个设备相互交流。想象一下，你在一个房间里同时和几个人对话，但每次只和一个人说话，其他人都在安静聆听——这就是I2C总线的工作原理。

I2C（Inter-Integrated Circuit）是飞利浦公司开发的一种串行通信协议，它只需要两根线：SDA（数据线）和SCL（时钟线）。这两根线都需要接上拉电阻，确保在空闲时保持高电平状态。在实际项目中，我通常使用4.7kΩ的上拉电阻，这个值在大多数情况下都能稳定工作。

为什么I2C在嵌入式领域如此受欢迎？主要是因为它简单高效。相比并行总线需要十几根线，I2C只用两根线就能连接多个设备，大大简化了PCB布线和硬件设计。我现在做的智能家居项目中，一个STM32主控通过I2C同时连接了温湿度传感器、光敏传感器和OLED显示屏，所有设备都挂在那两根线上，井然有序地工作。

I2C支持三种速率模式：标准模式（100kbps）、快速模式（400kbps）和高速模式（3.4Mbps）。对于大多数传感器应用，标准模式就足够了。我记得第一次调试I2C时，因为没注意速率配置，导致通信失败，后来才发现传感器只支持100kbps，而我的配置是400kbps。这个坑希望大家能避开。

2. 硬件连接：搭建稳定的通信桥梁

硬件连接是I2C通信的基础，如果这里出了问题，软件再怎么调试都是白费功夫。在实际项目中，我总结了一些硬件设计的经验，分享给大家。

首先是上拉电阻的选择。很多人不知道这个电阻值怎么确定，其实有个简单的计算方法：Rp(min) = (Vdd - Volmax) / Iol，Rp(max) = tr / (0.8473 × Cb)。其中Vdd是电源电压，Volmax是低电平最大电压，Iol是低电平输出电流，tr是上升时间，Cb是总线电容。如果觉得计算太复杂，直接用4.7kΩ到10kΩ之间的电阻基本都能工作。

接线时要注意走线尽量短，避免过长的线缆引入干扰。我有次项目因为SDA线走了个长回路，导致通信不稳定，数据经常出错。后来缩短走线距离并加了屏蔽，问题就解决了。

设备地址的分配也很重要。每个I2C设备都有唯一的7位地址，理论上可以连接128个设备，但实际应用中地址冲突很常见。比如SHT20的默认地址是0x40，而某些EEPROM也是这个地址。这时候就需要查看设备手册，看是否支持地址修改，或者使用I2C多路复用器。

电源滤波也不能忽视。每个I2C设备最好都加一个0.1uF的退耦电容，特别是在使用长线缆时。我曾经遇到一个诡异的问题：通信时好时坏，最后发现是电源噪声导致的，加上退耦电容后就稳定了。

3. 通信协议：掌握I2C的"语言规则"

I2C协议就像一套精心设计的对话规则，掌握了这些规则，你就能让设备间流畅交流。让我用最直观的方式解释这些协议细节。

起始条件（START）和停止条件（STOP）是对话的开始和结束。当SCL为高电平时，SDA从高变低表示起始条件；SDA从低变高表示停止条件。这里有个容易出错的地方：必须在SCL为高时改变SDA状态，否则设备无法识别。

数据传输时，每个时钟周期传输1位数据。在SCL高电平期间，SDA必须保持稳定，接收方在这个时候读取数据；在SCL低电平期间，发送方可以改变SDA状态。我建议在编程时严格遵循这个时序，否则很容易出现数据错误。

应答机制（ACK/NACK）是确保数据可靠传输的关键。每传输完8位数据后，接收方需要在第9个时钟周期发送应答信号：低电平表示ACK（应答），高电平表示NACK（非应答）。如果发送方没收到ACK，就知道数据传输失败了。

寻址过程是I2C通信的核心步骤。主机先发送起始条件，然后发送7位从机地址加1位读写标志（0写1读）。从机收到地址后，如果匹配自己的地址，就发送ACK应答。这里要注意地址的方向：写地址是(addr<<1)|0，读地址是(addr<<1)|1。

多字节传输时有两种情况：地址连续和地址不连续。地址连续时，数据会自动存入下一个地址；地址不连续时，需要重新发送起始条件和寄存器地址。我在处理SHT20传感器时，就是采用单次读取的方式，每次都要重新发起传输。

4. SHT20温湿度传感器：环境监测的精准之选

SHT20是Sensirion公司推出的一款高精度温湿度传感器，我在多个项目中都使用过它，性能确实可靠。先说说它的主要特性：温度测量范围-40到125℃，精度±0.3℃；湿度测量范围0-100%RH，精度±3%RH。这样的精度对于大多数应用场景都足够了。

传感器内部结构很精巧。湿度传感器采用电容式原理，温度传感器则是带隙式。这两个传感器都集成在同一个芯片上，保证了测量的一致性。我测试过在不同温湿度条件下的性能，结果都很稳定。

SHT20支持两种测量模式：保持主机模式（Hold Master）和非保持主机模式（No Hold Master）。保持主机模式下，传感器会保持SCL线为低电平，直到测量完成；非保持模式下，传感器释放总线，主机需要等待测量完成后再读取数据。在实际使用中，我更喜欢用非保持模式，这样不会阻塞总线，可以同时操作其他设备。

测量精度可以通过配置寄存器来设置。湿度测量可以选择12位或8位分辨率，温度测量可以选择14位或12位分辨率。分辨率越高，测量时间越长。通常我用12位湿度+14位温度的配置，测量时间约30ms，既能保证精度又不影响实时性。

传感器的校准数据存储在OTP内存中，出厂时已经校准好，我们直接使用即可。不过要注意，长期使用后可能会有漂移，建议每年进行一次校准。我在一个农业监测项目中，传感器连续工作了两年，精度仍然在允许范围内。

5. 实战准备：搭建开发环境

开始编程前，我们需要准备好开发环境。我习惯使用STM32CubeMX+Keil MDK的组合，这个组合既直观又强大。下面详细说说环境搭建的步骤。

首先安装STM32CubeMX，这是ST官方提供的图形化配置工具。安装完成后，记得安装对应的HAL库，这样才能支持最新的芯片型号。我建议安装最新版本的CubeMX和HAL库，因为旧版本可能不支持某些新特性。

创建新工程时，选择正确的芯片型号至关重要。我使用的是STM32U575RIT6，这是STM32U5系列的一款芯片，性能足够强大。选择芯片后，CubeMX会显示芯片的引脚图，我们可以开始配置外设。

I2C配置是关键步骤。在Pinout界面找到I2C1，选择I2C模式。STM32U575的I2C1默认对应PB6（SCL）和PB7（SDA），这两个引脚会自动配置为复用功能。在Configuration标签页中，设置I2C参数：标准模式、100kHz速率、7位地址模式。这些参数要和传感器规格匹配。

除了I2C，我们还需要配置串口用于调试输出。我使用USART1，对应PA9（TX）和PA10（RX）。设置波特率为9600，数据位8位，无校验位，停止位1位。这个配置和大多数串口工具兼容。

时钟配置也很重要。STM32U575支持多种时钟源，我通常使用HSI（内部高速时钟）作为系统时钟源，配置为160MHz。I2C时钟需要单独配置，确保不超过100kHz。时钟树配置看起来复杂，但CubeMX提供了可视化界面，只需要拖动滑块就能完成配置。

最后生成代码时，选择MDK-ARM作为工具链，勾选"生成外围初始化代码"和"保留用户代码"选项。这样生成的代码既完整又方便我们添加自定义代码。

6. 编程实现：从底层驱动到应用逻辑

现在进入最有趣的编程环节。我将分享如何编写稳定可靠的SHT20驱动程序，这些代码都是经过实际项目验证的。

首先创建sht20.h头文件，定义常用的宏和函数原型：

#ifndef __SHT20_H
#define __SHT20_H

#include "stdint.h"
#include "i2c.h"

#define SHT20_ADDRESS        0x40
#define SHT20_ADDRESS_W      ((SHT20_ADDRESS << 1) | 0)
#define SHT20_ADDRESS_R      ((SHT20_ADDRESS << 1) | 1)

#define TEMP_CMD             0xE3
#define HUM_CMD              0xE5

uint16_t SHT20_Read_Value(uint8_t command);
float SHT20_Convert_Temperature(uint16_t raw_value);
float SHT20_Convert_Humidity(uint16_t raw_value);

#endif

接下来实现sht20.c文件中的核心函数。读取数据的函数需要处理完整的I2C通信流程：

#include "sht20.h"
#include "main.h"

uint16_t SHT20_Read_Value(uint8_t command)
{
    uint8_t buffer[3];
    uint16_t result = 0;
    
    // 发送测量命令
    HAL_I2C_Master_Transmit(&hi2c1, SHT20_ADDRESS_W, &command, 1, 100);
    
    // 等待测量完成
    HAL_Delay(50);
    
    // 读取测量结果
    if (HAL_I2C_Master_Receive(&hi2c1, SHT20_ADDRESS_R, buffer, 3, 100) == HAL_OK)
    {
        // 检查CRC校验（可选）
        result = (buffer[0] << 8) | buffer[1];
    }
    
    return result;
}

数据转换函数将原始数据转换为实际的温湿度值：

float SHT20_Convert_Temperature(uint16_t raw_value)
{
    // 清除状态位
    raw_value &= 0xFFFC;
    
    // 转换为温度值
    return -46.85 + 175.72 * (raw_value / 65536.0);
}

float SHT20_Convert_Humidity(uint16_t raw_value)
{
    // 清除状态位
    raw_value &= 0xFFFC;
    
    // 转换为湿度值
    return -6.0 + 125.0 * (raw_value / 65536.0);
}

在主循环中，我们可以这样调用这些函数：

while (1)
{
    uint16_t temp_raw = SHT20_Read_Value(TEMP_CMD);
    uint16_t hum_raw = SHT20_Read_Value(HUM_CMD);
    
    float temperature = SHT20_Convert_Temperature(temp_raw);
    float humidity = SHT20_Convert_Humidity(hum_raw);
    
    printf("Temperature: %.2f C, Humidity: %.2f %%\r\n", temperature, humidity);
    
    HAL_Delay(2000);
}

这段代码每隔2秒读取一次温湿度数据，并通过串口输出。在实际项目中，我通常会增加错误处理机制，比如检查返回值，重试失败的操作等。

7. 调试技巧：解决常见问题的方法

调试I2C通信可能会遇到各种问题，我总结了一些常见问题的解决方法，希望能帮你少走弯路。

第一个常见问题是I2C总线死锁。有时候设备没有正确响应，导致SCL线被拉低，整个总线卡死。解决方法是先尝试发送停止条件，如果不行就重新初始化I2C外设。我在代码中加了这样的恢复机制：

void I2C_Recovery(void)
{
    // 尝试发送停止条件
    HAL_I2C_Master_Transmit(&hi2c1, 0x00, NULL, 0, 10);
    
    // 如果还不行，重新初始化I2C
    HAL_I2C_DeInit(&hi2c1);
    HAL_Delay(10);
    MX_I2C1_Init();
}

第二个问题是时序不匹配。不同设备的响应速度可能不同，需要适当增加超时时间。我通常把超时设置为100ms，这样既能保证可靠性，又不会影响实时性。

用逻辑分析仪调试I2C非常有效。我用的Saleae逻辑分析仪可以直接解码I2C信号，显示地址、数据和ACK/NACK状态。通过分析波形，很容易找到时序问题。如果没有逻辑分析仪，也可以用示波器观察SDA和SCL的波形。

软件模拟I2C是另一个调试手段。当硬件I2C出现问题時，可以先用GPIO模拟I2C时序，确保传感器本身没有问题。模拟IO的代码虽然效率低，但调试起来更灵活。

数据准确性也需要验证。我通常用标准温湿度计作为参考，对比传感器的读数。如果发现偏差，可以软件校准：记录多个点的误差，然后用插值法进行补偿。

电源噪声会影响测量精度。我有次发现湿度读数跳动很大，最后发现是开关电源的噪声导致的。换成线性电源后问题就解决了。建议在重要应用中使用LDO为传感器供电。

8. 进阶应用：优化与扩展

掌握了基础功能后，我们可以进一步优化代码和扩展功能。这些进阶技巧能让你的项目更加专业和可靠。

首先考虑低功耗优化。SHT20支持低功耗模式，在不需要测量时可以进入睡眠状态。我设计的智能家居传感器，平时每秒测量一次，检测到无人时改为每分钟测量一次，电池续航时间从一周延长到一个月。

数据滤波算法也很重要。原始数据可能会有噪声，我通常使用移动平均滤波或卡尔曼滤波。简单的移动平均滤波实现如下：

#define FILTER_SIZE 5

float moving_average(float new_value, float *buffer)
{
    static int index = 0;
    static float sum = 0;
    
    sum -= buffer[index];
    buffer[index] = new_value;
    sum += new_value;
    
    index = (index + 1) % FILTER_SIZE;
    return sum / FILTER_SIZE;
}

多传感器协同是另一个方向。我可以同时读取温湿度和光照数据，当温度过高且光照强烈时，自动控制窗帘和空调。这种联动控制能创造更舒适的环境。

数据记录功能也很有用。我添加了SD卡模块，每小时记录一次数据，用于长期趋势分析。记录的数据可以导出到电脑，用Excel或Python进行进一步分析。

无线传输是现代应用的标配。我通过ESP8266模块将数据上传到云平台，这样就能用手机随时查看温湿度情况。MQTT协议是个不错的选择，轻量级且支持性好。

最后考虑可靠性设计。我添加了看门狗定时器，防止程序跑飞；使用EEPROM存储校准参数；增加硬件故障检测等功能。这些设计让系统能够长期稳定运行。