简介：面向嵌入式初学者的STM32F103C8T6驱动Sensirion SCD4X传感器工程示例，重点解决I²C总线采集二氧化碳、湿度与温度时的协议配置、命令读取与数据换算问题，覆盖从GPIO初始化、I²C主设备收发到传感器数据解析的完整链路，也适合作为智能家居或环境监测项目的基础模板。压缩包共143个文件，大小约3.86MB，内含35个h头文件和34个c源码文件，涵盖I2C驱动、系统时钟、延时以及RCC、USART等标准外设库；Keil工程配置uvprojx/uvoptx可直接打开编译，hex/axf等输出便于烧录验证，另有PDF数据手册和调试文本辅助查阅。已有698人浏览学习。工程在SCD4X驱动之外，还附带LED控制、USART串口打印等示例，读者可按PB6/PB7接线搭建环境监测节点，也可将I2C主机收发代码移植到其他Sensirion传感器上；同时支持J-Link下载与9600波特率串口输出实时测量值，方便联调验证。 一块几十块钱的STM32F103C8T6最小系统板，一颗采用光声传感原理的Sensirion SCD4X二氧化碳传感器模块，成本不到一百多块钱，就能搭出一套能读CO2浓度、温湿度的空气质量监测节点。我去年做室内新风控制项目时就是这么干的，SCD4X只需要I2C两根线，5秒钟出一个带CRC校验的测量帧，表面看是“开箱即用”的典型代表。但真把程序调起来才发现，这颗传感器对电源纹波、时序稳定性和校准逻辑都有隐藏要求，我前后折腾了快一整天，从读不到数据、CRC校验狂报错，到数值纹丝不动，每一步都有对应的坑。这篇文章就以STM32F103C8T6调用SCD4X为主线，把硬件接线、软I2C驱动、测量值转换、校准流程和完整排错链路一次写透，给后面做室内空气监测、新风联动、孵化箱环境监控的兄弟省点时间。
1. 为什么是SCD4X搭配F103C8T6：这套组合的含金量在哪
1.1 SCD4X在CO2传感器里算什么水平
市面上常见的CO2传感器大致分三类：老牌NDIR传感器（如MH-Z19、S8）、金属氧化物半导体传感器（如SGP30）、以及SCD4X这种微型光声传感器。MH-Z19和S8虽然功耗大、体积大、价格便宜，但需要自己处理温度补偿和高度补偿；SGP30测的是eCO2，本质是算法估算值，长期漂移明显；SCD4X则在极小封装里集成了CO2、温度、湿度三个测量项，并且内置了湿度补偿和温度补偿逻辑，出厂校准精度标称40ppm ± 5%，在消费级产品里属于相当能打的存在。
SCD4X最让我满意的是它把复杂度封装得很好。对外只暴露一组I2C寄存器，通过几个命令就可以完成周期测量、单次测量、数据就绪查询、强制校准、海拔设置等操作，不需要像老式NDIR那样去调模拟电路或者处理复杂的PWM输出。它的测量间隔是固定的5秒左右，数据帧格式也简单：CO2两个字节、温度两个字节、湿度两个字节，每两个数据后面跟一个CRC8校验字节，共9字节，解析起来非常直观。
1.2 为什么拿F103C8T6最小系统板而不是更贵的板子
STM32F103C8T6这颗芯片虽然已经“老”了，但它的定位非常准确：64KB Flash、20KB RAM、主频72MHz，对于传感器采集这种轻量级任务绰绰有余。如果只是跑一个裸机循环读SCD4X、刷个OLED、走串口打印，Flash占用一般在30%以内。现在市面上还有不少引脚兼容的国产替代型号，代码不用改，成本还能再压一截，做小批量产品非常合适。
我见过很多新手一上来就上F407甚至H743，实际上对于SCD4X这种I2C从设备，F103的处理能力已经严重过剩。SCD4X的通信速率支持100kHz和400kHz，F103的硬件I2C或者GPIO模拟都毫无压力。另外，它的I2C地址是0x62，如果同一总线上还要挂OLED（一般是0x3C），地址完全不会冲突，这也是我选择这套组合的原因之一。从功能验证到产品化的路径非常平滑，后期想加FreeRTOS、LVGL也都能塞进这颗芯片，只是要注意Flash和RAM的规划。
2. 接线、供电与最小系统板上最容易被忽略的三件事
2.1 引脚分配与上拉电阻
SCD4X模块一共只引出四根线：VDD、GND、SCL、SDA，没有额外的复位、报警或者PWM引脚需要操心。我用的引脚分配很简单：SCL接PB6、SDA接PB7，对应STM32F103的I2C1。如果打算用软件模拟I2C，这两个引脚也可以随便换，但建议保持这个习惯，因为后期如果切到硬件I2C，PB6/PB7可以直接复用。
上拉电阻是第一个容易翻车的地方。SCD4X模块一般板载了上拉电阻，但如果买的是散装传感器、自己画板子，就必须在SCL和SDA上各接一个4.7kΩ到10kΩ的上拉电阻到3.3V。STM32内部虽然有上拉，但内部上拉的阻值偏大，在400kHz模式下边沿不够陡，容易导致通信不稳定。我有个兄弟图省事没加上拉，结果I2C偶尔能通、偶尔卡死，排查了半天才发现是这个问题。如果模块已经有上拉，那就不要再重复加，两个上拉并联会拉低总线电平，反而更糟。
2.2 供电、去耦电容与电平匹配
SCD4X官方手册里供电范围比较宽，但稳妥起见，我建议直接给它供3.3V，这样和STM32的IO电平完全匹配，不需要额外做电平转换。我自己的板子上在传感器的VDD和GND之间放了一个10μF的钽电容和一个0.1μF的陶瓷电容，紧挨着电源引脚放置，这个细节对SCD4X尤其重要。它的内部光声测量腔对电源噪声比较敏感，供电纹波大了之后，CO2读数会出现明显的跳动，甚至会直接拉高CRC错误率。
另外一个经常被忽略的问题是：不要用驱动继电器、电机或者加热丝的那路电源给传感器供电。我用一个12V风扇做风道测试时，风扇一启动，SCD4X的CO2数值就开始上下乱飘，最后把传感器供电单独用了一路LDO，问题才消失。风道方面，SCD4X虽然体积小，但它的气体交换口不能被完全堵死，外壳上至少要留出对流孔，否则传感器内部CO2浓度会被局部环境“困住”，读数会虚高。
3. 驱动实现：软I2C为主、硬I2C为辅的取舍与核心代码
3.1 为什么我最终选了软件I2C而不是硬件I2C
网上关于STM32F103硬件I2C的争议很多，有人说它的硬件I2C有bug，其实严格来说不是芯片完全不能用，而是ST的HAL库在F1上处理I2C事件中断的方式比较绕，配合DMA、超时、总线忙标志的组合容易出问题。我在测试过程中用HAL_I2C_Master_Transmit读SCD4X，确实遇到过调用返回HAL_BUSY、需要复位I2C外设才能恢复的情况。
对于SCD4X这种读一帧数据要经过“发送命令、停止、等待、重发起始、读9字节”的流程，用软件模拟I2C反而更清晰。每位时序自己控制，逻辑分析仪一抓就能看出问题在哪，排错成本低很多。SCD4X默认工作在100kHz或者400kHz，软件I2C只要延时合理，跑400kHz完全没问题，对传感器数据量来说性能绰绰有余。我也建议你先把软I2C跑通，确认传感器正常后再去折腾硬件I2C，否则硬件I2C的坑和传感器的坑叠在一起，排查起来非常痛苦。
3.2 HAL库手工建工程与IO初始化
我习惯用STM32CubeMX建工程。F103C8T6配置好几处关键项：SYS里的Debug选择Serial Wire，不然后面用ST-Link下载第二次就报找不到设备；RCC的HSE选择外部晶振；时钟树配到72MHz；GPIO里把PB6、PB7配置为开漏输出模式，上拉使能。开漏模式配合外部上拉，这样读引脚和写引脚都不需要来回切换模式，SDA释放后由外部上拉拉高，符合I2C总线的线与逻辑。
IO初始化代码实际上是标准HAL的写法：
void Soft_I2C_Init(void) { GPIO_InitTypeDef GPIO_InitStruct = {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); GPIO_InitStruct.Pin = GPIO_PIN_6 | GPIO_PIN_7; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD; GPIO_InitStruct.Pull = GPIO_PULLUP; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(GPIOB, &GPIO_InitStruct); HAL_GPIO_WritePin(GPIOB, GPIO_PIN_6 | GPIO_PIN_7, GPIO_PIN_SET); }开漏输出模式下，将引脚拉高就是释放总线，拉低就是主动驱动低电平，这正是I2C协议需要的。时钟频率不用配到太快，我实际测试中延时函数用的一个空循环，大概在几百纳秒级别，SCD4X就能稳定通信。
3.3 命令帧、时序与CRC8校验
SCD4X的命令帧非常简洁，每条命令都是2字节，部分命令后面需要跟参数和CRC。我常用到的命令整理如下：
| 功能 | 命令字 | 说明 |
|---|---|---|
| 启动周期测量 | 0x21B1 | 每约5秒产生一组新数据 |
| 读取测量值 | 0xEC05 | 读出9字节：CO2、温度、湿度各带CRC |
| 查询数据就绪 | 0xE4B8 | 返回2字节状态，低11位非零表示就绪 |
| 停止周期测量 | 0x3F86 | 退出周期测量，进入待机 |
| 单次测量 | 0x219D | 兼顾低功耗的单次触发模式 |
| 低功耗周期测量 | 0x21AC | 约30秒间隔的周期测量 |
| 强制校准FRC | 0x362F | 400ppm基准气体下修正读数 |
| 设置自动自校准 | 0x2416 | 开关ASC校准功能 |
| 设置海拔 | 0x2427 | 高海拔环境补偿 |
| 恢复出厂 | 0x3632 | 清除全部校准状态 |
CRC8校验是驱动里最核心的一段。SCD4X使用的多项式是0x31，初始值为0xFF，对每段2字节数据进行校验，生成1字节CRC。实现代码只有十几行：
uint8_t scd4x_crc8(const uint8_t *data, uint8_t len) { uint8_t crc = 0xFF; for (uint8_t i = 0; i < len; i++) { crc ^= data[i]; for (uint8_t bit = 0; bit < 8; bit++) { if (crc & 0x80) { crc = (crc << 1) ^ 0x31; } else { crc = (crc << 1); } } } return crc; }这个函数接收2字节原始数据，返回1字节CRC，和SCD4X返回的校验字节做比较。我写驱动的时候先单独写了个小函数验证CRC算法，用官方文档里的示例数据跑了一遍，然后再接入工程，避免驱动上了线之后分不清是通信问题还是校验问题。
4. 数据读取与标定：拿到CO2读数只是第一步
4.1 数据就绪位判断与测量值转换
SCD4X周期测量模式下，不能上电读完就马上取数，必须等它内部完成一次光声测量。正确的顺序是：先发0x21B1启动周期测量，之后每次读数据前先查0xE4B8的数据就绪状态，如果返回状态字的低11位非零，再发0xEC05读测量值。直接跳过就绪判断去读，大概率会拿到0xFFFF或者上一轮的旧数据。
读取9字节数据的核心代码长这样：
uint8_t scd4x_read_measurement(uint16_t *co2, float *temp, float *rh) { uint8_t buf[9]; // 发送 0xEC05 读取测量值 Soft_I2C_Start(); if (Soft_I2C_WriteByte(0xC4)) { // 0x62 << 1，写 Soft_I2C_Stop(); return 1; } Soft_I2C_WriteByte(0xEC); Soft_I2C_WriteByte(0x05); Soft_I2C_Stop(); delay_ms(2); // 读 9 字节 Soft_I2C_Start(); if (Soft_I2C_WriteByte(0xC5)) { // 0x62 << 1 | 1，读 Soft_I2C_Stop(); return 1; } for (int i = 0; i < 9; i++) { // 最后一字节回NACK，其余回ACK buf[i] = Soft_I2C_ReadByte(i == 8 ? 0 : 1); } Soft_I2C_Stop(); // CRC校验：CO2[0:1] CRC在[2]，温度[3:4] CRC在[5]，湿度[6:7] CRC在[8] if (scd4x_crc8(buf, 2) != buf[2]) return 2; if (scd4x_crc8(buf + 3, 2) != buf[5]) return 3; if (scd4x_crc8(buf + 6, 2) != buf[8]) return 4; *co2 = (buf[0] << 8) | buf[1]; uint16_t t_raw = (buf[3] << 8) | buf[4]; *temp = -45.0f + 175.0f * t_raw / 65535.0f; uint16_t rh_raw = (buf[6] << 8) | buf[7]; *rh = 100.0f * rh_raw / 65535.0f; return 0; }温度转换公式是 -45 + 175 * raw / 65535，湿度转换公式是 100 * raw / 65535，这两个公式必须记好，很多人会把SCD30的转换公式套过来，SCD30的数据顺序是湿度、温度、CO2，而SCD4X是CO2、温度、湿度，直接套用就会拿到完全对不上的数。
4.2 自动自校准ASC与强制校准FRC的使用时机
SCD4X的校准策略直接决定长期读数是否可信。传感器出厂时有一个基准校准，但使用一段时间后，因为老化、污染、环境变化，读数会产生偏移。ASC（自动自校准）功能适合那些设备能定期接触到新鲜空气的场景，比如室内空气质量监测仪放在通风良好的房间里，它会把测到的最低CO2浓度认定为接近外界基线，自动修正传感器漂移。但如果你的设备长期放在密闭空间，比如孵化箱、大棚、地下仓库，千万别开ASC，它会不断把偏高的基线当成参考，越校越偏。
FRC强制校准则适合已知当前环境CO2浓度的情况，具体做法是让设备在目标浓度下稳定运行至少几分钟，然后通过0x362F命令写入预期的CO2浓度值，比如在室外新鲜空气下写入400ppm。执行FRC后传感器内部会完成一次重新校准，返回的2字节结果如果是0xFFFF则说明参数无效或执行失败。我一般在新项目首次部署时做一次FRC，之后正常使用就交给ASC。还要注意海拔对CO2读数的影响，SCD4X内部有海拔补偿参数，住在高原地区的话用0x2427设置一下当地海拔，否则读数会比实际浓度偏大，这个细节很多人不知道。
5. 实测中踩过的坑：从全是FF到数值漂移的完整排查
5.1 现象一：读出来全是0xFF，偶尔还卡死在I2C等待
我第一次上电时，串口打印的CO2一直是65535，也就是两个字节全是0xFF。我的排查链路是这样的：先用万用表量传感器VDD对GND电压，确认3.3V正常；然后检查SCL和SDA有没有接反，这是最容易发生的问题，模块上的丝印可能标注不清，插反了之后I2C完全无法工作；再就是把SCL和SDA都拉到3.3V，确认上拉电阻存在。这些都没问题时，搬出逻辑分析仪抓波形，发现SDA上的地址字节发送后，第九个时钟周期压根没有ACK低电平，说明传感器没有应答——问题在传感器自身或者供电质量。
后来发现原因非常蠢：我的USB转TTL模块和传感器共用一个劣质3.3V LDO，传感器在上电瞬间拉低了电压，导致它没有完成正常的内部初始化。换了独立LDO给传感器供电，并在VDD附近补上10μF电容后，ACK就正常了。如果你也遇到全是0xFF，建议按这条链路走一遍：电压、接线、上拉、ACLK波形，最后再怀疑芯片。I2C函数里务必加超时保护，不然总线被拉死时程序会一直卡在while循环里，整个系统看起来就像死机了。
5.2 现象二：CRC校验错误频发，甚至一帧里三个CRC全错
当传感器有ACK、数据也能读出来，但CRC校验大量失败时，基本上可以断定是通信时序或者信号完整性问题。我第一次把I2C延时调得特别激进，想在400kHz下跑满速度，结果SCL高电平时间太短，传感器端的输入建立时间不够，CRC就开始随机错误。把延时函数里的空循环次数从5调到10之后，问题大幅缓解。
另一个常见诱因是杜邦线太长。SCD4X使用环境如果隔着20厘米以上的飞线，信号边沿会被线缆电容拖慢，干扰一上来CRC就会挂。我在测试台上用10厘米的短杜邦线完全没问题，换到30厘米后就开始偶发CRC错误。还有一个不起眼的原因：调试器ST-Link同时接着SWD，而SWD的时钟线如果离SCL太近，高频干扰会耦合到I2C总线上。实在排查不出来的时候，把所有调试线拔掉，只保留供电和I2C，再测试一轮。
5.3 现象三：CO2数值一直在400左右不动，像没通电一样
这个现象容易让人误以为传感器坏了，其实很可能是读数还没更新，或者读错了寄存器位置。我遇到过一种情况：代码里没有查询数据就绪位，每100毫秒就去读一次0xEC05，结果大部分时间读到的都是同一条旧数据，看起来就是数值“卡死”了。SCD4X在周期测量模式下5秒才更新一次，读得再频繁也不会出新数据。
还有一种情况是把SCD30的寄存器顺序套到SCD4X上，SCD30读出来的第一项是湿度，而SCD4X的第一项是CO2。如果把湿度当成CO2打印，自然看不出数值变化。确认这一点最直接的方法是朝传感器哈一口气，CO2读数应该在几秒内从400多升到1000以上。如果怎么哈气都不动，再去抓I2C波形，看看0xEC05之后传感器是不是真的返回了新数据。
5.4 现象四：CO2数值跳变剧烈，从400直接蹦到900
数值跳动大，首先要排除是不是真的环境变化。SCD4X的分辨率是1ppm，本身不会产生这么大的随机跳动，所以问题大概率出在供电或者风道上。我一个测试中把传感器放在风扇直吹的位置，气流变化导致传感器内部温度场波动，读数就会周期性起伏。解决方法是给传感器加一个防风罩，或者把它放在进风口稳定的位置。
如果供电正常、风道也没问题，可以做一个软件滑动平均，把最近5个有效值做平均再输出，能明显平滑曲线。要注意的是，滑动窗口不要超过10个点，否则5秒一个数据点、窗口50秒，实时性就太差了，做新风联动时会觉得系统反应迟钝。
6. 显示、RTOS与低功耗化：从功能验证到产品化的扩展
6.1 给传感器数据加一块OLED显示和串口调试
读SCD4X的数据最终是要给人看的。我在工程里用0.96寸的I2C OLED做本地显示，SCD4X和OLED挂在同一条I2C总线上，地址分别是0x62和0x3C，互不干扰。需要注意的是，用软件I2C时，读SCD4X和写OLED的操作要串行执行，不要在传感器读数据的半中间去切换总线操作。显示刷新率不用太高，SCD4X本身5秒一个新数据，OLED每2到3秒刷一次就够了，刷新太频繁反而会占I2C带宽，影响传感器通信的稳定性。
串口方面，我一般用UART1的PA9/PA10做调试输出，波特率115200，把原始的CO2、温度、湿度带单位打印出来。调试时建议把裸数据也打出来，比如原始16位CO2值和CRC校验结果，这样一帧数据出问题时能立刻判断是通信层的问题还是转换层的问题。加了OLED之后，Flash占用会多出十几KB，对F103C8T6的64KB Flash来说还在安全范围内，但如果你同时上了FreeRTOS和LVGL，就要开始仔细裁剪字体和图片资源了。
6.2 挂FreeRTOS后传感器任务怎么设计
我后来把工程迁移到了FreeRTOS上，SCD4X读取被单独拆成一个任务。任务里不能简单粗暴地“延时5秒读一次”，因为传感器从启动到数据就绪的间隔不是绝对精确的5秒，正确写法是循环里每100毫秒查询一次0xE4B8就绪位，一旦就绪立即读取。这样既不会漏数据，也不会在传感器还没准备好时发出无效读命令。
任务栈大小给到256个word就足够了，但要注意一个关键点：I2C总线上同时挂着SCD4X和OLED，两个任务如果都去访问总线，必须加一个互斥量。我给I2C总线建了一个二值信号量，任何任务在发起I2C操作前先获取信号量，操作完释放。没有这个保护，OLED刷新和SCD4X读取交叉进行时，偶发的数据错乱和CRC错误就会卷土重来。还有个地方容易被坑：FreeRTOS的vTaskDelay延时和裸机delay_ms混用，所有短延时尽量都走vTaskDelay，长延时用系统节拍，避免阻塞空闲任务导致看门狗或者低功耗逻辑出问题。
6.3 电池供电场景下的低功耗方案
如果你的目标产品要用电池供电，SCD4X的周期测量模式就不太合适了，5秒一个点虽然电流不大，但24小时连续跑还是会造成电量浪费。更适合的做法是使用单次测量模式，发0x219D命令触发一次测量，然后传感器内部完成测量后进入待机，再查询就绪位读取数据。搭配STM32的STOP模式，主控每5分钟醒来一次，触发生成一次测量，读完数据继续睡，整机平均电流可以压得非常低。
低功耗周期模式0x21AC也是一个折中选项，约30秒出一个数据点，适合那些需要保持实时性但又不能太耗电的场景。这里有个工程细节：从STOP模式唤醒后，HAL库的时钟重新初始化需要一点时间，不能立刻就去发I2C命令，先要稳定时钟、重新配置系统时钟源，否则传感器可能收不到正确时序。SCD4X本身还有存储校准参数的持久化命令0x3615，在设置完海拔、温度补偿、校准参数后执行一次，芯片掉电重启也不会丢。
这个项目做完之后，我最大的体会是：SCD4X的驱动代码其实也就几百行，真正的难点在工程细节上——干净的电源、稳定的上拉、合理的风道，这些决定传感器能不能长期可靠地工作。如果你也打算用STM32F103C8T6搭配SCD4X做室内空气质量监测、新风联动或者环境数据采集，完全可以按我这条链路先点亮传感器，再加显示、加系统、做低功耗，一步步往产品形态靠。
本文还有配套的精品资源，点击获取
