usb 1.9.1 → 2.0.1

package/dist/usb/endpoint.js

@@ -0,0 +1,236 @@
+"use strict";
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutEndpoint = exports.InEndpoint = exports.Endpoint = void 0;
+var events_1 = require("events");
+var bindings_1 = require("./bindings");
+var isBuffer = function (obj) { return obj && obj instanceof Uint8Array; };
+/** Common base for InEndpoint and OutEndpoint. */
+var Endpoint = /** @class */ (function (_super) {
+    __extends(Endpoint, _super);
+    function Endpoint(device, descriptor) {
+        var _this = _super.call(this) || this;
+        _this.device = device;
+        /** Sets the timeout in milliseconds for transfers on this endpoint. The default, `0`, is infinite timeout. */
+        _this.timeout = 0;
+        _this.descriptor = descriptor;
+        _this.address = descriptor.bEndpointAddress;
+        _this.transferType = descriptor.bmAttributes & 0x03;
+        return _this;
+    }
+    /** Clear the halt/stall condition for this endpoint. */
+    Endpoint.prototype.clearHalt = function (callback) {
+        return this.device.__clearHalt(this.address, callback);
+    };
+    /**
+     * Create a new `Transfer` object for this endpoint.
+     *
+     * The passed callback will be called when the transfer is submitted and finishes. Its arguments are the error (if any), the submitted buffer, and the amount of data actually written (for
+     * OUT transfers) or read (for IN transfers).
+     *
+     * @param timeout Timeout for the transfer (0 means unlimited).
+     * @param callback Transfer completion callback.
+     */
+    Endpoint.prototype.makeTransfer = function (timeout, callback) {
+        return new bindings_1.Transfer(this.device, this.address, this.transferType, timeout, callback);
+    };
+    return Endpoint;
+}(events_1.EventEmitter));
+exports.Endpoint = Endpoint;
+/** Endpoints in the IN direction (device->PC) have this type. */
+var InEndpoint = /** @class */ (function (_super) {
+    __extends(InEndpoint, _super);
+    function InEndpoint(device, descriptor) {
+        var _this = _super.call(this, device, descriptor) || this;
+        /** Endpoint direction. */
+        _this.direction = 'in';
+        _this.pollTransferSize = 0;
+        _this.pollPending = 0;
+        _this.pollActive = false;
+        return _this;
+    }
+    /**
+     * Perform a transfer to read data from the endpoint.
+     *
+     * If length is greater than maxPacketSize, libusb will automatically split the transfer in multiple packets, and you will receive one callback with all data once all packets are complete.
+     *
+     * `this` in the callback is the InEndpoint object.
+     *
+     * The device must be open to use this method.
+     * @param length
+     * @param callback
+     */
+    InEndpoint.prototype.transfer = function (length, callback) {
+        var _this = this;
+        var buffer = Buffer.alloc(length);
+        var cb = function (error, _buffer, actualLength) {
+            callback.call(_this, error, buffer.slice(0, actualLength));
+        };
+        try {
+            this.makeTransfer(this.timeout, cb).submit(buffer);
+        }
+        catch (e) {
+            process.nextTick(function () { return callback.call(_this, e); });
+        }
+        return this;
+    };
+    /**
+     * Start polling the endpoint.
+     *
+     * The library will keep `nTransfers` transfers of size `transferSize` pending in the kernel at all times to ensure continuous data flow.
+     * This is handled by the libusb event thread, so it continues even if the Node v8 thread is busy. The `data` and `error` events are emitted as transfers complete.
+     *
+     * The device must be open to use this method.
+     * @param nTransfers
+     * @param transferSize
+     */
+    InEndpoint.prototype.startPoll = function (nTransfers, transferSize, _callback) {
+        var _this = this;
+        var transferDone = function (error, transfer, buffer, actualLength) {
+            if (!error) {
+                _this.emit('data', buffer.slice(0, actualLength));
+            }
+            else if (error.errno != bindings_1.LIBUSB_TRANSFER_CANCELLED) {
+                _this.emit('error', error);
+                _this.stopPoll();
+            }
+            if (_this.pollActive) {
+                startTransfer(transfer);
+            }
+            else {
+                _this.pollPending--;
+                if (_this.pollPending === 0) {
+                    _this.pollTransfers = [];
+                    _this.emit('end');
+                }
+            }
+        };
+        var startTransfer = function (transfer) {
+            try {
+                transfer.submit(Buffer.alloc(_this.pollTransferSize), function (error, buffer, actualLength) {
+                    transferDone(error, transfer, buffer, actualLength);
+                });
+            }
+            catch (e) {
+                _this.emit('error', e);
+                _this.stopPoll();
+            }
+        };
+        this.pollTransfers = this.startPollTransfers(nTransfers, transferSize, function (error, buffer, actualLength) {
+            transferDone(error, this, buffer, actualLength);
+        });
+        this.pollTransfers.forEach(startTransfer);
+        this.pollPending = this.pollTransfers.length;
+        return this.pollTransfers;
+    };
+    InEndpoint.prototype.startPollTransfers = function (nTransfers, transferSize, callback) {
+        if (nTransfers === void 0) { nTransfers = 3; }
+        if (transferSize === void 0) { transferSize = this.descriptor.wMaxPacketSize; }
+        if (this.pollTransfers) {
+            throw new Error('Polling already active');
+        }
+        this.pollTransferSize = transferSize;
+        this.pollActive = true;
+        this.pollPending = 0;
+        var transfers = [];
+        for (var i = 0; i < nTransfers; i++) {
+            var transfer = this.makeTransfer(0, callback);
+            transfers[i] = transfer;
+        }
+        return transfers;
+    };
+    /**
+     * Stop polling.
+     *
+     * Further data may still be received. The `end` event is emitted and the callback is called once all transfers have completed or canceled.
+     *
+     * The device must be open to use this method.
+     * @param callback
+     */
+    InEndpoint.prototype.stopPoll = function (callback) {
+        if (!this.pollTransfers) {
+            throw new Error('Polling is not active.');
+        }
+        for (var i = 0; i < this.pollTransfers.length; i++) {
+            try {
+                this.pollTransfers[i].cancel();
+            }
+            catch (error) {
+                this.emit('error', error);
+            }
+        }
+        this.pollActive = false;
+        if (callback)
+            this.once('end', callback);
+    };
+    return InEndpoint;
+}(Endpoint));
+exports.InEndpoint = InEndpoint;
+/** Endpoints in the OUT direction (PC->device) have this type. */
+var OutEndpoint = /** @class */ (function (_super) {
+    __extends(OutEndpoint, _super);
+    function OutEndpoint() {
+        var _this = _super !== null && _super.apply(this, arguments) || this;
+        /** Endpoint direction. */
+        _this.direction = 'out';
+        return _this;
+    }
+    /**
+     * Perform a transfer to write `data` to the endpoint.
+     *
+     * If length is greater than maxPacketSize, libusb will automatically split the transfer in multiple packets, and you will receive one callback once all packets are complete.
+     *
+     * `this` in the callback is the OutEndpoint object.
+     *
+     * The device must be open to use this method.
+     * @param buffer
+     * @param callback
+     */
+    OutEndpoint.prototype.transfer = function (buffer, callback) {
+        var _this = this;
+        if (!buffer) {
+            buffer = Buffer.alloc(0);
+        }
+        else if (!isBuffer(buffer)) {
+            buffer = Buffer.from(buffer);
+        }
+        var cb = function (error, _buffer, actual) {
+            if (callback) {
+                callback.call(_this, error, actual || 0);
+            }
+        };
+        try {
+            this.makeTransfer(this.timeout, cb).submit(buffer);
+        }
+        catch (e) {
+            process.nextTick(function () { return cb(e); });
+        }
+        return this;
+    };
+    OutEndpoint.prototype.transferWithZLP = function (buffer, callback) {
+        if (buffer.length % this.descriptor.wMaxPacketSize === 0) {
+            this.transfer(buffer);
+            this.transfer(Buffer.alloc(0), callback);
+        }
+        else {
+            this.transfer(buffer, callback);
+        }
+    };
+    return OutEndpoint;
+}(Endpoint));
+exports.OutEndpoint = OutEndpoint;
+//# sourceMappingURL=endpoint.js.map

