@onekeyfe/hd-transport-react-native 1.1.27-alpha.5 → 1.1.27-alpha.6

package/dist/index.d.ts

@@ -1,9 +1,24 @@
 import * as transport from '@onekeyfe/hd-transport';
 import transport__default, { OneKeyDeviceInfoBase } from '@onekeyfe/hd-transport';
-import { Device, BleManager, Characteristic, Subscription } from 'react-native-ble-plx';
+import { Device, Characteristic, Subscription, BleManager } from 'react-native-ble-plx';
 import { Deferred } from '@onekeyfe/hd-shared';
 import EventEmitter from 'events';
 
+declare class BleTransport {
+    id: string;
+    name: string;
+    device: Device;
+    mtuSize: number;
+    writeCharacteristic: Characteristic;
+    notifyCharacteristic: Characteristic;
+    notifySubscription?: Subscription;
+    disconnectSubscription?: Subscription;
+    static MAX_RETRIES: number;
+    static RETRY_DELAY: number;
+    constructor(device: Device, writeCharacteristic: Characteristic, notifyCharacteristic: Characteristic);
+    writeWithRetry(data: string, retryCount?: number): Promise<void>;
+}
+
 type TransportOptions = {
     scanTimeout?: number;
 };
@@ -12,6 +27,10 @@ type BleAcquireInput = {
     forceCleanRunPromise?: boolean;
 };
 
