usb.legacy

モジュール内容

クラス

• usb.legacy.Endpoint

• usb.legacy.Interface

• usb.legacy.Configuration

• usb.legacy.DeviceHandle

• usb.legacy.Device

• usb.legacy.Bus

関数

• usb.legacy.busses

Attributes

usb.legacy.__author__ = Wander Lairson Costa

usb.legacy.USBError

usb.legacy.CLASS_AUDIO = 1

usb.legacy.CLASS_COMM = 2

usb.legacy.CLASS_DATA = 10

usb.legacy.CLASS_HID = 3

usb.legacy.CLASS_HUB = 9

usb.legacy.CLASS_MASS_STORAGE = 8

usb.legacy.CLASS_PER_INTERFACE = 0

usb.legacy.CLASS_PRINTER = 7

usb.legacy.CLASS_VENDOR_SPEC = 255

usb.legacy.DT_CONFIG = 2

usb.legacy.DT_CONFIG_SIZE = 9

usb.legacy.DT_DEVICE = 1

usb.legacy.DT_DEVICE_SIZE = 18

usb.legacy.DT_ENDPOINT = 5

usb.legacy.DT_ENDPOINT_AUDIO_SIZE = 9

usb.legacy.DT_ENDPOINT_SIZE = 7

usb.legacy.DT_HID = 33

usb.legacy.DT_HUB = 41

usb.legacy.DT_HUB_NONVAR_SIZE = 7

usb.legacy.DT_INTERFACE = 4

usb.legacy.DT_INTERFACE_SIZE = 9

usb.legacy.DT_PHYSICAL = 35

usb.legacy.DT_REPORT = 34

usb.legacy.DT_STRING = 3

usb.legacy.ENDPOINT_ADDRESS_MASK = 15

usb.legacy.ENDPOINT_DIR_MASK = 128

usb.legacy.ENDPOINT_IN = 128

usb.legacy.ENDPOINT_OUT = 0

usb.legacy.ENDPOINT_TYPE_BULK = 2

usb.legacy.ENDPOINT_TYPE_CONTROL = 0

usb.legacy.ENDPOINT_TYPE_INTERRUPT = 3

usb.legacy.ENDPOINT_TYPE_ISOCHRONOUS = 1

usb.legacy.ENDPOINT_TYPE_MASK = 3

usb.legacy.ERROR_BEGIN = 500000

usb.legacy.MAXALTSETTING = 128

usb.legacy.MAXCONFIG = 8

usb.legacy.MAXENDPOINTS = 32

usb.legacy.MAXINTERFACES = 32

usb.legacy.RECIP_DEVICE = 0

usb.legacy.RECIP_ENDPOINT = 2

usb.legacy.RECIP_INTERFACE = 1

usb.legacy.RECIP_OTHER = 3

usb.legacy.REQ_CLEAR_FEATURE = 1

usb.legacy.REQ_GET_CONFIGURATION = 8

usb.legacy.REQ_GET_DESCRIPTOR = 6

usb.legacy.REQ_GET_INTERFACE = 10

usb.legacy.REQ_GET_STATUS = 0

usb.legacy.REQ_SET_ADDRESS = 5

usb.legacy.REQ_SET_CONFIGURATION = 9

usb.legacy.REQ_SET_DESCRIPTOR = 7

usb.legacy.REQ_SET_FEATURE = 3

usb.legacy.REQ_SET_INTERFACE = 11

usb.legacy.REQ_SYNCH_FRAME = 12

usb.legacy.TYPE_CLASS = 32

usb.legacy.TYPE_RESERVED = 96

usb.legacy.TYPE_STANDARD = 0

usb.legacy.TYPE_VENDOR = 64

class usb.legacy.Endpoint(ep)

Bases: object

エンドポイント デスクリプター オブジェクト。

class usb.legacy.Interface(intf)

Bases: object

インターフェース デスクリプター オブジェクト。

class usb.legacy.Configuration(cfg)

Bases: object

configuration デスクリプター オブジェクト。

class usb.legacy.DeviceHandle(dev)

Bases: usb._objfinalizer.AutoFinalizedObject

_finalize_object(self)

bulkWrite(self, endpoint, buffer, timeout=100)

指定されたエンドポイントに対してバルク書き込み要求(request)を実行します。

パラメータ

• endpont -- エンドポイント番号。

• buffer -- 書き込むシーケンスデータバッファ。このパラメータは、任意のシーケンスタイプにすることができます。

