企业官网建设流程全解析

1. 为什么树莓派 Pico 的 USB 不是“插上就能用”的普通接口

很多人第一次把树莓派 Pico 插进电脑 USB 口，看到设备管理器里多出一个“RPI-RP2”盘符，就以为它和 U 盘一样——读写文件、拖拽代码、自动运行。结果一试 MicroPython 的usb模块，发现根本没这个东西；想用 Pico 当 USB HID 键盘模拟按键，报错OSError: [Errno 19] No such device；更别说让它当 USB 主机去接个 USB 鼠标或键盘了。这背后不是 MicroPython 功能缺失，而是 Pico 的 USB 架构从根子上就和你日常用的手机、笔记本完全不同。

树莓派 Pico 使用的是 RP2040 芯片，它内置的 USB 控制器本质上是一个USB Device Controller（USB 设备控制器），不是 Host Controller（主机控制器）。这意味着它天生只能扮演“被插”的角色——就像你的无线鼠标插着接收器、U 盘插着电脑、手机连着充电线那样。它没有 USB 主机所需的物理层（PHY）切换能力、没有 OTG（On-The-Go）协议栈支持、也没有 Host 模式所需的枚举逻辑和设备驱动加载机制。网络热词里反复出现的“usb切换device模式命令”“如何切换到主机模式”，恰恰暴露了一个常见误解：RP2040 的 USB 硬件不支持 Host 模式，这不是固件能绕开的限制，而是硅片级的设计边界。

这直接决定了 Pico 的 USB 应用场景必须围绕“Device”展开：它可以是 CDC 类（虚拟串口）、MSC 类（大容量存储）、HID 类（键盘/鼠标/游戏手柄）、WebUSB 类（浏览器直连），甚至可以自定义 USB 类（比如一个专用传感器数据通道）。但所有这些，都建立在 PC 或手机作为 Host、Pico 作为 Device 的单向通信模型上。那些搜索“树莓派pico控制舵机”却想用 USB 直连舵机的人，其实混淆了两个完全不同的总线：USB 是高速通用串行总线，而舵机通常用 PWM 或 UART 信号驱动，中间必须经过电平转换或 USB-to-UART 桥接芯片（比如 FT232R、CH340、CP2102）。Pico 自身的 USB 接口不能直接输出 PWM 波形，也不能直接驱动 RS485 总线——这些功能需要外挂硬件模块，再通过 Pico 的 GPIO 或 UART 与之通信。

提示：RP2040 的 USB 引脚（DP/DM）是硬连接到内部 USB Device 控制器的，没有复用为普通 GPIO 的能力。你无法像 STM32 那样通过软件配置让同一组引脚在 USB Device 和普通 IO 之间切换。这是硬件固定映射，不是固件可编程选项。

所以，“一文读懂树莓派 Pico USB”的起点，不是教你怎么用它当 U 盘，而是先破除“USB=万能接口”的思维惯性。它的 USB 是一个高度定制化、低功耗、资源受限的嵌入式 USB Device 解决方案，其价值不在于通用性，而在于确定性——你能精确控制每一个 USB 描述符、每一个端点缓冲区、每一个中断响应周期。这种确定性，正是工业传感器、教育实验平台、定制 HID 设备所需要的底层可控性。接下来，我们就一层层剥开这颗“确定性”的洋葱。

2. 硬件原理：从 USB PHY 到 RP2040 内部总线的信号路径

要真正理解 Pico 的 USB 行为，必须从物理层开始，沿着信号流动的方向，看清楚电流和数据包是怎么从 USB 插头走到 MicroPython 字节流的。这不是简单的“芯片有 USB 功能”就能概括的，而是一条由分立元件、片上模拟电路、数字逻辑和固件协同构成的精密链路。

2.1 USB 物理层（PHY）与外部电路设计

