STM32F103C8T6利用旋转编码器与PWM实现WS2812动态调光系统

1. 项目概述与硬件选型

大家好，今天我想分享一个非常实用的STM32项目——用旋转编码器控制WS2812灯带的亮度。这个项目特别适合想要做智能照明或者交互式灯光效果的朋友，无论是做台灯、氛围灯还是小型装饰灯，都能用得上。我自己在实际项目中用过好几次，效果真的很不错，操作起来也很顺手。

先简单介绍一下用到的核心硬件。主控芯片是STM32F103C8T6，这款芯片大家应该很熟悉了，性价比超高，功能也足够强大。旋转编码器我选用的是常见的EC11型号，这种编码器价格便宜，到处都能买到，而且手感不错，旋转起来有清晰的段落感。灯带部分用的是WS2812，这是一种智能控制LED，每个灯珠都可以单独控制颜色和亮度，非常灵活。

为什么选择这样的组合呢？STM32F103C8T6有丰富的定时器资源，特别适合处理旋转编码器的信号和产生PWM波形。旋转编码器作为一种输入设备，比普通的按键要直观得多，你可以通过旋转来精确调节亮度，操作体验很好。WS2812灯带则是现在最流行的RGB LED方案，只需要一根信号线就能控制大量LED，减少了布线的复杂度。

这个项目的难点在于如何实时响应旋转编码器的操作，并且平滑地控制WS2812的亮度。WS2812对时序要求很严格，需要精确的控制信号。而旋转编码器的读取也需要处理抖动和方向判断。不过别担心，我会一步步带你解决这些问题。

在实际动手之前，建议大家准备好这些材料：STM32F103C8T6最小系统板、EC11旋转编码器、WS2812灯带（长度根据需求而定）、若干杜邦线和一块面包板用于连接。焊接工具和万用表也最好准备着，调试的时候会用到。

2. 硬件电路连接详解

接下来我们看看这些硬件怎么连接。虽然看起来有点复杂，但只要理清思路，一步一步来，其实并不难。我先给大家画个 mental map，帮助理解整个连接关系。

STM32F103C8T6是核心控制器，旋转编码器和WS2812灯带都连接到它上面。旋转编码器一般有5个引脚：VCC、GND、SW（按键）、DT（数据线）、CLK（时钟线）。VCC接3.3V，GND接地，SW接到一个GPIO口（我用的PB15），DT和CLK分别接到TIM1的通道1和通道2（PA8和PA9）。

WS2812灯带的连接相对简单：VCC接5V电源，GND接地，DATA IN接TIM2的通道1（PA15）。这里要注意供电问题，如果灯带较长，需要单独供电，不能直接从STM32取电，否则电流不够。

为什么这样连接呢？旋转编码器的DT和CLK接到TIM1，是因为我们可以利用STM32的编码器接口功能，硬件自动处理旋转方向和计数，比用GPIO中断方式要稳定得多。WS2812的数据线接到TIM2的通道1，是因为我们要用PWM和DMA来产生精确的时序信号。

在实际接线时，有几点需要特别注意。首先是一定要做好电源去耦，特别是在电机和单片机共用电源的情况下。我在每个芯片的VCC和GND之间都加了0.1uF的瓷片电容，效果很明显。其次是信号线的长度不要太长，如果必须延长，可以考虑加上缓冲器。

旋转编码器最好加上软件去抖动处理，虽然硬件上也可以加电容滤波，但在STM32上用软件处理更灵活。WS2812的数据线要注意阻抗匹配，如果线太长，可能会造成信号失真，这时候可以在数据线串联一个100欧姆左右的电阻。

3. STM32CubeIDE环境配置

现在我们来配置开发环境。我用的STM32CubeIDE，这是ST官方推出的集成开发环境，基于Eclipse，用起来很方便，最重要的是它整合了STM32CubeMX，可以图形化配置引脚和时钟。

新建工程的时候选择STM32F103C8T6，然后开始配置各个外设。先配置RCC和SYS，RCC中选择HSE为Crystal/Ceramic Resonator，这样可以使用外部晶振，得到更精确的时钟。SYS中Debug选Serial Wire，这样可以用STLink进行调试和下载。

接下来配置TIM1为编码器模式。在TIM1的Mode中选择Encoder Mode，Parameter Settings中Polarity选Falling Edge，这样编码器计数更准确。我测试过几种配置，这个组合响应最灵敏。记得在NVIC Settings中开启TIM1中断，这样编码器的值变化时能及时处理。

然后配置TIM2用于产生PWM。Clock Source选择Internal Clock，Channel1选择PWM Generation CH1。Parameter Settings中Prescaler设为0，Counter Period设为90-1。这个值很关键，它决定了PWM的频率，要满足WS2812的时序要求。

