MicroPython pyboard 入门指南:硬件布局、供电方式与首次上电
嵌入式语言运行时编程语言解释器编译器物联网系统编程【免费下载链接】micropythonMicroPython - a lean and efficient Python implementation for microcontrollers and constrained systems项目地址https://gitcode.com/gh_mirrors/mi/micropython点击查看免费下载MicroPython 的 pyboard 是一块以 STM32F405RG 为核心的开发板本文是 pyboard 官方教程系列docs/pyboard/tutorial/index.rst的开篇围绕「认识硬件、正确供电、安全上电」展开并结合本仓库的 stm32 移植源码与后续教程帮助你在拿到板子后 5 分钟内完成首次通电、理解启动流程并为后续编写并运行第一个 MicroPython 脚本做好准备。读完本文你将掌握 pyboard 的板载资源布局、USB 与外部电源两种供电方式及电压限制、启动模式标准/安全/文件系统重置与常见故障的复位恢复手段。硬件布局一眼看懂 pyboard 上的关键元件在动手之前先熟悉 pyboard 的物理布局。以最常见的 pyboard 1.x 系列为例板面元件分布如下micro USB 连接器位于板的右上角是供电与数据通信USB 串口 USB 大容量存储的唯一入口micro SD 卡槽位于板的左上角插入 SD 卡后可作为扩展存储4 颗 LED位于 SD 卡槽与 USB 连接器之间颜色从下到上依次为红、绿、橙、蓝2 个开关右侧是RST复位开关左侧是USR用户开关。这些板级细节在源码中有明确对应。查看 pyboard 参考板的移植配置 ports/stm32/boards/PYBV11/mpconfigboard.h可以看到四颗 LED 的硬件引脚定义#define MICROPY_HW_LED1 (pin_A13) // red #define MICROPY_HW_LED2 (pin_A14) // green #define MICROPY_HW_LED3 (pin_A15) // yellow #define MICROPY_HW_LED4 (pin_B4) // blue #define MICROPY_HW_LED3_PWM { TIM2, 2, TIM_CHANNEL_1, GPIO_AF1_TIM2 } #define MICROPY_HW_LED4_PWM { TIM3, 3, TIM_CHANNEL_1, GPIO_AF2_TIM3 } #define MICROPY_HW_LED_ON(pin) (mp_hal_pin_high(pin)) #define MICROPY_HW_LED_OFF(pin) (mp_hal_pin_low(pin))这段代码同时印证了教程中反复提到的一个细节黄色LED3和蓝色LED4两颗 LED 支持 PWM 调光对应教程 docs/pyboard/tutorial/leds.rst 中的intensity()方法而红、绿两颗只能开关。用户开关 USR 的定义也在此文件中#define MICROPY_HW_USRSW_PIN (pin_B3) #define MICROPY_HW_USRSW_PULL (GPIO_PULLUP) #define MICROPY_HW_USRSW_EXTI_MODE (GPIO_MODE_IT_FALLING) #define MICROPY_HW_USRSW_PRESSED (0)即 USR 开关接在 B3 引脚上、内部上拉、下降沿触发外部中断——这正是教程 docs/pyboard/tutorial/switch.rst 中sw.callback()中断回调机制的底层来源。日常保养保护裸露的电路板pyboard 没有外壳硬件裸露在外使用中需要留意以下几点USB 插拔要轻柔micro USB 连接器是通孔焊接在板上的虽然相对牢固但一旦脱落修复非常困难警惕静电静电可能击穿板上的元器件。如果你所在的地区气候干燥寒冷、静电频繁请格外小心。如果 pyboard 原配了黑色塑料盒那是最好的收纳与携带方式——它由导电塑料制成、内部有导电泡沫是一个防静电盒软件几乎不可能弄坏硬件放心大胆地写代码测试即可。如果文件系统损坏可以按下文的方法重置最坏的情况下也只需通过 USB 重新烧写 MicroPython 固件。USB 供电与首次上电pyboard 通过micro USB 接口供电。用一根 micro USB 线连接到 PC注意接口只有一个方向能插进去不会插反。连接后板上的绿色 LED 会快速闪烁表示系统正在启动。从启动时序上看一次上电硬复位遵循固定的引导序列完整说明见 docs/reference/reset_boot.rst板载_boot.py烧录在固件中用于首次格式化内部闪存文件系统等初始化→ 执行可编辑的boot.py→ 初始化 USB → 执行main.py→ 若main.py不存在或退出则进入 REPL 交互解释器。更通俗的描述见 docs/pyboard/general.rst 的“Boot modes”一节标准模式下先执行boot.py然后配置 USB最后运行main.py。首次连接 PC 时pyboard 会以USB 大容量存储设备的形式出现Windows 下是可移动 U 盘、Mac 下桌面出现名为PYBFLASH的磁盘、Linux 下自动挂载可用lsblk查看后mount挂载。这个盘在 pyboard 内部称为/flash出厂时包含 4 个文件boot.py—— 各种配置选项开机时执行main.py—— 要运行的 Python 程序在boot.py之后执行README.txt—— 入门指引可安全删除pybcdc.inf—— Windows 下配置 USB 串口设备的驱动文件详见 docs/pyboard/tutorial/repl.rst。/flash是 pyboard 内部闪存上的文件系统如果插入了 micro SD 卡它会以/sd挂载并且优先从 SD 卡启动boot.py、main.py从 SD 卡查找。若希望强制从内部闪存启动可在/flash下创建一个名为SKIPSD的空文件此时 SD 卡不会自动挂载但仍可在程序中用vfs.mount手动挂载。需要特别提醒的是在复位 pyboard 之前务必先弹出Linux 下为卸载USB 盘否则可能损坏文件系统。外部电源供电VIN 与 GND除了 USB 供电pyboard 还可以通过电池或其他外部电源供电接线到板上的 VIN 与 GND 引脚。务必注意电源的正极接VIN负极地接GND。pyboard没有极性保护接反会损坏板子接线时必须万分小心。输入电压必须在 3.6V 与 10V 之间。3.6V 的下限意味着单节锂电池标称 3.7V充满约 4.2V即可供电10V 的上限说明常见的 5V USB 电源、9V 适配器都在安全范围内。超出该范围会给板载稳压电路带来风险。如果你希望进一步控制功耗pyboard 还提供软件层面的电源管理手段详见 docs/pyboard/tutorial/power_ctrl.rstwhile True: do_some_processing() pyb.wfi() # 等待中断等事件时降低功耗以及调节 CPU 主频pyb.freq(30000000) # 将 CPU 频率设为 30MHzpyb.freq()可在功耗与性能之间做权衡pyb.wfi()则让 CPU 在等待事件如外部中断时进入低功耗等待状态非常适合电池供电的场景。启动模式标准、安全与文件系统重置pyboard 支持通过「按住 USR 开关 按 RST 复位」的方式进入不同启动模式选择依据是上电时 LED 的二进制计数。操作要点详见 docs/pyboard/general.rst 与 docs/pyboard/tutorial/reset.rst连接 USB 使 pyboard 上电按住USR开关保持按住 USR同时按下并松开RST开关此时 LED 会在「绿 → 橙 → 绿橙」之间循环在 LED 显示到目标模式时松开 USR对应模式的 LED 会快速闪烁 4 次板子随即以该模式启动。三种模式如下模式LED 指示行为标准启动仅绿色 LED依次执行boot.py与main.py安全模式仅橙色 LED不执行任何启动脚本跳过boot.py/main.py以默认 USB 设置启动文件系统重置绿色 橙色 LED将内部闪存文件系统恢复出厂状态然后以安全模式启动其中安全模式用于排障它临时跳过boot.py和main.py板子以默认设置启动USB 盘正常出现你可以编辑修复这两个文件。安全模式是临时的不会改动板上文件。文件系统重置则用于两类场景文件系统损坏例如忘记弹出/卸载 USB 盘或boot.py/main.py中写入了导致你无法脱身的代码。该操作会删除 pyboard 内部存储不包含 SD 卡上的所有文件并把boot.py、main.py、README.txt、pybcdc.inf恢复为出厂状态。重置完成后会停留在安全模式按一次 RST 即可恢复正常启动。如果板子已经无法正常启动俗称“软砖”可参考 docs/reference/reset_boot.rst 中的恢复手段多数情况下打开 REPL 串口按Ctrl-C注入KeyboardInterrupt即可让脚本退出并进入 REPL然后用import os; os.remove(main.py)删除出问题的文件若 REPL 不可用再考虑安全模式与文件系统重置。复位方式与错误指示日常调试中你会频繁用到两种复位软复位在 MicroPython REPL 提示符下按Ctrl-D解释器会清理 Python 环境并重新启动打印MPY: soft reboot之类的信息后回到提示符见 docs/pyboard/tutorial/repl.rst硬复位按板上的RST 开关靠近 micro USB 插座的小黑按钮相当于断电重开会断开当前的串口连接程序。pyboard 还通过 LED 组合报告启动错误见 docs/pyboard/general.rst 的“Errors: flashing LEDs”一节红色与绿色 LED 交替闪烁某个 Python 脚本如main.py运行出错请进入 REPL 调试四颗 LED 缓慢循环点亮发生了硬故障hard fault无法恢复只能做一次硬复位。上电之后下一步该做什么完成通电验证后建议按官方教程顺序继续探索编写并运行第一个脚本编辑main.py写入import pybpyb.LED(4).on()保存弹出后按 RST 运行见 docs/pyboard/tutorial/script.rst进入 REPL 交互式执行代码print(hello pyboard!)、12、pyb.LED(1).on()等见 docs/pyboard/tutorial/repl.rst玩转四颗 LED开关、toggle()、intensity()调光与“迪斯科”循环见 docs/pyboard/tutorial/leds.rst使用 USR 开关与中断回调sw.callback(...)见 docs/pyboard/tutorial/switch.rst。需要额外硬件舵机、LCD 皮肤、音频放大皮肤等的进阶实验以及防抖、USB 透传等技巧可继续翻阅 docs/pyboard/tutorial/index.rst 中的其余章节。赞分享嵌入式语言运行时编程语言解释器编译器物联网系统编程【免费下载链接】micropythonMicroPython - a lean and efficient Python implementation for microcontrollers and constrained systems项目地址https://gitcode.com/gh_mirrors/mi/micropython点击查看免费下载相关推荐MicroPython pyb 模块完全指南pyboard 板级时间、复位、中断、电源与 USB 控制MicroPython pyb 模块完全指南pyboard 板级时间、复位、中断、电源与 USB 控制 导读 pyb 是 MicroPython 中专门面向嵌入式语言运行时编程语言解释器编译器物联网系统编程MicroPython on ESP8266 入门实战固件选择、烧录部署与首次启动配置全指南MicroPython on ESP8266 入门实战固件选择、烧录部署与首次启动配置全指南 本指南以 MicroPython 官方 ESP8266 入门教程嵌入式语言运行时编程语言解释器编译器物联网系统编程双击txt不再打开Notepad--了两步自检 分级修复路径找回文件关联双击txt不再打开Notepad 了两步自检 分级修复路径找回文件关联 双击一个txtNotepad 不再像以前那样弹出来而是跳到别的程序、或者干脆没桌面应用创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