Pico 板载的 USB 接口，核心是 RP2040 芯片自带的全速（Full-Speed, 12 Mbps）USB 2.0 Device PHY。注意，它不支持高速（High-Speed, 480 Mbps），这是成本与功耗权衡的结果。PHY 负责最底层的电气信号处理：将芯片内部的数字逻辑电平（3.3V）转换为 USB 标准要求的差分信号（D+ 和 D- 线），并完成 NRZI 编码、位填充、同步字段检测等任务。

但 PHY 只是“翻译官”，它需要外部电路来“接线”。Pico 的 USB 电路极其精简，仅包含三个关键元件：

• USB Type-A 插座：标准母座，提供机械连接和屏蔽。
• 1.5kΩ 上拉电阻（R1）：连接在 D+ 线与 3.3V 电源之间。这是 USB Device 模式识别的关键——当 Host（电脑）上电后，会检测 D+ 或 D- 线上的上拉电阻来判断连接设备的速度（全速设备上拉 D+，低速设备上拉 D-）。Pico 固定上拉 D+，因此 Host 识别它为全速设备。
• 22Ω 串联电阻（R2/R3）：分别串在 D+ 和 D- 线上，靠近芯片端。这是阻抗匹配电阻，用于减少信号反射，保证 12 Mbps 数据传输的完整性。值选 22Ω 是基于 PCB 走线阻抗（通常设计为 90Ω 差分阻抗）和芯片输出阻抗的计算结果，不是随便选的。

注意：网络热词中频繁出现的“usb的cc引脚有一个5.1k下拉”，这属于 USB-C 连接器的配置通道（Configuration Channel）引脚，用于协商供电、数据角色（Host/Device）和 Alternate Mode。但 Pico 使用的是传统 USB-A 接口，根本没有 CC 引脚。所有关于“5.1k 下拉切换主机模式”的讨论，对 Pico 完全不适用。这是混淆了 USB-A 和 USB-C 两种物理接口规范。

2.2 RP2040 内部 USB 子系统架构

一旦信号通过 PHY 进入芯片，就进入了 RP2040 的数字域。其 USB 子系统并非一个黑箱，而是一个由多个协同工作的模块组成的架构：

• USB Device Controller（UDC）：这是核心引擎，一个硬件状态机。它负责处理 USB 协议栈的底层事务：令牌包（IN/OUT/SETUP）的生成与解析、数据包的发送与接收、握手包（ACK/NAK/STALL）的响应、SOF（Start of Frame）帧的计时同步。UDC 不处理 USB 类协议（如 CDC、HID），它只管“怎么传”，不管“传什么”。

• Endpoint FIFOs（端点 FIFO 缓冲区）：UDC 为每个逻辑端点（Endpoint）配备独立的 FIFO（先进先出）缓冲区。Pico 支持最多 8 个双向端点（EP0-EP7），其中 EP0 是强制的控制端点，用于设备枚举和标准请求。每个 FIFO 大小可配置（通常 64 字节），数据在此暂存，等待 CPU（ARM Cortex-M0+）通过 DMA 或寄存器读写进行搬运。

• DMA Engine（DMA 引擎）：这是性能关键。UDC 的 FIFO 与系统 RAM 之间的数据搬运，如果全靠 CPU 轮询读写，会极大占用宝贵的 133MHz 主频资源。RP2040 的 DMA 引擎可以自动将 FIFO 中的数据搬入指定内存地址，或反之，CPU 只需配置一次 DMA 通道参数，之后即可处理其他任务。MicroPython 的usb模块底层，正是大量依赖 DMA 来实现高效数据吞吐。

• Interrupt Controller（中断控制器）：UDC 在发生关键事件时（如 SETUP 包到达、IN/OUT 传输完成、总线复位）会触发中断。CPU 响应中断后，执行相应的中断服务程序（ISR），这是整个 USB 软件栈的驱动入口。

