STM32CubeMX实战：ADC采集光敏电阻数据实现环境光照监测
1. 光敏电阻与ADC采集基础
光敏电阻是一种常见的光照传感器，它的核心特性是电阻值会随着光照强度的变化而改变。在实际应用中，我们通常需要将这种模拟量的变化转换为数字信号，这时候就需要用到模数转换器（ADC）。STM32系列单片机内置了12位精度的ADC模块，非常适合用于这类传感器的数据采集。
我刚开始接触光敏电阻时，发现市面上主要有两种常见型号：一种是固定阈值的简易版，另一种是带可调旋钮的版本。后者多了一个数字量输出引脚(DO)，可以通过旋钮调节触发阈值。不过对于光照强度的精确测量来说，我们更关注模拟量输出(AO)，因为它能反映连续的光照变化。
光敏电阻的工作原理基于内光电效应。当光线照射到半导体材料上时，会产生电子-空穴对，导致电阻值下降。这个变化非常灵敏，在强光下电阻可能降到1kΩ以下，而在完全黑暗的环境中则可能达到几兆欧姆。在实际项目中，我更喜欢使用带AO输出的模块，因为它能提供更丰富的光照信息。
2. STM32CubeMX工程配置实战
2.1 创建新工程
打开STM32CubeMX后，第一步是选择正确的MCU型号。以STM32F103C8T6为例，这是最常用的入门级芯片。创建工程时要注意保存路径不能包含中文，这是很多新手容易踩的坑。我建议建立一个专门的工程目录，比如"D:\STM32_Projects\LightSensor"。
时钟配置是另一个关键点。对于ADC采集来说，时钟频率直接影响采样精度。我通常使用外部8MHz晶振，通过PLL倍频到72MHz系统时钟。ADC时钟建议不要超过14MHz，可以在Clock Configuration页面中设置适当的分频系数。
2.2 ADC通道配置
在Pinout & Configuration页面中，找到ADC1设置。将通道0(IN0)分配给PA0引脚，这就是我们连接光敏电阻AO输出的地方。配置参数时需要注意：
- Resolution选择12位
- Scan Conversion Mode设为Disable
- Continuous Conversion Mode设为Disable
- End Of Conversion Selection设为EOC flag at the end of single conversion
数据对齐方式建议选择右对齐，这样处理起来更方便。采样时间(Sampling Time)可以设置为55.5个周期，这样能获得更好的采样精度。我实测发现，这个参数对光照测量的稳定性影响很大。
3. 硬件连接与电路设计
3.1 光敏电阻模块接线
光敏电阻模块通常有三个引脚：
- VCC：接3.3V电源
- GND：接地
- AO：接PA0(ADC1_IN0)
这里有个实用技巧：在PA0引脚上加一个0.1uF的滤波电容，可以有效减少电源噪声对ADC采样的干扰。我在实际项目中测试过，加了滤波电容后，采样值的波动范围能减小30%以上。
3.2 分压电路原理
光敏电阻需要与固定电阻组成分压电路。假设我们使用10kΩ的上拉电阻，当光敏电阻值变化时，PA0引脚的电压也会相应变化。计算公式为： Vout = 3.3V × (Rldr / (Rldr + 10k))
这个电压值会被ADC转换为数字量。由于STM32的ADC是12位的，所以转换结果范围是0-4095。通过这个值，我们可以反推出当前的光敏电阻阻值。
4. 代码实现与优化
4.1 基础采集代码
在main.c的while循环中添加ADC采集代码：
HAL_ADC_Start(&hadc1); if(HAL_ADC_PollForConversion(&hadc1, 10) == HAL_OK) { uint32_t adcValue = HAL_ADC_GetValue(&hadc1); printf("ADC Value: %lu\r\n", adcValue); } HAL_Delay(500);这段代码实现了最基本的ADC轮询采集。我建议在调试阶段先打印原始ADC值，确认硬件连接和配置是否正确。
4.2 数据滤波处理
原始ADC值通常会有一定波动，我们可以通过软件滤波来提高稳定性。最简单的办法是移动平均滤波：
#define SAMPLE_SIZE 10 uint32_t adcBuffer[SAMPLE_SIZE]; uint32_t adcSum = 0; uint8_t index = 0; // 在循环中 adcSum -= adcBuffer[index]; adcBuffer[index] = HAL_ADC_GetValue(&hadc1); adcSum += adcBuffer[index]; index = (index + 1) % SAMPLE_SIZE; uint32_t filteredValue = adcSum / SAMPLE_SIZE;这种滤波方式在我的项目中效果很好，计算量也不大。对于光照监测这种变化相对缓慢的信号，10个样本的移动平均已经足够。
5. 光照强度计算与校准
5.1 ADC值到光照强度的转换
将ADC值转换为实际的光照强度(Lux)需要校准。首先计算电压值： float voltage = adcValue * 3.3f / 4095.0f;
然后根据光敏电阻的特性曲线转换为光照强度。不同型号的光敏电阻特性不同，通常厂家会提供电阻-照度曲线。如果没有，可以自己通过实验测量几个关键点：
- 完全黑暗环境下的电阻值
- 室内正常光照下的电阻值
- 强光照射下的电阻值
5.2 实际应用中的技巧
在实际部署时，我发现环境温度会影响光敏电阻的灵敏度。解决方法是在不同温度下多采集几组校准数据，然后在代码中做温度补偿。另一个实用技巧是使用对数转换，因为人眼对光照的感知也是对数关系的：
float lux = pow(10, (log10(adcValue) * a + b));其中a和b是校准系数，需要通过实验确定。这种转换方式更符合人眼的感知特性，显示效果更自然。
6. 串口输出与可视化
6.1 优化串口输出
除了简单的数值输出，我们可以增加更多信息：
printf("光照强度: %d lux [ADC: %d]\r\n", (int)lux, adcValue);这样调试时一目了然。如果使用串口绘图工具，可以输出特定格式的数据，方便绘制实时曲线：
printf(">light:%d\r\n", (int)lux);6.2 阈值报警功能
很多应用需要光照强度报警，可以添加如下代码：
#define LIGHT_THRESHOLD 200 if(lux > LIGHT_THRESHOLD) { HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_SET); printf("警告：光照过强！\r\n"); } else { HAL_GPIO_WritePin(LED_GPIO_Port, LED_Pin, GPIO_PIN_RESET); }这个功能在智能家居的自动窗帘控制等场景中非常实用。
7. 常见问题排查
7.1 ADC采样值不稳定
如果发现ADC值跳动很大，可以检查：
- 电源是否稳定，建议使用LDO稳压
- 是否添加了足够的滤波电容
- 采样时间是否设置合理
- 接地是否良好
7.2 光敏电阻响应慢
某些光敏电阻的响应时间较长，这时可以：
- 降低采样频率
- 增加硬件滤波电路
- 选择响应速度更快的型号
我在一个温室监控项目中就遇到过这个问题，最后通过更换光敏电阻型号解决了。
8. 进阶应用思路
8.1 多传感器融合
可以结合温湿度传感器，实现更复杂的环境监测。例如：
float comfortIndex = 0.5*lux + 0.3*temp + 0.2*humidity;这种多参数融合能提供更有价值的环