Flow 中利用 match 表达式一次初始化多个变量:以 applyTheme 为主题的实战指南

Flow 中利用 match 表达式一次初始化多个变量:以 applyTheme 为主题的实战指南

开发工具静态分析代码质量 【免费下载链接】flow Adds static typing to JavaScript to improve developer productivity and code quality. 项目地址: https://gitcode.com/gh_mirrors/flow30/flow 点击查看 免费下载 本指南以 Flow(项目根目录&#x…

2026/9/20 18:08:11 阅读更多 →
SpringBoot智能仓储系统实战:从毕设到工业级落地

SpringBoot智能仓储系统实战:从毕设到工业级落地

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

2026/9/20 18:08:11 阅读更多 →
微信Windows旧版本回退指南:历史安装包获取、兼容性验证与数据迁移

微信Windows旧版本回退指南:历史安装包获取、兼容性验证与数据迁移

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

2026/9/20 18:08:11 阅读更多 →

最新新闻

Windows文件夹按日期分组怎么彻底关掉?WinSetView与注册表全解析

Windows文件夹按日期分组怎么彻底关掉?WinSetView与注册表全解析

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

2026/9/20 19:40:36 阅读更多 →
计算机程序设计员四级(中级)备考全攻略:从模拟卷到过线细节

计算机程序设计员四级(中级)备考全攻略:从模拟卷到过线细节

