PyUSB 1.0を使用したプログラミング

翻訳者から ：

これは、 PyUSB 1.0マニュアルを使用したプログラミングの翻訳です

このガイドはPyUSB開発者によって書かれましたが、コミットをすばやく実行して、私はwalacが主な著者であると信じています。

自己紹介させて

PyUSB 1.0は、 USBへの簡単なアクセスを提供するPythonライブラリです。 PyUSBはさまざまな機能を提供します。

• Pythonで書かれた100％：
  
  Cで作成された0.xバージョンとは異なり、1.0バージョンはPythonで作成されています。 これにより、Cの経験のないPythonプログラマーは、PyUSBの動作をよりよく理解できます。
• プラットフォームの中立性：
  
  バージョン1.0には、フロントエンドバックエンドスキームが含まれています。 APIをシステム固有の実装の詳細から分離します。 IBackendインターフェイスは、これらの2つのレイヤーを接続します。 PyUSBには、libusb 0.1、libusb 1.0、およびOpenUSBの組み込みバックエンドが付属しています。 必要に応じて、自分でバックエンドを作成できます。
• 移植性：
  
  PyUSBは、Python> = 2.4、 ctypes 、およびサポートされている組み込みバックエンドの少なくとも1つを備えた任意のプラットフォームで実行する必要があります。
• シンプルさ：
  
  USBデバイスとのやり取りがこれまでになく簡単になりました！ USBは複雑なプロトコルであり、PyUSBには最も一般的な構成に適したプリセットがあります。
• 等時性歯車のサポート：
  
  PyUSBは、基になるバックエンドがアイソクロナス転送をサポートしている場合にサポートします。

PyUSBはUSBプログラミングの苦痛を軽減しますが、このチュートリアルでは、USBプロトコルに関する最低限の知識があることを前提としています。 USBについて何も知らない場合は、Jan Axelson の優れたUSB Completeブックをお勧めします。

十分に話して、コードを書きましょう！

誰が誰

始めるために、PyUSBモジュールの説明をしましょう。 すべてのPyUSBモジュールはusbの下にあり、次のモジュールがあります。

モジュール	説明
コア	メインUSBモジュール。
util	補助機能。
制御	標準管理リクエスト。
レガシー	バージョン0.x互換性レイヤー。
バックエンド	組み込みのバックエンドを含むサブパッケージ。

たとえば、 コアモジュールをインポートするには、次のように入力します。

>>> import usb.core >>> dev = usb.core.find()
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

さあ、始めましょう

以下は、最初に見つかったデータソース（エンドポイントOUT）に文字列「test」を送信する簡単なプログラムです。

  import usb.core import usb.util #    dev = usb.core.find(idVendor=0xfffe, idProduct=0x0001) #   ? if dev is None: raise ValueError('Device not found') #   .  ,   #    dev.set_configuration() #    cfg = dev.get_active_configuration() intf = cfg[(0,0)] ep = usb.util.find_descriptor( intf, #     custom_match = \ lambda e: \ usb.util.endpoint_direction(e.bEndpointAddress) == \ usb.util.ENDPOINT_OUT) assert ep is not None #   ep.write('test')
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

最初の2行はPyUSBパッケージモジュールをインポートします。 usb.coreはメインモジュールであり、 usb.utilにはヘルパー関数が含まれています。 次のコマンドは、デバイスを検索し、見つかった場合はオブジェクトのインスタンスを返します。 そうでない場合は、 Noneを返します。 次に、使用する構成を設定します。 注：引数がない場合、目的の構成がデフォルトで設定されたことを意味します。 ご覧のとおり、多くのPyUSB機能には、ほとんどの一般的なデバイスのデフォルト設定があります。 この場合、最初に見つかった構成が設定されます。



次に、関心のあるエンドポイントを探します。 私たちが持っている最初のインターフェース内でそれを探しています。 このポイントを見つけたら、そこにデータを送信します。



エンドポイントアドレスが事前にわかっている場合は、デバイスオブジェクトの書き込み関数を呼び出すだけです。

 dev.write(1, 'test')
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ここでは、アドレス1のブレークポイントに文字列「test」を書き込みます。 これらの機能はすべて、次のセクションで詳しく説明します。

何が悪いの？