+type ResolvedBleCharacteristics = {
+    writeCharacteristic: Characteristic;
+    notifyCharacteristic: Characteristic;
+};
 type IOneKeyDevice = OneKeyDeviceInfoBase & Device;
 declare class ReactNativeBleTransport {
     blePlxManager: BleManager | undefined;
@@ -22,11 +41,15 @@ declare class ReactNativeBleTransport {
     scanTimeout: number;
     runPromise: Deferred<any> | null;
     emitter?: EventEmitter;
+    firmwareUploadWriteRecoveryIds: Set<string>;
     constructor(options: TransportOptions);
     init(_logger: any, emitter: EventEmitter): void;
     configure(signedData: any): void;
     listen(): void;
     getPlxManager(): Promise<BleManager>;
+    resolveCharacteristics(device: Device): Promise<ResolvedBleCharacteristics>;
+    attachDisconnectSubscription(transport: BleTransport, device: Device, uuid: string): void;
+    reconnectFirmwareUploadTransport(uuid: string, transport: BleTransport): Promise<void>;
     enumerate(): Promise<IOneKeyDevice[]>;
     acquire(input: BleAcquireInput): Promise<{
         uuid: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAIL,UAAU,IAAI,aAAa,EAE5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,SAAS,EAAE,EAGhB,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAgBhC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,YAAY,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAcjE,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG,MAAM,CAAC;AA0C1D,MAAM,CAAC,OAAO,OAAO,uBAAuB;IAC1C,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IAEzC,SAAS,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC;IAEnE,IAAI,SAA6B;IAEjC,UAAU,UAAS;IAEnB,OAAO,UAAS;IAEhB,WAAW,SAAQ;IAEnB,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAQ;IAExC,OAAO,CAAC,EAAE,YAAY,CAAC;gBAEX,OAAO,EAAE,gBAAgB;IAIrC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY;IAIxC,SAAS,CAAC,UAAU,EAAE,GAAG;IAMzB,MAAM;IAIN,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;IAWjC,SAAS;IA6FT,OAAO,CAAC,KAAK,EAAE,eAAe;;;IAiNpC,sBAAsB,CAAC,cAAc,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY;IA+E5E,OAAO,CAAC,IAAI,EAAE,MAAM;IA4BpB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA2HpE,IAAI;IAIE,UAAU,CAAC,OAAO,EAAE,MAAM;IA0EhC,MAAM;CAOP"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAIL,UAAU,IAAI,aAAa,EAE5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,SAAS,EAAE,EAGhB,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAahC,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAG1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,YAAY,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAkBjE,KAAK,0BAA0B,GAAG;IAChC,mBAAmB,EAAE,cAAc,CAAC;IACpC,oBAAoB,EAAE,cAAc,CAAC;CACtC,CAAC;AA+CF,MAAM,MAAM,aAAa,GAAG,oBAAoB,GAAG,MAAM,CAAC;AA0C1D,MAAM,CAAC,OAAO,OAAO,uBAAuB;IAC1C,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IAEzC,SAAS,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC;IAEnE,IAAI,SAA6B;IAEjC,UAAU,UAAS;IAEnB,OAAO,UAAS;IAEhB,WAAW,SAAQ;IAEnB,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAQ;IAExC,OAAO,CAAC,EAAE,YAAY,CAAC;IAEvB,8BAA8B,cAAqB;gBAEvC,OAAO,EAAE,gBAAgB;IAIrC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY;IAIxC,SAAS,CAAC,UAAU,EAAE,GAAG;IAMzB,MAAM;IAIN,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;IAMjC,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAuEjF,4BAA4B,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IA0B5E,gCAAgC,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY;IA6CtE,SAAS;IA6FT,OAAO,CAAC,KAAK,EAAE,eAAe;;;IAmIpC,sBAAsB,CAAC,cAAc,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY;IAmF5E,OAAO,CAAC,IAAI,EAAE,MAAM;IA4BpB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA6MpE,IAAI;IAIE,UAAU,CAAC,OAAO,EAAE,MAAM;IA0EhC,MAAM;CAOP"}

package/dist/index.js

@@ -214,6 +214,35 @@ BleTransport.RETRY_DELAY = 2000;
 const { check, buildBuffers, receiveOne, parseConfigure } = transport__default["default"];
 const Log = hdCore.getLogger(hdCore.LoggerNames.HdBleTransport);
 const transportCache = {};
+const FIRMWARE_UPLOAD_WRITE_BURST_SIZE = reactNative.Platform.OS === 'ios' ? 4 : 5;
+const FIRMWARE_UPLOAD_WRITE_PAUSE_MS = reactNative.Platform.OS === 'ios' ? 8 : 10;
+const FIRMWARE_UPLOAD_WRITE_FLUSH_DELAY_MS = reactNative.Platform.OS === 'ios' ? 24 : 30;
+const FIRMWARE_UPLOAD_WRITE_MAX_RETRIES = 8;
+const FIRMWARE_UPLOAD_RECONNECT_RETRY_DELAY_MS = 2000;
+const ANDROID_FIRMWARE_UPLOAD_PACKET_LENGTH = 192;
+const FIRMWARE_UPLOAD_WRITE_PACKET_CAPACITY = reactNative.Platform.OS === 'ios' ? IOS_PACKET_LENGTH : ANDROID_FIRMWARE_UPLOAD_PACKET_LENGTH;
+const ANDROID_GATT_CONGESTED_STATUS = 143;
+const delay = (ms) => new Promise(resolve => {
+    setTimeout(resolve, ms);
+});
+const getFirmwareUploadWriteRetryType = (error) => {
+    if (!error || typeof error !== 'object')
+        return null;
+    const bleWriteError = error;
+    if (bleWriteError.errorCode === reactNativeBlePlx.BleErrorCode.DeviceDisconnected ||
+        bleWriteError.errorCode === reactNativeBlePlx.BleErrorCode.CharacteristicNotFound) {
+        return 'reconnectable';
+    }
+    if (bleWriteError.androidErrorCode === ANDROID_GATT_CONGESTED_STATUS ||
+        bleWriteError.status === ANDROID_GATT_CONGESTED_STATUS) {
+        return 'congested';
+    }
+    const text = [bleWriteError.reason, bleWriteError.message, bleWriteError.name]
+        .filter(value => typeof value === 'string')
+        .join(' ');
+    return /GATT_CONGESTED|status\s*[:=]?\s*143/.test(text) ? 'congested' : null;
+};
+const resolveFirmwareUploadRetryDelay = (attempt, baseDelayMs = 200, maxDelayMs = 1200) => Math.min(baseDelayMs * Math.pow(2, attempt), maxDelayMs);
 let connectOptions = {
     requestMTU: 256,
     timeout: 3000,
@@ -254,6 +283,7 @@ class ReactNativeBleTransport {
         this.stopped = false;
         this.scanTimeout = 3000;
         this.runPromise = null;
+        this.firmwareUploadWriteRecoveryIds = new Set();
         this.scanTimeout = (_a = options.scanTimeout) !== null && _a !== void 0 ? _a : 3000;
     }
     init(_logger, emitter) {
@@ -272,6 +302,134 @@ class ReactNativeBleTransport {
         this.blePlxManager = new reactNativeBlePlx.BleManager();
         return Promise.resolve(this.blePlxManager);
     }
+    resolveCharacteristics(device) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield device.discoverAllServicesAndCharacteristics();
+            let infos = tryToGetConfiguration(device);
+            let characteristics;
+            if (!infos) {
+                for (const serviceUuid of getBluetoothServiceUuids()) {
+                    try {
+                        characteristics = yield device.characteristicsForService(serviceUuid);
+                        infos = getInfosForServiceUuid(serviceUuid, 'classic');
+                        break;
+                    }
+                    catch (e) {
+                        Log === null || Log === void 0 ? void 0 : Log.error(e);
+                    }
+                }
+            }
+            if (!infos) {
+                try {
+                    Log === null || Log === void 0 ? void 0 : Log.debug('cancel connection when service not found');
+                    yield device.cancelConnection();
+                }
+                catch (e) {
+                    Log === null || Log === void 0 ? void 0 : Log.debug('cancel connection error when service not found: ', e.message || e.reason);
+                }
+                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleServiceNotFound);
+            }
+            const { serviceUuid, writeUuid, notifyUuid } = infos;
+            if (!characteristics) {
+                characteristics = yield device.characteristicsForService(serviceUuid);
+            }
+            if (!characteristics) {
+                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleCharacteristicNotFound);
+            }
+            let writeCharacteristic;
+            let notifyCharacteristic;
+            for (const c of characteristics) {
+                if (c.uuid === writeUuid) {
+                    writeCharacteristic = c;
+                }
+                else if (c.uuid === notifyUuid) {
+                    notifyCharacteristic = c;
+                }
+            }
+            if (!writeCharacteristic) {
+                throw hdShared.ERRORS.TypedError('BLECharacteristicNotFound: write characteristic not found');
+            }
+            if (!notifyCharacteristic) {
+                throw hdShared.ERRORS.TypedError('BLECharacteristicNotFound: notify characteristic not found');
+            }
+            if (!writeCharacteristic.isWritableWithResponse) {
+                throw hdShared.ERRORS.TypedError('BLECharacteristicNotWritable: write characteristic not writable');
+            }
+            if (!notifyCharacteristic.isNotifiable) {
+                throw hdShared.ERRORS.TypedError('BLECharacteristicNotNotifiable: notify characteristic not notifiable');
+            }
+            return {
+                writeCharacteristic,
+                notifyCharacteristic,
+            };
+        });
+    }
+    attachDisconnectSubscription(transport, device, uuid) {
+        var _a;
+        (_a = transport.disconnectSubscription) === null || _a === void 0 ? void 0 : _a.remove();
+        transport.disconnectSubscription = device.onDisconnected(() => {
+            var _a;
+            if (this.firmwareUploadWriteRecoveryIds.has(uuid)) {
+                Log === null || Log === void 0 ? void 0 : Log.debug('device disconnect ignored during FirmwareUpload write recovery: ', uuid);
+                return;
+            }
+            try {
+                Log === null || Log === void 0 ? void 0 : Log.debug('device disconnect: ', device === null || device === void 0 ? void 0 : device.id);
+                (_a = this.emitter) === null || _a === void 0 ? void 0 : _a.emit('device-disconnect', {
+                    name: device === null || device === void 0 ? void 0 : device.name,
+                    id: device === null || device === void 0 ? void 0 : device.id,
+                    connectId: device === null || device === void 0 ? void 0 : device.id,
+                });
+                if (this.runPromise) {
+                    this.runPromise.reject(hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleConnectedError));
+                }
+            }
+            catch (e) {
+                Log === null || Log === void 0 ? void 0 : Log.debug('device disconnect error: ', e);
+            }
+            finally {
+                this.release(uuid);
+            }
+        });
+    }
+    reconnectFirmwareUploadTransport(uuid, transport) {
+        var _a, _b;
+        return __awaiter(this, void 0, void 0, function* () {
+            this.firmwareUploadWriteRecoveryIds.add(uuid);
+            try {
+                (_a = transport.disconnectSubscription) === null || _a === void 0 ? void 0 : _a.remove();
+                transport.disconnectSubscription = undefined;
+                (_b = transport.notifySubscription) === null || _b === void 0 ? void 0 : _b.remove();
+                transport.notifySubscription = undefined;
+                let { device } = transport;
+                const isConnected = yield device.isConnected().catch(() => false);
+                if (!isConnected) {
+                    try {
+                        device = yield device.connect(connectOptions);
+                    }
+                    catch (e) {
+                        if (e.errorCode === reactNativeBlePlx.BleErrorCode.DeviceMTUChangeFailed ||
+                            e.errorCode === reactNativeBlePlx.BleErrorCode.OperationCancelled) {
+                            connectOptions = {};
+                            device = yield device.connect();
+                        }
+                        else if (e.errorCode !== reactNativeBlePlx.BleErrorCode.DeviceAlreadyConnected) {
+                            throw e;
+                        }
+                    }
+                }
+                const { writeCharacteristic, notifyCharacteristic } = yield this.resolveCharacteristics(device);
+                transport.device = device;
+                transport.writeCharacteristic = writeCharacteristic;
+                transport.notifyCharacteristic = notifyCharacteristic;
+                transport.notifySubscription = this._monitorCharacteristic(notifyCharacteristic, uuid);
+                this.attachDisconnectSubscription(transport, device, uuid);
+            }
+            finally {
+                this.firmwareUploadWriteRecoveryIds.delete(uuid);
+            }
+        });
+    }
     enumerate() {
         return __awaiter(this, void 0, void 0, function* () {
             return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
@@ -441,60 +599,7 @@ class ReactNativeBleTransport {
                     }
                 }
             }
-            yield device.discoverAllServicesAndCharacteristics();
-            let infos = tryToGetConfiguration(device);
-            let characteristics;
-            if (!infos) {
-                for (const serviceUuid of getBluetoothServiceUuids()) {
-                    try {
-                        characteristics = yield device.characteristicsForService(serviceUuid);
-                        infos = getInfosForServiceUuid(serviceUuid, 'classic');
-                        break;
-                    }
-                    catch (e) {
-                        Log === null || Log === void 0 ? void 0 : Log.error(e);
-                    }
-                }
-            }
-            if (!infos) {
-                try {
-                    Log === null || Log === void 0 ? void 0 : Log.debug('cancel connection when service not found');
-                    yield device.cancelConnection();
-                }
-                catch (e) {
-                    Log === null || Log === void 0 ? void 0 : Log.debug('cancel connection error when service not found: ', e.message || e.reason);
-                }
-                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleServiceNotFound);
-            }
-            const { serviceUuid, writeUuid, notifyUuid } = infos;
-            if (!characteristics) {
-                characteristics = yield device.characteristicsForService(serviceUuid);
-            }
-            if (!characteristics) {
-                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleCharacteristicNotFound);
-            }
-            let writeCharacteristic;
-            let notifyCharacteristic;
-            for (const c of characteristics) {
-                if (c.uuid === writeUuid) {
-                    writeCharacteristic = c;
-                }
-                else if (c.uuid === notifyUuid) {
-                    notifyCharacteristic = c;
-                }
-            }
-            if (!writeCharacteristic) {
-                throw hdShared.ERRORS.TypedError('BLECharacteristicNotFound: write characteristic not found');
-            }
-            if (!notifyCharacteristic) {
-                throw hdShared.ERRORS.TypedError('BLECharacteristicNotFound: notify characteristic not found');
-            }
-            if (!writeCharacteristic.isWritableWithResponse) {
-                throw hdShared.ERRORS.TypedError('BLECharacteristicNotWritable: write characteristic not writable');
-            }
-            if (!notifyCharacteristic.isNotifiable) {
-                throw hdShared.ERRORS.TypedError('BLECharacteristicNotNotifiable: notify characteristic not notifiable');
-            }
+            const { writeCharacteristic, notifyCharacteristic } = yield this.resolveCharacteristics(device);
             yield this.release(uuid);
             const transport = new BleTransport(device, writeCharacteristic, notifyCharacteristic);
             transport.notifySubscription = this._monitorCharacteristic(transport.notifyCharacteristic, uuid);
