简介面向嵌入式开发者和物联网爱好者的 STM32F103 驱动 CCS811 完整工程围绕室内空气质量监测中 CO2 与 TVOC 浓度采集展开适合熟悉 C 语言和基础外设、希望深入学习传感器驱动的开发者。工程基于 Keil μVision 搭建核心代码包含 I2C 初始化、读写时序与数据转换逻辑同时提供 DHT11 温湿度实验可对照学习 I2C 与单总线两种传感器通信方式覆盖从寄存器配置到实际数据读取的完整流程。压缩包共 418 个文件约 13.92MB以 .c/.h 源文件、.o/.crf 编译中间文件、.hex 烧录文件、.uvprojx 工程文件及 .bat 辅助脚本为主其中包含大量标准外设库代码和多个流水灯、定时器示例便于在 Keil 中直接打开编译验证。资源内部按 Listing、User、Output、Project、Libraries 等目录分类方便快速定位源码、输出文件和文档。目前已有 1237 人学习下载可结合 CCS811 数据手册理解寄存器配置并参考实际工程完成驱动移植或二次开发。 最近在做一个小型空气质量监测项目核心方案就是用STM32F103来驱动CCS811这颗气体传感器。把整个驱动过程从硬件连接到寄存器操作、从基线管理到低功耗策略完整过了一遍这里把踩过的坑和最终稳定运行的方案整理出来给后面要玩这颗芯片的朋友做个参考。CCS811是一颗I2C接口的空气质量传感器内部集成了MOX金属氧化物气体传感器和一个MCU可以直接输出等效二氧化碳eCO2单位ppm和总挥发性有机物TVOC单位ppb两个指标不用自己跑复杂的算法。再加上STM32F103这颗经典的Cortex-M3单片机成本低、资料多、生态成熟两者搭配做室内空气监测、新风系统联动、车载净化器控制这类场景非常合适。1. 项目概述与整体思路1.1 核心需求解析CCS811和ST官方自己的温湿度传感器不一样它输出的不是原始ADC值而是经过内部算法处理后的空气质量等级数据。这意味着驱动它的核心工作分两块一是通过I2C正确读写寄存器把传感器配置到工作状态二是理解它的数据格式和校准机制把读回来的原始数据转换成有意义的eCO2和TVOC值。这颗芯片的I2C地址是0x5AADDR引脚拉低时如果ADDR引脚拉高则变为0x5B。支持标准模式100kHz和快速模式400kHzSTM32F103的硬件I2C跑400kHz完全没问题。不过我实测下来如果只是做数据采集100kHz反而更稳因为CCS811的数据手册明确写了它内部算法需要一定时间稳定通信速率不是瓶颈。另一个需要提前理解的点是CCS811上电后默认处于引导模式Boot Mode必须发送一个应用启动命令0xF4才能切换到应用模式Application Mode否则读不到任何有效数据。这个坑我一开始就踩了后面会详细说。1.2 硬件准备清单实际动手前我准备了这些硬件器件型号/规格用途主控板STM32F103C8T6最小系统板主控I2C1作为通信接口传感器CCS811模块GY-CCS811核心传感器下载器ST-Link V2程序烧录与调试USB转串口CP2102模块串口打印数据杜邦线若干母对母连接主控与模块面包板800孔搭建原型如果你手头是STM32F103ZET6这类大容量芯片或者用的是战舰、精英板接线思路完全一样只是引脚位置不同。CCS811模块大多数是3.3V供电注意不要直接接到5V上否则可能烧掉传感器。2. 硬件连接与初始化配置2.1 引脚分配与接线我使用的是STM32F103的I2C1外设引脚分配如下STM32F103引脚功能连接目标PB6I2C1_SCLCCS811 SCLPB7I2C1_SDACCS811 SDA3.3V电源CCS811 VCCGND地CCS811 GNDPB0可选复位控制CCS811 RSTPB1可选中断输入CCS811 INT这里有个容易被忽略的点CCS811的WAKE引脚必须拉低才能进行I2C通信。很多模块已经把WAKE引脚在板上拉低了但有些模块没有如果你的模块上电后I2C扫描不到设备优先检查WAKE引脚是否接地。2.2 I2C上拉电阻与电平问题STM32F103的I2C1_SCL和I2C1_SDA需要外接上拉电阻。我最初的接线没有加上拉电阻结果I2C通信时好时坏排查了很久才发现是这个问题。常见做法是接4.7kΩ到3.3V。如果你用的是现成的模块部分模块板上已经自带上拉电阻了直接用就行。如果不确定用万用表量一下SCL和SDA引脚对3.3V的电压如果接近0说明没有上拉需要自己补上。关于GPIO承受5V的问题STM32F103的数据手册标注了绝大多数IO是5V容忍的FT引脚但I2C引脚PB6/PB7也是FT引脚所以理论上可以接到5V上拉的I2C总线上。不过为了稳妥我建议还是统一用3.3V上拉毕竟CCS811的I2C电平不能超过VDD0.3V。2.3 初始化流程代码我用的是标准外设库来初始化I2C1流程如下void I2C1_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; I2C_InitTypeDef I2C_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_I2C1, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_6 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_OD; // 开漏输出 GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOB, GPIO_InitStructure); I2C_InitStructure.I2C_Mode I2C_Mode_I2C; I2C_InitStructure.I2C_DutyCycle I2C_DutyCycle_2; I2C_InitStructure.I2C_OwnAddress 0x00; I2C_InitStructure.I2C_Ack I2C_Ack_Enable; I2C_InitStructure.I2C_AcknowledgedAddress I2C_AcknowledgedAddress_7bit; I2C_InitStructure.I2C_ClockSpeed 100000; // 100kHz I2C_Init(I2C1, I2C_InitStructure); I2C_Cmd(I2C1, ENABLE); }这里有个细节GPIO模式必须配置为复用开漏AF_OD不能是推挽输出。原因很简单I2C协议本身靠拉低电平来通信高电平由上拉电阻提供如果配置成推挽输出两个设备同时操作总线时可能会出现短路风险。3. 驱动CCS811的核心操作3.1 切换工作模式CCS811通电后处于引导模式必须先发送应用启动命令。这步操作很简单往0xF4寄存器写入数据即可但要注意的是这条命令是只写的不需要参数。uint8_t ccs811_start_app(void) { uint8_t buf[1] {0xF4}; return I2C_WriteBytes(CCS811_I2C_ADDR, 0x00, buf, 1); }发送完成后建议延时100ms再查询状态寄存器0x00确认APP_VALID位bit4值为1和FW_MODE位bit7值为1都已置位表示传感器已经进入应用模式。如果FW_MODE为0说明还在引导模式需要检查命令是否正确发送。3.2 配置测量模式CCS811的测量模式由寄存器0x01MEAS_MODE控制关键是DRIVE_MODE位bit4-6。我使用的最多的是每250ms采样一次的模式即DRIVE_MODE 2既能保证数据实时性功耗也不算高。DRIVE_MODE采样间隔电流消耗参考适用场景0空闲极低低功耗唤醒前1每1s约12mA一般室内监测2每10s约7mA电池供电3每60s约3mA长期监测4每250ms约26mA快速响应需求3.3 读取空气质量数据当传感器完成一次采样后STATUS寄存器0x00的bit3DATA_READY会置1这时可以读取寄存器0x02ALG_RESULT_DATA一次读取4个字节格式如下Byte0eCO2的高8位Byte1eCO2的低8位Byte2TVOC的高8位Byte3TVOC的低8位换算很简单eCO2 (byte0 8) | byte1单位ppmTVOC (byte2 8) | byte3单位ppb。uint8_t ccs811_read_air_quality(uint16_t *eco2, uint16_t *tvoc) { uint8_t buf[4]; uint8_t status; // 读取状态寄存器 I2C_ReadBytes(CCS811_I2C_ADDR, 0x00, status, 1); // 检查DATA_READY位 if (!(status 0x08)) { return 1; // 数据未就绪 } // 读取4字节结果 I2C_ReadBytes(CCS811_I2C_ADDR, 0x02, buf, 4); *eco2 (buf[0] 8) | buf[1]; *tvoc (buf[2] 8) | buf[3]; return 0; }3.4 完整初始化流程实际项目中我总结了一个比较稳妥的初始化序列uint8_t ccs811_init(void) { uint8_t status; // 1. 等待传感器上电稳定 delay_ms(50); // 2. 如果需要复位拉低复位引脚10ms // GPIO_ResetBits(GPIOB, GPIO_Pin_0); // delay_ms(10); // GPIO_SetBits(GPIOB, GPIO_Pin_0); // delay_ms(20); // 3. 启动应用模式 if (ccs811_start_app() ! 0) { return 1; } delay_ms(100); // 4. 验证应用模式 I2C_ReadBytes(CCS811_I2C_ADDR, 0x00, status, 1); if ((status 0x90) ! 0x90) { return 2; // 应用模式未生效 } // 5. 设置测量模式10s间隔 uint8_t mode 0x30; // DRIVE_MODE 2即每10s采样一次 I2C_WriteBytes(CCS811_I2C_ADDR, 0x01, mode, 1); return 0; }4. 数据稳定性优化与低功耗设计4.1 基线Baseline管理CCS811的精度会随着时间漂移内部算法支持基线校准。合理的做法是定期读取基线值存到Flash下次上电时写回可以显著减少重新预热和稳定所需的时间。读取基线需要发送0x03读取BASELINE命令但要注意的是必须先发送0x00作为命令字节再读取2字节数据顺序不能反这是CCS811的一个特殊点。uint16_t ccs811_read_baseline(void) { uint8_t cmd 0x00; uint8_t buf[2]; uint16_t baseline; I2C_WriteBytes(CCS811_I2C_ADDR, 0x03, cmd, 1); delay_ms(10); I2C_ReadBytes(CCS811_I2C_ADDR, 0x03, buf, 2); baseline (buf[0] 8) | buf[1]; return baseline; } void ccs811_write_baseline(uint16_t baseline) { uint8_t buf[2]; buf[0] (baseline 8) 0xFF; buf[1] baseline 0xFF; I2C_WriteBytes(CCS811_I2C_ADDR, 0x03, buf, 2); }实际测试中基线存储在Flash后每次上电写回基线传感器从冷启动到数据稳定的时间从约20分钟缩短到了约5分钟效果非常明显。4.2 温湿度补偿CCS811的测量精度受环境温湿度影响较大手册推荐在已知环境温湿度时对传感器进行补偿。实现方法是通过0x02ENV_DATA寄存器写入当前温湿度数据。需要注意的是写入的温湿度数据不是常见的浮点而是定点格式。湿度数据 实际湿度 × 512温度数据 (实际温度 25) × 512分别用16位整数表示。void ccs811_set_env_data(float humidity, float temperature) { uint16_t hum (uint16_t)(humidity * 512); uint16_t temp (uint16_t)((temperature 25) * 512); uint8_t buf[4]; buf[0] (hum 8) 0xFF; buf[1] hum 0xFF; buf[2] (temp 8) 0xFF; buf[3] temp 0xFF; I2C_WriteBytes(CCS811_I2C_ADDR, 0x02, buf, 4); }提示如果你不接入温湿度传感器可以不发送这组数据CCS811会使用内部默认值。但如果系统里本身有SHT30、DHT22这类传感器把数据补偿进去能明显改善数据漂移。4.3 低功耗策略前面写到STM32F103有停机模式Stop Mode结合CCS811的低功耗特性可以做一个电池供电的空气质量监测节点。方案如下CCS811配置为每60s采样一次的DRIVE_MODE 3模式每次数据就绪后唤醒STM32F103读取数据读完后立刻进入停机模式用RTC定时唤醒。实测整机平均电流可以控制在5mA以内。不过有一点要注意CCS811在测量过程中的瞬时电流可以达到30mA左右如果电池供电建议在电源端并联一个100μF以上的电容避免瞬间压降导致传感器复位或数据异常。5. 常见问题与排查技巧5.1 I2C通信故障现象1扫描不到0x5A或0x5B地址排查顺序电源电压是否正常 → WAKE引脚是否拉低 → SCL/SDA是否接反 → 上拉电阻是否在位 → I2C速率是否过高改到100kHz试。如果用的是杜邦线加面包板接触不良也是常见原因建议焊接到洞洞板上测试。我测试时就遇到过杜邦线氧化导致时通时断的情况。现象2读寄存器可以写寄存器失败这个通常是I2C的写时序问题。CCS811的大多数寄存器需要先写入寄存器地址再写入数据。如果用的是HAL库的HAL_I2C_Master_Transmit注意要先发送寄存器地址再发数据不能两个一起发。比如写MEAS_MODE时下面两种写法效果不同// 写法一先发寄存器地址再发数据正确 uint8_t reg 0x01; uint8_t data 0x30; HAL_I2C_Master_Transmit(hi2c1, CCS811_ADDR, reg, 1, 100); HAL_I2C_Master_Transmit(hi2c1, CCS811_ADDR, data, 1, 100); // 写法二一次发2字节部分芯片可以CCS811实测不稳定 uint8_t buf[2] {0x01, 0x30}; HAL_I2C_Master_Transmit(hi2c1, CCS811_ADDR, buf, 2, 100);CCS811的I2C实现有点特殊和标准I2C从机不太一样建议严格按照数据手册的时序图来。5.2 数据异常问题现象3eCO2一直显示400ppm长时间不变化这是CCS811的初始值。传感器上电后需要一段预热时间算法会自动校准。如果过了30分钟还是400ppm检查传感器周围是否有气流遮挡或者换一个环境试试。现象4eCO2数值跳到8000ppm以上正常情况下这表示空气质量非常差但也可能是传感器被酒精、烟雾等挥发性气体干扰了。如果在干净环境中仍然飘高尝试写一次基线校准值或者重新上电。现象5读回的STATUS寄存器出现ERROR位bit0这意味着传感器内部发生了错误。先读取0xE0ERROR_ID寄存器确认错误类型通常处理方式是重新启动应用模式或完全断电重启。5.3 代码层面的坑现象6使用GPIO模拟I2C时SCL频率不稳定导致通信失败CCS811对时钟延展Clock Stretching有要求GPIO模拟时要注意在每次SCL拉低后保持足够的低电平时间1MHz主频软件延时下至少延时5μs以上再拉高SCL。现象7HAL库读取中断标志位卡死如果用的是STM32的硬件I2C加HAL库有时候会因为总线异常导致HAL_I2C_Master_Receive卡在等待标志上。解决方案是在初始化时设置超时时间并且在I2C错误回调里做总线恢复处理。5.4 上位机与下载器问题做调试时还会遇到一类和传感器本身无关、但同样很折腾的问题——串口打印乱码和下载器连不上。这两个问题几乎每个做STM32项目的人都会碰到顺手记一下。串口乱码十有八九是波特率不匹配或时钟配置不对。用CP2102、CH340这类USB转串口模块时如果程序里用的是8MHz外部晶振但实际板上焊的是12MHz晶振串口输出的汉字就会变成乱码。检查方法很简单用示波器或者逻辑分析仪看TX引脚的波形频率或者直接换一个已知正常的例程测试。下载器连不上的问题更常见。无论是ST-Link还是J-Link第一次使用前一定要装好驱动。ST-Link在Win10/Win11下通常免驱但老版本需要安装ST-Link USB DriverJ-Link则需要安装J-Link驱动包。如果插上设备后设备管理器里能看到设备但没有正确识别多半是驱动版本太老或者被杀毒软件拦截了。一个很容易被忽略的现象是ST-Link/J-Link与目标板共地。如果下载器的GND没有和目标板的GND连在一起烧录时大概率会报“No target connected”或连接不稳定。我之前排查过一台机器问题就是下载线接触不好导致GND虚接换了一根线就好了。6. 扩展思路与项目心得做完基础驱动后我做了进一步扩展把串口输出的原始数据接到ESP8266上通过Wi-Fi上报到MQTT服务器在手机端实时查看室内空气质量变化趋势。整体数据链路就是“STM32F103读CCS811 → 串口输出 → ESP8266转发 → 云端”成本不到50元效果很直观。关于CCS811的精度这里多说一句公道话它的eCO2数值是通过算法估算的不是真正的CO2传感器比如NDIR红外传感器所以绝对值精度有限但用于判断室内空气质量变化趋势、做新风系统联动是够用的。如果项目对CO2浓度有硬性精度要求建议升级用Senseair S8这类NDIR传感器成本会高一个量级。根据我个人的实际体验这颗芯片驱动起来最大的难点不在I2C本身而在于理解它的状态机和数据更新机制——什么状态下能读数据、什么时候需要校准、怎样在保证数据质量的同时降低功耗这些都需要实际跑一段时间才会有感觉。做嵌入式就是这样数据手册读十遍不如跑一遍实测遇到问题先从硬件查起再回头看寄存器配置往往能少走不少弯路。本文还有配套的精品资源点击获取