@onekeyfe/hd-core 1.2.0-alpha.80 → 1.2.0-alpha.82

package/__tests__/check-firmware-release-protocol-v2.test.ts

@@ -162,3 +162,33 @@ describe.each(['pro2', 'neo'] as const)('Protocol V2 release checks for %s', dev
     expect(allMethod.getSupportedProtocols()).toEqual(['V1', 'V2']);
   });
 });
+
+test('returns null from optional release probes when device features are unavailable', async () => {
+  const deviceWithoutFeatures = {
+    isProtocolV2: jest.fn(() => true),
+    features: undefined,
+    getDeviceState: jest.fn(),
+  };
+  const firmwareMethod = new CheckFirmwareRelease({
+    id: 1,
+    payload: { method: 'checkFirmwareRelease' },
+  });
+  const bleMethod = new CheckBLEFirmwareRelease({
+    id: 2,
+    payload: { method: 'checkBLEFirmwareRelease' },
+  });
+  const bootloaderMethod = new CheckBootloaderRelease({
+    id: 3,
+    payload: { method: 'checkBootloaderRelease' },
+  });
+
+  firmwareMethod.device = deviceWithoutFeatures as unknown as CheckFirmwareRelease['device'];
+  bleMethod.device = deviceWithoutFeatures as unknown as CheckBLEFirmwareRelease['device'];
+  bootloaderMethod.device = deviceWithoutFeatures as unknown as CheckBootloaderRelease['device'];
+
+  await expect(firmwareMethod.run()).resolves.toBeNull();
+  await expect(bleMethod.run()).resolves.toBeNull();
+  await expect(bootloaderMethod.run()).resolves.toBeNull();
+  expect(deviceWithoutFeatures.isProtocolV2).not.toHaveBeenCalled();
+  expect(deviceWithoutFeatures.getDeviceState).not.toHaveBeenCalled();
+});

package/__tests__/protocol-v2.test.ts

@@ -5860,6 +5860,80 @@ describe('Protocol V2 firmware update targets', () => {
     getFirmwareLatestReleaseSpy.mockRestore();
   });
 
