更成痒 发表于 2026-2-14 21:45:02

Linux USB应用开发学习笔记

三、USB应用编程

经过前面内容的学习,我们学习了 USB 的基础知识,接下来我们将探讨如何借助 USB 总线实现对 USB 外设的操作。与之前 I2C SPI 操作外设不同,usb应用采用主要是使用 libusb 库,在这章中,主要对libusb库的使用进行学习。
3.1 libusb库简介

libusb 是一个使用 C 编写的库,它提供 USB 设备的通用访问方法。APP 通过它,可以方便地访问 USB 设备,不需要编写 USB 设备驱动程序。libusb 库有三个特点:
1、可移植性好,支持 Linux,macOS,Windows 系统。
2、简单易用,APP 不需要特权模式,也不需要提升自己权限即可访问 USB 设备
3、支持所有的 USB 协议,从 USB1.0 到 USB3.1,并且 API 接口保持不变,方便开发。
3.2 libusb编译与测试

我们可以先从github上下载libusb库,在终端中输入如下命令
wzy@wzy-JiaoLong:~$ git clone https://github.com/libusb/libusb.git
Cloning into 'libusb'...
remote: Enumerating objects: 18197, done.
remote: Counting objects: 100% (31/31), done.
remote: Compressing objects: 100% (24/24), done.
remote: Total 18197 (delta 11), reused 7 (delta 7), pack-reused 18166 (from 2)
Receiving objects: 100% (18197/18197), 5.51 MiB | 4.23 MiB/s, done.
Resolving deltas: 100% (13031/13031), done.
wzy@wzy-JiaoLong:~$进入到libusb源码文件夹中,安装对应的依赖包准备编译
sudo apt install autoconf automake libtool libudev-dev m4接着输入以下命令进行编译和安装
./bootstrap.sh
./autogen.sh
make
sudo make install执行完之后,在libusb源文件下会生产一些中间文件

并且make install之后,会将编译好的库放到/usr/local/lib目录下

同时在源码文件夹examples路径下执行的脚本会自动将一些例程自动编译

可以运行其中的listdevs可执行文件来显示系统当前的USB设备信息,包括VID、PID、端口号等
wzy@wzy-JiaoLong:~/softpack/libusb/examples$ ./listdevs  
026d:0002 (bus 5, device 6) path: 1.4
048d:8910 (bus 5, device 5) path: 1.3
1bcf:28c4 (bus 5, device 4) path: 1.2
13d3:3585 (bus 5, device 3) path: 1.1
05e3:0610 (bus 5, device 2) path: 1
1d6b:0002 (bus 5, device 1)
0bda:9210 (bus 4, device 2) path: 1
1d6b:0003 (bus 4, device 1)
1d6b:0002 (bus 3, device 1)
1d6b:0003 (bus 2, device 1)
24ae:1861 (bus 1, device 2) path: 2
1d6b:0002 (bus 1, device 1)
wzy@wzy-JiaoLong:~/softpack/libusb/examples$上述的libusb的测试是在x86的环境下进行的测试,在实际的嵌入式开发中,我们通常会需要在嵌入式平台上使用libusb库,这时我们就需要对libusb库进行交叉编译,先在刚刚编译的libusb文件夹中执行make clean清除刚刚的编译结果,再执行configure脚本,配置编译环境,并且指定相应的目标平台
./configure --host=aarch64-linux-gnu --disable-udev --prefix=$PWD/install CC=/home/wzy/sdk/rk3576_linux6.1.99_release-rkr5/prebuilts/gcc/linux-x86/aarch64/gcc-arm-10.3-20
21.07-x86_64-aarch64-none-linux-gnu/bin/aarch64-none-linux-gnu-gcc CXX=/home/wzy/sdk/rk3576_linux6.1.99_release-rkr5/prebuilts/gcc/linux-x86/aarch64/gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu/bin/aa
rch64-none-linux-gnu-g++通过configure脚本指定完host、prefix、CC和CXX变量之后,就可以直接执行make命令进行编译了,再通过make instal进行安装,libusb库会安装到我们指定的prefix路径下面来

我们也可以通过file命令查看当前库的平台信息,可以看见已经成功编译到了aarch64平台下面了

