MicroPython pyboard 教程精讲:使用 PWM 实现 LED 渐亮与呼吸灯效果

发布时间:2026/11/19 4:24:44

MicroPython pyboard 教程精讲:使用 PWM 实现 LED 渐亮与呼吸灯效果 MicroPython pyboard 教程精讲使用 PWM 实现 LED 渐亮与呼吸灯效果【免费下载链接】micropythonMicroPython - a lean and efficient Python implementation for microcontrollers and constrained systems项目地址: https://gitcode.com/gh_mirrors/mi/micropython本教程源自 docs/pyboard/tutorial/fading_led.rst是 MicroPython pyboard 官方入门教程系列中关于脉宽调制PWM输出的核心实战指南。你将学会如何用一条数字引脚输出可变的平均电平从而平滑地控制 LED 亮度实现渐亮与呼吸灯两种经典效果同时文章会结合仓库源码带你理解 PWM 在 STM32 定时器层级的真实实现原理为后续用 PWM 驱动舵机、调光、发声等应用打下基础。为什么需要 PWM数字引脚也能输出模拟亮度LED 最简单的玩法是用数字引脚拉高/拉低实现亮与灭的开关控制。但数字引脚只有 0 和 1 两个状态无法表达半亮。解决思路是Pulse-Width Modulation脉宽调制让引脚在一个固定周期内一部分时间输出高电平、一部分时间输出低电平。只要切换频率足够高人眼感知到的就是介于全亮与全灭之间的平均亮度——高电平占比占空比越高LED 越亮。这正是本教程的出发点在只开关 LED的基础上通过控制占空比实现任意亮度从而做出渐亮动画。硬件清单与电路搭建本教程需要的元件非常少标准5 mm 或 3 mm 直插 LED一颗100 Ω 限流电阻一颗防止流过 LED 的电流过大若干导线面包板可选但能让接线更整洁、更易复现。接线方式本教程使用X1引脚将电阻的一端接到X1电阻的另一端接到 LED 的阳极anode——即较长的那根引脚将 LED 的阴极cathode接到板子的GND地。下面这张面包板接线图来自仓库 docs/pyboard/tutorial/img/fading_leds_breadboard_fritzing.png直观展示了完整的连接拓扑提示接线方向很关键——LED 是单向导电器件接反了不会发光。认准长脚为阳极这一经验法则即可。认识 X1 引脚为什么它能输出 PWM不是所有引脚都适合做 PWM 输出。在 STM32 上PWM 信号由硬件定时器的通道产生因此必须选择引脚 → 定时器通道这一映射关系成立的组合。根据 docs/pyboard/quickref.rst 的说明X1连接到定时器 5 的通道 1TIM5 CH1。在仓库中可以找到对应证据ports/stm32/boards/PYBV11/pins.csv 第 1 行X1,PA0即 pyboard v1.1 的X1对应 STM32 的PA0引脚ports/stm32/boards/stm32f405_af.csv 第 3 行PA0引脚的复用功能Alternate Function表中同时包含TIM2_CH1/TIM2_ETR与TIM5_CH1。所以PA0是一个一孔多能的引脚——quickref 中 PWM 示例用的是Timer(2)而本教程选择Timer(5)两者都是X1合法的硬件映射。这正体现了定时器与引脚的可选复用特性同一引脚可以绑定到不同定时器的对应通道。核心代码用 Timer TimerChannel 输出 PWM明确了硬件映射后代码分两步走先创建定时器对象再为指定通道创建TimerChannel对象并配置 PWM 模式。from pyb import Timer from time import sleep # timer 5 以 100 Hz 的频率工作 tim Timer(5, freq100) tchannel tim.channel(1, Timer.PWM, pinpyb.Pin.board.X1, pulse_width0)注意原文档此处写作tim pyb.Timer(5, freq100)但脚本开头已通过from pyb import Timer导入pyb这个名字并未被导入实际运行时应写为Timer(5, freq100)或把导入改为import pyb。以下代码均按可运行版本给出。代码要点Timer(5, freq100)将定时器 5 配置为100 Hz即每个 PWM 周期为1 / 100 0.01 s10 mstim.channel(1, Timer.PWM, pinpyb.Pin.board.X1, pulse_width0)取通道 1模式为Timer.PWM输出引脚绑定X1初始脉宽为 0LED 初始全灭。脉宽pulse_width是什么在 PWM 模式下LED 的亮度由脉宽决定——即每个周期内 LED 处于点亮状态的时间长度。定时器频率为 100 Hz 时每个周期 10 ms脉宽就是这 10 ms 内高电平占用的时长。从源码看脉宽的单位是定时器时钟的 tick而不是纳秒/微秒。相关证据在 ports/stm32/timer.c第 16471658 行注释明确说明capture、compare、pulse_width是同一个底层函数的不同别名在 PWM 模式下应当使用pulse_width这个语义名第 16601661 行注释给出换算关系边沿对齐edge aligned模式下pulse_width period 1时占空比为 100%中心对齐模式下pulse_width period时占空比为 100%。也就是说占空比 pulse_width / (period 1)。以 pyboard 的定时器时钟APB 总线时钟其计算逻辑见 ports/stm32/timer.c 第 354429 行的注释可以推断100 Hz 对应约 84 万个 tick 的周期因此教程中的min_width 20000对应约 2.4% 的占空比暗光max_width 200000对应约 23.8% 的占空比较亮但远未到全亮为渐亮动画留足了动态范围。实现渐亮动画Fading Effect掌握了脉宽与亮度的关系渐亮动画就顺理成章从最小脉宽开始每个循环把脉宽增加一个固定步长超过最大值后回到最小值周而复始# 最大和最小脉宽分别对应最大和最小亮度 max_width 200000 min_width 20000 # 每一步脉宽的改变量 wstep 1500 cur_width min_width while True: tchannel.pulse_width(cur_width) # 决定多久改变一次脉宽相当于动画的帧率 sleep(0.01) cur_width wstep if cur_width max_width: cur_width min_width运行后即可看到 LED 从暗到亮、然后瞬间跳回最暗、再次渐亮的循环效果。其中tchannel.pulse_width(cur_width)是每次循环的核心调用它直接写定时器通道的比较寄存器对应 ports/stm32/timer.c 第 16621672 行的pyb_timer_channel_capture_compare实现最终调用__HAL_TIM_SET_COMPAREsleep(0.01)相当于动画的帧间隔配合 1500 的步长从 20000 走到 200000 大约需要 120 帧、约 1.2 秒形成肉眼舒适平滑的渐变。进阶呼吸灯效果Breathing Effect渐亮后瞬间熄灭是循环动画而渐亮 → 渐暗 → 渐亮的往复效果更像呼吸。实现方法只需一个技巧在到达亮度上限时反转wstep的符号到达下限时再次反转。while True: tchannel.pulse_width(cur_width) sleep(0.01) cur_width wstep if cur_width max_width: cur_width max_width wstep * -1 elif cur_width min_width: cur_width min_width wstep * -1与前一版代码相比只多了两处边界处理超过max_width时把脉宽钳制在max_width并让wstep取反亮度开始下降低于min_width时把脉宽钳制在min_width并再次取反亮度重新上升。如此往复LED 亮度呈现正弦般平滑的呼吸节奏。为什么亮得快、灭得慢韦伯定律与指数补偿细心的读者运行呼吸灯代码后会注意到LED 似乎从暗到亮的变化更快从亮到暗的变化更慢。这不是代码 bug而是人眼的感知特性造成的错觉。人眼对亮度的感知不是线性的而是对数的——这被称为韦伯定律Webers Law相关背景资料见原文档引用的 telescope-optics.net 亮度响应讨论。也就是说人眼对暗处的微小变化敏感对亮处的同等幅度变化不敏感而我们的代码让脉宽等步长线性增减实际亮度增量恒定映射到人眼感知后就显得不均匀了。原文档给出的思考题是对数函数的反函数是什么答案是指数函数y e^x。要做感知均匀的渐变应当让脉宽按指数曲线变化这样人眼感知到的亮度增量才是近似均匀的。参考解法from pyb import Timer from time import sleep import math tim Timer(5, freq100) tchannel tim.channel(1, Timer.PWM, pinpyb.Pin.board.X1, pulse_width0) max_width 200000 min_width 20000 steps 100 ratio max_width / min_width # 指数曲线的动态范围 while True: # 先上升指数插值 for i in range(steps): cur int(min_width * (ratio ** (i / steps))) tchannel.pulse_width(cur) sleep(0.01) # 再下降反向指数插值 for i in range(steps - 1, -1, -1): cur int(min_width * (ratio ** (i / steps))) tchannel.pulse_width(cur) sleep(0.01)用指数曲线驱动脉宽后呼吸节奏在感知上会更加均匀自然。这是一个非常典型的硬件线性输出 vs 感官非线性感知的工程折中问题也是本教程最有价值的引申思考。备选方案DAC 与 PWM 的取舍原文档的附注Addendum还提到另一种实现途径数字模拟转换器DAC。pyboard 的X5引脚支持 DAC在 docs/pyboard/quickref.rst 中有对应示例from pyb import Pin, DAC dac DAC(Pin(X5)) dac.write(120) # 输出范围 0~255两种方案各有利弊DAC 方案直接输出连续的模拟电压代码上更直观但 DAC 输出的是电压LED 的电流取决于电路且 DAC 通道数量有限PWM 方案本教程采用每次都以相同的电流驱动 LED只是点亮的时间长短不同见原文档 Addendum 的说明。由于 LED 的亮度与驱动电流之间未必呈线性关系PWM 这种恒定电流 可变时长的方式反而能带来更精确、更一致的亮度控制效果。在实际工程中PWM 也是驱动 LED、舵机、蜂鸣器等最常见的手段通用性更强。源码视角PWM 的完整配置面与底层机制最后把教程里的 API 放到 ports/stm32/timer.c 的源码语境中可以看清它的完整能力面1.Timer.channel()的关键字参数timer.c 第 11641213 行参数含义mode必填Timer.PWM即本教程使用的脉宽调制模式pin输出引脚不传则保持None传入时会为该引脚配置对应定时器通道的复用功能引脚与定时器不匹配会报错pulse_width初始脉宽tick 单位整数pulse_width_percent初始脉宽占空比百分比0100支持浮点如 25 表示 25% 占空比pulse_width_us初始脉宽微秒pulse_width_ns初始脉宽纳秒callback通道回调函数2. 脉宽的多种设置方式timer.c 第 16751725 行除了教程使用的pulse_width()TimerChannel还提供pulse_width_percent()、pulse_width_us()、pulse_width_ns()均可不传参读取、传参设置。其中pulse_width_percent的实现compute_percent_from_pwm_value/compute_pwm_value_from_percent会把 0100 的百分比换算成对应的比较寄存器值适合需要直接按占空比调光的场景。比如 quickref 中的写法p Pin(X1) # X1 同时具备 TIM2 CH1 的复用功能 tim Timer(2, freq1000) ch tim.channel(1, Timer.PWM, pinp) ch.pulse_width_percent(50) # 直接设为 50% 占空比3. 定时器频率如何落地timer.c 第 449498 行Timer(5, freq100)的 100 Hz 并非直接写入硬件而是由compute_prescaler_period_from_freq()根据定时器输入时钟计算出一组预分频系数prescaler与计数周期period再配置到硬件定时器寄存器。这也是为什么脉冲宽度的最大值天然受period约束——脉宽超过period 1后占空比将超过 100%实际效果等同恒高电平所以教程用 200000 作为安全上限而不是更大值。总结本教程用最少的硬件一颗 LED、一个电阻、几根线演示了 MicroPython 最具代表性的硬件控制能力之一——PWM 脉宽调制输出。回顾要点选对引脚PWM 必须使用与定时器通道存在硬件映射的引脚X1PA0的复用功能同时支持TIM2_CH1与TIM5_CH1两个对象Timer决定频率/周期与TimerChannel决定脉宽/占空比脉宽本质是定时器 tick 数占空比 pulse_width / (period 1)三种动画线性渐亮、往返呼吸灯、基于指数曲线的感知均匀渐变两种输出方式PWM恒定电流 可变时长与 DAC可变电压本场景 PWM 更优。继续深入可阅读同目录下的 pyboard 快速参考、pyb.Timer 模块文档 以及定时器完整实现的 ports/stm32/timer.c。掌握了 PWM 之后下一个自然的进阶方向是用相同思路驱动舵机角度或生成 PWM 音频信号。【免费下载链接】micropythonMicroPython - a lean and efficient Python implementation for microcontrollers and constrained systems项目地址: https://gitcode.com/gh_mirrors/mi/micropython创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/16 15:53:36

