@onekeyfe/hd-transport-react-native 1.1.26 → 1.1.27-alpha.30

package/src/index.ts

@@ -9,35 +9,139 @@ import {
 } from 'react-native-ble-plx';
 import ByteBuffer from 'bytebuffer';
 import transport, {
-  COMMON_HEADER_SIZE,
   LogBlockCommand,
   type OneKeyDeviceInfoBase,
+  PROTOCOL_V1_MESSAGE_HEADER_SIZE,
+  PROTOCOL_V2_CHANNEL_BLE_UART,
+  type ProtocolType,
+  ProtocolV2FrameAssembler,
+  ProtocolV2Session,
+  type TransportCallOptions,
+  probeProtocolV2 as probeProtocolV2Helper,
 } from '@onekeyfe/hd-transport';
 import { ERRORS, HardwareErrorCode, createDeferred, isOnekeyDevice } from '@onekeyfe/hd-shared';
-import { LoggerNames, getLogger } from '@onekeyfe/hd-core';
 
 import { getConnectedDeviceIds, onDeviceBondState, pairDevice } from './BleManager';
 import { subscribeBleOn } from './subscribeBleOn';
 import {
   ANDROID_PACKET_LENGTH,
   IOS_PACKET_LENGTH,
+  getBleUuidKey,
   getBluetoothServiceUuids,
   getInfosForServiceUuid,
+  isSameBleUuid,
 } from './constants';
 import { isHeaderChunk } from './utils/validateNotify';
 import BleTransport from './BleTransport';
 import timer from './utils/timer';
+import { bleLogger, setBleLogger } from './logger';
 
 import type { Deferred } from '@onekeyfe/hd-shared';
 import type { Characteristic, Device, Subscription } from 'react-native-ble-plx';
 import type EventEmitter from 'events';
 import type { BleAcquireInput, TransportOptions } from './types';
 
-const { check, buildBuffers, receiveOne, parseConfigure } = transport;
+const { check, ProtocolV1, parseConfigure } = transport;
 
-const Log = getLogger(LoggerNames.HdBleTransport);
+const Log = bleLogger;
 
 const transportCache: Record<string, BleTransport> = {};