@@ -504,26 +609,7 @@ class ReactNativeBleTransport {
                 id: device.id,
                 connectId: device.id,
             });
-            transport.disconnectSubscription = device.onDisconnected(() => {
-                var _a;
-                try {
-                    Log === null || Log === void 0 ? void 0 : Log.debug('device disconnect: ', device === null || device === void 0 ? void 0 : device.id);
-                    (_a = this.emitter) === null || _a === void 0 ? void 0 : _a.emit('device-disconnect', {
-                        name: device === null || device === void 0 ? void 0 : device.name,
-                        id: device === null || device === void 0 ? void 0 : device.id,
-                        connectId: device === null || device === void 0 ? void 0 : device.id,
-                    });
-                    if (this.runPromise) {
-                        this.runPromise.reject(hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleConnectedError));
-                    }
-                }
-                catch (e) {
-                    Log === null || Log === void 0 ? void 0 : Log.debug('device disconnect error: ', e);
-                }
-                finally {
-                    this.release(uuid);
-                }
-            });
+            this.attachDisconnectSubscription(transport, device, uuid);
             return { uuid };
         });
     }
@@ -534,6 +620,10 @@ class ReactNativeBleTransport {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
             if (error) {
                 Log === null || Log === void 0 ? void 0 : Log.debug(`error monitor ${characteristic.uuid}, deviceId: ${characteristic.deviceID}: ${error}`);
+                if (this.firmwareUploadWriteRecoveryIds.has(uuid)) {
+                    Log === null || Log === void 0 ? void 0 : Log.debug('notify error ignored during FirmwareUpload write recovery: ', uuid);
+                    return;
+                }
                 if (this.runPromise) {
                     let ERROR = hdShared.HardwareErrorCode.BleCharacteristicNotifyError;
                     if ((_a = error.reason) === null || _a === void 0 ? void 0 : _a.includes('The connection has timed out unexpectedly')) {
@@ -659,6 +749,36 @@ class ReactNativeBleTransport {
                     }
                 });
             }
+            function writeFirmwareUploadChunkedData(buffers, writeFunction, onError) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    let index = 0;
+                    let packetsWritten = 0;
+                    let chunk = ByteBuffer__default["default"].allocate(FIRMWARE_UPLOAD_WRITE_PACKET_CAPACITY);
+                    while (index < buffers.length) {
+                        const buffer = buffers[index].toBuffer();
+                        chunk.append(buffer);
+                        index += 1;
+                        if (chunk.offset === FIRMWARE_UPLOAD_WRITE_PACKET_CAPACITY || index >= buffers.length) {
+                            chunk.reset();
+                            try {
+                                yield writeFunction(chunk.toString('base64'));
+                                packetsWritten += 1;
+                                chunk = ByteBuffer__default["default"].allocate(FIRMWARE_UPLOAD_WRITE_PACKET_CAPACITY);
+                                if (packetsWritten % FIRMWARE_UPLOAD_WRITE_BURST_SIZE === 0 && index < buffers.length) {
+                                    yield delay(FIRMWARE_UPLOAD_WRITE_PAUSE_MS);
+                                }
+                            }
+                            catch (e) {
+                                onError(e);
+                                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.BleWriteCharacteristicError);
+                            }
+                        }
+                    }
+                    if (packetsWritten > 0) {
+                        yield delay(FIRMWARE_UPLOAD_WRITE_FLUSH_DELAY_MS);
+                    }
+                });
+            }
             if (name === 'EmmcFileWrite') {
                 yield writeChunkedData(buffers, data => transport$1.writeWithRetry(data), e => {
                     this.runPromise = null;
@@ -666,8 +786,53 @@ class ReactNativeBleTransport {
                 });
             }
             else if (name === 'FirmwareUpload') {
-                yield writeChunkedData(buffers, (data) => __awaiter(this, void 0, void 0, function* () {
-                    yield transport$1.writeCharacteristic.writeWithoutResponse(data);
+                Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] FirmwareUpload write uses throttled BLE packets:', {
+                    packetCapacity: FIRMWARE_UPLOAD_WRITE_PACKET_CAPACITY,
+                    burstSize: FIRMWARE_UPLOAD_WRITE_BURST_SIZE,
+                    pauseMs: FIRMWARE_UPLOAD_WRITE_PAUSE_MS,
+                    flushDelayMs: FIRMWARE_UPLOAD_WRITE_FLUSH_DELAY_MS,
+                    maxRetries: FIRMWARE_UPLOAD_WRITE_MAX_RETRIES,
+                });
+                yield writeFirmwareUploadChunkedData(buffers, (data) => __awaiter(this, void 0, void 0, function* () {
+                    let attempt = 0;
+                    while (true) {
+                        try {
+                            yield transport$1.writeCharacteristic.writeWithoutResponse(data);
+                            return;
+                        }
+                        catch (error) {
+                            const retryType = getFirmwareUploadWriteRetryType(error);
+                            if (!retryType || attempt >= FIRMWARE_UPLOAD_WRITE_MAX_RETRIES) {
+                                throw error;
+                            }
+                            const shouldReconnect = retryType === 'reconnectable';
+                            const delayMs = shouldReconnect
+                                ? FIRMWARE_UPLOAD_RECONNECT_RETRY_DELAY_MS
+                                : resolveFirmwareUploadRetryDelay(attempt);
+                            Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] FirmwareUpload write retry:', {
+                                attempt: attempt + 1,
+                                delayMs,
+                                reconnect: shouldReconnect,
+                                error,
+                            });
+                            if (shouldReconnect) {
+                                this.firmwareUploadWriteRecoveryIds.add(uuid);
+                            }
+                            yield delay(delayMs);
+                            attempt += 1;
+                            if (shouldReconnect) {
+                                try {
+                                    yield this.reconnectFirmwareUploadTransport(uuid, transport$1);
+                                }
+                                catch (e) {
+                                    Log === null || Log === void 0 ? void 0 : Log.debug('[ReactNativeBleTransport] FirmwareUpload reconnect error:', e);
+                                    if (attempt >= FIRMWARE_UPLOAD_WRITE_MAX_RETRIES) {
+                                        throw e;
+                                    }
+                                }
+                            }
+                        }
+                    }
                 }), e => {
                     this.runPromise = null;
                     Log === null || Log === void 0 ? void 0 : Log.error('writeCharacteristic write error: ', e);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/hd-transport-react-native",
-  "version": "1.1.27-alpha.5",
+  "version": "1.1.27-alpha.6",
   "homepage": "https://github.com/OneKeyHQ/hardware-js-sdk#readme",
   "license": "MIT",
   "main": "dist/index.js",
@@ -19,11 +19,11 @@
     "lint:fix": "eslint . --fix"
   },
   "dependencies": {
-    "@onekeyfe/hd-core": "1.1.27-alpha.5",
-    "@onekeyfe/hd-shared": "1.1.27-alpha.5",
-    "@onekeyfe/hd-transport": "1.1.27-alpha.5",
+    "@onekeyfe/hd-core": "1.1.27-alpha.6",
+    "@onekeyfe/hd-shared": "1.1.27-alpha.6",
+    "@onekeyfe/hd-transport": "1.1.27-alpha.6",
     "@onekeyfe/react-native-ble-utils": "^0.1.4",
     "react-native-ble-plx": "3.5.1"
   },