PyUSBの各関数は、エラーが発生した場合に例外をスローします。 標準のPython例外に加えて、PyUSBはUSB関連エラーのusb.core.USBErrorを定義します。



PyUSBログ機能を使用することもできます。 ロギングモジュールを使用します。 これを使用するには、 critical 、 error 、 warning 、 infoまたはdebugのいずれかのログレベルでPYUSB_DEBUG環境変数を定義します。



デフォルトでは、メッセージはsys.stderrに送信されます 。 必要に応じて、環境変数PYUSB_LOG_FILENAMEを定義することにより、ログメッセージをファイルにリダイレクトできます。 その値がファイルへの正しいパスである場合、メッセージがそこに書き込まれます 。そうでない場合、メッセージはsys.stderrに送信されます 。

どこにいますか

コアモジュールのfind（）関数は、システムに接続されているデバイスの検索と番号付けに使用されます。 たとえば、デバイスのベンダーIDの値が0xfffeで、製品IDが0x0001であるとします。 このデバイスを見つける必要がある場合、これを行います。

 import usb.core dev = usb.core.find(idVendor=0xfffe, idProduct=0x0001) if dev is None: raise ValueError('Our device is not connected')
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

それだけです。関数は、デバイスを表すusb.core.Deviceオブジェクトを返します。 デバイスが見つからない場合、 Noneを返します。 実際、Device Descriptorクラスの任意のフィールドを使用できます。 たとえば、システムにUSBプリンターが接続されているかどうかを知りたい場合はどうでしょうか？ とても簡単です：

 #      ,   if usb.core.find(bDeviceClass=7) is None: raise ValueError('No printer found')
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

7は、USB仕様に従ったプリンタークラスのコードです。 ああ、待って、利用可能なすべてのプリンターに番号を付けたい場合はどうすればいいですか？ 問題ありません：

 #     ... printers = usb.core.find(find_all=True, bDeviceClass=7) # Python 2, Python 3,     import sys sys.stdout.write('There are ' + len(printers) + ' in the system\n.')
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

どうした さて、少し説明するための時間... findにはfind_allというパラメーターがあり 、デフォルトはFalseです。 偽のとき [1] 、 findは指定された基準に一致する最初のデバイスを返します（これについてはすぐに説明します）。 パラメータに真の値を渡すと、 findは代わりに条件に一致するすべてのデバイスのリストを返します。 以上です！ シンプルでしょ？



終わった？ いや！ まだすべてを説明していません。多くのデバイスは、実際にクラス情報をDevice DescriptorではなくInterface Descriptorに入れています。 したがって、システムに接続されているすべてのプリンターを本当に見つけるには、すべての構成とすべてのインターフェイスを調べ、インターフェイスの1つがbInterfaceClass 7に設定されているかどうかを確認する必要があります。これを実装できる簡単な方法はありますか。 答え：はい、そうです。 まず、接続されているすべてのプリンターを見つけるための既製のコードを見てみましょう。

 import usb.core import usb.util import sys class find_class(object): def __init__(self, class_): self._class = class_ def __call__(self, device): #  ,   if device.bDeviceClass == self._class: return True # ,   ,   # ,     for cfg in device: # find_descriptor:  ? intf = usb.util.find_descriptor( cfg, bInterfaceClass=self._class ) if intf is not None: return True return False printers = usb.core.find(find_all=1, custom_match=find_class(7))
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

custom_matchパラメーターは、デバイスオブジェクトを受け取る、呼び出されたオブジェクトを受け入れます。 適切なデバイスの場合はtrue、不適切なデバイスの場合はfalseを返す必要があります。 必要に応じて、 custom_matchとデバイスフィールドを組み合わせることもできます。

 #   ,    : printers = usb.core.find(find_all=1, custom_match=find_class(7), idVendor=0xfffe)
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ここでは、サプライヤ0xfffeのプリンタに興味があります。

自分を説明してください

さて、デバイスを見つけましたが、操作する前に、デバイスについて詳しく知りたいと思います。 構成、インターフェイス、エンドポイント、データストリームの種類...

デバイスがある場合は、オブジェクトプロパティとしてデバイス記述子の任意のフィールドにアクセスできます。

 >>> dev.bLength >>> dev.bNumConfigurations >>> dev.bDeviceClass >>> # ...
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