+const BLE_RESPONSE_TIMEOUT_MS = 30_000;
+const PROTOCOL_PROBE_TIMEOUT_MS = 1000;
+const PROTOCOL_V2_PROBE_TIMEOUT_MS = 5000;
+const DEVICE_SCAN_TIMEOUT_MS = 8000;
+const IOS_NOTIFY_READY_DELAY_MS = 150;
+const HIGH_VOLUME_WRITE_BURST_SIZE = Platform.OS === 'ios' ? 4 : 6;
+const HIGH_VOLUME_WRITE_PAUSE_MS = Platform.OS === 'ios' ? 6 : 2;
+const HIGH_VOLUME_WRITE_FLUSH_DELAY_MS = Platform.OS === 'ios' ? 20 : 8;
+
+const delay = (ms: number) =>
+  new Promise<void>(resolve => {
+    setTimeout(resolve, ms);
+  });
+
+export type ProtocolV2BleTuning = {
+  iosPacketLength?: number;
+  androidPacketLength?: number;
+  highVolumeWriteBurstSize?: number;
+  highVolumeWritePauseMs?: number;
+  highVolumeWriteFlushDelayMs?: number;
+  highVolumeWriteWithResponse?: boolean;
+};
+
+type ResolvedProtocolV2BleTuning = Required<ProtocolV2BleTuning>;
+
+const DEFAULT_PROTOCOL_V2_BLE_TUNING: ResolvedProtocolV2BleTuning = {
+  iosPacketLength: IOS_PACKET_LENGTH,
+  androidPacketLength: ANDROID_PACKET_LENGTH,
+  highVolumeWriteBurstSize: HIGH_VOLUME_WRITE_BURST_SIZE,
+  highVolumeWritePauseMs: HIGH_VOLUME_WRITE_PAUSE_MS,
+  highVolumeWriteFlushDelayMs: HIGH_VOLUME_WRITE_FLUSH_DELAY_MS,
+  highVolumeWriteWithResponse: false,
+};
+
+let protocolV2BleTuning: ResolvedProtocolV2BleTuning = { ...DEFAULT_PROTOCOL_V2_BLE_TUNING };
+
+const normalizePositiveInteger = (value: unknown, fallback: number) => {
+  const normalized = Number(value);
+  if (!Number.isFinite(normalized) || normalized <= 0) return fallback;
+  return Math.floor(normalized);
+};
+
+export function configureProtocolV2BleTuning(tuning: ProtocolV2BleTuning = {}) {
+  protocolV2BleTuning = {
+    iosPacketLength: normalizePositiveInteger(
+      tuning.iosPacketLength,
+      protocolV2BleTuning.iosPacketLength
+    ),
+    androidPacketLength: normalizePositiveInteger(
+      tuning.androidPacketLength,
+      protocolV2BleTuning.androidPacketLength
+    ),
+    highVolumeWriteBurstSize: normalizePositiveInteger(
+      tuning.highVolumeWriteBurstSize,
+      protocolV2BleTuning.highVolumeWriteBurstSize
+    ),
+    highVolumeWritePauseMs: normalizePositiveInteger(
+      tuning.highVolumeWritePauseMs,
+      protocolV2BleTuning.highVolumeWritePauseMs
+    ),
+    highVolumeWriteFlushDelayMs: normalizePositiveInteger(
+      tuning.highVolumeWriteFlushDelayMs,
+      protocolV2BleTuning.highVolumeWriteFlushDelayMs
+    ),
+    highVolumeWriteWithResponse:
+      tuning.highVolumeWriteWithResponse ?? protocolV2BleTuning.highVolumeWriteWithResponse,
+  };
+  Log?.debug('[ReactNativeBleTransport] Protocol V2 BLE tuning configured:', protocolV2BleTuning);
+}
+
+export function resetProtocolV2BleTuning() {
+  protocolV2BleTuning = { ...DEFAULT_PROTOCOL_V2_BLE_TUNING };
+  Log?.debug('[ReactNativeBleTransport] Protocol V2 BLE tuning reset:', protocolV2BleTuning);
+}
+
+export function getProtocolV2BleTuning() {
+  return { ...protocolV2BleTuning };
+}
+
+function inferProtocolTypeFromDeviceName(name?: string | null): ProtocolType | undefined {
+  return /\bpro\s*2\b/i.test(name ?? '') ? 'V2' : undefined;
+}
+
+function getDeviceDisplayName(device?: Device | null) {
+  return device?.name || device?.localName || null;
+}
+
+function isGenericBleService(uuid?: string | null) {
+  return ['1800', '1801', '180a'].includes(getBleUuidKey(uuid));
+}
+
+function hasKnownOneKeyService(device?: Device | null) {
+  return (device?.serviceUUIDs ?? []).some(serviceUuid =>
+    getInfosForServiceUuid(serviceUuid, 'classic')
+  );
+}
 
 let connectOptions: Record<string, unknown> = {
   requestMTU: 256,
@@ -49,7 +153,8 @@ export type IOneKeyDevice = OneKeyDeviceInfoBase & Device;
 
 const tryToGetConfiguration = (device: Device) => {
   if (!device || !device.serviceUUIDs) return null;
-  const [serviceUUID] = device.serviceUUIDs;
+  const serviceUUID = device.serviceUUIDs.find(uuid => getInfosForServiceUuid(uuid, 'classic'));
+  if (!serviceUUID) return null;
   const infos = getInfosForServiceUuid(serviceUUID, 'classic');
   if (!infos) return null;
   return infos;
@@ -92,23 +197,39 @@ export default class ReactNativeBleTransport {
 
   _messages: ReturnType<typeof transport.parseConfigure> | undefined;
 
+  _messagesV2: ReturnType<typeof transport.parseConfigure> | undefined;
+
   name = 'ReactNativeBleTransport';
 
   configured = false;
 
   stopped = false;
 
-  scanTimeout = 3000;
+  scanTimeout = DEVICE_SCAN_TIMEOUT_MS;
 
   runPromise: Deferred<any> | null = null;
 
   emitter?: EventEmitter;
 
+  /** Per-device protocol type detected by active wire-level probe after connect. */
+  private deviceProtocol: Map<string, ProtocolType> = new Map();
+
+  private protocolV2Assemblers: Map<string, ProtocolV2FrameAssembler> = new Map();
+
+  private protocolV2FrameQueue: Uint8Array[] = [];
+
+  private protocolV2FramePromise: Deferred<Uint8Array> | null = null;
+
+  private monitorTokens: Map<string, number> = new Map();
+
+  private nextMonitorToken = 1;
+
   constructor(options: TransportOptions) {
-    this.scanTimeout = options.scanTimeout ?? 3000;
+    this.scanTimeout = options.scanTimeout ?? DEVICE_SCAN_TIMEOUT_MS;
   }
 
-  init(_logger: any, emitter: EventEmitter) {
+  init(logger: any, emitter: EventEmitter) {
+    setBleLogger(logger);
     this.emitter = emitter;
   }
 
@@ -118,6 +239,11 @@ export default class ReactNativeBleTransport {
     this._messages = messages;
   }
 
+  configureProtocolV2(signedData: any) {
+    this._messagesV2 = parseConfigure(signedData);
+    Log?.debug('[ReactNativeBleTransport] Protocol V2 schema configured');
+  }
+
   listen() {
     // empty
   }
@@ -167,6 +293,7 @@ export default class ReactNativeBleTransport {
       blePlxManager.startDeviceScan(
         null,
         {
+          allowDuplicates: true,
           scanMode: ScanMode.LowLatency,
         },
         (error, device) => {
@@ -194,14 +321,41 @@ export default class ReactNativeBleTransport {
             return;
           }
 
-          if (isOnekeyDevice(device?.name ?? null, device?.id)) {
+          const displayName = getDeviceDisplayName(device);
+          const isOneKey =
+            isOnekeyDevice(device?.name ?? null, device?.id) ||
+            isOnekeyDevice(device?.localName ?? null, device?.id) ||
+            hasKnownOneKeyService(device);
+          const shouldTraceCandidate =
+            !!displayName && /onekey|bixinkey|pro\s*2|pro\b|touch|^k\d|^t\d/i.test(displayName);
+
+          if (shouldTraceCandidate) {
+            Log?.debug('[ReactNativeBleTransport] scan candidate', {
+              name: device?.name,
+              localName: device?.localName,
+              id: device?.id,
+              serviceUUIDs: device?.serviceUUIDs,
+              accepted: isOneKey,
+            });
+          }
+
+          if (isOneKey) {
             Log?.debug('search device start ======================');
-            const { name, localName, id } = device ?? {};
+            const { name, localName, id, serviceUUIDs } = device ?? {};
             Log?.debug(
-              `device name: ${name ?? ''}\nlocalName: ${localName ?? ''}\nid: ${id ?? ''}`
+              `device name: ${name ?? ''}\nlocalName: ${localName ?? ''}\nid: ${
+                id ?? ''
+              }\nserviceUUIDs: ${(serviceUUIDs ?? []).join(',')}`
             );
             addDevice(device as unknown as Device);
             Log?.debug('search device end ======================\n');
+          } else if (displayName && /\bpro\s*2\b/i.test(displayName)) {
+            Log?.debug('[ReactNativeBleTransport] Pro2-like BLE device was not accepted:', {
+              name: device?.name,
+              localName: device?.localName,
+              id: device?.id,
+              serviceUUIDs: device?.serviceUUIDs,
+            });
           }
         }
       );
@@ -215,7 +369,14 @@ export default class ReactNativeBleTransport {
 
       const addDevice = (device: Device) => {
         if (deviceList.every(d => d.id !== device.id)) {
-          deviceList.push({ ...device, commType: 'ble' } as IOneKeyDevice);
+          const displayName = getDeviceDisplayName(device) ?? 'Unknown BLE Device';
+          const protocolType = inferProtocolTypeFromDeviceName(displayName);
+          deviceList.push({
+            ...device,
+            name: displayName,
+            commType: 'ble',
+            ...(protocolType ? { protocolType } : {}),
+          } as IOneKeyDevice);
         }
       };
 
@@ -227,7 +388,7 @@ export default class ReactNativeBleTransport {
   }
 
   async acquire(input: BleAcquireInput) {
-    const { uuid, forceCleanRunPromise } = input;
+    const { uuid, forceCleanRunPromise, expectedProtocol } = input;
 
     if (!uuid) {
       throw ERRORS.TypedError(HardwareErrorCode.BleRequiredUUID);
@@ -245,7 +406,10 @@ export default class ReactNativeBleTransport {
     }
 
     if (forceCleanRunPromise && this.runPromise) {
-      this.runPromise.reject(ERRORS.TypedError(HardwareErrorCode.BleForceCleanRunPromise));
+      const error = ERRORS.TypedError(HardwareErrorCode.BleForceCleanRunPromise);
+      this.runPromise.reject(error);
+      this.rejectProtocolV2Frame(error);
+      this.runPromise = null;
       Log?.debug('Force clean Bluetooth run promise, forceCleanRunPromise: ', forceCleanRunPromise);
     }
 
@@ -307,7 +471,7 @@ export default class ReactNativeBleTransport {
       Log?.debug('not connected, try to connect to device: ', uuid);
 
       try {
-        await device.connect(connectOptions);
+        device = await device.connect(connectOptions);
       } catch (e) {
         Log?.debug('not connected, try to connect to device has error: ', e);
         if (
@@ -317,7 +481,7 @@ export default class ReactNativeBleTransport {
           connectOptions = {};
           Log?.debug('second try to reconnect without params');
           try {
-            await device.connect();
+            device = await device.connect();
           } catch (e) {
             Log?.debug('last try to reconnect error: ', e);
             // last try to reconnect device if this issue exists
@@ -325,7 +489,7 @@ export default class ReactNativeBleTransport {
             if (e.errorCode === BleErrorCode.OperationCancelled) {
               Log?.debug('last try to reconnect');
               await device.cancelConnection();
-              await device.connect();
+              device = await device.connect();
             }
           }
         } else {
@@ -337,6 +501,7 @@ export default class ReactNativeBleTransport {
     await device.discoverAllServicesAndCharacteristics();
     let infos = tryToGetConfiguration(device);
     let characteristics;
+    let fallbackServiceUuid: string | undefined;
 
     if (!infos) {
       for (const serviceUuid of getBluetoothServiceUuids()) {
@@ -351,16 +516,44 @@ export default class ReactNativeBleTransport {
     }
 
     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);
+      const services = await device.services();
+      Log?.debug(
+        '[ReactNativeBleTransport] Known OneKey service UUID not found, discovered services:',
+        services?.map(service => service.uuid)
+      );
+
+      const knownService = services.find(service =>
+        getInfosForServiceUuid(service.uuid, 'classic')
+      );
+      const fallbackService =
+        knownService ?? services.find(service => !isGenericBleService(service.uuid)) ?? services[0];
+
+      if (fallbackService) {
+        fallbackServiceUuid = fallbackService.uuid;
+        characteristics = await device.characteristicsForService(fallbackService.uuid);
+        Log?.debug('[ReactNativeBleTransport] Using fallback BLE service:', fallbackService.uuid);
       }
-      throw ERRORS.TypedError(HardwareErrorCode.BleServiceNotFound);
     }
 
-    const { serviceUuid, writeUuid, notifyUuid } = infos;
+    if (!infos) {
+      if (!fallbackServiceUuid) {
+        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 = infos?.serviceUuid ?? fallbackServiceUuid;
+    const writeUuid = infos?.writeUuid ?? '00000002-0000-1000-8000-00805f9b34fb';
+    const notifyUuid = infos?.notifyUuid ?? '00000003-0000-1000-8000-00805f9b34fb';
+
+    if (!serviceUuid) {
+      throw ERRORS.TypedError(HardwareErrorCode.BleServiceNotFound);
+    }
 
     if (!characteristics) {
       characteristics = await device.characteristicsForService(serviceUuid);
@@ -373,9 +566,9 @@ export default class ReactNativeBleTransport {
     let writeCharacteristic;
     let notifyCharacteristic;
     for (const c of characteristics) {
-      if (c.uuid === writeUuid) {
+      if (isSameBleUuid(c.uuid, writeUuid)) {
         writeCharacteristic = c;
-      } else if (c.uuid === notifyUuid) {
+      } else if (isSameBleUuid(c.uuid, notifyUuid)) {
         notifyCharacteristic = c;
       }
     }
@@ -402,12 +595,30 @@ export default class ReactNativeBleTransport {
     await this.release(uuid);
 
     const transport = new BleTransport(device, writeCharacteristic, notifyCharacteristic);
+    const monitorToken = this.nextMonitorToken;
+    this.nextMonitorToken += 1;
+    const notifyTransactionId = `${uuid}:notify:${monitorToken}`;
+    transport.monitorToken = monitorToken;
+    transport.notifyTransactionId = notifyTransactionId;
+    this.monitorTokens.set(uuid, monitorToken);
     transport.notifySubscription = this._monitorCharacteristic(
       transport.notifyCharacteristic,
-      uuid
+      uuid,
+      monitorToken,
+      notifyTransactionId
     );
     transportCache[uuid] = transport;
 
+    this.protocolV2Assemblers.set(uuid, new ProtocolV2FrameAssembler());
+
+    if (Platform.OS === 'ios') {
+      await new Promise<void>(resolve => {
+        setTimeout(resolve, IOS_NOTIFY_READY_DELAY_MS);
+      });
+    }
+
+    const protocolType = await this.detectProtocol(uuid, expectedProtocol);
+
     this.emitter?.emit('device-connect', {
       name: device.name,
       id: device.id,
@@ -415,6 +626,11 @@ export default class ReactNativeBleTransport {
     });
 
     transport.disconnectSubscription = device.onDisconnected(() => {
+      if (transportCache[uuid] !== transport) {
+        Log?.debug('device disconnect ignored for stale transport: ', device?.id);
+        return;
+      }
+
       try {
         Log?.debug('device disconnect: ', device?.id);
         this.emitter?.emit('device-disconnect', {
@@ -423,7 +639,9 @@ export default class ReactNativeBleTransport {
           connectId: device?.id,
         });
         if (this.runPromise) {
-          this.runPromise.reject(ERRORS.TypedError(HardwareErrorCode.BleConnectedError));
+          const error = ERRORS.TypedError(HardwareErrorCode.BleConnectedError);
+          this.runPromise.reject(error);
+          this.rejectProtocolV2Frame(error);
         }
       } catch (e) {
         Log?.debug('device disconnect error: ', e);
@@ -432,19 +650,29 @@ export default class ReactNativeBleTransport {
       }
     });
 
-    return { uuid };
+    return { uuid, protocolType };
   }
 
-  _monitorCharacteristic(characteristic: Characteristic, uuid: string): Subscription {
+  _monitorCharacteristic(
+    characteristic: Characteristic,
+    uuid: string,
+    monitorToken: number,
+    notifyTransactionId: string
+  ): Subscription {
     let bufferLength = 0;
     let buffer: any[] = [];
     const subscription = characteristic.monitor((error, c) => {
+      const isCurrentMonitor = this.monitorTokens.get(uuid) === monitorToken;
       if (error) {
         Log?.debug(
           `error monitor ${characteristic.uuid}, deviceId: ${characteristic.deviceID}: ${
             error as unknown as string
           }`
         );
+        if (!isCurrentMonitor) {
+          Log?.debug('monitor error ignored for stale transport: ', uuid, notifyTransactionId);
+          return;
+        }
         if (this.runPromise) {
           let ERROR:
             | typeof HardwareErrorCode.BleDeviceBondError
@@ -464,27 +692,40 @@ export default class ReactNativeBleTransport {
             error.reason?.includes('Writing is not permitted') || // pro firmware 2.3.4 upgrade
             error.reason?.includes('notify change failed for device')
           ) {
-            this.runPromise.reject(
-              ERRORS.TypedError(HardwareErrorCode.BleCharacteristicNotifyChangeFailure)
+            const notifyError = ERRORS.TypedError(
+              HardwareErrorCode.BleCharacteristicNotifyChangeFailure
             );
+            this.runPromise.reject(notifyError);
+            this.rejectProtocolV2Frame(notifyError);
             Log?.debug(
               `${HardwareErrorCode.BleCharacteristicNotifyChangeFailure} ${error.message}    ${error.reason}`
             );
             return;
           }
-          this.runPromise.reject(ERRORS.TypedError(ERROR));
+          const notifyError = ERRORS.TypedError(ERROR);
+          this.runPromise.reject(notifyError);
+          this.rejectProtocolV2Frame(notifyError);
           Log?.debug(': monitor notify error, and has unreleased Promise', Error);
         }
 
         return;
       }
 
+      if (!isCurrentMonitor) {
+        Log?.debug('monitor data ignored for stale transport: ', uuid, notifyTransactionId);
+        return;
+      }
+
       if (!c) {
         throw ERRORS.TypedError(HardwareErrorCode.BleMonitorError);
       }
 
       try {
         const data = Buffer.from(c.value as string, 'base64');
+        if (this.deviceProtocol.get(uuid) === 'V2') {
+          this.handleProtocolV2Notification(uuid, new Uint8Array(data));
+          return;
+        }
         // console.log('[hd-transport-react-native] Received a packet, ', 'buffer: ', data);
         if (isHeaderChunk(data)) {
           bufferLength = data.readInt32BE(5);
@@ -493,7 +734,7 @@ export default class ReactNativeBleTransport {
           buffer = buffer.concat([...data]);
         }
 
-        if (buffer.length - COMMON_HEADER_SIZE >= bufferLength) {
+        if (buffer.length - PROTOCOL_V1_MESSAGE_HEADER_SIZE >= bufferLength) {
           const value = Buffer.from(buffer);
           // console.log(
           //   '[hd-transport-react-native] Received a complete packet of data, resolve Promise, this.runPromise: ',
@@ -507,17 +748,31 @@ export default class ReactNativeBleTransport {
         }
       } catch (error) {
         Log?.debug('monitor data error: ', error);
-        this.runPromise?.reject(ERRORS.TypedError(HardwareErrorCode.BleWriteCharacteristicError));
+        const notifyError = ERRORS.TypedError(HardwareErrorCode.BleWriteCharacteristicError);
+        this.runPromise?.reject(notifyError);
+        this.rejectProtocolV2Frame(notifyError);
       }
-    }, uuid);
+    }, notifyTransactionId);
 
     return subscription;
   }
 
   async release(uuid: string) {
     const transport = transportCache[uuid];
+    if (this.runPromise) {
+      const error = ERRORS.TypedError(HardwareErrorCode.BleForceCleanRunPromise);
+      this.runPromise.reject(error);
+      this.runPromise = null;
+      this.rejectProtocolV2Frame(error);
+    } else {
+      this.resetProtocolV2Frames();
+    }
 
     if (transport) {
+      if (this.monitorTokens.get(uuid) === transport.monitorToken) {
+        this.monitorTokens.delete(uuid);
+      }
+
       // Clean up disconnect subscription first to prevent callbacks on released transport
       Log?.debug('release: removing disconnect subscription for device: ', uuid);
       transport.disconnectSubscription?.remove();
@@ -531,12 +786,25 @@ export default class ReactNativeBleTransport {
       transport.notifySubscription?.remove();
       transport.notifySubscription = undefined;
 
+      if (transport.notifyTransactionId) {
+        try {
+          await this.blePlxManager?.cancelTransaction(transport.notifyTransactionId);
+        } catch (e) {
+          Log?.debug('release: cancel notify transaction error (ignored): ', e?.message || e);
+        }
+      }
+
       delete transportCache[uuid];
+      this.deviceProtocol.delete(uuid);
+    }
 
-      // Temporary close the Android disconnect after each request
-      if (Platform.OS === 'android') {
-        // await this.blePlxManager?.cancelDeviceConnection(uuid);
-      }
+    this.protocolV2Assemblers.get(uuid)?.reset();
+    this.protocolV2Assemblers.delete(uuid);
+
+    try {
+      await this.blePlxManager?.cancelTransaction(uuid);
+    } catch (e) {
+      Log?.debug('release: cancel transaction error (ignored): ', e?.message || e);
     }
 
     return Promise.resolve(true);
@@ -546,7 +814,12 @@ export default class ReactNativeBleTransport {
     await this.call(session, name, data);
   }
 
-  async call(uuid: string, name: string, data: Record<string, unknown>) {
+  async call(
+    uuid: string,
+    name: string,
+    data: Record<string, unknown>,
+    options?: TransportCallOptions
+  ) {
     if (this.stopped) {
       // eslint-disable-next-line prefer-promise-reject-errors
       return Promise.reject(ERRORS.TypedError('Transport stopped.'));
@@ -562,13 +835,7 @@ export default class ReactNativeBleTransport {
       throw ERRORS.TypedError(HardwareErrorCode.TransportCallInProgress);
     }
 
-    const transport = transportCache[uuid];
-    if (!transport) {
-      throw ERRORS.TypedError(HardwareErrorCode.TransportNotFound);
-    }
-
-    this.runPromise = createDeferred();
-    const messages = this._messages;
+    const protocol = this.getProtocolType(uuid);
     // Upload resources on low-end phones may OOM
     if (name === 'ResourceUpdate' || name === 'ResourceAck') {
       Log?.debug('transport-react-native', 'call-', ' name: ', name, ' data: ', {
@@ -576,12 +843,44 @@ export default class ReactNativeBleTransport {
         hash: data?.hash,
       });
     } else if (LogBlockCommand.has(name)) {
-      Log?.debug('transport-react-native', 'call-', ' name: ', name);
+      Log?.debug('transport-react-native', 'call-', ' name: ', name, ' protocol: ', protocol);
     } else {
-      Log?.debug('transport-react-native', 'call-', ' name: ', name, ' data: ', data);
+      Log?.debug(
+        'transport-react-native',
+        'call-',
+        ' name: ',
+        name,
+        ' data: ',
+        data,
+        ' protocol: ',
+        protocol
+      );
     }
 
-    const buffers = buildBuffers(messages, name, data);
+    if (protocol === 'V2') {
+      return this.callProtocolV2(uuid, name, data, options);
+    }
+
+    return this.callProtocolV1(uuid, name, data, options);
+  }
+
+  private async callProtocolV1(
+    uuid: string,
+    name: string,
+    data: Record<string, unknown>,
+    options?: TransportCallOptions
+  ) {
+    if (!this._messages) {
+      throw ERRORS.TypedError(HardwareErrorCode.TransportNotConfigured);
+    }
+
+    const transport = this.getCachedTransport(uuid);
+    const runPromise = createDeferred<string>();
+    runPromise.promise.catch(() => undefined);
+    this.runPromise = runPromise;
+    const messages = this._messages;
+    const buffers = ProtocolV1.encodeTransportPackets(messages, name, data);
+    let timeout: ReturnType<typeof setTimeout> | undefined;
 
     async function writeChunkedData(
       buffers: ByteBuffer[],
@@ -652,20 +951,41 @@ export default class ReactNativeBleTransport {
     }
 
     try {
-      const response = await this.runPromise.promise;
+      const response = await Promise.race([
+        runPromise.promise,
+        new Promise<never>((_, reject) => {
+          if (options?.timeoutMs) {
+            timeout = setTimeout(() => {
+              const error = ERRORS.TypedError(
+                HardwareErrorCode.BleTimeoutError,
+                `BLE response timeout after ${options.timeoutMs}ms for ${name}`
+              );
+              runPromise.reject(error);
+              reject(error);
+            }, options.timeoutMs);
+          }
+        }),
+      ]);
 
       if (typeof response !== 'string') {
         throw new Error('Returning data is not string.');
       }
 
       Log?.debug('receive data: ', response);
-      const jsonData = receiveOne(messages, response);
+      const jsonData = ProtocolV1.decodeMessage(messages, response);
       return check.call(jsonData);
     } catch (e) {
-      Log?.error('call error: ', e);
+      if (name === 'Initialize' && options?.timeoutMs === PROTOCOL_PROBE_TIMEOUT_MS) {
+        Log?.debug('[ReactNativeBleTransport] Protocol V1 Initialize probe call failed:', e);
+      } else {
+        Log?.error('call error: ', e);
+      }
       throw e;
     } finally {
-      this.runPromise = null;
+      if (timeout) clearTimeout(timeout);
+      if (this.runPromise === runPromise) {
+        this.runPromise = null;
+      }
     }
   }
 
@@ -732,6 +1052,8 @@ export default class ReactNativeBleTransport {
     if (transportCache[session]) {
       delete transportCache[session];
     }
+    this.deviceProtocol.delete(session);
+    this.protocolV2Assemblers.delete(session);
 
     // emit the disconnect event
     try {
@@ -754,4 +1076,306 @@ export default class ReactNativeBleTransport {
     }
     this.runPromise = null;
   }
+
+  private getCachedTransport(uuid: string) {
+    const transport = transportCache[uuid];
+    if (!transport) {
+      throw ERRORS.TypedError(HardwareErrorCode.TransportNotFound);
+    }
+    return transport;
+  }
+
+  private createProtocolMismatchError(expected: ProtocolType) {
+    return ERRORS.TypedError(
+      HardwareErrorCode.RuntimeError,
+      `Device protocol mismatch: expected ${expected}, but device did not respond to expected protocol`
+    );
+  }
+
+  private async detectProtocol(
+    uuid: string,
+    expectedProtocol?: ProtocolType
+  ): Promise<ProtocolType> {
+    if (expectedProtocol === 'V1') {
+      if (await this.probeProtocolV1(uuid)) {
+        this.deviceProtocol.set(uuid, 'V1');
+        Log?.debug(`[ReactNativeBleTransport] detectProtocol: uuid=${uuid} -> V1 (expected)`);
+        return 'V1';
+      }
+      throw this.createProtocolMismatchError(expectedProtocol);
+    }
+
+    if (expectedProtocol === 'V2') {
+      if (await this.probeProtocolV2(uuid)) {
+        this.deviceProtocol.set(uuid, 'V2');
+        Log?.debug(`[ReactNativeBleTransport] detectProtocol: uuid=${uuid} -> V2 (expected)`);
+        return 'V2';
+      }
+      throw this.createProtocolMismatchError(expectedProtocol);
+    }
+
+    if (this.deviceProtocol.get(uuid) === 'V2' && (await this.probeProtocolV2(uuid))) {
+      this.deviceProtocol.set(uuid, 'V2');
+      Log?.debug(`[ReactNativeBleTransport] detectProtocol: uuid=${uuid} -> V2 (cached)`);
+      return 'V2';
+    }
+
+    let protocol: ProtocolType = 'V1';
+    if (!(await this.probeProtocolV1(uuid)) && (await this.probeProtocolV2(uuid))) {
+      protocol = 'V2';
+    }
+    this.deviceProtocol.set(uuid, protocol);
+    Log?.debug(`[ReactNativeBleTransport] detectProtocol: uuid=${uuid} -> ${protocol}`);
+    return protocol;
+  }
+
+  private async probeProtocolV1(uuid: string) {
+    if (!this._messages) {
+      return false;
+    }
+
+    try {
+      this.deviceProtocol.set(uuid, 'V1');
+      await this.callProtocolV1(uuid, 'Initialize', {}, { timeoutMs: PROTOCOL_PROBE_TIMEOUT_MS });
+      return true;
+    } catch (error) {
+      Log?.debug('[ReactNativeBleTransport] Protocol V1 Initialize probe failed:', error);
+      return false;
+    }
+  }
+
+  private async probeProtocolV2(uuid: string) {
+    if (!this._messages || !this._messagesV2) {
+      return false;
+    }
+
+    this.deviceProtocol.set(uuid, 'V2');
+    this.protocolV2Assemblers.get(uuid)?.reset();
+    return probeProtocolV2Helper({
+      call: (name: string, data: Record<string, unknown>, options?: TransportCallOptions) =>
+        this.callProtocolV2(uuid, name, data, options),
+      timeoutMs: PROTOCOL_V2_PROBE_TIMEOUT_MS,
+      logger: Log,
+      logPrefix: 'ProtocolV2 RN-BLE',
+      onProbeFailed: () => {
+        this.protocolV2Assemblers.get(uuid)?.reset();
+        this.resetProtocolV2Frames();
+      },
+    });
+  }
+
+  private handleProtocolV2Notification(uuid: string, data: Uint8Array) {
+    try {
+      if (!this.runPromise) {
+        this.protocolV2Assemblers.get(uuid)?.reset();
+        this.resetProtocolV2Frames();
+        return;
+      }
+
+      if (data.length === 0) return;
+
+      const assembler = this.protocolV2Assemblers.get(uuid);
+      if (!assembler) return;
+
+      let frameData = assembler.push(data);
+      while (frameData) {
+        this.resolveProtocolV2Frame(frameData);
+        frameData = assembler.push(new Uint8Array(0));
+      }
+    } catch (error) {
+      Log?.debug('[ReactNativeBleTransport] Protocol V2 notification error:', error);
+      const notifyError = ERRORS.TypedError(HardwareErrorCode.BleWriteCharacteristicError);
+      this.runPromise?.reject(notifyError);
+      this.rejectProtocolV2Frame(notifyError);
+    }
+  }
+
+  private resolveProtocolV2Frame(frame: Uint8Array) {
+    if (this.protocolV2FramePromise) {
+      this.protocolV2FramePromise.resolve(frame);
+      this.protocolV2FramePromise = null;
+      return;
+    }
+    this.protocolV2FrameQueue.push(frame);
+  }
+
+  private rejectProtocolV2Frame(error: Error) {
+    this.protocolV2FrameQueue = [];
+    if (this.protocolV2FramePromise) {
+      this.protocolV2FramePromise.reject(error);
+      this.protocolV2FramePromise = null;
+    }
+  }
+
+  private resetProtocolV2Frames() {
+    this.protocolV2FrameQueue = [];
+    this.protocolV2FramePromise = null;
+  }
+
+  private async readProtocolV2Frame() {
+    const queuedFrame = this.protocolV2FrameQueue.shift();
+    if (queuedFrame) {
+      return queuedFrame;
+    }
+
+    const framePromise = createDeferred<Uint8Array>();
+    this.protocolV2FramePromise = framePromise;
+    try {
+      return await framePromise.promise;
+    } finally {
+      if (this.protocolV2FramePromise === framePromise) {
+        this.protocolV2FramePromise = null;
+      }
+    }
+  }
+
+  private async writeProtocolV2Frame(
+    transport: BleTransport,
+    frame: Uint8Array,
+    options?: { highVolume?: boolean; writeWithResponse?: boolean }
+  ) {
+    const tuning = getProtocolV2BleTuning();
+    const packetCapacity =
+      Platform.OS === 'ios' ? tuning.iosPacketLength : tuning.androidPacketLength;
+    const writeWithResponse =
+      !!options?.writeWithResponse || (!!options?.highVolume && tuning.highVolumeWriteWithResponse);
+    const shouldThrottle = !!options?.highVolume && !writeWithResponse;
+    let packetsWritten = 0;
+
+    try {
+      for (let offset = 0; offset < frame.length; offset += packetCapacity) {
+        const chunk = frame.slice(offset, offset + packetCapacity);
+        const base64 = Buffer.from(chunk).toString('base64');
+        if (writeWithResponse) {
+          await transport.writeCharacteristic.writeWithResponse(base64);
+        } else {
+          await transport.writeCharacteristic.writeWithoutResponse(base64);
+        }
+        packetsWritten += 1;
+
+        if (
+          shouldThrottle &&
+          packetsWritten % tuning.highVolumeWriteBurstSize === 0 &&
+          offset + packetCapacity < frame.length
+        ) {
+          await delay(tuning.highVolumeWritePauseMs);
+        }
+      }
+
+      if (shouldThrottle) {
+        await delay(tuning.highVolumeWriteFlushDelayMs);
+      }
+    } catch (error) {
+      if (options?.highVolume && !writeWithResponse && packetsWritten === 0) {
+        Log?.debug(
+          '[ReactNativeBleTransport] Protocol V2 high-volume writeWithoutResponse failed before data was sent, fallback to writeWithResponse:',
+          error
+        );
+        await this.writeProtocolV2Frame(transport, frame, {
+          highVolume: true,
+          writeWithResponse: true,
+        });
+        return;
+      }
+      throw error;
+    }
+  }
+
+  private async callProtocolV2(
+    uuid: string,
+    name: string,
+    data: Record<string, unknown>,
+    options?: TransportCallOptions
+  ) {
+    if (!this._messages || !this._messagesV2) {
+      throw ERRORS.TypedError(HardwareErrorCode.TransportNotConfigured);
+    }
+
+    const forceRun = name === 'Initialize' || name === 'Cancel' || name === 'GetProtoVersion';
+    if (this.runPromise) {
+      if (!forceRun) {
+        throw ERRORS.TypedError(HardwareErrorCode.TransportCallInProgress);
+      }
+      const error = ERRORS.TypedError(HardwareErrorCode.BleForceCleanRunPromise);
+      this.runPromise.reject(error);
+      this.rejectProtocolV2Frame(error);
+      this.runPromise = null;
+    }
+
+    const transport = this.getCachedTransport(uuid);
+    const runPromise = createDeferred<Uint8Array>();
+    runPromise.promise.catch(() => undefined);
+    this.runPromise = runPromise;
+    this.protocolV2Assemblers.get(uuid)?.reset();
+    this.resetProtocolV2Frames();
+    let completed = false;
+    const callOptions = {
+      ...options,
+      timeoutMs: options?.timeoutMs ?? BLE_RESPONSE_TIMEOUT_MS,
+    };
+    const highVolumeWrite = LogBlockCommand.has(name);
+
+    if (highVolumeWrite) {
+      const tuning = getProtocolV2BleTuning();
+      Log?.debug(
+        '[ReactNativeBleTransport] Protocol V2 high-volume write uses throttled writeWithoutResponse:',
+        name,
+        {
+          packetCapacity:
+            Platform.OS === 'ios' ? tuning.iosPacketLength : tuning.androidPacketLength,
+          burstSize: tuning.highVolumeWriteBurstSize,
+          pauseMs: tuning.highVolumeWritePauseMs,
+          flushDelayMs: tuning.highVolumeWriteFlushDelayMs,
+          writeWithResponse: tuning.highVolumeWriteWithResponse,
+        }
+      );
+    }
+
+    try {
+      const session = new ProtocolV2Session({
+        schemas: {
+          protocolV1: this._messages,
+          protocolV2: this._messagesV2,
+        },
+        router: PROTOCOL_V2_CHANNEL_BLE_UART,
+        writeFrame: (frame: Uint8Array) =>
+          this.writeProtocolV2Frame(transport, frame, { highVolume: highVolumeWrite }),
+        readFrame: async () => {
+          const rxFrame = await this.readProtocolV2Frame();
+          if (!(rxFrame instanceof Uint8Array)) {
+            throw new Error('Protocol V2 response is not Uint8Array');
+          }
+          return rxFrame;
+        },
+        logger: Log,
+        logPrefix: 'ProtocolV2 RN-BLE',
+        createTimeoutError: (_messageName: string, timeout: number) =>
+          ERRORS.TypedError(
+            HardwareErrorCode.BleTimeoutError,
+            `BLE response timeout after ${timeout}ms for ${name}`
+          ),
+      });
+
+      const result = await session.call(name, data, callOptions);
+      completed = true;
+      return result;
+    } catch (e) {
+      this.protocolV2Assemblers.get(uuid)?.reset();
+      this.resetProtocolV2Frames();
+      Log?.error('[ReactNativeBleTransport] Protocol V2 call error:', e);
+      throw e;
+    } finally {
+      if (!completed) {
+        this.protocolV2Assemblers.get(uuid)?.reset();
+      }
+      this.resetProtocolV2Frames();
+      if (this.runPromise === runPromise) {
+        this.runPromise = null;
+      }
+    }
+  }
+
+  getProtocolType(path: string): ProtocolType {
+    return this.deviceProtocol.get(path) ?? 'V1';
+  }
 }