中文AI作图提示词失效真相:文化语义与视觉对齐

1. 这不是“能不能用中文”的问题,而是“中文提示词能否被真正理解”的问题最近两周,我连续帮三位设计师朋友调试AI作图流程——一位做电商详情页的,想输入“国风青花瓷纹样现代简约手机壳”,结果出图全是明清官窑瓷器摆件&#x…

2026/11/17 4:57:11

Tableau数据可视化工具安装与配置全指南

1. 为什么选择Tableau做数据可视化?十年前我刚入行数据分析时,总被老板要求做各种报表。那时候用Excel折腾透视表和VBA,经常为了调个图表样式加班到凌晨。直到在某次行业交流会上,看到有人用Tableau拖拽几下就生成了动态交互仪表盘…

2026/11/19 4:20:48

大邑电工证哪里报考全流程办理指南郑州报考避坑指南

大邑电工证哪里报考全流程办理指南郑州报考避坑指南 实操考试心里没底怕挂科,是很多准备考电工证的朋友最担心的事。特别是像你这样的应届工程类毕业生,面对第一次接触的特种作业考试,不知道从哪里下手,担心流程复杂、怕挂科、怕花钱打水漂,甚至担心报名…

2026/11/19 4:20:48

珠海电工证操作证丢了怎么补办 内部消息全知道