デバイスで使用可能な構成にアクセスするには、デバイスを反復できます。

 for cfg in dev: sys.stdout.write(str(cfg.bConfigurationValue) + '\n')
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

同様に、設定を繰り返してインターフェイスにアクセスしたり、インターフェイスを繰り返してコントロールポイントにアクセスしたりできます。 オブジェクトの各タイプには、属性として対応する記述子のフィールドがあります。 例を見てみましょう：

 for cfg in dev: sys.stdout.write(str(cfg.bConfigurationValue) + '\n') for intf in cfg: sys.stdout.write('\t' + \ str(intf.bInterfaceNumber) + \ ',' + \ str(intf.bAlternateSetting) + \ '\n') for ep in intf: sys.stdout.write('\t\t' + \ str(ep.bEndpointAddress) + \ '\n')
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

次のように、記述子へのランダムアクセスにインデックスを使用することもできます。

 >>> #      >>> cfg = dev[1] >>> #      >>> intf = cfg[(0,0)] >>> #    >>> ep = intf[2]
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ご覧のとおり、インデックスは0からカウントされます。しかし、待ってください！ インターフェースにアクセスする方法に奇妙な点があります...はい、そうです、Configurationのインデックスは一連の2つの値を取ります。最初の値はInterfaceインデックスで、2番目は代替設定です。 一般に、最初のインターフェイスにアクセスするために、2番目の設定では、 cfg [（0,1）]を記述します。



ここで、記述子を検索するための強力な方法-便利なfind_descriptor関数を学習します。 プリンタ検索の例ですでに見ました。 find_descriptorは、 findとほぼ同じように機能しますが 、2つの例外があります。

• find_descriptorは、検索するソース記述子を最初のパラメーターとして受け取ります。
• バックエンドパラメータはありません [2] 。

たとえば、 cfg構成記述子があり、インターフェイス1のすべての代替設定を検索する場合、次のようにします。

 import usb.util alt = usb.util.find_descriptor(cfg, find_all=True, bInterfaceNumber=1)
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

find_descriptorはusb.utilモジュールにあることに注意してください 。 また、 前述のcustom_matchパラメーターも受け入れます。



複数の同一のデバイスを扱っています



2つの同一のデバイスをコンピューターに接続できる場合があります。 どうすればそれらを区別できますか？ デバイスオブジェクトには、USB仕様の一部ではないが、非常に便利な2つの追加属性があります。 バス属性とアドレス属性です。 まず第一に、これらの属性はバックエンドからのものであり、バックエンドはそれらをサポートしていない可能性があります。この場合はNoneに設定されています。 ただし、これらの属性はデバイスバスの番号とアドレスを表し、ご想像のとおり 、同じidVendor属性値とidProduct属性値を持つ2つのデバイスを区別するために使用できます。

どうすればいいですか？

接続後、いくつかの標準クエリを使用してUSBデバイスを構成する必要があります。 USB仕様の検討を始めたとき、記述子、構成、インターフェイス、代替設定、転送タイプ、その他すべてにがっかりしました...そして最悪なのは、それらを無視することはできません：デバイスは、構成が設定されていなくても機能しないことです！ PyUSBはあなたの人生をできるだけシンプルにしようとしています。 たとえば、デバイスオブジェクトを受け取った後、まず操作する前に、 set_configurationリクエストを送信する必要があります。 関心のあるこのクエリの構成パラメーターはbConfigurationValueです。 ほとんどのデバイスには複数の構成があり、使用する構成値を追跡するのは面倒です（ただし、私が見たコードのほとんどはこれをハードコーディングしただけです）。 したがって、PyUSBでは、引数なしでset_configurationリクエストを送信するだけで済みます。 この場合、彼は最初に見つかった構成をインストールします（デバイスに1つしかない場合、構成値を心配する必要はまったくありません）。 たとえば、1つの構成記述子を持つデバイスがあり、そのbConfigurationValueフィールドが5であるとします [3] 、後続のクエリは同じように機能します。

 >>> dev.set_configuration(5) #  >>> dev.set_configuration() #  ,   5 -  #  >>> cfg = util.find_descriptor(dev, bConfigurationValue=5) >>> cfg.set() #  >>> cfg = util.find_descriptor(dev, bConfigurationValue=5) >>> dev.set_configuration(cfg)
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

