本文还有配套的精品资源,点击获取 menu-r.4af5f7ec.gif

简介:Linux USB驱动程序是连接Linux系统与USB设备的桥梁,负责识别、管理和通信。本文档“Linux-usb-driver-examples.zip”提供了多个USB驱动实例,用于帮助开发者理解USB驱动原理,并提供可编译使用的代码。内容涵盖USB设备枚举、设备描述符、类驱动、USB接口与端点、驱动编程、数据传输、热插拔处理、驱动编译与加载以及设备模拟等方面的实践知识。开发者通过学习这些示例,能够掌握编写、调试和优化USB驱动程序的技能。
Linux-usb-driver-examples.zip_linux usb驱动

1. Linux USB驱动程序简介

在当今的IT生态系统中,USB(通用串行总线)技术已成为连接和交换数据的基石。Linux操作系统在USB支持方面表现卓越,提供了强大的驱动程序和工具集,以支持各种USB设备。本章将带领读者初步了解Linux下的USB驱动程序,从基础概念讲起,为后续章节深入探讨USB设备枚举、驱动编程技术和数据传输方法等打下坚实基础。

Linux USB驱动程序不仅仅是一个单一的软件组件,而是一整套软件解决方案,它涉及内核模块、用户空间库和应用程序接口(API)。驱动程序负责管理USB设备的接入和通信,并且为用户提供可操作的接口。无论是简单的USB键盘、鼠标,还是更复杂的设备如3D打印机和外部存储,Linux系统都能够通过相应的驱动程序提供支持。

驱动程序的开发涉及对USB协议和Linux内核API的深入理解,同时也需要掌握设备的硬件规范和通信协议。为了编写有效的Linux USB驱动程序,开发者通常需要对以下方面有所了解:

  • USB规范:涉及USB协议的各个层次和特性。
  • Linux内核:特别是USB核心子系统及其提供的抽象层。
  • 设备硬件:不同设备有不同的硬件描述和特定的配置需求。

接下来的章节中,我们将逐步深入探索USB驱动程序的各个方面,从枚举流程到驱动编程技术,从数据传输到热插拔处理,从编译加载到模拟测试,为读者揭示Linux USB驱动程序的神秘面纱。

2. USB设备枚举流程

2.1 枚举过程概述

2.1.1 USB主机与设备的初始通信

当USB设备被接入计算机,USB主机(即计算机)通过检测是否有设备接入来开始初始通信。这一过程通常涉及到对总线上的数据包进行监听,以识别任何新设备的出现。USB总线上的设备会通过一系列初始化的握手信号,以确保双方都准备好进行通信。

USB设备枚举的第一步,主机控制器会发出复位信号(Reset),将设备置于默认状态。设备响应后,主机读取设备的基本信息,这些信息包括在设备描述符中。设备描述符包含了诸如设备类型、所支持的速度、最大包大小等关键信息。

2.1.2 设备地址分配与配置过程

一旦主机获取了设备描述符,主机控制器就会分配一个唯一的地址给设备。这个地址用于后续所有与该设备的通信。地址分配之后,设备处于默认通道状态,只能接收标准请求。

地址分配之后,进入配置过程。在此阶段,主机根据设备描述符中的信息,读取配置描述符,并将选定的配置信息写入设备。一个USB设备可能支持多个配置,每个配置都允许设备执行不同的功能或以不同的方式操作。

2.2 枚举过程中的关键步骤

2.2.1 高速设备的枚举

高速设备(如USB 2.0及以上版本的设备)具有更复杂的需求和通信协议。高速设备枚举时,主机需要确保正确的时钟同步,并启用高速操作所需的端点。高速设备初始化时,需要进行端点测试,验证端点可以处理高速传输。

2.2.2 全速与低速设备的枚举

全速和低速设备枚举相对简单。全速设备(如USB 1.1设备)的操作速率比高速设备低,但比低速设备快。低速设备如USB键盘、鼠标等,其最大数据传输速率限制在1.5 Mbps。枚举过程中,主机控制器会根据设备类型设置合适的数据传输速率。

2.2.3 设备端点的配置与测试