这些库编译完成之后,我们直接通过adb push命令将库文件和头文件拷贝到开发板中

这里需要注意的是,既可以将动态库拷贝到/lib路径下,也可以拷贝到/usr/lib路径下,优先会使用/lib路径下的libusb动态库,如果存在的话,如果配套开发板的/lib路径下有动态库了,可能会出现和自己编译时版本不匹配的情况,可以直接进行替换。接着拷贝头文件

这里需要注意的是,拷贝头文件的时候,直接将.h文件拷贝到/usr/include目录下,不要带libusb-1.0这一层路径
接着我们交叉编译示例程序,切换到examples路径下,使用交叉工具编译listdevs.c源文件,命令如下
wzy@wzy-JiaoLong:~/softpack/libusb/examples$ /home/wzy/sdk/rk3576_linux6.1.99_release-rkr5/prebuilts/gcc/linux-x86/aarch64/gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu/bin/aarch64-none-linux-gnu-gcc
listdevs.c -o listdevs -L/home/wzy/softpack/libusb/install/lib -I/home/wzy/softpack/libusb/install/include/libusb-1.0 -lusb-1.0 -lpthread可以看见可执行程序成功编译出来

接着将该可执行二进制文件拷贝到开发板上,直接运行,发现可执行文件报错,这是因为lisusb库的版本不一致导致的

这里遇到的这个坑,是因为开发板中动态库与我们交叉编译可执行文件使用的动态库版本不同,导致函数声明差异,这里是通过ldd命令查看了程序连接动态库的路径,发现是在/lib/aarch64-linux-gnu路径下,导致libusb动态库的版本一直不对,一直报错,所以我们需要将编译出来的动态库文件替换到这个路径下才行
root@linaro-alip:/# ldd ./listdevs
       linux-vdso.so.1 (0x0000007f9ad93000)
       libusb-1.0.so.0 => /lib/aarch64-linux-gnu/libusb-1.0.so.0 (0x0000007f9ad00000)
       libpthread.so.0 => /lib/aarch64-linux-gnu/libpthread.so.0 (0x0000007f9acd0000)
       libc.so.6 => /lib/aarch64-linux-gnu/libc.so.6 (0x0000007f9ab20000)
       libudev.so.1 => /lib/aarch64-linux-gnu/libudev.so.1 (0x0000007f9aad0000)
       /lib/ld-linux-aarch64.so.1 (0x0000007f9ad56000)root@linaro-alip:/# ldd ./listdevs
       linux-vdso.so.1 (0x0000007f9ad93000)
       libusb-1.0.so.0 => /lib/aarch64-linux-gnu/libusb-1.0.so.0 (0x0000007f9ad00000)
       libpthread.so.0 => /lib/aarch64-linux-gnu/libpthread.so.0 (0x0000007f9acd0000)
       libc.so.6 => /lib/aarch64-linux-gnu/libc.so.6 (0x0000007f9ab20000)
       libudev.so.1 => /lib/aarch64-linux-gnu/libudev.so.1 (0x0000007f9aad0000)
       /lib/ld-linux-aarch64.so.1 (0x0000007f9ad56000)可以看到,这里连接的动态库是存放在/lib/aarch64-linux-gnu路径下的,所以需要替换这里的动态库,替换完成之后重新执行,可执行文件成功执行,我们的libusb动态库与示例程序也就移植完成了,接下里可以开发自己的应用程序通过相同的流程部署到嵌入式开发板上

3.3 libusb库应用程序编写

在前面的章节中讲解 libusb 库的安装和使用,交叉编译了上层应用 demo 程序,并运行在开发板上。本章节将参考之前的 demo 程序,学习 libusb 库应用程序的编写。在前面的章节中讲解 libusb 库的安装和使用,交叉编译了上层应用 demo 程序,并运行在开发板上。本章节将参考之前的 demo 程序,学习 libusb 库应用程序的编写。
3.3.1 libusb库常用API接口介绍

1.libusb_init
该函数用于初始化libusb库
int libusb_init(libusb_context **ctx);参数:

