Linux USB/IP 驱动深度解析：虚拟主机控制器（vhci-hcd）的初始化与设备关联-开发者社区

1. Linux USB/IP 驱动概述

USB/IP 是 Linux 内核中一个非常实用的功能模块，它允许通过网络共享 USB 设备。想象一下，你可以把一台电脑上的 USB 摄像头"插"到另一台电脑上使用，就像直接连接一样。这背后的核心技术就是 USB/IP 驱动，而其中的核心组件就是虚拟主机控制器驱动 vhci-hcd。

这个驱动的工作原理其实很有趣。它创建了一个虚拟的 USB 主机控制器，就像在你的电脑里模拟了一个 USB 接口。当远程设备连接时，这个虚拟控制器会把它"伪装"成直接连接的设备。我在实际项目中用过这个功能来共享开发板，效果相当不错。

2. vhci-hcd 的初始化流程

2.1 驱动注册与平台设备创建

vhci-hcd 作为一个 platform 驱动，它的初始化从经典的模块初始化函数开始。让我们看看这个过程的代码实现：

static int __init vhci_hcd_init(void) { struct vhci *vhci; int ret; vhci = kzalloc(sizeof(*vhci), GFP_KERNEL); vhci->pdev = platform_device_alloc(driver_name, 0); ret = platform_device_add_data(vhci->pdev, &vhci, sizeof(void *)); ret = platform_driver_register(&vhci_driver); ret = platform_device_add(vhci->pdev); return ret; }

这段代码做了几件重要的事情：首先分配了 vhci 结构体内存，然后创建了平台设备，最后注册了平台驱动。这里有个巧妙的设计 - 通过 platform_device_add_data() 把 vhci 指针存入了平台设备，这样后续就能方便地获取这个数据结构。

2.2 关键数据结构解析

vhci-hcd 使用了几个核心数据结构来管理虚拟 USB 控制器：

