基于TI MSPM0的AGS10 MEMS TVOC传感器I2C驱动移植与室内空气质量监测实战最近在做一个室内环境监测的小项目需要检测空气中的TVOC总挥发性有机物浓度正好用上了TI的MSPM0开发板和AGS10传感器。AGS10这个传感器体积小、功耗低用I2C接口通信非常适合嵌入式项目。但在移植驱动时我发现网上资料比较零散自己摸索着把整个过程走通了今天就把从硬件连接到软件驱动再到数据读取的完整过程分享给大家手把手教你搞定这个传感器。1. 认识一下我们的主角AGS10 TVOC传感器在动手写代码之前咱们先花几分钟了解一下AGS10传感器。这就像你要和一个新朋友合作总得先知道他的脾气秉性吧。AGS10是一款基于MEMS微机电系统技术的数字输出型TVOC传感器。说人话就是它内部有个微小的“鼻子”传感元件能“闻”到空气中多种有害的有机气体比如甲醛、苯、酒精等并把“闻”到的浓度直接转换成数字信号通过I2C接口告诉我们。它有几个很讨喜的特点驱动简单只需要I2C两根线SDA, SCL就能通信大大节省MCU的引脚资源。功耗低典型功耗只有75mW对于电池供电的设备很友好。数字输出内部已经完成了模拟信号到数字信号的转换我们拿到手的就是纯净的数字值省去了外部ADC和复杂的信号调理电路。这里有一份它的核心“身份证”信息咱们开发时得记着参数项规格说明工作电压3.0V - 6.0V (和咱们的MSPM0开发板3.3V完美匹配)通信接口I2C从机模式速率 ≤ 15kHz测量范围0 ~ 99999 ppb (十亿分之一浓度单位)输出单位ppb采样周期≥ 2秒 (读取数据不要太频繁)预热时间≥ 120秒 (上电后需要等它稳定)工作温度0℃ ~ 50℃注意传感器上电后需要至少120秒的预热时间才能输出稳定准确的数据。刚上电就读数的话数值可能不准或者通信失败这个坑我一开始就踩过。2. 硬件连接与引脚配置硬件连接非常简单但有两个细节必须注意否则通信肯定失败。2.1 电路连接你需要准备一块TI MSPM0开发板比如立创的TI电赛开发板、一个AGS10传感器模块以及两根杜邦线。连接方式如下VCC 连接开发板的3.3V电源引脚。GND 连接开发板的GND引脚。SDA 连接开发板的任意一个GPIO引脚我们后续配置为I2C数据线。SCL 连接开发板的另一个GPIO引脚我们后续配置为I2C时钟线。关键提示 I2C总线是开漏输出这意味着SDA和SCL这两根线必须通过上拉电阻拉到高电平VCC才能正常工作。幸运的是大部分开发板包括立创的这款的I2C接口附近已经内置了上拉电阻通常是4.7kΩ或10kΩ。如果你的开发板没有或者你用的是自己画的板子记得在SDA和SCL线上各接一个4.7kΩ的电阻到3.3V。2.2 在SysConfig中配置GPIO引脚我们使用TI推荐的图形化配置工具SysConfig来初始化引脚这比直接写寄存器代码直观多了。这里我们以软件模拟I2C为例方便理解时序且不依赖特定硬件I2C外设。打开工程在你的CCS或IAR工程中找到empty.syscfg文件双击打开。添加GPIO配置在打开的界面中点击Tools-SYSCONFIG启动配置工具。配置SDA引脚点击ADD选择GPIO。假设我们选择PA6作为SDA引脚。在右侧属性栏将Direction设置为Output初始化为输出后续代码中会动态切换输入/输出。给这个配置起个易懂的名字比如GPIO_SDA。配置SCL引脚再次点击ADD添加另一个GPIO。选择PA7作为SCL引脚。将Direction设置为OutputSCL始终由主机控制输出。命名为GPIO_SCL。保存并生成代码点击保存按钮。这时可能会弹出一个关于生成代码的警告框一定要选择Yes to All。编译保存后点击编译。可能会有些警告暂时不用管。编译成功后SysConfig会自动根据你的图形化配置在ti_msp_dl_config.h文件中生成对应的引脚宏定义。这个文件通常已经被包含在board.h里了所以我们后续在代码里直接#include board.h就能使用这些宏。完成这步后GPIO_SDA_PIN、GPIO_SCL_PIN这些宏就对应了你刚才选择的物理引脚后面的驱动代码会用到它们。3. 手把手编写I2C模拟驱动与传感器驱动由于AGS10的I2C速率要求不高≤15kHz我们用GPIO模拟I2C时序完全可行而且移植性更好。我们把驱动代码分成两个文件bsp_ags10.c和bsp_ags10.h。3.1 头文件宏定义 (bsp_ags10.h)头文件主要完成引脚操作宏的定义让我们的C代码更简洁。#ifndef _BSP_AGS10_H_ #define _BSP_AGS10_H_ #include board.h // 包含SysConfig生成的引脚定义 // 将SDA引脚设置为输出模式 #define AGS10_SDA_OUT() {\ DL_GPIO_initDigitalOutput(GPIO_SDA_IOMUX);\ DL_GPIO_setPins(GPIO_PORT, GPIO_SDA_PIN);\ DL_GPIO_enableOutput(GPIO_PORT, GPIO_SDA_PIN);\ } // 将SDA引脚设置为输入模式用于读取从机应答和数据 #define AGS10_SDA_IN() { DL_GPIO_initDigitalInput(GPIO_SDA_IOMUX); } // 读取SDA引脚的电平状态 #define AGS10_GETSDA() ( ( ( DL_GPIO_readPins(GPIO_PORT,GPIO_SDA_PIN) GPIO_SDA_PIN ) 0 ) ? 1 : 0 ) // 控制SDA和SCL引脚输出高电平(1)或低电平(0) #define AGS10_SDA(x) ( (x) ? (DL_GPIO_setPins(GPIO_PORT,GPIO_SDA_PIN)) : (DL_GPIO_clearPins(GPIO_PORT,GPIO_SDA_PIN)) ) #define AGS10_SCL(x) ( (x) ? (DL_GPIO_setPins(GPIO_PORT,GPIO_SCL_PIN)) : (DL_GPIO_clearPins(GPIO_PORT,GPIO_SCL_PIN)) ) // 函数声明 uint32_t ags10_read(void); #endif3.2 核心驱动实现 (bsp_ags10.c)这个文件包含了所有I2C底层时序函数和读取TVOC数据的应用函数。咱们一段段来看。首先是I2C的起始和停止信号。这是I2C通信的“开场白”和“结束语”。//起始信号在SCL高电平期间SDA产生一个下降沿 void AGS10_IIC_Start(void) { AGS10_SDA_OUT(); // 确保SDA为输出模式 AGS10_SDA(1); AGS10_SCL(1); delay_1us(5); // 保持一段时间确保信号稳定 AGS10_SDA(0); // 在SCL高时拉低SDA产生起始条件 delay_1us(5); AGS10_SCL(0); // 拉低SCL为后续传输数据位做准备 delay_1us(5); } //停止信号在SCL高电平期间SDA产生一个上升沿 void AGS10_IIC_Stop(void) { AGS10_SDA_OUT(); AGS10_SCL(0); AGS10_SDA(0); AGS10_SCL(1); delay_1us(5); AGS10_SDA(1); // 在SCL高时拉高SDA产生停止条件 delay_1us(5); }接着是发送一个字节和接收一个字节的函数。I2C数据在SCL高电平期间必须保持稳定变化只能在SCL低电平期间发生。//发送一个字节8位数据 void AGS10_IIC_Send_Byte(uint8_t dat) { int i 0; AGS10_SDA_OUT(); AGS10_SCL(0); // 起始时确保SCL为低 for(i 0; i 8; i) { // 取出最高位(bit7)发送 AGS10_SDA( (dat 0x80) 7 ); delay_1us(1); // 数据建立时间 AGS10_SCL(1); // 拉高SCL从机在此时采样SDA delay_1us(5); // 保持高电平 AGS10_SCL(0); // 拉低SCL准备发送下一位 delay_1us(5); dat 1; // 左移准备发送下一位 } } //接收一个字节 unsigned char AGS10_IIC_Read_Byte(void) { unsigned char i, receive 0; AGS10_SDA_IN(); // 重要接收数据前将SDA设置为输入模式 for(i 0; i 8; i) { AGS10_SCL(0); delay_1us(5); AGS10_SCL(1); // 拉高SCL主机在此时读取SDA delay_1us(5); receive 1; // 左移为下一位腾出空间 if( AGS10_GETSDA() ) // 读取SDA引脚电平 { receive | 1; // 如果为高则对应位置1 } } AGS10_SCL(0); // 读完8位后拉低SCL return receive; }然后是应答机制。I2C每传输完一个字节接收方都需要发送一个应答信号。//主机发送应答信号(ACK) void AGS10_IIC_Send_Ack(void) { AGS10_SDA_OUT(); AGS10_SCL(0); AGS10_SDA(0); // 拉低SDA表示应答 AGS10_SCL(1); delay_1us(5); AGS10_SCL(0); AGS10_SDA(1); // 释放SDA线 } //主机发送非应答信号(NACK)通常用于读取最后一个字节后 void AGS10_IIC_Send_Nack(void) { AGS10_SDA_OUT(); AGS10_SCL(0); AGS10_SDA(1); // 拉高SDA表示非应答 AGS10_SCL(1); delay_1us(5); AGS10_SCL(0); AGS10_SDA(0); } //主机等待从机传感器的应答 unsigned char AGS10_I2C_WaitAck(void) { char ack 0; unsigned char ack_flag 10; // 超时计数 AGS10_SCL(0); AGS10_SDA(1); // 主机先释放SDA线 AGS10_SDA_IN(); // 将SDA设置为输入等待从机拉低 delay_1us(5); AGS10_SCL(1); // 拉高SCL从机应在此时拉低SDA delay_1us(5); // 循环检测SDA是否被拉低并加入超时机制 while( (AGS10_GETSDA() 1) ( ack_flag ) ) { ack_flag--; delay_1us(5); } if( ack_flag 0 ) // 超时未收到应答 { AGS10_IIC_Stop(); // 发生错误发送停止信号 return 1; // 返回1表示非应答/失败 } else // 收到应答 { AGS10_SCL(0); AGS10_SDA_OUT(); // 重新将SDA控制权拿回来 } return ack; // 返回0表示成功应答 }最后是最关键的数据读取函数ags10_read。这里包含了与AGS10通信的具体协议。根据AGS10的数据手册读取TVOC浓度的流程是主机向传感器写命令地址0x34 寄存器地址0x00启动一次测量。等待传感器准备数据需要一点时间。主机从传感器读取数据地址0x35共5个字节。对前4个字节进行CRC8校验与第5个字节CRC值比对。//CRC8校验函数多项式为0x31初始值为0xFF uint8_t Calc_CRC8(uint8_t *dat, uint8_t Num) { uint8_t i, byte, crc 0xFF; for(byte 0; byte Num; byte) { crc ^ (dat[byte]); for(i 0; i 8; i) { if(crc 0x80) crc (crc 1) ^ 0x31; else crc (crc 1); } } return crc; } //读取TVOC浓度的主函数 uint32_t ags10_read(void) { uint8_t timeout 0; uint8_t data[5] {0}; // 存储读取的5个字节 uint32_t TVOC_data 0; // 步骤1发送启动测量命令 AGS10_IIC_Start(); AGS10_IIC_Send_Byte(0X34); // 写地址 (0x1A 1) | 0 0x34 if(AGS10_I2C_WaitAck() 1) return 1; // 通信失败 AGS10_IIC_Send_Byte(0X00); // 寄存器地址 if(AGS10_I2C_WaitAck() 1) return 2; // 发送失败 AGS10_IIC_Stop(); // 步骤2等待传感器数据准备就绪 do{ delay_1ms(1); // 延时1ms再尝试 timeout; AGS10_IIC_Start(); AGS10_IIC_Send_Byte(0X35); // 读地址 (0x1A 1) | 1 0x35 } while((AGS10_I2C_WaitAck() 1) (timeout 50)); // 最多尝试50ms if(timeout 50) return 3; // 等待超时 // 步骤3连续读取5个字节数据 data[0] AGS10_IIC_Read_Byte(); // 状态字节 AGS10_IIC_Send_Ack(); // 发送ACK继续读 data[1] AGS10_IIC_Read_Byte(); // TVOC数据高字节 AGS10_IIC_Send_Ack(); data[2] AGS10_IIC_Read_Byte(); // TVOC数据中字节 AGS10_IIC_Send_Ack(); data[3] AGS10_IIC_Read_Byte(); // TVOC数据低字节 AGS10_IIC_Send_Ack(); data[4] AGS10_IIC_Read_Byte(); // CRC校验字节 AGS10_IIC_Send_Nack(); // 最后一个字节发送NACK AGS10_IIC_Stop(); // 步骤4CRC校验 if(Calc_CRC8(data, 4) ! data[4]) // 校验前4个字节 { return 4; // 校验失败 } // 步骤5组合有效数据位数据手册规定TVOC值在data[1], data[2], data[3]中 TVOC_data (data[1] 16) | (data[2] 8) | data[3]; return TVOC_data; // 返回TVOC浓度单位是ppb }4. 在工程中调用与测试驱动写好了最后就是在主函数里调用它并把数据打印出来看看。在你的主文件例如main.c或empty.c中加入以下代码#include board.h #include stdio.h #include bsp_ags10.h int main(void) { // 开发板初始化时钟、串口等 board_init(); // 初始化串口用于打印数据假设board_init已包含 printf(AGS10 TVOC Sensor Test Start\r\n); // 重要上电后等待传感器预热 delay_1ms(120000); // 延迟至少120秒 printf(Sensor Warm-up Complete.\r\n); while(1) { uint32_t tvoc_value ags10_read(); // 根据返回值判断读取状态 if(tvoc_value 99999) // 返回值在有效范围内 { printf(TVOC Concentration %ld ppb\r\n, tvoc_value); } else // 返回值大于99999说明是错误码 { switch(tvoc_value) { case 1: printf(Error: I2C Communication Failed.\r\n); break; case 2: printf(Error: Command Send Failed.\r\n); break; case 3: printf(Error: Sensor Response Timeout.\r\n); break; case 4: printf(Error: CRC Check Failed.\r\n); break; default: printf(Error: Unknown.\r\n); break; } } // 每次读取间隔至少2秒 delay_1ms(2000); } }将代码编译下载到MSPM0开发板打开串口调试助手波特率根据你的board_init配置通常是115200你就能看到每隔2秒输出的TVOC浓度值了。对着传感器哈口气或者喷一点酒精在附近注意安全应该能看到数值的明显变化。整个移植过程的核心就是理解I2C时序和AGS10的通信协议。代码里我加了不少注释和错误处理在实际项目中非常有用能帮你快速定位是接线问题、电源问题还是传感器本身的问题。希望这篇教程能帮你顺利把AGS10用起来。