-  "gitHead": "0c7353e097121596ad4076a531a473408471674c"
+  "gitHead": "a1fb7786313ccee4b1e570c53ae2c05a96f785df"
 }

package/src/index.ts

@@ -38,6 +38,60 @@ const { check, buildBuffers, receiveOne, parseConfigure } = transport;
 const Log = getLogger(LoggerNames.HdBleTransport);
 
 const transportCache: Record<string, BleTransport> = {};
+const FIRMWARE_UPLOAD_WRITE_BURST_SIZE = Platform.OS === 'ios' ? 4 : 5;
+const FIRMWARE_UPLOAD_WRITE_PAUSE_MS = Platform.OS === 'ios' ? 8 : 10;
+const FIRMWARE_UPLOAD_WRITE_FLUSH_DELAY_MS = Platform.OS === 'ios' ? 24 : 30;
+const FIRMWARE_UPLOAD_WRITE_MAX_RETRIES = 8;
+const FIRMWARE_UPLOAD_RECONNECT_RETRY_DELAY_MS = 2000;
+const ANDROID_FIRMWARE_UPLOAD_PACKET_LENGTH = 192;
+const FIRMWARE_UPLOAD_WRITE_PACKET_CAPACITY =
+  Platform.OS === 'ios' ? IOS_PACKET_LENGTH : ANDROID_FIRMWARE_UPLOAD_PACKET_LENGTH;
+const ANDROID_GATT_CONGESTED_STATUS = 143;
+
+type FirmwareUploadWriteRetryType = 'congested' | 'reconnectable';
+type ResolvedBleCharacteristics = {
+  writeCharacteristic: Characteristic;
+  notifyCharacteristic: Characteristic;
+};
+
+const delay = (ms: number) =>
+  new Promise<void>(resolve => {
+    setTimeout(resolve, ms);
+  });
+
+const getFirmwareUploadWriteRetryType = (error: unknown): FirmwareUploadWriteRetryType | null => {
+  if (!error || typeof error !== 'object') return null;
+  const bleWriteError = error as {
+    androidErrorCode?: unknown;
+    status?: unknown;
+    errorCode?: unknown;
+    reason?: unknown;
+    message?: unknown;
+    name?: unknown;
+  };
+
+  if (
+    bleWriteError.errorCode === BleErrorCode.DeviceDisconnected ||
+    bleWriteError.errorCode === BleErrorCode.CharacteristicNotFound
+  ) {
+    return 'reconnectable';
+  }
+
+  if (
+    bleWriteError.androidErrorCode === ANDROID_GATT_CONGESTED_STATUS ||
+    bleWriteError.status === ANDROID_GATT_CONGESTED_STATUS
+  ) {
+    return 'congested';
+  }
+
+  const text = [bleWriteError.reason, bleWriteError.message, bleWriteError.name]
+    .filter(value => typeof value === 'string')
+    .join(' ');
+  return /GATT_CONGESTED|status\s*[:=]?\s*143/.test(text) ? 'congested' : null;
+};
+
+const resolveFirmwareUploadRetryDelay = (attempt: number, baseDelayMs = 200, maxDelayMs = 1200) =>
+  Math.min(baseDelayMs * 2 ** attempt, maxDelayMs);
 
 let connectOptions: Record<string, unknown> = {
   requestMTU: 256,
@@ -104,6 +158,8 @@ export default class ReactNativeBleTransport {
 
   emitter?: EventEmitter;
 
+  firmwareUploadWriteRecoveryIds = new Set<string>();
+
   constructor(options: TransportOptions) {
     this.scanTimeout = options.scanTimeout ?? 3000;
   }
@@ -128,6 +184,143 @@ export default class ReactNativeBleTransport {
     return Promise.resolve(this.blePlxManager);
   }
 
+  async resolveCharacteristics(device: Device): Promise<ResolvedBleCharacteristics> {
+    await device.discoverAllServicesAndCharacteristics();
+    let infos = tryToGetConfiguration(device);
+    let characteristics: Characteristic[] | undefined;
+
+    if (!infos) {
+      for (const serviceUuid of getBluetoothServiceUuids()) {
+        try {
+          characteristics = await device.characteristicsForService(serviceUuid);
+          infos = getInfosForServiceUuid(serviceUuid, 'classic');
+          break;
+        } catch (e) {
+          Log?.error(e);
+        }
+      }
+    }
+
+    if (!infos) {
+      try {
+        Log?.debug('cancel connection when service not found');
+        await device.cancelConnection();
+      } catch (e) {
+        Log?.debug('cancel connection error when service not found: ', e.message || e.reason);
+      }
+      throw ERRORS.TypedError(HardwareErrorCode.BleServiceNotFound);
+    }
+
+    const { serviceUuid, writeUuid, notifyUuid } = infos;
+
+    if (!characteristics) {
+      characteristics = await device.characteristicsForService(serviceUuid);
+    }
+
+    if (!characteristics) {
+      throw ERRORS.TypedError(HardwareErrorCode.BleCharacteristicNotFound);
+    }
+
+    let writeCharacteristic;
+    let notifyCharacteristic;
+    for (const c of characteristics) {
+      if (c.uuid === writeUuid) {
+        writeCharacteristic = c;
+      } else if (c.uuid === notifyUuid) {
+        notifyCharacteristic = c;
+      }
+    }
+
+    if (!writeCharacteristic) {
+      throw ERRORS.TypedError('BLECharacteristicNotFound: write characteristic not found');
+    }
+
+    if (!notifyCharacteristic) {
+      throw ERRORS.TypedError('BLECharacteristicNotFound: notify characteristic not found');
+    }
+
+    if (!writeCharacteristic.isWritableWithResponse) {
+      throw ERRORS.TypedError('BLECharacteristicNotWritable: write characteristic not writable');
+    }
+
+    if (!notifyCharacteristic.isNotifiable) {
+      throw ERRORS.TypedError(
+        'BLECharacteristicNotNotifiable: notify characteristic not notifiable'
+      );
+    }
+
+    return {
+      writeCharacteristic,
+      notifyCharacteristic,
+    };
+  }
+
+  attachDisconnectSubscription(transport: BleTransport, device: Device, uuid: string) {
+    transport.disconnectSubscription?.remove();
+    transport.disconnectSubscription = device.onDisconnected(() => {
+      if (this.firmwareUploadWriteRecoveryIds.has(uuid)) {
+        Log?.debug('device disconnect ignored during FirmwareUpload write recovery: ', uuid);
+        return;
+      }
+
+      try {
+        Log?.debug('device disconnect: ', device?.id);
+        this.emitter?.emit('device-disconnect', {
+          name: device?.name,
+          id: device?.id,
+          connectId: device?.id,
+        });
+        if (this.runPromise) {
+          this.runPromise.reject(ERRORS.TypedError(HardwareErrorCode.BleConnectedError));
+        }
+      } catch (e) {
+        Log?.debug('device disconnect error: ', e);
+      } finally {
+        this.release(uuid);
+      }
+    });
+  }
+
+  async reconnectFirmwareUploadTransport(uuid: string, transport: BleTransport) {
+    this.firmwareUploadWriteRecoveryIds.add(uuid);
+    try {
+      transport.disconnectSubscription?.remove();
+      transport.disconnectSubscription = undefined;
+      transport.notifySubscription?.remove();
+      transport.notifySubscription = undefined;
+
+      let { device } = transport;
+      const isConnected = await device.isConnected().catch(() => false);
+      if (!isConnected) {
+        try {
+          device = await device.connect(connectOptions);
+        } catch (e) {
+          if (
+            e.errorCode === BleErrorCode.DeviceMTUChangeFailed ||
+            e.errorCode === BleErrorCode.OperationCancelled
+          ) {
+            connectOptions = {};
+            device = await device.connect();
+          } else if (e.errorCode !== BleErrorCode.DeviceAlreadyConnected) {
+            throw e;
+          }
+        }
+      }
+
+      const { writeCharacteristic, notifyCharacteristic } = await this.resolveCharacteristics(
+        device
+      );
+
+      transport.device = device;
+      transport.writeCharacteristic = writeCharacteristic;
+      transport.notifyCharacteristic = notifyCharacteristic;
+      transport.notifySubscription = this._monitorCharacteristic(notifyCharacteristic, uuid);
+      this.attachDisconnectSubscription(transport, device, uuid);
+    } finally {
+      this.firmwareUploadWriteRecoveryIds.delete(uuid);
+    }
+  }
+
   /**
    * 获取设备列表
    * 在搜索超过超时时间或设备数量大于 5 台时，返回 OneKey 设备，
@@ -334,69 +527,7 @@ export default class ReactNativeBleTransport {
       }
     }
 
-    await device.discoverAllServicesAndCharacteristics();
-    let infos = tryToGetConfiguration(device);
-    let characteristics;
-
-    if (!infos) {
-      for (const serviceUuid of getBluetoothServiceUuids()) {
-        try {
-          characteristics = await device.characteristicsForService(serviceUuid);
-          infos = getInfosForServiceUuid(serviceUuid, 'classic');
-          break;
-        } catch (e) {
-          Log?.error(e);
-        }
-      }
-    }
-
-    if (!infos) {
-      try {
-        Log?.debug('cancel connection when service not found');
-        await device.cancelConnection();
-      } catch (e) {
-        Log?.debug('cancel connection error when service not found: ', e.message || e.reason);
-      }
-      throw ERRORS.TypedError(HardwareErrorCode.BleServiceNotFound);
-    }
-
-    const { serviceUuid, writeUuid, notifyUuid } = infos;
-
-    if (!characteristics) {
-      characteristics = await device.characteristicsForService(serviceUuid);
-    }
-
-    if (!characteristics) {
-      throw ERRORS.TypedError(HardwareErrorCode.BleCharacteristicNotFound);
-    }
-
-    let writeCharacteristic;
-    let notifyCharacteristic;
-    for (const c of characteristics) {
-      if (c.uuid === writeUuid) {
-        writeCharacteristic = c;
-      } else if (c.uuid === notifyUuid) {
-        notifyCharacteristic = c;
-      }
-    }
-
-    if (!writeCharacteristic) {
-      throw ERRORS.TypedError('BLECharacteristicNotFound: write characteristic not found');
-    }
-
-    if (!notifyCharacteristic) {
-      throw ERRORS.TypedError('BLECharacteristicNotFound: notify characteristic not found');
-    }
-
-    if (!writeCharacteristic.isWritableWithResponse) {
-      throw ERRORS.TypedError('BLECharacteristicNotWritable: write characteristic not writable');
-    }
-
-    if (!notifyCharacteristic.isNotifiable) {
-      throw ERRORS.TypedError(
-        'BLECharacteristicNotNotifiable: notify characteristic not notifiable'
-      );
-    }
+    const { writeCharacteristic, notifyCharacteristic } = await this.resolveCharacteristics(device);
 
     // release transport before new transport instance
     await this.release(uuid);
@@ -414,23 +545,7 @@ export default class ReactNativeBleTransport {
       connectId: device.id,
     });
 
-    transport.disconnectSubscription = device.onDisconnected(() => {
-      try {
-        Log?.debug('device disconnect: ', device?.id);
-        this.emitter?.emit('device-disconnect', {
-          name: device?.name,
-          id: device?.id,
-          connectId: device?.id,
-        });
-        if (this.runPromise) {
-          this.runPromise.reject(ERRORS.TypedError(HardwareErrorCode.BleConnectedError));
-        }
-      } catch (e) {
-        Log?.debug('device disconnect error: ', e);
-      } finally {
-        this.release(uuid);
-      }
-    });
+    this.attachDisconnectSubscription(transport, device, uuid);
 
     return { uuid };
   }
@@ -445,6 +560,10 @@ export default class ReactNativeBleTransport {
             error as unknown as string
           }`
         );
+        if (this.firmwareUploadWriteRecoveryIds.has(uuid)) {
+          Log?.debug('notify error ignored during FirmwareUpload write recovery: ', uuid);
+          return;
+        }
         if (this.runPromise) {
           let ERROR:
             | typeof HardwareErrorCode.BleDeviceBondError
@@ -610,6 +729,41 @@ export default class ReactNativeBleTransport {
       }
     }
 
+    async function writeFirmwareUploadChunkedData(
+      buffers: ByteBuffer[],
+      writeFunction: (data: string) => Promise<void>,
+      onError: (e: any) => void
+    ) {
+      let index = 0;
+      let packetsWritten = 0;
+      let chunk = ByteBuffer.allocate(FIRMWARE_UPLOAD_WRITE_PACKET_CAPACITY);
+
+      while (index < buffers.length) {
+        const buffer = buffers[index].toBuffer();
+        chunk.append(buffer);
+        index += 1;
+
+        if (chunk.offset === FIRMWARE_UPLOAD_WRITE_PACKET_CAPACITY || index >= buffers.length) {
+          chunk.reset();
+          try {
+            await writeFunction(chunk.toString('base64'));
+            packetsWritten += 1;
+            chunk = ByteBuffer.allocate(FIRMWARE_UPLOAD_WRITE_PACKET_CAPACITY);
+            if (packetsWritten % FIRMWARE_UPLOAD_WRITE_BURST_SIZE === 0 && index < buffers.length) {
+              await delay(FIRMWARE_UPLOAD_WRITE_PAUSE_MS);
+            }
+          } catch (e) {
+            onError(e);
+            throw ERRORS.TypedError(HardwareErrorCode.BleWriteCharacteristicError);
+          }
+        }
+      }
+
+      if (packetsWritten > 0) {
+        await delay(FIRMWARE_UPLOAD_WRITE_FLUSH_DELAY_MS);
+      }
+    }
+
     if (name === 'EmmcFileWrite') {
       await writeChunkedData(
         buffers,
@@ -620,10 +774,57 @@ export default class ReactNativeBleTransport {
         }
       );
     } else if (name === 'FirmwareUpload') {
-      await writeChunkedData(
+      Log?.debug('[ReactNativeBleTransport] FirmwareUpload write uses throttled BLE packets:', {
+        packetCapacity: FIRMWARE_UPLOAD_WRITE_PACKET_CAPACITY,
+        burstSize: FIRMWARE_UPLOAD_WRITE_BURST_SIZE,
+        pauseMs: FIRMWARE_UPLOAD_WRITE_PAUSE_MS,
+        flushDelayMs: FIRMWARE_UPLOAD_WRITE_FLUSH_DELAY_MS,
+        maxRetries: FIRMWARE_UPLOAD_WRITE_MAX_RETRIES,
+      });
+
+      await writeFirmwareUploadChunkedData(
         buffers,
         async data => {
-          await transport.writeCharacteristic.writeWithoutResponse(data);
+          let attempt = 0;
+          // Retry only congestion. Other write errors should surface immediately.
+          // GATT_CONGESTED is usually transient backpressure from the Android BLE queue.
+          // eslint-disable-next-line no-constant-condition
+          while (true) {
+            try {
+              await transport.writeCharacteristic.writeWithoutResponse(data);
+              return;
+            } catch (error) {
+              const retryType = getFirmwareUploadWriteRetryType(error);
+              if (!retryType || attempt >= FIRMWARE_UPLOAD_WRITE_MAX_RETRIES) {
+                throw error;
+              }
+              const shouldReconnect = retryType === 'reconnectable';
+              const delayMs = shouldReconnect
+                ? FIRMWARE_UPLOAD_RECONNECT_RETRY_DELAY_MS
+                : resolveFirmwareUploadRetryDelay(attempt);
+              Log?.debug('[ReactNativeBleTransport] FirmwareUpload write retry:', {
+                attempt: attempt + 1,
+                delayMs,
+                reconnect: shouldReconnect,
+                error,
+              });
+              if (shouldReconnect) {
+                this.firmwareUploadWriteRecoveryIds.add(uuid);
+              }
+              await delay(delayMs);
+              attempt += 1;
+              if (shouldReconnect) {
+                try {
+                  await this.reconnectFirmwareUploadTransport(uuid, transport);
+                } catch (e) {
+                  Log?.debug('[ReactNativeBleTransport] FirmwareUpload reconnect error:', e);
+                  if (attempt >= FIRMWARE_UPLOAD_WRITE_MAX_RETRIES) {
+                    throw e;
+                  }
+                }
+              }
+            }
+          }
         },
         e => {
           this.runPromise = null;