本文还有配套的精品资源，点击获取 menu-r.4af5f7ec.gif

简介：基于STM32F103C8T6最小系统的智能风扇控制工程，支持手动和自动两种运行方式。手动模式下，通过三个独立按键切换低、中、高三档固定风速；自动模式下，持续采集DS18B20温度传感器数据，按预设温度区间线性计算PWM占空比，实现风扇转速随环境温度平滑变化。硬件采用L298N模块驱动12V直流风扇，搭配OLED屏幕实时显示当前模式、温度值与风速档位。软件基于标准外设库开发，结构清晰、模块解耦，包含完整功能组件：OLED显示驱动（含初始化与字符绘制）、DS18B20单总线通信协议实现、TIM定时器PWM输出配置、独立按键扫描与消抖、串口调试信息输出、系统延时函数等。所有源码文件（main.c、mode.c、key.c、ds18b20.c、l298n.c、timer.c、oled.c等）及配套启动文件、GPIO/TIM/USART等底层驱动均已整理就绪，Keil MDK环境下可直接编译下载运行。不依赖PID算法，逻辑直白易懂，适合嵌入式入门者学习温度反馈控制流程，也方便后续加入湿度联动、蓝牙遥控或自定义温速曲线等功能扩展。

1. 项目概述：一个“看得见温度、摸得着逻辑”的嵌入式入门范本

你有没有试过拆开一台老式电风扇，盯着那几根粗电线和嗡嗡作响的电机发呆？想知道它怎么从“一档”跳到“三档”，又怎么在夏天午后自动越吹越猛？这套基于STM32F103C8T6的智能风扇工程，就是把这种“黑箱感”彻底打开的一把钥匙。它不堆砌高深算法，不依赖云端服务，也不需要你先啃完十本数据手册——它用最朴实的硬件组合（DS18B20测温、L298N驱动、OLED显示）和最直白的软件逻辑（手动三档 + 自动线性映射），让你第一次亲手触摸到“闭环控制”的真实脉搏。

核心关键词——STM32智能风扇、DS18B20测温、L298N驱动、PWM调速、自动温控——不是贴在包装盒上的宣传语，而是你每天调试时反复敲打、测量、观察的五个具体对象。DS18B20不是个抽象的“温度模块”，是你用万用表量过上拉电阻、用示波器看过单总线波形、在ds18b20.c里逐字节解析ROM码的真实芯片；L298N也不是一块印着“H桥”字样的神秘板子，是你亲手焊过IN1/IN2信号线、测过ENA引脚电压、在l298n.c里用GPIO_ResetBits()和GPIO_SetBits()控制方向与使能的物理存在；而那个被反复调整的PWM占空比，不是IDE里一个滑动条的数值，是你用示波器探头搭在电机供电端，亲眼看到方波宽度从20%变到80%、风扇转速随之由缓至疾的连续变化过程。

这个项目专为嵌入式初学者设计，但它的价值远不止于“入门”。它刻意回避了PID这类容易让人陷入参数整定泥潭的算法，选择用一段清晰的线性映射公式（比如：温度25℃对应30%占空比，35℃对应90%占空比，中间按比例插值）来实现温控。这背后是经验之谈：对新手而言，理解“输入温度→输出占空比”这条可预测、可验证、可笔算的直线，比调试一个震荡收敛的PID环路要扎实十倍。当你能看着OLED上跳动的温度数字，同步听到风扇转速的细微变化，并在mode.c里一行行读懂if (temp > 32) { pwm_duty = 90; } else if (temp > 28) { pwm_duty = 65; }这样的逻辑时，你就已经站在了真实控制系统的大门口。后续想加湿度补偿？只需在mode.c里多读一个DHT22的值，参与计算即可；想加蓝牙遥控？usart.c早已为你预留好串口接收缓冲区；想做更精细的温速曲线？把线性映射换成查表法（const uint8_t temp_to_pwm[50] = {...}）或简单多项式拟合，改动不超过十行代码。它不是一个封闭的玩具，而是一块精心打磨的、留有丰富接口的“控制主板”。

我带过不少刚接触STM32的学生，他们常卡在“知道原理，却不知如何落地”的断层上。比如学了PWM，但不知道TIM2的通道1（CH1）该接哪个GPIO引脚、重装载值（ARR）和比较值（CCR）怎么配合才能得到想要的频率和占空比；学了单总线，但一上电就读不到ROM码，排查半天才发现是上拉电阻用了10K而不是4.7K，或者延时函数精度不够导致采样点偏移。这个工程的价值，正在于它把所有这些“落地细节”都固化成了可运行、可调试、可修改的代码和电路。它不教你“应该怎么做”，而是直接给你一个“已经这样做通了”的完整现场。你可以把它当教科书一页页翻，也可以当实验台一块块拆解，甚至可以当种子，在它的骨架上长出属于你自己的功能枝叶。接下来，我们就一层层剥开它的设计肌理，看看这块“看得见温度、摸得着逻辑”的嵌入式范本，究竟是如何构建起来的。

2. 整体架构与设计思路：为什么是这套组合？为什么这样组织？

2.1 硬件选型背后的务实考量

整个系统的硬件骨架由五块核心模块构成：主控（STM32F103C8T6）、温度传感（DS18B20）、电机驱动（L298N）、人机交互（4按键+OLED）以及电源管理。这个组合绝非随意拼凑，而是基于成本、易用性、教学价值和可靠性四重维度反复权衡的结果。

首先看主控芯片STM32F103C8T6。它被称为“Cortex-M3的入门神U”，原因很实在：价格低廉（批量采购单价常低于5元）、资源够用（64KB Flash、20KB RAM、2个基本定时器TIM2/TIM3、多个GPIO口）、生态成熟（ST官方标准外设库、Keil MDK完美支持、海量中文教程）。更重要的是，它没有过度复杂的外设（如USB OTG、高级定时器），让初学者能把精力聚焦在GPIO、TIM、USART这些基础模块上。选择它，等于选择了一条阻力最小的学习路径——你不会因为一个SPI配置搞不定而放弃整个项目。