DMA的配置很重要，它能让数据传输不占用CPU资源。在DMA Settings中添加新的DMA请求，选择TIM2_CH1，Mode设为Circular，这样数据传输会自动循环。Data Width都选Word，这样效率最高。

GPIO的配置相对简单。旋转编码器的按键接在PB15，设置为GPIO_Input，上拉模式。WS2812的数据线接PA15，已经在TIM2中配置过了，不需要额外设置。

时钟树的配置要特别注意。将HCLK频率配置为72MHz，这是STM32F103的最高工作频率，能提供足够的处理能力。PCLK1设为36MHz，PCLK2设为72MHz。TIM1和TIM2的时钟都要正确设置，否则编码器和PWM无法正常工作。

最后生成代码时，记得选择生成单独的.c和.h文件，这样代码结构更清晰。Toolchain/IDE选择STM32CubeIDE，然后点击Generate Code就可以了。生成的代码已经包含了基本的外设初始化，我们只需要添加业务逻辑。

4. WS2812驱动代码实现

WS2812的驱动是这个项目的核心部分，也是最有趣的地方。WS2812使用一种特殊的单线通信协议，每个bit用不同占空比的PWM波表示，0码和1码的时序不同，需要精确控制。

首先在ws2812.h中定义一些常量和函数原型。CODE_ONE_DUTY和CODE_ZERO_DUTY很重要，它们定义了1和0的PWM占空比。根据我的测试，66和21这个组合在很多灯带上效果都不错，但不同批次的WS2812可能需要微调。

RST_PERIOD_NUM是复位信号的长度，WS2812要求复位信号至少50us，对应100个PWM周期。WS2812_NUM是灯带上LED的数量，根据实际使用设置，我用了60个。

颜色存储是关键部分。我定义了两个数组：ws2812_color存储目标颜色，_ws2812_color_current存储当前显示的颜色。这样设计是为了实现渐变效果，不会突然变化，看起来更柔和。

ws2812_update函数是最核心的函数，它负责将颜色数据转换为WS2812能识别的PWM波形。这个函数中，我们先处理每个LED的颜色数据，将24bit颜色转换为R、G、B三个分量，然后每个bit转换为对应的PWM占空比。

这里有个细节要注意，WS2812的数据格式是GRB，不是RGB。也就是说颜色数据的传输顺序是绿色、红色、蓝色。这个顺序搞错了，显示的颜色就不对。我在早期版本中就犯过这个错误，调试了好久才发现。

DMA传输是提高效率的关键。HAL_TIM_PWM_Start_DMA函数启动DMA传输，将PWM数据直接送到定时器，不需要CPU参与。这样即使在传输大量数据时，CPU也可以处理其他任务，不会影响系统实时性。

渐变函数ws2812_gradient实现了颜色平滑过渡。它通过线性插值计算每一步的颜色，然后逐步更新。steps参数控制渐变步数，步数越多渐变越平滑，但耗时也越长。delay_ms控制每一步的时间间隔。

颜色转换函数rgb_to_color和color_to_rgb也很重要。它们负责在RGB分量和24bit颜色值之间转换。这里用了位操作，效率很高。注意颜色值的范围是0-255，超出范围会导致显示异常。

5. 旋转编码器数据处理

旋转编码器的数据处理是另一个重点。EC11编码器每次旋转会产生两个相位差90度的信号，通过判断两个信号的相位关系可以确定旋转方向，通过计数脉冲数可以知道旋转角度。

在main函数中，我们首先初始化一些变量。led_on_count记录当前点亮的LED数量，last_encoder_value记录上一次的编码器计数值。这两个变量是控制逻辑的核心。

启动编码器模式很关键：HAL_TIM_Encoder_Start(&htim1, TIM_CHANNEL_1 | TIM_CHANNEL_2)。这个函数启动TIM1的编码器接口，硬件会自动处理编码器信号，我们只需要读取计数值即可。

在主循环中，我们不断读取编码器的计数值：current_encoder_value = __HAL_TIM_GET_COUNTER(&htim1)。这个值会随着编码器的旋转而变化，顺时针旋转时增加，逆时针旋转时减少。

方向判断逻辑很简单但很重要。如果current_encoder_value > last_encoder_value，说明顺时针旋转，增加点亮LED的数量；如果current_encoder_value < last_encoder_value，说明逆时针旋转，减少点亮LED的数量。要注意边界检查，不能让数量超出范围。