struct vhci { spinlock_t lock; struct platform_device *pdev; struct vhci_hcd *vhci_hcd_hs; // USB 2.0控制器 struct vhci_hcd *vhci_hcd_ss; // USB 3.0控制器 }; struct vhci_hcd { struct vhci *vhci; u32 port_status[VHCI_HC_PORTS]; struct vhci_device vdev[VHCI_HC_PORTS]; // 其他成员... }; struct vhci_device { struct usb_device *udev; __u32 devid; __u32 rhport; struct usbip_device ud; // 其他成员... };

这些结构体形成了一个层次关系：vhci 是顶层结构，包含对平台设备和两个速度控制器的引用；vhci_hcd 管理具体的端口状态和设备；vhci_device 则代表每个虚拟 USB 设备实例。这种设计使得驱动能够灵活地管理多个虚拟设备和端口。

3. 驱动与 USB 核心框架的关联

3.1 probe 函数的执行流程

当平台驱动匹配到设备时，会调用我们注册的 probe 函数：

static int vhci_hcd_probe(struct platform_device *pdev) { struct vhci *vhci = *(void **)dev_get_platdata(&pdev->dev); struct usb_hcd *hcd_hs = usb_create_hcd(&vhci_hc_driver, &pdev->dev, dev_name(&pdev->dev)); hcd_hs->has_tt = 1; ret = usb_add_hcd(hcd_hs, 0, 0); // USB 3.0控制器初始化(省略) return ret; }

这个函数完成了虚拟主机控制器的创建和注册。其中 usb_create_hcd() 是关键，它创建了一个 USB 主机控制器驱动实例。我曾在调试时发现，如果忘记设置 has_tt 标志，会导致某些全速设备无法正常工作。

3.2 回调函数注册与实现

vhci-hcd 通过 hc_driver 结构体向 USB 核心框架注册了一系列回调函数：

static const struct hc_driver vhci_hc_driver = { .description = driver_name, .hcd_priv_size = sizeof(struct vhci_hcd), .flags = HCD_USB3 | HCD_SHARED, .reset = vhci_setup, .start = vhci_start, .stop = vhci_stop, .urb_enqueue = vhci_urb_enqueue, // 其他回调... };

这些回调函数构成了驱动的主要功能。比如 urb_enqueue 处理 USB 请求块的提交，hub_control 处理集线器控制请求等。在实际开发中，正确实现这些回调是确保驱动正常工作的关键。

4. 设备关联与对象查找机制

4.1 结构体间的相互引用

vhci-hcd 中有几个重要的结构体指针关联关系：

从 platform_device 可以通过 dev_get_platdata() 获取 vhci 指针
从 usb_hcd 可以通过 hcd_to_vhci_hcd() 获取 vhci_hcd 指针
vhci_hcd 中又保存着指向 vhci 的反向指针

这种相互引用关系看似复杂，但实际上是为了在不同上下文中能够方便地获取相关结构体。我在第一次阅读这段代码时花了些时间理清这些关系，但理解后就会发现它的设计很精妙。

4.2 container_of 的巧妙运用

Linux 内核中经常使用 container_of 宏来通过成员变量找到包含它的结构体。在 vhci-hcd 中也有类似技巧：

static inline struct vhci_hcd *hcd_to_vhci_hcd(struct usb_hcd *hcd) { return (struct vhci_hcd *)hcd->hcd_priv; }

这里利用了 usb_hcd 结构中的 hcd_priv 成员，它实际上指向了 vhci_hcd 结构。这种技术在 Linux 驱动开发中非常常见，是理解内核代码的重要模式。

5. sysfs 接口与控制机制

5.1 sysfs 属性组注册

在 vhci_start() 函数中，驱动注册了 sysfs 属性组：

err = sysfs_create_group(&hcd_dev(hcd)->kobj, &vhci_attr_group);

这使得用户空间可以通过 sysfs 文件系统与驱动交互。例如，/sys/devices/platform/vhci_hcd/ 下会出现各种控制文件，用户态工具通过这些文件配置虚拟控制器。

5.2 用户态控制接口

usbip 工具主要通过 sysfs 设置三个关键参数：

devid - 远程设备的唯一标识
speed - 设备速度(高速、全速等)
sockfd - 网络连接的文件描述符

这些参数设置后，驱动就知道如何与远程设备建立关联了。在实际使用中，我发现正确设置 speed 参数特别重要，否则会导致枚举失败。

6. 初始化回调函数详解

6.1 vhci_setup 函数分析

reset 回调函数 vhci_setup 主要完成以下工作：

static int vhci_setup(struct usb_hcd *hcd) { struct vhci *vhci = *(void **)dev_get_platdata(hcd->self.controller); if (usb_hcd_is_primary_hcd(hcd)) { vhci->vhci_hcd_hs = hcd_to_vhci_hcd(hcd); vhci->vhci_hcd_hs->vhci = vhci; hcd->speed = HCD_USB2; } return 0; }

这个函数建立了 vhci 和 vhci_hcd 之间的双向关联，并设置了控制器速度为 USB 2.0。注意这里对 primary_hcd 的判断，因为 USB 3.0 控制器会共享同一个驱动实例。

6.2 vhci_start 函数分析

start 回调函数做了更多初始化工作：

static int vhci_start(struct usb_hcd *hcd) { struct vhci_hcd *vhci_hcd = hcd_to_vhci_hcd(hcd); for (rhport = 0; rhport < VHCI_HC_PORTS; rhport++) { struct vhci_device *vdev = &vhci_hcd->vdev[rhport]; vhci_device_init(vdev); vdev->rhport = rhport; } // sysfs 初始化(省略) return 0; }

这里初始化了每个端口对应的 vhci_device 结构，包括自旋锁、等待队列和各种链表。我在调试时曾经遇到过端口初始化不完整导致设备无法识别的问题，后来发现是漏掉了某个链表的初始化。