libusb
原文地址
https://zhuanlan.zhihu.com/p/273598227
1 libusb_init
int libusb_init(libusb_context **ctx);
功能說明：該函數進行libusb的初始化，必須最先調用。
參數說明：ctx通常設置NULL
返回值：0成功，非0 失敗
2 libusb_exit
void libusb_exit(libusb_context *ctx);
功能說明：和libusb_init成對使用，釋放相應的資源。
參數說明：ctx通常設置NULL
3 libusb_has_capability
int libusb_has_capability(uint32_t capability);
功能說明：判斷當前的庫是否支持某項功能
參數說明：capability的取值范圍在 enum libusb_capability中定義。
LIBUSB_CAP_HAS_CAPABILITY libus庫的 API是否有效，該項通常總是返回1
LIBUSB_CAP_HAS_HOTPLUG 是否支持熱插拔
LIBUSB_CAP_HAS_HID_ACCESS 是否支持訪問HID設備，而不需要用戶干預
LIBUSB_CAP_SUPPORTS_DETACH_KERNEL_DRIVER 是否支持在內核中釋放默認的驅動也就是可以調用libusb_detach_kernel_driver來釋放內核驅動
返回值：非0 支持 ，0 不支持
4 libusb_hotplug_register_callback
int LIBUSB_CALL libusb_hotplug_register_callback(libusb_context *ctx,
libusb_hotplug_event events,
libusb_hotplug_flag flags,
int vendor_id, int product_id,
int dev_class,
libusb_hotplug_callback_fn cb_fn,
void *user_data,
libusb_hotplug_callback_handle *handle);
功能說明：注冊回調函數，響應熱插拔事件。
參數說明：ctx 通常為NULL
events 要響應的事件，參數為LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED設備插入事件 LIBUSB_HOTPLUG_EVENT_DEVICE_LEFT 設備拔出事件，也可以LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED|LIBUSB_HOTPLUG_EVENT_DEVICE_LEFT表示同時響應插拔事件
flags 如果為0，只有發生插拔的時候才會調用注冊的回調函數，如果為LIBUSB_HOTPLUG_ENUMERATE，則在初始化前設備已經插入，也會調用注冊的毀掉函數。
vendor_id 需要監控的VID，只有指定的VID的設備插拔，才會調用回調函數 。設置為LIBUSB_HOTPLUG_MATCH_ANY，則不判斷VID
product_id 需要監控的PID，如果設置為LIBUSB_HOTPLUG_MATCH_ANY，則不判斷PID
dev_class 需要監控的設備class,如果設置為LIBUSB_HOTPLUG_MATCH_ANY，則不判斷class。注意這里的class是與libusb_device_descriptor的class匹配，而不是 libusb_interface_descriptor的class
cb_fn 回調函數的指針 回調函數的定義為int LIBUSB_CALL hotplug_callback(libusb_context *ctx, libusb_device *dev, libusb_hotplug_event event, void *user_data)
user_data 用戶數據的指針 對應回調函數中的user_data
handle 句柄
返回值：0成功，非0 失敗
注意：不要在回調函數中調用可能阻塞的操作，否則可能造成libusb的其他函數執行失敗，不要在回調函數中調用libusb_claim_interface等操作，有可能會失敗
5 libusb_hotplug_deregister_callback
void LIBUSB_CALL libusb_hotplug_deregister_callback(
libusb_context *ctx,
libusb_hotplug_callback_handle handle);
參數說明：注銷libusb_hotplug_register_callback函數注冊的回調函數
參數說明：ctx 通常為NULL
handle libusb_hotplug_register_callback返回的句柄
返回值：無
6 libusb_handle_events
int LIBUSB_CALL libusb_handle_events(libusb_context *ctx);
功能說明：在阻塞模式中處理任何掛起的事件。
參數說明：ctx 通常為NULL
返回值：0成功，非0 失敗
注意：
1調用libusb_handle_events的線程，不要執行阻塞的操作，否則可能造成libusb其他函數執行失敗
2 如果注冊了熱插拔事件，必須要在循環中調用這個函數 例如下面的代碼如論怎么插拔USB設備，都不會打印“device insert”
static int LIBUSB_CALL hotplug_callback(libusb_context *ctx, libusb_device *dev, libusb_hotplug_event event, void *user_data)
{
printf("device insert \n");
}
int main(int argc, char **argv)
{
libusb_hotplug_callback_handle hp;
libusb_init (NULL);
libusb_hotplug_register_callback (NULL, LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED, LIBUSB_HOTPLUG_ENUMERATE, LIBUSB_HOTPLUG_MATCH_ANY,
LIBUSB_HOTPLUG_MATCH_ANY, 0, hotplug_callback, NULL, &hp);
while(1);
libusb_hotplug_deregister_callback(hp);
}
必須要改為下面的代碼,插拔USB才會有“device insert” 的信息
static int LIBUSB_CALL hotplug_callback(libusb_context *ctx, libusb_device *dev, libusb_hotplug_event event, void *user_data)
{
printf("device insert \n");
}
int main(int argc, char **argv)
{
libusb_hotplug_callback_handle hp;
libusb_init (NULL);
libusb_hotplug_register_callback (NULL, LIBUSB_HOTPLUG_EVENT_DEVICE_ARRIVED, LIBUSB_HOTPLUG_ENUMERATE, LIBUSB_HOTPLUG_MATCH_ANY,
LIBUSB_HOTPLUG_MATCH_ANY, 0, hotplug_callback, NULL, &hp);
while(1)
{
libusb_handle_events(NULL);
}
libusb_hotplug_deregister_callback(hp);
}
7 libusb_open_device_with_vid_pid
libusb_device_handle * LIBUSB_CALL libusb_open_device_with_vid_pid(libusb_context *ctx,
uint16_t vendor_id,
uint16_t product_id);
函數功能：通過VID和PID打開一個USB 設備，並返回設備句柄libusb_device_handle的指針
參數說明：ctx 通常為NULL
vendor_id 設備的VID
product_id 設備的PID
返回值：成功返回libusb_device_handle的指針 ，失敗返回NULL
8 libusb_open
int LIBUSB_CALL libusb_open(libusb_device *dev,
libusb_device_handle **handle);
函數功能：通過libusb_device的指針打開一個USB設備，並返回設備句柄libusb_device_handle的指針
參數說明：dev libusb_device的指針
handle 用來返回設備句柄libusb_device_handle的指針
返回值：0成功，非0 失敗
9 libusb_close
void LIBUSB_CALL libusb_close(libusb_device_handle *dev_handle);
函數功能：關閉 libusb_open或者libusb_open_device_with_vid_pid打開的設備
參數說明：dev_handle 調用libusb_open或者libusb_open_device_with_vid_pid返回的設備句柄libusb_device_handle的指針
返回值： 無
10 libusb_get_device_list
ssize_t LIBUSB_CALL libusb_get_device_list(libusb_context *ctx,
libusb_device ***list);
函數功能：獲取當前的設備列表
函數功能：ctx 通常為NULL
list USB設備列表
返回值：0成功，非0 失敗
11 libusb_free_device_list
void LIBUSB_CALL libusb_free_device_list(libusb_device **list,
int unref_devices);
函數功能：釋放以前使用的設備列表
參數說明：list 要釋放的設備列表的指針
unref_devices 如果該參數置1 列表中的每個設備的引用計數減1
返回值：無
注：下面是示例代碼：
libusb_device **devs;
ssize_t cnt;
int i;
libusb_init (NULL);
cnt = libusb_get_device_list(NULL, &devs);
for(i=0;i<cnt;i++)
{
PrintUsbDec(devs[i]);
}
libusb_free_device_list(devs, 1);
12 libusb_get_device_descriptor
int LIBUSB_CALL libusb_get_device_descriptor(libusb_device *dev,
struct libusb_device_descriptor *desc);
函數功能：獲取USB設備的設備描述符
參數說明：dev libusb_device的指針，是要讀取的設備
desc 設備描述符的指針，用來帶回設備描述符的結構
返回值：0成功，非0 失敗
注意：這個函數是將設備描述符的結構拷貝到desc指向的地址
所以,下面的用法是錯誤的
struct libusb_device_descriptor *desc;
libusb_get_device_descriptor(dev,desc);
正確的寫法是
struct libusb_device_descriptor desc;
libusb_get_device_descriptor(dev,&desc);
13 libusb_get_config_descriptor
int LIBUSB_CALL libusb_get_config_descriptor(
libusb_device *dev,
uint8_t config_index,
struct libusb_config_descriptor **config);
函數功能：獲取指定設備的配置描述符
參數說明：dev libusb_device的指針，是要讀取的設備
config_index 配置描述符的索引（一個USB設備可能有多個配置）
config 配置描述符的指針，用來帶回設備描述符
返回值：0成功，非0 失敗
14 libusb_free_config_descriptor
void LIBUSB_CALL libusb_free_config_descriptor(
struct libusb_config_descriptor *config);
函數功能：釋放配置描述符
參數說明：config 要釋放的配置描述符
返回值：無
注意： 用libusb_get_config_descriptor獲取配置描述符后必須要調用 libusb_free_config_descriptor釋放，否則會造成內存泄漏。
15 libusb_control_transfer
int LIBUSB_CALL libusb_control_transfer(
libusb_device_handle *dev_handle,
uint8_t request_type,
uint8_t bRequest,
uint16_t wValue,
uint16_t wIndex,
unsigned char *data,
uint16_t wLength,
unsigned int timeout);
參數說明：dev_handle libusb_device_handle的指針
request_type D7=0主機到設備， =1設備到主機；
D6D5 =00標准請求命令， 01 類請求命令，10用戶定義的命令，11保留值
D4D3D2D1D0= 0表示接收者為設備，1表示接收者為接口，2表示接收者為端點，3表示接收者為其他，其他值保留這個參數由 enum libusb_request_recipient 、enum libusb_request_type 、enum libusb_endpoint_direction 組合
bRequest 命令的序號(其實就是命令)；所有的命令都是以不同編碼值的方式傳遞給設備的，bRequest就表示USB命令的編碼值。可以是USB標准命令，也可以用戶自定義命令,標准請求命令定義在 enum libusb_standard_request
Value 2個字節，用來傳送當前請求的參數，隨請求不同而變。
Index 索引字段同樣是2個字節，描述的是接口號
data 要傳輸的數據的指針，不需要傳輸數據，設置為NULL
wLength 數據的長度。當命令不需要傳輸數據時，此字段設為0
timeout 設置超時的毫秒數，如果設置0，則永不超時
注：USB標准請求命令：
1.獲取狀態 Get Status (00H)
A:[To Device]獲取設備的狀態:
*.位0:自供電(0表示總線供電;1表示自供電).
*.位1:遠程喚醒(0表示不支持遠程喚醒;1表示遠程喚醒).
*.位2~15:保留.
*.一般選擇總線供電,不支持遠程喚醒,所以返回數據就是0x0000.
B:[To Interface]獲取接口的狀態:
*.接口狀態的16位字節全部保留,所以返回數據就是0x0000.
C:[To Endpoint]獲取端點的狀態:
*.位0:Halt(0表示端點允許;1表示端點禁止).
*.位1~15:保留(復位為0).
2.清除特性 Clear Feature (01H)
A:[To Device]清除設備的遠程喚醒功能,並返回一個空包.
B:[To Endpoint]解禁端點.
3.設置特性 Set Feature (03H)
A:[To Device]設置設備的遠程喚醒功能,並返回一個空包.
B:[To Endpoint]禁止端點.
4.設置地址 Set Address (05H)
A:設置設備地址.
5.獲取描述符 Get Descriptor (06H)
A:[To Device]獲取設備描述符:
*.描述當前USB協議的版本號.設備端點0的FIFO大小.USB設備的ID號等.
B:[To Configuration]獲取配置描述符:
*.描述USB設備接口個數及是否有自供電能力等.
C:[To Interface]獲取接口描述符:
*.描述端點0以外的物理端點個數等信息.
D:[To Endpoint]獲取端點描述符:
*.描述端點0各端點的傳輸類型和最大信息包大小和端點的傳輸方向(IN/OUT).
6.設置描述符(可選,無法更新) Set Descriptor (07H)
7.獲取配置信息 Get Configuration (08H)
8.設置配置 Set Configuration (09H)
A:[To Configuration]設置配置描述符.
B:[To Interface]設置接口描述符.
C:[To Endpoint]設置端點描述符.
9.獲取接口信息 Get Interface (0AH)
10.設置接口 Set Interface (0BH)
11.SYNCH_FRAME(0CH)
用於設備設置和報告一個端點的同步幀.
16 libusb_kernel_driver_active
int LIBUSB_CALL libusb_kernel_driver_active(libusb_device_handle *dev,
int interface_number);
函數功能：確定指定接口的內核驅動程序是否已經激活。如果一個內核驅動程序是激活的，libusb_claim_interface調用的會失敗
參數說明： dev 調用 libusb_open或者libusb_open_device_with_vid_pid返回的libusb_device_handle的句柄
interface_number 接口號，這個對應接口描述符的 bInterfaceNumber
返回值：1 已經激活，非1 沒有激活
17 libusb_detach_kernel_driver
int LIBUSB_CALL libusb_detach_kernel_driver(libusb_device_handle *dev,
int interface_number);
函數功能：卸載指定接口的內核驅動程序。如果一個內核驅動程序是激活的，必須先調用這個函數，再調用libusb_claim_interface
參數說明：dev 調用 libusb_open或者libusb_open_device_with_vid_pid返回的libusb_device_handle的句柄
interface_number 接口號，這個對應接口描述符的 bInterfaceNumber
返回值：0 成功，非0失敗
18 libusb_claim_interface
int LIBUSB_CALL libusb_claim_interface(libusb_device_handle *dev,
int interface_number);
函數功能：為指定的設備申請接口
參數說明：dev 調用 libusb_open或者libusb_open_device_with_vid_pid返回的libusb_device_handle的句柄
interface_number 接口號，這個對應接口描述符的 bInterfaceNumber
返回值：0 成功，非0失敗
19 libusb_release_interface
int LIBUSB_CALL libusb_release_interface(libusb_device_handle *dev,
int interface_number);
函數功能：釋放之前為指定的設備申請接口，注意這個函數只是釋放接口，不會重新加載內核驅動
參數說明：dev 調用 libusb_open或者libusb_open_device_with_vid_pid返回的libusb_device_handle的句柄
interface_number 接口號，這個對應接口描述符的 bInterfaceNumber
返回值：0 成功，非0失敗
20 libusb_attach_kernel_driver
int LIBUSB_CALL libusb_attach_kernel_driver(libusb_device_handle *dev,
int interface_number);
函數功能：加載指定接口的內核驅動
參數說明：dev 調用 libusb_open或者libusb_open_device_with_vid_pid返回的libusb_device_handle的句柄
interface_number 接口號，這個對應接口描述符的 bInterfaceNumber
返回值：0 成功，非0失敗
下面是示例代碼：
if(libusb_kernel_driver_active(handle, bInterfaceNumber) == 1) //判斷內核驅動時候加載
{
if(libusb_detach_kernel_driver(handle, bInterfaceNumber) == 0) //卸載驅動，例如我們操作的是一個U盤，那么執行到這里設備文件里面的U盤將消失
{
printf("Kernel Driver Detached!");
}
}
libusb_claim_interface(handle, bInterfaceNumber);
..........對設備進行讀寫操作
libusb_release_interface(handle, bInterfaceNumber); //釋放請求的接口
libusb_attach_kernel_driver(handle, bInterfaceNumber); //加載內核驅動，U盤將重新出現在設備文件里
21 libusb_set_auto_detach_kernel_driver
int LIBUSB_CALL libusb_set_auto_detach_kernel_driver(libusb_device_handle *dev,
int enable);
函數功能：設置自動卸載內核驅動，注意這個函數調用時不會卸載內核驅動，只是做標記。在調用libusb_claim_interface的時候卸載內核驅動
在調用libusb_release_interface的時候自動加載內核驅動
參數說明：dev 調用 libusb_open或者libusb_open_device_with_vid_pid返回的libusb_device_handle的句柄
enable 1 使能自動卸載的功能，0關閉
返回值：0 成功，非0失敗
例如 下面的代碼和上面的代碼效果等同
libusb_set_auto_detach_kernel_driver(handle,1);
libusb_claim_interface(handle, bInterfaceNumber); //請求接口之前先卸載內核驅動
..........對設備進行讀寫操作
libusb_release_interface(handle, bInterfaceNumber); //釋放請求的接口后自動加載內核驅動
22 libusb_bulk_transfer
int LIBUSB_CALL libusb_bulk_transfer(
libusb_device_handle *dev_handle,
unsigned char endpoint,
unsigned char *data,
int length,
int *actual_length,
unsigned int timeout);
函數功能：執行USB批量傳輸。該函數可以處理輸入和輸出，根據端點地址的方向位推斷傳輸方向，該函數采用同步模式，數據傳輸完畢才返回
參數說明： dev_handle 調用 libusb_open或者libusb_open_device_with_vid_pid返回的libusb_device_handle的句柄
endpoint 端點地址 最高位為1表示輸入
data 發送或者接收緩沖區指針
length 緩沖區長度
actual_length 帶回實際傳輸長度
timeout 超時的毫秒數，0 永不超時
返回值：0 成功，非0失敗
23 libusb_clear_halt
int LIBUSB_CALL libusb_clear_halt(
libusb_device_handle *dev,
unsigned char endpoint);
函數功能：清除端點的halt/stall狀態，libusb_bulk_transfer有可能返回LIBUSB_ERROR_PIPE，這是需要調用這個函數
參數說明：dev 調用 libusb_open或者libusb_open_device_with_vid_pid返回的libusb_device_handle的句柄
endpoint 出錯的端點地址
返回值：0 成功，非0失敗
24 libusb_interrupt_transfer
int LIBUSB_CALL libusb_interrupt_transfer(
libusb_device_handle *dev_handle,
unsigned char endpoint,
unsigned char *data,
int length,
int *actual_length,
unsigned int timeout);
函數功能：執行USB中斷傳輸。該函數可以處理輸入和輸出，根據端點地址的方向位推斷傳輸方向，該函數采用同步模式，數據傳輸完畢才返回
參數說明：dev_handle 調用 libusb_open或者libusb_open_device_with_vid_pid返回的libusb_device_handle的句柄
endpoint 端點地址 最高位為1表示輸入
data 發送或者接收緩沖區指針
length 緩沖區長度
actual_length 帶回實際傳輸長度
timeout 超時的毫秒數，0 永不超時
返回值：0 成功，非0失敗
25 libusb_set_configuration
int LIBUSB_CALL libusb_set_configuration(
libusb_device_handle *dev,
int configuration);
函數功能：為設備設置一個配置參數，大部分設備只有一個配置這個函數通常不需要調用。當某個USB設備有多個配置的時候需要設置
參數說明：dev 調用 libusb_open或者libusb_open_device_with_vid_pid返回的libusb_device_handle的句柄
configuration 配置參數，這個對應的是配置描述符里面的bConfigurationValue
返回值：0 成功，非0失敗