わあ！ Configurationオブジェクトをset_configurationのパラメーターとして使用できます！ はい、彼は現在の設定で自分自身を設定するための設定メソッドも持っています。



構成する必要がある、または構成する必要がない別のオプションは、インターフェースを変更するオプションです。 各デバイスは一度に1つのアクティブ化された構成のみを持つことができ、各構成は複数のインターフェースを持つことができ、すべてのインターフェースを同時に使用できます。 インターフェイスを論理デバイスと考えると、この概念をよりよく理解できます。 例えば、多機能プリンターを想像してみましょう。これは同時にプリンターとスキャナーの両方です。 複雑にならないように（または、少なくともできるだけ単純にするために）、構成が1つしかないと仮定します。 なぜなら プリンターとスキャナーがあり、構成にはプリンター用とスキャナー用の2つのインターフェイスがあります。 複数のインターフェイスを持つデバイスは、複合デバイスと呼ばれます。 多機能プリンターをコンピューターに接続すると、オペレーティングシステムは2つの異なるドライバーをロードします。 [4] 。



代替インターフェース設定はどうですか？ あなたが尋ねたことは良いことです。 インターフェイスには、1つ以上の代替設定があります。 代替設定が1つだけのインターフェースには、代替設定がないと見なされます [5] 。 デバイスの構成としてのインターフェースの代替設定。つまり、各インターフェースに対して、アクティブな代替設定を1つだけ持つことができます。 たとえば、USB仕様では、デバイスの主要な代替構成にアイソクロナスチェックポイントを設定できないことが提案されています [6] 。したがって、ストリーミングデバイスには少なくとも2つの代替設定が必要であり、2番目の設定にはアイソクロナスチェックポイントが必要です。 ただし、構成とは異なり、代替構成が1つだけのインターフェースを構成する必要はありません。 [7] 。 set_interface_altsetting関数を使用して、代替インターフェース設定を選択します。

 >>> dev.set_interface_altsetting(interface = 0, alternate_setting = 0)
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

警告



USBの仕様では、追加の代替設定がないインターフェイスに対するSET_INTERFACE要求を受信した場合、デバイスはエラーを返すことが許可されています。 そのため、インターフェイスに複数の代替設定があること、またはSET_INTERFACE要求を受け入れることが確実でない場合、最も安全な方法は、 次のようにtry-exceptブロック内でset_interface_altsettingを呼び出すことです。

 try: dev.set_interface_altsetting(...) except USBError: pass
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

Interfaceオブジェクトを関数パラメーターとして使用することもできます。interfaceおよびalternate_settingパラメーターは、 bInterfaceNumberおよびbAlternateSettingフィールドから自動的に継承されます 。 例：

 >>> intf = find_descriptor(...) >>> dev.set_interface_altsetting(intf) >>> intf.set_altsetting() # !       
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

警告



インターフェイスオブジェクトは、アクティブな構成記述子に属している必要があります。

ハニー、私に話して

そして、USBデバイスと対話する方法を理解する時が来ました。 USBには、バルク転送、割り込み転送、アイソクロナス転送、コントロール転送の4種類のデータストリームがあります。 各スレッドの目的とそれらの違いを説明するつもりはありません。 したがって、少なくともUSBデータストリームの基本的な知識があることを前提としています。



制御データストリームは構造が仕様で説明されている唯一のストリームであり、残りは単純にUSBの観点から生データを送受信します。 したがって、制御フローを操作するためのさまざまな機能があり、残りのフローは同じ機能によって処理されます。



ctrl_transferメソッドを使用して、制御データストリームにアクセスできます。 発信（OUT）ストリームと着信（IN）ストリームの両方に使用されます。 フローの方向は、 bmRequestTypeパラメーターによって決定されます。



パラメーターctrl_transferは、制御要求の構造とほぼ一致しています。 以下は、制御データストリームを整理する方法の例です。 [8] ：

 >>> msg = 'test' >>> assert dev.ctrl_transfer(0x40, CTRL_LOOPBACK_WRITE, 0, 0, msg) == len(msg) >>> ret = dev.ctrl_transfer(0xC0, CTRL_LOOPBACK_READ, 0, 0, len(msg)) >>> sret = ''.join([chr(x) for x in ret]) >>> assert sret == msg
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