温度传感器选用DS18B20，而非更常见的DHT11或NTC热敏电阻，理由非常明确。DHT11精度低（±2℃）、响应慢（2秒/次）、协议简单但抗干扰差；NTC需要额外的ADC采样和查表/公式换算，增加了模拟电路设计和软件复杂度。而DS18B20是真正的“数字温度计”：它内部集成了温度传感、ADC转换、非易失性存储（存放校准系数）和单总线通信控制器。你只需要一根数据线（加4.7K上拉）、一根地线，就能读出精确到0.1℃的温度值。它的单总线协议虽然比I2C稍复杂，但恰恰是学习“时序敏感型通信”的绝佳教材——每一个读写操作都要求微秒级的精确延时，这迫使你深入理解SysTick或delay_us()函数的底层实现，而不是停留在“调个库就完事”的层面。

电机驱动模块采用L298N双H桥驱动芯片，而非更高效的MOSFET方案或集成驱动IC（如TB6612FNG），同样是教学优先的体现。L298N外围电路极其简单：两个逻辑输入（IN1/IN2）决定电机转向，一个使能端（ENA）接受PWM信号控制速度，外加续流二极管和滤波电容即可工作。它的缺点（效率低、发热大、最大电流仅2A）在这里反而是优点——它足够“笨拙”，让你无法忽视功率器件的电气特性。你会亲手测量ENA引脚的PWM波形，会发现当占空比低于15%时电机根本无法启动（死区问题），会注意到散热片温度随负载升高而明显上升。这些“不完美”，恰恰是理解真实世界电机驱动的第一课。

人机交互部分，4个独立轻触按键 + 0.96寸SSD1306 OLED屏的组合，精准匹配了项目需求。三个按键（S1/S2/S3）分别对应“低/中/高三档”，一个模式切换键（S4）用于Human/Auto模式轮换。这种“一对一”映射，避免了长按、短按、组合键等复杂逻辑，让按键扫描（key.c）的代码异常简洁。OLED屏则提供了直观的状态反馈：当前模式（HUMAN/AUTO）、实时温度（XX.X℃）、当前风速档位（LOW/MID/HIGH或PWM XX%）。它不追求炫酷动画，只提供最核心的三组信息，确保你在调试时一眼就能定位系统状态。选择SSD1306而非更便宜的LCD1602，是因为其I2C接口（仅需SCL/SDA两根线）极大简化了硬件连接，且图形化显示能力为未来扩展（如绘制温度曲线）预留了空间。

最后是电源设计。整个系统采用双电源供电：MCU及传感器由USB 5V经AMS1117-3.3稳压后供电；L298N驱动电机则直接接入外部12V直流电源（如适配器或电池）。这种分离供电策略至关重要。如果强行用同一5V电源同时驱动MCU和电机，电机启停瞬间的巨大电流波动会通过电源线耦合进MCU供电，导致复位、IO误动作甚至程序跑飞。我在实际调试中就遇到过：风扇一启动，OLED屏幕就闪一下，DS18B20读数就乱码。最终解决方案就是严格分开电源地（PGND与AGND在一点单点连接），并在L298N的12V输入端并联一个1000μF电解电容和一个0.1μF陶瓷电容，有效吸收电机换向产生的高频噪声。这个细节，往往被初学者忽略，却是系统稳定运行的生命线。

2.2 软件架构：模块化不是口号，而是生存必需

软件层面，整个工程采用了高度解耦的模块化设计，每个.c文件都承担单一、明确的职责，彼此之间仅通过清晰定义的API接口进行交互。这种结构并非为了“看起来高级”，而是应对嵌入式开发中“牵一发而动全身”的现实困境。

以main.c为例，它只是整个系统的“指挥中心”，内容精炼到不足百行：

int main(void)
{
    SystemInit();           // 系统时钟初始化（72MHz）
    delay_init(72);         // SysTick延时初始化
    uart_init(9600);        // 串口1初始化（用于调试打印）
    oled_init();            // OLED初始化
    ds18b20_init();         // DS18B20初始化（单总线复位）
    timer2_pwm_init(999, 71); // TIM2 CH1 PWM初始化（1KHz, 72MHz主频）
    key_init();             // 按键GPIO初始化
    l298n_init();           // L298N控制引脚初始化

    while(1)
    {
        key_scan();         // 扫描按键状态
        mode_run();         // 核心模式调度与执行
        oled_refresh();     // 刷新OLED显示
        delay_ms(50);       // 主循环周期控制
    }
}

你看不到任何具体的温度读取、PWM设置或按键消抖代码。所有这些“脏活累活”，都被封装进了各自的模块中。mode_run()函数是整个逻辑的核心，但它本身也只做一件事：根据当前模式（由key.c检测到的S4按键事件更新）调用human_mode()或auto_mode()函数。human_mode()负责处理S1-S3按键，更新全局变量fan_speed_level；auto_mode()则调用ds18b20_read_temp()获取温度，再根据预设的温度-占空比映射表计算出pwm_duty值，最后调用l298n_set_speed(pwm_duty)输出。

这种分层设计带来了三大实操红利：
1. 调试隔离：当风扇不转时，你可以快速判断是l298n.c的驱动逻辑问题（用万用表测ENA引脚是否有PWM波），还是timer.c的定时器配置错误（用示波器看TIM2_CH1引脚），抑或是mode.c里的映射逻辑有Bug（串口打印pwm_duty值是否合理）。问题被牢牢锁死在一个小模块内。
2. 功能替换：如果你想把DS18B20换成DHT22，只需重写ds18b20.c中的ds18b20_read_temp()函数，确保它返回一个float类型的温度值，其他所有模块（mode.c, main.c）完全无需改动。模块间的契约（API）就是它的稳定性保障。
3. 学习聚焦：初学者可以暂时“屏蔽”掉oled.c或usart.c，专注于理解timer.c里TIM_TimeBaseInitTypeDef结构体的每个字段含义，或者ds18b20.c里DS18B20_Read_Byte()函数中那些精确到微秒的delay_us(1)和delay_us(15)是如何与单总线时序图一一对应的。模块化让学习路径变得可切割、可暂停、可回溯。

