1. 从一盏普通台灯到你的“学习伙伴”

大家好，我是老张，一个在嵌入式硬件和AIoT领域摸爬滚打了十多年的工程师。今天想和大家聊聊一个特别有意思，也特别有意义的DIY项目——做一盏真正懂你的智能学习台灯。

你可能觉得台灯嘛，能亮就行。但回想一下自己或孩子伏案学习的场景：光线太暗伤眼睛，坐姿不正伤脊椎，一学起来就忘了时间……这些问题，一盏普通的台灯可解决不了。而我们今天要聊的这盏台灯，它基于STM32单片机，配上一块小巧的OLED屏幕，就能变成一个贴心的“学习伙伴”。它能实时告诉你当前环境够不够亮，能定时提醒你该休息了，甚至在你趴得太近时发出“嘀嘀”的警报声。

听起来是不是有点酷？这不仅仅是技术上的炫技，更是把冰冷的硬件变成了有温度的工具。我当年带我儿子做这个项目，就是为了解决他写作业时老爱趴着、光线不足还浑然不觉的问题。做完之后，他学习时明显更自觉了，因为台灯成了他的“小监工”。这个项目非常适合电子爱好者、单片机初学者，甚至是家长带着孩子一起动手，既能学到知识，又能做出一个真正有用的东西。接下来，我就把我踩过的坑、总结的经验，掰开揉碎了分享给你。

2. 系统核心：让台灯“聪明”起来的四大功能

这盏智能台灯的核心，就是让硬件具备感知、思考和交互的能力。它主要围绕四个核心功能展开，每一个功能都对应着一个实际的学习痛点。

2.1 环境光自适应：你的“护眼卫士”

我们首先来解决光线问题。人眼在过暗或过亮的环境下阅读，都容易疲劳。传统台灯要么固定亮度，要么需要手动调节，很不智能。我们的方案是加入一个光敏电阻模块。

光敏电阻是个很神奇的元件，它的阻值会随着光照强度的变化而改变。我们把它接到STM32的ADC（模数转换器）引脚上，单片机就能读取到一个0到4095（以12位ADC为例）之间的数字值，这个值直接反映了环境的明暗。

// 简化的ADC读取光照值代码示例
uint16_t Read_Light_Sensor(void) {
    ADC_SoftwareStartConvCmd(ADC1, ENABLE); // 启动ADC转换
    while(!ADC_GetFlagStatus(ADC1, ADC_FLAG_EOC)); // 等待转换完成
    return ADC_GetConversionValue(ADC1); // 获取转换值
}

拿到这个数值后，事情就变得有趣了。在自动模式下，单片机会根据这个光照值，通过PWM（脉冲宽度调制）技术动态调节LED灯的亮度。PWM可以理解为快速开关电源，通过调整“开”和“关”的时间比例（占空比）来控制平均亮度，实现无级调光。比如，检测到环境光很暗，就自动把PWM占空比调高，让灯更亮；环境光很亮，就调低占空比，甚至关闭主灯只留氛围光。我实测下来，设定一个合理的光照阈值范围（比如ADC值在1500-2500之间为舒适区间），效果非常稳定，眼睛舒服多了。

2.2 坐姿检测与提醒：纠正坏习惯的“小闹钟”

孩子（包括很多成年人）写字时容易不自觉弯腰低头，长此以往对颈椎和视力危害很大。我们用一个简单的红外光电开关或超声波模块来实现距离检测。

红外光电开关的原理是一边发射红外光，另一边接收。当你的头或身体太靠近台灯，挡住了红外光束，接收端就收不到信号，STM32检测到对应的GPIO引脚电平变化，就知道“哦，用户趴得太近了”。超声波模块则是通过计算发射和接收回波的时间差来测算距离，精度更高一些。

一旦检测到距离小于我们设定的安全值（比如30厘米），系统会立刻在OLED屏幕上显示一个大大的“请注意坐姿！”图标，同时让蜂鸣器发出“滴滴”的提醒音。这个功能我儿子一开始觉得很烦，但习惯之后，坐姿真的端正了不少。代码逻辑也很清晰，就是一个持续的检测与判断过程。

2.3 学习定时与番茄工作法：提升效率的“计时器”

