libusb API学习笔记-1

libusb API学习笔记-1

源码API文档

libusb源码API文档

1. 库功能

• 支持传输类型
• 控制 control/批量 bulk/中断 interrupt/同步 isochronous
  我只用过前两种，control用于AOA Commands发送。bulk用于读写数据
• 传输方式
  • 同步
  • 异步
• 线程安全
• 支持热插拔(但非所有平台都支持，例如支持Android平台)
• 调试 libusb使用的是stderr进行日志记录的,默认情况下，日志是被设置为NONE,是不输出的。但是libusb提供了接口去打开的。

libusb_set_option(context, LIBUSB_OPTION_LOG_LEVEL, LIBUSB_LOG_LEVEL_DEBUG);

2. 源码结构

.
├── android
│   └── jni
├── doc
├── examples
│   └── getopt
├── libusb
│   └── os
├── m4
├── msvc
├── tests
└── Xcode
    └── libusb.xcodeproj

2.1 tests/

• 关于libusb的四个压力测试，不涉USB打开操作及具体的数据传输。

2.2 android

• android平台使用的libusb.根据文件夹下的README得到以下需要做的内容步骤。
  但如果你是做Android平台开发的，你会发现源码里已经将libusb都涵盖进去了。
  路径：Android/external/libusb

libusb for Android
==================

Building:
---------

To build libusb for Android do the following:

 1. Download the latest NDK from:
    http://developer.android.com/tools/sdk/ndk/index.html

 2. Extract the NDK.

 3. Open a shell and make sure there exist an NDK global variable
    set to the directory where you extracted the NDK.

 4. Change directory to libusb's "android/jni"

 5. Run "$NDK/ndk-build".

The libusb library, examples and tests can then be found in:
    "android/libs/$ARCH"

Where $ARCH is one of:
    armeabi
    armeabi-v7a
    mips
    mips64
    x86
    x86_64

2.3 doc

• API文档所在地，跟官网上的API的一样的内容，需要自己编译一下。

2.4 examples

• 样例代码所在。想要查看使用方法的时候，可以选择来这里查看。例如hotplugtest.c，就提供了热插拔的样例代码。包括但不限于，获取系统当前的usb设备列表， 指纹图像保存。

2.5 libusb

• libusb的核心代码。子目录os是支持的各种平台，从文件名就可以看出来，例如‘windows_winusb.c’。具体的上网查了下，分别是"Linux, OS X, Windows, Windows CE, Android, OpenBSD/NetBSD, Haiku。"
  链接：Linux USB开发：libusb开发指南

2.6 m4 msvc Xcode

• 不是很清楚，上网查了下，不敢保证完全准确，结果如下：

msvc: 微软VC编译环境，目录下均是windows平台环境相关文件。
m4: linux编译相关。m4 是一种宏处理器，它扫描用户输入的文本并将其输出，期间如果遇到宏就将其展开后输出。
Xcode: apple平台相关文件。Xcode是苹果的集成开发环境（IDE），开发者可用其构建适用于苹果iPad、iPhone以及Mac设备的应用程序。
在应用程序的创建、测试、优化以及提交至App Store的过程中，Xcode为开发者提供了用以管理整个开发工作流的工具。

libusb API学习笔记-2

参考链接

Linux USB开发：libusb开发指南 感觉很详细，很值得看一下。