• timeout -- ミリ秒単位の操作タイムアウト(デフォルト: 100)。

戻り値

書き込まれたバイト数。

bulkRead(self, endpoint, size, timeout=100)

指定されたエンドポイントに対してバルク読み取り要求(request)を実行します。

パラメータ

• endpoint -- エンドポイント番号。

• size -- 読み取るバイト数。

• timeout -- ミリ秒単位の操作タイムアウト(デフォルト: 100)。

戻り値

データが読み取られたタプル。

interruptWrite(self, endpoint, buffer, timeout=100)

指定されたエンドポイントに対して割り込み(interrupt)書き込み要求(request)を実行します。

パラメータ

• endpoint -- エンドポイント番号。

• buffer -- 書き込むシーケンスデータバッファ。このパラメータは、任意のシーケンスタイプにすることができます。

• timeout -- ミリ秒単位の操作タイムアウト(デフォルト: 100)。

戻り値

書き込まれたバイト数。

interruptRead(self, endpoint, size, timeout=100)

指定されたエンドポイントに対して割り込み(interrupt)読み取り要求(request)を実行します。

パラメータ

• endpoint -- エンドポイント番号。

• size -- 読み取るバイト数。

• timeout -- ミリ秒単位の操作タイムアウト(デフォルト: 100)。

戻り値

データが読み取られたタプル。

controlMsg(self, requestType, request, buffer, value=0, index=0, timeout=100)

デバイスのデフォルトの制御パイプ(control pipe)に対して制御要求(control request)を実行します。

パラメータ

• requestType -- データフローの方向、要求(request)のタイプ、および受信者(recipient)を指定します。

• request -- リクエストを指定します。

• buffer -- 転送が書き込み転送の場合、bufferは転送データのシーケンスです。それ以外の場合、bufferは読み取るバイト数です。

• value -- デバイスに渡す指定の情報(デフォルト:0)。

• index -- デバイスに渡す指定の情報(デフォルト:0)。

• timeout -- ミリ秒単位の操作タイムアウト(デフォルト: 100)。

戻り値

書き込まれたバイト数。

clearHalt(self, endpoint)

指定のエンドポイントの停止(halt)ステータスをクリアします。

パラメータ

endpoint -- エンドポイント番号。

claimInterface(self, interface)

オペレーティングシステムにinterfaceを要求(claim)します。

パラメータ

interface -- インターフェイス番号またはInterfaceオブジェクト。

releaseInterface(self)

以前にclaimInterfaceで要求(claim)されたインターフェースを解放します。

reset(self)

接続されているポートにRESETを送信して、指定のデバイスをリセットします。

resetEndpoint(self, endpoint)

指定のエンドポイントのすべての状態(all states)をリセットします。

パラメータ

endpoint -- エンドポイント番号。

setConfiguration(self, configuration)

デバイスのアクティブなconfigurationを設定します。

パラメータ

configuration -- configuration値またはConfigurationオブジェクト。

setAltInterface(self, alternate)

現在のインターフェースのアクティブな代替設定(alternate setting)を設定します。

パラメータ

alternate -- 代替設定番号(alternate setting naumber)またはInterfaceオブジェクト。

getString(self, index, length, langid=None)

indexおよびlangidで指定された文字列デスクリプターをデバイスから取得します。

パラメータ

• index -- デバイス内のデスクリプターのインデックス。

• length -- 文字列のバイト数(無視される)

• langid -- 言語ID。 省略した場合、最初の言語が使用されます。

getDescriptor(self, desc_type, desc_index, length, endpoint=- 1)

デスクリプターのタイプとインデックスによって識別されるデバイスからデスクリプターを取得します。

パラメータ

• desc_type -- デスクリプタータイプ。

• desc_index -- デスクリプターのインデックス。

• len -- デスクリプター長。

• endpoint -- 無視される。

detachKernelDriver(self, interface)

カーネルドライバーをインターフェイスから切り離します(detach)(カーネルドライバーが接続されている(attach)場合は、アクセス許可と操作はOSでサポートされています)。

パラメータ

interface -- インターフェイス番号またはInterfaceオブジェクト。

class usb.legacy.Device(dev)

Bases: object

Deviceデスクリプターオブジェクト

open(self)

デバイスを開いて使用します。

戻り値

DeviceHandleオブジェクト

class usb.legacy.Bus(devices)

Bases: object

Busオブジェクト。

usb.legacy.busses()

戻り値

USBバス達のタプル。