[*]libusb_context **ctx:上下文指针,可为 NULL 使用默认上下文。
返回值:
[*]成功返回0,失败返回负数
2.libusb_get_device_list
该函数用于获取当前连接的USB设备列表
ssize_t libusb_get_device_list(libusb_context *ctx, libusb_device ***list)参数:

[*]libusb_context ctx:上下文指针
[*]libusb_device ***list:输出设备指针数组
返回值:
[*]成功时返回设备数量,负值表示错误。
3.libusb_open_device_with_vid_pid
该函数用于获取当前连接的USB设备列表
libusb_device_handle *libusb_open_device_with_vid_pid(libusb_context *ctx, uint16_t vid, uint16_t pid)参数:

[*]libusb_context *ctx:上下文指针
[*]libusb_device ***list:输出设备指针数组
返回值:
[*]成功时返回设备数量,负值表示错误。
4.libusb_open_device_with_vid_pid
该函数用来根据idVendor和idProduct的值打开对应的USB设备。
libusb_device_handle *libusb_open_device_with_vid_pid(libusb_context *ctx, uint16_t vid, uint16_t pid)参数:

[*]libusb_context *ctx:上下文指针
[*]uint16_t vid:要搜索的idVendor值
[*]uint16_t pid:要搜索的 idProduct 值
返回值:
[*]成功返回设备句柄(libusb_device_handle *),失败返回 NULL。
5.libusb_open
该函数用来通过 libusb_device指针打开一个usb设备,并返回一个libusb_device_handle句柄
int libusb_open(libusb_device *dev, libusb_device_handle **dev_handle);参数:

[*]libusb_device *dev:要打开的 USB 设备指针。
[*]libusb_device_handle **dev_handle:返回的设备句柄的指针。
返回值:

[*]成功时返回 0,失败时返回负数,表示具体的错误码。
6.libusb_bulk_transfer
该函数用来实现USB的批量传输
int libusb_bulk_transfer(
        libusb_device_handle *dev_handle,
        unsigned char endpoint,
        unsigned char *data,
        int length,
        int *actual_length,
        unsigned int timeout
);参数:

[*]libusb_device_handle **dev_handle:指向设备句柄的指针。
[*]unsigned char endpoint:端点地址,最高位为 1 表示输入。
[*]unsigned char *data:发送或接收缓冲区指针。
[*]int length:缓冲区长度。
[*]int *actual_length:实际传输长度。
[*]unsigned int timeout:超时的毫秒数,0 表示永不超时
返回值:

[*]成功时返回 0,失败时返回负数,表示具体的错误码。
7.libusb_interrupt_transfer 函数
该函数用来实现USB的中断传输
int libusb_interrupt_transfer(
        libusb_device_handle *dev_handle,
        unsigned char endpoint,
        unsigned char *data,
        int length,
        int *actual_length,
        unsigned int timeout
);参数:

[*]libusb_device_handle dev_handle:指向设备句柄的指针
[*]unsigned char endpoint:端点地址,最高位为 1 表示输入
[*]unsigned char *data:发送或接收缓冲区指针。
[*]int length:缓冲区长度。
[*]int *actual_length:实际传输长度。
[*]unsigned int timeout:超时的毫秒数,0 表示永不超时。
返回值:

[*]成功时返回 0,失败时返回负数,表示具体的错误码。
8.libusb_get_device_descriptor 函数
该函数用于获取USB设备描述符。
int libusb_get_device_descriptor(
        libusb_device *dev,
        struct libusb_device_descriptor *desc
);参数:

[*]libusb_device *dev:要读取的设备。
[*]struct libusb_device_descriptor *desc:获取到的设备描述符
返回值:

[*]成功时返回 0,失败时返回负数,表示具体的错误码。
9.libusb_get_config_descriptor 函数
该函数用于根据索引值获取配置描述符。
int libusb_get_config_descriptor(
        libusb_device *dev,
        uint8_t config_index,
        struct libusb_config_descriptor **config
);参数:

[*]libusb_device *dev:要读取的设备。
[*]uint8_t config_index:配置描述符的索引(一个 USB 设备可能有多个配置)。
[*]struct libusb_config_descriptor **config:获取到的配置描述符
返回值:

