Firmware-Update

Wählen Sie die Update-API anhand der Protokollfamilie, nicht allein anhand des Marketingnamens. Hardware SDK 1.2.0 bietet eine gemeinsame JavaScript-Oberfläche; das Geräteprotokoll bestimmt, welche Methode gültig ist.

Bestätigen Sie das aktive Protokoll mit connectProtocol im Geräteobjekt oder über getDeviceState. Verzweigen Sie nicht anhand von USB-PID oder BLE-Namen. Siehe Geräte und Protocol V1 und V2.

Starten Sie ein Update erst, nachdem der Nutzer das Zielgerät ausgewählt und den Vorgang genehmigt hat. Verwenden Sie offizielle Release-Metadaten und geprüfte Artefakte für dieses Modell; eine Beispielversion darf niemals die zu installierende Firmware bestimmen.

1. Prüfen, ob ein Update erforderlich ist

const release = await HardwareSDK.checkFirmwareRelease(connectId);
if (!release.success) throw new Error(release.payload.error);
 
// payload.status: 'valid' | 'outdated' | 'required' | 'unknown' | 'none'
const updateAvailable = release.payload !== null &&
  (release.payload.status === 'outdated' || release.payload.status === 'required');
// Offer an update only when updateAvailable is true and release metadata exists.

BLE-Koprozessor: checkBLEFirmwareRelease. Abonnieren Sie FIRMWARE_EVENT (RELEASE_INFO / BLE_RELEASE_INFO), wenn Sie später darauf hinweisen möchten, statt die erste Verbindung zu blockieren.

2. Fortschritt vor dem Update-Aufruf abonnieren

import { UI_EVENT, UI_REQUEST } from '@onekeyfe/hd-core';
 
HardwareSDK.on(UI_EVENT, (msg) => {
  if (
    msg.type === UI_REQUEST.FIRMWARE_PROGRESS ||
    msg.type === UI_REQUEST.FIRMWARE_TIP ||
    msg.type === UI_REQUEST.FIRMWARE_PROCESSING
  ) {
    renderFirmwareProgress(msg.payload);
  }
  // firmwareUpdateV4 may emit REQUEST_BUTTON with reason 'firmware-update'.
  // Show "confirm on device". Do not uiResponse() that hint.
});

3. Passende Methode aufrufen

Classic / Mini / Touch. Wählen Sie das Ziel aus geprüften Release-Metadaten für das verbundene Modell:

declare const targetFirmwareVersion: number[];
const result = await HardwareSDK.firmwareUpdateV2(connectId, {
  platform: 'web',
  updateType: 'firmware',
  version: targetFirmwareVersion,
});
if (!result.success) throw new Error(result.payload.error);

Pro:

declare const targetFirmwareVersion: number[];
const result = await HardwareSDK.firmwareUpdateV3(connectId, {
  platform: 'desktop',
  firmwareVersion: targetFirmwareVersion,
});
if (!result.success) throw new Error(result.payload.error);

Pro 2 / Neo — bereits geprüfte Binärdateien übergeben:

const result = await HardwareSDK.firmwareUpdateV4(connectId, {
  platform: 'desktop',
  bootloaderBinary,
  applicationP1Binary,
  applicationP2Binary,
  coprocessorBinary,
  resourceArchiveBinary,
});
if (!result.success) throw new Error(result.payload.error);

platform ist für alle drei Methoden erforderlich: 'native' | 'desktop' | 'ext' | 'web' | 'web-embed'.

4. Nach dem Aufruf

1. Das Gerät kann neu starten. Warten Sie auf DEVICE.CONNECT (oder suchen Sie erneut). Bei normaler Wiederverbindung bleibt das bestätigte Protokoll erhalten. Siehe Verbindungsabbrüche und Wiederverbindung.
2. Erneut lesen: getDeviceState (scope: 'firmware', wenn Sie Versionen benötigen), bevor Sie dem neuen Build vertrauen.
3. Wenn der Aufruf mit einer Transportzeitüberschreitung fehlschlägt, nachdem die Installationsanfrage gesendet wurde, wiederholen Sie nicht dasselbe Update. Stellen Sie die Verbindung wieder her, lesen Sie den Status und entscheiden Sie dann.

Nicht tun:

• firmwareUpdateV3 auf Pro 2 / Neo oder firmwareUpdateV4 auf Classic / Pro aufrufen.
• Ein Update nach Trennung oder Zeitüberschreitung automatisch wiederholen.
• BLE-retryCount-Hilfsfunktionen per Spread an Update-Aufrufe übergeben.
• Romloader installieren über firmwareUpdateV4.

Weiter

• firmwareUpdateV2
• firmwareUpdateV3
• firmwareUpdateV4
• Core-API-Anleitung → Ereignisse