package/dist/usb/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../tsc/usb/endpoint.ts"],"names":[],"mappings":"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"}

package/dist/usb/index.d.ts

@@ -0,0 +1,25 @@
+import { ExtendedDevice } from './device';
+import * as usb from './bindings';
+interface EventListeners<T> {
+    newListener: keyof T;
+    removeListener: keyof T;
+}
+declare module './bindings' {
+    interface Device extends ExtendedDevice {
+    }
+    interface DeviceEvents extends EventListeners<DeviceEvents> {
+        attach: Device;
+        detach: Device;
+    }
+    function addListener<K extends keyof DeviceEvents>(event: K, listener: (arg: DeviceEvents[K]) => void): void;
+    function removeListener<K extends keyof DeviceEvents>(event: K, listener: (arg: DeviceEvents[K]) => void): void;
+    function on<K extends keyof DeviceEvents>(event: K, listener: (arg: DeviceEvents[K]) => void): void;
+    function off<K extends keyof DeviceEvents>(event: K, listener: (arg: DeviceEvents[K]) => void): void;
+    function once<K extends keyof DeviceEvents>(event: K, listener: (arg: DeviceEvents[K]) => void): void;
+    function listeners<K extends keyof DeviceEvents>(event: K): ((arg: DeviceEvents[K]) => void)[];
+    function rawListeners<K extends keyof DeviceEvents>(event: K): ((arg: DeviceEvents[K]) => void)[];
+    function removeAllListeners<K extends keyof DeviceEvents>(event?: K): void;
+    function emit<K extends keyof DeviceEvents>(event: K, arg: DeviceEvents[K]): boolean;
+    function listenerCount<K extends keyof DeviceEvents>(event: K): number;
+}
+export = usb;

