usb.control

usb.control - USB 標準制御要求(standard control requests)

本モジュールからは以下がエスクポートされます:

  • get_status - get recipeint status

  • clear_feature - clear a recipient feature

  • set_feature - set a recipient feature

  • get_descriptor - get a device descriptor

  • set_descriptor - set a device descriptor

  • get_configuration - get a device configuration

  • set_configuration - set a device configuration

  • get_interface - get a device interface

  • set_interface - set a device interface

Module Contents

Functions

  • usb.control.get_status

  • usb.control.clear_feature

  • usb.control.set_feature

  • usb.control.get_descriptor

  • usb.control.set_descriptor

  • usb.control.get_configuration

  • usb.control.set_configuration

  • usb.control.get_interface

  • usb.control.set_interface

Attributes

  • usb.control.ENDPOINT_HALT

  • usb.control.FUNCTION_SUSPEND

  • usb.control.DEVICE_REMOTE_WAKEUP

  • usb.control.U1_ENABLE

  • usb.control.U2_ENABLE

  • usb.control.LTM_ENABLE

usb.control.ENDPOINT_HALT = 0
usb.control.FUNCTION_SUSPEND = 0
usb.control.DEVICE_REMOTE_WAKEUP = 1
usb.control.U1_ENABLE = 48
usb.control.U2_ENABLE = 49
usb.control.LTM_ENABLE = 50
usb.control.get_status(dev, recipient=None)

指定の受信者(recipient)のステータスを返す。

dev は、リクエストの送信先となるデバイス・オブジェクトです。

受信者(recipient)は、 None (デバイスからステータスが照会される) または Interface または Endpoint デスクリプタにすることができます。

ステータス値は整数として返され、下位ワードは2バイトのステータス値からなります。

usb.control.clear_feature(dev, feature, recipient=None)

指定の機能(feature)をクリアまたは無効にします。

dev は、リクエストの送信先となるデバイス・オブジェクトです。

featureには、あなたが無効にしたい機能(feature)を指定します。

受信者(recipient)は、 None (デバイスからステータスが照会される) または Interface または Endpoint デスクリプタにすることができます。

usb.control.set_feature(dev, feature, recipient=None)

指定の機能(feature)を設定または有効化します。

dev は、リクエストの送信先となるデバイス・オブジェクトです。

featureにはあなたが有効にしたい機能(feature)を指定します。

受信者(recipient)は、 None (デバイスからステータスが照会される) または Interface または Endpoint デスクリプタにすることができます。

usb.control.get_descriptor(dev, desc_size, desc_type, desc_index, wIndex=0)

指定のデスクリプタを返す。

dev は、リクエストの送信先となるデバイス・オブジェクトです。

desc_sizeはデスクリプタのサイズを指定します。

desc_typeとdesc_indexは、それぞれデスクリプタのタイプとインデックスです。 wIndexインデックスは文字列デスクリプタに使用され、言語IDを表します。文字列デスクリプタ以外タイプの記述子の場合、wIndexはゼロです。

usb.control.set_descriptor(dev, desc, desc_type, desc_index, wIndex=None)

存在するデスクリプタを更新するか、または新しいデスクリプタを追加します。

dev は、リクエストの送信先となるデバイス・オブジェクトです。

descほげほげなパラメータ達は、デバイスに送信されるデスクリプタです。 desc_typeとdesc_indexは、それぞれデスクリプタのタイプとインデックスです。 wIndexインデックスは文字列デスクリプタに使用され、言語IDを表します。 文字列デスクリプタ以外のタイプのデスクリプタの場合、wIndexはゼロです。

usb.control.get_configuration(dev)

デバイスの、当座(current)でアクティブな構成(configuration)を取得します。

dev は、リクエストの送信先となるデバイス・オブジェクトです。

キャッシュされたデータを使用する可能性がある Device.get_active_configuration メソッドとは異なり、この関数は常にデバイス・リクエストを実行します。

usb.control.set_configuration(dev, bConfigurationNumber)

当座(current)とする構成(configuration)を設定します。

dev は、リクエストの送信先となるデバイス・オブジェクトです。

usb.control.get_interface(dev, bInterfaceNumber)

インターフェイスの代替設定(alternate setting)の当座(current)を取得します。

dev は、リクエストの送信先となるデバイス・オブジェクトです。

usb.control.set_interface(dev, bInterfaceNumber, bAlternateSetting)

インターフェイスの代替設定(alternate setting)を設定します。

dev は、リクエストの送信先となるデバイス・オブジェクトです。