@onekeyfe/hd-core 1.2.0-alpha.0 → 1.2.0-alpha.10

package/src/api/GetDeviceInfo.ts

@@ -57,7 +57,7 @@ function shouldReadOnekeyFeatures(params: GetDeviceInfoParams) {
 }
 
 function supportOnekeyFeatures(features?: Features) {
-  if (!features || features.bootloader_mode) return false;
+  if (!features || features.bootloaderMode) return false;
 
   const deviceType = getDeviceType(features);
   return ![
@@ -109,14 +109,8 @@ export default class GetDeviceInfo extends BaseMethod<GetDeviceInfoParams> {
       sources,
       scope: this.params.scope,
       includeRaw: this.params.includeRaw,
-      fallbackSerialNo: this.device.originalDescriptor?.path,
     });
-    // 缓存走字段级合并：basic 请求不能降级已有的完整 profile；返回值仍按请求 scope 给出
-    if (typeof this.device.applyProfileUpdate === 'function') {
-      this.device.applyProfileUpdate(profile, protocolV2DeviceInfo);
-    } else {
-      this.device.updateProfile?.(profile);
-    }
+    this.device.updateProtocolV2Features(protocolV2DeviceInfo);
     return profile;
   }
 
@@ -127,26 +121,25 @@ export default class GetDeviceInfo extends BaseMethod<GetDeviceInfoParams> {
 
     const sources: DeviceInfoSource[] = ['features'];
     const { features } = this.device;
-    let onekeyFeatures: OnekeyFeatures | undefined;
+    let protocolV1OneKeyFeatures: OnekeyFeatures | undefined;
 
     if (shouldReadOnekeyFeatures(this.params) && supportOnekeyFeatures(features)) {
       const { message } = await this.device.commands.typedCall(
         'OnekeyGetFeatures',
         'OnekeyFeatures'
       );
-      onekeyFeatures = normalizeOnekeyFeatures(message);
-      sources.push('onekeyFeatures');
+      protocolV1OneKeyFeatures = normalizeOnekeyFeatures(message);
+      sources.push('protocolV1OneKeyFeatures');
     }
 
     const profile = buildProfileFromProtocolV1({
       protocol: 'V1',
       features,
-      onekeyFeatures,
+      protocolV1OneKeyFeatures,
       sources,
       scope: this.params.scope,
       includeRaw: this.params.includeRaw,
     });
-    this.device.updateProfile?.(profile);
     return profile;
   }
 }

package/src/api/GetOnekeyFeatures.ts

@@ -4,7 +4,6 @@ import { UI_REQUEST } from '../constants/ui-request';
 import { fixVersion } from '../utils/deviceFeaturesUtils';
 import { PROTOCOL_V2_DEVICE_INFO_REQUEST } from '../protocols/protocol-v2';
 import { requestProtocolV2DeviceInfo } from '../protocols/protocol-v2/features';
-import { buildProfileFromProtocolV2, buildProtocolV2GetFeaturesPayload } from '../deviceProfile';
 import { BaseMethod } from './BaseMethod';
 
 import type { OnekeyFeatures } from '../types';