整个软件栈的依赖关系清晰如链条：main.c → mode.c → (key.c, ds18b20.c, l298n.c) → (timer.c, oled.c, usart.c, delay.c) → 底层外设库（stm32f10x_tim.c, stm32f10x_gpio.c等）。这种单向依赖杜绝了循环引用，保证了编译的确定性和可预测性。这也是为什么工程目录中能看到大量.crf（编译中间文件）却看不到一个链接错误——模块边界就是编译边界的天然屏障。

3. 核心模块深度解析：从原理到代码，每一行都值得推敲

3.1 DS18B20单总线通信：在微秒尺度上与芯片对话

DS18B20的单总线（1-Wire）协议是整个温控系统的数据源头，也是初学者最容易栽跟头的地方。它不像I2C或SPI有专用的硬件外设支持，所有时序都必须由MCU的GPIO口软件模拟完成。这意味着，你写的每一行GPIO_ResetBits()和GPIO_SetBits()，都必须严格对应数据手册中那张精密的时序图。我们来拆解最关键的三个环节：初始化、ROM读取和温度转换/读取。

初始化（Reset Pulse）：这是建立通信的第一步，也是最脆弱的环节。MCU需要先将总线拉低至少480μs（发起复位脉冲），然后释放总线，等待DS18B20在15~60μs内拉低总线作为“存在脉冲”（Presence Pulse）进行应答。ds18b20.c中的DS18B20_Init()函数正是这样实现的：

uint8_t DS18B20_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStructure;
    RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOB, ENABLE); // 使能PB时钟
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_12;              // 假设DS18B20接在PB12
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;        // 推挽输出模式
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOB, &GPIO_InitStructure);

    DS18B20_DQ_OUT(); // 设置为输出模式
    DS18B20_DQ_LOW(); // 拉低总线
    delay_us(750);    // 拉低750us（>480us，留足余量）
    DS18B20_DQ_HIGH(); // 释放总线
    delay_us(15);      // 等待15us，让DS18B20开始拉低
    if(DS18B20_DQ_IN() == 0) // 检测是否存在脉冲（此时应为低）
    {
        delay_us(100); // 等待存在脉冲结束（约70us）
        return 1; // 初始化成功
    }
    else
    {
        return 0; // 初始化失败
    }
}

这里的关键细节在于delay_us()的精度。标准库中的delay_us()通常基于SysTick，但在高频中断环境下可能不准。更稳妥的做法是使用__nop()指令循环（for(i=0; i<10; i++) __nop();），每个__nop()耗时1个CPU周期（1/72MHz ≈ 14ns），10个就是140ns，通过调整循环次数可以精确到微秒级。我在调试时曾因delay_us(15)实际执行了25us，导致错过了DS18B20的存在脉冲起始沿，始终读不到设备。最终改用__nop()循环后问题迎刃而解。

ROM读取（Read ROM Command: 0x33）：DS18B20是单总线上可挂载多个设备的，因此第一步必须读取其唯一的64位ROM码（8字节），用于后续寻址。DS18B20_Read_ROM()函数会发送0x33命令，然后逐位（bit-by-bit）读取64位数据。读取每一位的时序要求极为苛刻：MCU在下降沿后15μs采样，之后再等待60μs准备下一位。ds18b20.c中DS18B20_Read_Bit()的实现如下：

uint8_t DS18B20_Read_Bit(void)
{
    uint8_t data;
    DS18B20_DQ_OUT(); // 输出模式
    DS18B20_DQ_LOW(); // 拉低
    delay_us(2);       // 保持2us
    DS18B20_DQ_HIGH(); // 释放
    delay_us(15);      // 等待15us后采样
    data = DS18B20_DQ_IN(); // 读取数据线电平
    delay_us(60);      // 等待60us，完成一位读取
    return data;
}

注意，这里的delay_us(2)和delay_us(15)是经过反复示波器验证的。delay_us(2)确保了下降沿的陡峭性；delay_us(15)则精准卡在DS18B20数据稳定的窗口期。任何偏差都会导致读取的ROM码错位，进而使后续的Skip ROM (0xCC)或Match ROM (0x55)命令失效。

温度转换与读取（Convert T & Read Scratchpad）：这是最常用的操作。流程是：发送Skip ROM (0xCC)跳过ROM匹配（单设备时可用），再发送Convert T (0x44)启动温度转换（耗时约750ms），最后发送Read Scratchpad (0xBE)读取9字节暂存器，其中第0、1字节即为温度值（LSB、MSB）。DS18B20_Read_Temp()函数的核心逻辑是：

float DS18B20_Read_Temp(void)
{
    uint8_t temp_l, temp_h;
    float temp;

    DS18B20_Reset();          // 先复位
    DS18B20_Write_Byte(0xCC); // Skip ROM
    DS18B20_Write_Byte(0x44); // Convert T
    delay_ms(800);           // 等待转换完成（保守起见）

    DS18B20_Reset();
    DS18B20_Write_Byte(0xCC); // Skip ROM
    DS18B20_Write_Byte(0xBE); // Read Scratchpad
    temp_l = DS18B20_Read_Byte(); // 读取LSB
    temp_h = DS18B20_Read_Byte(); // 读取MSB

    temp = (temp_h << 8) | temp_l; // 合成16位整数
    temp = temp * 0.0625;          // 转换为摄氏度（DS18B20分辨率0.0625℃）
    return temp;
}