专注学习一段时间后适当休息，效率更高，这就是番茄工作法的精髓。我们用一颗DS1302时钟芯片来为台灯赋予精确的时间管理能力。

DS1302是一种低功耗的实时时钟芯片，自带电池备份，即使主系统断电，时间也能继续走。我们通过它获取精确的时分秒。你可以在系统里设置一个学习时长，比如45分钟。设置好后，OLED屏幕的一角会开始倒计时显示。时间一到，蜂鸣器会响起一段柔和的提示音，提醒你该站起来活动一下，看看远方了。这个功能对于培养时间管理习惯特别有帮助，避免了学得太投入而忘记时间。

2.4 OLED信息交互窗口：一切尽在“掌握”

所有的状态信息，都需要一个直观的展示窗口。这就是0.96寸OLED显示屏的用武之地。我特别喜欢用这种屏幕，因为它分辨率高（128x64），显示清晰，而且不需要背光，自身发光，在暗环境下观看效果极佳，最关键的是它功耗非常低。

我们通过I2C或SPI协议驱动它，可以在上面显示丰富的信息：

• 实时时间：从DS1302读取的年月日、时分秒。
• 环境光强度：以数值或进度条形式显示当前ADC值。
• 台灯工作模式：醒目的“自动”或“手动”标识。
• 亮度等级：手动模式下的当前档位（如1-5档）。
• 定时器状态：倒计时或定时提醒的开关状态。
• 报警信息：“坐姿不正！”、“定时到！”等提示。

有了这块屏幕，台灯的所有“心思”你都一目了然，交互感直接拉满。

3. 硬件设计：亲手搭建你的智能控制中心

纸上谈兵终觉浅，咱们来看看具体怎么把各个部件连接起来，搭建一个稳定可靠的硬件平台。我会尽量用通俗的语言解释每个部分的选择和设计思路。

3.1 主控芯片选型：为什么是STM32F103C8T6？

核心我们选择了经典的STM32F103C8T6，大家常说的“蓝色小药丸”或者“核心板”大多就是它。选它理由很充分：

1. 性能足够：基于ARM Cortex-M3内核，主频72MHz，处理我们这些传感器数据、驱动屏幕、产生PWM波绰绰有余。
2. 资源丰富：它拥有足够多的GPIO口、多个定时器（用于PWM和系统定时）、ADC模块、I2C和SPI接口，正好满足我们连接所有外设的需求。
3. 生态完善：资料最多，社区最活跃，无论是标准库还是HAL库，学习资源和例程一抓一大把，遇到问题很容易找到答案。
4. 成本低廉：性价比极高，非常适合学习和DIY。

它的最小系统包括晶振、复位电路、电源滤波电路和程序下载接口（如SWD）。对于初学者，我强烈建议直接购买一个现成的STM32F103C8T6最小系统板，省去自己画核心电路的麻烦，把精力集中在功能实现上。

3.2 传感器与执行器模块选型与连接

这是实现功能的关键，我们一个个来看怎么接到STM32上。

模块名称	关键型号/参数	与STM32连接方式	功能说明
OLED显示屏	0.96寸，SSD1306驱动，I2C接口	SCL -> PB6, SDA -> PB7	显示所有状态信息，I2C协议只需两根线。
光敏电阻模块	模拟量输出	AO -> PA0 (ADC1_IN0)	输出模拟电压，STM32的ADC将其转换为数字值。
红外光电开关	E18-D80NK 或类似	DO -> PA1	检测到物体时输出低电平，直接连接普通GPIO。
DS1302时钟模块	带备份电池	SCLK -> PB12, IO -> PB13, RST -> PB14	三线串行通信，获取精确时间。
蜂鸣器	有源蜂鸣器（低电平触发）	信号线 -> PA8	通过GPIO输出高低电平来控制鸣叫。
LED灯板	高亮度LED，需串联限流电阻	PWM控制线 -> PA6 (TIM3_CH1)	连接到定时器的PWM输出通道，实现调光。
按键	轻触开关 x 3	分别连接至 PB0, PB1, PB2	用于模式切换、亮度加减、定时设置。

电源部分：整个系统可以用一个5V/2A的USB电源适配器供电。STM32需要3.3V，可以通过AMS1117-3.3等稳压芯片从5V降压得到。OLED、DS1302等模块通常也兼容3.3V供电。LED灯板如果功率较大，可能需要单独供电，但用PWM控制信号来自STM32。