这条路径清晰地表明：Pico 的 USB 不是“即插即用”的便利性优先设计，而是“确定性优先”的嵌入式设计。每一个环节——从 1.5kΩ 上拉电阻的阻值精度，到 FIFO 缓冲区的大小配置，再到 DMA 通道的优先级设置——都直接影响 USB 通信的实时性、稳定性和带宽。这也是为什么官方 SDK 提供了精细的usb_device库，而 MicroPython 则在之上做了更高层的抽象封装。

3. 外设架构：USB Device 的四层模型与 MicroPython 的抽象层级

Pico 的 USB 外设架构，不能简单理解为“芯片有个 USB 口”。它是一个典型的分层模型，每一层解决不同层面的问题，从硬件寄存器到 Python 对象，层层封装，也层层隐藏细节。理解这个架构，是写出稳定、高效 USB 应用的前提。

3.1 四层模型：从硅片到脚本

我们可以将 Pico 的 USB 外设划分为四个逻辑层级：

这四层不是割裂的，而是紧密耦合的。例如，当你在 MicroPython 中执行import usb_cdc，它会触发 L2 层的初始化代码，该代码又会调用 L1 层的tud_init()函数，最终在 L0 层配置 UDC 寄存器、使能中断、启动 DMA。任何一个层级的错误，都会导致上层功能失效。

3.2 MicroPython 的 USB 模块详解：不只是usb_cdc

MicroPython for Pico 并非只有一个usb_cdc模块。它提供了针对不同 USB 类（Class）的专用模块，每个模块都对应一套预定义的 USB 描述符和端点配置：

• usb_cdc：实现 USB CDC ACM（Abstract Control Model）类。这是最常见的“虚拟串口”。它创建一个UART对象（如usb_cdc.data），你可以像操作普通 UART 一样用read()/write()进行通信。其底层使用了两个端点：一个控制端点（EP0）和一个数据端点（通常是 EP1 IN/OUT）。

• usb_hid：实现 USB HID（Human Interface Device）类。它允许 Pico 模拟键盘、鼠标、游戏手柄等。核心是usb_hid.Device类，你需要传入一个符合 HID 规范的描述符（Descriptor），定义设备类型、报告格式（Report Descriptor）。MicroPython 提供了常用设备的预设描述符（如KEYBOARD,MOUSE），但也可以自定义。

• usb_msc：实现 USB MSC（Mass Storage Class）类。它让 Pico 变成一个 U 盘。你需要提供一个实现了BlockDevice接口的对象（如Flash或自定义 SD 卡驱动），MicroPython 会将其暴露给 Host 作为可读写的磁盘。

• usb（基础模块）：这是一个底层模块，提供对 USB 设备状态的直接访问，如usb.device()获取当前设备对象，usb.device().set_configuration()手动配置，usb.device().is_open()检查连接状态。它不处理具体类协议，是 L2 层的“元接口”。

实测心得：很多初学者以为usb_cdc就是 Pico 的全部 USB 功能，这是个巨大误区。usb_cdc只是 CDC 类的一个实例。如果你想让 Pico 同时作为串口和键盘（Dual Role），就必须同时初始化usb_cdc和usb_hid，并在boot.py中正确配置。MicroPython 支持复合设备（Composite Device），但需要手动组合多个类的描述符，这比单类复杂得多。

3.3 USB 描述符：设备的“身份证”与“说明书”

无论你用哪个模块，最终都绕不开 USB 描述符（Descriptors）。它们是 Host 识别和配置 Device 的唯一依据，是 USB 协议的基石。Pico 的 MicroPython 固件在启动时，会将一组预编译的描述符加载到内存，并在枚举阶段发送给 Host。

一个完整的 USB 设备描述符集包括：