[*]成功时返回 0,失败时返回负数,表示具体的错误码。
10. libusb_free_device_list 函数
该函数用于释放设备列表。
void libusb_free_device_list(
        libusb_device **list,
        int unref_devices
);参数:

[*]libusb_device **list:要释放的设备列表。
[*]int unref_devices:如果设置成 1,则设备的引用计数-1。
返回值:

[*]成功时返回 0,失败时返回负数,表示具体的错误码。
11.libusb_free_config_descriptor函数
该函数用于释放配置描述符。
void libusb_free_config_descriptor(
struct libusb_config_descriptor *config
);参数:

[*]struct libusb_config_descriptor *config:要释放的配置描述符。
返回值:
[*]成功时返回 0,失败时返回负数,表示具体的错误码。
12 .libusb_set_auto_detach_kernel_driver函数
该函数用于解决“内核驱动占用 USB 设备”的问题,让程序员可以直接用 libusb 操作设备,并且自动处理 detach / attach,针对USB设备的接口而言不是针对某一个USB设备
int libusb_set_auto_detach_kernel_driver(
        libusb_device_handle *dev_handle,
        int enable
);参数:

[*]libusb_device_handle *dev_handle:已打开的 USB 设备句柄。
[*]int enable:启用(1)或禁用(0)自动分离功能。
返回值:
[*]成功时返回 0,失败时返回负数,表示具体的错误码。
举例:
//打开一个usb设备
libusb_open(dev, &handle);
//自动内核分离
libusb_set_auto_detach_kernel_driver(handle, 1);
//如果申请的接口已经被内核占用,会自动分离
libusb_claim_interface(handle, 0);13.libusb_claim_interface
该函数用来给设备申请接口。
int libusb_claim_interface(
        libusb_device_handle *dev_handle,
        int interface_number
);参数:

[*]libusb_device_handle *dev_handle:已打开的 USB 设备句柄。
[*]int interface_number:要声明的接口编号(从 0 开始),对应接口描述符的 bInterfaceNumber 成员。
返回值:
[*]成功时返回 0,失败时返回负数,表示具体的错误码。
14.libusb_alloc_transfer
该函数用于分配一个用于异步传输的结构体,即 libusb_transfer 结构体。
struct libusb_transfer *libusb_alloc_transfer( int iso_packets);参数:

[*]int iso_packets:等时传输包数量(非等时传输设为 0)。
返回值:
[*]成功时返回 struct libusb_transfer *结构体指针,失败时返回负数,表示具体的错误码。
15.libusb_fill_interrupt_transfer
该函数用于配置一个异步中断传输对象。
void libusb_fill_interrupt_transfer(
        struct libusb_transfer *transfer,
        libusb_device_handle *dev_handle,
        unsigned char endpoint,
        unsigned char *buffer,
        int length,
        libusb_transfer_cb_fn callback,
        void *user_data,
        unsigned int timeout
);参数:

[*]struct libusb_transfer *transfer:已分配的传输对象(需先通过libusb_alloc_transfer 分配)。
[*]libusb_device_handle *dev_handle: 已打开的 USB 设备句柄。
[*]unsigned char endpoint:端点地址。
[*]unsigned char *buffer:数据缓冲区指针。
[*]int length:缓冲区长度(字节数)
[*]libusb_transfer_cb_fn callback:传输完成时的回调函数。
[*]void *user_data:用户自定义数据(会传递给回调函数)。
[*]unsigned int timeout:超时时间(毫秒,0 表示不超时),单位 ms。
返回值:
[*]void
16.libusb_submit_transfer
该函数用于提交一个异步传输请求,传输完成或者出错时候调用回调函数进行处理。
int libusb_submit_transfer(struct libusb_transfer *transfer);参数:

[*]struct libusb_transfer *transfer:已通过 libusb_fill_interrupt_transfer 配置的传输对象。
返回值:
[*]成功返回 0,失败返回负数。
17.libusb_cancel_transfer
该函数用于取消已提交但未完成的异步 USB 传输。
int libusb_submit_transfer(struct libusb_transfer *transfer);参数:

[*]struct libusb_transfer *transfer:要取消的传输对象指针。
返回值:
[*]成功返回 0,失败返回负数。
18.libusb_free_transfer
该函数用于释放传输结构。
void libusb_free_transfer(struct libusb_transfer *transfer);参数:

