libusb 介紹

libusb是開源的C庫，使用該庫是的用戶可以在應用程序中直接訪問 USB 設備，無需為 USB 設備編寫內核驅動。libusb支持多個平臺 （linux, window, ios），所以可以很方便地將應用程序移植到其他平臺。

linux libusb 安裝

從網上下載libusb的源碼，下載地址：http://www.libusb.org/, 下載后編譯安裝。

# tar jxvf libusb-1.0.20.tar.bz2

# cd libusb-1.0.20

# ./configure

# make

# sudo make install

ubuntu下可以通過以下命令快速安裝。

sudo apt-get isntall libusb*

安裝后，libusb的頭文件被安裝在/usr/local/include/libusb-1.0 ，鏈接庫被安裝在/usr/loacal/lib目錄下。

usb bulk 傳輸例程

這個例程演示如何使用 libusb 庫，編寫 USB bulk xfer 上位機demo，可以正常接收和發送數據。注意，修改程序中的 VID 和 PID 的值和你 device 板子上所定義的一致，傳輸數據塊的大小不要超過 device 定義的最大傳輸長度。

#include

#include

#include

#include

#include "libusb.h"

#define VID 0x8888

#define PID 0x0088

#define edp2in 0x82

#define edp2out 0x02

int main(void)

{

    libusb_device **devs, *dev;

    int ret, i;

    ssize_t cnt;

    usb_pro_t usb_pro;

    struct libusb_device_handle *handle = NULL;

    libusb_context *ctx = NULL;

    ret = libusb_init(&ctx);

    if (ret < 0)

        return -1;

    libusb_set_debug(ctx, 3);

    cnt = libusb_get_device_list(NULL, &devs);

    if (cnt < 0) {

        printf("no usb dev on bus\r\n");

        return  -1;

    }

    i = 0;

    while((dev = devs[i++]) != NULL) {

        ret = libusb_get_device_descriptor(dev,&desc);

        if (ret < 0) {

            printf("failed to get device descriptor");

            goto error;

        }

        if ((desc.idVendor == VID) && (desc.idProduct == PID)) {

            printf("bLength: 0x%04x\r\n", desc.bLength);

            printf("bDescriptorType: 0x%04x\r\n", desc.bDescriptorType);

            printf("bcdUSB: 0x%04x\r\n", desc.bcdUSB);

            printf("bDeviceClass: 0x%04x\r\n", desc.bDeviceClass);

            printf("bDeviceSubClass: 0x%04x\r\n", desc.bDeviceSubClass);

            printf("bDeviceProtocol: 0x%04x\r\n", desc.bDeviceProtocol);

            printf("bMaxPacketSize0: 0x%04x\r\n", desc.bMaxPacketSize0);

            printf("vendor id: 0x%04x\r\n", desc.idVendor);

            printf("product id: 0x%04x\r\n", desc.idProduct);

            printf("bcdDevice: 0x%04x\r\n", desc.bcdDevice);

            printf("iManufacturer: 0x%04x\r\n", desc.iManufacturer);

            printf("iProduct: 0x%04x\r\n", desc.iProduct);

            printf("iSerialNumber: 0x%04x\r\n", desc.iSerialNumber);

            printf("bNumConfigurations: 0x%04x\r\n", desc.bNumConfigurations);

        }

    }

    handle = libusb_open_device_with_vid_pid(ctx, VID, PID);

    if (handle == NULL) {

        printf("cant't open device\r\n");

        goto error;

    } else {

        printf("open device\r\n");

    }

    libusb_free_device_list(devs, 1);

    if (libusb_kernel_driver_active(handle, 0) ==1) {

        printf("kernel driver active, detach it \r\n");

        if (libusb_detach_kernel_driver(handle, 0) == 0) {

            printf("detached kernel driver\r\n");

        }

        else {

            goto error;

        }

    }

    ret = libusb_claim_interface(handle, 0);

    if (ret < 0) {

        printf("can't claim interface\r\n");

        goto error;

    } else {

        printf("claimed interface\r\n");

    }

    char data[64];

    int actual_len = 0;

    int didi = 1000;

    for (int i = 0; i< 1000; i++) {

        memset(data, 0, sizeof(data));

        /*  receive data from device  */

        /*

        ret = libusb_bulk_transfer(handle, edp2in, data, 64, &actual_len, 0);

        if (actual_len = 0) {

            printf("received nothing\r\n");

        } else {

            printf("bulk transfer: %s\r\n", data);

        }

        usleep(200000);

        */

        char *str = "am host";

        sprintf(data, "am host %d\r\n", i);

        ret = libusb_bulk_transfer(handle, edp2out, data, strlen(data), &actual_len, 0);

        if (actual_len != 0) {

            printf("send data: %s\r\n", data);

        }

        usleep(200000); 

    }

    libusb_close(handle);

error:

    printf("free device list\r\n");

    libusb_free_device_list(devs, 1);

    libusb_exit(NULL);

    return 0;

}

編譯

編譯代碼可以使用 makefile 文件，也可以是使用命令行命令編譯，這里給出兩種編譯方法。

makefile

CC = gcc

# your libusb library path, be careful your path.

LDIR = /usr/loacal/lib

# link flag

LFLAG = -lusb-1.0

# libusb hearder file path

INCLUDES = /usr/local/include/libusb-1.0

CFLAGS = -I$(INCLUDES) -std=c99

src = $(wildcard *.c)

obj = $(patsubst %.c, %.o, $(src))

.PHONY: all clean

all: main

main: $(obj)

    $(CC)   $(obj) -o main -L$(LDIR) $(LFLAG)

%.o:%.c

    $(CC) $(CFLAGS) -c $< -o $@

clean:

    @-rm -f main $(obj)

命令行編譯 

命令中-I/usr/local/include/libusb-1.0 告訴編譯器 libusb 的頭文件所在的路徑。-L/usr/local/lib/ 告訴鏈接器所要鏈接的庫文件路徑。-lusb-1.0 告訴編譯器需要鏈接 libusb-1.0.so這個庫。

 gcc -I/usr/local/include/libusb-1.0 -std=c99 main.c -o main -L/usr/local/lib/ -lusb-1.0

運行

編譯后會在當前目錄下生成一個名叫“main“的可執行文件，運行這個文件。如果打開USB設備時出錯提示permission error，那么使用

# sudo ./main

運行后，HOST每隔200ms 向 device 發送一個數據包。

源碼下載

我的源碼已上傳到http://download.csdn.net/detail/chengwenyang/9479835 ，包含STM32F4Discovery板子的 usb bulk 傳輸的工程文件和 使用 libusb 編寫的上位機程序。