この例では、デバイスにループバックパイプのように動作する2つのユーザー制御要求が含まれていることを前提としています。 メッセージCTRL_LOOPBACK_WRITEで書いたものは、メッセージCTRL_LOOPBACK_READで読むことができます。



最初の4つのパラメーター-bmRequestType 、 bmRequest 、 wValueおよびwIndexは、制御ストリームの標準構造のフィールドです。 5番目のパラメーターは、発信データストリーム用に転送されるデータ、または着信ストリームで読み取られるデータの数です。 送信されるデータは、配列の__init__メソッドの入力にパラメーターとして供給することができる任意のタイプのシーケンスにすることができます。 転送されるデータがない場合、パラメーターはNone （着信データストリームの場合は0）に設定する必要があります。 操作のタイムアウトを示す別のオプションのパラメーターがあります。 渡さない場合、デフォルトのタイムアウトが使用されます（これについては後で説明します）。 発信データストリームでは、戻り値は実際にデバイスに送信されたバイト数です。 着信ストリームでは、戻り値はデータが読み取られた配列です。



他のストリームの場合、 writeメソッドとreadメソッドをそれぞれ使用して 、 データの書き込みと読み取りを行うことができます。 ストリームのタイプを心配する必要はありません。チェックポイントのアドレスによって自動的に検出されます。 ブレークポイント1にループバックパイプがある場合、ループバックの例を次に示します。

 >>> msg = 'test' >>> assert len(dev.write(1, msg, 100)) == len(msg) >>> ret = dev.read(0x81, len(msg), 100) >>> sret = ''.join([chr(x) for x in ret]) >>> assert sret == msg
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

最初と3番目のパラメーターは両方のメソッドで同じです-これはそれぞれチェックポイントアドレスとタイムアウトです。 2番目のパラメーターは、送信されるデータ（書き込み）または読み取るバイト数（読み取り）です。 返されるデータは、 読み取りメソッドの配列オブジェクトのインスタンス、または書き込みメソッドの書き込みバイト数のいずれかです。



ベータ2バージョンでは、バイト数の代わりに、 読み取り用に転送するか、データが読み取られる配列オブジェクトをctrl_transferできます。 この場合、読み込むバイト数は、配列の長さにarray.itemsizeの値を掛けたものになります。



ctrl_transferでは、 タイムアウトパラメータはオプションです。 タイムアウトを省略すると、 Device.default_timeoutプロパティが操作タイムアウトとして使用されます。

自分を制御する

データストリーム関数に加えて、 usb.controlモジュールは標準のUSB制御要求を含む関数を提供し、 usb.utilモジュールにはライン記述子を具体的に表示する便利なget_string関数があります。

追加のトピック

すべての偉大な抽象化の背後にある素晴らしい実現

以前は、 libusbのみがありました。 次にlibusb 1.0が登場し、libusb 0.1と1.0ができました。 その後、 OpenUSBを作成し、 USBライブラリのバベルの塔に住んでいます [9] 。 PyUSBはこれをどのように処理しますか？ さて、PyUSBは民主的なライブラリであり、必要なライブラリを選択できます。 実際、独自のUSBライブラリをゼロから作成し、それを使用するようPyUSBに指示することができます。



find関数には別のパラメーターがありますが、これについては説明しませんでした。 これはバックエンドパラメータです。 転送しない場合、組み込みのバックエンドのいずれかが使用されます。 バックエンドはusb.backend.IBackendから継承されたオブジェクトで、オペレーティングシステム固有のUSBジャンクの導入を担当します。 ご想像のとおり、組み込みのlibusb 0.1、libusb 1.0、およびOpenUSBはバックエンドです。



独自のバックエンドを作成して使用できます。 IBackendから継承し、必要なメソッドを有効にします。 これがどのように行われるかを理解するには、 usb.backendのドキュメントを見る必要があるかもしれません。

わがままにならないで

Pythonには、 自動メモリ管理と呼ばれるものがあります 。 これは、仮想マシンがメモリからオブジェクトをいつアンロードするかを決定することを意味します。 内部では、PyUSBは作業する必要があるすべての低レベルのリソース（インターフェイスの承認、デバイスの調整など）を管理し、ほとんどのユーザーは心配する必要はありません。 しかし、Pythonによるオブジェクトの自動破棄の未定義の性質により、ユーザーは割り当てられたリソースがいつリリースされるかを予測できません。 一部のアプリケーションでは、リソースを決定的に割り当てて解放する必要があります。 そのようなアプリケーションの場合、 usb.utilモジュールはリソース管理と対話するための機能を提供します。



