wiSrSr/SQrSSKJr SSKrSSKrSSKJr SSK J r SSK J r SSKrSSKrSSKrSSKr\R$"S5rSr\"5rSrSrS S jrS!S jr"S S \5rS r"SS5r"SS\5r "SS\ 5r!"SS\"5r#"SS5r$"SS5r%"SS5r&"SS\ RN5r(S"Sjr)S#Sjr*g)$avusb.core - Core USB features. This module exports: Device - a class representing a USB device. Configuration - a class representing a configuration descriptor. Interface - a class representing an interface descriptor. Endpoint - a class representing an endpoint descriptor. find() - a function to find USB devices. show_devices() - a function to show the devices present. zWander Lairson Costa) Device Configuration InterfaceEndpointUSBErrorUSBTimeoutErrorNoBackendErrorfind show_devicesNzusb.coreic @UHn[X[X55 M gN)setattrgetattr)inputoutputfieldsfs B/home/james-whalen/.local/lib/python3.13/site-packages/usb/core.py _set_attrrAs 75,-c:[X5nU$! [nU$=fr )r _sentinel)objectnameattrs r _try_getattrrEs)v$ K Ks cUS:XaUnU$Uc[R"X5nU$[R"XU5nU$! UnU$=f)zURR5 T"U/UQ70UD6URR5 $!URR5 f=fr )lockacquirerelease)r3argskwargsrs rwrappersynchronized..wrappermsK II   T+D+F+ II   DII   s %AA) functoolswraps)rrCs` r synchronizedrGls%__Q  Nrc\rSrSrSr\S5r\S5r\S5r\S5r \S5r \S5r \S 5r \S 5r \S 5r\S 5r\SS j5rSrg)_ResourceManagervcX lSUlXlSUl[ 5Ul0Ul0Ul[R"5Ul gr ) backend_active_cfg_indexr handleset _claimed_intf _intf_setting_ep_info threadingRLockr>)r3r rLs r__init___ResourceManager.__init__wsB !%  U OO% rcURc*URRUR5UlUR$r )rNrL open_devicer r2s r managed_open_ResourceManager.managed_opens0 ;; ,,22488.MockConfigurationc SUlSUlg)Nr )r!bConfigurationValuer2s rrUN_ResourceManager.managed_set_configuration..MockConfiguration.__init__s!%DJ/0D,r)rdr!N)r6r7r8r9rUr;r1rrMockConfigurationras1rrfrdzInvalid configuration ) isinstancerrfind_descriptor ValueErrorstrrYrLset_configurationrNrdr!rMrQclearrR)r3deviceconfigcfgrfs rmanaged_set_configuration*_ResourceManager.managed_set_configurations >)C  . .C q[ 1 1$%C&&vJC ;5F CD D  &&t{{C4K4KL "%   " rcUR5 [U[5(a URnOUnX0R;aBUR R URU5 URRU5 ggr ) rYrhrbInterfaceNumberrPrLclaim_interfacerNadd)r3rnintfis rmanaged_claim_interface(_ResourceManager.managed_claim_interfacesh  dI & &%%AA && & LL ( (a 8    " "1 % 'rcxUc!URU5nUSRnO$[U[5(a URnOUnX@R;aCUR R URU5 URRU5 gg!URRU5 f=f)Nr r ) get_active_configurationrtrhrrPrLrelease_interfacerNremove)r3rnrwrprxs rmanaged_release_interface*_ResourceManager.managed_release_interfaces <//7CE ++A i ( (%%AA "" " - ..t{{A>""))!, #""))!,s &BB9c2[U[5(aUnO|URU5nUcUSRnUb[R "XRUS9nO[R "XRS9nUc)[ S[U5-S-[U5-S-5eURX5 Uc URnURRURURU5 X0RUR'URR5 g)Nr|)rtbAlternateSetting)rtzNo matching interface (,))rhrr}rtrrirjrkryrrLset_interface_altsettingrNrQrRrm)r3rnrwaltrxrps rmanaged_set_interface&_ResourceManager.managed_set_interfaces dI & &A//7C|5z22((WZ[((Dy !:SY!F!LsSVx!WZ]!]^^ $$V/ ;%%C --dkk1;M;MsS141--. rc[U[5(a URnOUnURX5upEUR X5 XE4$r )rhrbEndpointAddressget_interface_and_endpointry)r3rnendpointendpoint_addressrweps r setup_request_ResourceManager.setup_requestsK h ) )'88 ' 226L $$V2zrcdURU$![a URU5HgnURURR UR S5:waM9[R"X2S9nUcMRX44URU'X44s s$ [S[U5-5ef=f)Nr )rzInvalid endpoint address ) rRr(r}rrQgetrtrrirjhex)r3rnrrwrs rr+_ResourceManager.get_interface_and_endpoints R==!12 2 R55f=))T-?-?-C-CDDYDY[\-]]))$R>7;jDMM"238O >83?O;PPQ Q RsA)B/>B/B/c URciUR5 [R"UURR UR 5S9nUc [S5eURUlU$XR$)NrgzConfiguration not set) rMrYrrirLget_configurationrNrr!)r3rnrps rr})_ResourceManager.get_active_configurationsv  ! ! )    &&(, (F(Ft{{(SC{677%(YYD "J,,--rc[R"UR5nUHnURX5 M g![a M'f=fr )copyrPrr)r3rnclaimedrxs rrelease_all_interfaces'_ResourceManager.release_all_interfaces sI))D../A ..v9  s= A  A cURU5 U(aUR5 URR5 URR5 SUlgr )rr]rQrmrRrM)r3rn close_handles rdispose_ResourceManager.disposesI ##F+        " !%r)rMrPrRrQrLr rNr>N)T)r6r7r8r9rUrGrYr]rqryrrrrr}rrr;r1rrrIrIvs&  8 & & - -0   R R . .&&rrIc"\rSrSrSrSSjrSrg)ri zException class for USB errors. Backends must raise this exception when USB related errors occur. The backend specific error code is available through the 'backend_error_code' member variable. Nc<[RXU5 X lg)zInitialize the object. This initializes the USBError object. The strerror and errno are passed to the parent object. The error_code parameter is attributed to the backend_error_code member variable. N)IOErrorrUbackend_error_code)r3strerror error_codeerrnos rrUUSBError.__init__(s h/",r)rNN)r6r7r8r9r:rUr;r1rrrr s  -rrc\rSrSrSrSrg)ri3zException class for connection timeout errors. Backends must raise this exception when a call on a USB connection returns a timeout error code. r1Nr6r7r8r9r:r;r1rrrr3s   rrc\rSrSrSrSrg)ri;z2Exception class when a valid backend is not found.r1Nrr1rrrr;s9rrcR\rSrSrSrS SjrSrSrS SjrS Sjr S r S r S r g)ri?aRepresent an endpoint object. This class contains all fields of the Endpoint Descriptor according to the USB Specification. You can access them as class properties. For example, to access the field bEndpointAddress of the endpoint descriptor, you can do so: >>> import usb.core >>> dev = usb.core.find() >>> for cfg in dev: >>> for i in cfg: >>> for e in i: >>> print e.bEndpointAddress cXlX lURRnUR URR UUUU5n[ UUS5 g)aInitialize the Endpoint object. The device parameter is the device object returned by the find() function. endpoint is the endpoint logical index (not the endpoint address). The configuration parameter is the logical index of the configuration (not the bConfigurationValue field). The interface parameter is the interface logical index (not the bInterfaceNumber field) and alternate_setting is the alternate setting logical index (not the bAlternateSetting value). An interface may have only one alternate setting. In this case, the alternate_setting parameter should be zero. By "logical index" we mean the relative order of the configurations returned by the peripheral as a result of GET_DESCRIPTOR request. ) bLengthbDescriptorTyper bmAttributeswMaxPacketSize bIntervalbRefresh bSynchAddressextra_descriptorsN)rnr!_ctxrLget_endpoint_descriptorr r)r3rnr interfacealternate_setting configurationrLdescs rrUEndpoint.__init__NsY   ++%%..KKOO%!    rc.SUR5-S-$N<>_strr2s rr4Endpoint.__repr__{TYY[ 3&&rc@SUR5-S-n[R"UR5[R:XaSnOSnU<SS[ U5- -<S3SS UR 4--S S UR[[RUR54--S S URU4--S S UR[RURS-4--SSURUR4--SSUR4--$)Nz  INOUT=< z %-17s:%#7x (7 bytes) rz %-17s:%#7x %s rrrz %-17s:%#7x (%d bytes) rz %-17s:%#7xr)rrendpoint_directionr ENDPOINT_INlenrrr,_lu descriptorsr ep_attributesrr)r3headstr directions r__str__Endpoint.__str__~sJTYY[(3.  " "4#8#8 9T=M=M MII"C2G +<$=>'4<<+) )) !!4#7#7COOT-A-AB$D DD !"D$9$99$F F F ! 1 1!!4#4#4s#:<$> > > ) $"5"5t7J7J,L L L {DNN;; < >rcNURRUR5 g)z0Clear the halt/status condition of the endpoint.N)rn clear_haltrr2s rrEndpoint.clear_halts t445rc[R"UR5[R:XaSnOSnSUR[R UR S-U4-$)NrrzENDPOINT 0x%X: %s %sr)rrrrrrr)r3rs rr Endpoint._strsc  " "4#8#8 9T=M=M MII #d&;&;   t0036 8 &  rrnr!r r r r ) r6r7r8r9r:rUr4rrrrrr;r1rrrr?s3 67;<+Z'<. 6 ?6 rrcV\rSrSrSrSSjrSrSrSrSr Sr S r S r S r S rg )riaRepresent an interface object. This class contains all fields of the Interface Descriptor according to the USB Specification. You may access them as class properties. For example, to access the field bInterfaceNumber of the interface descriptor, you can do so: >>> import usb.core >>> dev = usb.core.find() >>> for cfg in dev: >>> for i in cfg: >>> print i.bInterfaceNumber cXlX0lX lX@lURR nUR URRRUUU5n[UUS5 g)aInitialize the interface object. The device parameter is the device object returned by the find() function. The configuration parameter is the logical index of the configuration (not the bConfigurationValue field). The interface parameter is the interface logical index (not the bInterfaceNumber field) and alternate_setting is the alternate setting logical index (not the bAlternateSetting value). An interface may have only one alternate setting. In this case, the alternate_setting parameter should be zero. By "logical index" we mean the relative order of the configurations returned by the peripheral as a result of GET_DESCRIPTOR request. ) rrrtr bNumEndpointsbInterfaceClassbInterfaceSubClassbInterfaceProtocol iInterfacerN) rnalternate_indexr!rrrLget_interface_descriptorr r)r3rnrrrrLrs rrUInterface.__init__sj 0 *++%%//KK$$((%!    rc.SUR5-S-$rrr2s rr4Interface.__repr__rrcZUR5nUHnUS[U5-- nM U$)z'Show all information for the interface.r_get_full_descriptor_strrk)r3r%rs rrInterface.__str__s4..0H dS]* *F rc[U5$)z*Return a tuple of the interface endpoints.tupler2s r endpointsInterface.endpoints T{rcdURRURUR5 g)z$Set the interface alternate setting.N)rnrrtrr2s rset_altsettingInterface.set_altsetting s& ,,  ! !  " " $rc## [UR5H<n[URUURUR UR 5v M> g7f)z,Iterate over all endpoints of the interface.N)rangerrrnr!rrr3rxs r__iter__Interface.__iter__sJt))*AKKJJ((&& ( (+sAAcp[URUURURUR5$)z1Return the Endpoint object in the given position.)rrnr!rrr3r!s r __getitem__Interface.__getitem__s2  $$"" $ $rc UR(aSUR-nOSnSURU[[RUR SS94-$)Nz, %dzINTERFACE %d%s: %sz Unknown Class)r+)rrtr,rinterface_classesr)r3 alt_settings rrInterface._str%sW  ! ! 4#9#99KK#t'<'% t||)% %%  t33 )=)= >"@ @@   5 57 7 7  !7!79 9 9  T//1 1 1  t33 --t/C/C D"F FF  $"9"9; ;;"  $"9"9; ;#;&  $// DKK 9 ; ;'; ;r)rrrnr!Nr)r6r7r8r9r:rUr4rrrrr rrr;r1rrrrs= ,-34,\'$ ($,;rrcX\rSrSrSrSSjrSrSrSrSr Sr S r S r S r S rS rg)riIa~Represent a configuration object. This class contains all fields of the Configuration Descriptor according to the USB Specification. You may access them as class properties. For example, to access the field bConfigurationValue of the configuration descriptor, you can do so: >>> import usb.core >>> dev = usb.core.find() >>> for cfg in dev: >>> print cfg.bConfigurationValue cXlX lURRnUR URRR U5n[ UUS5 g)abInitialize the configuration object. The device parameter is the device object returned by the find() function. The configuration parameter is the logical index of the configuration (not the bConfigurationValue field). By "logical index" we mean the relative order of the configurations returned by the peripheral as a result of GET_DESCRIPTOR request. ) rr wTotalLengthbNumInterfacesrdiConfigurationr bMaxPowerrN)rnr!rrLget_configuration_descriptorr r)r3rnrrLrs rrUConfiguration.__init__WsX " ++%%33   $$   rc.SUR5-S-$rrr2s rr4Configuration.__repr__zrrcZUR5nUHnUS[U5-- nM U$)N %sr)r3r%rs rrConfiguration.__str__}s2..0I fs9~- -F rc[U5$)z/Return a tuple of the configuration interfaces.rr2s r interfacesConfiguration.interfacesrrcNURRUR5 g)z)Set this configuration as the active one.N)rnrlrdr2s rrOConfiguration.sets %%d&>&>?rc## [UR5H/nSn[URXUR5v US- nM* g![ [ 4a MGf=f7f)z1Iterate over all interfaces of the configuration.r N)rrrrnr!r IndexError)r3rxrs rrConfiguration.__iter__sdt**+AC #DKKDD1HC, j)  s(A#+A  A# A A#A  A#cR[URUSUSUR5$)zReturn the Interface object in the given position. index is a tuple of two values with interface index and alternate setting index, respectivally. Example: >>> interface = config[(0, 0)] r r%)rrnr!rs rr Configuration.__getitem__s%eAha$**EErc$URRb>URRS:a[RnU$[RnU$URR S:a[RO[RnU$)Ni)rnspeedrMAX_POWER_UNITS_USB_SUPERSPEEDMAX_POWER_UNITS_USB2p0bcdUSB)r3power_multipliers r_get_power_multiplier#Configuration._get_power_multipliers ;;   (EI[[EVEVZ[E[sAA   bea{a{  FJ[[EWEW[aEasAAgjhBhB rcZSURUR5UR-4-$)NzCONFIGURATION %d: %d mA)rdr1rr2s rrConfiguration._strs2(  $ $  & & (4>> 9,;; ;rcSUR5-S-nURS-(aSnOSnURS-(aSnOSnU<S S [U5- -<S 3S S UR4--SSUR[ [ RUR54--SSURUR4--SSUR4--SSUR4--SSUR[URUR54--SSURX#4--SSURUR5UR-4--$)Nz r@SelfBus z, Remote Wakeupr rrrz %-21s:%#7x (9 bytes) rz %-21s:%#7x %s rz %-21s:%#7x (%d bytes) rz %-21s:%#7x rrdrz %-21s:%#7x %s Powered%s rz %-21s:%#7x (%d mA)r)rrrrrr,rrrrrdrr&rnrr1)r3rpowered remote_wakeups rr&Configuration._get_full_descriptor_strs$s*    %GG    %-MM"C2G +<$=># t||'% %%  t33 )=)= > @ @@ % D--t/@/@(B B B  d113 3 3  !4#;#;= = =  d11 DKK)<)< = ? ?? ' D--w* &   & & (4>> 9#; ;'; ;rrN)r )r6r7r8r9r:rUr4rr rOrr r1rrr;r1rrrrIs< !F' @ F ; !;rrc6\rSrSrSrSrSrSrSrSr Sr \ S 5r \ S 5r \ S 5r\ S 5r\ S 5r\ S5rS&SjrSrS'SjrSrSrS&SjrS&SjrS(SjrSrSrSrSrSrSrSr Sr!S r"S!r#S"r$\ "\"\!S#S$9r%S%r&g))riaDevice object. This class contains all fields of the Device Descriptor according to the USB Specification. You may access them as class properties. For example, to access the field bDescriptorType of the device descriptor, you can do so: >>> import usb.core >>> dev = usb.core.find() >>> dev.bDescriptorType Additionally, the class provides methods to communicate with the hardware. Typically, an application will first call the set_configuration() method to put the device in a known configured state, optionally call the set_interface_altsetting() to select the alternate setting (if there is more than one) of the interface used, and call the write() and read() methods to send and receive data, respectively. When working in a new hardware, the first try could be like this: >>> import usb.core >>> dev = usb.core.find(idVendor=myVendorId, idProduct=myProductId) >>> dev.set_configuration() >>> dev.write(1, 'test') This sample finds the device of interest (myVendorId and myProductId should be replaced by the corresponding values of your device), then configures the device (by default, the configuration value is 1, which is a typical value for most devices) and then writes some data to the endpoint 0x01. Timeout values for the write, read and ctrl_transfer methods are specified in milliseconds. If the parameter is omitted, Device.default_timeout value will be used instead. This property can be set by the user at anytime. c[XR5(aGURURUR4URURUR4:H$[ $r )rh __class__rLbusaddressNotImplemented)r3others r__eq__ Device.__eq__sO e^^ , ,LL$((DLL9MM599emm<= =" !rcZ[URURUR45$r )hashrLr@rAr2s r__hash__Device.__hash__s T\\488T\\:;;rc.SUR5-S-$rrr2s rr4Device.__repr__rrcUR5nUHnUS[U5-- nM U$![a> UR5nUSUR-- nU$![a US- nU$f=ff=f)Nrz" USBError Accessing Configurations)rrkrr}info)r3r%rs rrDevice.__str__s..0 ?!% &3}#555"&  ? ? $ = = ? &M$6$677  ?>>  ?  ?s&. A6"AA2-A61A22A6c[U5$)z,Return a tuple of the device configurations.rr2s rconfigurationsDevice.configurationsrrcB[X5Ul[UlSuUlUlUlSUlURU5n[UUS5 URb[UR5Ul OSUl URb[UR5Ul OSUl URb[UR5Ul OSUl URb[UR5UlOSUlSUlSUlg)aInitialize the Device object. Library users should normally get a Device instance through the find function. The dev parameter is the identification of a device to the backend and its meaning is opaque outside of it. The backend parameter is a instance of a backend object. )NNNN)rrr/ bDeviceClassbDeviceSubClassbDeviceProtocolbMaxPacketSize0idVendor idProduct bcdDevice iManufactureriProduct iSerialNumberbNumConfigurationsrAr@ port_number port_numbersr,)rIr_DEFAULT_TIMEOUT_Device__default_timeout_serial_number_product _manufacturer_langidsget_device_descriptorrr@intrAr^r, _has_parent_parent)r3r rLrs rrUDevice.__init__s%S2 !1AQ>T]D,> ,,S1 4 88 488}DHDH << #t||,DLDL    '"4#3#34D #D  :: !TZZDJDJ rcURc([R"U5UlUR$UR$![a SUlUR$f=f)aReturn the USB device's supported language ID codes. These are 16-bit codes familiar to Windows developers, where for example instead of en-US you say 0x0409. USB_LANGIDS.pdf on the usb.org developer site for more info. String requests using a LANGID not in this array should not be sent to the device. This property will cause some USB traffic the first time it is accessed and cache the resulting value for future use. r1)rer get_langidsrr2s rlangidsDevice.langidsSs\ ==  # $ 0 0 6 }}t}} # " }} #sAA! A!c~URc%[R"XR5UlUR$)zReturn the USB device's serial number string descriptor. This property will cause some USB traffic the first time it is accessed and cache the resulting value for future use. )rbrrr\r2s r serial_numberDevice.serial_numberfs3    &"&//$8J8J"KD """rc~URc%[R"XR5UlUR$)zReturn the USB device's product string descriptor. This property will cause some USB traffic the first time it is accessed and cache the resulting value for future use. )rcrrr[r2s rproductDevice.productqs, ==  OOD--@DM}}rcHURcURRRURR5nUSLUlUR(a0[ XRR5UlUR $SUlUR $)zReturn the parent device. N)rhrrL get_parentr rri)r3ris rparent Device.parent|s}    #ii''22499==AG&d2D %gyy/@/@A || $ ||rc~URc%[R"XR5UlUR$)zReturn the USB device's manufacturer string descriptor. This property will cause some USB traffic the first time it is accessed and cache the resulting value for future use. )rdrrrZr2s r manufacturerDevice.manufacturers3    %!%7I7I!JD !!!rc.URR$)z,Return the backend being used by the device.)rrLr2s rrLDevice.backendsyy   rNc:URRX5 g)adSet the active configuration. The configuration parameter is the bConfigurationValue field of the configuration you want to set as active. If you call this method without parameter, it will use the first configuration found. As a device hardly ever has more than one configuration, calling the method without arguments is enough to get the device ready. N)rrq)r3rs rrlDevice.set_configurations ++D@rc8URRU5$)zJReturn a Configuration object representing the current configuration set. )rr}r2s rr}Device.get_active_configurationsyy11$77rc<URRXU5 g)aSet the alternate setting for an interface. When you want to use an interface and it has more than one alternate setting, you should call this method to select the appropriate alternate setting. If you call the method without one or the two parameters, it will be selected the first one found in the Device in the same way of the set_configuration method. Commonly, an interface has only one alternate setting and this call is not necessary. For most devices, either it has more than one alternate setting or not, it is not harmful to make a call to this method with no arguments, as devices will silently ignore the request when there is only one alternate setting, though the USB Spec allows devices with no additional alternate setting return an error to the Host in response to a SET_INTERFACE request. If you are in doubt, you may want to call it with no arguments wrapped by a try/except clause: >>> try: >>> dev.set_interface_altsetting() >>> except usb.core.USBError: >>> pass N)rr)r3rrs rrDevice.set_interface_altsettings2 ''9JKrc[U[5(a URnURR 5 URR R URRU5 g)z3Clear the halt/stall condition for the endpoint ep.N)rhrrrrYrLrrN)r3rs rrDevice.clear_haltsN b( # #$$B   $$TYY%5%5r:rcURR5 URRUS5 URRR URR 5 URRUS5 g)zReset the device.FTN)rrYrrL reset_devicerNr2s rreset Device.resets\   $& &&tyy'7'78 $%rc URRn[RUR[R UR [RUR0nURRX5upgU[R"UR5nU"URRURUR[R "U5UR#U55$)a}Write data to the endpoint. This method is used to send data to the device. The endpoint parameter corresponds to the bEndpointAddress member whose endpoint you want to communicate with. The data parameter should be a sequence like type convertible to the array type (see array module). The timeout is specified in milliseconds. The method returns the number of bytes written. )rrLrENDPOINT_TYPE_BULK bulk_writeENDPOINT_TYPE_INTR intr_writeENDPOINT_TYPE_ISO iso_writer endpoint_typerrNrrt_interopas_array_Device__get_timeout) r3rrrrLfn_maprwrfns rr Device.writes))##++G,>,>++G,>,>**7+<+< 99**4: D&&r7 8   ##%%!!$'""7+  rc URRn[RUR[R UR [RUR0nURRX5upgU[R"UR5n[U[R5(aUn O[R"U5n U"URRUR UR"U UR%U55n [U[R5(aU $U ['U 5U R(-:waU SU $U $)ahRead data from the endpoint. This method is used to receive data from the device. The endpoint parameter corresponds to the bEndpointAddress member whose endpoint you want to communicate with. The size_or_buffer parameter either tells how many bytes you want to read or supplies the buffer to receive the data (it *must* be an object of the type array). The timeout is specified in milliseconds. If the size_or_buffer parameter is the number of bytes to read, the method returns an array object with the data read. If the size_or_buffer parameter is an array object, it returns the number of bytes actually read. N)rrLrr bulk_readr intr_readriso_readrrrrharray create_bufferrNrrtrritemsize) r3rrrrLrrwrrbuffrets rr Device.reads ))##++G,=,=++G,=,=**7+;+; 99**4: D&&r7 8 nekk 2 2!D%%n5D   ##%%""7+ - nekk 2 2J CI - -: Krc z[R"U5nURR5 US-nUS-n U[R :Xa4U [R :wa US-n URRX 5 URRRURRUUUUUURU55n [U[R5(d([R"U5[R:XaU $U [!U5UR"-:waUSU $U$)aDo a control transfer on the endpoint 0. This method is used to issue a control transfer over the endpoint 0 (endpoint 0 is required to always be a control endpoint). The parameters bmRequestType, bRequest, wValue and wIndex are the same of the USB Standard Control Request format. Control requests may or may not have a data payload to write/read. In cases which it has, the direction bit of the bmRequestType field is used to infer the desired request direction. For host to device requests (OUT), data_or_wLength parameter is the data payload to send, and it must be a sequence type convertible to an array object. In this case, the return value is the number of bytes written in the data payload. For device to host requests (IN), data_or_wLength is either the wLength parameter of the control request specifying the number of bytes to read in data payload, and the return value is an array object with data read, or an array object which the data will be read to, and the return value is the number of bytes read. r`N)rrrrYrCTRL_RECIPIENT_INTERFACECTRL_TYPE_VENDORryrL ctrl_transferrNrrhrctrl_directionCTRL_OUTrr) r3 bmRequestTypebRequestwValuewIndexdata_or_wLengthrr recipientrqtypeinterface_numberrs rrDevice.ctrl_transfer!s .  1  "A% &) 55 5d333%}  II - -d Eii--$(II$4$4$1$,$*$*$($($6$6w$?A ou{{ 3 3&&}5FJ CI - -: KrcURR5 URRRURRU5$)zDetermine if there is kernel driver associated with the interface. If a kernel driver is active, the object will be unable to perform I/O. The interface parameter is the device interface number to check. )rrYrLis_kernel_driver_activerNr3rs rrDevice.is_kernel_driver_activeVsA  yy  88    rcURR5 URRRURRU5 g)zDetach a kernel driver. If successful, you will then be able to perform I/O. The interface parameter is the device interface number to detach the driver from. N)rrYrLdetach_kernel_driverrNrs rrDevice.detach_kernel_drivercs<   .. II    rcURR5 URRRURRU5 g)zRe-attach an interface's kernel driver, which was previously detached using detach_kernel_driver(). The interface parameter is the device interface number to attach the driver to. N)rrYrLattach_kernel_driverrNrs rrDevice.attach_kernel_driverps<   .. II    rc#^# [UR5Hn[X5v M g7f)z.Iterate over all configurations of the device.N)rr]rrs rrDevice.__iter__|s%t../A( (0s+-c[X5$)z6Return the Configuration object in the given position.)rrs rr Device.__getitem__s T))rc^[US5(aURRU5 gg)Nr)hasattrrrr2s r_finalize_objectDevice._finalize_objects& 4 II  d # !rc$UbU$UR$r ra)r3rs r __get_timeoutDevice.__get_timeouts  N%%%rc2US:a [S5eXlg)Nr z"Timeout cannot be a negative value)rjra)r3tmos r __set_def_tmoDevice.__set_def_tmos 7AB B!$rcUR$r rr2s r __get_def_tmoDevice.__get_def_tmos%%%rcdSURURURUR4-$)Nz,DEVICE ID %04x:%04x on Bus %03d Address %03d)rWrXr@rAr2s rr Device._strs1= MM4>>488T\\ACC CrcUR5S-nURS-(a[URS-5nOSnURS-(a[URS-5nOSnU<SS[ U5- -<S3SSUR 4--S S UR [[RUR 54--S S URURS -S- URS-S- U4--S SUR[[RUR54--SSUR4--SSUR4--SSURUR4--SSUR4--SSUR 4--SSURURS -S- URS-S- U4--S SUR"[%XR"54--S SUR&[%XR&54--S SUR([%XR(54--SS UR*4--$)!Nrr rrrz %-23s:%#7x (18 bytes) rz %-23s:%#7x %s rz %-23s:%#7x USB %d.%d%s r/ir+rSz %-23s:%#7x rTrUz %-23s:%#7x (%d bytes) rVz %-23s: %#06x rWrXz %-23s:%#7x Device %d.%d%s rYrZr[r\z %-23s:%#7xr])rr/rkrYrrrr,rrrSdevice_classesrTrUrVrWrXrZr&r[r\r])r3r low_bcd_usblow_bcd_devices rrDevice._get_full_descriptor_strs))+# ;; dkkC/0KK >>C  #!56NN#SBW,=%>?" t||&% %%  t33 )=)= >@ @@ $ dkkDKK&$81#< [[4 A %{'4 4 4  D-- **D,=,= >@ @ @  t335 5 5  t335 55 # t33T5I5I&K K!K$   ' '%'(  ) ))), ' $..6*AA)E ^^d "q (.*: :-:2  T// D"4"4 57 7378   D-- 02 292>  T// D"4"4 57 7?!7D  $"9"9; ;E#;# ;rz*Default timeout for transfer I/O functions)doc) __default_timeoutrrhrerdrircrbrAr@r^r,r r)r r NN)'r6r7r8r9r:rDrHr4rrPrUpropertyrmrprsrwrzrLrlr}rrrrrrrrrrr rr_Device__set_def_tmo_Device__get_def_tmorrdefault_timeoutr;r1rrrrs$!F"<' ?B$##  ""!! A8 L6;&B,\GH.23j   ) *$& % &C0;d%%JOrrc H^^UU4SjnTcfSSKJs Jn SSKJs Jn SSKJs Jn XWU4H8nUR5mTcM[RSUR5 O [S5eU(aU"S0UD6$[U"S0UD65$![a gf=f)aR Find an USB device and return it. find() is the function used to discover USB devices. You can pass as arguments any combination of the USB Device Descriptor fields to match a device. For example: find(idVendor=0x3f4, idProduct=0x2009) will return the Device object for the device with idVendor field equals to 0x3f4 and idProduct equals to 0x2009. If there is more than one device which matchs the criteria, the first one found will be returned. If a matching device cannot be found the function returns None. If you want to get all devices, you can set the parameter find_all to True, then find will return an iterator with all matched devices. If no matching device is found, it will return an empty iterator. Example: for printer in find(find_all=True, bDeviceClass=7): print (printer) This call will get all the USB printers connected to the system. (actually may be not, because some devices put their class information in the Interface Descriptor). You can also use a customized match criteria: dev = find(custom_match = lambda d: d.idProduct==0x3f4 and d.idVendor==0x2009) A more accurate printer finder using a customized match would be like so: def is_printer(dev): import usb.util if dev.bDeviceClass == 7: return True for cfg in dev: if usb.util.find_descriptor(cfg, bInterfaceClass=7) is not None: return True for printer in find(find_all=True, custom_match = is_printer): print (printer) Now even if the device class code is in the interface descriptor the printer will be found. You can combine a customized match with device descriptor fields. In this case, the fields must match and the custom_match must return True. In the our previous example, if we would like to get all printers belonging to the manufacturer 0x3f4, the code would be like so: printers = list(find(find_all=True, idVendor=0x3f4, custom_match=is_printer)) If you want to use find as a 'list all devices' function, just call it with find_all = True: devices = list(find(find_all=True)) Finally, you can pass a custom backend to the find function: find(backend = MyBackend()) PyUSB has builtin backends for libusb 0.1, libusb 1.0 and OpenUSB. If you do not supply a backend explicitly, find() function will select one of the predefineds backends according to system availability. Backends are explained in the usb.backend module. c;>^# TR5HQn[UT5mU4SjUR55n[U5(dM;TbT"T5(dMMTv MS g7f)Nc3F># UHupU[TU5:Hv M g7fr )r).0keyvalds r ,find..device_iter..sPXSSLC00s!)enumerate_devicesritemsall)rBr testsrrL custom_matchs @r device_iterfind..device_itersP,,.CsG$APPE5zz|3|A /sAA+A+" A+Nr zfind(): using backend "%s"zNo backend availabler1)usb.backend.libusb1rLlibusb1usb.backend.libusb0libusb0usb.backend.openusbopenusb get_backend_loggerrMr6rnext StopIteration) find_allrLrrArrrrms `` rr r sH------G,AmmoG" 91::F - !!78 8"T""  +d+, ,  sB B! B!c SUS'[S0UD6nSnUHYnU(d>X4R5<S[[RUR 5<S3- nMHUS[ U5-- nM[ [U5$)zShow information about connected devices. The verbose flag sets to verbose or not. **kwargs are passed directly to the find() function. Trr z, rz%s r1)r rr,rrrSrkr.)verboserBdevicesstringsrns rr r 3sz F:nVnGG kkm[""F$7$769: :G x#f+- -G  7 ##r)Nr zError Accessing String)r )FNN)F)+r: __author____all__usb.utilrroperator usb._interoprusb._objfinalizer _objfinalizer usb._lookup_lookuprloggingrrSrE getLoggerrr`rrrrr&r,rkr.rGrIrrrrjrrrrAutoFinalizedObjectrr r r1rrr s> $  J )    J ' H .AC7 c g&g&T-w-& h  Z BF;F;RE;E;N@] . .@F^@$r