端点是USB通信的基本单元,每个端点有一个唯一的地址,并且可以配置为不同的传输类型,如批量、中断或等时传输。端点的配置包括设置端点的最大包大小以及端点的传输速率。测试则确保端点可以正确接收和发送数据包。

为了展示以上内容,下面通过一段示例代码来展示如何在Linux环境下查看USB设备的枚举情况:

lsusb

执行上述命令后,会列出系统中所有已枚举的USB设备,例如:

Bus 002 Device 005: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
Bus 002 Device 003: ID 046d:c52b Logitech, Inc. Unifying Receiver
Bus 002 Device 002: ID 8087:8000 Intel Corp.
Bus 002 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub

每行信息包含了设备的总线号和设备号、厂商ID和产品ID、以及设备的描述。这些信息有助于开发者理解设备连接到系统时USB驱动如何进行枚举。

sudo lsusb -v

执行此命令,输出将包括设备的详细信息,其中就包括了设备的描述符信息。通过分析这些信息,开发者可以了解设备的枚举细节,并进一步为设备开发或调试USB驱动程序。

通过上述命令和对应的分析,我们可以对USB设备在Linux环境中的枚举过程有一个初步的认识,从而为深入理解USB设备的枚举流程打下基础。

3. 设备描述符解析

3.1 设备描述符的作用

3.1.1 识别USB设备信息

USB设备描述符是USB设备通信中的关键组件,它提供了关于设备本身的信息,以便USB主机能够识别设备并据此建立通信。USB设备描述符包含了一系列的字段,用于标识设备类型、速度、配置数、支持的电源模式等。每个USB设备都有一个标准的设备描述符,其中的字段具有特定的定义,如供应商ID、产品ID、设备版本号、设备类、子类和协议等。这些信息在设备连接到USB主机时被读取,是实现驱动程序自动识别和配置设备的基础。

3.1.2 描述符的结构与组成

USB设备描述符的数据结构定义了设备的基本属性。这些描述符在设备初始化时由设备固件提供,是USB设备描述符中最基础且最重要的一种类型。一个标准的USB设备描述符包括以下字段:

  • bLength(字节长度):描述符的总字节长度。
  • bDescriptorType(描述符类型):本描述符的类型(0x01 表示设备描述符)。
  • bcdUSB(USB版本号):遵循的USB规范的版本号。
  • bDeviceClass(设备类代码):设备的类代码,决定了设备属于哪一类功能。
  • bDeviceSubClass(设备子类代码):设备类下的子类代码,用于进一步区分功能。
  • bDeviceProtocol(设备协议代码):设备通信协议代码。
  • bMaxPacketSize0(端点0的最大包大小):端点0的数据包大小。
  • idVendor(供应商ID):设备制造商的ID。
  • idProduct(产品ID):特定的产品模型编号。
  • bcdDevice(设备版本号):设备的版本号。
  • iManufacturer(制造商字符串索引):提供供应商名称的字符串索引。
  • iProduct(产品字符串索引):提供产品名称的字符串索引。
  • iSerialNumber(序列号字符串索引):提供设备序列号的字符串索引。
  • bNumConfigurations(配置数):设备支持的配置数量。

3.2 解析不同类型的描述符

3.2.1 配置描述符

配置描述符提供了一个USB设备可以提供的一组功能的信息。一个设备可以有一个或多个配置,每个配置都具有一个描述符。配置描述符的结构包含了设备可能提供的接口以及电源要求等信息。典型的配置描述符包括以下字段:

  • bLength:描述符长度。
  • bDescriptorType:描述符类型(0x02 表示配置描述符)。
  • wTotalLength:此配置的全部描述符的总长度。
  • bNumInterfaces:此配置下接口的数量。
  • bConfigurationValue:用于选择配置的数值。
  • iConfiguration:配置的描述字符串的索引。
  • bmAttributes:配置属性,指示设备是否可以从该配置供电,以及是否支持远程唤醒等。
  • bMaxPower:设备在该配置下使用的最大电流(单位为2mA)。

3.2.2 接口描述符