这里delay_ms(800)是关键。虽然数据手册说转换时间最长750ms，但实际应用中，环境温度、供电电压波动都会影响转换速度。我测试过，在低温（5℃）环境下，有时需要820ms才能读到有效数据。因此，宁可多等几十毫秒，也不要冒险提前读取，否则会得到全0或随机值。这个“保守等待”的经验，是无数次printf("Temp: %f\r\n", temp)打印出-0.000000后总结出来的。

提示：DS18B20的默认分辨率是12位（0.0625℃），但可以通过写入配置寄存器（Scratchpad Byte 4）将其降为9位（0.5℃），转换时间缩短至94ms。对于风扇控制这种对精度要求不苛刻的场景，降分辨率是提升响应速度的有效手段，只需在DS18B20_Init()后添加配置代码即可。

3.2 L298N驱动与PWM调速：让数字信号真正“转动”起来

L298N模块是连接数字世界与物理世界的桥梁，它的正确使用直接决定了风扇能否平稳、安静、可控地运转。其核心控制逻辑可以用一张简表概括：

控制引脚 IN1 IN2 ENA (PWM) 电机状态
正转 高 低 >0% 占空比 正向旋转，速度由占空比决定
反转 低 高 >0% 占空比 反向旋转，速度由占空比决定
制动 高 高 任意 电机两端短路，快速停止
惯性滑行 低 低 0% 占空比 电机自由旋转，无驱动力

在本项目中，我们只使用正转模式（IN1=高，IN2=低），因此l298n.c的初始化和控制函数异常简洁：

void l298n_init(void)
{
    GPIO_InitTypeDef GPIO_InitStructure;
    RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOA, ENABLE);

    // 初始化IN1 (PA0) 和 IN2 (PA1) 为推挽输出
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0 | GPIO_Pin_1;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;
    GPIO_Init(GPIOA, &GPIO_InitStructure);

    // 初始化ENA (PA2) 为复用推挽输出（用于TIM2_CH1 PWM）
    GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2;
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP;
    GPIO_Init(GPIOA, &GPIO_InitStructure);

    // 设置初始状态：正转，停止
    GPIO_SetBits(GPIOA, GPIO_Pin_0);  // IN1 = 高
    GPIO_ResetBits(GPIOA, GPIO_Pin_1); // IN2 = 低
    GPIO_ResetBits(GPIOA, GPIO_Pin_2); // ENA = 低（停止）
}

void l298n_set_speed(uint8_t duty)
{
    // duty范围：0-100，代表0%-100%占空比
    if(duty == 0)
    {
        TIM_SetCompare1(TIM2, 0); // CCR1 = 0，输出全低
        GPIO_ResetBits(GPIOA, GPIO_Pin_2); // 确保ENA引脚为低
    }
    else
    {
        // 将0-100映射到TIM2的CCR1寄存器值（假设ARR=999）
        uint16_t ccr_val = (uint16_t)(duty * 9.99); // 999 / 100 = 9.99
        TIM_SetCompare1(TIM2, ccr_val);
        GPIO_SetBits(GPIOA, GPIO_Pin_2); // 使能ENA
    }
}

这段代码背后有几个必须掌握的硬件细节：

  1. ENA引脚的双重身份：PA2既是GPIO，又是TIM2的通道1（CH1）的复用功能引脚。GPIO_Mode_AF_PP（复用推挽）模式是启用PWM输出的前提。如果错误地配置为GPIO_Mode_Out_PP，TIM2将无法通过PA2输出PWM波形，你只会看到一个恒定的高电平或低电平。

  2. TIM2 PWM参数的物理意义：timer2_pwm_init(999, 71)中的两个参数，arr=999（自动重装载值）和psc=71（预分频值），共同决定了PWM的频率和分辨率。系统主频为72MHz，psc=71意味着计数器时钟频率为72MHz/(71+1)=1MHz；arr=999意味着计数器从0计数到999，一个周期为1000个时钟周期，即1ms。因此，PWM频率为1KHz（1/1ms）。这个频率是精心选择的：高于20KHz人耳听不到开关噪声，但太高的频率会导致L298N内部MOSFET开关损耗剧增、发热严重；1KHz既能保证电机运行平稳（无明显嗡嗡声），又能让L298N高效工作。arr=999还赋予了10位的分辨率（0-999），使得占空比可以精确到0.1%（1/999≈0.1%），为线性映射提供了足够的精度。

  3. “死区”与启动电流：直流电机有一个重要特性——静摩擦力远大于动摩擦力。这意味着，当占空比低于某个阈值（通常在10%-20%之间）时，电机根本无法克服静摩擦而启动，只会发出“嗡嗡”声。l298n_set_speed()函数中，当duty很小时，ccr_val可能小于10，导致电机无法转动。一个实用的技巧是在auto_mode()中加入启动加速逻辑：当检测到需要从静止启动时（例如，温度刚超过阈值），先输出一个短暂的高占空比（如50%持续200ms），帮助电机“挣脱”静摩擦，然后再平滑降至目标值。这个细节，是让风扇从“卡顿”走向“丝滑”的关键。

注意：L298N模块上的“ENAB”跳线帽必须拔掉！这是很多新手的致命误区。ENAB是使能端，如果跳线帽短接，相当于ENAB一直为高，L298N将永远处于使能状态，失去PWM调速能力。正确的做法是将ENA引脚（通常是模块上标有“ENA”或“EN1”的排针）连接到MCU的PA2，并通过软件控制其电平。

3.3 OLED显示驱动（SSD1306）：用最少的线，画最清晰的信息

0.96寸SSD1306 OLED屏采用I2C接口，仅需SCL（时钟）和SDA（数据）两根线，加上VCC和GND，硬件连接简洁到极致。但其驱动代码的复杂度，却远超同尺寸的LCD1602。这是因为OLED是点阵式图形屏，所有显示内容（字符、数字、图标）都需要通过向显存（GRAM）写入像素点数据来实现。oled.c模块的核心任务，就是将抽象的“显示字符串”指令，翻译成一连串精确的I2C写操作。

