dfu-tool – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

dfu-tool – Tool zur Aktualisierung der Geräte-Firmware

ZUSAMMENFASSUNG

dfu-tool [ - ausführlich ] [ --Version ] [ --Macht ] [ --device=VID:PID ] [ --überweisen-
Größe=BYTES ]

BESCHREIBUNG

Diese Handbuchseite dokumentiert kurz die dfu-tool Befehl.

dfu-tool ermöglicht es einem Benutzer, verschiedene Arten von Firmware auf Geräte zu schreiben, die USB unterstützen
Protokoll zur Aktualisierung der Geräte-Firmware. Mit diesem Tool kann das Gerät vom umgeschaltet werden
vom normalen Laufzeitmodus in den „DFU-Modus“, der es dem Benutzer ermöglicht, Firmware zu lesen und zu schreiben.
Entweder kann das gesamte Gerät in einem Vorgang beschrieben werden, oder es können einzelne „Ziele“ beschrieben werden
mit dem alternativen Namen oder der alternativen Nummer angegeben.

dfu-tool verwendet die gemeinsam genutzte Bibliothek libdfu, um Aktionen auszuführen. Alle Synchronaktionen können
kann sicher abgebrochen werden und bei einem Fehler werden Fehler mit einem Typ und einem vollständigen Text zurückgegeben
Beschreibung. libdfu unterstützt DFU 1.0, DFU 1.1 und die ST DfuSe-Anbietererweiterung und
Bewältigt viele Geräte-„Macken“, die für die reale Implementierung von DFU erforderlich sind.

zusätzlich dfu-tool kann zum Konvertieren von Firmware aus verschiedenen Formaten verwendet werden, oder
um Details zu den in der Firmware enthaltenen Elementen, Bildern und Metadaten zu ändern
Datei. Sie können beispielsweise die DFU 1.1-Firmware problemlos in das herstellerspezifische DfuSe konvertieren
Formatieren, eine Intel HEX-Datei in eine auf eine bestimmte Größe aufgefüllte Rohdatei konvertieren oder eine neue hinzufügen
Urheberrechts- und Lizenzinformationen zu einer vorhandenen Datei hinzufügen. Felder wie der Lieferant und
Produkt-IDs können geändert werden und die Firmware-Elemente können mit ver- und entschlüsselt werden
verschiedene Methoden. Es ist jedoch auch möglich, zwei DfuSe-Dateien zusammenzuführen
Es ist eine gute Idee, vor dem Zusammenführen unterschiedliche Alt-Setting-Nummern anzugeben, um Verwirrung zu vermeiden.

Obwohl dfu-tool versucht, eine große Anzahl benutzerfreundlicher Befehle bereitzustellen, möglicherweise nur
Es ist möglich, bestimmte Vorgänge direkt mit der libdfu-Bibliothek auszuführen. Das ist einfacher als
Es hört sich an, da die Bibliothek mit GObject Introspection-Unterstützung erstellt wurde, sodass sie in verwendet werden kann
viele Sprachen wie C, Javascript und Python. Darüber hinaus ist die Nutzung der Bibliothek eine gute Sache
Idee, wenn Sie mehrere Vorgänge an großen Firmware-Dateien ausführen möchten, z. B.
Konvertieren aus einer Intel HEX-Datei, Auffüllen auf eine bestimmte Größe, Festlegen des Anbieters und Hinzufügen
Lizenzinformationen und anschließendes Speichern an einem Remote-Standort.

OPTIONAL

Dieses Programm folgt der üblichen GNU-Befehlszeilensyntax, mit langen Optionen beginnend mit
zwei Bindestriche (-). Nachfolgend finden Sie eine Zusammenfassung der Optionen.

--help
Zusammenfassung aller zur Verwendung verfügbaren Befehle anzeigen.

--Version
Zeigt die Version von an dfu-tool installiert.

- ausführlich
Zusätzliche Debugging-Informationen anzeigen.

--device=VID:PID
Wenn mehrere DFU-fähige Geräte angeschlossen sind, können Sie den spezifischen Anbieter angeben
und Produkt-ID des DFU-Geräts, das Sie abfragen möchten.

--transfer-size=BYTES
Überschreiben Sie die Größe jeder USB-Übertragung manuell, was möglicherweise unzuverlässig ist
Hardware oder wenn das Gerät bei der maximalen Paketgröße liegt, die es akzeptiert.