接口描述符定义了在特定配置下设备的一个功能集合,每个接口都对应一种功能。例如,一个USB打印机设备可能有一个用于打印功能的接口和一个用于扫描功能的接口。接口描述符的结构包含了如下字段:

  • bLength:描述符长度。
  • bDescriptorType:描述符类型(0x04 表示接口描述符)。
  • bInterfaceNumber:接口编号。
  • bAlternateSetting:备用设置编号。
  • bNumEndpoints:此接口使用的端点数(除端点0外)。
  • bInterfaceClass:接口类代码。
  • bInterfaceSubClass:接口子类代码。
  • bInterfaceProtocol:接口协议代码。
  • iInterface:接口描述字符串的索引。

3.2.3 端点描述符

端点描述符描述了USB设备上的一个端点信息,这些端点用于数据传输。端点0通常是用于控制传输的默认端点,其他的端点则用于数据传输、中断、等时传输等。端点描述符的结构包含以下字段:

  • bLength:描述符长度。
  • bDescriptorType:描述符类型(0x05 表示端点描述符)。
  • bEndpointAddress:端点地址(包含端点号和方向信息)。
  • bmAttributes:端点属性(传输类型)。
  • wMaxPacketSize:端点的最大包大小。
  • bInterval:轮询间隔,用于中断和等时传输的端点。

每个端点描述符提供了端点特性的详细信息,包括传输方向、端点类型(控制、中断、批量或等时)、最大包大小以及在某些传输类型下使用的间隔时间。

在了解了USB设备描述符的结构和作用后,开发者可以针对不同的设备类型编写更精确的设备驱动程序,实现设备的高效管理和数据通信。下面提供一个示例代码块来解析USB设备描述符:

#include <stdio.h>
#include <stdlib.h>
#include <usb.h>

// 用于打印设备描述符信息的辅助函数
void print_device_descriptor(struct usb_device_descriptor *desc) {
    printf("bLength: %d\n", desc->bLength);
    printf("bDescriptorType: %d\n", desc->bDescriptorType);
    printf("bcdUSB: 0x%x\n", desc->bcdUSB);
    printf("bDeviceClass: %d\n", desc->bDeviceClass);
    printf("bDeviceSubClass: %d\n", desc->bDeviceSubClass);
    printf("bDeviceProtocol: %d\n", desc->bDeviceProtocol);
    printf("bMaxPacketSize0: %d\n", desc->bMaxPacketSize0);
    printf("idVendor: 0x%x\n", desc->idVendor);
    printf("idProduct: 0x%x\n", desc->idProduct);
    printf("bcdDevice: 0x%x\n", desc->bcdDevice);
    printf("iManufacturer: %d\n", desc->iManufacturer);
    printf("iProduct: %d\n", desc->iProduct);
    printf("iSerialNumber: %d\n", desc->iSerialNumber);
    printf("bNumConfigurations: %d\n", desc->bNumConfigurations);
}

int main() {
    struct usb_bus *bus;
    struct usb_device *dev;

    usb_find_busses();
    usb_find_devices();

    for (bus = usb_busses; bus; bus = bus->next) {
        for (dev = bus->devices; dev; dev = dev->next) {
            if (dev->descriptor.idVendor == 0x1234 && dev->descriptor.idProduct == 0x5678) {
                print_device_descriptor(&dev->descriptor);
            }
        }
    }

    return 0;
}

这个简单的示例程序使用了usb库函数来枚举并打印出特定USB设备的描述符信息。通过这个程序,开发者能够直观地看到设备描述符中的各个字段。对于更复杂的应用,开发者可以基于这些基础信息来设计驱动程序,并构建更复杂的设备管理逻辑。

4. USB类驱动开发

4.1 USB类驱动的概念与作用

4.1.1 类驱动与总线驱动的关系

USB类驱动位于USB设备驱动的上层,负责特定类型USB设备的通用操作,如音频设备、存储设备和打印设备等。类驱动相对于总线驱动而言,不直接负责物理硬件的管理,而是为特定类型的USB设备提供抽象层,实现了设备的一些基本功能。在Linux内核中,USB核心提供了设备和类驱动之间的标准接口,使得开发者能够专注于特定类设备的逻辑实现,而不必从头开始编写重复的枚举和通信代码。

