libusb开发者指南.docxVIP

libusb开发者指南1 介绍1.1 概览1.2 当前OS支持2 API2.1 设备与接口2.2 超时2.3 数据类型2.4 同步2.5 返回值3 函数3.1 函数3.2 设备操作3.3 控制传输3.4 块传输3.5 中断传输3.6 不可移植4 例子4.1 简单例子4.2 源码包的例子4.3 其他应用本文档描述libusb的API，以及如何开发USB应用。1 介绍1.1 概览本文档描述libusb-0.1的API和USB相关内容。1.2 当前OS支持Linux 2.2或以上FreeBSD/NetBSD/OpenBSDDarwin/MacOSX2 API2.1 设备与接口一个设备可能有多个接口，所以一个句柄可以返回多个接口实例。不要忘记调用 usb_claim_interface() 。2.2 超时总是以毫秒为单位。2.3 数据类型同时使用有抽象结构和非抽象结构来保持可移植性。2.4 同步所有libusb v0.1的函数都是同步的，这意味着操作完成或超时前不会返回。异步操作从libusb v1.0开始支持。2.5 返回值libusb v0.1有两种返回值。一种是 usb_open() 返回的句柄，另一种是整数int，返回负数表示错误。3 函数3.1 函数void usb_init(void);初始化libusb。int usb_find_busses(void);查找所有总线，返回上次调用以后改变的数量(包括新增的和移除的总线)。int usb_find_devices(void);寻找每个总线上的所有设备。应该在 usb_find_busses() 之后调用。返回上次调用后改变的数量(包括新增和移除的设备)。struct usb_bus *usb_get_busses(void);简单的返回全局变量 usb_busses 。这仅对支持C调用规范和可以使用共享库的语言，但是不支持C全局变量的(例如Delphi)。3.2 设备操作这组函数用于操作设备。允许你打开关闭设备，设置配置、轮换设置、干净的关闭和重置设备。它也提供OS级别的操作，如认领(claim)和释放接 口。usb_dev_handle *usb_open(struct *usb_device dev);打开设备以供使用，返回设备句柄。int usb_close(usb_dev_handle *dev);关闭设备，返回0成功，负数失败。int usb_set_configuration(usb_dev_handle *dev, int configuration);设置活跃配置。configuration参数是描述符bConfigurationValue字段的值。返回0成功，负数失败。int usb_set_altinterface(usb_dev_handle *dev, int alternate);设置当前接口的活跃轮换设置。alternate参数是描述符bAlternateSetting字段的值。返回0成功，负数失败。int usb_resetep(usb_dev_handle *dev, unsigned int ep);重置指定端点的所有状态。ep参数是描述符的bEndpointAddress字段的值。返回0称公，负数失败。该接口不建议使用，你可能需要的是 usb_clear_halt() 。int usb_clear_halt(usb_dev_handle *dev, unsigned int ep);清理端点所有停止状态，ep是描述符bEndpointAddress字段的值。返回0成功，负数失败。int usb_reset(usb_dev_handle *dev);重置指定设备，通过发送RESET指令过去。返回0成功，负数失败。在执行该函数之后，需要重新列举，找到设备。当前的句柄无法再工作了。int usb_claim_interface(usb_dev_handle *dev, int interface);通过OS认领一个接口。interface参数是描述符的bInterfaceNumber字段。返回0成功，负数失败。必须在任何接口相关操作(如 usb_set_altinterface() 、 usb_bulk_write() 等)之前调用。返回码：EBUSY ：接口无效，无法被认领ENOMEM ：内存不足int usb_release_interface(usb_dev_handle *dev, int interface);释放之前认领的接口。interface参数是描述符的bInterfaceNumber字段。返回0成功，负数失败。3.3 控制传输发送消息到缺省控制管道。int usb_control_msg(usb_dev_handle *d