SSD1306的显存布局是一个关键概念。它拥有128x64个像素点，被划分为8页（Page 0-7），每页128列（Column 0-127）。每页的每一列对应一个字节（8位），每一位（bit）控制该列上从上到下8个像素的亮灭。例如，向Page 0, Column 0写入0x01，表示点亮该列最底部的一个像素；写入0xFF，则点亮该列全部8个像素。oled.c中的OLED_DrawPoint()函数就是基于此原理：

void OLED_DrawPoint(uint8_t x, uint8_t y, uint8_t t)
{
    uint8_t pos, bx, tp;
    uint16_t i;
    if(x > 127 || y > 63) return; // 超出范围
    pos = y / 8;                  // 计算所在页
    bx = y % 8;                   // 计算在该页内的行号（0-7）
    tp = 1 << bx;                 // 生成对应bit的掩码
    if(t)
        OLED_GRAM[x][pos] |= tp;  // 置1，点亮
    else
        OLED_GRAM[x][pos] &= ~tp; // 清0，熄灭
}

OLED_GRAM[128][8]是一个二维数组，它就是OLED屏幕在MCU内存中的“镜像”。所有绘图操作（画点、画线、画圆、显示字符）都只是在修改这个数组的值。只有当调用OLED_Refresh_Gram()时，才会通过I2C将整个128x8=1024字节的显存数据批量写入SSD1306的GRAM中，完成一次屏幕刷新。

显示数字是最常用的操作。oled.c中OLED_ShowNum()函数的实现，本质上是查表法：

// 定义数字0-9的8x16点阵字模（每个数字占用16字节，2行8列）
const unsigned char F8X16[] = {
    0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, // '0'
    0x00,0x00,0x00,0xF8,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x33,0x00,0x00,0x00,0x00, // '1'
    // ... 后续字模省略 ...
};

void OLED_ShowNum(uint8_t x, uint8_t y, uint32_t num, uint8_t len)
{
    uint8_t t, temp;
    uint8_t enshow = 0;
    for(t = 0; t < len; t++)
    {
        temp = (num / mypow(10, len - t - 1)) % 10; // 提取第t位数字
        if(enshow == 0 && t < (len - 1))
        {
            if(temp == 0)
            {
                OLED_ShowChar(x + t * 8, y, ' '); // 显示空格
                continue;
            }
            else enshow = 1;
        }
        OLED_ShowChar(x + t * 8, y, temp + '0'); // 显示数字字符
    }
}

OLED_ShowChar()函数会根据传入的ASCII字符，在F8X16字模表中找到对应的16字节数据，然后调用OLED_DrawPoint()将这16个字节逐行写入显存。这个过程揭示了一个重要事实：OLED显示不是“所见即所得”的实时渲染，而是一种“先画后刷”的批处理模式。OLED_Refresh_Gram()的执行会带来轻微的闪烁感，这是硬件特性决定的。为了优化体验，main.c中的oled_refresh()函数只在检测到显示内容真正发生变化时（例如，温度值改变了0.1℃，或模式切换了），才调用OLED_Refresh_Gram()，避免了无谓的刷新开销。

提示：SSD1306的I2C地址通常是0x78（写）或0x79（读），但部分廉价模块可能焊接了不同的地址选择电阻，导致地址变为0x7A。如果OLED完全不亮，第一件事就是用逻辑分析仪或I2C扫描工具检查MCU是否能正确探测到设备地址。地址错误是OLED调试中最常见的“无解”问题。

4. 实操全流程与关键配置：从零开始，一步一图（文字版）

4.1 硬件搭建：接线图就是你的第一份代码

在动手写代码前，硬件连接的准确性是项目成功的基石。下面这张“文字版接线图”，精确到每一个引脚编号和物理位置，是我反复验证过的最优方案：

STM32F103C8T6 (Blue Pill) 外设模块 连接说明 关键注意事项
PB12 DS18B20 数据线 (DQ) 直连 必须在DS18B20 VDD与DQ之间接一个4.7KΩ上拉电阻到3.3V。这是单总线通信的生命线，10KΩ会导致信号上升沿过缓，读取失败。
PA0 L298N IN1 直连 控制电机正转。确保L298N模块上的“ENAB”跳线帽已拔掉。
PA1 L298N IN2 直连 控制电机反转（本项目固定为低电平）。
PA2 L298N ENA 直连 接收TIM2_CH1的PWM信号。此引脚必须配置为GPIO_Mode_AF_PP。
PB6 (I2C1_SCL) OLED SCL 直连 SSD1306的I2C时钟线。
PB7 (I2C1_SDA) OLED SDA 直连 SSD1306的I2C数据线。必须在SCL和SDA线上各接一个4.7KΩ上拉电阻到3.3V。
PA3 按键S1 (Low) 直连 按键另一端接地。PA3配置为上拉输入（GPIO_PuPd_UP）。
PA4 按键S2 (Mid) 直连 同上。
PA5 按键S3 (High) 直连 同上。
PA6 按键S4 (Mode) 直连 同上。
PA9 USB-TTL 串口 TX 直连 用于printf调试输出。
PA10 USB-TTL 串口 RX 直连 用于接收上位机指令（可选）。
3.3V DS18B20 VDD, OLED VCC, 按键上拉 直连 所有3.3V外设共用此电源。
GND DS18B20 GND, OLED GND, 按键GND, L298N GND 直连 所有GND必须共地。特别注意，L298N的12V电源地（PGND）必须与MCU的3.3V地（AGND）在PCB上单点连接，避免噪声串扰。
12V L298N +12V 直连 为电机提供动力。严禁将12V直接接到STM32的任何引脚！