+  test('downloads only firmware targets that are missing from an explicit mixed payload', async () => {
+    const explicitApplicationBinary = new Uint8Array([1]).buffer;
+    const remoteCoprocessorBinary = new Uint8Array([2]).buffer;
+    const method = new FirmwareUpdateV4({
+      id: 1,
+      payload: {
+        method: 'firmwareUpdateV4',
+        platform: 'web',
+        targetsToUpdate: ['app_v1', 'coprocessor'],
+      },
+    });
+    method.init();
+
+    const getSysResourceBinarySpy = jest
+      .spyOn(firmwareBinaryApi, 'getSysResourceBinary')
+      .mockResolvedValue({ binary: remoteCoprocessorBinary });
+    const getFirmwareLatestReleaseSpy = jest
+      .spyOn(DataManager, 'getFirmwareLatestRelease')
+      .mockReturnValue({
+        required: false,
+        version: [1, 0, 0],
+        url: 'https://example.com/applicationP1.pp.bin',
+        installOrder: ['applicationP1', 'coprocessor'],
+        components: {
+          applicationP1: {
+            target: 'APPLICATION_P1',
+            url: 'https://example.com/applicationP1.pp.bin',
+          },
+          coprocessor: {
+            target: 'COPROCESSOR',
+            url: 'https://example.com/coprocessor.pp.bin',
+          },
+        },
+        fingerprint: '',
+        changelog: {
+          'zh-CN': '',
+          'en-US': '',
+        },
+      });
+
+    const remoteBinaries = await (method as any).prepareRemoteProtocolV2Binaries(
+      'universal',
+      { deviceType: 'pro2', firmwareVersion: '0.0.0' },
+      [
+        {
+          fileName: 'application_p1.bin',
+          binary: explicitApplicationBinary,
+          targetId: 4,
+          kind: 'firmware',
+        },
+      ]
+    );
+
+    expect(getSysResourceBinarySpy).toHaveBeenCalledTimes(1);
+    expect(getSysResourceBinarySpy).toHaveBeenCalledWith('https://example.com/coprocessor.pp.bin');
+    expect(remoteBinaries.installItems).toEqual([
+      {
+        fileName: 'application_p1.bin',
+        binary: explicitApplicationBinary,
+        targetId: 4,
+        kind: 'firmware',
+      },
+      {
+        fileName: 'coprocessor.bin',
+        binary: remoteCoprocessorBinary,
+        targetId: 6,
+        kind: 'firmware',
+      },
+    ]);
+
+    getSysResourceBinarySpy.mockRestore();
+    getFirmwareLatestReleaseSpy.mockRestore();
+  });
+
   test('ignores an unsupported remote ROMLOADER component when installing selected targets', async () => {
     const method = new FirmwareUpdateV4({
       id: 1,
@@ -6195,6 +6269,108 @@ describe('Protocol V2 firmware update targets', () => {
     );
   });
 
+  test('downloads every missing firmware target when manifest resources are already prepared', async () => {
+    const resourceBundle = createProtocolV2OkppBinary();
+    const applicationBinary = new Uint8Array([7]).buffer;
+    const remoteBinaries = {
+      bootloaderBinary: null,
+      fwBinaryMap: [
+        {
+          fileName: 'application_p1.bin',
+          binary: applicationBinary,
+          targetId: 4,
+        },
+      ],
+      installItems: [
+        {
+          fileName: 'application_p1.bin',
+          binary: applicationBinary,
+          targetId: 4,
+          kind: 'firmware',
+        },
+      ],
+    };
+    const method = new FirmwareUpdateV4({
+      id: 1,
+      payload: {
+        method: 'firmwareUpdateV4',
+        platform: 'web',
+        targetsToUpdate: ['app_v1', 'resource'],
+        resourceFiles: [
+          {
+            binary: resourceBundle,
+            devicePath: 'vol0:/bundles/images/images.okpkg',
+          },
+        ],
+      },
+    });
+    method.init();
+    (method as any).captureProtocolV2PhysicalIdentity = jest.fn().mockResolvedValue(undefined);
+    (method as any).device = stubDevice({
+      originalDescriptor: { protocolType: 'V2' },
+      features: { deviceType: 'pro2', firmwareVersion: '0.0.0', capabilities: [] },
+    });
+    (method as any).prepareRemoteProtocolV2Binaries = jest.fn().mockResolvedValue(remoteBinaries);
+    (method as any).executeProtocolV2Update = jest.fn().mockResolvedValue(undefined);
+    method.postTipMessage = jest.fn();
+
+    await method.run();
+
+    expect(forceReloadDataSpy).toHaveBeenCalledTimes(1);
+    expect((method as any).prepareRemoteProtocolV2Binaries).toHaveBeenCalledWith(
+      'universal',
+      expect.objectContaining({ deviceType: 'pro2' }),
+      []
+    );
+    expect((method as any).executeProtocolV2Update).toHaveBeenCalledWith({
+      bootloaderBinary: null,
+      fwBinaryMap: remoteBinaries.fwBinaryMap,
+      installItems: remoteBinaries.installItems,
+      resourceBundles: [
+        {
+          name: 'images.okpkg',
+          binary: resourceBundle,
+          devicePath: 'vol0:/bundles/images/images.okpkg',
+          version: [1, 2, 3],
+          payloadHash: '11'.repeat(64),
+          headerHash: '22'.repeat(64),
+        },
+      ],
+    });
+  });
+
+  test('rejects a mixed resource plan when the requested firmware release is unavailable', async () => {
+    const resourceBundle = createProtocolV2OkppBinary();
+    const method = new FirmwareUpdateV4({
+      id: 1,
+      payload: {
+        method: 'firmwareUpdateV4',
+        platform: 'web',
+        targetsToUpdate: ['app_v1', 'resource'],
+        resourceFiles: [
+          {
+            binary: resourceBundle,
+            devicePath: 'vol0:/bundles/images/images.okpkg',
+          },
+        ],
+      },
+    });
+    method.init();
+    (method as any).captureProtocolV2PhysicalIdentity = jest.fn().mockResolvedValue(undefined);
+    (method as any).device = stubDevice({
+      originalDescriptor: { protocolType: 'V2' },
+      features: { deviceType: 'pro2', firmwareVersion: '0.0.0', capabilities: [] },
+    });
+    jest.spyOn(DataManager, 'getFirmwareLatestRelease').mockReturnValue(undefined);
+    (method as any).executeProtocolV2Update = jest.fn();
+    method.postTipMessage = jest.fn();
+
+    await expect(method.run()).rejects.toThrow(
+      'Protocol V2 firmware release is unavailable for requested targets: app_v1'
+    );
+    expect((method as any).executeProtocolV2Update).not.toHaveBeenCalled();
+  });
+
   test('combines prepared firmware components with explicit manifest resource files', async () => {
     const resourceBundle = createProtocolV2OkppBinary();
     const method = new FirmwareUpdateV4({

package/dist/api/CheckBLEFirmwareRelease.d.ts

@@ -10,6 +10,6 @@ export default class CheckBLEFirmwareRelease extends BaseMethod {
         }[];
         release: import("..").IBLEFirmwareReleaseInfo | undefined;
         bootloaderMode: boolean;
-    }>;
+    } | null>;
 }
 //# sourceMappingURL=CheckBLEFirmwareRelease.d.ts.map

package/dist/api/CheckBLEFirmwareRelease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CheckBLEFirmwareRelease.d.ts","sourceRoot":"","sources":["../../src/api/CheckBLEFirmwareRelease.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAY1C,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,UAAU;IAC7D,qBAAqB;IAIrB,IAAI;IAUE,GAAG;;;;;;;;;CA+BV"}
+{"version":3,"file":"CheckBLEFirmwareRelease.d.ts","sourceRoot":"","sources":["../../src/api/CheckBLEFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAY1C,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,UAAU;IAC7D,qBAAqB;IAIrB,IAAI;IAUE,GAAG;;;;;;;;;CA2BV"}

package/dist/api/CheckBootloaderRelease.d.ts

@@ -11,6 +11,6 @@ export default class CheckBootloaderRelease extends BaseMethod {
         release: import("..").IFirmwareReleaseInfo | undefined;
         bootloaderMode: boolean;
         shouldUpdate: boolean;
-    }>;
+    } | null>;
 }
 //# sourceMappingURL=CheckBootloaderRelease.d.ts.map

package/dist/api/CheckBootloaderRelease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CheckBootloaderRelease.d.ts","sourceRoot":"","sources":["../../src/api/CheckBootloaderRelease.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc1C,MAAM,CAAC,OAAO,OAAO,sBAAuB,SAAQ,UAAU;IAC5D,qBAAqB;IAIrB,IAAI;IAME,GAAG;;;;;;;;;;CA0CV"}
+{"version":3,"file":"CheckBootloaderRelease.d.ts","sourceRoot":"","sources":["../../src/api/CheckBootloaderRelease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc1C,MAAM,CAAC,OAAO,OAAO,sBAAuB,SAAQ,UAAU;IAC5D,qBAAqB;IAIrB,IAAI;IAME,GAAG;;;;;;;;;;CAqCV"}

package/dist/api/CheckFirmwareRelease.d.ts

@@ -10,6 +10,6 @@ export default class CheckFirmwareRelease extends BaseMethod {
         }[];
         release: import("..").IFirmwareReleaseInfo | undefined;
         bootloaderMode: boolean;
-    }>;
+    } | null>;
 }
 //# sourceMappingURL=CheckFirmwareRelease.d.ts.map

package/dist/api/CheckFirmwareRelease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CheckFirmwareRelease.d.ts","sourceRoot":"","sources":["../../src/api/CheckFirmwareRelease.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAa1C,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,UAAU;IAC1D,qBAAqB;IAIrB,IAAI;IAUE,GAAG;;;;;;;;;CAiCV"}
+{"version":3,"file":"CheckFirmwareRelease.d.ts","sourceRoot":"","sources":["../../src/api/CheckFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAa1C,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,UAAU;IAC1D,qBAAqB;IAIrB,IAAI;IAUE,GAAG;;;;;;;;;CA6BV"}

package/dist/api/FirmwareUpdateV4.d.ts

@@ -40,6 +40,7 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
     private verifyProtocolV2ReconnectIdentity;
     private prepareBootloaderBinary;
     private hasExplicitProtocolV2Payload;
+    private getMissingProtocolV2FirmwareTargets;
     private buildProtocolV2InstallItems;
     private getRemoteComponentEntries;
     private getRemoteComponentTarget;

package/dist/api/FirmwareUpdateV4.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FirmwareUpdateV4.d.ts","sourceRoot":"","sources":["../../src/api/FirmwareUpdateV4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkD,MAAM,qBAAqB,CAAC;AAyBlG,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAmB/E,OAAO,KAAK,EAEV,sBAAsB,EAEvB,MAAM,6BAA6B,CAAC;AA6CrC,wBAAgB,wCAAwC,CACtD,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,EAC5C,MAAM,EAAE,sBAAsB,QAgB/B;AA6UD,eAAO,MAAM,oCAAoC,WACvC,WAAW,GAAG,UAAU,eACnB,MAAM,GAAG,SAAS,YAKhC,CAAC;AAEF,eAAO,MAAM,iCAAiC,0BACrB,MAAM,uBACR,MAAM,iBACZ,MAAM,eACR,MAAM,SAsBpB,CAAC;AAUF,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,wBAAwB,CAAC,sBAAsB,CAAC;IAC5F,OAAO,CAAC,8BAA8B,CAAC,CAAS;IAEhD,OAAO,CAAC,sBAAsB,CAAC,CAAS;IAExC,qBAAqB;IAIrB,OAAO,CAAC,yBAAyB,CAA4B;IAE7D,OAAO,CAAC,2BAA2B,CAAS;IAE5C,OAAO,CAAC,iCAAiC,CAA6B;IAEtE,OAAO,CAAC,6BAA6B,CAAC,CAAW;IAEjD,OAAO,CAAC,6BAA6B,CAAS;IAE9C,IAAI;IAoHJ,OAAO,CAAC,8BAA8B;IAwBhC,GAAG;;;;;YAKK,aAAa;YAwGb,4BAA4B;YAkB5B,0BAA0B;YAY1B,8BAA8B;YAK9B,+BAA+B;YAqD/B,gCAAgC;YAmDhC,8BAA8B;IAkC5C,OAAO,CAAC,8BAA8B;IA0BtC,OAAO,CAAC,kCAAkC;IAc1C,OAAO,CAAC,gCAAgC;IAsDxC,OAAO,CAAC,6BAA6B;YAsBvB,2BAA2B;IAWzC,OAAO,CAAC,yBAAyB;IAKjC,OAAO,CAAC,kCAAkC;IAS1C,OAAO,CAAC,8BAA8B;YAMxB,iCAAiC;YAOjC,iCAAiC;YAkBjC,iCAAiC;IAM/C,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,4BAA4B;IAQpC,OAAO,CAAC,2BAA2B;IAsBnC,OAAO,CAAC,yBAAyB;IAiBjC,OAAO,CAAC,wBAAwB;YAkBlB,iCAAiC;YAmCjC,+BAA+B;IAqD7C,OAAO,CAAC,sCAAsC;IA0C9C,OAAO,CAAC,6BAA6B;YAMvB,8BAA8B;YA8C9B,kCAAkC;IA4BhD,OAAO,CAAC,0BAA0B;IAUlC,OAAO,CAAC,yBAAyB;IAc3B,6BAA6B;YAgCrB,+BAA+B;IAkD7C,OAAO,CAAC,6BAA6B;IAkCrC,OAAO,CAAC,8BAA8B;YA8CxB,uBAAuB;YAiCvB,6BAA6B;YAa7B,uBAAuB;YA6CvB,8BAA8B;YA8D9B,6BAA6B;IAuE3C,OAAO,CAAC,mCAAmC;YAI7B,0BAA0B;IAaxC,OAAO,CAAC,4BAA4B;IAyGpC,OAAO,CAAC,6BAA6B;YAcvB,uCAAuC;YA0JvC,gCAAgC;YAehC,yBAAyB;YAQzB,8BAA8B;IAQ5C,OAAO,CAAC,0BAA0B;YAkBpB,mCAAmC;YAWnC,qCAAqC;YAgDrC,yBAAyB;YA8DzB,8BAA8B;IAU5C,OAAO,CAAC,kCAAkC;YAQ5B,cAAc;YAuCd,6BAA6B;YAW7B,0BAA0B;YAS1B,6BAA6B;YAmB7B,gBAAgB;IAiB9B,OAAO,CAAC,qBAAqB;CAM9B"}
+{"version":3,"file":"FirmwareUpdateV4.d.ts","sourceRoot":"","sources":["../../src/api/FirmwareUpdateV4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkD,MAAM,qBAAqB,CAAC;AAyBlG,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAmB/E,OAAO,KAAK,EAEV,sBAAsB,EAEvB,MAAM,6BAA6B,CAAC;AA6CrC,wBAAgB,wCAAwC,CACtD,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,EAC5C,MAAM,EAAE,sBAAsB,QAgB/B;AA6UD,eAAO,MAAM,oCAAoC,WACvC,WAAW,GAAG,UAAU,eACnB,MAAM,GAAG,SAAS,YAKhC,CAAC;AAEF,eAAO,MAAM,iCAAiC,0BACrB,MAAM,uBACR,MAAM,iBACZ,MAAM,eACR,MAAM,SAsBpB,CAAC;AAUF,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,wBAAwB,CAAC,sBAAsB,CAAC;IAC5F,OAAO,CAAC,8BAA8B,CAAC,CAAS;IAEhD,OAAO,CAAC,sBAAsB,CAAC,CAAS;IAExC,qBAAqB;IAIrB,OAAO,CAAC,yBAAyB,CAA4B;IAE7D,OAAO,CAAC,2BAA2B,CAAS;IAE5C,OAAO,CAAC,iCAAiC,CAA6B;IAEtE,OAAO,CAAC,6BAA6B,CAAC,CAAW;IAEjD,OAAO,CAAC,6BAA6B,CAAS;IAE9C,IAAI;IAoHJ,OAAO,CAAC,8BAA8B;IAwBhC,GAAG;;;;;YAKK,aAAa;YAgHb,4BAA4B;YAkB5B,0BAA0B;YAY1B,8BAA8B;YAK9B,+BAA+B;YAqD/B,gCAAgC;YAmDhC,8BAA8B;IAkC5C,OAAO,CAAC,8BAA8B;IA0BtC,OAAO,CAAC,kCAAkC;IAc1C,OAAO,CAAC,gCAAgC;IAsDxC,OAAO,CAAC,6BAA6B;YAsBvB,2BAA2B;IAWzC,OAAO,CAAC,yBAAyB;IAKjC,OAAO,CAAC,kCAAkC;IAS1C,OAAO,CAAC,8BAA8B;YAMxB,iCAAiC;YAOjC,iCAAiC;YAkBjC,iCAAiC;IAM/C,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,4BAA4B;IAIpC,OAAO,CAAC,mCAAmC;IAY3C,OAAO,CAAC,2BAA2B;IAsBnC,OAAO,CAAC,yBAAyB;IAiBjC,OAAO,CAAC,wBAAwB;YAkBlB,iCAAiC;YAmCjC,+BAA+B;IA6E7C,OAAO,CAAC,sCAAsC;IA0C9C,OAAO,CAAC,6BAA6B;YAMvB,8BAA8B;YA8C9B,kCAAkC;IA4BhD,OAAO,CAAC,0BAA0B;IAUlC,OAAO,CAAC,yBAAyB;IAc3B,6BAA6B;YAgCrB,+BAA+B;IAkD7C,OAAO,CAAC,6BAA6B;IAkCrC,OAAO,CAAC,8BAA8B;YA8CxB,uBAAuB;YAiCvB,6BAA6B;YAa7B,uBAAuB;YA6CvB,8BAA8B;YA8D9B,6BAA6B;IAuE3C,OAAO,CAAC,mCAAmC;YAI7B,0BAA0B;IAaxC,OAAO,CAAC,4BAA4B;IAyGpC,OAAO,CAAC,6BAA6B;YAcvB,uCAAuC;YA0JvC,gCAAgC;YAehC,yBAAyB;YAQzB,8BAA8B;IAQ5C,OAAO,CAAC,0BAA0B;YAkBpB,mCAAmC;YAWnC,qCAAqC;YAgDrC,yBAAyB;YA8DzB,8BAA8B;IAU5C,OAAO,CAAC,kCAAkC;YAQ5B,cAAc;YAuCd,6BAA6B;YAW7B,0BAA0B;YAS1B,6BAA6B;YAmB7B,gBAAgB;IAiB9B,OAAO,CAAC,qBAAqB;CAM9B"}

package/dist/index.d.ts

@@ -1545,7 +1545,7 @@ type CheckAllFirmwareReleaseParams = {
 };
 declare function checkAllFirmwareRelease(connectId?: string, params?: CommonParams & CheckAllFirmwareReleaseParams): Response<AllFirmwareRelease>;
 
-type CheckBootloaderReleaseResponse = FirmwareReleaseCheckResult;
+type CheckBootloaderReleaseResponse = FirmwareReleaseCheckResult | null;
 type CheckBootloaderReleaseParams = {
     willUpdateFirmwareVersion?: string;
     firmwareType?: EFirmwareType;
@@ -1622,9 +1622,9 @@ declare function openWalletSession(connectId: string, params: CommonParams & Ope
 type CheckFirmwareReleaseParams = {
     firmwareType?: EFirmwareType;
 };
-declare function checkFirmwareRelease(connectId?: string, params?: CheckFirmwareReleaseParams): Response<FirmwareReleaseCheckResult>;
+declare function checkFirmwareRelease(connectId?: string, params?: CheckFirmwareReleaseParams): Response<FirmwareReleaseCheckResult | null>;
 
-declare function checkBLEFirmwareRelease(connectId?: string): Response<FirmwareReleaseCheckResult>;
+declare function checkBLEFirmwareRelease(connectId?: string): Response<FirmwareReleaseCheckResult | null>;
 
 interface FirmwareUpdateCapabilities {
     planSchemaVersion: 2;

package/dist/index.js

@@ -47750,6 +47750,8 @@ class CheckFirmwareRelease extends BaseMethod {
         var _a;
         return __awaiter(this, void 0, void 0, function* () {
             const payload = this.payload;
+            if (!this.device.features)
+                return null;
             if (this.device.isProtocolV2()) {
                 const { state, firmwareType, release } = yield loadProtocolV2FirmwareReleaseContext({
                     device: this.device,
@@ -47764,13 +47766,10 @@ class CheckFirmwareRelease extends BaseMethod {
                 }), PROTOCOL_V2_MAIN_FIRMWARE_TARGETS);
                 return toProtocolV2FirmwareReleaseInfo({ plan, state, release });
             }
-            if (this.device.features) {
-                const deviceFirmwareType = this.device.getCurrentFirmwareType();
-                const firmwareType = (_a = payload.firmwareType) !== null && _a !== void 0 ? _a : deviceFirmwareType;
-                const releaseInfo = getFirmwareReleaseInfo(this.device.features, firmwareType);
-                return releaseInfo;
-            }
-            throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, 'checkFirmwareRelease requires initialized device features');
+            const deviceFirmwareType = this.device.getCurrentFirmwareType();
+            const firmwareType = (_a = payload.firmwareType) !== null && _a !== void 0 ? _a : deviceFirmwareType;
+            const releaseInfo = getFirmwareReleaseInfo(this.device.features, firmwareType);
+            return releaseInfo;
         });
     }
 }
@@ -47790,6 +47789,8 @@ class CheckBLEFirmwareRelease extends BaseMethod {
     }
     run() {
         return __awaiter(this, void 0, void 0, function* () {
+            if (!this.device.features)
+                return null;
             if (this.device.isProtocolV2()) {
                 const { state, firmwareType, release } = yield loadProtocolV2FirmwareReleaseContext({
                     device: this.device,
@@ -47807,11 +47808,8 @@ class CheckBLEFirmwareRelease extends BaseMethod {
                     release: getProtocolV2ComponentReleaseInfo(plan, 'COPROCESSOR'),
                 });
             }
-            if (this.device.features) {
-                const releaseInfo = getBleFirmwareReleaseInfo(this.device.features);
-                return releaseInfo;
-            }
-            throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, 'checkBLEFirmwareRelease requires initialized device features');
+            const releaseInfo = getBleFirmwareReleaseInfo(this.device.features);
+            return releaseInfo;
         });
     }
 }
@@ -47882,9 +47880,8 @@ class CheckBootloaderRelease extends BaseMethod {
     run() {
         var _a;
         return __awaiter(this, void 0, void 0, function* () {
-            if (!this.device.features) {
-                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, 'checkBootloaderRelease requires initialized device features');
-            }
+            if (!this.device.features)
+                return null;
             const { features } = this.device;
             const payload = this.payload;
             if (this.device.isProtocolV2()) {
@@ -51536,7 +51533,7 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
         });
     }
     runProtocolV2() {
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d, _e, _f;
         return __awaiter(this, void 0, void 0, function* () {
             yield this.captureProtocolV2PhysicalIdentity();
             const deviceFeatures = yield this.getProtocolV2DeviceFeatures();
@@ -51564,7 +51561,14 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
                 resourceBundles = this.prepareExplicitProtocolV2ResourceFiles();
                 fwBinaryMap = this.collectExplicitTargetBinaries();
                 bootloaderBinary = this.prepareBootloaderBinary();
-                const needsRemoteFirmware = !this.hasExplicitProtocolV2Payload(fwBinaryMap);
+                const explicitInstallItems = this.buildProtocolV2InstallItems({
+                    bootloaderBinary,
+                    fwBinaryMap,
+                });
+                const missingFirmwareTargets = this.getMissingProtocolV2FirmwareTargets(explicitInstallItems);
+                const needsRemoteFirmware = ((_e = this.params.targetsToUpdate) === null || _e === void 0 ? void 0 : _e.length)
+                    ? missingFirmwareTargets.length > 0
+                    : !this.hasExplicitProtocolV2Payload(explicitInstallItems);
                 if (needsPreparedResources) {
                     throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, 'Protocol V2 resource manifest must be prepared by the external firmware host', {
                         firmwareUpdateCode: 'FirmwareArtifactsNotPrepared',
@@ -51581,7 +51585,7 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
                     yield DataManager.forceReloadData();
                 }
                 if (needsRemoteFirmware) {
-                    const remoteBinaries = yield this.prepareRemoteProtocolV2Binaries(firmwareType, deviceFeatures);
+                    const remoteBinaries = yield this.prepareRemoteProtocolV2Binaries(firmwareType, deviceFeatures, explicitInstallItems);
                     bootloaderBinary = remoteBinaries.bootloaderBinary;
                     fwBinaryMap = remoteBinaries.fwBinaryMap;
                     installItems = remoteBinaries.installItems;
@@ -51592,7 +51596,7 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
                 if (typeof err === 'object' &&
                     err !== null &&
                     'params' in err &&
-                    ((_e = err.params) === null || _e === void 0 ? void 0 : _e.firmwareUpdateCode) === 'FirmwareArtifactsNotPrepared') {
+                    ((_f = err.params) === null || _f === void 0 ? void 0 : _f.firmwareUpdateCode) === 'FirmwareArtifactsNotPrepared') {
                     throw err;
                 }
                 if (err instanceof hdShared.HardwareError && err.errorCode === hdShared.HardwareErrorCode.NetworkError) {
@@ -51907,11 +51911,17 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
         var _a;
         return (_a = this.params.bootloaderBinary) !== null && _a !== void 0 ? _a : null;
     }
-    hasExplicitProtocolV2Payload(fwBinaryMap) {
+    hasExplicitProtocolV2Payload(installItems) {
+        var _a;
+        return !!((_a = this.params.resourceFiles) === null || _a === void 0 ? void 0 : _a.length) || installItems.length > 0;
+    }
+    getMissingProtocolV2FirmwareTargets(installItems) {
         var _a;
-        return (!!((_a = this.params.resourceFiles) === null || _a === void 0 ? void 0 : _a.length) ||
-            !!this.params.bootloaderBinary ||
-            fwBinaryMap.length > 0);
+        const preparedTargets = new Set(installItems.flatMap(item => {
+            const target = PROTOCOL_V2_UPDATE_TARGET_BY_TARGET_ID.get(item.targetId);
+            return target ? [target] : [];
+        }));
+        return ((_a = this.params.targetsToUpdate) !== null && _a !== void 0 ? _a : []).filter(target => target !== 'resource' && !preparedTargets.has(target));
     }
     buildProtocolV2InstallItems({ bootloaderBinary, fwBinaryMap, }) {
         const installItems = [];
@@ -51974,7 +51984,7 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
             return Object.assign(Object.assign({}, target), { binary });
         });
     }
-    prepareRemoteProtocolV2Binaries(firmwareType, features) {
+    prepareRemoteProtocolV2Binaries(firmwareType, features, explicitInstallItems = []) {
         var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
             const release = DataManager.getFirmwareLatestRelease(features, firmwareType);
@@ -51982,6 +51992,10 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
             const fwBinaryMap = [];
             const installItems = [];
             if (!release) {
+                const missingFirmwareTargets = this.getMissingProtocolV2FirmwareTargets(explicitInstallItems);
+                if (missingFirmwareTargets.length > 0) {
+                    throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, `Protocol V2 firmware release is unavailable for requested targets: ${missingFirmwareTargets.join(', ')}`);
+                }
                 return {
                     bootloaderBinary,
                     fwBinaryMap,
@@ -51990,6 +52004,8 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
             }
             const entries = this.getRemoteComponentEntries(release);
             const targetsToUpdate = new Set((_a = this.params.targetsToUpdate) !== null && _a !== void 0 ? _a : []);
+            const explicitInstallItemByTargetId = new Map(explicitInstallItems.map(item => [item.targetId, item]));
+            const preparedTargets = new Set();
             for (const [key, component] of entries) {
                 const targetName = (_b = component.target) === null || _b === void 0 ? void 0 : _b.toUpperCase();
                 const target = PROTOCOL_V2_REMOTE_COMPONENT_TARGETS[targetName];
@@ -51997,27 +52013,27 @@ class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod {
                     ? PROTOCOL_V2_UPDATE_TARGET_BY_TARGET_ID.get(target.targetId)
                     : undefined;
                 if (updateTarget && targetsToUpdate.has(updateTarget)) {
-                    const remoteBinary = yield this.downloadRemoteProtocolV2Component(key, component);
-                    if (remoteBinary.kind === 'bootloader') {
-                        bootloaderBinary = remoteBinary.binary;
-                        installItems.push({
-                            fileName: remoteBinary.fileName,
-                            binary: remoteBinary.binary,
-                            targetId: remoteBinary.targetId,
-                            kind: remoteBinary.kind,
-                        });
+                    const explicitInstallItem = explicitInstallItemByTargetId.get(target.targetId);
+                    const installItem = explicitInstallItem !== null && explicitInstallItem !== void 0 ? explicitInstallItem : (yield this.downloadRemoteProtocolV2Component(key, component));
+                    if (installItem.kind === 'bootloader') {
+                        bootloaderBinary = installItem.binary;
                     }
                     else {
                         const binaryEntry = {
-                            fileName: remoteBinary.fileName,
-                            binary: remoteBinary.binary,
-                            targetId: remoteBinary.targetId,
+                            fileName: installItem.fileName,
+                            binary: installItem.binary,
+                            targetId: installItem.targetId,
                         };
                         fwBinaryMap.push(binaryEntry);
-                        installItems.push(Object.assign(Object.assign({}, binaryEntry), { kind: remoteBinary.kind }));
                     }
+                    installItems.push(Object.assign({}, installItem));
+                    preparedTargets.add(updateTarget);
                 }
             }
+            const missingTarget = Array.from(targetsToUpdate).find(target => target !== 'resource' && !preparedTargets.has(target));
+            if (missingTarget) {
+                throw hdShared.ERRORS.TypedError(hdShared.HardwareErrorCode.RuntimeError, `Protocol V2 release does not contain requested target ${missingTarget}`);
+            }
             return {
                 bootloaderBinary,
                 fwBinaryMap,

package/dist/types/api/checkBLEFirmwareRelease.d.ts

@@ -1,4 +1,4 @@
 import type { Response } from '../params';
 import type { FirmwareReleaseCheckResult } from './checkAllFirmwareRelease';
-export declare function checkBLEFirmwareRelease(connectId?: string): Response<FirmwareReleaseCheckResult>;
+export declare function checkBLEFirmwareRelease(connectId?: string): Response<FirmwareReleaseCheckResult | null>;
 //# sourceMappingURL=checkBLEFirmwareRelease.d.ts.map

package/dist/types/api/checkBLEFirmwareRelease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkBLEFirmwareRelease.d.ts","sourceRoot":"","sources":["../../../src/types/api/checkBLEFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE5E,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC7C,SAAS,CAAC,EAAE,MAAM,GACjB,QAAQ,CAAC,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"checkBLEFirmwareRelease.d.ts","sourceRoot":"","sources":["../../../src/types/api/checkBLEFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE5E,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC7C,SAAS,CAAC,EAAE,MAAM,GACjB,QAAQ,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC"}

package/dist/types/api/checkBootloaderRelease.d.ts

@@ -1,7 +1,7 @@
 import type { EFirmwareType } from '@onekeyfe/hd-shared';
 import type { CommonParams, Response } from '../params';
 import type { FirmwareReleaseCheckResult } from './checkAllFirmwareRelease';
-export type CheckBootloaderReleaseResponse = FirmwareReleaseCheckResult;
+export type CheckBootloaderReleaseResponse = FirmwareReleaseCheckResult | null;
 export type CheckBootloaderReleaseParams = {
     willUpdateFirmwareVersion?: string;
     firmwareType?: EFirmwareType;

package/dist/types/api/checkBootloaderRelease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkBootloaderRelease.d.ts","sourceRoot":"","sources":["../../../src/types/api/checkBootloaderRelease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE5E,MAAM,MAAM,8BAA8B,GAAG,0BAA0B,CAAC;AAExE,MAAM,MAAM,4BAA4B,GAAG;IACzC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,YAAY,GAAG,4BAA4B,GACnD,QAAQ,CAAC,8BAA8B,CAAC,CAAC"}
+{"version":3,"file":"checkBootloaderRelease.d.ts","sourceRoot":"","sources":["../../../src/types/api/checkBootloaderRelease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE5E,MAAM,MAAM,8BAA8B,GAAG,0BAA0B,GAAG,IAAI,CAAC;AAE/E,MAAM,MAAM,4BAA4B,GAAG;IACzC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAC5C,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,YAAY,GAAG,4BAA4B,GACnD,QAAQ,CAAC,8BAA8B,CAAC,CAAC"}

package/dist/types/api/checkFirmwareRelease.d.ts

@@ -4,5 +4,5 @@ import type { FirmwareReleaseCheckResult } from './checkAllFirmwareRelease';
 export type CheckFirmwareReleaseParams = {
     firmwareType?: EFirmwareType;
 };
-export declare function checkFirmwareRelease(connectId?: string, params?: CheckFirmwareReleaseParams): Response<FirmwareReleaseCheckResult>;
+export declare function checkFirmwareRelease(connectId?: string, params?: CheckFirmwareReleaseParams): Response<FirmwareReleaseCheckResult | null>;
 //# sourceMappingURL=checkFirmwareRelease.d.ts.map

package/dist/types/api/checkFirmwareRelease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkFirmwareRelease.d.ts","sourceRoot":"","sources":["../../../src/types/api/checkFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE5E,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,0BAA0B,GAClC,QAAQ,CAAC,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"checkFirmwareRelease.d.ts","sourceRoot":"","sources":["../../../src/types/api/checkFirmwareRelease.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE5E,MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,0BAA0B,GAClC,QAAQ,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/hd-core",
-  "version": "1.2.0-alpha.80",
+  "version": "1.2.0-alpha.82",
   "description": "Core processes and APIs for communicating with OneKey hardware devices.",
   "author": "OneKey",
   "homepage": "https://github.com/OneKeyHQ/hardware-js-sdk#readme",
@@ -25,8 +25,8 @@
     "url": "https://github.com/OneKeyHQ/hardware-js-sdk/issues"
   },
   "dependencies": {
-    "@onekeyfe/hd-shared": "1.2.0-alpha.80",
-    "@onekeyfe/hd-transport": "1.2.0-alpha.80",
+    "@onekeyfe/hd-shared": "1.2.0-alpha.82",
+    "@onekeyfe/hd-transport": "1.2.0-alpha.82",
     "axios": "1.15.2",
     "bignumber.js": "^9.0.2",
     "bytebuffer": "^5.0.1",
@@ -44,5 +44,5 @@
     "@types/w3c-web-usb": "^1.0.10",
     "@types/web-bluetooth": "^0.0.21"
   },
-  "gitHead": "7a1fda70653fc04493307cfaae76c04cc5cd1554"
+  "gitHead": "7b2b6f5b2f046f5ff2e35e14735ba3918c258054"
 }

package/src/api/CheckBLEFirmwareRelease.ts

@@ -1,5 +1,3 @@
-import { ERRORS, HardwareErrorCode } from '@onekeyfe/hd-shared';
-
 import { BaseMethod } from './BaseMethod';
 import { UI_REQUEST } from '../constants/ui-request';
 import { getBleFirmwareReleaseInfo } from './firmware/releaseHelper';
@@ -28,6 +26,8 @@ export default class CheckBLEFirmwareRelease extends BaseMethod {
   }
 
   async run() {
+    if (!this.device.features) return null;
+
     if (this.device.isProtocolV2()) {
       const { state, firmwareType, release } = await loadProtocolV2FirmwareReleaseContext({
         device: this.device,
@@ -49,13 +49,7 @@ export default class CheckBLEFirmwareRelease extends BaseMethod {
       });
     }
 
-    if (this.device.features) {
-      const releaseInfo = getBleFirmwareReleaseInfo(this.device.features);
-      return releaseInfo;
-    }
-    throw ERRORS.TypedError(
-      HardwareErrorCode.RuntimeError,
-      'checkBLEFirmwareRelease requires initialized device features'
-    );
+    const releaseInfo = getBleFirmwareReleaseInfo(this.device.features);
+    return releaseInfo;
   }
 }

package/src/api/CheckBootloaderRelease.ts

@@ -1,5 +1,3 @@
-import { ERRORS, HardwareErrorCode } from '@onekeyfe/hd-shared';
-
 import { BaseMethod } from './BaseMethod';
 import { UI_REQUEST } from '../constants/ui-request';
 import { getBootloaderReleaseInfo } from './firmware/releaseHelper';
@@ -26,12 +24,7 @@ export default class CheckBootloaderRelease extends BaseMethod {
   }
 
   async run() {
-    if (!this.device.features) {
-      throw ERRORS.TypedError(
-        HardwareErrorCode.RuntimeError,
-        'checkBootloaderRelease requires initialized device features'
-      );
-    }
+    if (!this.device.features) return null;
     const { features } = this.device;
     const payload = this.payload as CheckBootloaderReleaseParams;
 

package/src/api/CheckFirmwareRelease.ts

@@ -1,5 +1,3 @@
-import { ERRORS, HardwareErrorCode } from '@onekeyfe/hd-shared';
-
 import { BaseMethod } from './BaseMethod';
 import { UI_REQUEST } from '../constants/ui-request';
 import { getFirmwareReleaseInfo } from './firmware/releaseHelper';
@@ -31,6 +29,8 @@ export default class CheckFirmwareRelease extends BaseMethod {
   async run() {
     const payload = this.payload as CheckFirmwareReleaseParams;
 
+    if (!this.device.features) return null;
+
     if (this.device.isProtocolV2()) {
       const { state, firmwareType, release } = await loadProtocolV2FirmwareReleaseContext({
         device: this.device,
@@ -49,16 +49,10 @@ export default class CheckFirmwareRelease extends BaseMethod {
       return toProtocolV2FirmwareReleaseInfo({ plan, state, release });
     }
 
-    if (this.device.features) {
-      const deviceFirmwareType = this.device.getCurrentFirmwareType();
-      const firmwareType = payload.firmwareType ?? deviceFirmwareType;
+    const deviceFirmwareType = this.device.getCurrentFirmwareType();
+    const firmwareType = payload.firmwareType ?? deviceFirmwareType;
 
-      const releaseInfo = getFirmwareReleaseInfo(this.device.features, firmwareType);
-      return releaseInfo;
-    }
-    throw ERRORS.TypedError(
-      HardwareErrorCode.RuntimeError,
-      'checkFirmwareRelease requires initialized device features'
-    );
+    const releaseInfo = getFirmwareReleaseInfo(this.device.features, firmwareType);
+    return releaseInfo;
   }
 }

package/src/api/FirmwareUpdateV4.ts

@@ -683,7 +683,14 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
       resourceBundles = this.prepareExplicitProtocolV2ResourceFiles();
       fwBinaryMap = this.collectExplicitTargetBinaries();
       bootloaderBinary = this.prepareBootloaderBinary();
-      const needsRemoteFirmware = !this.hasExplicitProtocolV2Payload(fwBinaryMap);
+      const explicitInstallItems = this.buildProtocolV2InstallItems({
+        bootloaderBinary,
+        fwBinaryMap,
+      });
+      const missingFirmwareTargets = this.getMissingProtocolV2FirmwareTargets(explicitInstallItems);
+      const needsRemoteFirmware = this.params.targetsToUpdate?.length
+        ? missingFirmwareTargets.length > 0
+        : !this.hasExplicitProtocolV2Payload(explicitInstallItems);
       if (needsPreparedResources) {
         throw ERRORS.TypedError(
           HardwareErrorCode.RuntimeError,
@@ -713,7 +720,8 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
       if (needsRemoteFirmware) {
         const remoteBinaries = await this.prepareRemoteProtocolV2Binaries(
           firmwareType,
-          deviceFeatures
+          deviceFeatures,
+          explicitInstallItems
         );
         bootloaderBinary = remoteBinaries.bootloaderBinary;
         fwBinaryMap = remoteBinaries.fwBinaryMap;
@@ -1110,11 +1118,19 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
     return this.params.bootloaderBinary ?? null;
   }
 
-  private hasExplicitProtocolV2Payload(fwBinaryMap: ProtocolV2TargetBinary[]) {
-    return (
-      !!this.params.resourceFiles?.length ||
-      !!this.params.bootloaderBinary ||
-      fwBinaryMap.length > 0
+  private hasExplicitProtocolV2Payload(installItems: ProtocolV2InstallItem[]) {
+    return !!this.params.resourceFiles?.length || installItems.length > 0;
+  }
+
+  private getMissingProtocolV2FirmwareTargets(installItems: ProtocolV2InstallItem[]) {
+    const preparedTargets = new Set(
+      installItems.flatMap(item => {
+        const target = PROTOCOL_V2_UPDATE_TARGET_BY_TARGET_ID.get(item.targetId);
+        return target ? [target] : [];
+      })
+    );
+    return (this.params.targetsToUpdate ?? []).filter(
+      target => target !== 'resource' && !preparedTargets.has(target)
     );
   }
 
@@ -1210,7 +1226,11 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
     };
   }
 
-  private async prepareRemoteProtocolV2Binaries(firmwareType: EFirmwareType, features: Features) {
+  private async prepareRemoteProtocolV2Binaries(
+    firmwareType: EFirmwareType,
+    features: Features,
+    explicitInstallItems: ProtocolV2InstallItem[] = []
+  ) {
     const release = DataManager.getFirmwareLatestRelease(features, firmwareType);
 
     let bootloaderBinary: ArrayBuffer | null = null;
@@ -1218,6 +1238,15 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
     const installItems: ProtocolV2InstallItem[] = [];
 
     if (!release) {
+      const missingFirmwareTargets = this.getMissingProtocolV2FirmwareTargets(explicitInstallItems);
+      if (missingFirmwareTargets.length > 0) {
+        throw ERRORS.TypedError(
+          HardwareErrorCode.RuntimeError,
+          `Protocol V2 firmware release is unavailable for requested targets: ${missingFirmwareTargets.join(
+            ', '
+          )}`
+        );
+      }
       return {
         bootloaderBinary,
         fwBinaryMap,
@@ -1227,6 +1256,10 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
 
     const entries = this.getRemoteComponentEntries(release);
     const targetsToUpdate = new Set(this.params.targetsToUpdate ?? []);
+    const explicitInstallItemByTargetId = new Map(
+      explicitInstallItems.map(item => [item.targetId, item] as const)
+    );
+    const preparedTargets = new Set<FirmwareUpdateV4Target>();
 
     for (const [key, component] of entries) {
       const targetName = component.target?.toUpperCase();
@@ -1235,27 +1268,34 @@ export default class FirmwareUpdateV4 extends FirmwareUpdateBaseMethod<FirmwareU
         ? PROTOCOL_V2_UPDATE_TARGET_BY_TARGET_ID.get(target.targetId)
         : undefined;
       if (updateTarget && targetsToUpdate.has(updateTarget)) {
-        const remoteBinary = await this.downloadRemoteProtocolV2Component(key, component);
-        if (remoteBinary.kind === 'bootloader') {
-          bootloaderBinary = remoteBinary.binary;
-          installItems.push({
-            fileName: remoteBinary.fileName,
-            binary: remoteBinary.binary,
-            targetId: remoteBinary.targetId,
-            kind: remoteBinary.kind,
-          });
+        const explicitInstallItem = explicitInstallItemByTargetId.get(target.targetId);
+        const installItem =
+          explicitInstallItem ?? (await this.downloadRemoteProtocolV2Component(key, component));
+        if (installItem.kind === 'bootloader') {
+          bootloaderBinary = installItem.binary;
         } else {
           const binaryEntry = {
-            fileName: remoteBinary.fileName,
-            binary: remoteBinary.binary,
-            targetId: remoteBinary.targetId,
+            fileName: installItem.fileName,
+            binary: installItem.binary,
+            targetId: installItem.targetId,
           };
           fwBinaryMap.push(binaryEntry);
-          installItems.push({ ...binaryEntry, kind: remoteBinary.kind });
         }
+        installItems.push({ ...installItem });
+        preparedTargets.add(updateTarget);
       }
     }
 
+    const missingTarget = Array.from(targetsToUpdate).find(
+      target => target !== 'resource' && !preparedTargets.has(target)
+    );
+    if (missingTarget) {
+      throw ERRORS.TypedError(
+        HardwareErrorCode.RuntimeError,
+        `Protocol V2 release does not contain requested target ${missingTarget}`
+      );
+    }
+
     return {
       bootloaderBinary,
       fwBinaryMap,

package/src/types/api/checkBLEFirmwareRelease.ts

@@ -3,4 +3,4 @@ import type { FirmwareReleaseCheckResult } from './checkAllFirmwareRelease';
 
 export declare function checkBLEFirmwareRelease(
   connectId?: string
-): Response<FirmwareReleaseCheckResult>;
+): Response<FirmwareReleaseCheckResult | null>;

package/src/types/api/checkBootloaderRelease.ts

@@ -2,7 +2,7 @@ import type { EFirmwareType } from '@onekeyfe/hd-shared';
 import type { CommonParams, Response } from '../params';
 import type { FirmwareReleaseCheckResult } from './checkAllFirmwareRelease';
 
-export type CheckBootloaderReleaseResponse = FirmwareReleaseCheckResult;
+export type CheckBootloaderReleaseResponse = FirmwareReleaseCheckResult | null;
 
 export type CheckBootloaderReleaseParams = {
   willUpdateFirmwareVersion?: string;

package/src/types/api/checkFirmwareRelease.ts

@@ -9,4 +9,4 @@ export type CheckFirmwareReleaseParams = {
 export declare function checkFirmwareRelease(
   connectId?: string,
   params?: CheckFirmwareReleaseParams
-): Response<FirmwareReleaseCheckResult>;
+): Response<FirmwareReleaseCheckResult | null>;