STM32光敏模块实战：从ADC采样到环境光强监测
1. 光敏模块与STM32的硬件连接
光敏模块是检测环境光强度的常用传感器，它通过光敏电阻将光照变化转化为电信号。我手头用的是四线制模块，包含VCC、GND、DO（数字输出）和AO（模拟输出）四个引脚。实际项目中，我们主要使用AO引脚连接STM32的ADC通道，因为模拟量能反映光照的连续变化。
接线时要注意三点：一是VCC接3.3V或5V需与模块规格匹配，我用的是3.3V供电；二是AO引脚必须连接到支持ADC功能的GPIO，我选择的是PA1（STM32F103C8T6的ADC1通道1）；三是GND一定要共地。DO引脚可以暂时悬空，它是用于阈值报警的开关量输出，后续扩展功能时再用。
这里有个坑我踩过：早期测试时发现数据跳动严重，后来发现是电源干扰。建议在VCC和GND之间加个0.1μF的滤波电容，实测能有效稳定信号。模块的AO输出电压范围是0-VCC，对应光照从暗到亮的变化。使用前最好用万用表测量AO电压范围，确认模块工作正常。
2. CubeMX的ADC配置详解
打开CubeMX新建工程时，芯片型号要选对。我用的是STM32F103C8T6，属于Medium-density系列。配置ADC分几个关键步骤：
2.1 基础外设配置
先在SYS里启用Serial Wire调试接口，否则后续无法烧录程序。时钟配置选择外部晶振（HSE），主频设为72MHz。ADC时钟不能超过14MHz，我选择6分频得到12MHz时钟。
2.2 ADC参数设置
在Analog标签下启用ADC1，将PA1配置为ADC1_IN1。关键参数如下：
- Resolution：12位（4096级精度）
- Data Alignment：右对齐
- Scan Conversion Mode：禁用（单通道不需要扫描）
- Continuous Conversion Mode：禁用（采用手动触发）
- End Of Conversion Selection：EOC标志在每次转换后置位
特别要注意"Rank"设置里的Sampling Time采样时间。光敏模块输出阻抗较高，建议设为239.5周期（约20μs），这样ADC电容能充分充电，提高采样精度。
2.3 串口辅助调试配置
为方便观察数据，我额外配置了USART1（PA9-TX,PA10-RX）用于打印电压值。波特率设为115200，数据位8，无校验位。记得在NVIC中使能串口中断，虽然本例用轮询方式发送数据。
3. HAL库的ADC采样代码实现
CubeMX生成代码后，需要添加核心业务逻辑。先包含标准输入输出库，用于格式化字符串：
#include "stdio.h"定义全局变量存储采样值：
uint16_t adc_value = 0; // 原始ADC值 uint16_t voltage_mv = 0; // 换算后的电压值(mV) char msg_buf[64]; // 串口消息缓冲区电压转换函数是关键：
void read_light_sensor(void) { HAL_ADC_Start(&hadc1); // 启动ADC转换 if(HAL_ADC_PollForConversion(&hadc1, 10) == HAL_OK) { adc_value = HAL_ADC_GetValue(&hadc1); voltage_mv = adc_value * 3300 / 4095; // 3.3V参考电压 } HAL_ADC_Stop(&hadc1); }串口打印函数这样实现：
void print_sensor_data(void) { sprintf(msg_buf, "ADC: %4d | Voltage: %4dmV\r\n", adc_value, voltage_mv); HAL_UART_Transmit(&huart1, (uint8_t*)msg_buf, strlen(msg_buf), HAL_MAX_DELAY); }主循环中每500ms采样一次：
while (1) { read_light_sensor(); print_sensor_data(); HAL_Delay(500); }4. 从电压到光照强度的转换
原始电压值需要经过两步处理才有实际意义：
4.1 校准与滤波
实测发现ADC值会有±5左右的波动。我采用滑动平均滤波，存储最近10次采样值求平均：
#define SAMPLE_SIZE 10 uint16_t adc_samples[SAMPLE_SIZE]; uint8_t sample_index = 0; void update_sample_buffer(uint16_t new_sample) { adc_samples[sample_index++] = new_sample; if(sample_index >= SAMPLE_SIZE) sample_index = 0; } uint16_t get_average_value(void) { uint32_t sum = 0; for(int i=0; i<SAMPLE_SIZE; i++) { sum += adc_samples[i]; } return sum / SAMPLE_SIZE; }4.2 光照强度换算
不同光敏电阻的响应曲线不同。以GL5516为例，其电阻-照度关系近似满足：
R = 500*(100/Lux)^0.9 // 单位：kΩ结合模块的分压电路设计，推导出电压-照度公式：
float convert_to_lux(uint16_t mv) { float v = mv / 1000.0; float rldr = (3.3 - v) * 10.0 / v; // 10kΩ分压电阻 return 100 * pow(500.0/rldr, 1/0.9); }实际应用时建议分段线性化处理。我在不同光照条件下实测得到校准表：
| 电压(mV) | 近似照度(lux) | 适用场景 |
|---|---|---|
| 0-100 | 0-10 | 全黑暗环境 |
| 100-500 | 10-100 | 夜间室内 |
| 500-1500 | 100-1000 | 普通室内照明 |
| 1500-2500 | 1000-5000 | 明亮办公室 |
| 2500-3300 | 5000+ | 阳光直射 |
5. 实际应用中的优化技巧
5.1 动态采样频率
根据应用场景调整采样率可以降低功耗。比如智能灯控系统在稳定光照时，可以延长采样间隔：
uint32_t sample_interval = 500; // 默认500ms void adjust_sample_rate(void) { static uint16_t last_value = 0; uint16_t change = abs(adc_value - last_value); if(change > 50) sample_interval = 100; // 变化剧烈时加速采样 else if(change > 20) sample_interval = 250; else sample_interval = 1000; // 稳定时降低频率 last_value = adc_value; }5.2 阈值触发功能
除了模拟量采集，还可以利用DO引脚实现快速响应。比如检测突然开灯事件：
void check_light_event(void) { static uint8_t last_state = 1; uint8_t curr_state = HAL_GPIO_ReadPin(GPIOA, GPIO_PIN_0); // DO接PA0 if(last_state == 1 && curr_state == 0) { sprintf(msg_buf, "Light ON detected!\r\n"); HAL_UART_Transmit(&huart1, (uint8_t*)msg_buf, strlen(msg_buf), HAL_MAX_DELAY); } last_state = curr_state; }5.3 低功耗优化
对于电池供电设备，可以关闭ADC和串口进入停机模式，通过外部中断唤醒：
void enter_low_power_mode(void) { HAL_ADC_Stop(&hadc1); HAL_UART_DeInit(&huart1); HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI); // 唤醒后需要重新初始化外设 SystemClock_Config(); MX_ADC1_Init(); MX_USART1_UART_Init(); }6. 常见问题排查
调试时遇到过ADC值始终为0的情况，检查发现是GPIO模式未正确配置为模拟输入。解决方法是在CubeMX中确认PA1的Mode设置为"Analog Mode"。
另一个典型问题是电压值跳变严重。除了硬件滤波，软件上可以：
- 适当增加采样时间（239.5周期）
- 在ADC初始化后添加1ms延时
- 丢弃前几次采样值
串口打印乱码时，请检查：
- 波特率是否匹配（双方均为115200）
- 电平是否匹配（3.3V TTL）
- 接线是否交叉（TX接RX，RX接TX）
最后分享一个实用技巧：用Excel绘制电压-照度曲线，可以直观验证转换公式的准确性。将模块放在已知照度的环境中（如用手机测光APP参考），记录ADC值并拟合曲线。