ota-hub-reactjs 0.0.14 → 0.0.15

package/dist/transport_layers/serial-device-whisperer.d.ts

@@ -1,7 +1,8 @@
 import { DeviceConnectionState, AddConnectionProps } from "../base/device-whisperer.js";
 export declare class UsbTransport {
     device: USBDevice;
-    interfaceNumber: number;
+    controlInterface: number;
+    dataInterface: number;
     endpointIn: number;
     endpointOut: number;
     private static readonly SET_LINE_CODING;

package/dist/transport_layers/serial-device-whisperer.js

@@ -14,7 +14,8 @@ import { useEffect } from "react";
 // usb-transport.ts
 export class UsbTransport {
     constructor(device) {
-        this.interfaceNumber = 0;
+        this.controlInterface = 0;
+        this.dataInterface = 1;
         this.endpointIn = 0;
         this.endpointOut = 0;
         this.device = device;
@@ -27,25 +28,40 @@ export class UsbTransport {
         if (this.device.configuration === null) {
             await this.device.selectConfiguration(1);
         }
-        // Find the CDC Data interface (usually class 10) or just the first one with Bulk endpoints
         const interfaces = this.device.configuration?.interfaces || [];
-        let targetInterface;
-        for (const iface of interfaces) {
+        let ctrlIface;
+        let dataIface;
+        dataIface = interfaces.find(iface => {
             const endpoints = iface.alternate.endpoints;
-            const hasIn = endpoints.some(e => e.direction === 'in' && e.type === 'bulk');
-            const hasOut = endpoints.some(e => e.direction === 'out' && e.type === 'bulk');
-            if (hasIn && hasOut) {
-                targetInterface = iface;
-                break;
+            return endpoints.some(e => e.direction === 'in' && e.type === 'bulk') &&
+                endpoints.some(e => e.direction === 'out' && e.type === 'bulk');
+        });
+        if (dataIface) {
+            this.dataInterface = dataIface.interfaceNumber;
+            ctrlIface = interfaces.find(i => i.interfaceNumber === this.dataInterface - 1)
+                || interfaces.find(i => i.alternate.interfaceClass === 2);
+            this.controlInterface = ctrlIface ? ctrlIface.interfaceNumber : this.dataInterface;
+        }
+        if (!dataIface) {
+            throw new Error("No serial-compatible Bulk interface found.");
+        }
+        // Note: On Android, if the OS has claimed Interface 0, this first call will fail.
+        try {
+            if (this.controlInterface !== this.dataInterface) {
+                await this.device.claimInterface(this.controlInterface);
             }
         }
-        if (!targetInterface) {
-            throw new Error("No serial-compatible interface found on device.");
+        catch (e) {
+            console.warn("Could not claim Control Interface (OS locked?). Proceeding to Data...", e);
+            // We continue, but setSignals might fail later.
+        }
+        try {
+            await this.device.claimInterface(this.dataInterface);
+        }
+        catch (e) {
+            throw new Error(`Failed to claim Data Interface. Android OS has locked the device driver. Try using a 'Vendor Specific' USB Class device or a native Serial App workaround.`);
         }
-        this.interfaceNumber = targetInterface.interfaceNumber;
-        await this.device.claimInterface(this.interfaceNumber);
-        // Map endpoints
-        const endpoints = targetInterface.alternate.endpoints;
+        const endpoints = dataIface.alternate.endpoints;
         this.endpointIn = endpoints.find(e => e.direction === 'in' && e.type === 'bulk').endpointNumber;
         this.endpointOut = endpoints.find(e => e.direction === 'out' && e.type === 'bulk').endpointNumber;
         await this.setBaudRate(baudRate);
@@ -57,7 +73,6 @@ export class UsbTransport {
     async write(data) {
         if (!this.device.opened)
             return;
-        // Cast to 'unknown' then 'BufferSource' to satisfy the strict type definition
         await this.device.transferOut(this.endpointOut, data);
     }
     /**
@@ -85,14 +100,13 @@ export class UsbTransport {
     async setSignals({ dtr, rts }) {
         if (!this.device.opened)
             return;
-        // CDC-ACM: DTR is bit 0, RTS is bit 1
         const value = (Number(dtr) | (Number(rts) << 1));
         await this.device.controlTransferOut({
             requestType: 'class',
             recipient: 'interface',
             request: UsbTransport.SET_CONTROL_LINE_STATE,
             value: value,
-            index: this.interfaceNumber
+            index: this.controlInterface
         });
     }
     async setBaudRate(baud) {
@@ -102,20 +116,31 @@ export class UsbTransport {
         // 4 bytes: baud (LE), 1 byte: stop bits, 1 byte: parity, 1 byte: data bits
         const buffer = new ArrayBuffer(7);
         const view = new DataView(buffer);
-        view.setUint32(0, baud, true); // Little Endian
-        view.setUint8(4, 0); // 1 stop bit
-        view.setUint8(5, 0); // No parity
-        view.setUint8(6, 8); // 8 data bits
+        view.setUint32(0, baud, true);
+        view.setUint8(4, 0);
+        view.setUint8(5, 0);
+        view.setUint8(6, 8);
         await this.device.controlTransferOut({
             requestType: 'class',
             recipient: 'interface',
             request: UsbTransport.SET_LINE_CODING,
             value: 0,
-            index: this.interfaceNumber
+            index: this.controlInterface
         }, buffer);
     }
     async disconnect() {
         if (this.device.opened) {
+            // Release both
+            try {
+                await this.device.releaseInterface(this.dataInterface);
+            }
+            catch (e) { }
+            if (this.controlInterface !== this.dataInterface) {
+                try {
+                    await this.device.releaseInterface(this.controlInterface);
+                }
+                catch (e) { }
+            }
             await this.device.close();
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ota-hub-reactjs",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "ReactJS tools for building web apps to flash MCU devices such as esp32, brought to you by OTA Hub.",
   "type": "module",
   "main": "dist/index.js",