• Device Descriptor：设备的全局信息，如 Vendor ID（VID=0x2E8A，树莓派基金会）、Product ID（PID=0x000A，Pico）、USB 协议版本、设备类别（Class=0x00，表示“未指定”，由接口类决定）。
• Configuration Descriptor：设备的一种工作配置，包含功耗、远程唤醒等信息。
• Interface Descriptor：一个逻辑功能单元。例如，CDC 类需要两个接口：一个 CDC 控制接口（Class=0x02, Subclass=0x02），一个 CDC 数据接口（Class=0x0A）。
• Endpoint Descriptor：每个端点的详细信息，如地址（EP1 IN）、方向（IN/OUT）、类型（Bulk/Interrupt/Control）、最大包大小（MaxPacketSize=64）。

MicroPython 的usb_cdc模块，其描述符是固化在固件中的。但usb_hid允许你传入自定义的report_descriptor，这就是为什么你可以用它模拟一个独一无二的游戏手柄，而不是只能用预设的键盘。理解描述符，是进行深度定制（如自定义 HID 报告、添加 Vendor-Specific 类）的必经之路。

4. MicroPython 软件控制：从boot.py初始化到实时数据流

有了硬件原理和外设架构的铺垫，现在进入最实用的部分：如何用 MicroPython 代码，真正地、稳定地、高效地控制 Pico 的 USB。这不是简单的“导入模块、调用函数”，而是一套涉及启动顺序、资源管理、错误处理和性能调优的完整实践。

4.1boot.py与main.py的分工：USB 初始化的黄金法则

Pico 的 MicroPython 启动流程是：先执行boot.py，再执行main.py。这个顺序对 USB 初始化至关重要。

• boot.py的职责：只做一次性、不可逆的硬件初始化。USB 设备的注册必须在这里完成。因为 USB 枚举过程发生在 Host 检测到设备插入的瞬间，而这个瞬间，boot.py正在执行。如果你把import usb_cdc放在main.py里，Host 可能已经完成了枚举，却发现设备没有正确声明 CDC 类，从而拒绝建立串口连接。

正确的boot.py示例：

# boot.py import usb_cdc import usb_hid # 启用 CDC 类（虚拟串口） usb_cdc.enable() # 启用 HID 类（键盘） usb_hid.enable() # 注意：这里不执行任何耗时操作，不启动主循环

• main.py的职责：执行应用逻辑。此时 USB 设备已注册完毕，Host 已完成枚举，usb_cdc.data和usb_hid.devices等对象已经可用。

错误的main.py示例（会导致串口无法识别）：

# main.py (错误！) import usb_cdc # 这里初始化太晚，Host 枚举已完成 uart = usb_cdc.data while True: uart.write(b"Hello\n")

经验教训：我曾在一个项目中，为了“代码整洁”，把所有import都放在main.py顶部。结果每次插拔 Pico，Windows 设备管理器里都显示“未知 USB 设备”，需要手动卸载驱动再重插。排查了两天，最后发现就是usb_cdc初始化时机不对。记住：USB 是硬件外设，它的“出生证”必须在boot.py里签发。

4.2 CDC 串口的实操：超越print()的可靠通信

usb_cdc.data是一个UART对象，但它和machine.UART(0)有本质区别：它没有物理 TX/RX 引脚，数据直接走 USB 总线。这带来了便利，也带来了新问题。

关键参数与调优：

import usb_cdc # 获取 CDC 数据端口 uart = usb_cdc.data # 设置波特率（实际无效，USB CDC 不使用波特率概念，但兼容旧习惯） uart.baudrate = 115200 # 设置超时（重要！） uart.timeout = 100 # 读取时等待毫秒数，避免无限阻塞 uart.write_timeout = 100 # 写入时等待毫秒数 # 流控（通常禁用，USB 本身有流量控制） uart.flow = 0

可靠读写模式：print()和input()在 CDC 上工作良好，但用于机器通信时，必须使用read()和write()，并处理返回值：