[*]struct libusb_transfer *transfer:要取消的传输对象指针。
返回值:
[*]成功返回 0,失败返回负数。
19.libusb_handle_events
该函数用于在阻塞模式下处理任何待处理事件。
int libusb_handle_events(libusb_context *ctx);参数:

[*]libusb_context *ctx:USB上下文
返回值:
[*]成功返回 0,失败返回负数。
3.3.2 USB设备枚举应用程序实验

接下来实现一个基于libusb库的USB设备枚举程序,主要功能是扫描并列出当前系统中所有已连接的USB设备的基本信息。
#include <stdio.h>
#include "libusb.h"

int main(void)
{
        int ret; // 函数返回值存储
        int cnt; // 设备计数
        libusb_device **device = NULL; // 设备列表指针
        libusb_device *dev; // 单个设备指针
        int i = 0; // 循环计数器
       
        // 初始化libusb库
        ret = libusb_init(NULL);
        if (ret < 0) {
                printf("libusb_init error \n");
                return ret;
        }
       
        // 获取USB设备列表
        cnt = libusb_get_device_list(NULL, &device);
        if (cnt < 0) {
                printf("libusb_get_device_list error \n");
                return cnt;
        }
       
        // 遍历设备列表
        while (dev = device) {
                struct libusb_device_descriptor desc; // 设备描述符
                // 获取设备描述符
                ret = libusb_get_device_descriptor(dev, &desc);
                if (ret < 0) {
                        printf("libusb_get_device_descriptor error \n");
                        return ret;
                }
                // 打印厂商ID和产品ID
                printf("%04x : %04x\n", desc.idVendor, desc.idProduct);
        }
       
        // 释放设备列表(unref=1表示减少引用计数)
        libusb_free_device_list(device, 1);
        // 释放 libusb 库占用的所有资源
        libusb_exit(NULL);
        return 0;
}使用如下命令编译程序,再将可执行文件拷贝到开发板上执行
wzy@wzy-JiaoLong:~/Downloads$ /home/wzy/sdk/rk3576_linux6.1.99_release-rkr5/prebuilts/gcc/linux-x86/aarch64/gcc-arm-10.3-2021.07-x86_64-aarch64-none-linux-gnu/bin/aarch64-none-linux-gnu-gcc usb1.
c -o usb1 -I/home/wzy/softpack/libusb/install/include/libusb-1.0 -L/home/wzy/softpack/libusb/install/lib -lusb-1.0 -lpthread得到正确结果
root@linaro-alip:/# ./usb1  
05e3 : 0626
1d6b : 0003
2c7c : 0125
1a86 : 8091
05e3 : 0610
1d6b : 0002
root@linaro-alip:/#v3.3.3 USB HID键盘设备检测程序实验

#include <stdio.h>
#include "libusb.h"