布局建议：光敏电阻要放在灯罩外侧，避免自身灯光干扰。红外光电开关最好安装在灯臂前端，对准使用者胸口位置。OLED屏幕可以嵌入灯座正面，方便查看。

3.3 电路设计与PCB绘制要点

如果你不满足于用杜邦线连接模块，想做一个更集成、更稳定的成品，那么设计一块PCB是很有成就感的。我用的是Altium Designer，你也可以用立创EDA这类在线工具，对新手更友好。

1. 原理图绘制：根据上面的连接表，把每个元件的原理图符号找出来，按照信号流向连接好。特别注意电源网络（VCC、GND）要连接正确且完整。STM32的退耦电容（通常每个电源引脚附近放一个0.1uF和一个10uF电容）一定要画上，这是保证芯片稳定运行的关键。
2. PCB布局：
   • 分区布局：把电路板大致分为单片机核心区、传感器接口区、电源区、功率输出区（LED驱动）。
   • 电源优先：先布置电源走线，线宽要足够（比如5V和GND走线可以设到20-30mil），确保供电稳定。
   • 信号线处理：模拟信号线（如光敏电阻的ADC线）要尽量短，远离数字信号线和电源线，避免干扰。I2C等低速数字信号线问题不大。
   • 过孔与铺铜：合理使用过孔连接不同层的走线。最后对整板进行接地铺铜，能有效增强抗干扰能力。
3. 打样与焊接：现在JLC等平台打样非常便宜。收到PCB后，焊接顺序建议是“先矮后高，先里后外”：先焊电阻、电容等小元件，再焊芯片座、接插件，最后焊大元件。焊接STM32芯片时，一定要有耐心，检查有没有虚焊或短路。

4. 软件编程：赋予硬件“灵魂”的逻辑

硬件是躯干，软件才是灵魂。我们的程序要让所有模块协调工作。下面我分模块讲解关键代码逻辑。

4.1 系统初始化与主循环框架

程序一开始，必须把所有外设初始化好。这就像演出开始前，所有演员、灯光、音响都要就位。

int main(void) {
    // 1. 系统基础初始化
    Delay_Init();           // 延时函数初始化
    NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2); // 设置中断优先级分组
    USART1_Init(115200);    // 初始化串口，用于调试打印（可选）

    // 2. 外设初始化
    OLED_Init();            // OLED屏幕初始化
    KEY_Init();             // 按键GPIO初始化
    LightSensor_ADC_Init(); // 光敏电阻ADC初始化
    PWM_Init(TIM3, 1, 7199, 49); // 初始化TIM3的通道1为PWM输出，用于调光
    DS1302_Init();          // 时钟芯片初始化
    BEEP_Init();            // 蜂鸣器初始化
    PostureSensor_Init();   // 坐姿检测传感器初始化

    // 3. 清屏并显示初始界面
    OLED_Clear();
    OLED_ShowString(0, 0, "Smart Lamp Ready", 16);
    OLED_ShowString(0, 2, "Mode: Auto", 16);
    OLED_ShowString(0, 4, "Light: ", 16);

    // 4. 主循环 - 永不停止地检测与响应
    while(1) {
        Key_Process();           // 扫描按键，处理模式切换、亮度调节、定时设置
        Display_Update();        // 更新OLED显示的时间、光照值、模式等信息
        Auto_Brightness_Adjust();// 自动模式下，根据光照调整PWM
        Posture_Check();         // 检查坐姿，异常则报警
        Timer_Check();           // 检查定时器，时间到则报警
        Delay_ms(50);            // 延时一下，避免CPU空转过热
    }
}

这个while(1)循环就是系统的心脏，它不断跳动，依次检查各个功能模块的状态并作出响应。我在这里加了一个50ms的短暂延时，是为了降低CPU使用率，实际不影响功能响应速度。

4.2 关键功能模块的代码实现

PWM调光实现：这是控制灯光亮度的核心。我们利用STM32的定时器产生PWM波。