@@ -91,23 +90,13 @@ export default class GetOnekeyFeatures extends BaseMethod {
   async run() {
     if (this.device.isProtocolV2()) {
       // V2 没有 OnekeyGetFeatures 消息：
-      // 取完整 DevGetDeviceInfo（含 SE/hash/build_id）后写入 features 兼容视图。
+      // 取完整 DeviceInfoGet（含 SE/hash/build_id）后刷新结构化 features 缓存。
       const deviceInfo = await requestProtocolV2DeviceInfo({
         commands: this.device.commands,
         request: PROTOCOL_V2_DEVICE_INFO_REQUEST,
       });
-      const profile = this.device.applyProfileUpdate(
-        buildProfileFromProtocolV2({
-          deviceInfo,
-          sources: ['deviceInfo'],
-          scope: 'verify',
-          fallbackSerialNo: this.device.originalDescriptor?.path,
-        }),
-        deviceInfo
-      );
-      return pickOnekeyFeatures(
-        buildProtocolV2GetFeaturesPayload(profile, deviceInfo) as OnekeyFeatures
-      );
+      const features = this.device.updateProtocolV2Features(deviceInfo);
+      return pickOnekeyFeatures(features as OnekeyFeatures);
     }
 
     const { message } = await this.device.commands.typedCall('OnekeyGetFeatures', 'OnekeyFeatures');

package/src/api/GetPassphraseState.ts

@@ -16,6 +16,7 @@ export default class GetPassphraseState extends BaseMethod {
         expectPassphraseState: this.payload.passphraseState,
         onlyMainPin: this.payload.useEmptyPassphrase,
         allowCreateAttachPin: this.payload.allowCreateAttachPin,
+        initSession: this.payload.initSession,
       });
 
     const { features } = this.device;
@@ -25,10 +26,12 @@ export default class GetPassphraseState extends BaseMethod {
 
     // refresh device info
     return Promise.resolve({
-      passphrase_state: isProSeries || passphraseProtection === true ? passphraseState : undefined,
-      session_id: newSession ?? features?.session_id ?? undefined,
-      unlocked_attach_pin: unlockedAttachPin ?? features?.unlocked_attach_pin,
-      passphrase_protection: passphraseProtection,
+      passphraseState: isProSeries || passphraseProtection === true ? passphraseState : undefined,
+      sessionId: this.payload.initSession
+        ? newSession ?? undefined
+        : newSession ?? features?.sessionId ?? undefined,
+      unlockedAttachPin: unlockedAttachPin ?? features?.unlockedAttachPin,
+      passphraseProtection,
     });
   }
 }

package/src/api/device/DeviceRebootToBoardloader.ts

@@ -1,4 +1,4 @@
-import { DevRebootType } from '@onekeyfe/hd-transport';
+import { DeviceRebootType } from '@onekeyfe/hd-transport';
 
 import { BaseMethod } from '../BaseMethod';
 
