Struct DeviceInfo

pub struct DeviceInfo { /* private fields */ }

Corresponds to android.hardware.usb.UsbDevice. Its fields and the InterfaceInfo list are read on creation and will not be updated automatically; however, PartialEq depends on these fields.

Implementations

impl DeviceInfo

pub fn has_permission(&self) -> Result<bool, Error>

Returns true if the caller has permission to access the device.

pub fn check_connection(&self) -> bool

Checks if the device is still in the list of connected devices. Note: The implementation can be optimized.

pub fn request_permission(&self) -> Result<Option<PermissionRequest>, Error>

Performs a permission request for the device.

Returns Ok(None) if the permission is already granted. Otherwise it returns a PermissionRequest handler.

The activity might be paused by requestPermission() here, but resumed on receving result. The state of PermissionRequest can be checked on android_activity::MainEvent::Resume, Otherwise block in a background thread (it wouldn’t be paused/resumed automatically).

pub fn open_device(&self) -> Result<Device, Error>

Opens the device. Returns error PermissionDenied if the permission is not granted.

impl DeviceInfo

pub fn vendor_id(&self) -> u16

Equals idVendor.

pub fn product_id(&self) -> u16

Equals idProduct.

pub fn class(&self) -> u8

Equals bDeviceClass.

pub fn subclass(&self) -> u8

Equals bDeviceSubClass.

pub fn protocol(&self) -> u8

Equals bDeviceProtocol.

impl DeviceInfo

pub fn path_name(&self) -> &String

(usually) Path of the device in the usbfs file system.

pub fn manufacturer_string(&self) -> &Option<String>

Vendor name.

pub fn product_string(&self) -> &Option<String>

Product name.

pub fn version(&self) -> &Option<String>

USB protocol version.

pub fn serial_number(&self) -> &Option<String>

Device serial ID string. FIXME: On Android 10 and above, this is always None if this struct is created before gaining permission for the device. To read it, call list_devices() and find the device again after the permission is granted.

impl DeviceInfo

pub fn interfaces(&self) -> impl Iterator<Item = &InterfaceInfo>

Iterator over the device’s interfaces.

Trait Implementations

impl Clone for DeviceInfo

fn clone(&self) -> DeviceInfo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DeviceInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for DeviceInfo

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.