MicroPython pyboard 入门指南:硬件布局、供电方式与首次上电

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),仅供参考