如何一键安装MicroPython驱动包,保姆级uPyPi教程全攻略?
摘要:像 pip 一样爽:搜包→复制命令→安装,传感器驱动(比如 BMP280)直接用,10 分钟搞定硬件联动。
uPyPi 平台下载和上传驱动包使用说明
一、快速安装驱动包
如果你是第一次接触 MicroPython 和 uPyPi 平台,不用担心!这份说明会从最基础的准备工作开始,一步步教你如何在树莓派 Pico2(无网络)和 Pico2W(有网络)上,从 uPyPi 平台下载并使用驱动包(以 bmp280_driver 气压温度传感器驱动为例)。同时也会简要介绍如何上传驱动包(方便有分享需求的使用者)。
1.1 零基础前置准备
在使用 uPyPi 之前,需要准备好硬件、软件,并完成基础设置,缺一不可。
1.1.1 硬件准备
硬件名称
用途
备注
任何支持mpy固件的单片机(如树莓派 Pico2 / Pico2W)
运行 MicroPython 代码的核心硬件
Pico2 无 WiFi 功能(需本地安装);Pico2W 带 WiFi 功能(可远程安装)
USB-C 数据线
连接开发板与电脑,传输代码 / 供电
需支持数据传输(充电线不可用)
BMP280 气压温度传感器模块(可选)或其他常见电子模块
测试驱动包的硬件
用于验证安装的 bmp280_driver 是否可用
杜邦线(若干)
连接开发板与传感器
需准备公对公 / 公对母杜邦线,根据接线需求选择
1.1.2 软件准备
安装 Thonny 编辑器:
Thonny 是最适合零基础的 MicroPython 开发工具,支持代码编写、开发板连接、文件管理。
下载地址:https://thonny.org/
安装方式:按系统提示下一步安装即可(默认设置无需修改)。
安装 mpremote 工具(电脑端)
这是电脑与 MicroPython 开发板通信的工具,用于本地安装驱动包(不支持联网功能的单片机必备)。
打开电脑的「命令提示符(CMD)」或「PowerShell」,输入以下命令并回车:
pip install mpremote
提示「Successfully installed mpremote」即安装成功。
1.2 开发板基础设置(烧录 MicroPython 固件)
你需要首先给你的 MCU 烧录一个 mpy 固件,这里我们以树莓派 Pico2 / Pico2W 为例,出厂无 MicroPython 固件,需先烧录才能使用。
按住开发板上的 BOOTSEL 按键,同时用 USB-C 线将开发板连接到电脑,松开按键。
电脑会识别出一个名为「RPI-RP2」的 U 盘。
打开浏览器,下载对应固件:
树莓派 Pico2 固件:https://micropython.org/download/RPI_PICO2/
树莓派 Pico2W 固件:https://micropython.org/download/RPI_PICO2W/
将下载的 .uf2 固件文件复制粘贴到「RPI-RP2」U 盘中。
复制完成后,开发板会自动重启,U 盘消失,此时固件烧录完成。
1.3 打开 uPyPi 平台搜索包和复制命令
uPyPi 平台是 MicroPython 驱动包的 “集散地”,我们可以在这里搜索、查看、下载需要的驱动包。
打开浏览器,访问 uPyPi 官网:https://upypi.net/
在页面顶部的搜索框中输入 bmp280,点击右侧「搜索」按钮:
搜索结果会显示匹配的驱动包(如 bmp280_driver 1.0.0),点击即可:
进入驱动包详情页,可在页面左侧切换驱动包版本:
页面左侧会显示核心安装命令(本地安装 / 远程安装):
3.4 下载并安装驱动包
根据开发板是否有网络,分为本地安装(Pico2) 和远程安装(Pico2W) 两种方式。
3.4.1 本地安装(适用于无 WiFi 的开发板)
通过 USB 连接电脑,用 mpremote 工具将 uPyPi 上的驱动包安装到开发板。
输入执行指令:
mpremote mip install https://upypi.net/pkgs/bmp280_driver/1.0.0
等待命令执行,终端出现以下内容,即安装成功:
我们也可以使用下面指令查看板内文件确认有没有下载成功:
# 查看根文件目录
mpremote fs ls
# 查看'lib/'文件夹下目录
mpremote fs ls 'lib/'
3.4.2 远程安装(适用于有 WiFi 的开发板)
先让开发板连接 WiFi,再直接在开发板的 REPL 终端中安装驱动包。
先用 USB 线将树莓派 Pico2W 连接到电脑,Thonny 自动识别后,点击底部「Shell」面板。
