保姆级教程：用STM32CubeMX和HAL库搞定ADC采集光照传感器（附完整代码）
从零玩转STM32光照监测：CubeMX配置与HAL库实战指南
当阳光透过窗帘洒在桌面的STM32开发板上，那个不起眼的光敏电阻正在悄悄记录着环境亮度的变化。作为嵌入式开发的入门经典项目，光照监测系统完美融合了硬件感知与软件处理的精髓。本文将带你用STM32CubeMX和HAL库，三步构建智能光照采集系统——无需底层寄存器操作，避开晦涩的硬件原理，直接上手做出能用的作品。
1. 硬件准备与环境搭建
手边的STM32F103C8T6开发板（俗称"蓝莓板"）价格不到20元，却拥有12位精度的ADC模块。搭配一个售价仅0.5元的光敏电阻GL5528，再串联一个10kΩ普通电阻组成分压电路，这就是我们全部的硬件需求。光敏电阻的特性曲线很有意思——在10lux照度下阻值约8kΩ，100lux时降到2kΩ，这种非线性关系正是我们需要在软件中处理的。
必备软件三件套：
- STM32CubeMX 6.6.1（图形化配置神器）
- Keil MDK 5.37（经典IDE）
- Termite 3.4（串口调试工具）
提示：安装CubeMX时建议勾选"自动安装HAL库"选项，避免后续手动添加库文件的麻烦。首次使用Keil需要注册，社区版有32KB代码限制但对学习完全够用。
2. CubeMX工程配置详解
打开CubeMX时，新手常被密密麻麻的引脚图吓到。其实我们只需要关注三个关键配置：
2.1 时钟树配置
在Clock Configuration标签页，按照以下步骤设置：
- 选择HSE（外部高速时钟）为晶振输入
- 将PLLCLK设为72MHz（STM32F103的极限频率）
- ADC预分频器设置为6分频，得到12MHz ADC时钟
// 生成的时钟初始化代码片段 RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE; RCC_OscInitStruct.HSEState = RCC_HSE_ON; RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON; RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE; RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;2.2 ADC参数设置
转到Analog→ADC1标签页，关键参数这样配：
| 参数项 | 推荐值 | 说明 |
|---|---|---|
| Resolution | 12-bit | 精度越高转换时间越长 |
| Scan Mode | Disabled | 单通道不需扫描 |
| Continuous Conv | Disabled | 按需启动转换更灵活 |
| Sampling Time | 239.5 cycles | 对高阻信号源需要更长时间 |
将PA0引脚设为ADC1_IN0（通道0），这是开发板上最方便测量的ADC输入引脚。
2.3 串口配置
USART1选择异步模式，波特率115200，8位数据位，无校验位。这个设置将用于实时输出光照数据到PC端串口助手。
3. 代码编写与传感器校准
生成Keil工程后，我们需要在main.c中添加几个关键函数：
3.1 串口重定向
实现printf输出到串口的功能：
// 添加到/* USER CODE BEGIN 0 */区域 #include <stdio.h> int __io_putchar(int ch) { HAL_UART_Transmit(&huart1, (uint8_t*)&ch, 1, HAL_MAX_DELAY); return ch; }3.2 光照采集函数
阻塞式ADC读取配合数值转换：
uint16_t Read_Light_Sensor(void) { HAL_ADC_Start(&hadc1); if(HAL_ADC_PollForConversion(&hadc1, 10) == HAL_OK) { uint16_t raw = HAL_ADC_GetValue(&hadc1); // 将3.3V参考电压下的ADC值转换为百分比 uint16_t light = 100 - (raw * 100) / 4095; HAL_ADC_Stop(&hadc1); return light; } return 0xFFFF; // 错误返回值 }3.3 主循环逻辑
在while(1)循环中添加定期采集：
// 在/* USER CODE BEGIN WHILE */后添加 while (1) { uint16_t light = Read_Light_Sensor(); if(light != 0xFFFF) { printf("当前光照强度: %d%%\r\n", light); } HAL_Delay(1000); // 每秒采样一次 /* USER CODE END WHILE */ }4. 进阶优化与问题排查
当基本功能实现后，这些技巧能让你的项目更专业：
4.1 软件滤波算法
原始ADC数据常有波动，试试这个移动平均滤波：
#define FILTER_LEN 5 uint16_t filter_buf[FILTER_LEN]; uint8_t filter_index = 0; uint16_t Filter_ADC_Value(uint16_t raw) { filter_buf[filter_index++] = raw; if(filter_index >= FILTER_LEN) filter_index = 0; uint32_t sum = 0; for(uint8_t i=0; i<FILTER_LEN; i++) { sum += filter_buf[i]; } return sum / FILTER_LEN; }4.2 常见问题解决方案
现象：ADC读数始终为0
- 检查分压电路是否接对，测量PA0引脚电压是否随光照变化
- 确认CubeMX中ADC通道配置正确
- 在代码中添加HAL_ADCEx_Calibration_Start(&hadc1)进行校准
现象：数值跳动剧烈
- 增加ADC采样时间（最高可达239.5周期）
- 在VCC和GND之间加0.1uF去耦电容
- 采用前述的软件滤波算法
现象：串口输出乱码
- 检查波特率是否与终端软件设置一致
- 确认ST-Link的串口驱动安装正确
- 尝试降低波特率到9600测试
5. 项目扩展方向
当基础版本稳定运行后，不妨尝试这些升级玩法：
- 光照阈值报警：当光照低于设定值时点亮LED
if(light < 30) { HAL_GPIO_WritePin(GPIOB, GPIO_PIN_12, GPIO_PIN_SET); } else { HAL_GPIO_WritePin(GPIOB, GPIO_PIN_12, GPIO_PIN_RESET); }- 数据可视化：通过串口发送JSON格式数据
printf("{\"light\":%d,\"unit\":\"%%\"}\r\n", light);- 低功耗模式：配合RTC实现定时采样
HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI);记得在CubeMX中启用RTC和低功耗时钟源，并配置唤醒源为EXTI中断。实际测试中，这种方案可使系统待机电流降至20μA以下，纽扣电池能持续工作数月。