做搜狗网站优化首中国联通网站备案

张

张建站

2026/4/6 17:19:54

10分钟阅读

做搜狗网站优化首,中国联通网站备案,在国外做外国的网站合法吗,软件工程四大方向1. 为什么你需要libusb-1.0#xff1f; 如果你曾经想写个程序#xff0c;跟一个USB设备#xff08;比如一个自定义的硬件、一个特殊的鼠标键盘、或者一个数据采集卡#xff09;聊聊天#xff0c;那你可能马上就会遇到一个头疼的问题#xff1a;操作系统不让随便聊。在Win…1. 为什么你需要libusb-1.0如果你曾经想写个程序跟一个USB设备比如一个自定义的硬件、一个特殊的鼠标键盘、或者一个数据采集卡聊聊天那你可能马上就会遇到一个头疼的问题操作系统不让随便聊。在Windows上你得写个内核驱动那玩意儿门槛高得吓人在Linux上虽然好点但直接操作/dev/bus/usb/下面的文件也是一堆繁琐的ioctl调用而且不同系统还不一样。这时候libusb就像你的救星。它是一个用C写的、跨平台的库把你从这些底层泥潭里拉出来。它提供了一个统一的API让你在Linux、macOS、Windows、甚至Android上都能用几乎相同的代码去操作USB设备。最棒的是它工作在用户空间这意味着你不需要去碰内核驱动也不需要什么管理员权限在大多数情况下用普通用户程序就能搞定。我刚开始接触USB开发时也被驱动搞得焦头烂额。后来发现了libusb感觉整个世界都亮了。它把USB通信那些复杂的细节都封装好了你只需要关心“我想发什么数据”、“我想收什么数据”。这大大降低了嵌入式软件、测试工具、或者任何需要跟USB硬件打交道的应用开发门槛。简单来说libusb-1.0我们主要讨论这个现代版本就是连接你的应用程序和USB硬件之间的一座标准化桥梁。无论桥那边的硬件是插在Windows笔记本上还是Linux服务器上你过桥的方式都一样。2. 快速上手5分钟跑通你的第一个libusb程序光说不练假把式。我们直接来看代码目标是列出你电脑上所有的USB设备。这是和USB世界打招呼的第一步。首先你得把libusb库“请”到你的项目里。不同平台方法不一样Ubuntu/Debian:sudo apt-get install libusb-1.0-0-devmacOS (用Homebrew):brew install libusbWindows: 去官网libusb.info或者GitHub releases页面下载预编译的DLL和导入库.lib文件或者用vcpkg、MSYS2这样的包管理器。安装好后我们写一个简单的C程序list_devices.c#include stdio.h #include libusb-1.0/libusb.h int main() { // 1. 初始化libusb会话 libusb_context *ctx NULL; int ret libusb_init(ctx); if (ret 0) { fprintf(stderr, 初始化失败: %s\n, libusb_error_name(ret)); return 1; } // 设置日志级别方便调试 libusb_set_option(ctx, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_INFO); // 2. 获取设备列表 libusb_device **dev_list; ssize_t cnt libusb_get_device_list(ctx, dev_list); if (cnt 0) { fprintf(stderr, 获取设备列表失败\n); libusb_exit(ctx); return 1; } printf(找到 %zd 个USB设备:\n, cnt); // 3. 遍历列表打印每个设备的基础信息 libusb_device *dev; int i 0; while ((dev dev_list[i]) ! NULL) { struct libusb_device_descriptor desc; ret libusb_get_device_descriptor(dev, desc); if (ret 0) { fprintf(stderr, 获取设备描述符失败\n); continue; } // 打印厂商ID(Vendor ID)和产品ID(Product ID)这是USB设备的“身份证” printf(设备 %d: %04X:%04X (总线 %d, 设备地址 %d)\n, i, desc.idVendor, desc.idProduct, libusb_get_bus_number(dev), libusb_get_device_address(dev)); } // 4. 释放设备列表注意第二个参数1表示同时减少每个设备的引用计数 libusb_free_device_list(dev_list, 1); // 5. 结束libusb会话 libusb_exit(ctx); return 0; }编译和运行Linux/macOS示例gcc -o list_devices list_devices.c -lusb-1.0 ./list_devices如果一切顺利你会看到一串输出类似找到 12 个USB设备: 设备 1: 1D6B:0002 (总线 1, 设备地址 1) 设备 2: 8087:0024 (总线 1, 设备地址 2) ...这里的1D6B:0002就是Linux Foundation的根集线器。恭喜你你已经成功用libusb和系统的USB子系统对话了这个简单的程序包含了libusb使用的核心流程初始化 - 获取设备列表 - 操作 - 清理释放。记住这个模式后面复杂的操作都是在这个骨架上添肉。3. 核心操作找到并“握住”你的设备仅仅列出设备还不够我们得找到我们想操作的那个“它”并打开一个连接。通常我们通过设备的**厂商IDVendor ID, vid和产品IDProduct ID, pid**来精确定位。这两个ID是USB设备在出厂时就烧录好的全球唯一。假设我们要操作一个VID为0x1234PID为0x5678的设备代码如下#include stdio.h #include libusb-1.0/libusb.h #define MY_VID 0x1234 #define MY_PID 0x5678 int main() { libusb_context *ctx NULL; libusb_device_handle *dev_handle NULL; int ret; ret libusb_init(ctx); if (ret 0) return ret; // 方法一遍历查找更灵活可以检查多个条件 libusb_device **dev_list; ssize_t cnt libusb_get_device_list(ctx, dev_list); libusb_device *found_dev NULL; for (int i 0; i cnt; i) { libusb_device *dev dev_list[i]; struct libusb_device_descriptor desc; libusb_get_device_descriptor(dev, desc); if (desc.idVendor MY_VID desc.idProduct MY_PID) { found_dev dev; break; } } if (found_dev) { // 打开找到的设备 ret libusb_open(found_dev, dev_handle); if (ret ! LIBUSB_SUCCESS) { printf(打开设备失败: %s\n, libusb_error_name(ret)); } } // 方法二直接通过VID/PID打开更简洁但只适用于只有一个匹配设备的情况 // dev_handle libusb_open_device_with_vid_pid(ctx, MY_VID, MY_PID); libusb_free_device_list(dev_list, 1); // 释放列表 if (dev_handle NULL) { printf(未找到设备 %04X:%04X\n, MY_VID, MY_PID); libusb_exit(ctx); return 1; } printf(成功打开设备\n); // 重要声明使用设备的哪个接口 // 一个USB设备可以有多个接口比如一个USB声卡可能有音频输入、输出两个接口 // 接口编号通常从0开始。你需要查看设备的文档或描述符来确定。 int interface_number 0; ret libusb_claim_interface(dev_handle, interface_number); if (ret ! LIBUSB_SUCCESS) { printf(声明接口失败: %s\n, libusb_error_name(ret)); libusb_close(dev_handle); libusb_exit(ctx); return 1; } printf(接口 %d 声明成功。\n, interface_number); // ... 在这里进行数据传输下一节讲 // 使用完毕后必须释放接口并关闭设备 libusb_release_interface(dev_handle, interface_number); libusb_close(dev_handle); libusb_exit(ctx); printf(设备已关闭资源已释放。\n); return 0; }这里有几个关键点libusb_open 这是建立连接的关键。拿到libusb_device_handle句柄后续所有数据传输都靠它。libusb_claim_interface 这一步至关重要可以理解为“独占这个USB设备的某个功能”。如果不声明接口操作系统自带的驱动比如对于HID设备可能会占着它导致你的程序无法进行数据传输。在Windows上你可能还需要先分离内核驱动libusb_detach_kernel_driver再声明接口。资源管理像C语言很多库一样libusb要求你“有借有还”。claim了接口最后一定要releaseopen了设备最后一定要closeinit了上下文最后一定要exit。养成好习惯避免内存和资源泄漏。4. 实战数据传输控制、批量、中断传输详解USB有四种传输类型控制Control、批量Bulk、中断Interrupt、等时Isochronous。libusb-1.0对前三种提供了非常直接的同步API等时传输通常用于音频、视频等实时流需要用到更复杂的异步接口。我们先搞定最常用的三种。4.1 控制传输设备的“管理通道”控制传输是USB中最基础、必有的传输类型。用于设备枚举、配置、获取描述符、发送自定义命令等。它的函数原型看起来参数很多但结构清晰int libusb_control_transfer(libusb_device_handle *dev_handle, uint8_t bmRequestType, // 请求类型方向、类型、接收方 uint8_t bRequest, // 请求码 uint16_t wValue, // 值具体含义依赖请求 uint16_t wIndex, // 索引通常指接口或端点号 unsigned char *data, // 数据缓冲区指针 uint16_t wLength, // 数据缓冲区期望长度 unsigned int timeout); // 超时时间毫秒举个例子我们想向设备发送一个自定义的“点亮LED”命令。假设设备文档定义发送一个控制写请求bmRequestType0x40请求码bRequest0x01wValue表示LED状态1开/0关wIndex未使用设为0。unsigned char led_on 1; // 点亮LED int transferred 0; int ret libusb_control_transfer(dev_handle, 0x40, // 方向主机-设备类型厂商自定义接收方设备 0x01, // 自定义请求码SET_LED 1, // wValue: LED状态为开 (1) 0, // wIndex: 未使用 led_on, // 数据指针对于无数据的控制写可以为NULL 1, // 数据长度 1000); // 超时1秒 if (ret 0) { printf(控制传输成功发送了 %d 字节。\n, ret); } else { printf(控制传输失败: %s\n, libusb_error_name(ret)); }4.2 批量传输大量数据的“搬运工”批量传输用于传输大量数据保证数据的正确性有错误重传但不保证延迟和速度。非常适合文件传输、打印数据等场景。函数很简单int libusb_bulk_transfer(libusb_device_handle *dev_handle, unsigned char endpoint, // 端点地址方向包含在最高位 unsigned char *data, int length, int *actual_length, // 实际传输的字节数输出参数 unsigned int timeout);端点地址Endpoint是USB通信的“门户”。它是一个8位的数最低4位是端点编号最高位表示方向0表示OUT主机到设备1表示IN设备到主机。例如0x81表示端点1的IN方向。假设我们要从设备的端点0x81IN读取最多512字节的数据unsigned char buffer[512]; int actual_length 0; int ret libusb_bulk_transfer(dev_handle, 0x81, // 端点地址端点1IN方向 buffer, sizeof(buffer), actual_length, 2000); // 超时2秒 if (ret LIBUSB_SUCCESS) { printf(批量读取成功收到 %d 字节数据。\n, actual_length); // 处理 buffer 中的数据... } else if (ret LIBUSB_ERROR_TIMEOUT) { printf(批量读取超时可能设备没数据。\n); } else { printf(批量读取失败: %s\n, libusb_error_name(ret)); }4.3 中断传输及时响应的“小信使”中断传输用于传输小量、需要及时响应的数据比如USB鼠标的移动坐标、键盘的按键事件。它的API和批量传输一模一样只是函数名不同int libusb_interrupt_transfer(libusb_device_handle *dev_handle, unsigned char endpoint, unsigned char *data, int length, int *actual_length, unsigned int timeout);用法和libusb_bulk_transfer完全一致只是底层USB调度策略不同。你需要根据设备描述符中定义的端点类型来选择正确的函数。4.4 传输模式对比与选择为了更直观我把这三种常用传输类型的特点总结成下表特性控制传输 (Control)批量传输 (Bulk)中断传输 (Interrupt)主要用途设备配置、状态查询、自定义命令大量数据块传输文件、打印小量、周期性、需及时响应的数据HID设备数据可靠性高有错误重传高有错误重传高有错误重传传输速度低速每个帧最多预留一些带宽高利用空闲带宽中每个帧预留固定带宽延迟保证无无有保证最大延迟典型端点端点0所有设备都有0x02, 0x82, 0x04, 0x84...0x81, 0x01...libusb函数libusb_control_transferlibusb_bulk_transferlibusb_interrupt_transfer怎么选这不由你决定而是由你的USB设备硬件设计决定。你需要在设备的说明书或USB描述符里查清楚每个端点Endpoint支持什么类型的传输。然后“对号入座”调用对应的libusb函数。5. 进阶技巧异步传输、热插拔与错误处理当你掌握了同步传输就可以应对大部分场景了。但如果你想追求更高的性能比如不间断地收发数据或者需要更优雅地处理设备插拔就需要了解进阶功能。5.1 异步传输不阻塞的高性能之道同步传输函数bulk_transfer,interrupt_transfer会一直阻塞直到传输完成或超时。这在处理大量数据或需要同时管理多个传输时会拖慢整个程序。异步传输则不同你提交一个传输请求函数立刻返回然后你的程序可以继续做别的事情。等传输完成了libusb会在后台调用你指定的回调函数来通知你。这需要配合事件处理循环来使用。#include libusb-1.0/libusb.h struct transfer_context { int completed; // 你可以在这里放任何你想传递给回调函数的数据 }; static void LIBUSB_CALL async_transfer_callback(struct libusb_transfer *transfer) { struct transfer_context *ctx (struct transfer_context *)transfer-user_data; printf(异步传输完成状态: %s, 实际传输字节: %d\n, libusb_error_name(transfer-status), transfer-actual_length); ctx-completed 1; } int perform_async_bulk_transfer(libusb_device_handle *dev_handle) { unsigned char buffer[4096]; struct transfer_context ctx {0}; struct libusb_transfer *transfer; // 1. 分配一个传输结构体 transfer libusb_alloc_transfer(0); if (!transfer) { return LIBUSB_ERROR_NO_MEM; } // 2. 填充传输结构体 // 这是一个批量IN传输从端点0x81读取数据 libusb_fill_bulk_transfer(transfer, dev_handle, 0x81, // 端点地址 buffer, sizeof(buffer), async_transfer_callback, ctx, // 用户数据指针会传给回调函数 0); // 超时(0表示无限等待由事件循环控制) // 3. 提交传输 int ret libusb_submit_transfer(transfer); if (ret ! LIBUSB_SUCCESS) { libusb_free_transfer(transfer); return ret; } // 4. 运行事件循环等待传输完成 // 在实际应用中这个循环可能在一个单独的线程或者集成到GUI的主事件循环中 while (!ctx.completed) { // 处理任何挂起的事件timeout是毫秒0表示非阻塞 ret libusb_handle_events_completed(NULL, NULL); if (ret 0) { // 处理错误比如取消传输 libusb_cancel_transfer(transfer); break; } // 这里可以做一些其他工作... // usleep(1000); // 避免忙等待可以短暂休眠 } // 5. 传输完成后释放资源 // 注意在回调函数被调用后传输结构体才可以被安全释放 // 这里因为我们在回调里只设置了标志位所以可以在这里释放 libusb_free_transfer(transfer); return LIBUSB_SUCCESS; }异步传输的流程是分配 - 填充 - 提交 - 事件循环等待 - 回调处理 - 释放。它更复杂但给了你最大的灵活性和性能潜力。5.2 热插拔支持优雅地迎接设备到来和离开如果你的程序需要长时间运行并且动态响应USB设备的插入和拔出热插拔回调就非常有用。注意这个功能在Windows上默认是不支持的需要在初始化时设置选项。static int LIBUSB_CALL hotplug_callback(libusb_context *ctx, libusb_device *dev, libusb_hotplug_event event, void *user_data) { struct libusb_device_descriptor desc; libusb_get_device_descriptor(dev, desc); if (event LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED) { printf(设备已插入: %04X:%04X\n, desc.idVendor, desc.idProduct); // 这里可以自动打开设备或者更新UI列表 } else if (event LIBUSB_HOTPLUG_EVENT_DEVICE_LEFT) { printf(设备已拔出: %04X:%04X\n, desc.idVendor, desc.idProduct); // 这里可以清理设备相关的资源 } return 0; } int setup_hotplug(libusb_context *ctx) { // 检查当前平台是否支持热插拔 if (!libusb_has_capability(LIBUSB_CAP_HAS_HOTPLUG)) { printf(当前平台不支持热插拔通知。\n); return -1; } libusb_hotplug_callback_handle callback_handle; int ret libusb_hotplug_register_callback(ctx, LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED | LIBUSB_HOTPLUG_EVENT_DEVICE_LEFT, LIBUSB_HOTPLUG_NO_FLAGS, LIBUSB_HOTPLUG_MATCH_ANY, // 匹配任何VID LIBUSB_HOTPLUG_MATCH_ANY, // 匹配任何PID LIBUSB_HOTPLUG_MATCH_ANY, // 匹配任何设备类 hotplug_callback, NULL, // 用户数据 callback_handle); if (LIBUSB_SUCCESS ! ret) { printf(注册热插拔回调失败。\n); } else { printf(热插拔监听已启动。\n); } return ret; } // 在主循环中你需要定期调用 libusb_handle_events() 来处理热插拔事件。5.3 错误处理让你的程序更健壮libusb的函数基本都返回一个整数错误码。libusb_error_name()可以把它转换成可读的字符串。一些常见的错误你需要特别处理LIBUSB_ERROR_NO_DEVICE: 设备已断开。这是异步传输和长时间运行程序中最常见的错误之一。你的代码需要能优雅地处理比如关闭无效的句柄清理资源。LIBUSB_ERROR_TIMEOUT: 传输超时。对于批量传输可能只是设备暂时没数据对于控制传输可能是命令不被支持。根据场景决定是重试还是报错。LIBUSB_ERROR_ACCESS: 权限不足。在Linux上很常见需要配置udev规则或者让你的程序以root权限运行不推荐。更好的做法是创建一个udev规则文件比如/etc/udev/rules.d/99-mydevice.rules内容类似SUBSYSTEMusb, ATTR{idVendor}1234, ATTR{idProduct}5678, MODE0666然后重新插拔设备。LIBUSB_ERROR_BUSY: 资源被占用比如接口已被声明。确保你的程序没有重复声明或者操作系统驱动没有占用它记得detach_kernel_driver。一个健壮的程序应该对所有libusb API调用进行错误检查并设计好资源清理路径goto cleanup模式在这里很常用。6. 跨平台构建与实战踩坑指南让同一份代码在Windows、Linux、macOS上都能编译运行是libusb的核心价值但也需要一些技巧。6.1 项目配置与编译Linux/macOS (使用CMake示例):cmake_minimum_required(VERSION 3.10) project(MyUsbTool) find_package(PkgConfig REQUIRED) pkg_check_modules(LIBUSB REQUIRED libusb-1.0) add_executable(my_usb_tool main.c) target_include_directories(my_usb_tool PRIVATE ${LIBUSB_INCLUDE_DIRS}) target_link_libraries(my_usb_tool ${LIBUSB_LIBRARIES})编译mkdir build cd build cmake .. makeWindows (使用Visual Studio):下载编译好的libusb-1.0.dll和libusb-1.0.lib或者用vcpkg安装 (vcpkg install libusb)。在VS项目中添加头文件目录libusb-1.0所在目录的include子文件夹。添加库目录.lib文件所在目录。在“链接器 - 输入 - 附加依赖项”中添加libusb-1.0.lib。确保运行时libusb-1.0.dll和你的可执行文件在同一个目录或者放在系统路径下。6.2 我踩过的那些坑Windows上的驱动冲突这是新手最大的拦路虎。如果你的USB设备已经被系统自带的驱动比如WinUSB、HID等占用了libusb是打不开它的。你需要用工具如Zadig为设备安装libusb-win32或WinUSB驱动。重要提示操作前务必确认设备装错驱动可能导致键盘鼠标失灵需要重启到安全模式修复。接口声明失败在Linux上如果你没有权限或者设备被内核驱动如usbhid绑定libusb_claim_interface会失败。解决方案写udev规则赋予权限或者在打开设备后、声明接口前尝试libusb_detach_kernel_driver。传输超时与ZLPZero Length Packet对于批量传输当数据长度恰好是端点最大包大小的整数倍时设备可能期待主机发送一个长度为0的包来表示传输结束。如果你没发传输可能会挂起直到超时。有些libusb的高级API或异步传输能自动处理但自己写同步传输时要注意。异步传输的内存管理libusb_transfer结构体和它里面的数据缓冲区必须在你确认回调函数执行完毕、不再需要之后才能释放。否则会导致程序崩溃。我习惯在回调函数里释放或者用一个状态机来管理。多线程安全libusb的上下文libusb_context不是线程安全的。但你可以为每个线程创建独立的上下文libusb_init或者使用libusb_set_option(ctx, LIBUSB_OPTION_THREAD_SAFE, 1)来启用线程安全支持如果平台支持的话。更常见的做法是在一个专用线程里运行libusb_handle_events事件循环其他线程通过消息队列向其提交传输请求。6.3 调试小技巧开启详细日志在libusb_init之后立刻调用libusb_set_option(ctx, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_DEBUG)。你会看到控制台打印出非常详细的内部操作信息对定位问题极有帮助。使用lsusbLinux或USB Device Tree ViewerWindows这些工具可以让你直观地看到设备的拓扑结构、VID/PID、以及各个接口和端点的详细信息。写代码前先用它们确认你的设备信息。从官方示例开始libusb源码包的examples目录是宝藏。listdevs.c教你枚举xusb.c在libusb-win32包里有各种传输的完整例子。我强烈建议先把这些例子在你的环境下编译跑通再开始写自己的代码。7. 真实项目案例与一个USB HID设备通信让我们把这些知识串起来假设我们要和一个简单的USB HID人机接口设备比如自定义按钮盒通信。HID设备通常使用中断传输并且有一个报告描述符定义数据结构。步骤分解识别设备用lsusb或设备管理器找到设备的VID/PID。假设是0xcafe和0x4001。打开并声明接口和前面例子一样但HID设备通常只有一个接口编号0。处理内核驱动仅Linux在声明接口前检查并分离内核驱动。if (libusb_kernel_driver_active(dev_handle, 0) 1) { printf(发现内核驱动占用正在分离...\n); libusb_detach_kernel_driver(dev_handle, 0); } ret libusb_claim_interface(dev_handle, 0);读取中断数据HID设备的输入报告通常通过中断IN端点发送。假设端点地址是0x81。unsigned char report_buffer[64]; // HID报告长度常见的有8, 64字节 int actual_len; while (!should_quit) { ret libusb_interrupt_transfer(dev_handle, 0x81, report_buffer, sizeof(report_buffer), actual_len, 1000); // 每秒检查一次 if (ret LIBUSB_SUCCESS actual_len 0) { printf(收到HID报告: ); for (int i 0; i actual_len; i) { printf(%02X , report_buffer[i]); } printf(\n); // 解析 report_buffer根据你的设备协议处理 } else if (ret LIBUSB_ERROR_TIMEOUT) { // 超时是正常的继续循环 continue; } else { // 其他错误退出循环 break; } }发送数据如果需要通过中断OUT端点例如0x01发送报告。清理释放接口重新附着内核驱动可选关闭设备。这个流程覆盖了从设备发现、驱动处理、到持续数据收发的完整生命周期。在实际项目中你可能还需要解析复杂的HID报告描述符但这超出了libusb的基本范畴可能需要借助专门的HID解析库。libusb-1.0的强大之处在于一旦你掌握了这套模式无论是简单的数据采集卡还是复杂的多接口工业设备你都能用同一套思维模型和类似的代码结构去与之通信。它把平台差异的复杂性隐藏起来让你能专注于设备本身的协议逻辑。