File: //lib/python3.6/site-packages/usb/__pycache__/core.cpython-36.pyc
3
�~�Vp� � @ s< d Z dZddddddgZdd ljZdd lZdd lZdd ljZdd l j
Z
dd l j Z
dd lZdd lZdd lZdd lZejd
�Zd Zd d
� Zd%dd�Zd&dd�ZG dd� de�Zdd� ZG dd� de�Z G dd� de �Z G d d � d e �Z G d d� de�Z!G d d� de�Z"G d d� de�Z#G d!d� de
j$�Z%d'd#d�Z&d(d$d�Z'd S ))av usb.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� Interface�Endpoint�find� show_devices� Nzusb.corei� c C s$ x |D ]}t ||t| |�� qW d S )N)�setattr�getattr)�input�outputZfields�f� r
�/usr/lib/python3.6/core.py� _set_attr= s
r � �Error Accessing Stringc
C sL |dkr|}n:y(|dkr&t j| |�}nt j| ||�}W n |}Y nX |S )z= try to get a string, but return a string no matter what
r N)�util�
get_string)�dev�indexZlangidZdefault_str_i0Zdefault_access_error�stringr
r
r �_try_get_stringA s
r c C s* y | | }W n t k
r$ |}Y nX |S )zS try to get a string from the lookup table, return "" instead of key
error
)�KeyError)�table�value�defaultr r
r
r � _try_lookupQ s
r c @ s e Zd ZdZdd� ZdS )�_DescriptorInfozc this class is used so that when a descriptor is shown on the
terminal it is propely formatted c C s | S )Nr
)�selfr
r
r �__repr__^ s z_DescriptorInfo.__repr__N)�__name__�
__module__� __qualname__�__doc__r r
r
r
r r [ s r c s t j� �� fdd��}|S )Nc
s, z| j j� � | f|�|�S | j j� X d S )N)�lock�acquire�release)r �args�kwargs)r r
r �wrapperb s
z synchronized.<locals>.wrapper)� functools�wraps)r r) r
)r r � synchronizeda s r, c @ s� e Zd Zdd� Zedd� �Zedd� �Zedd� �Zed d
� �Zed d � �Z ed
d� �Z
edd� �Z edd� �Z edd� �Z
edd� �Zeddd��ZdS ) �_ResourceManagerc C s6 || _ d | _|| _d | _tj� | _i | _tj � | _
d S )N) �backend�_active_cfg_indexr �handle�_interopZ_set�
_claimed_intf�_ep_info� threading�RLockr$ )r r r. r
r
r �__init__l s
z_ResourceManager.__init__c C s | j d kr| jj| j�| _ | j S )N)r0 r. Z open_devicer )r r
r
r � managed_openu s
z _ResourceManager.managed_openc C s" | j d k r | jj| j � d | _ d S )N)r0 r. Z close_device)r r
r
r �
managed_close{ s
z _ResourceManager.managed_closec C s� |d kr|d }n>t |t�r"|}n.|dkrBG dd� dt�}|� }ntj||d�}|d krhtdt|� ��| j� | jj | j
|j � |j | _
| jj� d S )Nr c @ s e Zd Zdd� ZdS )zE_ResourceManager.managed_set_configuration.<locals>.MockConfigurationc S s d | _ d| _d S )Nr )r �bConfigurationValue)r r
r
r r6 � s zN_ResourceManager.managed_set_configuration.<locals>.MockConfiguration.__init__N)r r! r" r6 r
r
r
r �MockConfiguration� s r: )r9 zInvalid configuration )�
isinstancer �objectr �find_descriptor�
ValueError�strr7 r. �set_configurationr0 r9 r r/ r3 �clear)r �device�config�cfgr: r
r
r �managed_set_configuration� s
z*_ResourceManager.managed_set_configurationc C sH | j � t|t�r|j}n|}|| jkrD| jj| j|� | jj|� d S )N) r7 r; r �bInterfaceNumberr2 r. Zclaim_interfacer0 �add)r rB �intf�ir
r
r �managed_claim_interface� s
z(_ResourceManager.managed_claim_interfacec C sf |d kr | j |�}|d j}nt|t�r0|j}n|}|| jkrbz| jj| j|� W d | jj|� X d S )Nr )r r ) �get_active_configurationrF r; r r2 r. Zrelease_interfacer0 �remove)r rB rH rD rI r
r
r �managed_release_interface� s
z*_ResourceManager.managed_release_interfacec C s� t |t�r|}nD| j|�}|d kr,|d j}|d k rFtj|||d�}ntj||d�}| j||� |d krn|j}| jj | j
|j|� d S )Nr )rF �bAlternateSetting)rF )r r ) r; r rK rF r r= rJ rN r. �set_interface_altsettingr0 )r rB rH �altrI rD r
r
r �managed_set_interface� s
z&_ResourceManager.managed_set_interfacec C s: t |t�r|j}n|}| j||�\}}| j||� ||fS )N)r; r �bEndpointAddress�get_interface_and_endpointrJ )r rB �endpoint�endpoint_addressrH �epr
r
r �
setup_request� s
z _ResourceManager.setup_requestc C st y
| j | S tk
rn x>| j|�D ]0}tj||d�}|d k r&||f| j |< ||fS q&W tdt|� ��Y nX d S )N)rR zInvalid endpoint address )r3 r rK r r= r> �hex)r rB rU rH rV r
r
r rS � s
z+_ResourceManager.get_interface_and_endpointc C sP | j d krF| j� tj|| jj| j�d�}|d kr:td��|j| _ |S || j S )N)r9 zConfiguration not set) r/ r7 r r= r. Zget_configurationr0 �USBErrorr )r rB rD r
r
r rK � s
z)_ResourceManager.get_active_configurationc C sD t j | j�}x2|D ]*}y| j||� W q tk
r: Y qX qW d S )N)�copyr2 rM rY )r rB ZclaimedrI r
r
r �release_all_interfaces� s
z'_ResourceManager.release_all_interfacesTc C s* | j |� |r| j� | jj� d | _d S )N)r[ r8 r3 rA r/ )r rB Z close_handler
r
r �dispose s
z_ResourceManager.disposeN)T)r r! r" r6 r, r7 r8 rE rJ rM rQ rW rS rK r[ r\ r
r
r
r r- k s
r- c @ s e Zd ZdZddd�ZdS )rY z�Exception 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 C s t j| ||� || _dS )z�Initialize 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)�IOErrorr6 Zbackend_error_code)r �strerrorZ
error_code�errnor
r
r r6 s zUSBError.__init__)NN)r r! r" r# r6 r
r
r
r rY s rY c @ s e Zd ZdZdS )�NoBackendErrorz2Exception class when a valid backend is not found.N)r r! r" r# r
r
r
r r` s r` c @ sN e Zd ZdZddd�Zdd� Zdd� Zdd
d �Zdd d
�Zdd� Z dd� Z
d S )r a� Represent 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
r c C s: || _ || _|jj}|j|jj||||�}t|| d � d
S ) a( Initialize 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.
�bLength�bDescriptorTyperR � bmAttributes�wMaxPacketSize� bInterval�bRefresh�
bSynchAddress�extra_descriptorsN) ra rb rR rc rd re rf rg rh )rB r �_ctxr. Zget_endpoint_descriptorr r )r rB rT � interface�alternate_setting�
configurationr. �descr
r
r r6 1 s* zEndpoint.__init__c C s d| j � d S )N�<�>)�_str)r r
r
r r ^ s zEndpoint.__repr__c C s� d| j � d }tj| j�tjkr(d}nd}d|ddt|� f dd | jf d
d | jtt j
| j�f d
d | j|f d
d
| j t j | j d@ f dd| j
| j
f dd| jf S )Nz � �IN�OUTz%s%s
�=�< z %-17s:%#7x (7 bytes)
ra z %-17s:%#7x %s
rb rR rc � z %-17s:%#7x (%d bytes)
rd z %-17s:%#7xre )rp r �endpoint_directionrR � ENDPOINT_IN�lenra rb r �_lu� descriptorsrc �
ep_attributesrd re )r �headstr� directionr
r
r �__str__a s |zEndpoint.__str__Nc C s | j j| ||�S )a^ Write data to the endpoint.
The parameter data contains the data to be sent to the endpoint and
timeout is the time limit of the operation. The transfer type and
endpoint address are automatically inferred.
The method returns the number of bytes written.
For details, see the Device.write() method.
)rB �write)r �data�timeoutr
r
r r� x s zEndpoint.writec C s | j j| ||�S )a� Read data from the endpoint.
The parameter size_or_buffer is either the number of bytes to
read or an array object where the data will be put in and timeout is the
time limit of the operation. The transfer type and endpoint address
are automatically inferred.
The method returns either an array object or the number of bytes
actually read.
For details, see the Device.read() method.
)rB �read)r �size_or_bufferr� r
r
r r� � s
z
Endpoint.readc C s | j j| j� dS )z0Clear the halt/status condition of the endpoint.N)rB �
clear_haltrR )r r
r
r r� � s zEndpoint.clear_haltc C s8 t j| j�t jkrd}nd}d| jtj| jd@ |f S )Nrr rs zENDPOINT 0x%X: %s %srv )r rw rR rx rz r| rc )r r~ r
r
r rp � s z
Endpoint._str)r r r )N)N) r r! r" r# r6 r r r� r� r� rp r
r
r
r r " s
,
c @ sZ e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dS )r a� Represent 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
r c
C sF || _ || _|| _|| _|jj}|j| j jj|||�}t|| d � d S )
a� Initialize 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.
ra rb rF rN �
bNumEndpoints�bInterfaceClass�bInterfaceSubClass�bInterfaceProtocol�
iInterfacerh N)
ra rb rF rN r� r� r� r� r� rh ) rB �alternate_indexr rl ri r. Zget_interface_descriptorr r )r rB rj rk rl r. rm r
r
r r6 � s. zInterface.__init__c C s d| j � d S )Nrn ro )rp )r r
r
r r � s zInterface.__repr__c C s* | j � }x | D ]}|dt|� 7 }qW |S )z'Show all information for the interface.�
)�_get_full_descriptor_strr? )r r rT r
r
r r � s
zInterface.__str__c C s t | �S )z*Return a tuple of the interface endpoints.)�tuple)r r
r
r � endpoints� s zInterface.endpointsc C s | j j| j| j� dS )z$Set the interface alternate setting.N)rB rO rF rN )r r
r
r �set_altsetting� s zInterface.set_altsettingc c s2 x,t | j�D ] }t| j|| j| j| j�V q W dS )z,Iterate over all endpoints of the interface.N)�ranger� r rB r r� rl )r rI r
r
r �__iter__� s zInterface.__iter__c C s t | j|| j| j| j�S )z1Return the Endpoint object in the given position.)r rB r r� rl )r r r
r
r � __getitem__� s zInterface.__getitem__c C s4 | j rd| j }nd}d| j|ttj| jdd�f S )Nz, %dr zINTERFACE %d%s: %sz
Unknown Class)r )rN rF r rz �interface_classesr� )r Z alt_settingr
r
r rp s
zInterface._strc C s� d| j � d }d|ddt|� f dd| jf dd | jttj| j�f d
d | jf d
d | jf d
d
| j f dd| j
ttj | j
�f d
d| j f d
d| j
f dd| jt| j| j�f S )Nz rq z%s%s
rt ru z %-19s:%#7x (9 bytes)
ra z %-19s:%#7x %s
rb z %-19s:%#7x
rF rN r� r� r� r� z %-19s:%#7x %sr� )rp ry ra rb r rz r{ rF rN r� r� r� r� r� r� r rB )r r} r
r
r r� s
�z"Interface._get_full_descriptor_strN)r r r )
r r! r" r# r6 r r r� r� r� r� rp r� r
r
r
r r � s
-
c @ sZ e Zd ZdZddd�Zdd� Zdd� Zd d
� Zd d � Zd
d� Z dd� Z
dd� Z dd� Z dS )r a� 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
r c C s6 || _ || _|jj}|j| j jj|�}t|| d � d
S ) a� Initialize 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.
ra rb � wTotalLength�bNumInterfacesr9 �iConfigurationrc � bMaxPowerrh N) ra rb r� r� r9 r� rc r� rh )rB r ri r. Z get_configuration_descriptorr r )r rB rl r. rm r
r
r r6 : s$ zConfiguration.__init__c C s d| j � d S )Nrn ro )rp )r r
r
r r ] s zConfiguration.__repr__c C s* | j � }x | D ]}|dt|� 7 }qW |S )Nz
%s)r� r? )r r rj r
r
r r ` s
zConfiguration.__str__c C s t | �S )z/Return a tuple of the configuration interfaces.)r� )r r
r
r �
interfacesf s zConfiguration.interfacesc C s | j j| j� dS )z)Set this configuration as the active one.N)rB r@ r9 )r r
r
r �setj s zConfiguration.setc
c s\ xVt | j�D ]H}d}y&x t| j||| j�V |d7 }qW W q ttfk
rR Y q X q W dS )z1Iterate over all interfaces of the configuration.r � N)r� r� r rB r rY �
IndexError)r rI rP r
r
r r� n s zConfiguration.__iter__c C s t | j|d |d | j�S )z�Return 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� )r rB r )r r r
r
r r� y s zConfiguration.__getitem__c C s d| j tj| j f S )NzCONFIGURATION %d: %d mA)r9 rz �MAX_POWER_UNITS_USB2p0r� )r r
r
r rp � s zConfiguration._strc C s� d| j � d }| jd@ r d}nd}| jd @ r4d}nd }d
|d d t|� f d
d| jf dd| jttj| j�f dd| j| jf dd| j f dd| j
f dd| j t | j
| j �f dd| j||f dd| jtj| j f S ) Nz rq r� � ZSelfZBus� z, Remote Wakeupr z%s%s
rt ru z %-21s:%#7x (9 bytes)
ra z %-21s:%#7x %s
rb z %-21s:%#7x (%d bytes)
r� z %-21s:%#7x
r� r9 r� z %-21s:%#7x %s Powered%s
rc z %-21s:%#7x (%d mA)r� �@ � )rp rc ry ra rb r rz r{ r� r� r9 r� r rB r� r� )r r} ZpoweredZ
remote_wakeupr
r
r r� � s
�z&Configuration._get_full_descriptor_strN)r )
r r! r" r# r6 r r r� r� r� r� rp r� r
r
r
r r , s
# c @ s e Zd ZdZdd� Zdd� Zdd� Zdd � Zed
d � �Z ed d
� �Z
edd� �Z edd� �Z edd� �Z
d>dd�Zdd� Zd?dd�Zdd � Zd d � Zd@d d �ZdAd!d"�ZdBd$d%�Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Zd2d3� Z d4d5� Z d6d7� Z d8d9� Z d:d;� Z ee e d<d=�Z!dS )Cr a
Device 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 miliseconds. If the parameter is omitted, Device.default_timeout value
will be used instead. This property can be set by the user at anytime.
c C s d| j � d S )Nrn ro )rp )r r
r
r r � s zDevice.__repr__c C s| | j � }y"x | D ]}|dt|� 7 }qW W nL tk
rv y| j� }|d|j 7 }W n tk
rp |d7 }Y nX Y nX |S )Nz
%sz" USBError Accessing Configurations)r� r? rY rK �info)r r rl r
r
r r � s
zDevice.__str__c C s t | �S )z,Return a tuple of the device configurations.)r� )r r
r
r �configurations� s zDevice.configurationsc C s� t ||�| _t| _d\| _| _| _d| _|j|�}t || d� |j
dk rVt |j
�| _
nd| _
|j dk rtt |j �| _ nd| _ |j
dk r�t |j
�| _
nd| _
|jdk r�t |j�| _nd| _dS )aC Initialize 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.
Nra rb �bcdUSB� bDeviceClass�bDeviceSubClass�bDeviceProtocol�bMaxPacketSize0�idVendor� idProduct� bcdDevice�
iManufacturer�iProduct�
iSerialNumber�bNumConfigurations�address�bus� port_number� port_numbers�speed)NNN)ra rb r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� )r- ri �_DEFAULT_TIMEOUT�_Device__default_timeout�_serial_number�_product�
_manufacturer�_langidsZget_device_descriptorr r� �intr� r� r� )r r r. rm r
r
r r6 � sN
zDevice.__init__c C s< | j dkr6ytj| �| _ W n tk
r4 f | _ Y nX | j S )a� Return 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.
N)r� r Z get_langidsrY )r r
r
r �langids# s
zDevice.langidsc C s | j dkrtj| | j�| _ | j S )z� Return 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.
N)r� r r r� )r r
r
r �
serial_number6 s
zDevice.serial_numberc C s | j dkrtj| | j�| _ | j S )z� Return 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.
N)r� r r r� )r r
r
r �productA s
zDevice.productc C s | j dkrtj| | j�| _ | j S )z� Return 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.
N)r� r r r� )r r
r
r � manufacturerL s
zDevice.manufacturerc C s | j jS )z,Return the backend being used by the device.)ri r. )r r
r
r r. W s zDevice.backendNc C s | j j| |� dS )a� Set 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)ri rE )r rl r
r
r r@ \ s zDevice.set_configurationc C s | j j| �S )zZReturn a Configuration object representing the current
configuration set.
)ri rK )r r
r
r rK g s z Device.get_active_configurationc C s | j j| ||� dS )a} Set 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)ri rQ )r rj rk r
r
r rO m s z Device.set_interface_altsettingc C s2 t |t�r|j}| jj� | jjj| jj|� dS )z4 Clear the halt/stall condition for the endpoint ep.N)r; r rR ri r7 r. r� r0 )r rV r
r
r r� � s
zDevice.clear_haltc C s< | j j� | j j| d� | j jj| j j� | j j| d� dS )zReset the device.FTN)ri r7 r\ r. Z reset_devicer0 )r r
r
r �reset� s
z Device.resetc C sj | j j}tj|jtj|jtj|ji}| j j | |�\}}|tj
|j � }|| j j |j
|jtj|�| j|��S )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 miliseconds.
The method returns the number of bytes written.
)ri r. r �ENDPOINT_TYPE_BULKZ
bulk_write�ENDPOINT_TYPE_INTRZ
intr_write�ENDPOINT_TYPE_ISOZ iso_writerW �
endpoint_typerc r0 rR rF r1 �as_array�_Device__get_timeout) r rT r� r� r. �fn_maprH rV �fnr
r
r r� � s z Device.writec C s� | j j}tj|jtj|jtj|ji}| j j | |�\}}|tj
|j � }t |t
j
�rX|} n
tj|�} || j j|j|j| | j|��}
t |t
j
�r�|
S |
t| �| j kr�| d|
� S | S dS )a� Read 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 miliseconds.
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)ri r. r r� Z bulk_readr� Z intr_readr� Ziso_readrW r� rc r; �array�
create_bufferr0 rR rF r� ry �itemsize) r rT r� r� r. r� rH rV r� �buff�retr
r
r r� � s(
z Device.readr c C s� yt j|�}W n tk
r, tj|�}Y nX | jj� |d@ }|d@ } |t jkrr| t jkrr|d@ }
| jj | |
� | jj
j | jj |||||| j
|��} t|tj�s�t j|�t jkr�| S | t|�|j kr�|d| � S |S dS )a� Do 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.
rv r� � N�` )r r� � TypeErrorr1 r� ri r7 ZCTRL_RECIPIENT_INTERFACEZCTRL_TYPE_VENDORrJ r. �
ctrl_transferr0 r� r; r� Zctrl_directionZCTRL_OUTry r� ) r Z
bmRequestTypeZbRequestZwValueZwIndexZdata_or_wLengthr� r� Z recipientZrqtypeZinterface_numberr� r
r
r r� � s2
zDevice.ctrl_transferc C s | j j� | j jj| j j|�S )z�Determine 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.
)ri r7 r. �is_kernel_driver_activer0 )r rj r
r
r r� s
z Device.is_kernel_driver_activec C s" | j j� | j jj| j j|� dS )z�Detach 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)ri r7 r. �detach_kernel_driverr0 )r rj r
r
r r� * s
zDevice.detach_kernel_driverc C s" | j j� | j jj| j j|� dS )z�Re-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)ri r7 r. �attach_kernel_driverr0 )r rj r
r
r r� 7 s
zDevice.attach_kernel_driverc c s$ x t | j�D ]}t| |�V q W dS )z.Iterate over all configurations of the device.N)r� r� r )r rI r
r
r r� C s zDevice.__iter__c C s
t | |�S )z6Return the Configuration object in the given position.)r )r r r
r
r r� H s zDevice.__getitem__c C s | j j| � d S )N)ri r\ )r r
r
r �_finalize_objectL s zDevice._finalize_objectc C s |d k r |S | j S )N)r� )r r� r
r
r Z
__get_timeoutO s zDevice.__get_timeoutc C s |dk rt d��|| _d S )Nr z"Timeout cannot be a negative value)r> r� )r Ztmor
r
r Z
__set_def_tmoT s zDevice.__set_def_tmoc C s | j S )N)r� )r r
r
r Z
__get_def_tmoY s zDevice.__get_def_tmoc C s d| j | j| j| jf S )Nz,DEVICE ID %04x:%04x on Bus %03d Address %03d)r� r� r� r� )r r
r
r rp \ s z Device._strc C s� | j � d }| jd@ r&t| jd@ �}nd}| jd@ rDt| jd@ �}nd}d|ddt|� f dd| jf d d
| jttj | j�f d d | j| jd
@ d? | jd@ d? |f d d| j
ttj | j
�f dd| j f dd| j
f dd| j| jf dd| jf dd| jf dd| j| jd
@ d? | jd@ d? |f d d | jt| | j�f d d | jt| | j�f d d | jt| | j�f d d | jf S )!Nrq � r z%s%s
rt ru z %-23s:%#7x (18 bytes)
ra z %-23s:%#7x %s
rb z %-23s:%#7x USB %d.%d%s
r� i � � �� � r� z %-23s:%#7x
r� r� z %-23s:%#7x (%d bytes)
r� z %-23s: %#06x
r� r� z %-23s:%#7x Device %d.%d%s
r� r� r� r� z %-23s:%#7xr� )rp r� r? r� ry ra rb r rz r{ r� �device_classesr� r� r� r� r� r� r r� r� r� )r r} Z low_bcd_usbZlow_bcd_devicer
r
r r� ` s
#� ;z Device._get_full_descriptor_strz*Default timeout for transfer I/O functions)�doc)N)NN)N)N)r r NN)"r r! r" r# r r r� r6 �propertyr� r� r� r� r. r@ rK rO r� r� r� r� r� r� r� r� r� r� r� r� Z_Device__set_def_tmoZ_Device__get_def_tmorp r� Zdefault_timeoutr
r
r
r r � sD "
>
!
.
7
2Fc s� � �fdd�}� dkrvddl jj}ddljj}ddljj}x:|||fD ]$}|j� � � dk rFtj d|j
� P qFW t d��| r�|f |�S yt j
|f |��S tk
r� dS X dS )a
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 ; sV xP�j � D ]D}t|��� � fdd�| j� D �}tj|�r
�d ksH�� �r
� V q
W d S )Nc 3 s | ]\}}|t � |�kV qd S )N)r )�.0�key�val)�dr
r � <genexpr>� s z,find.<locals>.device_iter.<locals>.<genexpr>)Zenumerate_devicesr �itemsr1 Z_all)r( r Ztests)r. � custom_match)r� r � device_iter� s
zfind.<locals>.device_iterNr zfind(): using backend "%s"zNo backend available)Zusb.backend.libusb1r. �libusb1Zusb.backend.libusb0�libusb0Zusb.backend.openusb�openusbZ get_backend�_loggerr� r r` r1 Z_next�
StopIteration) �find_allr. r� r' r� r� r� r� �mr
)r. r� r r � s" D
c K s` d|d< t f |�}d}x@|D ]8}| sD|d|j� ttj|j�f 7 }q |dt|� 7 }q W t|�S )z�Show information about connected devices.
The verbose flag sets to verbose or not.
**kwargs are passed directly to the find() function.
Tr� r z%s, %s
z%s
)r rp r rz r� r� r? r )�verboser( ZdevicesZstringsrB r
r
r r � s
)Nr r )r )FNN)F)(r# �
__author__�__all__Zusb.utilr rZ �operatorZ usb._interopr1 Zusb._objfinalizerZ
_objfinalizerZ usb._lookupZ_lookuprz Zloggingr� r4 r* Z getLoggerr� r� r r r r? r r, r< r- r] rY r> r` r r r ZAutoFinalizedObjectr r r r
r
r
r �<module>' sJ
!
o
`