インターフェイスを手動で要求およびリリースする場合は、 claim_interfaceおよびrelease_interface関数を使用できます。デバイスがまだ要求していない場合、claim_interface関数は指定されたインターフェイスを要求します。デバイスがすでにインターフェイスを要求している場合、何もしません。また、release_interfaceは、要求された場合、指定されたインターフェイスを解放します。インターフェイスが要求されない場合、何もしません。手動のインターフェイスクエリを使用して、libusbの ドキュメントに記載されている構成選択の問題を解決できます。



デバイスオブジェクトによって割り当てられたすべてのリソース（要求されたインターフェイスを含む）を解放する場合は、dispose_resources関数を使用できます。。割り当てられたすべてのリソースを解放し、デバイスオブジェクトを（デバイス自体のハードウェアではなく）、find関数を使用した後に返された状態に転送します。

手動ライブラリー定義

一般に、バックエンドは、USBにアクセスするためのAPIを実装する共有ライブラリのラッパーです。デフォルトでは、バックエンドはctypes関数find_library（）を使用します。 Linuxおよびその他のUnixライクなオペレーティングシステムでは、find_libraryはライブラリファイルを見つけるために外部プログラム（/ sbin / ldconfig、gccおよびobjdumpなど）を実行しようとします。



これらのプログラムが存在しないシステムおよび/またはライブラリキャッシュが無効になっているシステムでは、この機能は使用できません。制限を克服するために、PyUSBでは、find_library（）カスタム関数をバックエンドに送信できます。



このようなシナリオの例は次のとおりです。

 >>> import usb.core >>> import usb.backend.libusb1 >>> >>> backend = usb.backend.libusb1.get_backend(find_library=lambda x: "/usr/lib/libusb-1.0.so") >>> dev = usb.core.find(..., backend=backend)
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

find_libraryはget_backend（）関数の引数であることに注意してください。この関数では、バックエンドに適したライブラリを見つけるための関数を提供します。

古い学校のルール

古いPyUSB API（0.何かがある）を使用してアプリケーションを作成している場合、新しいAPIを使用するためにコードを更新する必要があるかどうかを自問することができます。まあ、あなたはそれを行うべきですが、それは必要ではありません。PyUSB 1.0にはusb.legacy互換性モジュールが付属しています。新しいAPIに基づいた古いAPIが含まれています。「まあ、アプリケーションusbを機能させるために、usbとしてimport usbの行をimport usb.legacyに置き換えるだけですか？」答えはイエスです。機能しますが、必ずしも必要ではありません。アプリケーションを変更せずに実行する場合、import usb行はusb.legacyからすべてのパブリックキャラクターをインポートするため、動作します。。問題が発生した場合-バグを発見した可能性が高いです。

助けてください

あなたが助けを必要とするならば、私に電子メールを書かないでください、これのためのメーリングリストがあります。サブスクリプションの手順は、PyUSB Webサイトで見つけることができます。



[1] TrueまたはFalse（大文字）を記述するとき、Python言語の対応する値を意味します。そして、true（true）またはfalse（false）と言うとき、trueまたはfalseと見なされるPython式を意味します。（この類似性はオリジナルで発生し、翻訳における真と偽の概念を理解するのに役立ちます。- 注。）：



[2]特定のバックエンドのドキュメントを参照してください。



[3] USB仕様は、構成値に特定の値を強制しません。インターフェイス番号と代替設定についても同様です。



[4]実際には、すべてがもう少し複雑ですが、これは私たちの単なる説明です。



[5]これは奇妙に聞こえます。



[6]これは、デバイスの構成中にアイソクロナスデータストリームの帯域幅がない場合、正常に番号付けできるためです。



[7]これは、デバイスが未構成状態になることが許可されているため、構成では発生しません。



[8] PyUSBでは、制御データストリームが制御ポイント0にアクセスします。ごくまれに、デバイスに代替制御コントロールポイントがあります（このようなデバイスに出会ったことはありません）。



[9]これは冗談です。真剣に受け止めないでください。素晴らしい選択肢は選択肢なしよりも優れています。