为何yubikey-personalization要声明占用第0号USB接口？

核心原因 #

你看到的这行代码：

int rc = usb_claim_interface((usb_dev_handle *)dev, 0);

声明占用0号USB接口，本质是因为这个_ykusb_write()函数根本不是给2号智能卡（CCID）通道用的，它操作的是Yubikey复用在0号HID键盘接口上的旧配置通信通道。

具体说明 #

你贴的lsusb输出里列的3个接口，是Yubikey同时枚举的3个独立功能端，各自对应完全独立的功能，互不干扰：

• 0号接口：兼容Boot协议的HID键盘设备。这是Yubikey最早版本就有的核心接口，最广为人知的作用是模拟键盘输入输出OTP一次性密码，初代、二代Yubikey的所有配置指令通信，也是直接复用这个HID键盘接口完成的，不需要走智能卡协议。
• 1号接口：通用HID设备，对应FIDO/U2F认证功能，用来做网站、系统的无密码/二次验证。
• 2号接口：CCID智能卡设备，对应PIV证书、OpenPGP卡这类智能卡功能，走独立的ISO7816智能卡协议，和你现在看的这段旧HID通信逻辑完全无关。

你查看的yubikey-personalization库的这部分ykcore_libusb.c底层代码，是专门为兼容早期Yubikey的HID通信逻辑写的：

1. 这类旧款Yubikey不支持通过CCID接口发送配置指令，所有写配置、读状态的操作都必须通过0号HID键盘接口发送自定义HID报文实现，_ykusb_write()本身就是给这个HID通道写报文的函数，执行的第一步自然要先声明占用对应的0号接口。
2. 这个库里操作2号CCID智能卡接口的逻辑是完全独立拆分的，根本不会走_ykusb_write()这个HID路径，对应代码会单独声明占用2号接口，和你看到的这段逻辑不冲突。

关于设计约定 #

这个接口分配是Yubikey从初代产品就固定下来的兼容规范：

• 只要设备启用了OTP功能，0号接口固定为HID键盘接口，位置不会因为设备开启了FIDO、CCID、其他附加功能发生偏移，旧代码硬编码接口号0就是为了最大化兼容，不用额外枚举判断接口类型就能找到HID通信通道。
• 其余的FIDO、CCID接口属于后续新增功能，接口号可能根据设备启用的功能组合不同发生变动，不会做硬编码。

实际运行时也可以观察到，这段代码声明占用0号HID接口的时候，完全不会影响2号智能卡接口的正常使用——USB复合设备的不同接口是独立管理的，各自绑定独立的驱动，只要0号接口没有被其他进程独占，就能正常完成配置通信。

内容的提问来源于stack exchange，提问作者TheAlertGerbil