基于TI TMS320F28P550的光敏电阻传感器模块移植与ADC/GPIO驱动实战
基于TI TMS320F28P550的光敏电阻传感器模块移植与ADC/GPIO驱动实战
最近在做一个智能光照控制的小项目，需要用到光敏电阻来检测环境亮度。手头正好有TI的TMS320F28P550 DSP开发板和一块通用的光敏电阻模块，但发现网上关于C2000系列DSP驱动这类模块的教程不多。于是，我花时间把整个移植过程走了一遍，从硬件连接到软件驱动，再到数据读取和百分比转换，都封装成了可以直接复用的代码。
今天，我就把这个完整的实战过程分享出来，无论你是正在准备电赛的学生，还是刚开始接触嵌入式开发的工程师，跟着这篇教程一步步操作，都能轻松让光敏电阻模块在TI开发板上跑起来，实现精准的光照强度检测。
1. 光敏电阻模块与硬件连接
咱们先来认识一下今天的主角——光敏电阻模块。你拿到手的模块大概率长这样：一个蓝色的小板子，上面有个圆形的光敏电阻，还有四个引脚（VCC, GND, DO, AO）。
1.1 模块是怎么工作的？
光敏电阻的核心是一个用硫化镉等材料做的小电阻，它的特性非常有趣：光照越强，电阻值越小；光照越弱，电阻值越大。你可以把它想象成一个“光控可变电阻”。
模块板子上的电路主要做了两件事：
- 模拟量输出（AO）：直接把光敏电阻和一个固定电阻串联分压后的电压引出来。光线变化导致光敏电阻阻值变化，分压点的电压也就跟着变化。这个电压是连续的模拟信号。
- 数字量输出（DO）：通过一个叫LM393的电压比较器芯片。我们用一个可调电阻（模块上通常是个蓝色的小电位器）设置一个参考电压，和AO的电压进行比较。当环境光暗到一定程度（AO电压低于参考电压），DO就输出高电平（比如3.3V）；光线亮起来，DO就输出低电平（0V）。这个DO引脚就相当于一个简单的“光暗开关”。
模块的主要参数如下，接线和编程时都用得上：
| 参数 | 值 | 说明 |
|---|---|---|
| 工作电压 | 3.3V - 5V | 开发板上的3.3V和5V引脚都能用 |
| 工作电流 | 约 1mA | 非常省电 |
| 输出接口 | AO (模拟量), DO (数字量) | 一个测具体亮度，一个做阈值判断 |
| 读取方式 | ADC (读AO), GPIO (读DO) | 需要两种外设驱动 |
1.2 连接到TI开发板
连接非常简单，一共四根线。关键是AO引脚必须接到开发板带有ADC功能的GPIO上。根据开发板资料，我选择了GPIO-A6，因为它复用了ADC功能。
具体的接线对应关系看下面这个表：
| 传感器模块引脚 | 开发板引脚 | 作用 |
|---|---|---|
| VCC | 3V3 | 供电（3.3V） |
| GND | GND | 共地 |
| DO | GPIO54 | 数字输出，接普通GPIO即可 |
| AO | GPIO-A6 | 模拟输出，必须接ADC引脚 |
注意：不同型号的TI C2000开发板，ADC引脚可能不同。一定要查阅你手头开发板的原理图或引脚功能图，确认哪个GPIO支持ADC输入。连接错了是无法读取模拟信号的。
2. 开发环境配置与引脚定义
硬件接好了，接下来要在代码里告诉芯片，哪个引脚干什么用。TI的C2000系列现在推荐使用SysConfig图形化工具来配置，非常方便。
2.1 使用SysConfig配置引脚
- 在你的CCS工程里，找到并双击
c2000.syscfg这个文件，SysConfig界面会自动打开。 - 在界面中找到GPIO或PinMux的配置部分，点击ADD来添加一个新的GPIO配置项。
- 我们需要配置两个引脚：
- GPIO-A6：将其功能设置为ADC输入。通常在下拉菜单里选择“ADC-A”之类的选项，具体名称可能因型号略有差异，核心是选中ADC功能。
- GPIO54：将其功能设置为GPIO Input（GPIO输入模式），因为我们只需要读取DO引脚的高低电平。
- 配置完成后，记得按
Ctrl + S保存配置文件。 - 接着按
Ctrl + B编译一下工程。这里可能会弹出一些警告，但通常不影响，直接忽略即可。
完成这步后，SysConfig会自动生成代码。关键的引脚定义会在board.h文件里。比如，它会生成类似GPIO_A6和GPIO_DO这样的宏定义。由于我们的工程模板已经将board.h包含在了tjx_init.h中，所以我们后续编程时，只需要包含tjx_init.h这一个头文件，就能使用这些定义好的引脚了。
3. 手把手编写驱动代码
配置好硬件抽象层，我们就可以专心写业务逻辑了。一个好的习惯是为每个外设模块创建独立的驱动文件。我们在工程里新建一个module_driver文件夹，然后在里面创建两个文件：bsp_illume.c和bsp_illume.h(“bsp”意为板级支持包，“illume”是光照的意思)。
别忘了把module_driver这个文件夹的路径添加到编译器的头文件包含路径里，这样编译器才能找到我们的.h文件。
3.1 头文件定义 (bsp_illume.h)
头文件主要做两件事：声明外部可用的函数，以及定义一些宏来让代码更易读。
#ifndef __BSP_ILLUME_H__ #define __BSP_ILLUME_H__ #include "tjx_init.h" // 包含开发板所有的引脚和初始化定义 // 一个方便的宏，用于读取DO引脚的电平状态 #define GET_DO_IN GPIO_readPin(GPIO_DO) // 函数声明 uint16_t Get_Adc_Value(uint8_t Count); uint16_t Get_illume_Percentage_value(void); uint8_t Get_DO_In(void); #endif这里的关键是GET_DO_IN这个宏，它直接调用了TI驱动库里的GPIO_readPin函数来读取GPIO54的电平，后续我们判断光线明暗就靠它。
3.2 核心驱动实现 (bsp_illume.c)
这个文件包含了所有具体的读取逻辑。我们把它拆解成几个部分来看。
第一部分：基础的ADC单次读取
任何ADC读取，最底层都是一个“启动转换-等待完成-读取结果”的过程。我们把它封装成一个静态函数，只在本文件内使用。
#include "bsp_illume.h" #include "stdio.h" /** * @brief 读取一次ADC数据 * @param 无 * @retval 12位的ADC原始值 (0-4095) * @note 这是一个底层函数，被其他函数调用 */ static uint16_t ADC_GET(void) { uint16_t gAdcResult = 0; uint16_t timeOut = 1000; // 设置超时，防止卡死 // 1. 软件触发ADC开始转换 (SOC0) ADC_forceMultipleSOC(Module_ADC_BASE, Module_ADC_FORCE_SOC0); // 2. 等待ADC转换完成 while(ADC_isBusy(Module_ADC_BASE) && timeOut--) { delay_us(1); // 短暂延时 } // 3. 超时处理 if(!timeOut) { lc_printf("ADC_GET Failed!!!\r\n"); return 0; } // 4. 读取转换结果 gAdcResult = ADC_readResult(Module_ADC_RESULT_BASE, Module_ADC_SOC0); return gAdcResult; }这里有几个细节：
Module_ADC_BASE这些宏来自TI的驱动库或SysConfig生成的文件，代表了ADC外设的基地址。delay_us(1)是一个微秒级延时函数，需要你事先实现或在工程中已有。- 超时判断是个好习惯，能增强程序的健壮性。
第二部分：ADC均值滤波
直接读一次ADC值往往噪声很大，特别是对于光敏电阻这种模拟信号。常见的做法是连续采样多次然后取平均。
/** * @brief 获取指定次数的ADC平均值 * @param Count: 采样次数 * @retval 多次采样的平均值 */ uint16_t Get_Adc_Value(uint8_t Count) { uint16_t gAdcResult = 0; uint8_t i = 0; for(i = 0; i < Count; i++) { // 累加多次采样结果 gAdcResult += ADC_GET(); } // 返回平均值 return (gAdcResult / Count); }调用时，比如Get_Adc_Value(5)就是采样5次取平均。次数越多越平滑，但响应会变慢，需要根据实际需求权衡。
第三部分：将ADC值转换为光照百分比
这是我们最终想要的功能：用一个0-100的整数来表示光照强度。这里有个关键点：光越强，光敏电阻分压得到的电压越低，ADC值越小。所以计算百分比时要用“1 - 比值”。
/** * @brief 读取光敏电阻值，并转换为百分比 * @param 无 * @retval 光照强度百分比 (0%最暗，100%最亮) */ uint16_t Get_illume_Percentage_value(void) { // ADC是12位的，最大值是2^12 - 1 = 4095 int adc_max = 4095; int adc_new = 0; int Percentage_value = 0; // 获取5次采样的平均ADC值 adc_new = Get_Adc_Value(5); // 核心转换公式：百分比 = (1 - (当前值 / 最大值)) * 100 // 因为ADC值越小代表光越强，所以要用1去减 Percentage_value = ( 1 - ( (float)adc_new / adc_max ) ) * 100; return Percentage_value; }提示：公式里把
adc_new转成了float类型再做除法，是为了保证计算精度。如果直接用整数除法，adc_new / adc_max的结果永远是0（整数除整数），百分比就永远算不出来了。这是一个新手常踩的坑。
第四部分：读取数字开关量（DO）
这个就简单多了，直接使用头文件里定义好的宏来读取引脚电平。
/** * @brief 读取DO引脚的电平状态 * @param 无 * @retval 1: 环境过暗 (DO输出高电平) 0: 环境足够亮 (DO输出低电平) */ uint8_t Get_DO_In(void) { if( GET_DO_IN == 1 ) // 直接使用宏读取GPIO54 { return 1; // 检测到过暗 } return 0; // 检测到足够亮 }DO的阈值可以通过模块上的蓝色电位器调节。顺时针拧，参考电压升高，模块会在更亮的时候才判断为“亮”；逆时针拧则相反。
4. 在主程序中测试与验证
驱动写好了，最后一步就是在主函数里调用它们，看看效果。我们让开发板循环打印出ADC原始值、光照百分比和DO开关状态。
#include "driverlib.h" #include "device.h" #include "board.h" #include "tjx_init.h" #include "bsp_illume.h" // 包含我们自己的驱动头文件 void main(void) { // 1. 芯片与外设初始化（这部分代码通常由CCS或SysConfig自动生成） Device_init(); Device_initGPIO(); Interrupt_initModule(); Interrupt_initVectorTable(); Board_init(); EINT; ERTM; lc_printf("\r\n=== 光敏电阻模块测试程序启动 ===\r\n"); while(1) { // 2. 读取并打印所有数据 lc_printf("ADC原始值 = %d\r\n", Get_Adc_Value(5)); lc_printf("光照百分比 = %d%%\r\n", Get_illume_Percentage_value()); lc_printf("DO开关状态 = %d (1:暗 0:亮)\r\n", Get_DO_In()); // 3. 加个简单的LED闪烁，表示程序在运行 GPIO_writePin(RGB_B, 0); // 蓝灯亮 GPIO_writePin(RGB_G, 1); // 绿灯灭 delay_ms(500); GPIO_writePin(RGB_B, 1); // 蓝灯灭 GPIO_writePin(RGB_G, 0); // 绿灯亮 delay_ms(500); } }将代码编译下载到开发板，打开串口调试助手（波特率根据你的板子设置，通常是115200），你就能看到实时数据了。用手遮住光敏电阻，再用手电筒照它，观察ADC值、百分比和DO状态的变化。你会发现百分比比原始的ADC值直观多了，DO状态则提供了一个简单的“暗/亮”判断，可以直接用来控制继电器或者LED灯。
整个移植过程就是这样。总结一下关键点：硬件上AO必须接ADC引脚；软件上先用SysConfig配置引脚功能，然后写驱动时注意ADC值到百分比的转换逻辑，并且处理好浮点运算。把这些代码稍作修改，你就能应用到自己的光照控制、智能窗帘或者环境监测项目里了。