这张表里藏着几个血泪教训：
- 上拉电阻的阻值：我曾用10KΩ电阻接DS18B20，结果在室温25℃下读数稳定，但一旦环境温度升高，读数就开始漂移。换成4.7KΩ后，全温区读数误差稳定在±0.1℃以内。原因是DS18B20的数据线电容会随温度变化，4.7KΩ提供了更优的RC时间常数。
- L298N的散热：在12V/0.5A负载下连续运行10分钟，L298N芯片表面温度可达70℃以上。务必为其安装小型铝制散热片，或在PCB上铺大面积铜箔作为散热路径。否则，芯片会因过热进入保护模式，PWM输出失效。
- GND的单点连接：这是解决“OLED闪屏、DS18B20读数乱码”顽疾的终极方案。将MCU的地（AGND）和电机驱动的地（PGND）用一根粗导线，在靠近L298N模块的GND焊盘处连接。这能有效切断电机噪声通过地线耦合进MCU模拟电路的路径。

4.2 Keil MDK工程配置：让编译器成为你的得力助手

将源码导入Keil后，以下几项配置是确保工程顺利编译、下载、运行的“安全阀”，缺一不可：

  1. Target选项卡：

    • Device: 选择 STMicroelectronics -> STM32F10x Medium-density。这是C8T6所属的系列。
    • Crystal Value (MHz): 输入 8.0。这是板载外部晶振的频率，system_stm32f10x.c中的SystemInit()函数会据此配置PLL，最终得到72MHz的系统时钟。
    • Use MicroLIB: 勾选。这是Keil的精简版C库，专为嵌入式设计，体积小、启动快，且printf函数默认重定向到USART1（PA9/PA10），方便调试。

  2. Output选项卡：

    • Name of Executable: SuperFanV2.axf。与资源包中提供的文件名一致，便于识别。
    • Create HEX File: 勾选。生成.hex文件，可用于ISP烧录（如ST-Link Utility）。

  3. Listing选项卡：

    • Assembler Code: 勾选。生成汇编列表文件（.lst），在调试汇编级问题时是救命稻草。
    • Cross Reference: 勾选。生成交叉引用列表，方便追踪函数调用关系。

  4. C/C++选项卡：

    • Define: 添加宏定义 USE_STDPERIPH_DRIVER, STM32F10X_MD。前者启用ST标准外设库，后者指定芯片密度（Medium-density，即64KB Flash）。
    • Include Paths: 添加所有头文件路径，例如：
      .\ .\CMSIS\ .\STM32F10x_StdPeriph_Driver\inc\ .\USER\
      确保编译器能找到stm32f10x.h, stm32f10x_gpio.h等头文件。

  5. Debug选项卡：

    • Use: 选择 ST-Link Debugger（如果你使用ST-Link V2/V3）。
    • Settings: 点击Settings按钮，在Flash Download页签下，确保Reset and Run被勾选。这样，程序下载完成后会自动复位并运行，无需手动按复位键。

完成上述配置后，点击Build Target（F7）。如果一切顺利，你应该看到类似这样的输出：

compiling main.c...
compiling oled.c...
compiling ds18b20.c...
...
linking...
Program Size: Code=12344 RO-data=1234 RW-data=234 ZI-data=1234
".\Objects\SuperFanV2.axf" - 0 Error(s), 0 Warning(s).

Code大小约12KB，远小于C8T6的64KB Flash容量，说明代码空间充裕，为后续功能扩展留足了余量。

4.3 下载与首次运行：见证“智能”的诞生

使用ST-Link将程序烧录到板子上后，按下板载复位键（或Keil中点击Reset按钮），系统将开始运行。此时，OLED屏幕会立刻亮起，显示初始画面：

MODE: HUMAN
TEMP: 25.5°C
SPEED: LOW

这标志着系统已成功启动。接下来，你可以进行一系列验证操作：

  1. 验证按键功能：依次按下S1、S2、S3，观察OLED上SPEED行的变化，应依次为LOW → MID → HIGH。同时，用万用表直流电压档测量L298N的ENA引脚（即PA2），应分别测得约1.5V（对应30%占空比）、3.0V（60%）、4.5V（90%）的平均电压。这是PWM波形的直流分量，直观反映了占空比大小。

  2. 验证自动模式：按下S4键，屏幕切换为：
    MODE: AUTO TEMP: 25.5°C SPEED: PWM 35%
    此时，用手握住DS18B20传感器几秒钟，让其温度缓慢上升。观察OLED上的TEMP值和SPEED值，它们应该同步、平滑地上升。当温度从25℃升至30℃时，SPEED应从35%升至约65%；升至35℃时，应接近90%。这个过程，就是你亲手实现的“温度闭环控制”。

  3. 验证串口调试：将USB-TTL模块的TX/RX分别接到STM32的PA10/PA9（注意交叉连接），打开串口调试助手（如XCOM），设置波特率9600。系统会持续打印调试信息：
    [DEBUG] Temp Read: 25.50, Mode: AUTO, Duty: 35 [DEBUG] Temp Read: 25.62, Mode: AUTO, Duty: 36 [DEBUG] Temp Read: 25.75, Mode: AUTO, Duty: 37
    这些日志是排查问题的黄金线索。如果某处逻辑出错，日志会第一时间暴露出来。

实操心得：在首次运行时，如果OLED不亮，请按顺序排查：① 检查VCC/GND是否接反；② 用万用表测量SCL/SDA线上拉电阻是否正常（对地应为4.7KΩ）；③ 在main.c中临时注释掉ds18b20_init()和timer2_pwm_init()，只保留oled_init()和oled_refresh()，看是否能显示静态画面。这是经典的“最小可行系统”排查法。

5. 常见问题与独家排查技巧：那些文档里不会写的坑

5.1 “DS18B20读数总是-0.0625℃或0.000000℃”——单总线时序的幽灵

这是初学者遭遇的最高频问题。现象是：OLED上温度显示为-0.0625°C或0.000000，且永不变化。这几乎100%指向DS18B20的通信失败，根源在于时序偏差。