类驱动通常使用由USB核心提供的接口与设备进行交互,与总线驱动相比,它们更容易编写和维护。总线驱动管理的是USB总线的物理层和协议层,负责检测USB设备、分配地址、配置设备等。类驱动则构建在总线驱动之上,利用总线驱动提供的服务,执行设备特定的操作。

4.1.2 常见USB类驱动类型

在Linux系统中,常见的USB类驱动包括但不限于以下几类:

  • USB音频类驱动 :用于处理音频数据传输,包括麦克风、扬声器和耳机等音频设备。
  • USB存储类驱动 :实现对USB存储设备,例如U盘、移动硬盘等的数据读写操作。
  • USB打印类驱动 :负责USB打印机的通信和打印任务的管理。
  • USB视频类驱动 :通常用于摄像头、视频捕捉设备等图像采集设备。

每种类驱动都需要遵循USB核心提供的接口和规范,这样就可以兼容各种不同的USB设备。

4.2 开发USB类驱动的基本步骤

4.2.1 USB设备的发现与注册

当一个USB设备连接到USB总线时,Linux内核会通过总线驱动检测到设备,并开始枚举过程。在这个过程中,设备会报告它的类、子类和协议信息给内核,这样内核就能判断出对应的类驱动并加载它。

USB类驱动的初始化函数通常包含以下步骤:

  1. 注册类驱动到USB核心,提供一个 usb_driver 结构体。
  2. 实现特定的 probe 函数,该函数会在设备与驱动匹配成功时被调用。
  3. 实现 disconnect 函数,在设备断开连接时进行资源的释放和清理工作。

代码示例:

static struct usb_driver my_usb_driver = {
    .name = "my_usb_driver",
    .id_table = my_usb_table,
    .probe = my_usb_probe,
    .disconnect = my_usb_disconnect,
};

static int __init my_usb_init(void) {
    return usb_register(&my_usb_driver);
}

static void __exit my_usb_exit(void) {
    usb_deregister(&my_usb_driver);
}

module_init(my_usb_init);
module_exit(my_usb_exit);

在这个例子中, my_usb_driver 结构体定义了驱动的名称、ID表、以及 probe 和 disconnect 函数。模块初始化和退出时分别调用 usb_register 和 usb_deregister 函数来注册和注销驱动。

4.2.2 设备接口与功能实现

在 probe 函数中,类驱动会获取设备的详细信息,并根据设备的特定需求初始化所需的资源和数据结构。这包括但不限于分配内存、注册字符设备、设置传输缓冲区等。

功能实现是USB类驱动开发的核心部分,它要求开发者详细地了解USB协议以及具体设备的工作原理。在这一部分,你需要处理如下任务:

  • 初始化设备端点和传输管道。
  • 实现数据传输逻辑,如接收和发送数据。
  • 实现设备特定的控制命令和状态报告处理。

例如,USB存储类驱动需要实现文件系统的操作,包括挂载、卸载和文件I/O操作等。而USB音频类驱动则需要处理音频流的输入输出。

总的来说,开发USB类驱动需要对USB协议和Linux内核驱动编程有深入的了解。此外,还需要具备调试和优化驱动程序的能力,以便在各种硬件环境下都能有良好的性能和稳定性表现。

5. USB接口和端点知识

5.1 USB接口的定义与分类

5.1.1 接口的配置与选择

USB接口是一种标准化的通用串行总线接口,用于连接各种外围设备与主机系统。其设计旨在提供一个标准化的接口,使设备能够易于连接和使用。在USB系统中,接口的概念指的是一种协议,即一组特定的数据处理方式和格式,它定义了如何通过USB发送和接收数据。

USB接口的配置是驱动程序初始化过程中的一个重要步骤。配置USB设备时,需要选择一个合适的配置,并激活它。在Linux内核中,这通常由USB核心自动完成,但在某些情况下,可能需要手动干预。每个配置可以包含一个或多个接口,而每个接口又可以包含多个端点。开发者通常关注如何在驱动程序中选择并配置这些接口来匹配所使用的设备。