void PWM_Init(TIM_TypeDef* TIMx, uint8_t Channel, uint16_t Arr, uint16_t Psc) {
    // ... 定时器时钟使能、GPIO配置（复用推挽输出） ...
    TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure;
    TIM_OCInitTypeDef TIM_OCInitStructure;

    // 定时器基础设置，决定PWM频率
    TIM_TimeBaseStructure.TIM_Period = Arr; // 自动重装载值
    TIM_TimeBaseStructure.TIM_Prescaler = Psc; // 预分频系数
    TIM_TimeBaseStructure.TIM_ClockDivision = 0;
    TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up;
    TIM_TimeBaseInit(TIM3, &TIM_TimeBaseStructure);

    // PWM模式设置
    TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; // 模式1
    TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable;
    TIM_OCInitStructure.TIM_Pulse = 0; // 初始占空比为0，灯灭
    TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High;
    TIM_OC1Init(TIM3, &TIM_OCInitStructure); // 初始化通道1

    TIM_Cmd(TIM3, ENABLE); // 使能定时器
    TIM_CtrlPWMOutputs(TIM3, ENABLE); // 主输出使能
}

// 通过改变CCR寄存器的值来改变占空比，从而调节亮度
void Set_Light_Brightness(uint8_t level) {
    // level可以是0-100，或者0-5档
    uint16_t pulse = (uint16_t)((Arr + 1) * level / 100); // 计算对应的脉冲值
    TIM_SetCompare1(TIM3, pulse); // 设置通道1的捕获比较值
}

坐姿检测逻辑：这是一个典型的状态检测与防抖处理。

void Posture_Check(void) {
    static uint8_t alarm_flag = 0;
    static uint32_t last_alarm_time = 0;

    if (POSTURE_SENSOR_READ() == 0) { // 传感器输出低电平，表示检测到物体过近
        if (alarm_flag == 0) { // 首次检测到
            alarm_flag = 1;
            last_alarm_time = Get_SystemTick(); // 记录当前时间
            OLED_ClearLine(3); // 清除屏幕第三行
            OLED_ShowString(0, 3, "Bad Posture!", 16); // 显示警告
            BEEP_On(); // 蜂鸣器响
        } else { // 持续检测到
            // 可以设置蜂鸣器间歇鸣叫，比如响1秒停1秒
            if ((Get_SystemTick() - last_alarm_time) > 1000) {
                BEEP_Toggle(); // 切换蜂鸣器状态
                last_alarm_time = Get_SystemTick();
            }
        }
    } else { // 距离正常
        if (alarm_flag == 1) { // 刚从异常恢复
            alarm_flag = 0;
            BEEP_Off(); // 关闭蜂鸣器
            OLED_ClearLine(3);
            OLED_ShowString(0, 3, "Posture OK ", 16); // 显示正常信息
        }
    }
}

这里我加入了一个简单的状态标志alarm_flag和基于系统滴答定时器的计时，避免了传感器因抖动而误触发，也让报警提示更人性化（比如间歇鸣叫，而不是一直吵）。

OLED菜单与交互：通过几个按键，我们可以实现一个简单的菜单系统来设置参数。

typedef enum {
    MENU_MAIN,      // 主界面，显示状态
    MENU_SET_TIME,   // 设置时间
    MENU_SET_TIMER,  // 设置定时器
    MENU_SET_BRIGHTNESS // 设置手动亮度
} Menu_State_t;

Menu_State_t current_menu = MENU_MAIN;

void Key_Process(void) {
    if (KEY1_Pressed()) { // 模式切换键
        current_menu = MENU_MAIN;
        lamp_mode = (lamp_mode == AUTO_MODE) ? MANUAL_MODE : AUTO_MODE;
        OLED_ShowString(60, 2, lamp_mode ? "Manual" : "Auto ", 16);
    }
    if (KEY2_Pressed()) { // 进入设置/增加键
        if (current_menu == MENU_MAIN) {
            current_menu = MENU_SET_TIMER;
            OLED_Clear();
            OLED_ShowString(0, 0, "Set Timer(min):", 16);
            OLED_ShowNum(90, 0, study_timer, 3, 16);
        } else if (current_menu == MENU_SET_TIMER) {
            study_timer += 5; // 每次加5分钟
            if (study_timer > 120) study_timer = 5;
            OLED_ShowNum(90, 0, study_timer, 3, 16);
        }
    }
    // ... 其他按键处理
}