int main(void)
{
        // 变量声明区
        int ret; // 存储函数返回值
        int cnt; // 设备计数器
        libusb_device **device = NULL; // USB设备列表指针
        libusb_device *dev; // 单个USB设备指针
        int i = 0, k = 0, j = 0; // 循环计数器
        int endpoint; // 端点地址
        int flag = 0; // 标志位

        // 描述符结构体
        struct libusb_config_descriptor *config_desc = NULL; // USB配置描述符
        const struct libusb_interface_descriptor *interface_descriptor = NULL; // 接口描述符
        libusb_device_handle *dev_handle = NULL; // USB设备句柄

        // 数据缓冲区
        unsigned char buffer; // 数据接收缓冲区
        int transferred; // 实际传输字节数

        // 初始化libusb库
        ret = libusb_init(NULL);
        if (ret < 0) {
                printf("libusb初始化失败\n");
                return ret;
        }

        // 获取USB设备列表
        cnt = libusb_get_device_list(NULL, &device);
        if (cnt < 0) {
                printf("获取设备列表失败\n");
                return cnt;
        }

        // 遍历设备列表查找HID设备
        while (dev = device) {
                // 获取设备配置描述符
                ret = libusb_get_config_descriptor(dev, 0, &config_desc);
                if (ret < 0) {
                        printf("获取配置描述符失败\n");
                        return ret;
                }

                // 遍历所有接口
                for (k = 0; k < config_desc->bNumInterfaces; k++) {
                        interface_descriptor = &config_desc->interface.altsetting;
                        // 查找HID类设备(Class=3),3为HID人机交互设备且协议为键盘(Protocol=1),在USB协议中,是固定的规定
                        if (interface_descriptor->bInterfaceClass == 3 && interface_descriptor->bInterfaceProtocol == 1) {
                        // 遍历端点查找中断输入端点
                                for (j = 0; j < interface_descriptor->bNumEndpoints; j++) {
                                        if ((interface_descriptor->endpoint.bmAttributes & LIBUSB_TRANSFER_TYPE_MASK) == LIBUSB_TRANSFER_TYPE_INTERRUPT && (interface_descriptor->endpoint.bmAttributes & LIBUSB_ENDPOINT_DIR_MASK) == LIBUSB_ENDPOINT_IN) {
                                                endpoint = interface_descriptor->endpoint.bEndpointAddress;
                                                flag = 1; // 找到目标设备
                                                break;
                                        }
                                }
                        }
                        if (flag) break;
                }
                if (flag) break;
        }

        // 打开目标设备
        ret = libusb_open(dev, &dev_handle);
        if (ret < 0) {
                printf("打开设备失败\n");
                return ret;
        }

        // 设置自动卸载内核驱动
        libusb_set_auto_detach_kernel_driver(dev_handle, 1);
        // 声明接口,一般和libusb_set_auto_detach_kernel_driver函数搭配使用
        libusb_claim_interface(dev_handle, interface_descriptor->bInterfaceNumber);
       
        // 主循环:持续读取键盘数据
        while (1) {
        // 中断传输读取键盘数据
                ret = libusb_interrupt_transfer(dev_handle, endpoint, buffer, 16, &transferred, 5000);
                if (ret >= 0) { // 读取成功
                // 打印接收到的键盘数据
                        for (i = 0; i < transferred; i++) {
                                printf("%02x ", buffer);
                        }
                        printf("\n");
                }
        }

        // 资源释放
        libusb_free_config_descriptor(config_desc); // 释放配置描述符
        libusb_free_device_list(device, 1); // 释放设备列表
        libusb_exit(NULL); // 释放libusb资源
        return 0;
}交叉编译之后可执行程序拷贝到开发板上,执行之后插入键盘,按下按键后可以看见打印出了键盘的按键信息

上面的版本是使用的libusb_interrupt_transfer接口函数接收USB数据,这种方式是一种阻塞同步的方式,当前线程会完全停住,接收到数据之后才会继续执行代码,这种方式性能差,拓展性差,下面对接收方式进行优化,使用异步方式来处理,主要使用到以下四个API函数
libusb_alloc_transfer()
libusb_fill_interrupt_transfer()
libusb_submit_transfer()
libusb_handle_events()完整优化代码如下
#include <stdio.h>
#include "libusb.h"

// 全局变量声明
struct libusb_transfer *keyboard_transfer = NULL; // 异步传输控制块
unsigned char buffer; // 键盘数据接收缓冲区
int ret; // 函数返回值存储

// 异步传输回调函数
void callback_recv(struct libusb_transfer *transfer) {
        int k;
        if (transfer->status == LIBUSB_TRANSFER_COMPLETED) {
                if (transfer->actual_length > 0) {
                        // 打印接收到的键盘数据(16进制)
                        for (k = 0; k < transfer->actual_length; k++) {
                                printf("%02x ", buffer);
                        }
                        printf("\n");
                }
        }
        // 重新提交传输请求(实现持续监听)
        ret = libusb_submit_transfer(keyboard_transfer);
        if (ret < 0) {
                libusb_cancel_transfer(keyboard_transfer);
                libusb_free_transfer(keyboard_transfer);
        }
}