简介:这是一份面向计算机程序设计员国家职业资格四级(中级)考生的模拟试卷,内容围绕职业道德、法律法规、信息技术与职业标准等核心考核模块展开。通过理论选择题的形式,帮助考生熟悉考试题型与答题节奏,及…

2026/9/20 19:40:36 阅读更多 →
H8013A宽压降压芯片:100V耐压与高频恒压设计解析

H8013A宽压降压芯片:100V耐压与高频恒压设计解析

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

2026/9/20 19:40:36 阅读更多 →
CC-SDD 里的 Codex CLI 不走官方模型通道,改走 TaoToken 行不行?

CC-SDD 里的 Codex CLI 不走官方模型通道,改走 TaoToken 行不行?

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

2026/9/20 19:40:36 阅读更多 →
自建 MCP Server 给 WorkBuddy 调用,模型认证改填 TaoToken 行不行

自建 MCP Server 给 WorkBuddy 调用,模型认证改填 TaoToken 行不行

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

2026/9/20 19:40:36 阅读更多 →
MiniMax H3 IP Edition低配本地部署:ComfyUI极限调试与显存优化实战

MiniMax H3 IP Edition低配本地部署:ComfyUI极限调试与显存优化实战

1. 从一条发布消息说起:H3 IP Edition 到底在做什么MiniMax 发布 H3 IP Edition 这件事,如果只看新闻标题,很容易被归类成“又一个模型版本更新”。但把热词列表摊开看,你会发现大家真正关心的东西完全不在发布稿里——minimax h3…

