用STM32标准库和光敏电阻做个智能小夜灯：从ADC采样到OLED动态显示（附完整代码）
用STM32标准库和光敏电阻打造智能小夜灯：从硬件选型到动态显示优化
深夜起床开灯太刺眼？传统小夜灯无法自动调节亮度？今天我们将用STM32F103C8T6开发板、光敏电阻和OLED屏，打造一个能感知环境光线并自动调节的智能小夜灯。这个项目不仅适合嵌入式初学者练手，也能为你的卧室或走廊增添一份科技感十足的实用装置。
1. 项目规划与硬件选型
在开始编码前，合理的硬件选型是项目成功的关键。我们需要的核心组件包括：
主控芯片：STM32F103C8T6（蓝色pill开发板）
- 72MHz主频，64KB Flash，20KB RAM
- 内置12位ADC，满足光照采集需求
- 价格亲民，社区资源丰富
光敏传感器：GL5528光敏电阻模块
- 灵敏度范围：8-20KΩ（光照强度变化时）
- 工作电压：3.3V-5V
- 模拟量输出，可直接连接ADC
显示模块：0.96寸OLED（SSD1306驱动）
- 128×64分辨率
- I2C接口，节省IO资源
- 自发光，无需背光
硬件连接示意图：
| 模块 | STM32引脚 | 备注 |
|---|---|---|
| 光敏AO | PA0 | ADC1通道0 |
| OLED SCL | PB6 | I2C1时钟线 |
| OLED SDA | PB7 | I2C1数据线 |
| LED输出 | PB0 | 通过MOSFET控制灯带 |
提示：实际布线时，建议为光敏电阻添加0.1μF的滤波电容，减少电源噪声对ADC采样的干扰。
2. ADC配置与光照采集优化
STM32的ADC模块虽然强大，但需要合理配置才能获得稳定读数。以下是标准库配置的关键步骤：
void ADC1_Init(void) { GPIO_InitTypeDef GPIO_InitStruct; ADC_InitTypeDef ADC_InitStruct; // 开启时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADC1 | RCC_APB2Periph_GPIOA, ENABLE); RCC_ADCCLKConfig(RCC_PCLK2_Div6); // 12MHz ADC时钟 // PA0模拟输入配置 GPIO_InitStruct.GPIO_Pin = GPIO_Pin_0; GPIO_InitStruct.GPIO_Mode = GPIO_Mode_AIN; GPIO_Init(GPIOA, &GPIO_InitStruct); // ADC参数配置 ADC_InitStruct.ADC_Mode = ADC_Mode_Independent; ADC_InitStruct.ADC_ScanConvMode = DISABLE; ADC_InitStruct.ADC_ContinuousConvMode = ENABLE; // 连续转换模式 ADC_InitStruct.ADC_ExternalTrigConv = ADC_ExternalTrigConv_None; ADC_InitStruct.ADC_DataAlign = ADC_DataAlign_Right; ADC_InitStruct.ADC_NbrOfChannel = 1; ADC_Init(ADC1, &ADC_InitStruct); // 通道配置 ADC_RegularChannelConfig(ADC1, ADC_Channel_0, 1, ADC_SampleTime_239Cycles5); // 校准流程 ADC_Cmd(ADC1, ENABLE); ADC_ResetCalibration(ADC1); while(ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while(ADC_GetCalibrationStatus(ADC1)); ADC_SoftwareStartConvCmd(ADC1, ENABLE); // 启动连续转换 }实际项目中，我们还需要考虑以下优化点：
软件滤波：采用滑动平均滤波算法消除瞬时波动
#define SAMPLE_SIZE 5 uint16_t ADC_Filter(void) { static uint16_t samples[SAMPLE_SIZE] = {0}; static uint8_t index = 0; uint32_t sum = 0; samples[index++] = ADC_GetConversionValue(ADC1); if(index >= SAMPLE_SIZE) index = 0; for(uint8_t i=0; i<SAMPLE_SIZE; i++) { sum += samples[i]; } return sum / SAMPLE_SIZE; }非线性校准：光敏电阻的响应曲线通常是非线性的，建议采用分段线性插值或查表法
3. 光照强度转换与亮度控制
获取ADC原始值后，需要将其转换为更有实际意义的光照强度百分比。常见的转换方法有：
线性转换法（简单但精度一般）：
#define MAX_ADC 4095 // 12位ADC最大值 uint8_t ConvertToPercentage(uint16_t adcValue) { return 100 - (adcValue * 100) / MAX_ADC; }查表法（精度高但需要预先校准）：
const uint16_t luxTable[] = {0, 50, 100, 200, 500, 1000}; // 照度值(lux) const uint16_t adcTable[] = {4000, 3500, 2800, 2000, 1000, 300}; // 对应ADC值 uint16_t ADCToLux(uint16_t adcVal) { for(uint8_t i=0; i<5; i++) { if(adcVal >= adcTable[i+1]) { return luxTable[i] + (luxTable[i+1]-luxTable[i]) * (adcVal-adcTable[i]) / (adcTable[i+1]-adcTable[i]); } } return luxTable[5]; }
亮度控制建议采用PWM调光，既能实现无级调光又能提高LED寿命：
void PWM_Init(void) { GPIO_InitTypeDef GPIO_InitStruct; TIM_TimeBaseInitTypeDef TIM_TimeBaseStruct; TIM_OCInitTypeDef TIM_OCInitStruct; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOB | RCC_APB2Periph_AFIO, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); // PB0作为TIM3通道3输出 GPIO_InitStruct.GPIO_Pin = GPIO_Pin_0; GPIO_InitStruct.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStruct.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOB, &GPIO_InitStruct); // 定时器基础配置 TIM_TimeBaseStruct.TIM_Prescaler = 72 - 1; // 1MHz计数频率 TIM_TimeBaseStruct.TIM_CounterMode = TIM_CounterMode_Up; TIM_TimeBaseStruct.TIM_Period = 100 - 1; // 10kHz PWM频率 TIM_TimeBaseStruct.TIM_ClockDivision = TIM_CKD_DIV1; TIM_TimeBaseInit(TIM3, &TIM_TimeBaseStruct); // PWM模式配置 TIM_OCInitStruct.TIM_OCMode = TIM_OCMode_PWM1; TIM_OCInitStruct.TIM_OutputState = TIM_OutputState_Enable; TIM_OCInitStruct.TIM_Pulse = 0; // 初始占空比0% TIM_OCInitStruct.TIM_OCPolarity = TIM_OCPolarity_High; TIM_OC3Init(TIM3, &TIM_OCInitStruct); TIM_Cmd(TIM3, ENABLE); }4. OLED动态显示优化技巧
原始方案中全屏刷新导致的闪烁问题确实影响用户体验。我们实现了局部刷新方案后，还可以进一步优化：
自定义显示布局设计：
typedef struct { uint8_t x; uint8_t y; char label[8]; uint16_t value; uint8_t prevLen; } DisplayField; void UpdateField(DisplayField *field) { // 计算数字长度 uint8_t len = 0; uint16_t temp = field->value; do { len++; temp /= 10; } while(temp > 0); // 仅当数值变化时才更新 static uint16_t lastValue = 0; if(field->value != lastValue) { OLED_LoactionClear(field->y, strlen(field->label) + field->x); OLED_ShowString(field->y, field->x, field->label); OLED_ShowNum(field->y, field->x + strlen(field->label), field->value, len); lastValue = field->value; field->prevLen = len; } }多级亮度指示条实现：
void DrawLightBar(uint8_t row, uint8_t col, uint8_t level) { OLED_SetCursor(row, col); for(uint8_t i=0; i<10; i++) { if(i < level/10) { OLED_WriteData(0xFF); // 实心块 } else { OLED_WriteData(0x81); // 空心块 } } }主循环优化后的完整实现：
int main(void) { SystemInit(); ADC1_Init(); PWM_Init(); OLED_Init(); DisplayField adcField = {1, 1, "ADC:", 0, 0}; DisplayField luxField = {1, 3, "LUX:", 0, 0}; DisplayField pwmField = {1, 5, "PWM:", 0, 0}; while(1) { uint16_t adcValue = ADC_Filter(); uint16_t luxValue = ADCToLux(adcValue); uint8_t pwmDuty = CalculatePWM(luxValue); TIM_SetCompare3(TIM3, pwmDuty); // 更新PWM输出 adcField.value = adcValue; luxField.value = luxValue; pwmField.value = pwmDuty; UpdateField(&adcField); UpdateField(&luxField); UpdateField(&pwmField); DrawLightBar(4, 1, luxValue); Delay_ms(200); } }5. 项目进阶与功能扩展
基础功能实现后，可以考虑以下增强功能：
光强历史记录：利用STM32内部Flash存储每日光照数据
#define RECORD_INTERVAL 30 // 每30分钟记录一次 void SaveToFlash(uint16_t lux) { static uint32_t lastTime = 0; if(GetCurrentMinute() - lastTime >= RECORD_INTERVAL) { FLASH_Unlock(); FLASH_ProgramHalfWord(0x0801F000 + (lastTime/RECORD_INTERVAL)*2, lux); FLASH_Lock(); lastTime = GetCurrentMinute(); } }蓝牙远程控制：通过HC-05模块实现手机APP控制
- 可调整亮度曲线参数
- 设置自动开关时段
- 查看历史光照数据
环境适应算法：自动学习用户的亮度偏好
typedef struct { uint16_t dayLuxThreshold; uint16_t nightLuxThreshold; uint8_t preferredBrightness; uint8_t learningFactor; } UserPreference; void AdjustPreference(UserPreference *pref, uint16_t currentLux, uint8_t userAdjust) { if(userAdjust != 0) { pref->preferredBrightness = (pref->preferredBrightness * (100 - pref->learningFactor) + userAdjust * pref->learningFactor) / 100; } }
硬件布局上，可以考虑3D打印一个精致的灯罩，将光敏电阻朝向环境光源，LED灯珠朝下照射，OLED显示屏倾斜一定角度方便查看状态。电源方面，建议采用5V/2A的USB适配器供电，如需电池备份，可增加18650锂电池和充放电管理模块。