STM32F103C8T6驱动HDC1080温湿度传感器：手把手教你写软件I2C代码（附完整工程）
STM32F103C8T6驱动HDC1080温湿度传感器：从零构建软件I2C系统
第一次拿到HDC1080这个小巧的温湿度传感器时，我完全被它简洁的外形欺骗了——官方手册里那些晦涩的时序描述让我在实验室熬了两个通宵。作为嵌入式开发者，我们都经历过被芯片手册"折磨"的阶段。本文将用最直白的语言，带你完整实现STM32F103C8T6通过软件I2C驱动HDC1080的全过程，重点破解手册中最令人困惑的第二步和第三步操作逻辑。
1. 环境搭建与硬件连接
1.1 硬件准备清单
在开始编码前，我们需要准备以下硬件组件：
- STM32F103C8T6最小系统板（Blue Pill开发板）
- HDC1080温湿度传感器模块
- 杜邦线若干
- USB转TTL串口模块（用于调试输出）
连接示意图：
HDC1080 STM32F103C8T6 VCC → 3.3V GND → GND SCL → PB0 SDA → PB1注意：HDC1080的工作电压范围为2.7V-5.5V，但建议使用3.3V供电以确保与STM32电平兼容。
1.2 开发环境配置
推荐使用Keil MDK-ARM作为开发环境，具体配置步骤如下：
- 新建STM32F103C8T6工程
- 选择Device为STM32F103C8
- 在Manage Run-Time Environment中勾选：
- CMSIS → CORE
- Device → Startup
- 设置调试器为ST-Link（根据实际使用的调试工具选择）
// 系统时钟配置示例（在system_stm32f10x.c中） #define SYSCLK_FREQ_72MHz 72000000 void SystemInit(void) { RCC->CFGR |= (uint32_t)RCC_CFGR_PLLMULL9; FLASH->ACR |= FLASH_ACR_LATENCY_2; RCC->CR |= RCC_CR_PLLON; while(!(RCC->CR & RCC_CR_PLLRDY)); RCC->CFGR |= (uint32_t)RCC_CFGR_SW_PLL; while ((RCC->CFGR & (uint32_t)RCC_CFGR_SWS) != (uint32_t)0x08); }2. 软件I2C底层实现
2.1 GPIO端口初始化
软件I2C的核心是通过GPIO模拟时序，首先配置PB0(SCL)和PB1(SDA)为推挽输出模式：
void HDC1080_I2C_GPIO_Configuration(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); // SCL配置 GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &GPIO_InitStructure); // SDA配置（初始化为输出） GPIO_InitStructure.GPIO_Pin = GPIO_Pin_1; GPIO_Init(GPIOB, &GPIO_InitStructure); // 初始状态置高 GPIO_SetBits(GPIOB, GPIO_Pin_0 | GPIO_Pin_1); }2.2 关键时序函数实现
软件I2C需要精确控制以下几个基本时序单元：
- 起始条件：SCL高电平时SDA从高到低跳变
int I2C4_Start(void) { SDA_H; SCL_H; I2C4_delay(); if(!SDA_Status) return 0; // 检测SDA是否被拉低 SDA_L; I2C4_delay(); if(SDA_Status) return 0; // 检测SDA是否成功拉低 SCL_L; I2C4_delay(); return 1; }- 停止条件：SCL高电平时SDA从低到高跳变
void I2C4_Stop(void) { SCL_L; I2C4_delay(); SDA_L; I2C4_delay(); SCL_H; I2C4_delay(); SDA_H; I2C4_delay(); }- 字节传输：每个时钟周期传输1bit数据
void I2C4_WriteByte(uint8_t Data) { uint8_t i; SCL_L; for(i=0; i<8; i++) { if(Data & 0x80) SDA_H; else SDA_L; Data <<= 1; I2C4_delay(); SCL_H; I2C4_delay(); SCL_L; } SDA_H; // 释放SDA线 }3. HDC1080驱动实现
3.1 寄存器地址定义
HDC1080内部有几个关键寄存器需要定义：
| 寄存器名称 | 地址 | 功能描述 |
|---|---|---|
| Temperature | 0x00 | 温度数据寄存器 |
| Humidity | 0x01 | 湿度数据寄存器 |
| Configuration | 0x02 | 配置寄存器 |
| Manufacturer ID | 0xFE | 固定值0x5449(TI的标识) |
| Device ID | 0xFF | 固定值0x1050(器件型号) |
对应的C语言定义：
#define HDC1080_TempAddress 0x00 #define HDC1080_HumiAddress 0x01 #define HDC1080_Configuration 0x02 #define HDC1080_ManufactID 0xFE #define HDC1080_DeviceID 0xFF #define HDC1080_Write_Address 0x80 #define HDC1080_Read_Address 0x813.2 破解手册中的关键步骤
官方手册中最令人困惑的是测量触发流程：
传统理解误区：
- 第二步：执行指针写入事务(0x00)
- 第三步：等待测量完成
- 第四步：读取数据
这看似需要三个独立操作，实际上...
正确实现方式：
int HDC1080_I2C4_ReadBuffer(uint8_t Reg_Addr, uint8_t *pBuffer, uint8_t NumByteToRead) { // 第一步：发送写地址+寄存器地址 I2C4_Start(); I2C4_WriteByte(HDC1080_Write_Address); if(!I2C4_GetAck()) { I2C4_Stop(); return 0; } I2C4_WriteByte(Reg_Addr); if(!I2C4_GetAck()) { I2C4_Stop(); return 0; } // 关键点：这里的20ms延迟同时完成了第二步和第三步 delay_ms(20); // 等待测量完成 // 第四步：读取数据 I2C4_Start(); I2C4_WriteByte(HDC1080_Read_Address); if(!I2C4_GetAck()) { I2C4_Stop(); return 0; } for(uint8_t i=0; i<NumByteToRead; i++) { pBuffer[i] = I2C4_ReadByte(i != NumByteToRead-1); } I2C4_Stop(); return 1; }提示：20ms延迟是HDC1080完成温湿度转换所需的最长时间，实际应用中可以根据需要调整。
4. 数据转换与校准
4.1 原始数据转换公式
从HDC1080读取的原始数据需要按以下公式转换：
温度转换：
T(°C) = (raw_temp / 2^16) × 165 - 40湿度转换：
RH(%) = (raw_humi / 2^16) × 100对应的C语言实现：
void HDC1080_Caculate(uint16_t ut, uint16_t uh, float *rt, float *rh) { *rt = (float)ut / 65536.0f * 165.0f - 40.0f; *rh = (float)uh / 65536.0f * 100.0f; }4.2 实际测试数据对比
在不同环境下的测试结果：
| 环境条件 | 温度读数(°C) | 湿度读数(%RH) | 备注 |
|---|---|---|---|
| 室内常温 | 25.3 | 52.1 | 基准测试 |
| 手指接触传感器 | 27.8 | 0.0 | 湿度传感器被完全遮挡 |
| 靠近热水杯 | 31.2 | 48.7 | 温度上升明显 |
| 冰箱冷藏室 | 6.5 | 35.2 | 低温环境测试 |
4.3 常见问题排查
在实际开发中可能会遇到以下问题：
无响应问题：
- 检查I2C地址是否正确（HDC1080固定地址0x40）
- 确认上拉电阻已连接（通常4.7kΩ）
- 测量供电电压是否稳定
数据异常问题：
- 确保转换等待时间足够（至少20ms）
- 检查时序是否符合标准I2C规范
- 验证CRC校验（如果启用）
精度问题：
- 避免将传感器放置在发热元件附近
- 确保传感器表面清洁无遮挡
- 考虑进行软件滤波处理
// 简单的移动平均滤波实现 #define FILTER_LEN 5 float temp_filter_buf[FILTER_LEN] = {0}; uint8_t filter_index = 0; float filter_temp(float new_val) { temp_filter_buf[filter_index] = new_val; filter_index = (filter_index + 1) % FILTER_LEN; float sum = 0; for(uint8_t i=0; i<FILTER_LEN; i++) { sum += temp_filter_buf[i]; } return sum / FILTER_LEN; }在完成所有代码实现后，建议先用逻辑分析仪抓取I2C波形，确认时序完全符合标准。实际项目中，我发现最容易被忽视的是SCL/SDA线上的毛刺问题，这可以通过适当降低GPIO速度或增加少量延迟来解决。