防抖动处理是必须的。编码器机械结构会导致信号抖动，可能产生误判。我用了两种方法：硬件上在CLK和DT引脚加0.1uF电容滤波；软件上采用延时去抖，读取编码器值后延时10ms再判断。

速度检测可以增强用户体验。通过计算单位时间内编码器值的变化量，可以判断旋转速度。快速旋转时，可以一次改变多个LED，提高响应速度。我实现了这个功能，操作起来更加顺手。

按键功能也是很有用的。EC11编码器通常带有一个按键，按下时可以切换工作模式，比如在亮度调节和颜色调节之间切换。按键处理采用中断方式，响应及时，不会影响旋转检测。

编码器值范围处理要注意。STM32的编码器接口是16位计数器，范围是-32768到32767。当超过范围时会自动翻转，但我们需要处理这个翻转，否则方向判断会出错。我用了int16_t类型，并处理了边界情况。

6. 主控制逻辑与效果优化

主控制逻辑是整个项目的大脑，它协调各个模块的工作，实现最终的效果。我的设计思路是：编码器控制亮度，按键切换模式，WS2812显示效果。

在主循环中，我们先处理编码器输入，根据旋转方向和速度更新led_on_count。然后根据led_on_count的值更新WS2812的颜色数据。最后调用ws2812_update更新显示。

亮度控制算法很重要。直接改变RGB值虽然简单，但视觉效果不好，因为人眼对亮度的感知不是线性的。我采用了gamma校正，使亮度变化更符合人眼特性。实际效果提升很明显，变化更加平滑自然。

颜色效果可以多样化。除了简单的白光亮度调节，还可以实现彩色效果。我实现了彩虹渐变模式，编码器旋转时颜色在光谱上循环，非常漂亮。还可以实现温度颜色模式，亮度低时偏暖色，亮度高时偏冷色。

动态效果增强用户体验。简单的突然变化很生硬，我加入了渐变过渡，亮度变化时有平滑的动画效果。通过调整渐变步数和延时，可以控制变化速度，达到最佳视觉效果。

功耗控制也是考虑因素。WS2812在全亮时功耗不小，长时间使用需要注意散热。我实现了自动亮度限制，当温度过高时自动降低亮度，保护LED延长寿命。

响应速度优化很重要。系统要实时响应编码器操作，不能有延迟感。我通过优化代码结构，减少不必要的计算，确保主循环执行很快。DMA传输也提高了效率。

模式记忆功能很实用。系统会记住最后的设置，断电再上电后恢复之前的状态。我用了STM32的Flash存储保存设置，虽然写入次数有限，但对于不频繁的操作足够了。

安全性检查是必要的。我会检查参数范围，防止超出合法值。还有温度监控，防止过热。这些保护措施让系统更加稳定可靠，可以长时间运行。

7. 常见问题与调试技巧

做这个项目可能会遇到一些问题，我把自己踩过的坑和大家分享一下，帮助大家少走弯路。

第一个常见问题是WS2812显示颜色不对。这通常是时序问题，检查CODE_ONE_DUTY和CODE_ZERO_DUTY的值是否正确。不同批次的WS2812可能需要微调这些值。用逻辑分析仪查看波形最直接，没有的话可以慢慢调试。

第二个问题是编码器读数不准，方向判断错误。检查TIM1的编码器模式配置，Polarity设置很重要。还可以在DT和CLK引脚加电容滤波，减少抖动。软件去抖也很关键，适当增加延时时间。

电源问题也很常见。WS2812全亮时电流很大，电源容量要足够。我建议WS2812单独供电，不要从STM32的3.3V取电。电源线要粗，减少压降。在每个WS2812旁边加0.1uF电容，效果会更好。

DMA传输有时会出错，特别是数据量大时。检查DMA缓冲区是否对齐，地址是否正确。Circular模式要注意缓冲区大小设置，太小会导致数据覆盖。我建议加DMA传输完成中断，处理异常情况。

代码优化很重要。中断处理要快，不能有耗时操作。主循环中的计算尽量简化，避免浮点运算。使用查表法代替实时计算，提高效率。我优化后CPU占用率很低，系统很流畅。

焊接问题也不容忽视。WS2812灯带焊接要快，温度不能太高，否则会损坏LED。STM32和编码器的连接要牢固，接触不良会导致奇怪的问题。用万用表检查每个连接点，确保连通性。

电磁干扰可能影响信号质量。PWM信号线不要太长，远离电源线。可以在信号线串联小电阻，减少振铃。良好的接地也很重要，减少噪声干扰。

最后是调试技巧。用好STM32CubeIDE的调试功能，设置断点，查看变量值。LED可以分段测试，先控制少数几个，成功后再增加。保持耐心，一步步排查，问题总能解决。