1. 项目概述为什么你的RP2040/2350板卡需要一个专属“身份证”如果你正在基于树莓派的RP2040或RP2350微控制器设计自己的开发板或产品那么“USB标识符”这个概念你迟早会碰到。这玩意儿说白了就是你的设备插上电脑后操作系统用来识别“你是谁”的一串数字和文字。听起来简单但这里面的门道直接关系到你的产品能否被正确识别、驱动能否自动安装甚至影响到用户体验的流畅度。我自己在做一些定制硬件项目时就曾因为忽略了USB标识符的配置导致在Windows上设备管理器里冒出一堆“未知设备”或者几个不同功能的板子被系统认成了同一个东西驱动打架调试起来一头雾水。所以今天咱们就掰开揉碎了聊聊基于RP2040/RP2350做板子关于USB Vendor ID (VID) 和 Product ID (PID) 的那些事儿以及什么时候你需要去申请一个独一无二的PID什么时候用“软”方法区分就够了。核心就两点VID是厂商代码好比是“树莓派有限公司”的工商注册号PID是产品代码好比是这家公司生产的“某某型号开发板”的备案号。树莓派很贴心地为RP2040/2350这类通用芯片的使用者开了一个绿色通道你可以申请使用树莓派的官方VID (0x2E8A)然后配上一个专属于你产品的PID。当然这不是必须的但有些情况下它就是那把关键的钥匙。2. USB标识符核心概念与树莓派生态的特别授权2.1 VID与PID硬件世界的“身份证号”与“产品型号”让我们先抛开代码用最直白的方式理解这两个ID。当你的设备通过USB线连接到电脑时在通信握手的最初几毫秒里设备会向主机你的电脑报告两个至关重要的16位十六进制数Vendor ID (VID) 和 Product ID (PID)。Vendor ID (VID) 由USB-IFUSB实施者论坛统一分配代表设备制造商。这是一个全球唯一的标识。例如树莓派基金会的VID是0x2E8A意法半导体ST的是0x0483微芯科技Microchip的是0x04D8。拥有自己的VID是件正式且有一定成本的事对于小团队或个人开发者来说直接申请一个VID并不总是最经济的选择。Product ID (PID) 由持有VID的厂商自行分配和管理用于区分自己旗下的不同产品。比如树莓派用0x0005可能代表Pico用0x1001可能代表Pico W。PID在厂商内部需要保持唯一。电脑操作系统尤其是Windows的驱动模型严重依赖这对 (VID, PID) 组合来为设备查找和加载正确的驱动程序。如果系统发现一个设备的 (VID, PID) 对在它的驱动库inf文件中有记录它就会尝试匹配安装如果没有就可能将其列为“未知设备”。2.2 树莓派的开放策略共享VID自定PID这里就体现了树莓派生态的友好之处。树莓派基金会从USB-IF获得了许可允许第三方基于RP2040或RP2350芯片设计和销售产品时使用树莓派的VID (0x2E8A)。这意味着你不需要自己去申请一个昂贵的VID就能让你做的板子拥有一个“官方认可”的厂商标识。但是PID需要你自己去申请一个唯一的。为什么不能大家都用同一个PID比如RP2040默认的0x0005呢想象一下如果市面上所有基于RP2040的板子都报告(VID0x2E8A, PID0x0005)那么在你的电脑上一个做键盘的板子和一个做数据采集的板子在系统看来就是完全相同的设备。这会导致驱动冲突系统无法为不同功能的产品加载不同的专用驱动。无法区分你的应用程序无法通过(VID, PID)可靠地找到特定的设备。用户体验差用户插上你的“高级产品”可能只被识别为普通的“Raspberry Pi Pico”。因此树莓派建立了一个USB PID仓库以自助、开源的方式让开发者可以免费申请一个属于自己产品的、唯一的PID。这个PID会与树莓派的VID (0x2E8A) 绑定使用。注意这个授权仅适用于使用RP2040或RP2350芯片的产品。如果你用的是树莓派官方的Pico模组那整块小电路板通常应继续使用官方为该模组分配的PID。这里的“自制板卡”指的是你从芯片开始自主设计PCB的板卡。2.3 字符串描述符设备的“名片信息”除了硬编码的VID和PIDUSB设备还可以通过字符串描述符提供更人性化的信息主要包括iManufacturer制造商名称字符串如 “My Awesome Gadgets Inc.”iProduct产品名称字符串如 “Quantum Sensor Board v2.0”iSerial序列号字符串如 “SN2024-0512-001”这些信息是文本形式的可以在设备管理器中看到也能被应用程序读取。它们对于用户在图形界面下区分设备非常有用。一个重要的特性是操作系统在判断设备是否“相同”时主要依据(VID, PID)但也会参考序列号(iSerial)。即使(VID, PID)相同只要iSerial不同系统也可能将其视为不同的设备实例。这为我们提供了一种不需要唯一PID的区分方案。3. 何时需要申请专属PID决策流程图与场景分析要不要去申请一个专属PID这取决于你的产品目标和目标平台。我们可以通过一个简单的决策流程来判断开始 ├─ 你的产品是否需要为Windows提供自定义驱动程序 (.inf, .sys) │ ├─ 是 → **必须申请唯一PID** (路径A) │ └─ 否 → 进入下一判断 ├─ 你的产品是否需要在任何操作系统上被软件通过(VID, PID)唯一地、可靠地识别 │ ├─ 是 → **强烈建议申请唯一PID** (路径B) │ └─ 否 → 进入下一判断 └─ 你是否可以接受仅通过制造商名、产品名、序列号等字符串来区分设备 ├─ 是 → **可以使用默认PID配合唯一字符串** (路径C) └─ 否 → 建议重新考虑路径B下面我们详细拆解这三种路径3.1 路径A必须申请PID的场景——Windows自定义驱动这是最硬性的要求。Windows的驱动安装机制核心依赖于硬件ID其标准格式就是USB\VID_XXXXPID_YYYY。如果你需要为你的设备开发一个专用的Windows内核驱动或安装一个特定的过滤驱动你必须在驱动的.inf文件中指定你的硬件ID。为什么不能用默认PID如果你使用RP2040的默认PID如0x0005那么你的.inf文件会声明它支持USB\VID_2E8APID_0005。问题来了所有使用这个默认PID的RP2040板卡包括官方的Pico在Bootloader模式下都会尝试加载你的驱动这必然导致冲突和系统不稳定。你的驱动可能会错误地接管其他完全无关的设备。实操影响没有唯一的PID你的自定义驱动将无法安全、精准地安装到你的设备上。Windows Update、驱动签名等高级功能也都需要唯一的硬件标识。案例你设计了一个基于RP2040的高速数据采集卡需要在Windows上实现一个高性能的专用驱动来保证低延迟数据传输。这种情况下你必须为你的采集卡申请一个专属PID例如0xC001并在驱动INF文件中使用USB\VID_2E8APID_C001。这样只有你的采集卡才会加载这个驱动。3.2 路径B强烈建议申请PID的场景——可靠设备识别即使你不做Windows驱动如果你的应用程序跨平台或Linux/macOS需要从多个USB设备中精准找到“你的那一个”唯一PID也是最干净、最可靠的方式。编程更简洁在代码中你可以直接通过(VID, PID)来枚举和筛选设备。几乎所有USB库如libusb, pyusb都提供基于VID/PID的过滤接口。代码逻辑清晰if (vid0x2E8A pid0xC001) { // 这就是我的设备 }。避免误操作在开发实验室里可能同时连接着多个不同类型的RP2040板卡。如果你的控制软件错误地连接到了一个正在调试其他功能的板子上可能会导致意外复位或数据错误。唯一的PID是防止这种“串台”的最有效硬件屏障。未来兼容性为产品预留一个唯一的PID是为未来的功能扩展比如某天需要Windows驱动或产品线细分基础版、专业版使用不同PID打下基础。案例你开发了一套基于多个RP2040节点的分布式传感器网络每个节点都是一个自制板。主机上的管理软件需要同时与所有节点通信。如果所有节点都用默认PID管理软件在枚举设备时将得到一堆VID/PID完全相同的设备只能依靠端口号来区分而端口号在设备重插后可能会变导致配置混乱。为每种节点类型如温度节点PID_0xA001湿度节点PID_0xA002分配唯一PID管理软件就能稳定、准确地识别和寻址每一个节点。3.3 路径C可使用默认PID的场景——字符串区分已足够对于很多简单的、功能性的项目或者产品初期原型申请唯一PID可能不是首要任务。如果你满足以下所有条件可以暂时使用默认PID设备使用标准USB类协议如HID-键盘鼠标、CDC-串口、MSC-U盘依赖操作系统自带的通用类驱动无需自定义驱动。用户或上层软件不需要通过(VID, PID)来硬性区分设备。例如设备作为通用串口CDC出现用户通过操作系统分配的COM端口号如COM3, COM4来区分即可。你有办法通过其他方式让设备在逻辑上可区分并且能接受其局限性。这时你可以充分利用USB字符串描述符设置唯一的iSerial这是最关键的一步。在固件中为每一片板子烧写一个唯一的序列号可以基于芯片内置的唯一ID生成。这样在电脑的设备管理器中即使两个板子VID/PID相同也会因为序列号不同而显示为两个独立的设备条目。设置明确的iManufacturer和iProduct让用户一眼就能看出这是什么产品。局限性分析软件识别依赖库支持你的应用程序如果想通过序列号来区分设备需要调用能读取USB字符串描述符的API。这比单纯过滤VID/PID稍复杂一点。某些系统工具可能不友好一些底层的系统配置工具或脚本可能只认硬件ID(VID/PID)。无法解决路径A的驱动问题。案例你制作了一批小礼物——基于RP2040的USB呼吸灯杯垫功能是插上电脑后通过HID协议控制灯光模式。它不需要特殊驱动用户也不关心设备ID只在乎灯光效果。这时使用默认PID (0x0005)并在固件里设置iProduct为“Glowing Coaster”iSerial为生产批号就完全足够了。简单省事。4. 实操指南如何申请树莓派旗下的USB PID如果你决定需要唯一PID那么申请过程是非常直接和开放的。树莓派通过一个GitHub仓库来管理PID的分配流程透明且免费。4.1 前期准备与信息确认在开始申请前请确保你的产品确实基于RP2040或RP2350芯片。这是使用树莓派VID (0x2E8A) 的前提。你已经有一个GitHub账户。因为申请流程需要通过GitHub提交Pull Request (PR)。想好你的产品名称和可选的产品URL。这些信息会被记录在公开的清单中。准备一个未被占用的PID。你需要去查看当前的PID分配列表从中选一个未被使用的。4.2 分步申请流程详解整个流程可以概括为Fork - 编辑 - 提交PR - 等待合并。第一步访问仓库并Fork打开树莓派官方的USB PID仓库https://github.com/raspberrypi/usb-pid请自行在浏览器中访问。点击右上角的“Fork”按钮将这个仓库复制到你自己的GitHub账户下。这相当于你获得了了一份申请表格的副本。第二步在本地编辑分配文件在你的Fork出来的仓库中找到usb-pid.md这个文件。这个文件是一个Markdown格式的表格记录了所有已分配的PID、申请者、产品名等信息。 你需要做的是在表格的末尾新增一行。填写以下信息PID (hex) 你选择的PID格式为0xXXXX。建议从表格后面未被使用的区域选择例如0xC000之后的号码。避免使用0x0000到0x000F以及0x5xxx、0x9xxx等已有明确说明的保留范围。Requester / GitHub ID 你的GitHub用户名。Product Name 你的产品名称如 “CyberDuck Debug Probe”。Product URL (optional) 产品介绍页面可选。Notes (optional) 任何补充说明可选。示例假设你的GitHub用户是techMaker42产品是“Quantum Sensor Board”你选择了PID0xC123。 那么你添加的行应该类似| 0xC123 | techMaker42 | Quantum Sensor Board | https://example.com/qsb | For environmental data logging |重要提示编辑时请严格遵守现有表格的格式确保管道符|对齐。一个格式错误可能导致自动化检查失败。第三步提交Pull Request编辑并保存好usb-pid.md文件后在你的GitHub仓库页面会提示你有更改。按照流程提交更改Commit然后回到原仓库raspberrypi/usb-pid的主页。通常这里会有一个醒目的提示让你为你刚Fork的仓库提交一个“Pull Request”。点击它创建一个PR。 在PR的描述中可以简要说明你的产品和申请理由例如“Requesting PID 0xC123 for the Quantum Sensor Board based on RP2040.”第四步等待审核与合并树莓派的维护者会审核你的PR。这个过程通常是人工进行的可能需要几天时间。只要你的申请符合要求基于RP芯片PID未被占用信息完整一般都会被合并。合并后你的PID就正式被分配了全世界都可以在那个公开的usb-pid.md文件中看到。4.3 在固件中配置你的专属PID申请到PID后下一步就是将其固化到你的设备固件中。具体方法取决于你使用的开发框架。对于使用树莓派官方SDK (Pico SDK) 的项目在项目的CMakeLists.txt文件中你需要设置编译定义。最关键的是在target_compile_definitions或pico_add_extra_outputs的PICO_USB_VID和PICO_USB_PID参数。# 在 add_executable 之后pico_add_extra_outputs 之前或之中设置 target_compile_definitions(your_target_name PRIVATE PICO_USB_VID0x2E8A PICO_USB_PID0xC123 # 你申请到的PID )或者更常见的做法是在pico_sdk_import.cmake之后直接全局设置set(PICO_USB_VID 0x2E8A) set(PICO_USB_PID 0xC123)同时别忘了设置字符串描述符这通常在CMakeLists.txt或专门的配置头文件中完成set(PICO_USB_MANUFACTURER My Company) set(PICO_USB_PRODUCT Quantum Sensor Board) # 序列号可以留空SDK会自动使用芯片唯一ID生成一个你也可以自定义。 # set(PICO_USB_SERIAL_NUMBER SN-001)对于使用Arduino框架 (通过Arduino-Pico核心) 的项目你需要修改boards.txt或创建/修改平台本地配置。更简单通用的方法是在你的Arduino代码中于setup()函数之前通过USBProduct和USBManufacturer宏来覆盖默认设置并非所有核心版本都支持。最可靠的方法是修改你所使用的“板型”定义。 通常在Arduino-Pico核心的安装目录下找到variants/your_board/目录编辑其中的pins_arduino.h或variant.cpp文件查找并修改USB_VID,USB_PID,USB_MANUFACTURER,USB_PRODUCT等定义。对于使用MicroPython或CircuitPython你需要编译自定义的固件。在编译前需要修改端口配置文件。以RP2040端口的MicroPython为例你需要找到ports/rp2/目录下的mpconfigboard.h或mpconfigboard.cmake文件修改其中的#define MICROPY_HW_USB_VID (0x2E8A) #define MICROPY_HW_USB_PID (0xC123) #define MICROPY_HW_USB_STR_MANUFACTURER My Company #define MICROPY_HW_USB_STR_PRODUCT Quantum Board #define MICROPY_HW_USB_STR_SERIAL_NUMBER (NULL) // 或自定义生成函数然后重新编译整个MicroPython固件并烧录。实操心得无论用哪种框架修改后第一次烧录固件前务必断开板子的USB线然后按住BOOTSEL按钮再上电进入UF2下载模式后再连接USB。这是因为如果旧的固件正在运行它可能占用USB接口导致新固件无法正确枚举。进入下载模式可以确保USB接口由Bootloader控制从而顺利烧写新固件。5. 常见问题排查与调试技巧实录即使配置正确在实际操作中也可能遇到各种问题。下面是我在项目中踩过的一些坑和解决方法。5.1 设备枚举失败或显示为“未知设备”现象板子烧录新固件后插上电脑设备管理器里显示黄色感叹号的“未知设备”或者干脆没有反应。排查步骤检查物理连接换条USB线换台电脑USB口试试。劣质USB线或供电不足的端口是常见罪魁祸首。验证VID/PID配置确认固件中设置的VID和PID值格式正确十六进制0x前缀。一个常见的低级错误是把0x2E8A写成2E8A缺少0x编译器可能不会报错但生成的常量值完全不对。查看设备具体信息在Windows设备管理器中右键“未知设备” - “属性” - “详细信息” - “属性”下拉框选择“硬件Id”。你应该能看到类似USB\VID_2E8APID_C123REV_0100的字符串。检查这里的VID和PID是否与你设定的一致。如果不一致说明固件配置未生效。在Linux下使用lsusb命令。你应该能看到一行记录例如Bus 003 Device 005: ID 2e8a:c123 Raspberry Pi Ltd.。这里的2e8a:c123就是VID:PID。检查描述符如果VID/PID正确但仍是未知设备可能是USB描述符设备描述符、配置描述符等配置有误。使用USB分析工具如USBTreeView(Windows)、lsusb -v(Linux) 可以查看设备报告的所有描述符信息对比与标准USB规范的差异。5.2 多个相同PID设备无法区分现象插上两个使用相同默认PID的自制板系统只识别出一个或者应用程序无法分别访问它们。解决方案与技巧确保iSerial唯一这是解决此问题成本最低的方法。在固件中务必为每个设备生成或烧写唯一的序列号。RP2040 SDK默认会使用芯片的独一无二的序列号从Flash中读取作为USB序列号这通常能保证唯一性。你需要确认你的固件启用了这个功能。应用程序端使用复合条件在你的主机端软件中不要仅用VID/PID来查找设备。使用能获取设备路径、总线号、端口号或序列号的API。例如在libusb中当你枚举到设备后可以打开设备句柄然后使用libusb_get_string_descriptor_ascii函数读取其序列号字符串再根据序列号来区分。终极方案如前所述为不同产品甚至同一产品的不同版本分配不同的PID是从根本上杜绝混淆的方法。5.3 驱动安装错误或冲突现象为自定义PID的设备安装了INF驱动但设备管理器显示“驱动程序错误”或安装了错误的驱动。排查步骤检查INF文件硬件ID用文本编辑器打开你的.inf文件找到[Standard.NT$ARCH$]或类似章节下的%DeviceName%DeviceInstall, USB\VID_2E8APID_C123这一行。确保这里的PID与你设备固件中的PID完全一致一个字符都不能差。检查驱动签名对于现代Windows如Win10/11 64位未签名的驱动在默认安全设置下无法安装。你需要要么禁用驱动强制签名仅用于测试要么使用测试证书对驱动进行签名要么购买正式代码签名证书。彻底卸载旧驱动如果之前安装过错误或旧版本的驱动可能会导致冲突。使用设备管理器“卸载设备”时勾选“删除此设备的驱动程序软件”。也可以使用像“Driver Store Explorer”这样的工具来清理驱动程序存储缓存。查看安装日志在设备管理器中选择设备查看其“事件”选项卡里面可能有驱动安装失败的详细原因记录。5.4 PID申请被拒绝或合并延迟现象提交的PR长时间未被处理或被关闭。可能原因与应对PID冲突你选择的PID已经被别人申请了。在提交PR前务必仔细查看usb-pid.md文件的最新版本确认你选的PID是空的。格式错误你编辑的表格行格式不对导致自动化检查失败。在本地用Markdown预览工具检查一下确保管道符对齐没有多余的空格或制表符。信息不全产品名称过于模糊如“My Board”或者GitHub账号信息可疑。提供清晰的产品名和如果可能产品链接。非RP2040/2350项目如果你申请的PID用于非树莓派这两款芯片的产品申请会被拒绝。维护者繁忙开源项目维护全靠志愿者延迟几天甚至一两周是正常的。耐心等待即可如果超过一个月没有任何动静可以礼貌地在PR下留言询问。调试利器推荐USBTreeView(Windows) 神器级别的免费工具以树形结构完整展示所有USB主机控制器、集线器和设备能查看详细的设备描述符、配置描述符以及当前加载的驱动信息。是诊断USB问题的一站式工具。lsusb(Linux/macOS) 终端命令lsusb列出设备lsusb -v显示详细信息包括描述符。结合grep可以快速过滤。WiresharkUSBPcap(Windows) 如果需要深入分析USB通信协议层面的问题这个组合可以捕获USB总线上的原始数据包但设置稍复杂。串口调试输出 在固件开发初期可以通过板载的UART输出调试信息例如打印出当前设置的VID/PID这是验证配置是否被正确编译和加载的最直接方法。