--Macht
Erzwingen Sie den Vorgang und ignorieren Sie Warnungen oder Plausibilitätsprüfungen wie Datei-CRC und
Prüfsummen. Dies ist nützlich, wenn Sie wirklich wissen, was Sie tun, oder in der
Spezialfall des Fuzz-Testens von libdfu.

DEVICE BEFEHLE

Diese Befehle werden zur Verbindung mit DFU-fähigen Geräten verwendet.

Liste
Dieser Befehl listet aktuell angeschlossene DFU-fähige Geräte auf. Bei einigen Geräten ist dies nicht der Fall
unterstützen den offiziellen DFU-Laufzeitmodus und unterstützen daher nicht die Verwendung der automatischen Erkennung
diesen Befehl. Bei diesen Geräten müssen Sie das Gerät manuell in den DFU-Modus versetzen (z. B
indem Sie beim Neustart des Geräts eine Taste gedrückt halten) wird es hier angezeigt.

DETACH
Dieser Befehl trennt das aktuell angeschlossene DFU-fähige Gerät von einem speziellen Gerät
Programmiermodus. Während sich das Gerät in diesem speziellen DFU-Modus befindet, kann es nicht verwendet werden
als normales Gerät. Beispielsweise akzeptiert ein Drucker im DFU-Modus keine Dokumente
Modus arbeiten können.

anhängen
Dieser Befehl verbindet ein DFU-fähiges Gerät wieder mit der Laufzeit, sodass es als verwendet werden kann
normales Gerät. Einige Geräte unterstützen das Anschließen nicht und müssen manuell vorgenommen werden
getrennt und wieder angeschlossen werden, bevor der Modus geändert wird.

ZEIT FÜR STORYTELLING
Dieser Befehl überwacht den Hotplug von DFU-Geräten und kann zur Überprüfung von libdfu verwendet werden
Gleicht die Laufzeit- und DFU-Modi beim Anschließen und Trennen an. Verwenden STRG + C zu
Lassen Sie diesen Befehl beenden.

lesen DATEINAME
Dieser Befehl lädt die gesamte Firmware vom Gerät in eine Datei hoch. Wenn das Gerät hat
Wenn mehrere Partitionen als unterschiedliche alternative Abschnitte exportiert werden, werden sie alle exportiert
in eine Multi-Image-Datei im DfuSe-Format eingelesen werden. Wenn Sie nur den Inhalt eines davon möchten
Partition, read-alt ist der gewünschte Befehl.

read-alt DATEINAME GERÄTE-ALT-NAME|GERÄTE-ALT-ID
Dieser Befehl lädt Firmware von einer Partition in eine Datei hoch. Sie können die angeben
Partitionieren Sie entweder nach der ALT-ID oder dem ALT-NAME, falls festgelegt.

z.B dfu-tool read-alt backup.dfu SRAM

schreiben
Dieser Befehl lädt Firmware aus einer Datei in alle möglichen Partitionen einer Datei herunter
Gerät. Wenn Sie nur eine Partition schreiben möchten, write-alt ist der Befehl, den du hast
wollen.

write-alt DATEINAME GERÄTE-ALT-NAME|GERÄTE-ALT-ID [BILD-ALT-NAME|BILD-ALT-ID]
Dieser Befehl lädt Firmware aus der Datei in eine Partition herunter. Sie können angeben
die Partition entweder über die ALT-ID oder den ALT-NAME, falls festgelegt.

z.B dfu-tool write-alt sram.dfu SRAM __SRAM

FIRMWARE BEFEHLE

Diese Befehle werden zum Lesen und Ändern vorhandener Firmware-Dateien verwendet.

abladen DATEINAME
Dieser Befehl gibt alle bekannten Details zu einer Firmware-Datei aus. Die komplette Speicherkarte
wird zusammen mit allen Metadaten oder Herstellerinformationen zur Firmware-Datei angezeigt.