int main(void) {
        // 设备枚举相关变量
        int cnt; // 设备数量计数器
        libusb_device **device = NULL; // USB设备列表
        libusb_device *dev = NULL; // 当前设备指针
        int i = 0, k = 0, j = 0; // 循环计数器
        int endpoint; // 端点地址
        int flag = 0; // 设备查找标志
       
        // USB描述符指针
        struct libusb_config_descriptor *config_desc = NULL; // 配置描述符
        const struct libusb_interface_descriptor *interface_descriptor = NULL; // 接口描述符
        libusb_device_handle *dev_handle = NULL; // 设备操作句柄

        // 初始化libusb库
        ret = libusb_init(NULL);
        if (ret < 0) {
                printf("libusb初始化失败\n");
                return ret;
        }

        // 获取USB设备列表
        cnt = libusb_get_device_list(NULL, &device);
        if (cnt < 0) {
                printf("获取设备列表失败\n");
                return cnt;
        }

        // 遍历设备查找HID键盘
        while ((dev = device)) {
                // 获取默认配置描述符
                ret = libusb_get_config_descriptor(dev, 0, &config_desc);
                if (ret < 0) {
                        printf("获取配置描述符失败\n");
                        return ret;
                }
                // 遍历所有接口
                for (k = 0; k < config_desc->bNumInterfaces; k++) {
                interface_descriptor = &config_desc->interface.altsetting;
                // 检查是否为HID键盘设备(Class=3, Protocol=1)
                if (interface_descriptor->bInterfaceClass == 3 &&
                interface_descriptor->bInterfaceProtocol == 1) {
                                // 查找中断输入端点
                                for (j = 0; j < interface_descriptor->bNumEndpoints; j++) {
                                        if ((interface_descriptor->endpoint.bmAttributes & LIBUSB_TRANSFER_TYPE_MASK) == LIBUSB_TRANSFER_TYPE_INTERRUPT &&
                                        (interface_descriptor->endpoint.bmAttributes & LIBUSB_ENDPOINT_DIR_MASK) == LIBUSB_ENDPOINT_IN)
                                        {
                                                endpoint = interface_descriptor->endpoint.bEndpointAddress;
                                                flag = 1; // 标记已找到目标设备
                                                break;
                                        }
                                }
                        }
                        if (flag) break;
                }
                if (flag) break;
        }

        // 打开找到的键盘设备
        ret = libusb_open(dev, &dev_handle);
        if (ret < 0) {
                printf("打开设备失败\n");
                return ret;
        }
       
        // 设置自动卸载内核驱动(避免冲突)
        libusb_set_auto_detach_kernel_driver(dev_handle, 1);
        // 声明使用该接口
        libusb_claim_interface(dev_handle, interface_descriptor->bInterfaceNumber);
       
        // 配置异步传输
        keyboard_transfer = libusb_alloc_transfer(0); // 分配传输控制块
        libusb_fill_interrupt_transfer( // 填充中断传输参数
                keyboard_transfer,
                dev_handle,
                endpoint,
                buffer,
                16,
                callback_recv,
                NULL, 5000);
               
        // 提交异步传输请求
        ret = libusb_submit_transfer(keyboard_transfer);
        if (ret < 0) {
                libusb_cancel_transfer(keyboard_transfer);
                libusb_free_transfer(keyboard_transfer);
                return ret;
        }

        // 主事件循环(处理USB事件)
        while (1) {
                libusb_handle_events(NULL);
        }
       
        // 资源清理(实际不会执行到此处)
        libusb_free_config_descriptor(config_desc);
        libusb_free_device_list(device, 1);
        libusb_exit(NULL);
        return 0;
}这种异步的方法可以理解为
1、预提交一个或多个 USB 传输任务
2、然后不断轮询事件
3、在事件循环中处理完成,如果任务完成,就执行回调函数

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!

习和璧 发表于 2026-2-21 06:09:50

喜欢鼓捣这些软件,现在用得少,谢谢分享!

幽淆 发表于 2026-2-25 03:33:32

热心回复!

僚娥 发表于 2026-3-7 08:35:16

感谢分享

矛赓宁 发表于 2026-3-7 10:17:52

用心讨论,共获提升!

益竹月 发表于 2026-3-8 05:13:19

这个好,看起来很实用

啤愿 发表于 2026-3-8 06:36:58

用心讨论,共获提升!
页: [1]
查看完整版本: Linux USB应用开发学习笔记