5.1.2 接口的关联与作用

接口与USB设备的功能紧密相关。一个USB设备可能支持多个接口,每个接口用于实现设备的不同功能。例如,一个USB网络摄像头可能有一个用于视频流的接口和一个用于控制设备的接口。在驱动程序中,正确地识别和初始化这些接口对于确保设备的正常工作至关重要。

接口通常定义在设备的配置描述符中。每个接口可以包含多个端点,用于数据传输。接口0通常是默认接口,它在设备枚举时被激活,用于配置设备的其他接口和端点。

5.2 端点的管理与数据传输

5.2.1 端点的类型与特性

在USB通信模型中,端点是数据传输的基本单位。每个端点都有特定的类型和方向,分为控制端点、中断端点、批量端点和等时端点。控制端点用于设备的初始配置和控制消息的传输;中断端点用于传输小量的数据,适用于需要快速响应的设备;批量端点用于传输大量数据,例如打印机和扫描仪;等时端点用于需要固定带宽和定时的数据传输,如音频和视频设备。

端点具有特定的传输特性,如传输速率、最大包大小和传输方向(输入、输出或双向)。这些特性在端点的描述符中定义,并在设备枚举时被USB核心读取。

5.2.2 数据传输方式与优化

数据传输是USB通信的核心。开发者在编程时需要考虑如何高效地传输数据,并考虑到可能的传输延迟和错误处理。USB提供了异步和同步两种数据传输方式。

异步传输方式允许主机在不等待数据传输完成的情况下继续执行其他任务,这适用于不需要立即响应的数据传输。例如,在后台将数据从设备传输到主机。同步传输则确保数据传输完成之前,主机不会继续执行后续操作,这适用于对实时性有高要求的场景,比如音频和视频数据的传输。

在数据传输过程中,开发者需要根据应用场景和性能需求来优化传输方式。例如,使用批量端点进行大数据传输时,可能需要合理设置传输超时和重试策略以保证数据的完整性。此外,为了提高性能,开发者可以考虑使用DMA(直接内存访问)技术,以减少CPU的负担。

下面是一个简化的USB批量端点数据传输的代码示例及其逻辑分析:

#include <linux/kernel.h>
#include <linux/module.h>
#include <linux/usb.h>

static const struct usb_device_id usb_table[] = {
    { USB_DEVICE(VID, PID) }, // VID是供应商ID,PID是产品ID
    {} 
};

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Your Name");
MODULE_DESCRIPTION("USB Bulk Transfer Example");

static int usb_probe(struct usb_interface *interface, const struct usb_device_id *id)
{
    struct usb_endpoint_descriptor *endpoint;
    struct usb_host_interface *iface_desc;
    int i;

    iface_desc = interface->cur_altsetting;
    for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
        endpoint = &iface_desc->endpoint[i].desc;

        // 检查端点类型是否为批量端点
        if (usb_endpoint_xfer_bulk(endpoint)) {
            printk(KERN_INFO "Bulk Endpoint found\n");
            // 这里可以添加实现端点数据传输的代码
        }
    }

    return 0;
}

static struct usb_driver usb_driver = {
    .name = "my_usb_bulk_driver",
    .id_table = usb_table,
    .probe = usb_probe,
};

static int __init usb_init(void)
{
    return usb_register(&usb_driver);
}

static void __exit usb_exit(void)
{
    usb_deregister(&usb_driver);
}

module_init(usb_init);
module_exit(usb_exit);

在上面的代码示例中,我们定义了一个USB驱动程序,用于查找并处理USB设备上的批量端点。模块初始化函数 usb_init 会注册驱动,而退出函数 usb_exit 则在模块卸载时注销驱动。 usb_probe 函数会在找到匹配的USB设备时被调用,用于检查端点类型,并为后续的数据传输做准备。

需要注意的是,上述代码只是一个框架,用于演示如何定位批量端点。在实际驱动程序中,开发者需要实现具体的数据传输逻辑,这可能涉及到使用URB(USB Request Block)和处理可能发生的传输错误。

6. USB驱动编程技术