2026/9/20 19:39:36 阅读更多 →

日新闻

Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化

Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化

直接铺开项目本身吧。这几个月我一直在折腾一件事:用Flutter给OpenHarmony做一款游戏集合类的App,说白了就是把若干小游戏塞进一个壳里,用统一入口分发。这个方向本身不算新鲜,真正让我花了不少心思的,是首页那堆游戏卡…

2026/9/20 0:00:46 阅读更多 →
Word表格编号全攻略:从列表编号到题注交叉引用

Word表格编号全攻略:从列表编号到题注交叉引用

写Word文档,最让人头疼的往往是那些“看起来不起眼”的小问题。比如表格编号这事:今天在表后面多加了两个空白行,明天给客户交稿前发现整个章节的编号全部错位,光是挨个改序号就能耗掉大半个下午。我前阵子帮人整理一份上百页的技…

2026/9/20 0:00:46 阅读更多 →
从第一个站到第二个站:独立开发者的静态网站选型与落地实践

从第一个站到第二个站:独立开发者的静态网站选型与落地实践

1. 项目概述1.1 核心需求解析做独立开发者这几年,说实话,第一个网站上线的那天晚上我兴奋得没睡着。但等它跑了半年,流量惨淡、功能臃肿、代码自己都懒得看第二遍之后,我才慢慢琢磨明白一个道理:第一个网站是练手&…

2026/9/20 0:00:46 阅读更多 →

周新闻

Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化

Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化

直接铺开项目本身吧。这几个月我一直在折腾一件事:用Flutter给OpenHarmony做一款游戏集合类的App,说白了就是把若干小游戏塞进一个壳里,用统一入口分发。这个方向本身不算新鲜,真正让我花了不少心思的,是首页那堆游戏卡…

2026/9/20 0:00:46 阅读更多 →
Word表格编号全攻略:从列表编号到题注交叉引用

Word表格编号全攻略:从列表编号到题注交叉引用

写Word文档,最让人头疼的往往是那些“看起来不起眼”的小问题。比如表格编号这事:今天在表后面多加了两个空白行,明天给客户交稿前发现整个章节的编号全部错位,光是挨个改序号就能耗掉大半个下午。我前阵子帮人整理一份上百页的技…

2026/9/20 0:00:46 阅读更多 →
从第一个站到第二个站:独立开发者的静态网站选型与落地实践

从第一个站到第二个站:独立开发者的静态网站选型与落地实践

1. 项目概述1.1 核心需求解析做独立开发者这几年,说实话,第一个网站上线的那天晚上我兴奋得没睡着。但等它跑了半年,流量惨淡、功能臃肿、代码自己都懒得看第二遍之后,我才慢慢琢磨明白一个道理:第一个网站是练手&…

2026/9/20 0:00:46 阅读更多 →

月新闻

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能分类:[AI/大模型]细分主题:AI 增强型 CI/CD 流水线自动化与 GitOps 实践:Agent 工作流、工具调用与任务拆解:从原型到生产的验收清单很多团队在尝试用大…

2026/9/19 23:01:36 阅读更多 →
容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场分类:[工程技术]细分主题:Kubernetes 生产环境运维与排障实战:可复制的项目复盘模板与决策记录大部分团队的事故复盘报告,最后都变成了躺在 Confluence 或钉…

2026/9/19 17:50:38 阅读更多 →
容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步分类:[工程技术]细分主题:Docker 容器化技术与镜像安全管理:核心链路的逐步实现与关键代码取舍面对一个积累了五六年历史包袱的单体架构应用(包含 Web 接口、后台…

2026/9/19 23:35:34 阅读更多 →