libusbについての変更点

Top > libusbについて
追加された行はこの色です。
削除された行はこの色です。
libusbについてへ行く。
「[[libusb:http://libusb.sourceforge.net/]]」は簡単にUSB機器にアクセスできるように作られたC言語用ライブラリ。~
カーネルの変更や専用のドライバを必要としないので開発は楽。~
[[Windows版:http://pc.tantin.jp/tamori/soft/LibUsb-Win32.html]]も存在する

''－－目次－－''
#contents

*準備 [#e408aa67]
-「[[libusb:http://libusb.sourceforge.net/]]」がインストールされていなかったらインストールする。
--さまざまなディストリビューションにパッケージが用意されているので、インストールは簡単。
-アクセスするUSB機器のベンダーIDとプロダクトIDを調べる。機器の説明書や仕様書に載っている。
--分からなかったらつなげてみて「lsusb」コマンドを実行。([[Debian:http://www.debian.org/]]では[[usbutils:http://packages.debian.org/usbutils]]パッケージに含まれる)
 Bus 001 Device 001: ID 0123:4567
というように表示され、IDの後に続く最初の4桁(この場合0123)がベンダーID、後の4桁がプロダクトID(この場合4567)になる。

-''rootでないとデバイスにアクセスできない場合がある''ので注意。
--筆者はしばらくこれにはまった (^^; 
*プログラミング(はじめの方)[#r3464651]
USBの機器にあまり依存しない部分
**インクルード [#t3dd2089]
libusb用のヘッダーをincludeする
 #include <usb.h>
という行を入れる
**変数の定義 [#s9d69ba2]
USB用に使う変数を宣言
 struct usb_bus *bus;
 struct usb_device *dev;
 usb_dev_handle *dh;
**初期化 [#mebdf58b]
あまり考えずに以下の行を書き込む
 usb_init();
 usb_find_busses();
 usb_find_devices();
**デバイスを見つける [#f7a9349a]
デバイスがつながっているか見つける。「VENDOR_ID」と「PRODUCT_ID」にベンダーIDとプロダクトIDを入れておく。
 for (bus = usb_get_busses(); bus; bus = bus->next) {
    for (dev = bus->devices; dev; dev = dev->next) {
	if (dev->descriptor.idVendor == VENDOR_ID &&
	    dev->descriptor.idProduct == PRODUCT_ID) {
	    goto device_found;
	}
    }
 }
 /* デバイスが見つからなかった場合 */
 fprintf(stderr, "Device not found.\n");
 exit(1);
 /* デバイスが見つかった場合 */
 device_found:
 printf("Device Found!!\n"); /* 確認用*/
**デバイスを開く [#qcdaed88]
単純には
 /*USB Open*/
 dh = usb_open(dev);
エラートラップを付ける
 if( (dh=usb_open(dev))==NULL ){
   printf("usb_open Error.(%s)\n",usb_strerror());
   exit(1);
 }

最後に「usb_close」で閉じることを忘れない
 usb_close(dh);

デバイスを閉めておかないと次回プログラムを起動したときにちゃんと動かない。

**コンフィグレーションやインターフェースの要求 [#d9cd4039]
 if(usb_set_configuration(dh,dev->config->bConfigurationValue)<0){
        if(usb_detach_kernel_driver_np(dh,dev->config->interface->altsetting->bInterfaceNumber)<0 ){
            printf("usb_set_configuration Error.\n");
            printf("usb_detach_kernel_driver_np Error.(%s)\n",usb_strerror());
        }
 }
 if(usb_claim_interface(dh,dev->config->interface->altsetting->bInterfaceNumber)<0 ){
        if(usb_detach_kernel_driver_np(dh,dev->config->interface->altsetting->bInterfaceNumber)<0 ){
            printf("usb_claim_interface Error.\n");
            printf("usb_detach_kernel_driver_np Error.(%s)\n",usb_strerror());
        }
    }
 
 if(usb_claim_interface(dh,dev->config->interface->altsetting->bInterfaceNumber)<0 ){
        printf("usb_claim_interface Error.(%s)\n",usb_strerror());
    }
*USBの仕様に合わせて書いていく部分 [#v728d138]
アクセスするUSBデバイスの「bmRequestType」や「bRequest」、「wValue」、「wIndex」、「wLength」などとエンドポイントなどを調べておく必要がある。~
**メッセージ、コマンドを送る [#a488dbd4]
それぞれの変数(bmRequestType, bRequest, wValue, wIndex,timeout)を宣言しておく必要がある。これらは上述の値を使う。~
USB機器から帰ってくる応答は「msg(配列)」に格納される。ここでは返答は8バイトを想定している。
 unsigned char msg[8];
 int result=usb_control_msg(dh, bmRequestType, bRequest, wValue, wIndex, msg, sizeof(msg), timeout);
 if(result<0){printf ("Control message error. (%s)\n", usb_strerror());}
resultの結果は本来「sizeof(msg)」と同じはず。
**バルクデータを読む [#sa5b89e9]
「bytes」バイトだけバルクモードで読み込む。読み込んだデータは「readbuf(配列)」に格納される。~
「end_point」は機器で指定されたもの。
 result=usb_bulk_read(dh, end_point, readbuf, bytes, timeout);
 if(result<0){printf ("bulk read error. (%s)\n", usb_strerror());}
resultの結果が負の場合エラーだけれど、本来resultの値は「bytes」と同じはずなのでエラートラップを下のように厳しくしてもいい。
 result=usb_bulk_read(dh, end_point, readbuf, bytes, timeout);
 if(result < bytes){printf ("bulk read error. (%s)\n", usb_strerror());}
**デバイスを閉じる [#b083b840]
最後に「usb_close」で閉じることを忘れない
 usb_close(dh);
*サンプル [#ba0fa903]
簡単なサンプル。デバイスを見つけて開いて閉じるだけ。
#ref(test_libusb0.c)

その他、[[EZ-USB>EZ-USB関係]] FX2用のサンプルを「[[EZ-USB FX2>EZ-USB/FX2]]」に置いておく。
*コンパイル [#h086addf]
コンパイルするときは「-lusb」というオプションをつける。
 gcc -lusb -o hoge hoge.c
上のサンプルなら
 gcc -lusb -o test_libusb0 test_libusb0.c
----
*[[リファレンス:http://libusb.sourceforge.net/doc/]] [#vddd2436]
**[[Core:http://libusb.sourceforge.net/doc/ref.core.html]] [#m26e0b97]
***[[usb_init:http://libusb.sourceforge.net/doc/function.usbinit.html]] [#m47387bf]
初期化。一番初めに呼ぶ。
 void usb_init(void);
***[[usb_find_busses:http://libusb.sourceforge.net/doc/function.usbfindbusses.html]] [#j1fac14a]
全てのUSBバスを見つける。返す値は前回呼ばれたときのバスの数と今のバスの数の違い
 int usb_find_busses(void);
***[[usb_find_devices:http://libusb.sourceforge.net/doc/function.usbfinddevices.html]] [#vdc03bf4]
つながっているUSBデバイスを探す。usb_find_bussesの後に呼ぶ必要がある。返す値は前回との違い
 int usb_find_devices(void);
***[[usb_get_busses:http://libusb.sourceforge.net/doc/function.usbgetbusses.html]] [#z54e3b7a]
見つかったUSBバスのリストを返す
 struct usb_bus *usb_get_busses(void);
**[[Device operations:http://libusb.sourceforge.net/doc/ref.deviceops.html]] [#g5563090]
***[[usb_open:http://libusb.sourceforge.net/doc/function.usbopen.html]] [#o0f8c94d]
USBデバイスを開く。いろいろな操作の前に開く必要がある。USBデバイスのハンドルを返す
 usb_dev_handle *usb_open(struct *usb_device dev);
***[[usb_close:http://libusb.sourceforge.net/doc/function.usbclose.html]] [#y7488693]
USBデバイスを閉じる。いろいろな操作の後に閉める。成功すると0を返して失敗すると負の値を返す
 int usb_close(usb_dev_handle *dev);
***[[usb_set_configuration:http://libusb.sourceforge.net/doc/function.usbsetconfiguration.html]] [#t3f84f92]
デバイスの設定を行う。成功すると0を返して失敗すると負の値を返す
 int usb_set_configuration(usb_dev_handle *dev, int configuration);
「configuration」にはUSBデバイスが指定している「bConfigurationValue」の値を入れる
***[[usb_set_altinterface:http://libusb.sourceforge.net/doc/function.usbsetaltinterface.html]] [#k2085e28]
現在使用中のデバイスの代替設定を行う。成功すると0を返して失敗すると負の値を返す
 int usb_set_altinterface(usb_dev_handle *dev, int alternate);
「alternate」にはUSBデバイスで指定している「bAlternateSetting」の値を入れる
//***[[usb_resetep:http://libusb.sourceforge.net/doc/function.usbresetep.html]]
//エンドポイントをリセット。成功すると0を返して失敗すると負の値を返す
// int usb_resetep(usb_dev_handle *dev, unsigned int ep);
***[[usb_clear_halt:http://libusb.sourceforge.net/doc/function.usbclearhalt.html]] [#bd0160ec]
エンドポイントをクリアする。成功すると0を返して失敗すると負の値を返す
 int usb_clear_halt(usb_dev_handle *dev, unsigned int ep);
「ep」はエンドポイント。「bEndpointAddress」の値を入れる
***[[usb_reset:http://libusb.sourceforge.net/doc/function.usbreset.html]] [#m7ca00f6]
デバイスをリセット。成功すると0を返して失敗すると負の値を返す
 int usb_reset(usb_dev_handle *dev);
これを使った後はまた初期化プロセスを行う必要があるみたい
***[[usb_claim_interface:http://libusb.sourceforge.net/doc/function.usbclaiminterface.html]] [#v4361e79]
デバイスのインターフェースを要求。成功すると0を返して失敗すると負の値を返す
 int usb_claim_interface(usb_dev_handle *dev, int interface);
「interface」にはUSBデバイスが指定している「bInterfaceNumber」をいれる~
このインターフェースに関係した関数（「usb_set_altinterface」や「usb_bulk_write」）などの前に呼ぶ必要がある 
***[[usb_release_interface:http://libusb.sourceforge.net/doc/function.usbreleaseinterface.html]] [#lab4e480]
前に要求されたインターフェースを開放。成功すると0を返して失敗すると負の値を返す
 int usb_release_interface(usb_dev_handle *dev, int interface);
「interface」にはUSBデバイスが指定している「bInterfaceNumber」をいれる
**[[Control Transfers:http://libusb.sourceforge.net/doc/ref.control.html]] [#p3bf3b75]
***[[usb_control_msg:http://libusb.sourceforge.net/doc/function.usbcontrolmsg.html]] [#gca505bb]
コントロールメッセージをデバイスに送る。成功すると読み書きしたバイト数を返し失敗すると負の値を返す
 int usb_control_msg(usb_dev_handle *dev, int requesttype, int request, int value, int index, char *bytes, int size, int timeout);
「bytes」に送るメッセージが入り、「size」はそのメッセージのバイト数。このサイズと成功した時に返される値は同じはず。~
「requesttype」、「request」、「index」などにはUSBデバイスが指定している値が入る
***[[usb_get_string:http://libusb.sourceforge.net/doc/function.usbgetstring.html]] [#b02cfe62]
デバイスから文字列を受け取る。成功すると受け取ったデータのバイト数を返し失敗すると負の値を返す
 int usb_get_string(usb_dev_handle *dev, int index, int langid, char *buf, size_t buflen);
「buflen」で指定した長さのデータを受け取る。「buflen」と成功した時に返される値は同じはず。~
「index」と「langid」で決められたデータを受け取る。受け取ったデータは「buf」に入る。
***[[usb_get_string_simple:http://libusb.sourceforge.net/doc/function.usbgetstringsimple.html]] [#p1a3f47a]
 int usb_get_string_simple(usb_dev_handle *dev, int index, char *buf, size_t buflen);
***[[usb_get_descriptor:http://libusb.sourceforge.net/doc/function.usbgetdescriptor.html]] [#s9833ff7]
 int usb_get_descriptor(usb_dev_handle *dev, unsigned char type, unsigned char index, void *buf, int size);
***[[usb_get_descriptor_by_endpoint:http://libusb.sourceforge.net/doc/function.usbgetdescriptorbyendpoint.html]] [#u7009c5d]
 int usb_get_descriptor_by_endpoint(usb_dev_handle *dev, int ep, unsigned char type, unsigned char index, void *buf, int size);
**[[Bulk Transfers:http://libusb.sourceforge.net/doc/ref.bulk.html]] [#e791f46c]
***[[usb_bulk_write:http://libusb.sourceforge.net/doc/function.usbbulkwrite.html]] [#ve6bbc6a]
「ep」で指定したエンドポイントへ「bytes」(「size」サイズ)のバルクデータを書き込む。成功すると送ったデータのバイト数を返し失敗すると負の値を返す
 int usb_bulk_write(usb_dev_handle *dev, int ep, char *bytes, int size, int timeout);
「size」と成功した時に返される値は同じはず。
***[[usb_bulk_read:http://libusb.sourceforge.net/doc/function.usbbulkread.html]] [#nb6ca1d6]
「ep」で指定したエンドポイントから「size」サイズのバルクデータを読み込み「bytes」に入れる。成功すると受け取ったデータのバイト数を返し失敗すると負の値を返す
 int usb_bulk_read(usb_dev_handle *dev, int ep, char *bytes, int size, int timeout);
「size」と成功した時に返される値は同じはず。
**[[Interrupt Transfers:http://libusb.sourceforge.net/doc/ref.interrupt.html]] [#ya1e0ea7]
***[[usb_interrupt_write:http://libusb.sourceforge.net/doc/function.usbinterruptwrite.html]] [#laf2a817]
「ep」で指定した割り込みエンドポイントへ「bytes」(「size」サイズ)のバルクデータを書き込む。成功すると送ったデータのバイト数を返し失敗すると負の値を返す
 int usb_interrupt_write(usb_dev_handle *dev, int ep, char *bytes, int size, int timeout);
「size」と成功した時に返される値は同じはず。
***[[usb_interrupt_read:http://libusb.sourceforge.net/doc/function.usbinterruptread.html]] [#rdf36392]
「ep」で指定した割り込みエンドポイントから「size」サイズのバルクデータを読み込み「bytes」に入れる。成功すると受け取ったデータのバイト数を返し失敗すると負の値を返す
 int usb_interrupt_read(usb_dev_handle *dev, int ep, char *bytes, int size, int timeout);
「size」と成功した時に返される値は同じはず。
**[[Non Portable:http://libusb.sourceforge.net/doc/ref.nonportable.html]] [#xc8780fe]
***[[usb_get_driver_np:http://libusb.sourceforge.net/doc/function.usbgetdrivernp.html]] [#w2e9e345]
 int usb_get_driver_np(usb_dev_handle *dev, int interface, char *name, int namelen);
***[[usb_detach_kernel_driver_np:http://libusb.sourceforge.net/doc/function.usbdetachkerneldrivernp.html]] [#j291e79b]
 int usb_detach_kernel_driver_np(usb_dev_handle *dev, int interface);
//**[[:]]
//***[[:]]
*参考リンク [#e78b43cf]
-[[USB-IOをFC5（Linux)で使用する＠バケさんの趣味の部屋:http://bake-san.com/usb004.htm]]
--libusbを用いてUSB-IOをコントロールしている。ソースも公開している

-[[CycFX2Prog]]
--libusbを用いてEZ-USBにアクセス。ソースも公開されているので参考になる。
libusbについて の変更点

libusbについての変更点