珠海电工证操作证丢了怎么补办 内部消息全知道 学历不高怕报不上名?别急,珠海电工证操作证丢了怎么补办?我来告诉你 内部消息 ,让你省心又省钱。 为什么学历不高也能报考珠海电工证操作证? 很多人总觉得 珠海电工证操作证…

2026/11/19 4:20:48

学校没有电工证吗?保姆级教程帮你理清报考全流程

学校没有电工证吗?保姆级教程帮你理清报考全流程 之前考的证在外省能不能转过来?这个问题其实很多电工朋友都遇到过,尤其是像我们漯河的在职建筑工人,跨省工作频繁,证书的互通性直接影响到我们能否顺利上岗。今天就用 保姆级教程…

2026/11/19 4:20:48

湖南哪里考电工证好在哪考别再踩坑了

湖南哪里考电工证好在哪考别再踩坑了 实操考试心里没底怕挂科,这是很多想考电工证的朋友们最真实的心理状态。尤其是湖南地区的学员,面对复杂的考试流程、不清晰的考试标准和不确定的通过率,难免会感到焦虑。其实,只要选对地方、掌握方法,考试通过不是难…

2026/11/19 4:15:40

南阳哪个技校办电工证网上查询怎么操作最靠谱

南阳哪个技校办电工证网上查询怎么操作最靠谱 证书过期了不知道怎么复审延期,这事儿真让人头疼。尤其是在南阳,不少电工从业者都遇到过这种情况,尤其是在项目赶工期的时候,证件一过期,别说干活,连进场都成问题。如果你正好也在为电工证网上查询和复审发…

2026/11/18 21:12:58

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/18 21:55:23

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/19 0:04:42

深圳电工证培训考场模拟考试题库:郑州报考避坑指南

深圳电工证培训考场模拟考试题库:郑州报考避坑指南 证书过期了不知道怎么复审延期,很多人在遇到这个问题的时候才意识到特种作业证的重要性。其实,不管是电工证、焊工证还是高处作业证,这些证书不仅是上岗的“通行证”,更是法律对安全操作的硬性要求。尤…

2026/11/19 0:04:42

天津电工证查询入口多少钱能报上名

天津电工证查询入口多少钱能报上名 学历不高怕报不上名?别急,天津电工证查询入口其实没你想的那么难。今天咱们就来聊聊,怎么用最低的门槛、最少的钱,把电工证拿下来,还能查得到、用得上。 电工证到底值不值?先搞清楚它的作用…

2026/11/18 12:37:05

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/18 1:15:04

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