编写一个高效的USB驱动程序需要深入理解Linux内核的USB子系统。本章节将介绍编写USB驱动的框架和实现USB数据通信的关键技术。

6.1 编写USB驱动的框架

在Linux内核中,USB驱动的编写遵循特定的框架结构。这一部分将探讨USB核心API,并设计一个驱动程序的基本结构。

6.1.1 Linux内核USB核心API介绍

USB核心API为驱动开发者提供了与USB子系统交互的接口。以下是几个关键的API及其功能简述:

  • usb_register_driver() : 用于注册一个USB驱动到USB子系统。
  • usb_get_dev() 和 usb_put_dev() : 提供对USB设备的引用计数管理。
  • usb_submit_urb() : 提交一个URB(USB Request Block)进行数据传输。

这些API的使用贯穿于USB驱动的整个生命周期,是驱动开发者必须掌握的基础。

6.1.2 驱动程序结构设计

一个典型的USB驱动程序包括以下几个部分:

  • 模块加载和卸载函数( module_init() 和 module_exit() )。
  • 驱动程序的初始化(通常是 probe() 函数)。
  • 设备与驱动分离时的清理工作(通常是 disconnect() 函数)。
  • 设备属性操作的文件操作函数。

这些部分共同构成了驱动程序的骨架,是USB设备与驱动交互的起点。

6.2 实现USB数据通信

USB驱动程序的核心目标是高效地传输数据。本部分将讲解URB的使用以及数据传输的同步与异步处理方式。

6.2.1 URB(USB Request Block)的使用

URB是USB驱动与USB核心之间的数据传输请求块。以下是URB使用的基本步骤:

  1. 分配URB结构体。
  2. 填充URB结构体的相关字段,如传输缓冲区、设备、端点等。
  3. 提交URB到USB核心进行处理。
  4. 完成后,USB核心将调用URB的完成回调函数。

示例代码如下:

struct urb *urb;
urb = usb_alloc_urb(0, GFP_KERNEL); // 分配URB

if (!urb) {
    // 分配URB失败处理
}

usb_fill_bulk_urb(urb, dev, pipe, buffer, length, callback, context);
urb->transfer_flags = URB_NO_TRANSFER_DMA_MAP;

int ret = usb_submit_urb(urb, GFP_KERNEL); // 提交URB

if (ret) {
    // 提交URB失败处理
}

usb_free_urb(urb); // 使用完毕后释放URB

6.2.2 数据传输的同步与异步处理

同步与异步处理是两种数据传输方式:

  • 同步传输(Synchronous Transfer):传输过程阻塞直到完成,代码易于编写,但会阻塞执行线程。
  • 异步传输(Asynchronous Transfer):传输请求被提交后,主线程继续执行,传输完成时通过回调函数通知。

选择合适的传输方式依赖于应用的具体需求。

通过以上章节内容,我们可以看到USB驱动编程技术需要对Linux内核的USB子系统有深入的理解。同时,需要掌握URB的使用方法,理解数据传输的同步与异步处理机制。这些知识和技术将为编写高性能USB驱动奠定坚实的基础。

在下一章节,我们将继续深入探讨USB驱动开发中的数据传输方法,以及如何利用内核提供的同步与异步接口,来满足不同应用场景的需求。

本文还有配套的精品资源,点击获取 menu-r.4af5f7ec.gif

简介:Linux USB驱动程序是连接Linux系统与USB设备的桥梁,负责识别、管理和通信。本文档“Linux-usb-driver-examples.zip”提供了多个USB驱动实例,用于帮助开发者理解USB驱动原理,并提供可编译使用的代码。内容涵盖USB设备枚举、设备描述符、类驱动、USB接口与端点、驱动编程、数据传输、热插拔处理、驱动编译与加载以及设备模拟等方面的实践知识。开发者通过学习这些示例,能够掌握编写、调试和优化USB驱动程序的技能。


本文还有配套的精品资源,点击获取
menu-r.4af5f7ec.gif

Logo

北京人形旗下天工造物具身智能开源社区,聚焦具身天工与慧思开物两大平台

更多推荐