libusb 是一個(gè)用C語(yǔ)言開發(fā)的跨平臺(tái)的USB設(shè)備訪問接口庫(kù)。

驅(qū)動(dòng)開發(fā)向來是內(nèi)核開發(fā)中工作量最多的一塊，隨著USB設(shè)備的普及，大量的USB設(shè)備的驅(qū)動(dòng)開發(fā)也成為驅(qū)動(dòng)開發(fā)者手頭上做的最多的事情。本文主要介紹Linux平臺(tái)下基于libusb的驅(qū)動(dòng)開發(fā)，希望能夠給從事Linux驅(qū)動(dòng)開發(fā)的朋友帶來些幫助，更希望能夠給其他平臺(tái)上的無驅(qū)設(shè)計(jì)帶來些幫助。文章是我在工作中使用libusb的一些總結(jié)，難免有錯(cuò)誤，如有不當(dāng)?shù)牡胤?#xff0c;還請(qǐng)指正。?[1] Linux 平臺(tái)上的usb驅(qū)動(dòng)開發(fā)，主要有內(nèi)核驅(qū)動(dòng)的開發(fā)和基于libusb的無驅(qū)設(shè)計(jì)。 對(duì)于內(nèi)核驅(qū)動(dòng)的大部分設(shè)備，諸如帶usb接口的hid設(shè)備，linux本身已經(jīng)自帶了相關(guān)的驅(qū)動(dòng)，我們只要操作設(shè)備文件便可以完成對(duì)設(shè)備大部分的操作，而另外一些設(shè)備，諸如自己設(shè)計(jì)的硬件產(chǎn)品，這些驅(qū)動(dòng)就需要我們驅(qū)動(dòng)工程師開發(fā)出相關(guān)的驅(qū)動(dòng)了。內(nèi)核驅(qū)動(dòng)有它的優(yōu)點(diǎn)，然而內(nèi)核驅(qū)動(dòng)在某些情況下會(huì)遇到如下的一些問題： 1 當(dāng)使用我們產(chǎn)品的客戶有2.4內(nèi)核的平臺(tái)，同時(shí)也有2.6內(nèi)核的平臺(tái)，我們要設(shè)計(jì)的驅(qū)動(dòng)是要兼容兩個(gè)平臺(tái)的，就連makefile 我們都要寫兩個(gè)。 2 當(dāng)我們要把linux移植到嵌入平臺(tái)上，你會(huì)發(fā)現(xiàn)原先linux自 帶的驅(qū)動(dòng)移過去還挺大的，我的內(nèi)核當(dāng)然是越小越好拉，這樣有必要么。這還不是最郁悶的地方，如果嵌入平臺(tái)是客戶的，客戶要購(gòu)買你的產(chǎn)品，你突然發(fā)現(xiàn)客戶設(shè) 備里的系統(tǒng)和你的環(huán)境不一樣，它沒有你要的驅(qū)動(dòng)了，你的程序運(yùn)行不了，你會(huì)先想：“沒關(guān)系，我寫個(gè)內(nèi)核驅(qū)動(dòng)加載一下不就行了“。卻發(fā)現(xiàn)客戶連insmod加載模塊的工具都沒移植，那時(shí)你就看看老天，說聲我怎么那么倒霉啊，客戶可不想你動(dòng)他花了n時(shí)間移植的內(nèi)核哦 3 花了些功夫?qū)懥藗€(gè)新產(chǎn)品的驅(qū)動(dòng)，挺有成就感啊，代碼質(zhì)量也是相當(dāng)?shù)挠兴疁?zhǔn)啊。正當(dāng)你沉醉在你的代碼中時(shí)，客服不斷的郵件來了，“客戶需要2.6.5內(nèi)核的驅(qū)動(dòng)，config文件我已經(jīng)發(fā)你了” “客戶需要雙核的 2.6.18-smp 的驅(qū)動(dòng)” “客戶的平臺(tái)是自己定制的是2.6.12-xxx “ 你恨不得把驅(qū)動(dòng)的源代碼給客戶，這樣省得編譯了。你的一部分工作時(shí)間編譯內(nèi)核，定制驅(qū)動(dòng) 有問題產(chǎn)生必然會(huì)有想辦法解決問題的人， libusb的出現(xiàn)給我們帶來了某些方便，即節(jié)約了我們的時(shí)間，也降低了公司的成本。 所以在一些情況下，就可以考慮使用libusb的無驅(qū)設(shè)計(jì)了。 下面我們就來詳細(xì)討論一下libusb, 并以寫一個(gè)hid設(shè)備的驅(qū)動(dòng)來講解如何運(yùn)用libusb,至于文章中涉及的usb協(xié)議的知識(shí)，限于篇幅，就不詳細(xì)講解了，相關(guān)的可自行查看usb相關(guān)協(xié)議。 一 libusb 介紹 libusb 設(shè)計(jì)了一系列的外部API 為應(yīng)用程序所調(diào)用，通過這些API應(yīng)用程序可以操作硬件，從libusb的源代碼可以看出，這些API 調(diào)用了內(nèi)核的底層接口，和kernel driver中所用到的函數(shù)所實(shí)現(xiàn)的功能差不多，只是libusb更加接近USB 規(guī)范。使得libusb的使用也比開發(fā)內(nèi)核驅(qū)動(dòng)相對(duì)容易的多。 Libusb 的編譯安裝請(qǐng)查看Readme,這里不做詳解 二 libusb 的外部接口 2.1 初始化設(shè)備接口 這些接口也可以稱為核心函數(shù)，它們主要用來初始化并尋找相關(guān)設(shè)備。 usb_init 函數(shù)定義： void usb_init(void); 從函數(shù)名稱可以看出這個(gè)函數(shù)是用來初始化相關(guān)數(shù)據(jù)的，這個(gè)函數(shù)大家只要記住必須調(diào)用就行了，而且是一開始就要調(diào)用的. usb_find_busses 函數(shù)定義： int usb_find_busses(void); 尋找系統(tǒng)上的usb總線，任何usb設(shè)備都通過usb總線和計(jì)算機(jī)總線通信。進(jìn)而和其他設(shè)備通信。此函數(shù)返回總線數(shù)。 usb_find_devices 函數(shù)定義： int usb_find_devices(void); 尋找總線上的usb設(shè)備，這個(gè)函數(shù)必要在調(diào)用usb_find_busses()后使用。以上的三個(gè)函數(shù)都是一開始就要用到的，此函數(shù)返回設(shè)備數(shù)量。 usb_get_busses 函數(shù)定義： struct usb_bus *usb_get_busses(void); 這個(gè)函數(shù)返回總線的列表，在高一些的版本中已經(jīng)用不到了，這在下面的實(shí)例中會(huì)有講解 2.2 操作設(shè)備接口 usb_open 函數(shù)定義： usb_dev_handle *usb_open(struct *usb_device dev); 打開要使用的設(shè)備，在對(duì)硬件進(jìn)行操作前必須要調(diào)用usb_open 來打開設(shè)備，這里大家看到有兩個(gè)結(jié)構(gòu)體usb_dev_handle 和 usb_device 是我們?cè)陂_發(fā)中經(jīng)常碰到的，有必要把它們的結(jié)構(gòu)看一看。在libusb 中的usb.h和usbi.h中有定義。 這里我們不妨理解為返回的 usb_dev_handle?指針是指向設(shè)備的句柄，而行參里輸入就是需要打開的設(shè)備。 usb_close 函數(shù)定義： int usb_close(usb_dev_handle *dev); 與usb_open相對(duì)應(yīng)，關(guān)閉設(shè)備，是必須調(diào)用的, 返回0成功，<0 失敗。 usb_set_configuration 函數(shù)定義： int usb_set_configuration(usb_dev_handle *dev, int configuration); 設(shè)置當(dāng)前設(shè)備使用的configuration，參數(shù)configuration 是你要使用的configurtation descriptoes中的bConfigurationValue, 返回0成功，<0失敗( 一個(gè)設(shè)備可能包含多個(gè)configuration,比如同時(shí)支持高速和低速的設(shè)備就有對(duì)應(yīng)的兩個(gè)configuration,詳細(xì)可查看usb標(biāo)準(zhǔn)) usb_set_altinterface 函數(shù)定義： int usb_set_altinterface(usb_dev_handle *dev, int alternate); 和名字的意思一樣，此函數(shù)設(shè)置當(dāng)前設(shè)備配置的interface descriptor，參數(shù)alternate是指interface descriptor中的bAlternateSetting。返回0成功，<0失敗 usb_resetep 函數(shù)定義： int usb_resetep(usb_dev_handle *dev, unsigned int ep); 復(fù)位指定的endpoint，參數(shù)ep 是指bEndpointAddress,。這個(gè)函數(shù)不經(jīng)常用，被下面介紹的usb_clear_halt函數(shù)所替代。 usb_clear_halt 函數(shù)定義： int usb_clear_halt (usb_dev_handle *dev, unsigned int ep); 復(fù)位指定的endpoint，參數(shù)ep 是指bEndpointAddress。這個(gè)函數(shù)用來替代usb_resetep usb_reset 函數(shù)定義： int usb_reset(usb_dev_handle *dev); 這個(gè)函數(shù)現(xiàn)在基本不怎么用，不過這里我也講一下，和名字所起的意思一樣，這個(gè)函數(shù)reset設(shè)備，因?yàn)橹貑⒃O(shè)備后還是要重新打開設(shè)備，所以用usb_close就已經(jīng)可以滿足要求了。 usb_claim_interface 函數(shù)定義： int usb_claim_interface(usb_dev_handle *dev, int interface); 注冊(cè)與操作系統(tǒng)通信的接口，這個(gè)函數(shù)必須被調(diào)用，因?yàn)橹挥凶?cè)接口，才能做相應(yīng)的操作。 Interface 指 bInterfaceNumber. (下面介紹的usb_release_interface 與之相對(duì)應(yīng)，也是必須調(diào)用的函數(shù)) usb_release_interface 函數(shù)定義： int usb_release_interface(usb_dev_handle *dev, int interface); 注銷被usb_claim_interface函數(shù)調(diào)用后的接口，釋放資源，和usb_claim_interface對(duì)應(yīng)使用。 2.3 控制傳輸接口 usb_control_msg 函數(shù)定義：int usb_control_msg(usb_dev_handle *dev, int requesttype, int request, int value, int index, char *bytes, int size, int timeout); 從默認(rèn)的管道發(fā)送和接受控制數(shù)據(jù) usb_get_string 函數(shù)定義： int usb_get_string(usb_dev_handle *dev, int index, int langid, char *buf, size_t buflen); usb_get_string_simple 函數(shù)定義： int usb_get_string_simple(usb_dev_handle *dev, int index, char *buf, size_t buflen); usb_get_descriptor 函數(shù)定義： int usb_get_descriptor(usb_dev_handle *dev, unsigned char type, unsigned char index, void *buf, int size); usb_get_descriptor_by_endpoint 函數(shù)定義： int usb_get_descriptor_by_endpoint(usb_dev_handle *dev, int ep, unsigned char type, unsigned char index, void *buf, int size); 2.4 批傳輸接口 usb_bulk_write 函數(shù)定義： int usb_bulk_write(usb_dev_handle *dev, int ep, char *bytes, int size, int timeout); usb_interrupt_read 函數(shù)定義： int usb_interrupt_read(usb_dev_handle *dev, int ep, char *bytes, int size, int timeout); 2.5 中斷傳輸接口 usb_bulk_write 函數(shù)定義： int usb_bulk_write(usb_dev_handle *dev, int ep, char *bytes, int size, int timeout); usb_interrupt_read 函數(shù)定義： int usb_interrupt_read(usb_dev_handle *dev, int ep, char *bytes, int size, int timeout);

總結(jié)

以上是生活随笔為你收集整理的libusb usb设备访问接口库的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。