package/dist/usb/index.js

@@ -0,0 +1,116 @@
+"use strict";
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+var events_1 = require("events");
+var device_1 = require("./device");
+var usb = require("./bindings");
+if (usb.INIT_ERROR) {
+    /* eslint-disable no-console */
+    console.warn('Failed to initialize libusb.');
+}
+Object.setPrototypeOf(usb, events_1.EventEmitter.prototype);
+Object.getOwnPropertyNames(device_1.ExtendedDevice.prototype).forEach(function (name) {
+    Object.defineProperty(usb.Device.prototype, name, Object.getOwnPropertyDescriptor(device_1.ExtendedDevice.prototype, name) || Object.create(null));
+});
+// Polling mechanism for discovering device changes until this is fixed:
+// https://github.com/libusb/libusb/issues/86
+var pollTimeout = 500;
+var hotplugSupported = usb._getLibusbCapability(usb.LIBUSB_CAP_HAS_HOTPLUG) > 0;
+var pollingHotplug = false;
+var pollDevices = [];
+var pollHotplug = function (start) {
+    var e_1, _a, e_2, _b;
+    if (start === void 0) { start = false; }
+    if (start) {
+        pollingHotplug = true;
+    }
+    else if (!pollingHotplug) {
+        return;
+    }
+    var devices = usb.getDeviceList();
+    if (!start) {
+        var _loop_1 = function (device) {
+            var found = pollDevices.find(function (item) { return item.deviceAddress === device.deviceAddress; });
+            if (!found) {
+                usb.emit('attach', device);
+            }
+        };
+        try {
+            // Find attached devices
+            for (var devices_1 = __values(devices), devices_1_1 = devices_1.next(); !devices_1_1.done; devices_1_1 = devices_1.next()) {
+                var device = devices_1_1.value;
+                _loop_1(device);
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (devices_1_1 && !devices_1_1.done && (_a = devices_1.return)) _a.call(devices_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        var _loop_2 = function (device) {
+            var found = devices.find(function (item) { return item.deviceAddress === device.deviceAddress; });
+            if (!found) {
+                usb.emit('detach', device);
+            }
+        };
+        try {
+            // Find detached devices
+            for (var pollDevices_1 = __values(pollDevices), pollDevices_1_1 = pollDevices_1.next(); !pollDevices_1_1.done; pollDevices_1_1 = pollDevices_1.next()) {
+                var device = pollDevices_1_1.value;
+                _loop_2(device);
+            }
+        }
+        catch (e_2_1) { e_2 = { error: e_2_1 }; }
+        finally {
+            try {
+                if (pollDevices_1_1 && !pollDevices_1_1.done && (_b = pollDevices_1.return)) _b.call(pollDevices_1);
+            }
+            finally { if (e_2) throw e_2.error; }
+        }
+    }
+    pollDevices = devices;
+    setTimeout(function () {
+        pollHotplug();
+    }, pollTimeout);
+};
+usb.on('newListener', function (event) {
+    if (event !== 'attach' && event !== 'detach') {
+        return;
+    }
+    var listenerCount = usb.listenerCount('attach') + usb.listenerCount('detach');
+    if (listenerCount === 0) {
+        if (hotplugSupported) {
+            usb._enableHotplugEvents();
+        }
+        else {
+            pollHotplug(true);
+        }
+    }
+});
+usb.on('removeListener', function (event) {
+    if (event !== 'attach' && event !== 'detach') {
+        return;
+    }
+    var listenerCount = usb.listenerCount('attach') + usb.listenerCount('detach');
+    if (listenerCount === 0) {
+        if (hotplugSupported) {
+            usb._disableHotplugEvents();
+        }
+        else {
+            pollingHotplug = false;
+        }
+    }
+});
+module.exports = usb;
+//# sourceMappingURL=index.js.map

package/dist/usb/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../tsc/usb/index.ts"],"names":[],"mappings":"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"}

package/dist/usb/interface.d.ts

@@ -0,0 +1,78 @@
+import { LibUSBException, Device } from './bindings';
+import { InterfaceDescriptor } from './descriptors';
+import { Endpoint } from './endpoint';
+export declare class Interface {
+    protected device: Device;
+    protected id: number;
+    /** Integer interface number. */
+    interfaceNumber: number;
+    /** Integer alternate setting number. */
+    altSetting: number;
+    /** Object with fields from the interface descriptor -- see libusb documentation or USB spec. */
+    descriptor: InterfaceDescriptor;
+    /** List of endpoints on this interface: InEndpoint and OutEndpoint objects. */
+    endpoints: Endpoint[];
+    constructor(device: Device, id: number);
+    protected refresh(): void;
+    /**
+     * Claims the interface. This method must be called before using any endpoints of this interface.
+     *
+     * The device must be open to use this method.
+     */
+    claim(): void;
+    /**
+     * Releases the interface and resets the alternate setting. Calls callback when complete.
+     *
+     * It is an error to release an interface with pending transfers.
+     *
+     * The device must be open to use this method.
+     * @param callback
+     */
+    release(callback?: (error?: LibUSBException) => void): void;
+    /**
+     * Releases the interface and resets the alternate setting. Calls callback when complete.
+     *
+     * It is an error to release an interface with pending transfers. If the optional closeEndpoints
+     * parameter is true, any active endpoint streams are stopped (see `Endpoint.stopStream`),
+     * and the interface is released after the stream transfers are cancelled. Transfers submitted
+     * individually with `Endpoint.transfer` are not affected by this parameter.
+     *
+     * The device must be open to use this method.
+     * @param closeEndpoints
+     * @param callback
+     */
+    release(closeEndpoints?: boolean, callback?: (error?: LibUSBException) => void): void;
+    /**
+     * Returns `false` if a kernel driver is not active; `true` if active.
+     *
+     * The device must be open to use this method.
+     */
+    isKernelDriverActive(): boolean;
+    /**
+     * Detaches the kernel driver from the interface.
+     *
+     * The device must be open to use this method.
+     */
+    detachKernelDriver(): void;
+    /**
+     * Re-attaches the kernel driver for the interface.
+     *
+     * The device must be open to use this method.
+     */
+    attachKernelDriver(): void;
+    /**
+     * Sets the alternate setting. It updates the `interface.endpoints` array to reflect the endpoints found in the alternate setting.
+     *
+     * The device must be open to use this method.
+     * @param altSetting
+     * @param callback
+     */
+    setAltSetting(altSetting: number, callback?: (error: LibUSBException | undefined) => void): void;
+    /**
+     * Return the InEndpoint or OutEndpoint with the specified address.
+     *
+     * The device must be open to use this method.
+     * @param addr
+     */
+    endpoint(addr: number): Endpoint;
+}

package/dist/usb/interface.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Interface = void 0;
+var bindings_1 = require("./bindings");
+var endpoint_1 = require("./endpoint");
+var Interface = /** @class */ (function () {
+    function Interface(device, id) {
+        this.device = device;
+        this.id = id;
+        /** Integer alternate setting number. */
+        this.altSetting = 0;
+        this.refresh();
+    }
+    Interface.prototype.refresh = function () {
+        if (!this.device.configDescriptor) {
+            return;
+        }
+        this.descriptor = this.device.configDescriptor.interfaces[this.id][this.altSetting];
+        this.interfaceNumber = this.descriptor.bInterfaceNumber;
+        this.endpoints = [];
+        var len = this.descriptor.endpoints.length;
+        for (var i = 0; i < len; i++) {
+            var desc = this.descriptor.endpoints[i];
+            var c = (desc.bEndpointAddress & bindings_1.LIBUSB_ENDPOINT_IN) ? endpoint_1.InEndpoint : endpoint_1.OutEndpoint;
+            this.endpoints[i] = new c(this.device, desc);
+        }
+    };
+    /**
+     * Claims the interface. This method must be called before using any endpoints of this interface.
+     *
+     * The device must be open to use this method.
+     */
+    Interface.prototype.claim = function () {
+        this.device.__claimInterface(this.id);
+    };
+    Interface.prototype.release = function (closeEndpointsOrCallback, callback) {
+        var _this = this;
+        var closeEndpoints = false;
+        if (typeof closeEndpointsOrCallback === 'boolean') {
+            closeEndpoints = closeEndpointsOrCallback;
+        }
+        else {
+            callback = closeEndpointsOrCallback;
+        }
+        var next = function () {
+            _this.device.__releaseInterface(_this.id, function (error) {
+                if (!error) {
+                    _this.altSetting = 0;
+                    _this.refresh();
+                }
+                if (callback) {
+                    callback.call(_this, error);
+                }
+            });
+        };
+        if (!closeEndpoints || this.endpoints.length === 0) {
+            next();
+        }
+        else {
+            var n_1 = this.endpoints.length;
+            this.endpoints.forEach(function (ep) {
+                if (ep.direction === 'in' && ep.pollActive) {
+                    ep.once('end', function () {
+                        if (--n_1 === 0) {
+                            next();
+                        }
+                    });
+                    ep.stopPoll();
+                }
+                else {
+                    if (--n_1 === 0) {
+                        next();
+                    }
+                }
+            });
+        }
+    };
+    /**
+     * Returns `false` if a kernel driver is not active; `true` if active.
+     *
+     * The device must be open to use this method.
+     */
+    Interface.prototype.isKernelDriverActive = function () {
+        return this.device.__isKernelDriverActive(this.id);
+    };
+    /**
+     * Detaches the kernel driver from the interface.
+     *
+     * The device must be open to use this method.
+     */
+    Interface.prototype.detachKernelDriver = function () {
+        return this.device.__detachKernelDriver(this.id);
+    };
+    /**
+     * Re-attaches the kernel driver for the interface.
+     *
+     * The device must be open to use this method.
+     */
+    Interface.prototype.attachKernelDriver = function () {
+        return this.device.__attachKernelDriver(this.id);
+    };
+    /**
+     * Sets the alternate setting. It updates the `interface.endpoints` array to reflect the endpoints found in the alternate setting.
+     *
+     * The device must be open to use this method.
+     * @param altSetting
+     * @param callback
+     */
+    Interface.prototype.setAltSetting = function (altSetting, callback) {
+        var _this = this;
+        this.device.__setInterface(this.id, altSetting, function (error) {
+            if (!error) {
+                _this.altSetting = altSetting;
+                _this.refresh();
+            }
+            if (callback) {
+                callback.call(_this, error);
+            }
+        });
+    };
+    /**
+     * Return the InEndpoint or OutEndpoint with the specified address.
+     *
+     * The device must be open to use this method.
+     * @param addr
+     */
+    Interface.prototype.endpoint = function (addr) {
+        var endpoint = this.endpoints.find(function (item) { return item.address === addr; });
+        if (!endpoint) {
+            throw new Error("Endpoint not found for address: " + addr);
+        }
+        return endpoint;
+    };
+    return Interface;
+}());
+exports.Interface = Interface;
+//# sourceMappingURL=interface.js.map

package/dist/usb/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../tsc/usb/interface.ts"],"names":[],"mappings":"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"}

package/dist/webusb/index.d.ts

@@ -0,0 +1,56 @@
+/// <reference types="w3c-web-usb" />
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+/**
+ * USB Options
+ */
+export interface USBOptions {
+    /**
+     * Optional `device found` callback function to allow the user to select a device
+     */
+    devicesFound?: (devices: USBDevice[]) => Promise<USBDevice | void>;
+    /**
+     * Optional array of preconfigured allowed devices
+     */
+    allowedDevices?: USBDeviceFilter[];
+    /**
+     * Optional flag to automatically allow all devices
+     */
+    allowAllDevices?: boolean;
+    /**
+     * Optional timeout (in milliseconds) to use for the device control transfers
+     */
+    deviceTimeout?: number;
+}
+export declare class WebUSB implements USB {
+    private options;
+    protected emitter: EventEmitter;
+    protected knownDevices: Map<string, USBDevice>;
+    protected allowedDevices: USBDeviceFilter[];
+    constructor(options?: USBOptions);
+    private _onconnect;
+    set onconnect(fn: (ev: USBConnectionEvent) => void);
+    private _ondisconnect;
+    set ondisconnect(fn: (ev: USBConnectionEvent) => void);
+    addEventListener(type: 'connect' | 'disconnect', listener: (this: this, ev: USBConnectionEvent) => void): void;
+    addEventListener(type: 'connect' | 'disconnect', listener: EventListener): void;
+    removeEventListener(type: 'connect' | 'disconnect', callback: (this: this, ev: USBConnectionEvent) => void): void;
+    removeEventListener(type: 'connect' | 'disconnect', callback: EventListener): void;
+    dispatchEvent(_event: Event): boolean;
+    /**
+     * Requests a single Web USB device
+     * @param options The options to use when scanning
+     * @returns Promise containing the selected device
+     */
+    requestDevice(options?: USBDeviceRequestOptions): Promise<USBDevice>;
+    /**
+     * Gets all allowed Web USB devices which are connected
+     * @returns Promise containing an array of devices
+     */
+    getDevices(): Promise<USBDevice[]>;
+    private loadDevices;
+    private preFilterDevices;
+    private filterDevice;
+    private getDeviceId;
+    private isAllowedDevice;
+}