verkaufen FORMAT DATEI IN DATEI-AUS [GRÖSSE]
Dieser Befehl konvertiert die Firmware von einem Format in ein anderes, optional mit Padding
auf eine bestimmte Größe. Mögliche Werte für das Ziel FORMAT umfassen: raw, ihex,
dfu und dfuse. Der DATEI IN und DATEI-AUS Die Werte können mit denen der Quelldatei identisch sein
soll überschrieben werden. Obwohl das Auffüllen die Dateigröße erhöht, ohne dass dies erkennbar ist
Vorteile: Es kann zur Unterstützung von Geräten verwendet werden, die das Laufzeitbild nicht speichern
Größe und wo eine Validierung der geschriebenen Firmware erforderlich ist.

z.B dfu-tool verkaufen dfu Firmware.hex Firmware.dfu 8000

verschlüsseln DATEINAME-IN DATEINAME-OUT TYP WESENTLICHE
Dieser Befehl verschlüsselt Firmware-Daten. Lediglich die Bildinhalte sind tatsächlich vorhanden
geändert, die DFU-Fußzeile und die DfuSe-Kopfzeile bleiben unverändert. Mögliche Werte für
das Ziel TYP umfassen: xtea und nop. Wenn die WESENTLICHE ist nicht erforderlich
Länge wird als Eingabe für eine Hash-Funktion verwendet, die einen Schlüssel des erzeugen kann
erforderliche Größe.

z.B dfu-tool verschlüsseln Firmware.dfu Firmware.xdfu xTee Deadbeef

entschlüsseln DATEINAME-IN DATEINAME-OUT TYP WESENTLICHE
Dieser Befehl entschlüsselt Firmware-Daten. Lediglich die Bildinhalte sind tatsächlich vorhanden
geändert, die DFU-Fußzeile und die DfuSe-Kopfzeile bleiben unverändert. Mögliche Werte für
das Ziel TYP umfassen: xtea und nop. Wenn die WESENTLICHE ist nicht erforderlich
Länge wird als Eingabe für eine Hash-Funktion verwendet, die einen Schlüssel des erzeugen kann
erforderliche Größe.

z.B dfu-tool entschlüsseln Firmware.xdfu Firmware.dfu xTee Deadbeef

fusionieren DATEI-AUS FILE1 FILE2 [DATEI3...]
Dieser Befehl führt mehrere Firmware-Dateien zu einer Datei zusammen. Obwohl Sie zusammenführen können
Dateien mit derselben ALT-ID oder demselben ALT-NAMEn erstellen, ist dies wahrscheinlich nicht das, was Sie tun möchten.

z.B dfu-tool fusionieren kombiniert.dfu lib.dfu app.dfu

set-alt-setting FILE ALT-ID
Dieser Befehl ändert die alternative Nummer in der Firmware-Datei.

z.B dfu-tool set-alt-setting Firmware.dfu 1

set-alt-setting-name
Dieser Befehl ändert den alternativen Namen in der Firmware-Datei.

z.B dfu-tool set-alt-setting-name Firmware.dfu SRAM

Set-Metadaten FILE WESENTLICHE BEWERTUNG
Dieser Befehl fügt einer Firmware-Datei vorhandene Metadaten hinzu oder ändert sie. HINWEIS: Es gibt
In DFU-Dateien ist nur sehr begrenzter Speicherplatz für Metadaten vorhanden, daher sollten Schlüssel und Werte vorhanden sein
so kurz wie möglich gehalten. Insbesondere sollte der Lizenzwert in angegeben werden
SPDX-Format.

z.B dfu-tool Set-Metadaten Firmware.dfu Lizenz GPL-2.0+

Set-Anbieter FILE VID
Dieser Befehl legt die Hersteller-ID einer Firmware-Datei fest, die für den Abgleich mit bestimmten Geräten verwendet wird
Geräte. Die Werte von ffff stimmen mit jedem Gerätehersteller überein.

z.B dfu-tool Set-Anbieter Firmware.dfu 273f

Set-Produkt FILE PID
Dieser Befehl legt die Produkt-ID in einer Firmware-Datei fest, die für den Abgleich verwendet wird
bestimmte Geräte. Die Werte von ffff passen zu jedem Geräteprodukt.

z.B dfu-tool Set-Produkt Firmware.dfu 1004

Set-Release FILE Loslassen
Dieser Befehl legt die Release-Version der Firmware-Datei fest, die für den Abgleich verwendet wird
bestimmte Geräte. Die Werte von ffff entsprechen jeder Geräteversion.

z.B dfu-tool Set-Release Firmware.dfu ffff

Nutzen Sie dfu-tool online über die Dienste von onworks.net