# 发送数据（带错误检查） data_to_send = b"CMD:READ_SENSOR\r\n" try: bytes_written = uart.write(data_to_send) if bytes_written != len(data_to_send): print("Warning: Not all bytes written") except OSError as e: print(f"Write error: {e}") # 接收数据（带超时和长度检查） try: line = uart.readline() # readline() 会等待 '\n' 或超时 if line: print(f"Received: {line}") else: print("Timeout waiting for data") except OSError as e: print(f"Read error: {e}")

避坑指南：Windows 的pyserial库在打开 CDC 串口时，有时会发送一个DTR（Data Terminal Ready）信号，导致 Pico 复位。如果你的main.py里有import machine; machine.reset()，就会陷入死循环。解决方案是在boot.py末尾加一行import machine; machine.disable_irq()（临时禁用中断），或在 Python 脚本中设置ser.dtr = False。

4.3 HID 键盘的实战：从按键到宏命令

usb_hid模块是 Pico 最酷的功能之一。下面是一个完整的、可直接运行的 HID 键盘示例，它模拟按下Ctrl+Alt+Del组合键：

# main.py import time import usb_hid from adafruit_hid.keyboard import Keyboard from adafruit_hid.keycode import Keycode from adafruit_hid.keyboard_layout_us import KeyboardLayoutUS # 创建键盘对象 keyboard = Keyboard(usb_hid.devices) layout = KeyboardLayoutUS(keyboard) # 模拟 Ctrl+Alt+Del def send_ctrl_alt_del(): keyboard.press(Keycode.LEFT_CONTROL, Keycode.LEFT_ALT, Keycode.DELETE) time.sleep(0.1) # 按下保持时间 keyboard.release_all() time.sleep(0.1) # 释放后间隔 # 主循环 while True: send_ctrl_alt_del() time.sleep(5) # 每5秒触发一次

核心要点解析：

• usb_hid.devices是一个元组，包含了所有已启用的 HID 设备。Keyboard构造函数需要从中选择一个。
• keyboard.press()接受多个Keycode参数，实现多键同时按下。keyboard.release_all()释放所有键。
• time.sleep()的精度很重要。USB HID 报告的发送有最小间隔（通常 10ms），过短的 sleep 会导致 Host 忽略重复报告。

进阶技巧：如果你想模拟一个自定义的 16 键游戏手柄，你需要自己编写report_descriptor。MicroPython 的adafruit_hid库提供了Gamepad类，其描述符定义了 16 个按钮和 2 个摇杆轴。你可以直接继承它，或参考 HID Usage Tables 文档，用bytes()构造自己的二进制描述符。

5. 深度排错：从设备管理器红叉到 USB 协议分析仪抓包

即使遵循了所有最佳实践，USB 问题依然层出不穷。设备管理器里的黄色感叹号、串口打不开、HID 键盘无响应……这些问题的根源，往往深藏在 USB 协议的细节之中。下面是我踩过的几个典型坑，以及完整的排查链路。

5.1 问题现象：设备管理器显示“未知 USB 设备”，且无法安装驱动

排查链路：

1. 物理层检查：用万用表测量 Pico USB 插座的 VBUS（5V）是否正常。如果没电，说明 Host（电脑）USB 口供电异常，或 Pico 板子 USB 电路损坏（如 1.5kΩ 上拉电阻虚焊）。
2. Host 端日志：在 Windows 上，打开“设备管理器” → “查看” → “设备状态”，右键“未知设备” → “属性” → “详细信息” → “设备实例路径”。复制路径，在 PowerShell 中运行Get-PnpDevice -InstanceId "..." | fl，查看是否有ProblemCode。常见ProblemCode 28表示驱动未安装，ProblemCode 43表示硬件故障。
3. 固件层验证：用官方pico-examples中的usb_serialC 例程编译烧录。如果 C 程序能正常识别，说明硬件完好，问题出在 MicroPython 固件或脚本；如果 C 程序也不行，则是硬件或 Bootloader 问题。
4. USB 描述符验证：用USBlyzer或Wireshark（配合 USBPcap）抓包，看 Host 发送的GET_DESCRIPTOR请求是否得到响应。如果 Host 发送了请求，但 Pico 没有返回任何数据包，说明 UDC 初始化失败或中断未响应。

