Arduino-ESP32项目中自定义USB HID设备的厂商和产品名称

在基于Arduino-ESP32平台开发USB HID设备时，开发者经常需要自定义设备在操作系统中显示的厂商名称和产品名称。默认情况下，ESP32设备会显示为"Espressif Systems"厂商和"TinyUSB HID"产品名称，这显然不能满足个性化开发需求。

为什么需要自定义设备信息

USB设备在连接主机时，会向操作系统报告一系列描述符信息，其中包括：

1. 厂商名称(Manufacturer Name) - 标识设备制造商
2. 产品名称(Product Name) - 标识具体产品型号
3. 序列号(Serial Number) - 设备唯一标识
4. 设备类(Device Class) - 标识设备类型

自定义这些信息对于产品品牌化、设备识别和多设备管理都非常重要。特别是在以下场景：

• 商业产品开发时需要展示自有品牌
• 同时连接多个同类设备时需要区分
• 驱动程序需要根据特定设备信息进行匹配

Arduino-ESP32的实现方法

Arduino-ESP32平台通过USB类提供了简洁的API来设置这些信息。在开发HID设备时，可以在USB初始化前调用以下方法：

#include <USB.h>

void setup() {
  USB.manufacturerName("自定义厂商名称");
  USB.productName("自定义产品名称");
  USB.serialNumber("设备序列号");
  USB.begin();
  
  // 其他初始化代码...
}

实现原理

在底层实现上，这些设置会修改USB设备描述符中的字符串描述符(String Descriptor)。USB协议规定字符串描述符使用Unicode编码，Arduino-ESP32的USB库会自动处理编码转换。

当设备连接到主机时，主机会请求这些字符串描述符，操作系统会根据获取到的信息显示相应的设备名称。修改这些信息不会影响设备的功能特性，只是改变了显示名称。

注意事项

1. 必须在USB.begin()之前设置这些属性，否则设置不会生效
2. 字符串长度不宜过长，一般不超过30个字符为宜
3. 某些操作系统会缓存设备信息，修改后可能需要重新插拔设备才能看到变化
4. 对于量产产品，建议为每个设备设置唯一序列号

通过这种简单的方式，开发者可以轻松实现USB HID设备的品牌化和个性化，提升产品的专业性和用户体验。