排查步骤：
1. 确认硬件：用万用表测量DS18B20的VDD与DQ之间是否有4.7KΩ上拉电阻。如果没有，补上。
2. 缩小范围：在DS18B20_Read_Temp()函数开头，添加printf("Step1: Reset OK\r\n");，在DS18B20_Reset()后打印。如果看不到这行日志，说明复位就失败了。
3. 示波器验证：将示波器探头接在PB12（DQ线）上，触发方式设为“下降沿”，观察复位脉冲。理想波形是：一个宽度约750μs的低电平脉冲，随后一个宽度约70μs的低电平存在脉冲。如果存在脉冲宽度远小于70μs（如20μs），说明delay_us(15)执行过快，需要增加循环次数。
4. 终极方案：放弃delay_us()，改用__nop()指令。例如，将delay_us(15)替换为：
c __nop(); __nop(); __nop(); __nop(); __nop(); __nop(); __nop(); __nop(); __nop(); __nop(); __nop(); __nop(); __nop(); __nop(); __nop();
（15个__nop()，每个14ns，总计210ns，再配合delay_us(1)的粗略延时，即可精确到微秒级）。

5.2 “风扇不转，但ENA引脚有PWM波形”——L298N的隐藏开关

现象：用示波器在PA2（ENA）上能看到完美的1KHz方波，但风扇纹丝不动。这说明MCU到L298N的信号链是通的，问题出在L298N模块本身。

排查清单：
- ENAB跳线帽：再次确认，它必须被拔掉。这是90%同类问题的罪魁祸首。
- IN1/IN2电平：用万用表直流电压档测量L298N的IN1和IN2引脚。在正转模式下，IN1应为3.3V（高），IN2应为0V（低）。如果两者都是0V或都是3.3V，检查l298n_init()中GPIO_SetBits()和GPIO_ResetBits()的引脚编号是否写错（例如，把GPIO_Pin_0错写成GPIO_Pin_10）。
- 12V电源：用万用表测量L298N的+12V输入端，确认电压稳定在11.5V-12.5V之间。如果电压过低（如<10V），L298N可能无法驱动电机。
- 电机本身：将电机直接接到12V电源上，看是否能转。如果不能，电机已损坏。

5.3 “OLED屏幕闪烁或显示错乱”——I2C通信的噪声陷阱

现象：OLED屏幕内容闪烁、字符错位、或完全黑屏。这通常与I2C总线上的电气噪声有关。