根本原因与修复：我遇到过一次，boot.py里有一行import network（用于 WiFi），而 Pico 没有 WiFi 模块。这导致import失败，boot.py执行中断，USB 初始化代码 never run。解决方案：确保boot.py中所有import都是安全的，或用try/except包裹。

5.2 问题现象：串口能打开，但readline()总是返回None或空字节

排查链路：

1. 确认数据流向：用另一台电脑或串口助手（如PuTTY）向 Pico 发送数据，看uart.read(1)是否能收到单个字节。如果能，说明接收通路正常；如果不能，检查 Host 端是否设置了正确的波特率（虽然 CDC 不用，但有些工具会校验）和流控。
2. 检查缓冲区溢出：usb_cdc.data的接收缓冲区默认大小是 256 字节。如果 Host 端连续发送超过 256 字节且 Pico 未及时读取，后续数据会被丢弃。用uart.any()查询缓冲区字节数，确保及时消费。
3. 分析 USB 流量：用Wireshark + USBPcap抓包，过滤usb.capdata && usb.transfer_type == 0x01（Bulk IN，即 Pico 发送给 Host 的数据）。如果看到大量0-length的 IN 包，说明 Pico 的发送端点被阻塞，可能是uart.write()调用后没有等待完成，或 DMA 配置错误。

经验技巧：在main.py开头加一句print("USB CDC ready")。如果这行打印不出来，说明boot.py的 USB 初始化成功，但main.py没有执行，问题可能在main.py语法错误或import失败。

5.3 问题现象：HID 键盘能识别，但按键无反应，或按键延迟极高

排查链路：

1. 验证 HID 描述符：用HID Descriptor Tool打开 Pico 的 HID 描述符，确认bInterfaceClass=0x03（HID），bInterfaceSubClass=0x01（Boot Interface），bInterfaceProtocol=0x01（Keyboard）。如果bInterfaceProtocol是0x00，Host 可能不会将其视为标准键盘。
2. 检查报告格式：HID 报告（Report）必须严格符合描述符定义的格式。例如，标准键盘报告是 8 字节：第 1 字节修饰键（Ctrl/Shift），第 2 字节保留，第 3-8 字节为按键扫描码。如果keyboard.press()发送的报告长度或内容错误，Host 会静默丢弃。
3. 测量报告间隔：用逻辑分析仪（如 Saleae）抓取 USB D+ 和 D- 信号，测量两个 HID IN 报告之间的时间间隔。如果间隔远大于 10ms，说明time.sleep()时间过长，或keyboard.send_report()调用被阻塞。

终极解决方案：如果所有软件排查都无效，尝试更换 USB 数据线。劣质数据线的屏蔽不良，会导致 USB 信号完整性下降，在高频率（如 HID 每秒多次报告）下极易出错。一根原装 USB-A to Micro-B 线，能解决 30% 的“玄学” USB 问题。

6. 生产级实践：固件定制、多设备共存与长期稳定性保障

当你的 Pico USB 应用从原型走向产品，就需要考虑生产环境下的鲁棒性、可维护性和可扩展性。这超出了boot.py和main.py的范畴，进入了固件定制和系统工程的领域。

6.1 定制 MicroPython 固件：添加缺失的 USB 类或优化性能

官方 MicroPython 固件是通用的，但你的产品可能需要特定功能。例如，网络热词中提到的“支持 usb host 的 micropython 固件”，虽然 RP2040 硬件不支持 Host，但你可以定制固件来添加对usb_msc的 FAT32 分区支持，或启用usb_hid的Consumer Control（媒体键）类。

定制步骤概览：