@@ -23,10 +23,10 @@ export default class DeviceRebootToBoardloader extends BaseMethod<RebootToBoardl
   }
 
   async run() {
-    // Protocol V2 submodule firmware uses DevReboot with reboot_type enum.
+    // Protocol V2 submodule firmware uses DeviceReboot with reboot_type enum.
     if (this.device.isProtocolV2()) {
-      const res = await this.device.commands.typedCall('DevReboot', 'Success', {
-        reboot_type: DevRebootType.Boardloader,
+      const res = await this.device.commands.typedCall('DeviceReboot', 'Success', {
+        reboot_type: DeviceRebootType.Romloader,
       });
       return Promise.resolve(res.message);
     }

package/src/api/device/DeviceRebootToBootloader.ts

@@ -1,4 +1,4 @@
-import { DevRebootType } from '@onekeyfe/hd-transport';
+import { DeviceRebootType } from '@onekeyfe/hd-transport';
 
 import { BaseMethod } from '../BaseMethod';
 
@@ -23,10 +23,10 @@ export default class DeviceRebootToBootloader extends BaseMethod<RebootToBootloa
   }
 
   async run() {
-    // Protocol V2 submodule firmware uses DevReboot with reboot_type enum.
+    // Protocol V2 submodule firmware uses DeviceReboot with reboot_type enum.
     if (this.device.isProtocolV2()) {
-      const res = await this.device.commands.typedCall('DevReboot', 'Success', {
-        reboot_type: DevRebootType.Bootloader,
+      const res = await this.device.commands.typedCall('DeviceReboot', 'Success', {
+        reboot_type: DeviceRebootType.Bootloader,
       });
       return Promise.resolve(res.message);
     }

package/src/api/firmware/FirmwareUpdateBaseMethod.ts

@@ -13,6 +13,7 @@ import { DeviceModelToTypes } from '../../types';
 import { DataManager } from '../../data-manager';
 import { BaseMethod } from '../BaseMethod';
 import { DEVICE } from '../../events';
+import { createFirmwareProgressThrottle } from './progressThrottle';
 
 import type {
   IFirmwareUpdateProgressType,
@@ -40,6 +41,8 @@ const isDeviceDisconnectedError = (error: unknown) => {
 export class FirmwareUpdateBaseMethod<Params> extends BaseMethod<Params> {
   checkPromise: Deferred<any> | null = null;
 
+  private shouldPostFirmwareProgress = createFirmwareProgressThrottle();
+
   init(): void {}
 
   run(): Promise<any> {
@@ -83,6 +86,10 @@ export class FirmwareUpdateBaseMethod<Params> extends BaseMethod<Params> {
    * @param progress Post the percentage of the progress
    */
   postProgressMessage = (progress: number, progressType: IFirmwareUpdateProgressType) => {
+    if (!this.shouldPostFirmwareProgress(progress, progressType)) {
+      return;
+    }
+
     this.postMessage(
       createUiMessage(UI_REQUEST.FIRMWARE_PROGRESS, {
         device: this.device.toMessageObject() as KnownDevice,
@@ -138,6 +145,8 @@ export class FirmwareUpdateBaseMethod<Params> extends BaseMethod<Params> {
     // check device goto bootloader mode
     let isFirstCheck = true;
     let checkCount = 0;
+    let hasPromptedWebDevice = false;
+    let isPromptingWebDevice = false;
     // eslint-disable-next-line prefer-const
     let timeoutTimer: ReturnType<typeof setTimeout> | undefined;
 
@@ -158,23 +167,28 @@ export class FirmwareUpdateBaseMethod<Params> extends BaseMethod<Params> {
         if (
           checkCount > 4 &&
           DataManager.isBrowserWebUsb(DataManager.getSettings('env')) &&
-          !this.payload.skipWebDevicePrompt
+          !this.payload.skipWebDevicePrompt &&
+          !hasPromptedWebDevice &&
+          !isPromptingWebDevice
         ) {
-          clearInterval(intervalTimer);
-          clearTimeout(timeoutTimer);
-
+          isPromptingWebDevice = true;
           try {
             this.postTipMessage(FirmwareUpdateTipMessage.SelectDeviceInBootloaderForWebDevice);
             const confirmed = await this._promptDeviceInBootloaderForWebDevice();
+            hasPromptedWebDevice = true;
             if (confirmed) {
               await this._checkDeviceInBootloaderMode(connectId, intervalTimer, timeoutTimer);
             }
           } catch (e) {
+            clearInterval(intervalTimer);
+            clearTimeout(timeoutTimer);
             Log.log(
               'FirmwareUpdateBaseMethod [checkDeviceToBootloader] _promptDeviceInBootloaderForWebDevice failed: ',
               e
             );
             this.checkPromise?.reject(e);
+          } finally {
+            isPromptingWebDevice = false;
           }
           return;
         }

package/src/api/firmware/bootloaderHelper.ts

@@ -1,7 +1,7 @@
 import semver from 'semver';
 import { EDeviceType } from '@onekeyfe/hd-shared';
 
-import { getDeviceType } from '../../utils';
+import { getDeviceBootloaderVersion, getDeviceType } from '../../utils';
 
 import type { Features, IVersionArray } from '../../types';
 
@@ -38,9 +38,10 @@ export function shouldUpdateBootloaderForClassicAndMini({
 export function isEnteredManuallyBoot(features: Features, updateType: string) {
   const deviceType = getDeviceType(features);
   const isMini = deviceType === EDeviceType.Mini;
+  const bootloaderVersion = getDeviceBootloaderVersion(features).join('.');
   const isBoot183ClassicUpBle =
     updateType === 'firmware' &&
     deviceType === EDeviceType.Classic &&
-    features.bootloader_version === '1.8.3';
+    bootloaderVersion === '1.8.3';
   return isMini || isBoot183ClassicUpBle;
 }

package/src/api/firmware/getBinary.ts

@@ -41,7 +41,7 @@ export const getBinary = async ({
   }
 
   if (version && !semver.eq(releaseInfo.version.join('.'), version.join('.'))) {
-    const touchWithoutVersion = getDeviceType(features) === 'touch' && !features.onekey_version;
+    const touchWithoutVersion = getDeviceType(features) === 'touch' && !features.firmwareVersion;
     if (!touchWithoutVersion) {
       throw ERRORS.TypedError(HardwareErrorCode.RuntimeError, 'firmware version mismatch');
     }

package/src/api/firmware/progressThrottle.ts

@@ -0,0 +1,44 @@
+import type { IFirmwareUpdateProgressType } from '../../events/ui-request';
+
+const DEFAULT_FIRMWARE_PROGRESS_INTERVAL_MS = 250;
+
+type FirmwareProgressThrottleState = {
+  lastEmittedAt: number;
+  lastProgress?: number;
+};
+
+export const createFirmwareProgressThrottle = (
+  intervalMs = DEFAULT_FIRMWARE_PROGRESS_INTERVAL_MS
+) => {
+  const stateByType = new Map<IFirmwareUpdateProgressType, FirmwareProgressThrottleState>();
+
+  return (progress: number, progressType: IFirmwareUpdateProgressType) => {
+    if (progressType !== 'transferData') {
+      return true;
+    }
+
+    const normalizedProgress = Math.max(0, Math.min(100, Math.floor(progress)));
+    if (normalizedProgress === 0 || normalizedProgress === 100) {
+      stateByType.set(progressType, {
+        lastEmittedAt: Date.now(),
+        lastProgress: normalizedProgress,
+      });
+      return true;
+    }
+
+    const now = Date.now();
+    const state = stateByType.get(progressType);
+    if (
+      state &&
+      (state.lastProgress === normalizedProgress || now - state.lastEmittedAt < intervalMs)
+    ) {
+      return false;
+    }
+
+    stateByType.set(progressType, {
+      lastEmittedAt: now,
+      lastProgress: normalizedProgress,
+    });
+    return true;
+  };
+};

package/src/api/firmware/releaseHelper.ts

@@ -12,7 +12,7 @@ export const getFirmwareReleaseInfo = (features: Features, firmwareType: EFirmwa
   const firmwareStatus = DataManager.getFirmwareStatus(features, firmwareType);
   const changelog = DataManager.getFirmwareChangelog(features, firmwareType);
   const release = DataManager.getFirmwareLatestRelease(features, firmwareType);
-  const bootloaderMode = !!features.bootloader_mode;
+  const bootloaderMode = !!features.bootloaderMode;
   return {
     status: firmwareStatus,
     changelog,
@@ -25,7 +25,7 @@ export const getBleFirmwareReleaseInfo = (features: Features) => {
   const firmwareStatus = DataManager.getBLEFirmwareStatus(features);
   const changelog = DataManager.getBleFirmwareChangelog(features);
   const release = DataManager.getBleFirmwareLatestRelease(features);
-  const bootloaderMode = !!features.bootloader_mode;
+  const bootloaderMode = !!features.bootloaderMode;
   return {
     status: firmwareStatus,
     changelog,
@@ -52,7 +52,7 @@ export const getBootloaderReleaseInfo = ({
       Object.prototype.hasOwnProperty.call(item, 'en-US')
   );
 
-  const bootloaderMode = !!features.bootloader_mode;
+  const bootloaderMode = !!features.bootloaderMode;
 
   let shouldUpdate = false;
 

package/src/api/firmware/uploadFirmware.ts

@@ -9,6 +9,7 @@ import { DeviceModelToTypes } from '../../types';
 import { bytesToHex } from '../helpers/hexUtils';
 import { DataManager } from '../../data-manager';
 import { DevicePool } from '../../device/DevicePool';
+import { buildProtocolV1FeaturesPayload } from '../../deviceProfile';
 
 import type { KnownDevice } from '../../types';
 import type { TypedCall, TypedResponseMessage } from '../../device/DeviceCommands';
@@ -34,7 +35,7 @@ const isDeviceDisconnectedError = (error: unknown) => {
 
 const postConfirmationMessage = (device: Device) => {
   // only if firmware is already installed. fresh device does not require button confirmation
-  if (device.features?.firmware_present) {
+  if (device.features?.firmwarePresent) {
     device.emit(DEVICE.BUTTON, device, { code: 'ButtonRequest_FirmwareUpdate' });
   }
 };
@@ -109,7 +110,9 @@ export const uploadFirmware = async (
 
     if (isFirmware && !isUpdateBootloader) {
       const newFeatures = await typedCall('GetFeatures', 'Features', {});
-      const deviceBootloaderVersion = getDeviceBootloaderVersion(newFeatures.message).join('.');
+      const deviceBootloaderVersion = getDeviceBootloaderVersion(
+        buildProtocolV1FeaturesPayload(newFeatures.message, device.features)
+      ).join('.');
       const supportUpgradeFileHeader = semver.gte(deviceBootloaderVersion, '2.1.0');
       Log.debug('supportUpgradeFileHeader:', supportUpgradeFileHeader);
 

package/src/api/index.ts

@@ -7,6 +7,7 @@ export { default as getDeviceInfo } from './GetDeviceInfo';
 export { default as getOnekeyFeatures } from './GetOnekeyFeatures';
 export { default as getPassphraseState } from './GetPassphraseState';
 export { default as getLogs } from './GetLogs';
+export { default as clearSessionCache } from './ClearSessionCache';
 export { default as checkFirmwareRelease } from './CheckFirmwareRelease';
 export { default as checkBLEFirmwareRelease } from './CheckBLEFirmwareRelease';
 export { default as checkBridgeStatus } from './CheckBridgeStatus';
@@ -43,20 +44,17 @@ export { default as firmwareUpdateV4 } from './FirmwareUpdateV4';
 export { default as promptWebDeviceAccess } from './PromptWebDeviceAccess';
 
 // File system & device control API (Protocol V2 only)
-export { default as getProtoVersion } from './protocol-v2/GetProtoVersion';
+export { default as protocolInfoRequest } from './protocol-v2/ProtocolInfoRequest';
 export { default as ping } from './protocol-v2/Ping';
 export { default as deviceReboot } from './protocol-v2/DeviceReboot';
-export { default as deviceGetDeviceInfo } from './protocol-v2/DeviceGetDeviceInfo';
-export { default as deviceGetOnboardingStatus } from './protocol-v2/DeviceGetOnboardingStatus';
+export { default as deviceInfoGet } from './protocol-v2/DeviceInfoGet';
+export { default as deviceStatusGet } from './protocol-v2/DeviceStatusGet';
+export { default as deviceSessionGet } from './protocol-v2/DeviceSessionGet';
 export { default as deviceFirmwareUpdate } from './protocol-v2/DeviceFirmwareUpdate';
 export { default as deviceGetFirmwareUpdateStatus } from './protocol-v2/DeviceGetFirmwareUpdateStatus';
-export { default as devReboot } from './protocol-v2/DevReboot';
-export { default as devGetDeviceInfo } from './protocol-v2/DeviceGetDeviceInfo';
-export { default as devFirmwareUpdate } from './protocol-v2/DeviceFirmwareUpdate';
-export { default as devGetFirmwareUpdateStatus } from './protocol-v2/DeviceGetFirmwareUpdateStatus';
-export { default as factoryDeviceInfoSettings } from './protocol-v2/FactoryDeviceInfoSettings';
-export { default as factoryGetDeviceInfo } from './protocol-v2/FactoryGetDeviceInfo';
-export { default as filesystemFixPermission } from './protocol-v2/FilesystemFixPermission';
+export { default as deviceFactoryInfoSet } from './protocol-v2/DeviceFactoryInfoSet';
+export { default as deviceFactoryInfoGet } from './protocol-v2/DeviceFactoryInfoGet';
+export { default as filesystemPermissionFix } from './protocol-v2/FilesystemPermissionFix';
 export { default as filesystemFormat } from './protocol-v2/FilesystemFormat';
 export { default as filesystemDiskControl } from './protocol-v2/FilesystemDiskControl';
 export { default as fileRead } from './FileRead';

package/src/api/protocol-v2/{FactoryGetDeviceInfo.ts → DeviceFactoryInfoGet.ts}

@@ -1,6 +1,6 @@
 import { BaseMethod } from '../BaseMethod';
 
-export default class FactoryGetDeviceInfo extends BaseMethod {
+export default class DeviceFactoryInfoGet extends BaseMethod {
   init() {
     // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
     this.requireProtocolV2 = true;
@@ -11,8 +11,8 @@ export default class FactoryGetDeviceInfo extends BaseMethod {
 
   async run() {
     const res = await this.device.commands.typedCall(
-      'FactoryGetDeviceInfo',
-      'FactoryDeviceInfo',
+      'DeviceFactoryInfoGet',
+      'DeviceFactoryInfo',
       {}
     );
     return Promise.resolve(res.message);

package/src/api/protocol-v2/DeviceFactoryInfoSet.ts

@@ -0,0 +1,32 @@
+import { BaseMethod } from '../BaseMethod';
+
+import type { DeviceFactoryInfoSetParams } from './helpers';
+
+export default class DeviceFactoryInfoSet extends BaseMethod<DeviceFactoryInfoSetParams> {
+  init() {
+    // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
+    this.requireProtocolV2 = true;
+    this.skipForceUpdateCheck = true;
+    this.useDevicePassphraseState = false;
+    this.params = {
+      version: this.payload.version,
+      serial_number: this.payload.serial_number,
+      burn_in_completed: this.payload.burn_in_completed,
+      factory_test_completed: this.payload.factory_test_completed,
+      manufacture_time: this.payload.manufacture_time,
+    };
+  }
+
+  async run() {
+    const res = await this.device.commands.typedCall('DeviceFactoryInfoSet', 'Success', {
+      info: {
+        version: this.params.version,
+        serial_number: this.params.serial_number,
+        burn_in_completed: this.params.burn_in_completed,
+        factory_test_completed: this.params.factory_test_completed,
+        manufacture_time: this.params.manufacture_time,
+      },
+    });
+    return Promise.resolve(res.message);
+  }
+}

package/src/api/protocol-v2/DeviceFirmwareUpdate.ts

@@ -29,7 +29,7 @@ export default class DeviceFirmwareUpdate extends BaseMethod<DeviceFirmwareUpdat
     const targets = normalizeFirmwareTargets(this.params);
     try {
       const res = await this.device.commands.typedCall(
-        'DevFirmwareUpdate',
+        'DeviceFirmwareUpdateRequest',
         PROTOCOL_V2_FIRMWARE_UPDATE_RESPONSE_TYPES,
         {
           targets,
@@ -37,13 +37,11 @@ export default class DeviceFirmwareUpdate extends BaseMethod<DeviceFirmwareUpdat
         {
           ...PROTOCOL_V2_FIRMWARE_UPDATE_OPTIONS,
           onIntermediateResponse: (response: MessageFromOneKey) => {
-            if (response.type !== 'DevFirmwareInstallProgress') return;
-            const progress = Number(response.message?.progress);
-            if (!Number.isFinite(progress)) return;
+            if (response.type !== 'DeviceFirmwareUpdateStatus') return;
             this.postMessage(
               createUiMessage(UI_REQUEST.FIRMWARE_PROGRESS, {
                 device: this.device.toMessageObject() as KnownDevice,
-                progress: Math.min(Math.max(progress, 0), 100),
+                progress: 99,
                 progressType: 'installingFirmware',
               })
             );

package/src/api/protocol-v2/DeviceGetFirmwareUpdateStatus.ts

@@ -1,19 +1,53 @@
 import { BaseMethod } from '../BaseMethod';
+import { invalidParameter } from '../helpers/filesystemValidation';
 
-export default class DeviceGetFirmwareUpdateStatus extends BaseMethod {
+import type { DeviceFirmwareUpdateStatusGetParams } from './helpers';
+import type { DeviceFirmwareUpdateRecordFields } from '@onekeyfe/hd-transport';
+
+const DEVICE_FIRMWARE_UPDATE_STATUS_FIELDS = ['status', 'payload_version', 'path'] as const;
+
+function normalizeStatusFields(
+  fields: DeviceFirmwareUpdateStatusGetParams['fields']
+): DeviceFirmwareUpdateRecordFields | undefined {
+  if (fields === undefined || fields === null) return undefined;
+  if (typeof fields !== 'object' || Array.isArray(fields)) {
+    throw invalidParameter('Parameter [fields] must be an object.');
+  }
+
+  const unknownField = Object.keys(fields).find(
+    field => !DEVICE_FIRMWARE_UPDATE_STATUS_FIELDS.includes(field as any)
+  );
+  if (unknownField) {
+    throw invalidParameter(`Unsupported firmware update status field: ${unknownField}`);
+  }
+
+  const normalized: DeviceFirmwareUpdateRecordFields = {};
+  for (const field of DEVICE_FIRMWARE_UPDATE_STATUS_FIELDS) {
+    const value = fields[field];
+    if (value === undefined) continue;
+    if (typeof value !== 'boolean') {
+      throw invalidParameter(`Parameter [fields.${field}] must be a boolean.`);
+    }
+    normalized[field] = value;
+  }
+  return normalized;
+}
+
+export default class DeviceGetFirmwareUpdateStatus extends BaseMethod<DeviceFirmwareUpdateStatusGetParams> {
   init() {
     // Protocol V2 (Pro2) 专属方法，core 调度层统一做非 V2 设备守卫
     this.requireProtocolV2 = true;
     this.skipForceUpdateCheck = true;
     this.useDevicePassphraseState = false;
-    this.params = undefined;
+    const fields = normalizeStatusFields(this.payload.fields);
+    this.params = fields ? { fields } : {};
   }
 
   async run() {
     const res = await this.device.commands.typedCall(
-      'DevGetFirmwareUpdateStatus',
-      'DevFirmwareUpdateStatus',
-      {}
+      'DeviceFirmwareUpdateStatusGet',
+      'DeviceFirmwareUpdateStatus',
+      this.params
     );
     return Promise.resolve(res.message);
   }