TI MSPM0G3507开发板驱动ADS1115 16位ADC模块实战：I2C通信与四通道电压采集

TI MSPM0G3507开发板驱动ADS1115 16位ADC模块实战I2C通信与四通道电压采集最近在做一个需要高精度电压采集的小项目手头正好有TI的MSPM0G3507开发板和一块ADS1115模块。这个ADS1115是个好东西16位精度四通道用I2C通信特别适合空间和功耗都受限的传感器测量场景。但刚开始调的时候对着数据手册和网上零散的代码还是踩了不少坑。今天我就把从硬件连接到代码调试的完整过程手把手地分享出来希望能帮到正在用MSPM0系列或者需要高精度ADC的朋友们。咱们这篇教程的目标很明确让MSPM0G3507通过I2C总线稳稳当当地读取ADS1115四个通道的电压值。我会从ADS1115的基础讲起然后一步步带你配置引脚、编写底层I2C驱动、理解并配置ADS1115的寄存器最后完成数据读取和电压换算。只要你有一点C语言和单片机基础跟着做下来肯定能搞定。1. 认识我们的“高精度尺子”ADS1115在动手接线写代码之前咱们先得搞清楚要驱动的对象是个啥。你可以把ADS1115想象成一把非常精密的“电子尺子”专门用来测量电压。它比单片机自带的ADC模数转换器要厉害得多。它厉害在哪精度高16位分辨率。这是什么概念单片机常见的12位ADC能把一个电压范围分成4096份而16位能分成65536份精细了16倍。测量小电压时优势巨大。通道多内部有一个输入多路复用器可以接4个单端输入对地测量或者2组差分输入测量两个引脚间的电压差。量程可调内置可编程增益放大器PGA量程可以从±256mV到±6.144V之间选择。这意味着无论是测量微弱的传感器信号比如几毫伏还是测量更高的电压它都能保持高精度。接口简单通过I2C总线通信只需要两根线SCL时钟线、SDA数据线就能搞定控制和数据读取节省单片机引脚。功耗低工作电流只有150uA还支持单次转换后自动休眠的模式非常适合电池供电的设备。关键参数一览参数规格工作电压2.0V - 5.5V (兼容3.3V和5V系统)工作电流150 µA (典型值)分辨率16 位输入通道4 路单端 或 2 路差分通信接口I2C封装10引脚 (我们用的模块是2.54mm排针引出)最大采样率860 SPS (每秒采样次数)对于我们这次实战计划用它的单端输入模式来测量四个通道A0, A1, A2, A3对地的电压量程设置为±4.096V采用连续转换模式采样率用128 SPS。这个配置在精度和速度上是个不错的平衡适合大多数数据采集场景。2. 硬件连接给开发板和模块“牵线搭桥”接线是第一步千万不能错。我们用的是TI MSPM0G3507开发板ADS1115模块通常是一个小板子上面有排针。连接关系如下表所示ADS1115模块引脚MSPM0G3507开发板引脚说明VDD5V0 或 3V3电源。模块工作电压范围是2.0-5.5V接3.3V或5V都可以。我接的5V。GNDGND电源地。必须共地SCLPA1I2C时钟线。SDAPA0I2C数据线。A0, A1, A2, A3待测电压信号模拟输入通道。将你要测量的电压信号线接到这里。另一端和模块共地。ADDRGND地址选择引脚。接GND时器件I2C地址是0x487位地址。这个很重要注意I2C总线需要上拉电阻。幸运的是MSPM0G3507开发板上的I2C引脚通常已经内置了上拉电阻或者我们的ADS1115模块上也自带。如果你的模块没有需要在SDA和SCL线上各接一个4.7kΩ - 10kΩ的电阻到VCC。接好线硬件部分就准备好了。接下来我们要在软件里告诉单片机PA0和PA1这两个引脚是用来做I2C通信的。3. 软件配置让单片机认识I2C引脚我们使用TI的SysConfig图形化工具来配置引脚这比直接写寄存器代码要直观得多。打开工程在你的CCSCode Composer Studio工程中找到并双击empty.syscfg文件。添加GPIO配置在SysConfig界面中找到“GPIO”部分添加两个GPIO配置。配置引脚功能将PA0配置为GPIO Output (Open Drain)模式并给它起个易懂的名字比如ADS1115_SDA。开漏模式是I2C通信的标准要求。将PA1同样配置为GPIO Output (Open Drain)模式命名为ADS1115_SCL。保存并生成代码按下Ctrl S保存配置。然后点击编译按钮或等待自动生成。这里可能会弹出一些警告暂时不用管它。包含头文件配置完成后SysConfig会自动在ti_msp_dl_config.h文件中生成对应的引脚宏定义。而这个文件通常已经被包含在board.h里了。所以在我们的代码里只需要#include board.h就可以使用ADS1115_SDA_PIN、ADS1115_SCL_PIN这样的宏了非常方便。4. 代码实战一编写底层I2C“交通规则”ADS1115通过I2C协议通信我们可以用单片机的GPIO引脚来模拟I2C的时序。虽然MSPM0有硬件I2C外设但用GPIO模拟软件I2C更灵活便于理解协议本质移植到其他平台也容易。我们在工程里新建一个BSP(Board Support Package) 文件夹在里面创建bsp_ads1115.c和bsp_ads1115.h两个文件用来放我们的ADS1115驱动代码。首先来看头文件bsp_ads1115.h它定义了我们需要的宏和函数接口#ifndef _BSP_ADS1115_H_ #define _BSP_ADS1115_H_ #include board.h // 引脚操作宏定义让代码更清晰 // 将SDA引脚设置为输入模式读取数据时用 #define SDA_IN() { DL_GPIO_initDigitalInput(ADS1115_SDA_IOMUX); } // 将SDA引脚设置为输出模式发送数据时用 #define SDA_OUT() { DL_GPIO_initDigitalOutput(ADS1115_SDA_IOMUX); \ DL_GPIO_enableOutput(ADS1115_PORT, ADS1115_SDA_PIN); } // 控制SCL引脚输出高/低电平 #define SCL(BIT) ( BIT ? DL_GPIO_setPins(ADS1115_PORT,ADS1115_SCL_PIN) : DL_GPIO_clearPins(ADS1115_PORT,ADS1115_SCL_PIN) ) // 控制SDA引脚输出高/低电平 #define SDA(BIT) ( BIT ? DL_GPIO_setPins(ADS1115_PORT,ADS1115_SDA_PIN) : DL_GPIO_clearPins(ADS1115_PORT,ADS1115_SDA_PIN) ) // 读取SDA引脚的电平状态 #define GETSDA() ( ( DL_GPIO_readPins( ADS1115_PORT, ADS1115_SDA_PIN ) ADS1115_SDA_PIN ) ? 1 : 0 ) // 函数声明 void ADS1115_Init(void); uint8_t WriteADS1115(uint8_t reg_addr, uint8_t dat_H, uint8_t dat_L); float ReadADS1115(uint8_t reg_addr); #endif接下来是重头戏bsp_ads1115.c。I2C通信就像一套严格的“交通规则”有开始、停止、应答等信号。我们先把这些基本动作实现出来。#include bsp_ads1115.h #include stdio.h // 用于调试打印 // 微秒级延时函数需要根据你的系统时钟实现这里是个示例 void delay_us(uint32_t us) { // 具体实现依赖于你的系统时钟例如用DL_Timer的延时函数 // 这里假设有一个__delay_cycles()函数或类似功能 for(uint32_t i0; ius*10; i); // 粗略实现需校准 } void delay_ms(uint32_t ms) { for(uint32_t i0; ims; i) delay_us(1000); } /* I2C起始信号SCL高电平时SDA产生一个下降沿 */ void IIC_Start(void) { SDA_OUT(); SDA(1); delay_us(5); SCL(1); delay_us(5); SDA(0); // 下降沿 delay_us(5); SCL(0); // 钳住总线准备发送数据 delay_us(5); } /* I2C停止信号SCL高电平时SDA产生一个上升沿 */ void IIC_Stop(void) { SDA_OUT(); SCL(0); SDA(0); delay_us(5); SCL(1); delay_us(5); SDA(1); // 上升沿 delay_us(5); } /* 主机发送应答(ACK)或非应答(NACK)信号 */ void IIC_Send_Ack(uint8_t ack) { SDA_OUT(); SCL(0); SDA(0); // 先拉低准备发送ACK delay_us(5); if(!ack) SDA(0); // 发送ACK (0) else SDA(1); // 发送NACK (1) SCL(1); delay_us(5); SCL(0); SDA(1); // 释放SDA线 } /* 主机等待从机(ADS1115)的应答信号超时则返回1 */ uint8_t IIC_Wait_Ack(void) { uint8_t ack_flag 10; // 超时计数 SDA_IN(); // SDA设为输入准备读取 SDA(1); // 释放总线由上拉电阻拉高 delay_us(5); SCL(1); delay_us(5); // 等待SDA被从机拉低ACK信号 while( (GETSDA() 1) (ack_flag) ) { ack_flag--; delay_us(5); } if(ack_flag 0) { // 超时无应答 IIC_Stop(); return 1; } else { SCL(0); SDA_OUT(); // 切换回输出模式为后续操作做准备 return 0; // 收到应答 } } /* I2C写入一个字节数据 */ void IIC_Write(uint8_t dat) { uint8_t i; SDA_OUT(); SCL(0); // 拉低时钟开始数据位传输 for(i0; i8; i) { // 先放数据高位在前 SDA( (dat 0x80) 7 ); dat 1; delay_us(2); // 再产生一个时钟脉冲 SCL(1); delay_us(4); SCL(0); delay_us(4); } } /* I2C读取一个字节数据 */ uint8_t IIC_Read(void) { uint8_t i, receive 0; SDA_IN(); // 设置为输入读取从机数据 for(i0; i8; i) { SCL(0); delay_us(5); SCL(1); // 从机在SCL高电平期间放置数据 delay_us(5); receive 1; // 左移为下一位腾出空间 if(GETSDA()) { receive | 1; // 读到‘1’ } delay_us(5); } return receive; }这些函数就是I2C通信的“原子操作”。有了它们我们就能组合出完整的读写序列。5. 代码实战二理解并配置ADS1115寄存器要指挥ADS1115工作我们必须通过I2C读写它的内部寄存器。ADS1115主要有两个我们关心的寄存器转换寄存器 (0x00)存放最新转换完成的16位ADC结果。配置寄存器 (0x01)用来设置ADS1115的工作模式、通道、量程、采样率等。配置寄存器有16位每一位都有特定含义。根据我们的目标A0单端输入±4.096V量程连续转换128SPS需要这样配置位域名称值二进制说明15OS1单次转换启动位在单次模式下。我们写1启动转换在连续模式下此位写0但手册建议写1。实际操作中我们按原文配置为1。14-12MUX100 (0x4)输入多路选择。100对应A0单端输入AINPA0, AINNGND。要测其他通道改这里即可。11-9PGA001 (0x1)可编程增益放大器设置满量程范围(FSR)。001对应±4.096V。8MODE0工作模式。0为连续转换模式1为单次转换模式。7-5DR100 (0x4)数据速率。100对应128 SPS每秒采样数。4-0其他00011 (0x03)比较器相关设置我们不用比较器功能按原文配置为0x03禁用比较器ALERT/RDY引脚高阻。把上述二进制组合起来1100 0010 1000 0011转换成十六进制就是0xC283。这个值就是我们要写入配置寄存器的内容。现在我们来编写读写ADS1115寄存器的核心函数/* 向ADS1115指定寄存器写入数据 */ uint8_t WriteADS1115(uint8_t reg_addr, uint8_t dat_H, uint8_t dat_L) { IIC_Start(); // 1. 发送起始信号 IIC_Write(0x90); // 2. 发送器件地址写位 (0x48 1) | 0 0x90 if(IIC_Wait_Ack() 1) { // 3. 等待应答 printf(Error: No ACK after device address write.\r\n); return 1; } IIC_Write(reg_addr); // 4. 发送要写的寄存器地址 if(IIC_Wait_Ack() 1) { // 5. 等待应答 printf(Error: No ACK after register address write.\r\n); return 2; } IIC_Write(dat_H); // 6. 发送数据高字节 IIC_Wait_Ack(); // 7. 等待应答这里简化处理不严格检查 IIC_Write(dat_L); // 8. 发送数据低字节 IIC_Wait_Ack(); // 9. 等待应答 IIC_Stop(); // 10. 发送停止信号 return 0; // 写入成功 } /* 从ADS1115指定寄存器读取数据并换算为电压值(V) */ float ReadADS1115(uint8_t reg_addr) { uint8_t i 0; uint8_t dat[2] {0}; uint16_t adc_value 0; float voltage 0; // 第一部分发送“伪写”操作告诉ADS1115我们要读哪个寄存器 IIC_Start(); IIC_Write(0x90); // 器件地址 写 if(IIC_Wait_Ack() 1) return -1.0f; // 失败 IIC_Write(reg_addr); // 指定要读的寄存器地址这里是0x00转换寄存器 if(IIC_Wait_Ack() 1) return -1.0f; // 第二部分重新发起起始信号开始读操作 do { i; if(i 20) return -1.0f; // 超时判断 delay_ms(1); IIC_Start(); // 重新发送起始信号 IIC_Write(0x91); // 器件地址 读 (0x48 1) | 1 0x91 } while(IIC_Wait_Ack() 1); // 等待从机应答可能数据未就绪 // 第三部分读取两个字节数据 dat[0] IIC_Read(); // 读取高8位 IIC_Send_Ack(0); // 主机发送ACK要求继续读 dat[1] IIC_Read(); // 读取低8位 IIC_Send_Ack(1); // 主机发送NACK表示读取结束 IIC_Stop(); // 发送停止信号 // 第四部分数据整合与电压换算 adc_value ((uint16_t)dat[0] 8) | dat[1]; // 合并成16位数据 /* 电压换算说明 * ADS1115输出的是16位有符号整数二进制补码。 * 我们设置PGA为±4.096V这意味着 * 正满量程 (4.096V) 对应 0x7FFF (32767) * 零输入 (0V) 对应 0x0000 * 负满量程 (-4.096V) 对应 0x8000 (-32768) * 分辨率 量程 / (2^15) 4.096V / 32768 0.000125 V/LSB */ const float LSB_SIZE 0.000125f; // 每个数字量代表的电压 // 方法一直接乘分辨率适用于单端输入结果始终为正 // 对于单端输入AINNGND测量结果总是正数直接转换即可。 voltage (float)adc_value * LSB_SIZE; // 方法二处理有符号数适用于差分输入可测负电压 // int16_t signed_value (int16_t)adc_value; // voltage (float)signed_value * LSB_SIZE; return voltage; } /* ADS1115初始化函数写入配置字 */ void ADS1115_Init(void) { // 向配置寄存器(0x01)写入0xC283配置为A0单端±4.096V连续转换128SPS WriteADS1115(0x01, 0xC2, 0x83); // 可以加个短暂延时等待配置生效 delay_ms(10); }6. 上机测试与结果验证最后我们在主函数里调用这些驱动读取A0通道的电压并打印出来。#include ti_msp_dl_config.h #include board.h #include bsp_ads1115.h #include stdio.h // 如果lc_printf是基于stdio的 int main(void) { SYSCFG_DL_init(); // 初始化系统时钟、外设等 ADS1115_Init(); // 初始化ADS1115 // 初始化串口用于打印假设lc_printf已配置好 lc_printf(ADS1115 Demo Start...\r\n); while(1) { float voltage_A0 ReadADS1115(0x00); // 读取转换寄存器的值并换算为电压 if(voltage_A0 0) { // 读取成功 lc_printf(A0 Voltage %.3f V\r\n, voltage_A0); // 打印3位小数 } else { lc_printf(Read ADS1115 Failed!\r\n); } delay_ms(500); // 每500ms读取一次 } }将代码编译下载到MSPM0G3507开发板打开串口调试助手波特率要和你的lc_printf设置一致。给ADS1115的A0引脚接一个可调的电压比如用开发板的3.3V或通过电位器分压你应该能看到串口稳定输出当前的电压值精度可以达到毫伏级别。如果想测量其他通道比如A1只需要修改初始化配置寄存器中的MUX字段。将0xC283中的MUX部分从100(A0) 改为101(A1)即高字节从0xC2变为0xD2。所以初始化时调用WriteADS1115(0x01, 0xD2, 0x83);即可。在实际项目中你可以写一个函数来动态切换通道。常见问题排查读回来全是0或固定值检查I2C地址是否正确ADDR引脚是否接地检查SDA/SCL线是否接反用逻辑分析仪抓一下I2C时序最直观。电压值不准检查PGA量程设置是否匹配你测量的电压。如果测量3.3V系统电压用±4.096V量程是合适的。确保电源和参考地稳定。通信时好时坏检查I2C总线的上拉电阻通常4.7kΩ在3.3V系统比较合适。适当调整delay_us的延时时间I2C通信对时序有一定要求。好了到这里你已经成功用MSPM0G3507驱动了高精度的ADS1115 ADC模块。这套软件I2C的驱动代码结构清晰稍作修改就能用在其他单片机平台上。希望这篇详细的实战笔记能让你在项目中使用ADS1115时更加得心应手。