通过一个状态机来管理不同的菜单页面，逻辑会非常清晰。在设置模式下，通过短按、长按等组合，可以完成时间、定时时长、手动亮度等级等参数的设置。

5. 调试、优化与功能扩展

代码写完、板子焊好，最激动人心也最考验耐心的环节来了——调试。

5.1 分模块调试：化整为零，逐个击破

千万不要把所有代码都写完了再一起调试，那样出了问题会让人抓狂。一定要分模块调试。

1. 点亮OLED：先写一个最简单的测试程序，让OLED显示“Hello World”。确保I2C通信正常，屏幕能亮。
2. 测试ADC：读取光敏电阻的值，并通过串口打印出来。用手遮住光敏电阻，看数值是否大幅变化。这样可以验证硬件连接和ADC配置是否正确。
3. 测试PWM：写一个程序，让LED灯从暗到亮循环呼吸。观察灯光变化是否平滑，验证PWM配置和LED驱动电路。
4. 测试传感器：分别测试红外光电开关和DS1302。用物体遮挡红外传感器，看GPIO电平是否变化；读取DS1302的时间，看是否准确。
5. 集成测试：当所有模块单独测试都通过后，再把它们整合到主程序里。这时候出问题，大概率是逻辑冲突或者资源（如定时器、中断）配置冲突。

调试神器——串口打印：一定要善用串口调试助手。把关键变量的值（如光照ADC值、PWM占空比、传感器状态）实时打印出来，能帮你快速定位问题所在。

5.2 性能优化与稳定性提升

基础功能跑通后，我们可以让它更“优雅”、更稳定。

• 中断的合理使用：对于DS1302的定时提醒、按键的快速响应，可以使用外部中断，而不是在主循环里轮询，这样响应更及时，CPU效率更高。
• 低功耗考虑：如果想让台灯更省电，可以在检测到无人（通过红外热释电传感器，而不仅仅是光电开关）一段时间后，自动进入休眠模式，关闭屏幕和大部分外设，仅保留RTC和唤醒中断。当检测到人回来时再唤醒。STM32的停止（Stop）模式功耗可以降到微安级别。
• 参数掉电保存：用户设置的亮度偏好、定时时长等参数，可以保存到STM32内部的Flash或者外挂的EEPROM芯片（如AT24C02）中。这样下次上电就不用重新设置了。注意：STM32的内部Flash有擦写次数限制（约1万次），频繁保存的数据不要用这种方式。

5.3 脑洞大开：你的台灯还能更“智能”

这个项目是一个完美的起点，你可以根据自己的想法无限扩展：

• 加入语音控制：像网络资料里提到的，增加一个LD3320或SYN7318这类语音识别模块。你就可以说“小灯小灯，开灯”、“亮一点”，实现更酷的交互。语音模块一般通过串口与STM32通信。
• 连接物联网：增加一个ESP8266或ESP32 WiFi模块，让台灯接入家庭网络。你就可以开发一个手机APP，远程开关灯、调节亮度、查看学习时长统计。甚至接入智能音箱，实现语音控制。
• 升级传感器：用更精确的BH1750数字光照传感器替代光敏电阻，它的精度和稳定性好得多。增加一个MPU6050六轴传感器贴在椅背或使用者身上，可以实现更精准的坐姿判断（比如判断是否歪斜、驼背）。
• 数据统计与可视化：利用OLED屏幕或上传到服务器，统计每天的学习总时长、坐姿不良报警次数、平均环境光照度，生成简单的学习报告，帮助培养好习惯。

我做第一个版本时，只实现了基本功能。后来应孩子要求加了语音控制，他玩得不亦乐乎。再后来，我又加了WiFi，做了个简单的网页控制界面，出差时还能远程帮他开灯，感觉特别棒。技术的乐趣就在于，你可以不断用它去解决实际问题，创造价值。

这个基于STM32和OLED的智能学习台灯项目，从硬件选型、电路设计到软件编程，涵盖了一个嵌入式产品开发的主要流程。它不复杂，但“麻雀虽小，五脏俱全”。希望我的分享能给你带来启发和动手的勇气。当你看到自己亲手制作的台灯，随着环境光缓缓明灭，在你趴得太近时发出提醒，那种成就感是无可替代的。如果过程中遇到任何问题，欢迎随时来交流，我们一起让这盏灯变得更亮、更智能。