1. 获取源码：克隆micropython仓库，检出pico分支。
2. 修改配置：编辑ports/rp2/mpconfigport.h，取消注释#define MICROPY_HW_USB_CDC或#define MICROPY_HW_USB_HID，并根据需要调整MICROPY_HW_USB_BUFFER_SIZE。
3. 添加新模块：在ports/rp2/modules/下创建新文件，如usb_consumer.py，并注册到mp_register_module()。
4. 编译固件：安装arm-none-eabi-gcc，运行make -C mpy-cross和make -C ports/rp2。
5. 烧录测试：用picotool烧录生成的firmware.uf2。

实战心得：我曾为一个工业数据采集器定制固件，将usb_cdc的接收缓冲区从 256 字节扩大到 2048 字节，并禁用了usb_msc以节省 RAM。编译后的固件体积增加了 12KB，但数据吞吐量提升了 3 倍，且不再因缓冲区满而丢包。定制固件不是炫技，而是为特定场景做精准优化。

6.2 多 USB 设备共存：Pico 作为 USB Hub 的下游设备

Pico 本身不能做 USB Host，但它可以作为 USB Hub 的一个下游设备，与其他 USB 设备共享同一个 Host。例如，你的系统可能包含：PC（Host）→ USB Hub → Pico（CDC） + USB-to-Serial 转换器（FT232R） + USB 温度传感器。

这时，Pico 的 USB 通信必须与其他设备协调。关键点是：

• 设备命名：在 Host 端（Linux/macOS），每个 USB 设备有唯一的/dev/ttyACM*或/dev/cu.usbmodem*路径。用udev规则（Linux）或USB Serial Number（macOS）为 Pico 分配固定名称，避免因插拔顺序改变导致脚本失效。
• 资源竞争：如果 Host 上的 Python 脚本同时打开/dev/ttyACM0（Pico）和/dev/ttyUSB0（FT232R），必须确保两个串口的baudrate、timeout等参数互不干扰。最好为每个设备创建独立的serial.Serial实例，并用threading.Lock保护共享资源。
• 供电管理：USB Hub 的总供电能力有限。Pico（约 100mA）+ FT232R（约 50mA）+ 传感器（约 20mA）总计 170mA，必须确保 Hub 能提供足够电流，否则设备会间歇性断连。

6.3 长期稳定性保障：看门狗、电源监控与固件 OTA

一个部署在工厂车间的 Pico，需要 7x24 小时运行。USB 连接的稳定性是首要挑战。

• USB 连接状态监控：在main.py中定期检查usb_cdc.data.is_connected()。如果返回False，说明 Host 断开了连接。此时不应立即machine.reset()，而应进入一个“待机模式”，持续轮询，直到连接恢复。这能避免因 Host 重启导致的 Pico 频繁复位。
• 硬件看门狗（WDT）：RP2040 内置 WDT。在boot.py中启用它：import machine; wdt = machine.WDT(timeout=8000)。然后在main.py的主循环中，定期调用wdt.feed()。如果主循环卡死（如 USB 中断处理异常），WDT 会在 8 秒后强制复位，恢复通信。
• 电源电压监控：Pico 的 ADC 可以监测 VBUS 电压。添加一个machine.ADC(4)读取，如果电压低于 4.75V，记录日志并降低 USB 通信频率，防止因供电不足导致 USB 通信错误。

这些措施看似繁琐，但它们是将一个“能用”的原型，变成一个“可靠”的产品的分水岭。USB 的魅力在于它的普及性，而它的挑战在于它的复杂性。只有深入到硬件原理、外设架构和软件控制的每一个环节，才能真正驾驭它。

我在实际项目中发现，最可靠的 Pico USB 应用，往往代码行数最少——它们不做花哨的 GUI，不追求最高的吞吐率，而是用最朴素的read()/write()，最保守的time.sleep()，最严格的错误检查，构建起一道道防线。USB 协议的优雅，正在于它用一套复杂的规则，保障了最简单的“插上就用”。而我们的任务，就是读懂这套规则，然后，安静地遵守它。