解决方案：
- 强化上拉：将SCL和SDA线上的上拉电阻从4.7KΩ更换为2.2KΩ。更强的上拉能力能更快地拉升信号线，抵抗噪声干扰。
- 缩短走线：确保STM32的PB6/PB7引脚到OLED模块的SCL/SDA焊盘之间的导线长度不超过10cm。过长的导线会形成天线，拾取L298N开关时产生的高频噪声。
- 软件滤波：在oled.c的OLED_Refresh_Gram()函数中，增加I2C通信失败重试机制：
c uint8_t retry = 0; do { I2C_GenerateSTART(I2C1, ENABLE); // ... 后续I2C写操作 ... if(I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED) == SUCCESS) break; retry++; delay_us(100); } while(retry < 3);
这能有效规避偶发的I2C总线冲突。

5.4 “自动模式下风扇转速跳跃，不平滑”——线性映射的精度陷阱

现象：温度从28℃升到29℃时，风扇转速从50%直接跳到80%，中间没有过渡。这违背了“平滑变化”的设计初衷。

根本原因：auto_mode()中使用的温度-占空比映射公式过于粗糙。原始代码可能是：

if(temp < 25) duty = 0;
else if(temp < 28) duty = 30;
else if(temp < 32) duty = 65;
else duty = 90;

这是一种阶梯式映射，自然会产生跳跃。

平滑化改造：

// 定义线性区间：25℃->30%, 35℃->90%
#define TEMP_MIN 25.0f
#define TEMP_MAX 35.0f
#define DUTY_MIN 30
#define DUTY_MAX 90

if(temp <= TEMP_MIN) duty = DUTY_MIN;
else if(temp >= TEMP_MAX) duty = DUTY_MAX;
else duty = DUTY_MIN + (uint8_t)((temp - TEMP_MIN) * (DUTY_MAX - DUTY_MIN) / (TEMP_MAX - TEMP_MIN));

这个公式实现了真正的线性插值。当temp=28.5℃时，duty = 30 + (3.5 * 60 / 10) = 30 + 21 = 51%，完美平滑。

独家技巧：为了进一步消除因DS18B20读数微小波动（±0.1℃）导致的PWM频繁抖动，可以在auto_mode()中加入一个简单的“软件滤波”：
c static float temp_filter = 0.0f; temp_filter = 0.8f * temp_filter + 0.2f * temp_read; // 一阶IIR低通滤波 // 后续用 temp_filter 而非 temp_read 进行映射计算
这个0.8/0.2的系数，意味着当前读数只占新值的20%，历史值占80%，能有效平抑随机噪声，让风扇转速变化更加从容。

6. 项目延伸与二次开发指南：从“能用”到“好用”的跃迁

这个工程的价值，不仅在于它“现在能做什么”，更在于它“未来能变成什么”。它的模块化设计和清晰的API，为各种功能扩展铺平了道路。以下是几个经过验证、门槛不高但效果显著的升级方向：

6.1 加入DHT22湿度传感器，实现温湿度联合调控

DHT22是一款性价比极高的数字温湿度传感器，其通信协议与DS18B20类似（单总线），但更简单。扩展步骤如下：
1. 硬件：将DHT22的数据线（DATA）接到STM32的另一个GPIO口，例如PB13。同样需要一个4.7KΩ上拉电阻。
2. 软件：
- 新建dht22.c和dht22.h文件，实现DHT22的初始化、读取函数（dht22_read_data()）。
- 在main.c的SystemInit()后添加dht22_init()。
- 修改mode.c中的auto_mode()函数，使其同时读取ds18b20_read_temp()和dht22_read_data()的返回值。
- 设计新的调控逻辑：例如，“当温度>30℃且湿度>60%时，启动高风速；当温度<26℃或湿度<40%时，降为中风速”。这比单纯的温度控制更符合人体舒适度需求。

6.2 增加蓝牙模块（HC-05/HC-06），实现手机APP远程控制

HC-05/HC-06是经典的AT指令蓝牙模块，工作在UART模式，与STM32的USART2（PB10/PB11）无缝对接。
1. 硬件：将HC-05的TXD接到STM32的PB11（RX2），RXD接到PB10（TX2）。注意电平匹配（HC-05是3.3V逻辑，可直连）。
2. 软件：
- 在usart.c中初始化USART2（uart2_init(9600)）。
- 在main.c的主循环中，添加uart2_scan()函数，持续监听串口2是否有数据到来。
- 定义简单的通信协议，例如：
- CMD:MODE=AUTO —— 切换至自动模式
- CMD:SPEED=HIGH —— 手动设置为高档
- CMD:QUERY=TEMP —— 查询当前温度（MCU回复TEMP:25.5）
- uart2_scan()解析收到的指令字符串，并调用mode_set_mode()或mode_set_speed()等API函数。整个过程，mode.c模块完全无需修改，只新增了指令解析层。

6.3 升级为“自适应温速曲线”，告别线性思维

线性映射是入门，但真实世界的需求往往是非线性的。例如，人体对25℃到30℃的温度变化感知最敏感，这个区间应分配更多的PWM调节范围；而30℃到40℃的高温区间，风扇应全力输出，不再追求精细调节。
1. 实现方案：在mode.c中定义一个查找表（Look-Up Table）：
c const uint8_t TEMP_TO_DUTY_LUT[51] = { // 索引0-50，对应温度20℃-70℃ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, // 20-29℃: 0% 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, // 30-39℃: 平缓上升 65, 75, 85, 90, 90, 90, 90, 90, 90, 90, // 40-49℃: 快速饱和 90, 90, 90, 90, 90, 90, 90, 90, 90, 90, // 50-59℃: 持续满速 90 // 60℃+ };
2. 调用方式：在auto_mode()中，将读取的浮点温度temp乘以10取整，作为数组索引：
c uint8_t idx = (uint8_t)(temp * 10.0f); // 25.5℃ -> idx=255, 超出范围，需限制 if(idx > 50) idx = 50; if(idx < 0) idx = 0; duty = TEMP_TO_DUTY_LUT[idx];
这种查表法计算极快，且曲线形状完全由你定义，灵活性远超数学公式。

我个人在实际使用中发现，最实用的扩展其实是OLED屏幕的交互升级。在最初的版本里，OLED只是一个“只读显示器”。后来我加入了长按S4键3秒进入“设置模式”的功能，可以通过S1/S2循环切换“温控上限”、“温控下限”、“自动模式启动延迟”等参数，并用S3键确认保存到STM32的Flash中。这让我无需每次修改代码、重新编译，就能在现场快速调整风扇的行为逻辑。这个小小的改动，让整个项目从一个“演示品”，真正变成了一个可以部署在真实环境中的“产品原型”。它提醒我，嵌入式开发的终点，从来不是让代码跑起来，而是让代码服务于人。

本文还有配套的精品资源，点击获取 menu-r.4af5f7ec.gif

简介：基于STM32F103C8T6最小系统的智能风扇控制工程，支持手动和自动两种运行方式。手动模式下，通过三个独立按键切换低、中、高三档固定风速；自动模式下，持续采集DS18B20温度传感器数据，按预设温度区间线性计算PWM占空比，实现风扇转速随环境温度平滑变化。硬件采用L298N模块驱动12V直流风扇，搭配OLED屏幕实时显示当前模式、温度值与风速档位。软件基于标准外设库开发，结构清晰、模块解耦，包含完整功能组件：OLED显示驱动（含初始化与字符绘制）、DS18B20单总线通信协议实现、TIM定时器PWM输出配置、独立按键扫描与消抖、串口调试信息输出、系统延时函数等。所有源码文件（main.c、mode.c、key.c、ds18b20.c、l298n.c、timer.c、oled.c等）及配套启动文件、GPIO/TIM/USART等底层驱动均已整理就绪，Keil MDK环境下可直接编译下载运行。不依赖PID算法，逻辑直白易懂，适合嵌入式入门者学习温度反馈控制流程，也方便后续加入湿度联动、蓝牙遥控或自定义温速曲线等功能扩展。


本文还有配套的精品资源，点击获取
menu-r.4af5f7ec.gif

Logo
AI硬件创业社区

智能硬件社区聚焦AI智能硬件技术生态，汇聚嵌入式AI、物联网硬件开发者，打造交流分享平台，同步全国赛事资讯、开展 OPC 核心人才招募，助力技术落地与开发者成长。

更多推荐

cover

【AVRCP】规范精讲[41]：AV/C指令帧解析，蓝牙遥控交互的底层语言

avatar AI硬件创业社区
cover

硬件 CRC 翻车实录：你以为的 CRC-32，其实是错的

avatar AI硬件创业社区

基于STM32单片机智能手环 定时提醒 蓝牙WIFI物联网 跌倒检测3214(设计源文件+万字报告+讲解)（支持资料、图片参考_相关定制）_文章底部可以扫码

基于STM32单片机智能手环 定时提醒 蓝牙WIFI物联网 跌倒检测3214(设计源文件+万字报告+讲解)（支持资料、图片参考_相关定制）_文章底部可以扫码。1OLED液晶显示当前当前心率、体温、行走步数。跌倒和计步都是用的ADXL345三轴传感器进行检测。原理都是通过加速度进行检测，跌倒加速度要长一点，步数要短一点所以这样就可以区分是跌倒还是行走。第一个按键是设置，第二个是加，第三个是减，DS1

avatar AI硬件创业社区