第一次把树莓派 Pico 插上电脑很多人会被那个突然弹出的 RPI-RP2 磁盘骗到以为它就是个 U 盘。实际上这块板子上的 Micro-USB 口背后是一整套 USB 1.1 设备控制器而 MicroPython 固件默认把它做成了“虚拟串口 大容量存储”的复合设备。这篇内容会把树莓派 Pico 的 USB 从硬件原理、外设架构到 MicroPython 软件控制完整过一遍顺带把我踩过的坑整理成排查手册。适合刚拿到 Pico 的新手也适合想拿它做 HID 键盘、DIY 外设的老玩家。1. 先说硬件Pico 的 USB 到底是什么水平1.1 RP2040 只有一个 Device 控制器别指望它当 Host很多第一次接触 Pico 的人会有一个直觉既然板子上有 USB 口那我能不能插个 U 盘上去答案是不行。RP2040 这颗芯片内部的 USB 外设是纯设备控制器Device Controller只能让 Pico 作为“外设”去连接电脑也就是扮演键盘、鼠标、串口、U 盘这种角色它没有 Host 控制器没办法主动去枚举和管理其他 USB 设备。这个定位和 STM32 的部分型号、ESP32-S3 都不一样。ESP32-S3 原生带 USB-OTG能切到 Host 模式去读 U 盘、接 USB 摄像头RP2040 则在硬件上就砍掉了这条路想让它当 Host 必须外扩芯片后面我会专门讲。所以玩 Pico 的 USB第一件事就是摆正预期它的方向是“被电脑使用”而不是“使用别人”。另外现在很多用 Type-C 接口的 RP2040 小板上能看到 CC 引脚和 5.1k 下拉电阻有些朋友会问“CC 有 5.1k 下拉怎么切主机模式”这里要澄清一下Type-C 的 CC 引脚电阻只是用来协商供电方向Source/Sink和角色5.1k 下拉表示这个设备是 Sink也就是被供电方。它和能不能当 USB Host 没有直接关系RP2040 本身的 USB 控制器就不支持 Host板子就算做成 Type-C、就算把 CC 改成上拉也切不出主机模式。1.2 Micro-USB 座子背后的电路D/D-、VBUS 检测与电源链路Pico 板上用的是 Micro-USB 座布局非常经典VBUS、D-、D、ID、GND 五个引脚其中 ID 悬空。D/D- 走的是 90 欧姆差分阻抗的 PCB 走线芯片内部有USB 收发器PHY不需要外部再挂 USB 转串口芯片——这一点特别容易被误解后面驱动问题我还会展开。在板级电路上USB 座子旁边一般会有共模电感或者 ESD 保护器件用来处理静电和信号干扰。D/D- 线上还串了 22 欧姆左右的电阻主要作用是抑制信号振铃、匹配阻抗降低全速模式下的波形畸变。这些是硬件工程师需要考虑的事对大多数用 MicroPython 开发的人来说只需要知道“板厂都帮你处理好了”不用自己去补电容电阻。VBUS 也并不是直接连到 RP2040 的 GPIO而是先经过一个二极管或负载开关进到 VSYS 网络再由板载电源芯片转出 3.3V。Pico 板上还有一个很关键的设计VBUS 检测脚通过分压电阻接到 GPIO24。这个引脚电平为高就说明外部 USB 电源已经接入固件可以通过读它来判断当前是不是被 USB 供电。板上还串了一个 500mA 的自恢复保险丝一旦后级短路或者电流过大保险丝会断开保护 USB 口等故障排除后又能自动恢复。1.3 全速 12Mbps 的限制CDC、HID、MSC 都能干UAC/UVC 别想RP2040 的 USB 控制器支持的是USB 2.0 Full Speed也就是 12Mbps不是 High Speed 的 480Mbps。很多新手看到“USB 2.0”字样就以为速度飞快实际上 Full Speed 和 High Speed 之间差了 40 倍。12Mbps 的实际可用带宽大概在 8~9Mbps 左右。跑虚拟串口、HID 键盘鼠标、MIDI、大容量存储这类设备绰绰有余但如果你想拿它做 USB 声卡UAC、USB 摄像头UVC这种需要实时传输大量数据的应用带宽不够只是其一更致命的是 RP2040 的 USB 外设不支持同步传输Isochronous Transfer。音频和视频类设备几乎都依赖同步端点来保证实时性所以 Pico 在这方面天生被砍了一刀别在这个方向上浪费时间。用一句话总结硬件定位Pico 的 USB 适合做“交互型”外设比如模拟键盘鼠标、虚拟串口、自定义 HID 控制面板但不适合做“数据流型”外设。2. 外设架构拆解枚举、端点和 TinyUSB2.1 设备枚举电脑是怎么“认识”Pico 的USB 设备不是插上就能用它和电脑之间要先进行一套“自我介绍”流程这个过程叫枚举Enumeration。大致流程是Pico 插进 USB 口之后主机检测到 D 线上被拉高知道有设备接入。然后主机向地址 0 发送一个GET_DESCRIPTOR请求设备返回自己的设备描述符包括 VID、PID、设备类型等。接着主机给设备分配一个新的地址再继续请求配置描述符、接口描述符、端点描述符和字符串描述符。拿到这一整套信息之后主机才知道“这玩意儿是什么设备、需要什么驱动、数据往哪个端点传”。这个流程用生活里的话说就是 Pico 在递简历先报名字设备描述符再说技能配置/接口描述符最后说怎么联系端点描述符。简历写得越标准电脑识别得越快。MicroPython 官方固件已经把这套简历模板写好了所以插上就能用不需要用户干预。如果你对协议细节有兴趣最直观的学习方式就是抓一次枚举的 USB 包后面第 5 节我会给具体操作步骤。抓一次包比看十篇协议文档都管用。2.2 端点与 DPRAM数据到底存在哪USB 通信的最小单位是端点Endpoint你可以把它理解成设备和主机之间的“邮箱”。PC 想给 Pico 发数据就投递到某个端点的邮箱里Pico 要给 PC 回数据也放在端点邮箱里等主机来取。RP2040 的 USB 外设提供了6 组端点对Endpoint Pair每个端点对包含 IN 和 OUT 两个方向。其中端点 0 固定用来做控制传输也就是枚举阶段的主通道。剩下 5 组端点可以配置成批量传输或中断传输分别对应虚拟串口、HID 这类应用。注意它不支持同步传输。这些端点的数据缓冲区并不在普通 RAM 里而是放在 USB 外设专用的DPRAM双端口 RAM中。固件要做的事就是把 DPRAM 划分成一块块缓冲区告诉硬件“端点 1 的缓冲区从地址 X 开始、大小是 Y”然后协议栈把待发送的数据填进去硬件就自动按 USB 时序发出去了。数据发完或者收到数据时硬件会触发中断CPU 再过来搬数据。这种设计把 USB 时序的实时压力从 CPU 手里解放了出来让主控能同时跑 MicroPython 解释器也不会丢包。2.3 TinyUSBPico 生态里真正的 USB 协议栈在 Pico 生态里几乎所有的 USB 功能都不是从零写的而是基于一个叫TinyUSB的开源协议栈。它是 Adafruit 团队主导的项目专门为嵌入式小系统设计代码精简支持设备模式也支持部分主机模式。Pico 官方 C SDK 默认集成了 TinyUSBMicroPython 官方固件底层也是拿 TinyUSB 实现 USB 功能的。MicroPython 的 rp2 移植版默认启用了CDC虚拟串口和MSC大容量存储两个类所以插上 Pico 之后电脑里会出现一个串口和一个可移动磁盘。TinyUSB 的可贵之处在于它把枚举、标准请求、类驱动这些琐碎的事情全部封装好了。如果你用 C 语言开发只需要调用tud_cdc_available()、tud_hid_keyboard_report()这类接口不用自己处理底层协议。对 MicroPython 用户来说TinyUSB 更像是“幕后团队”你通过 Python 层访问 USB 能力它负责把数据从 DPRAM 搬到电脑上。3. MicroPython 里怎么控制 USB三种现成姿势3.1 CDC 串口最简单的上位机通信MicroPython 固件默认把 USB 变成了一个虚拟串口这个串口在电脑上就是 COM 口Windows或者 /dev/ttyACM0Linux。它有三个作用跑 REPL 交互、打印日志、和上位机做数据通信。很多人以为 USB 串口只能用来写代码其实它完全可以作为 Pico 和电脑之间的一条“数据管道”。我来给一个最简单实用的例子让 Pico 接收电脑发来的命令控制板载 LED。先把代码写进 main.py然后用串口助手或 Python 的 pyserial 发送命令import sys import select from machine import Pin led Pin(LED, Pin.OUT) print(Ready, waiting for command...) while True: # MicroPython 中监控 USB CDC 是否收到数据 if select.select([sys.stdin], [], [], 0)[0]: cmd sys.stdin.readline().strip() if cmd on: led.value(1) print(LED ON) elif cmd off: led.value(0) print(LED OFF) elif cmd toggle: led.toggle() print(LED toggled)这里用select.select做非阻塞检查避免程序卡在读输入上。实测下来在 Thonny 的串口终端或任意串口助手里发送文本命令响应延迟基本感觉不到。这套机制完全可以扩展到传感器数据回传、上位机控制电机、调参等场景。注意一个坑MicroPython 的 REPL 和你的应用共用同一个 USB 串口。如果程序里大量print输出会拖慢 REPL 交互甚至和调试输出互相打架。做正式的上位机通信时推荐把“调试打印”和“数据协议”分开比如数据用二进制帧格式调试信息只在关键点打。3.2 大容量存储把 Pico 当“U 盘”用MicroPython 固件插入电脑后会出现一个名为RPI-RP2的磁盘这个就是 MSCMass Storage Class功能。它和真正的 U 盘有区别这不是独立的一块 Flash而是 RP2040 外接的 2MB QSPI Flash 被固件分出了一部分以 FAT 文件系统的方式暴露给电脑。这个功能最大的价值是“拖拽文件”式管理代码和资源。你在电脑上把 main.py 拖进磁盘Pico 重启后就会自动执行新的 main.py也可以把字库、配置文件、音频素材放到里面MicroPython 代码里用open()直接读取。我经常用它在现场快速换程序完全不需要额外的下载器或串口工具。这里有一个很实用的技巧如果需要频繁读写字库、日志这类大文件建议给 MSC 用“USB 弹出”功能先卸载再拔线避免文件缓存没写回导致损坏。Windows 上直接拔偶尔会提示磁盘未安全弹出Flash 文件系统一旦损坏固件可能反复重启这时候按住 Pico 板上的 BOOTSEL 键重新插线就能进入 bootloader 模式重新刷机问题基本能救回来。3.3 自定义 HID 键盘/鼠标官方 MicroPython 做不了CircuitPython 可以这是很多人的真实需求拿 Pico 做一个 HID 键盘自动输入密码或者做一个自定义按键面板。但这里必须说一个容易被忽略的事实官方 MicroPython rp2 移植版并没有向 Python 层开放自定义 HID 设备的接口。插上 Pico 时电脑看到的只有串口和 U 盘没有键盘。因为 TinyUSB 在编译固件时就固定好了描述符配置Python 层没有 API 能动态改设备描述符。想要 HID 功能目前最省力的路线是换CircuitPython。它是 MicroPython 的一个分支语法高度兼容但对 USB 设备层做了大量扩展内置usb_hid模块。刷入 CircuitPython 固件后磁盘会变成CIRCUITPY默认暴露的就是 HID 键盘/鼠标 串口 磁盘的复合设备。下面是一段非常经典的自动打字示例用它的adafruit_hid库可以直接模拟键盘输出import time import usb_hid from adafruit_hid.keyboard import Keyboard from adafruit_hid.keyboard_layout_us import KeyboardLayoutUS time.sleep(1) # 给电脑一点时间识别 HID kbd Keyboard(usb_hid.devices) layout KeyboardLayoutUS(kbd) layout.write(Hello from Pico!)把这段代码存成code.py把adafruit_hid库文件夹放进CIRCUITPY/lib插上电脑后等 1 秒就会自动打出那行字。设计按键面板、快捷输入器、模拟鼠标动作思路都一样查清楚对应 HID 报告格式用Keyboard、Mouse对象发报告就行。如果你对 MicroPython 有执念那只能走编译定制的路自己拉 MicroPython 源码在ports/rp2下修改 TinyUSB 的 tuc_config.h 和描述符文件启用 HID 类再把新固件烧进去。这个流程不是不能做但维护成本高社区的非官方 HID 固件又容易和最新 MicroPython 版本脱节不如直接切 CircuitPython 省心。4. Pico USB 不工作这份排查手册直接抄4.1 “设备描述符请求失败”的常见原因Windows 的 USB 设备管理器里出现“未知 USB 设备设备描述符请求失败”是 Pico 玩家最常遇到的问题。这个提示说明电脑没有从设备那里拿到合法的基础描述符绝大多数情况下不是 Pico 坏了而是下面几个原因。现象可能原因排查方法设备描述符请求失败供电不足或 USB 口老化换到电脑背面直连 USB 口不要经过 HUB 和延长线设备描述符请求失败线材只供电无数据换一根确认可传数据的短线很多廉价线只有电源线完全无反应固件崩溃或刷入损坏固件按住 BOOTSEL 键再插线进入 RPI-RP2 模式重新刷固件枚举成功但串口消失程序里禁用了中断或 USB 被软件关闭按住 BOOTSEL 重启或重新烧录官方固件我实测经验里线和供电占到了八成的故障原因。Pico 工作电流虽然只有几十毫安但劣质线材在传输数据时压降大、时序差很容易导致枚举中途失败。另外如果你用的是笔记本尽量插原生的 USB-A 口不要插扩展坞或前置 HUB这些地方的供电和信号完整性都打折扣。还有一种情况刷入了一个不完整的固件或者自己编译的固件有 bug 导致 USB 栈初始化失败。这时候只要按住 BOOTSEL 键插入 USB芯片会直接进入 ROM 引导状态不加载用户程序电脑上出现一个RPI-RP2磁盘把官方固件拖进去就能恢复。4.2 驱动乱象Pico 不需要 CH340/FT232 驱动有个现象特别有意思很多新手看到 Pico 串口号带感叹号就去网上搜驱动结果搜到一堆 CH340、FT232、FT231 的驱动下载页装上之后还可能把系统搞乱。这里必须澄清Pico 的 USB 是 RP2040 芯片直接提供的它不是 USB 转 UART 芯片。CH340、FT232、FT231 这类芯片是独立的“USB 转串口”解决方案常见于 Arduino 兼容板、USB-TTL 模块上。它们需要额外安装驱动而树莓派 Pico 插上后电脑看到的本来就是一个标准的 USB CDC 设备Windows 10/11、macOS、主流 Linux 发行版都自带驱动不需要手动装任何东西。如果在设备管理器里看到的是“串行设备”而不是“USB 串行设备”或者识别出 CH340/FT232 相关名字那基本可以确定你手上这不是原版 Pico而是把 USB 转串口芯片和 RP2040 分开了的设计。这种板子反而需要装对应芯片的驱动。买板子时如果对 USB 这块想省心尽量挑原生 USB 方案的开发板。4.3 供电是万恶之源VBUS 5V 真不能乱吸USB 口的标准供电能力是 5VUSB 2.0 默认 500mAUSB 3.0 默认 900mA。Pico 本身用电很少但不少人喜欢在 Pico 上外接舵机、继电器、LED 灯带这时候如果直接从 VBUS 取电问题就来了。我见过一个很典型的翻车案例有人用 Pico 控制 SG90 舵机直接把舵机电源并到 VBUS 上结果舵机启动瞬间电流超过 USB 口能力导致 Pico 瞬间掉电重启电脑反复提示“设备已断开/已连接”电池还在转程序却不断从头跑。舵机、电机、功放这类带感性负载的器件启动电流是稳态电流的好几倍远超 USB 的能力。网上还有人问 TDA2030 这类功放能不能用 USB 供电结论很明确别试音频功放瞬时电流轻松超过 1AUSB 口根本顶不住。正确的做法是外接一个 5V/2A 或更高功率的电源给执行器供电Pico 和外设共地把 GND 连在一起Pico 本身继续用 USB 供电或者同一个电源供电都行。控制信号线只负责传信号不承担功率。这样既稳定也避免因为电流拉垮 USB 总线导致 Pico 反复枚举。5. 深入玩转 Pico USB抓包、HOST 扩展和更多可能5.1 用 Wireshark 抓一次 USB 枚举比看十篇文档都管用很多教程把 USB 协议讲得云里雾里但如果你真的抓一次包几分钟就能建立起直觉。这里推荐两条路线Windows 上用Wireshark USBPcap。USBPcap 是 Wireshark 官方推荐的 USB 抓包驱动装好后以管理员身份打开 Wireshark选择 USBPcap 接口开始抓包再插拔一次 Pico。Linux 上用 Wireshark 直接监听usbmon接口或者在终端用tshark -i usbmon1抓。抓到的包里最值得看的几个环节先是主机发送的GET DESCRIPTOR请求Pico 返回 18 字节设备描述符然后是SET ADDRESS主机给 Pico 分配地址接着是GET DESCRIPTOR的配置描述符里面能看到接口数量和端点信息。整个过程只有几毫秒但视野里清清楚楚。我自己抓包之后最直观的感受是以前以为“枚举很神秘”其实它就是一连串有规律的标准请求。如果以后自己写 USB 设备遇到无法识别抓包能直接定位到是“设备没响应”还是“描述符内容不合法”比盲调强太多。5.2 Pico 真的不能当 USB Host 吗三条绕行路线RP2040 原生不支持 USB Host但如果你非要在 Pico 上用 U 盘、USB 键盘还是有绕行办法的只是代价不小。第一条路线是外扩 USB Host 控制器芯片常见的有 MAX3421E通过 SPI 接口连接控制权完全在 Pico 手里。这个方案实现难度不低驱动得自己写或者移植适合想深入了解 USB 协议栈的人。第二条路线是换一颗支持 USB Host 的芯片比如 ESP32-S3。它原生带 USB-OTG能直接接 U 盘、USB 摄像头甚至有人用它做简单的 USB 视频采集这也是网上“esp32-s3 usb摄像头”那么热的原因。如果你真正的需求是“单片机读写 U 盘”选 ESP32-S3 比折腾 Pico 外扩芯片靠谱得多。这里顺便提一句社区里有针对其他芯片的非官方 MicroPython 固件支持 USB Host但 RP2040 因为硬件没有 Host 控制器单纯换固件是解决不了的。第三条路线是使用 RP2040 的 PIO 外设模拟低速 USB Host。有人已经成功做到了让 Pico 读取低速 USB 键盘和鼠标但只能支持低速 1.5Mbps 的设备而且整套协议栈要自己在 PIO 里跑不是常规项目能接受的复杂度。我建议普通玩家看看热闹就好别轻易趟这条河。5.3 还能玩什么MIDI、手柄与复合设备Pico 的 USB 上限比很多人想的要高。如果你刷了 CircuitPython可以一行配置就把 Pico 变成 USB MIDI 设备接上电脑音乐软件就能当 MIDI 控制器也可以改 HID 描述符把它变成带 8 个按键、两个摇杆的游戏手柄玩模拟器非常爽。更进阶的方向是复合设备一个 Pico 插上电脑后同时是一个键盘、一个鼠标、一个串口、一个磁盘。这在定制输入设备的场景里极其有用比如做一个“按键宏面板”既能输出快捷键又能通过串口和电脑软件通信。实现上TinyUSB 的示例工程里就有composite参考C 语言开发比较直接CircuitPython 也能配置usb_hid的设备和usb_cdc的串口同时启用。我个人玩下来的最大体会是Pico 的 USB 是那种“上限不低、但需要你懂一点协议才能玩好”的外设。MicroPython 把门槛拉得很低插上就能用串口和磁盘但想突破官方固件的限制最终还是要回到描述符和 TinyUSB 这些底层内容。所以建议各位先把手头的 CDC 串口玩明白做完一次上位机通信再去试 HID 和抓包——USB 这东西看再多文档都不如自己插拔一次、抓一次包来得实在。
第一次把树莓派 Pico 插上电脑很多人会被那个突然弹出的 RPI-RP2 磁盘骗到以为它就是个 U 盘。实际上这块板子上的 Micro-USB 口背后是一整套 USB 1.1 设备控制器而 MicroPython 固件默认把它做成了“虚拟串口 大容量存储”的复合设备。这篇内容会把树莓派 Pico 的 USB 从硬件原理、外设架构到 MicroPython 软件控制完整过一遍顺带把我踩过的坑整理成排查手册。适合刚拿到 Pico 的新手也适合想拿它做 HID 键盘、DIY 外设的老玩家。1. 先说硬件Pico 的 USB 到底是什么水平1.1 RP2040 只有一个 Device 控制器别指望它当 Host很多第一次接触 Pico 的人会有一个直觉既然板子上有 USB 口那我能不能插个 U 盘上去答案是不行。RP2040 这颗芯片内部的 USB 外设是纯设备控制器Device Controller只能让 Pico 作为“外设”去连接电脑也就是扮演键盘、鼠标、串口、U 盘这种角色它没有 Host 控制器没办法主动去枚举和管理其他 USB 设备。这个定位和 STM32 的部分型号、ESP32-S3 都不一样。ESP32-S3 原生带 USB-OTG能切到 Host 模式去读 U 盘、接 USB 摄像头RP2040 则在硬件上就砍掉了这条路想让它当 Host 必须外扩芯片后面我会专门讲。所以玩 Pico 的 USB第一件事就是摆正预期它的方向是“被电脑使用”而不是“使用别人”。另外现在很多用 Type-C 接口的 RP2040 小板上能看到 CC 引脚和 5.1k 下拉电阻有些朋友会问“CC 有 5.1k 下拉怎么切主机模式”这里要澄清一下Type-C 的 CC 引脚电阻只是用来协商供电方向Source/Sink和角色5.1k 下拉表示这个设备是 Sink也就是被供电方。它和能不能当 USB Host 没有直接关系RP2040 本身的 USB 控制器就不支持 Host板子就算做成 Type-C、就算把 CC 改成上拉也切不出主机模式。1.2 Micro-USB 座子背后的电路D/D-、VBUS 检测与电源链路Pico 板上用的是 Micro-USB 座布局非常经典VBUS、D-、D、ID、GND 五个引脚其中 ID 悬空。D/D- 走的是 90 欧姆差分阻抗的 PCB 走线芯片内部有USB 收发器PHY不需要外部再挂 USB 转串口芯片——这一点特别容易被误解后面驱动问题我还会展开。在板级电路上USB 座子旁边一般会有共模电感或者 ESD 保护器件用来处理静电和信号干扰。D/D- 线上还串了 22 欧姆左右的电阻主要作用是抑制信号振铃、匹配阻抗降低全速模式下的波形畸变。这些是硬件工程师需要考虑的事对大多数用 MicroPython 开发的人来说只需要知道“板厂都帮你处理好了”不用自己去补电容电阻。VBUS 也并不是直接连到 RP2040 的 GPIO而是先经过一个二极管或负载开关进到 VSYS 网络再由板载电源芯片转出 3.3V。Pico 板上还有一个很关键的设计VBUS 检测脚通过分压电阻接到 GPIO24。这个引脚电平为高就说明外部 USB 电源已经接入固件可以通过读它来判断当前是不是被 USB 供电。板上还串了一个 500mA 的自恢复保险丝一旦后级短路或者电流过大保险丝会断开保护 USB 口等故障排除后又能自动恢复。1.3 全速 12Mbps 的限制CDC、HID、MSC 都能干UAC/UVC 别想RP2040 的 USB 控制器支持的是USB 2.0 Full Speed也就是 12Mbps不是 High Speed 的 480Mbps。很多新手看到“USB 2.0”字样就以为速度飞快实际上 Full Speed 和 High Speed 之间差了 40 倍。12Mbps 的实际可用带宽大概在 8~9Mbps 左右。跑虚拟串口、HID 键盘鼠标、MIDI、大容量存储这类设备绰绰有余但如果你想拿它做 USB 声卡UAC、USB 摄像头UVC这种需要实时传输大量数据的应用带宽不够只是其一更致命的是 RP2040 的 USB 外设不支持同步传输Isochronous Transfer。音频和视频类设备几乎都依赖同步端点来保证实时性所以 Pico 在这方面天生被砍了一刀别在这个方向上浪费时间。用一句话总结硬件定位Pico 的 USB 适合做“交互型”外设比如模拟键盘鼠标、虚拟串口、自定义 HID 控制面板但不适合做“数据流型”外设。2. 外设架构拆解枚举、端点和 TinyUSB2.1 设备枚举电脑是怎么“认识”Pico 的USB 设备不是插上就能用它和电脑之间要先进行一套“自我介绍”流程这个过程叫枚举Enumeration。大致流程是Pico 插进 USB 口之后主机检测到 D 线上被拉高知道有设备接入。然后主机向地址 0 发送一个GET_DESCRIPTOR请求设备返回自己的设备描述符包括 VID、PID、设备类型等。接着主机给设备分配一个新的地址再继续请求配置描述符、接口描述符、端点描述符和字符串描述符。拿到这一整套信息之后主机才知道“这玩意儿是什么设备、需要什么驱动、数据往哪个端点传”。这个流程用生活里的话说就是 Pico 在递简历先报名字设备描述符再说技能配置/接口描述符最后说怎么联系端点描述符。简历写得越标准电脑识别得越快。MicroPython 官方固件已经把这套简历模板写好了所以插上就能用不需要用户干预。如果你对协议细节有兴趣最直观的学习方式就是抓一次枚举的 USB 包后面第 5 节我会给具体操作步骤。抓一次包比看十篇协议文档都管用。2.2 端点与 DPRAM数据到底存在哪USB 通信的最小单位是端点Endpoint你可以把它理解成设备和主机之间的“邮箱”。PC 想给 Pico 发数据就投递到某个端点的邮箱里Pico 要给 PC 回数据也放在端点邮箱里等主机来取。RP2040 的 USB 外设提供了6 组端点对Endpoint Pair每个端点对包含 IN 和 OUT 两个方向。其中端点 0 固定用来做控制传输也就是枚举阶段的主通道。剩下 5 组端点可以配置成批量传输或中断传输分别对应虚拟串口、HID 这类应用。注意它不支持同步传输。这些端点的数据缓冲区并不在普通 RAM 里而是放在 USB 外设专用的DPRAM双端口 RAM中。固件要做的事就是把 DPRAM 划分成一块块缓冲区告诉硬件“端点 1 的缓冲区从地址 X 开始、大小是 Y”然后协议栈把待发送的数据填进去硬件就自动按 USB 时序发出去了。数据发完或者收到数据时硬件会触发中断CPU 再过来搬数据。这种设计把 USB 时序的实时压力从 CPU 手里解放了出来让主控能同时跑 MicroPython 解释器也不会丢包。2.3 TinyUSBPico 生态里真正的 USB 协议栈在 Pico 生态里几乎所有的 USB 功能都不是从零写的而是基于一个叫TinyUSB的开源协议栈。它是 Adafruit 团队主导的项目专门为嵌入式小系统设计代码精简支持设备模式也支持部分主机模式。Pico 官方 C SDK 默认集成了 TinyUSBMicroPython 官方固件底层也是拿 TinyUSB 实现 USB 功能的。MicroPython 的 rp2 移植版默认启用了CDC虚拟串口和MSC大容量存储两个类所以插上 Pico 之后电脑里会出现一个串口和一个可移动磁盘。TinyUSB 的可贵之处在于它把枚举、标准请求、类驱动这些琐碎的事情全部封装好了。如果你用 C 语言开发只需要调用tud_cdc_available()、tud_hid_keyboard_report()这类接口不用自己处理底层协议。对 MicroPython 用户来说TinyUSB 更像是“幕后团队”你通过 Python 层访问 USB 能力它负责把数据从 DPRAM 搬到电脑上。3. MicroPython 里怎么控制 USB三种现成姿势3.1 CDC 串口最简单的上位机通信MicroPython 固件默认把 USB 变成了一个虚拟串口这个串口在电脑上就是 COM 口Windows或者 /dev/ttyACM0Linux。它有三个作用跑 REPL 交互、打印日志、和上位机做数据通信。很多人以为 USB 串口只能用来写代码其实它完全可以作为 Pico 和电脑之间的一条“数据管道”。我来给一个最简单实用的例子让 Pico 接收电脑发来的命令控制板载 LED。先把代码写进 main.py然后用串口助手或 Python 的 pyserial 发送命令import sys import select from machine import Pin led Pin(LED, Pin.OUT) print(Ready, waiting for command...) while True: # MicroPython 中监控 USB CDC 是否收到数据 if select.select([sys.stdin], [], [], 0)[0]: cmd sys.stdin.readline().strip() if cmd on: led.value(1) print(LED ON) elif cmd off: led.value(0) print(LED OFF) elif cmd toggle: led.toggle() print(LED toggled)这里用select.select做非阻塞检查避免程序卡在读输入上。实测下来在 Thonny 的串口终端或任意串口助手里发送文本命令响应延迟基本感觉不到。这套机制完全可以扩展到传感器数据回传、上位机控制电机、调参等场景。注意一个坑MicroPython 的 REPL 和你的应用共用同一个 USB 串口。如果程序里大量print输出会拖慢 REPL 交互甚至和调试输出互相打架。做正式的上位机通信时推荐把“调试打印”和“数据协议”分开比如数据用二进制帧格式调试信息只在关键点打。3.2 大容量存储把 Pico 当“U 盘”用MicroPython 固件插入电脑后会出现一个名为RPI-RP2的磁盘这个就是 MSCMass Storage Class功能。它和真正的 U 盘有区别这不是独立的一块 Flash而是 RP2040 外接的 2MB QSPI Flash 被固件分出了一部分以 FAT 文件系统的方式暴露给电脑。这个功能最大的价值是“拖拽文件”式管理代码和资源。你在电脑上把 main.py 拖进磁盘Pico 重启后就会自动执行新的 main.py也可以把字库、配置文件、音频素材放到里面MicroPython 代码里用open()直接读取。我经常用它在现场快速换程序完全不需要额外的下载器或串口工具。这里有一个很实用的技巧如果需要频繁读写字库、日志这类大文件建议给 MSC 用“USB 弹出”功能先卸载再拔线避免文件缓存没写回导致损坏。Windows 上直接拔偶尔会提示磁盘未安全弹出Flash 文件系统一旦损坏固件可能反复重启这时候按住 Pico 板上的 BOOTSEL 键重新插线就能进入 bootloader 模式重新刷机问题基本能救回来。3.3 自定义 HID 键盘/鼠标官方 MicroPython 做不了CircuitPython 可以这是很多人的真实需求拿 Pico 做一个 HID 键盘自动输入密码或者做一个自定义按键面板。但这里必须说一个容易被忽略的事实官方 MicroPython rp2 移植版并没有向 Python 层开放自定义 HID 设备的接口。插上 Pico 时电脑看到的只有串口和 U 盘没有键盘。因为 TinyUSB 在编译固件时就固定好了描述符配置Python 层没有 API 能动态改设备描述符。想要 HID 功能目前最省力的路线是换CircuitPython。它是 MicroPython 的一个分支语法高度兼容但对 USB 设备层做了大量扩展内置usb_hid模块。刷入 CircuitPython 固件后磁盘会变成CIRCUITPY默认暴露的就是 HID 键盘/鼠标 串口 磁盘的复合设备。下面是一段非常经典的自动打字示例用它的adafruit_hid库可以直接模拟键盘输出import time import usb_hid from adafruit_hid.keyboard import Keyboard from adafruit_hid.keyboard_layout_us import KeyboardLayoutUS time.sleep(1) # 给电脑一点时间识别 HID kbd Keyboard(usb_hid.devices) layout KeyboardLayoutUS(kbd) layout.write(Hello from Pico!)把这段代码存成code.py把adafruit_hid库文件夹放进CIRCUITPY/lib插上电脑后等 1 秒就会自动打出那行字。设计按键面板、快捷输入器、模拟鼠标动作思路都一样查清楚对应 HID 报告格式用Keyboard、Mouse对象发报告就行。如果你对 MicroPython 有执念那只能走编译定制的路自己拉 MicroPython 源码在ports/rp2下修改 TinyUSB 的 tuc_config.h 和描述符文件启用 HID 类再把新固件烧进去。这个流程不是不能做但维护成本高社区的非官方 HID 固件又容易和最新 MicroPython 版本脱节不如直接切 CircuitPython 省心。4. Pico USB 不工作这份排查手册直接抄4.1 “设备描述符请求失败”的常见原因Windows 的 USB 设备管理器里出现“未知 USB 设备设备描述符请求失败”是 Pico 玩家最常遇到的问题。这个提示说明电脑没有从设备那里拿到合法的基础描述符绝大多数情况下不是 Pico 坏了而是下面几个原因。现象可能原因排查方法设备描述符请求失败供电不足或 USB 口老化换到电脑背面直连 USB 口不要经过 HUB 和延长线设备描述符请求失败线材只供电无数据换一根确认可传数据的短线很多廉价线只有电源线完全无反应固件崩溃或刷入损坏固件按住 BOOTSEL 键再插线进入 RPI-RP2 模式重新刷固件枚举成功但串口消失程序里禁用了中断或 USB 被软件关闭按住 BOOTSEL 重启或重新烧录官方固件我实测经验里线和供电占到了八成的故障原因。Pico 工作电流虽然只有几十毫安但劣质线材在传输数据时压降大、时序差很容易导致枚举中途失败。另外如果你用的是笔记本尽量插原生的 USB-A 口不要插扩展坞或前置 HUB这些地方的供电和信号完整性都打折扣。还有一种情况刷入了一个不完整的固件或者自己编译的固件有 bug 导致 USB 栈初始化失败。这时候只要按住 BOOTSEL 键插入 USB芯片会直接进入 ROM 引导状态不加载用户程序电脑上出现一个RPI-RP2磁盘把官方固件拖进去就能恢复。4.2 驱动乱象Pico 不需要 CH340/FT232 驱动有个现象特别有意思很多新手看到 Pico 串口号带感叹号就去网上搜驱动结果搜到一堆 CH340、FT232、FT231 的驱动下载页装上之后还可能把系统搞乱。这里必须澄清Pico 的 USB 是 RP2040 芯片直接提供的它不是 USB 转 UART 芯片。CH340、FT232、FT231 这类芯片是独立的“USB 转串口”解决方案常见于 Arduino 兼容板、USB-TTL 模块上。它们需要额外安装驱动而树莓派 Pico 插上后电脑看到的本来就是一个标准的 USB CDC 设备Windows 10/11、macOS、主流 Linux 发行版都自带驱动不需要手动装任何东西。如果在设备管理器里看到的是“串行设备”而不是“USB 串行设备”或者识别出 CH340/FT232 相关名字那基本可以确定你手上这不是原版 Pico而是把 USB 转串口芯片和 RP2040 分开了的设计。这种板子反而需要装对应芯片的驱动。买板子时如果对 USB 这块想省心尽量挑原生 USB 方案的开发板。4.3 供电是万恶之源VBUS 5V 真不能乱吸USB 口的标准供电能力是 5VUSB 2.0 默认 500mAUSB 3.0 默认 900mA。Pico 本身用电很少但不少人喜欢在 Pico 上外接舵机、继电器、LED 灯带这时候如果直接从 VBUS 取电问题就来了。我见过一个很典型的翻车案例有人用 Pico 控制 SG90 舵机直接把舵机电源并到 VBUS 上结果舵机启动瞬间电流超过 USB 口能力导致 Pico 瞬间掉电重启电脑反复提示“设备已断开/已连接”电池还在转程序却不断从头跑。舵机、电机、功放这类带感性负载的器件启动电流是稳态电流的好几倍远超 USB 的能力。网上还有人问 TDA2030 这类功放能不能用 USB 供电结论很明确别试音频功放瞬时电流轻松超过 1AUSB 口根本顶不住。正确的做法是外接一个 5V/2A 或更高功率的电源给执行器供电Pico 和外设共地把 GND 连在一起Pico 本身继续用 USB 供电或者同一个电源供电都行。控制信号线只负责传信号不承担功率。这样既稳定也避免因为电流拉垮 USB 总线导致 Pico 反复枚举。5. 深入玩转 Pico USB抓包、HOST 扩展和更多可能5.1 用 Wireshark 抓一次 USB 枚举比看十篇文档都管用很多教程把 USB 协议讲得云里雾里但如果你真的抓一次包几分钟就能建立起直觉。这里推荐两条路线Windows 上用Wireshark USBPcap。USBPcap 是 Wireshark 官方推荐的 USB 抓包驱动装好后以管理员身份打开 Wireshark选择 USBPcap 接口开始抓包再插拔一次 Pico。Linux 上用 Wireshark 直接监听usbmon接口或者在终端用tshark -i usbmon1抓。抓到的包里最值得看的几个环节先是主机发送的GET DESCRIPTOR请求Pico 返回 18 字节设备描述符然后是SET ADDRESS主机给 Pico 分配地址接着是GET DESCRIPTOR的配置描述符里面能看到接口数量和端点信息。整个过程只有几毫秒但视野里清清楚楚。我自己抓包之后最直观的感受是以前以为“枚举很神秘”其实它就是一连串有规律的标准请求。如果以后自己写 USB 设备遇到无法识别抓包能直接定位到是“设备没响应”还是“描述符内容不合法”比盲调强太多。5.2 Pico 真的不能当 USB Host 吗三条绕行路线RP2040 原生不支持 USB Host但如果你非要在 Pico 上用 U 盘、USB 键盘还是有绕行办法的只是代价不小。第一条路线是外扩 USB Host 控制器芯片常见的有 MAX3421E通过 SPI 接口连接控制权完全在 Pico 手里。这个方案实现难度不低驱动得自己写或者移植适合想深入了解 USB 协议栈的人。第二条路线是换一颗支持 USB Host 的芯片比如 ESP32-S3。它原生带 USB-OTG能直接接 U 盘、USB 摄像头甚至有人用它做简单的 USB 视频采集这也是网上“esp32-s3 usb摄像头”那么热的原因。如果你真正的需求是“单片机读写 U 盘”选 ESP32-S3 比折腾 Pico 外扩芯片靠谱得多。这里顺便提一句社区里有针对其他芯片的非官方 MicroPython 固件支持 USB Host但 RP2040 因为硬件没有 Host 控制器单纯换固件是解决不了的。第三条路线是使用 RP2040 的 PIO 外设模拟低速 USB Host。有人已经成功做到了让 Pico 读取低速 USB 键盘和鼠标但只能支持低速 1.5Mbps 的设备而且整套协议栈要自己在 PIO 里跑不是常规项目能接受的复杂度。我建议普通玩家看看热闹就好别轻易趟这条河。5.3 还能玩什么MIDI、手柄与复合设备Pico 的 USB 上限比很多人想的要高。如果你刷了 CircuitPython可以一行配置就把 Pico 变成 USB MIDI 设备接上电脑音乐软件就能当 MIDI 控制器也可以改 HID 描述符把它变成带 8 个按键、两个摇杆的游戏手柄玩模拟器非常爽。更进阶的方向是复合设备一个 Pico 插上电脑后同时是一个键盘、一个鼠标、一个串口、一个磁盘。这在定制输入设备的场景里极其有用比如做一个“按键宏面板”既能输出快捷键又能通过串口和电脑软件通信。实现上TinyUSB 的示例工程里就有composite参考C 语言开发比较直接CircuitPython 也能配置usb_hid的设备和usb_cdc的串口同时启用。我个人玩下来的最大体会是Pico 的 USB 是那种“上限不低、但需要你懂一点协议才能玩好”的外设。MicroPython 把门槛拉得很低插上就能用串口和磁盘但想突破官方固件的限制最终还是要回到描述符和 TinyUSB 这些底层内容。所以建议各位先把手头的 CDC 串口玩明白做完一次上位机通信再去试 HID 和抓包——USB 这东西看再多文档都不如自己插拔一次、抓一次包来得实在。
