基于TI MSPM0G3507的TCRT5000红外循迹传感器移植与调试实战

基于TI MSPM0G3507的TCRT5000红外循迹传感器移植与调试实战最近在准备电赛很多同学问我怎么把网上买的通用传感器模块比如TCRT5000红外循迹模块快速用在自己的TI MSPM0G3507开发板上。网上的资料要么是针对Arduino的要么是STM32的直接拿来用在TI的MSPM0系列上总是不对劲。今天我就以手头这块TI电赛开发板MSPM0G3507为例带你走一遍完整的移植流程。从看懂模块原理、硬件接线到用SysConfig图形化工具配置引脚最后手写驱动代码读取模拟和数字两种信号。跟着做一遍你就能掌握把任何通用传感器“驯服”在自己板子上的通用方法。1. 认识你的传感器TCRT5000模块在动手写代码之前咱们得先搞清楚手里这个“小黑块”是怎么工作的。TCRT5000红外循迹模块可以说是智能小车、寻线机器人的“眼睛”。1.1 它到底是怎么“看见”黑线的模块的核心是一个叫TCRT5000的器件它把红外发射管和接收管做在了一起。你可以把它想象成一个微型的手电筒发射管和一个光敏眼睛接收管它们紧紧挨着。它的工作原理很简单发射红外发射管一直向外发射肉眼看不见的红外光。反射与接收如果传感器下方是白色表面比如白纸红外光会被强烈反射回来被旁边的接收管“看到”接收管就会导通。如果下方是黑色表面比如黑胶带红外光大部分被吸收反射回来的光很弱接收管就处于关闭状态。输出信号模块通过检测接收管的导通状态来告诉你下面是黑还是白。1.2 模块的“两张嘴”AO和DO这是理解本教程的关键。这个模块提供了两种方式告诉你检测结果对应两个输出引脚引脚名称信号类型工作原理特点与用途AO (模拟输出)模拟电压直接输出接收管检测到的反射光强度对应的电压值。反射越强电压越高。连续变化可以判断灰度比如区分浅灰和深灰需要MCU的ADC引脚来读取。DO (数字输出)数字电平模块内部有一个LM393电压比较器。它把AO的电压和一个可调的阈值电压比较高于阈值输出高电平低于阈值输出低电平。非0即1直接告诉你“是黑”还是“不是黑”。可以通过模块上的电位器调节灵敏度接MCU的普通GPIO即可。简单说AO给你的是“原始数据”有多白DO给你的是“判决结果”是黑吗。在寻线小车中通常用DO就足够了简单可靠。但如果你想做更复杂的判断比如识别不同灰度或者想动态调整阈值就需要读取AO值。模块关键参数根据资料工作电压3.3V - 5V 我们的MSPM0G3507开发板提供3.3V正好匹配检测距离1mm - 25mm 调试时注意传感器离地面的高度引脚4个VCC, GND, DO, AO2. 硬件连接把模块“插”到开发板上硬件连接是第一步千万不能错。我们使用的是TI的MSPM0G3507开发板。供电找到开发板上的3.3V和GND引脚分别用杜邦线连接到传感器模块的VCC和GND。注意一定要确保共地即开发板的GND和模块的GND连接在一起这是所有电路正常工作的基础。信号线连接DO引脚模块的DO输出是数字信号可以连接到开发板任意一个支持输入的GPIO引脚。比如我们选择PA26。AO引脚模块的AO输出是模拟信号必须连接到开发板上具有ADC模数转换功能的引脚。根据原文资料我们选择PA27因为它具有ADC的附属功能。连接好后你的接线应该是这样的模块.VCC - 开发板.3.3V模块.GND - 开发板.GND模块.DO - 开发板.PA26 (或其他你喜欢的GPIO)模块.AO - 开发板.PA27 (必须是有ADC功能的引脚)3. 软件配置使用SysConfig图形化工具TI为MSPM0系列提供了非常方便的图形化配置工具SysConfig它集成在Code Composer Studio (CCS)或IAR等IDE中。我们用它可以可视化地配置引脚功能生成底层代码避免手动查手册、写寄存器容易出的错。操作步骤跟着做就行在你的CCS工程中找到并双击empty.syscfg文件或其他你工程中的.syscfg文件它会打开SysConfig配置界面。在界面左侧的“Software”或“Peripherals”栏中找到并点击ADD按钮来添加外设配置。添加ADC配置在添加列表中找到ADC12并添加它MSPM0G3507的ADC模块是ADC12。在ADC12的配置页面中我们需要配置一个通道来读取AO引脚。选择Channel 0在“Input Selection”里选择PA27作为这个ADC通道的输入引脚。这样就把PA27配置为ADC功能了。其他ADC参数如采样周期、参考电压可以先保持默认后续需要优化性能时再调整。添加GPIO配置同样用ADD按钮添加GPIO配置。找到我们连接DO引脚的PA26将其功能设置为GPIO InputGPIO输入模式。因为DO是模块的输出我们的MCU只需要读取它。保存并生成代码点击保存按钮。这里有一个非常重要的坑点保存时如果弹出对话框询问是否生成代码一定要选择Yes to All保存后点击编译整个工程。此时可能会因为一些依赖关系报一些警告但通常不影响可以暂时不管正如原文提示。完成以上步骤后SysConfig会自动在工程里生成一个ti_msp_dl_config.h文件。这个文件里已经定义好了我们刚才配置的ADC12_0_INSTADC实例、GPIO_PORT和GPIO_DO_PIN等宏。我们的工程已经通过board.h包含了这个配置头文件所以后续编程直接#include board.h就能使用这些定义非常省事。4. 驱动代码编写让MCU读懂传感器配置好硬件抽象层接下来就是编写应用层的驱动代码了。我们需要创建两个文件bsp_IRtracking.c和bsp_IRtracking.h“bsp”意为板级支持包。4.1 头文件定义 (bsp_IRtracking.h)头文件主要进行宏定义和函数声明。#ifndef _BSP_IRTRACKING_H_ #define _BSP_IRTRACKING_H_ #include board.h // 包含SysConfig生成的配置 // 读取DO引脚状态的宏读取GPIO端口引脚并进行位判断 #define IR_DO ( ( DL_GPIO_readPins( GPIO_PORT, GPIO_DO_PIN ) GPIO_DO_PIN ) ? 1 : 0 ) // ADC采样次数多次采样取平均可以滤除噪声 #define SAMPLES 30 // 函数声明 void IRtracking_Init(void); // 初始化函数 unsigned int Get_ADC_Value(void); // 读取AO模拟值 unsigned char Get_DO_Num(void); // 读取DO数字状态 #endif这里的关键是IR_DO宏它使用TI驱动库DL的函数DL_GPIO_readPins来读取指定引脚的电平并转换为1或0。4.2 初始化与ADC读取 (bsp_IRtracking.c)这是驱动的核心我们分函数来看。首先全局变量和初始化#include bsp_IRtracking.h #include stdio.h volatile bool gCheckADC; // ADC转换完成标志位用volatile防止编译器优化 void IRtracking_Init(void) { SYSCFG_DL_init(); // 初始化SysConfig配置的外设ADC、GPIO等 // 开启ADC的中断这样ADC转换完成后会触发中断通知我们 NVIC_EnableIRQ(ADC12_0_INST_INT_IRQN); }初始化函数很简单就是启动配置和使能ADC中断。ADC转换需要时间我们用中断方式等待这样CPU在转换期间可以去做别的事情。其次ADC单次读取函数 这是最需要理解的底层操作。uint32_t ADC_GET(void) { unsigned int gAdcResult 0; int timeout 20; // 超时计数器防止ADC卡死 // 1. 软件触发ADC开始一次转换 DL_ADC12_startConversion(ADC12_0_INST); // 2. 等待转换完成标志这个标志在中断函数里被设置 while (false gCheckADC) { delay_us(1); timeout--; if(timeout 0) // 超时处理打印错误 { printf(ADC转换超时错误!! LINE:%d\r\n,__LINE__); return 0; // 返回一个错误值 } } // 3. 转换完成从ADC结果存储器中读取数据 gAdcResult DL_ADC12_getMemResult(ADC12_0_INST, ADC12_MEM_IDX_0); // 注意原文代码此处为ADC12_0_ADCMEM_ADC_CH0需根据实际生成的宏调整 // 4. 清除标志为下一次转换做准备 gCheckADC false; return gAdcResult; // 返回原始的ADC数字值例如0-4095对应0V-3.3V }接着ADC均值滤波函数 直接读一次ADC值噪声很大通常取多次平均。unsigned int Get_ADC_Value(void) { unsigned char i 0; unsigned int AdcValue 0; // 循环采样SAMPLES次比如30次 for(i 0; i SAMPLES; i) { AdcValue ADC_GET(); // 累加 } AdcValue AdcValue / SAMPLES; // 求平均值 return AdcValue; // 返回滤波后的ADC值 }然后数字信号读取函数 这个就非常简单了直接使用头文件里定义的宏。unsigned char Get_DO_Num(void) { if( IR_DO 1 ) // 根据宏定义IR_DO为1时表示DO引脚为高电平 { return 1; // 模块输出高电平通常表示未检测到黑线取决于模块比较器设置 } else { return 0; // 模块输出低电平通常表示检测到黑线 } }重要提示IR_DO 1具体对应“黑”还是“白”取决于模块上那个蓝色电位器的调节方向。你需要在实际调试时将传感器分别放在黑线和白线上观察这个函数的返回值来确定。通常检测到黑线时DO输出低电平0。最后ADC中断服务函数 这个函数由硬件自动调用我们在里面设置转换完成标志。void ADC12_0_INST_IRQHandler(void) { // 检查是哪个ADC中断源触发了 switch (DL_ADC12_getPendingInterrupt(ADC12_0_INST)) { // 如果是我们使用的存储器0MEM0转换完成中断 case DL_ADC12_IIDX_MEM0_RESULT_LOADED: gCheckADC true; // 设置标志位通知主程序可以读取数据了 break; default: break; } }5. 实战验证在主函数中测试驱动写好了最后在main.c里写个简单的测试程序看看传感器是否正常工作。#include board.h #include stdio.h #include bsp_IRtracking.h int main(void) { // 开发板基础初始化时钟、延时等 board_init(); // 初始化我们的红外循迹传感器 IRtracking_Init(); printf(红外循迹传感器演示开始\r\n); while(1) { // 读取并打印模拟值AO printf(AO (模拟值) %d\r\n, Get_ADC_Value() ); // 读取并打印数字状态DO printf(DO (数字状态) %d\r\n\n, Get_DO_Num() ); // 延时1秒避免打印太快 delay_ms(1000); } }上电调试将代码编译下载到MSPM0G3507开发板。打开串口调试助手如Putty、SecureCRT设置好波特率与board_init中配置的一致通常是115200。观察打印信息。测试用手或一张白纸靠近/远离传感器底部观察AO值的变化距离越近反射越强AO值越大。用黑胶带和白纸测试DO值的变化并调节模块上的蓝色电位器直到DO值能准确地在黑白之间切换。调试心得AO值范围正常工作时AO值会在一个范围内变化。你可以通过这个值来设定一个软件阈值实现比硬件比较器更灵活的判断逻辑。DO跳变如果DO输出不稳定在黑白边缘频繁跳变可以尝试稍微调高电位器增加回差或者在软件中对DO信号进行软件消抖比如连续读取5次都是同一状态才确认。高度影响传感器的检测效果受安装高度影响很大最好根据你的小车底盘高度在目标距离比如5mm处仔细调节电位器。按照这个流程走下来你就成功把通用的TCRT5000模块移植到了TI MSPM0平台。这个过程中学习的硬件连接、SysConfig配置、ADC中断读取、GPIO输入等方法完全可以套用到其他类似的传感器如超声波、光敏电阻上。