dfu-tool - Online în cloud

PROGRAM:

NUME

dfu-tool - Instrument de actualizare a firmware-ului dispozitivului

REZUMAT

dfu-instrument [ --verbos ] [ --versiune ] [ --forta ] [ --device=VID:PID ] [ --transfer-
dimensiune=BYTES ]

DESCRIERE

Această pagină de manual documentează pe scurt dfu-instrument comanda.

dfu-instrument permite unui utilizator să scrie diferite tipuri de firmware pe dispozitivele care acceptă USB
Protocolul de actualizare a firmware-ului dispozitivului. Acest instrument poate fi folosit pentru a comuta dispozitivul de la
modul normal de rulare la „modul DFU”, care permite utilizatorului să citească și să scrie firmware.
Fie întregul dispozitiv poate fi scris într-o singură operație, fie „ținte” individuale pot fi
specificat cu numele sau numărul alternativ.

dfu-instrument folosește biblioteca partajată libdfu pentru a efectua acțiuni. Toate acțiunile sincrone pot
să fie anulat în siguranță și în caz de eșec va returna erori atât cu un tip, cât și cu un text complet
Descriere. libdfu acceptă DFU 1.0, DFU 1.1 și extensia furnizorului ST DfuSe și
se ocupă de multe „quirks” ale dispozitivului necesare pentru implementările în lumea reală a DFU.

În plus, dfu-instrument poate fi folosit pentru a converti firmware din diferite formate sau
pentru a modifica detalii despre elementele, imaginile și metadatele conținute în interiorul firmware-ului
fişier. De exemplu, puteți converti cu ușurință firmware-ul DFU 1.1 în DfuSe specific furnizorului
format, convertiți un fișier Intel HEX într-un fișier brut căptușit la o anumită dimensiune sau adăugați un fișier nou
informații privind drepturile de autor și licențierea unui fișier existent. Câmpuri precum vânzătorul și
ID-urile produsului pot fi modificate, iar elementele firmware pot fi criptate și decriptate folosind
diverse metode diferite. Unirea a două fișiere DfuSe este, de asemenea, posibilă, deși
specificarea diferitelor numere de setare alternativă înainte de îmbinare este o idee bună pentru a evita confuzia.

Cu toate ca dfu-instrument încearcă să ofere un număr mare de comenzi ușor de utilizat, poate doar să fie
este posibil să faceți anumite operațiuni folosind direct biblioteca libdfu. Acest lucru este mai ușor decât
Sună, deoarece biblioteca este construită cu suport GObject Introspection, făcând-o utilizabilă în
multe limbaje precum C, Javascript și Python. În plus, folosirea bibliotecii este un lucru bun
idee dacă doriți să efectuați mai multe operații pe fișiere de firmware mari, de exemplu,
conversia dintr-un fișier Intel HEX, completarea la o anumită dimensiune, setarea furnizorului și adăugarea
informații de licențiere și apoi salvarea într-o locație la distanță.

OPŢIUNI

Acest program urmează sintaxa obișnuită a liniei de comandă GNU, cu opțiuni lungi începând cu
două liniuțe (-). Un rezumat al opțiunilor este inclus mai jos.

--Ajutor
Afișați rezumatul tuturor comenzilor disponibile pentru utilizare.

--versiune
Arată versiunea de dfu-instrument instalat.

--verbos
Afișați informații suplimentare de depanare.

--device=VID:PID
Dacă sunt atașate mai multe dispozitive compatibile cu DFU, puteți specifica furnizorul specific
și ID-ul produsului al dispozitivului DFU pe care doriți să îl interogați.

--transfer-size=BYTES
Suprascrieți manual dimensiunea fiecărui transfer USB, pe care s-ar putea să-l doriți pentru nesigur
hardware sau când dispozitivul se află la dimensiunea maximă a pachetului pe care o acceptă.

--forta
Forțați operațiunea, ignorând avertismentele sau verificările de sănătate, cum ar fi fișierul CRC și
sume de control. Acest lucru este util dacă știți cu adevărat ce faceți sau în
caz specializat de testare fuzz libdfu.

DISPOZITIV COMANDE

Aceste comenzi sunt folosite pentru a interfața cu dispozitivele compatibile cu DFU.

listă
Această comandă listează dispozitivele DFU atașate în prezent. Unele dispozitive nu
acceptă modul de rulare oficial DFU și, prin urmare, nu acceptă utilizarea auto-descoperirii
această comandă. Pentru acele dispozitive, punerea manuală a dispozitivului în modul DFU (de ex
ținând apăsat un buton când reporniți dispozitivul) îl va face să apară aici.

DETAȘEAZĂ
Această comandă detașează dispozitivul capabil DFU atașat în prezent într-un dispozitiv special
modul de programare. În timp ce dispozitivul se află în acest mod special DFU, nu poate fi utilizat
ca un dispozitiv normal. De exemplu, o imprimantă nu va accepta documente când este în DFU
Mod.

atașa
Această comandă atașează un dispozitiv capabil DFU înapoi la runtime, astfel încât să poată fi utilizat ca un
dispozitiv normal. Unele dispozitive nu acceptă atașarea și trebuie să fie manual
deconectat și conectat înainte de a schimba modurile.

ceas
Această comandă urmărește conectarea la cald a dispozitivelor DFU și poate fi folosită pentru a verifica libdfu
potrivește modurile de rulare și DFU la atașare și detașare. Utilizare CTRL + C la
faceți această comandă să iasă.

citit NUME DE FIȘIER
Această comandă încarcă tot firmware-ul de pe dispozitiv într-un fișier. Dacă dispozitivul are
mai multe partiții exportate ca secțiuni alternative diferite, apoi vor fi toate
fi citit într-un fișier cu mai multe imagini în format DfuSe. Dacă vrei doar conținutul unuia
partiție, citire-alt este comanda pe care o vrei.

citire-alt NUME DE FIȘIER DEVICE-ALT-NAME|DEVICE-ALT-ID
Această comandă încarcă firmware dintr-o partiție într-un fișier. Puteți specifica
partiție fie prin ALT-ID, fie ALT-NAME dacă este setat.

de exemplu dfu-instrument citire-alt backup.dfu SRAM

scrie
Această comandă descarcă firmware dintr-un fișier în toate partițiile posibile ale unui fișier
dispozitiv. Dacă doriți să scrieți doar o partiție, scrie-alt este comanda ta
vrei.

scrie-alt NUME DE FIȘIER DEVICE-ALT-NAME|DEVICE-ALT-ID [IMAGE-ALT-NAME|IMAGE-ALT-ID]
Această comandă descarcă firmware-ul din fișier într-o singură partiție. Puteți specifica
partiția fie prin ALT-ID, fie ALT-NAME dacă este setată.

de exemplu dfu-instrument scrie-alt sram.dfu SRAM __SRAM

FIRMWARE COMANDE

Aceste comenzi sunt folosite pentru a citi și modifica fișierele firmware existente.

descărca NUME DE FIȘIER
Această comandă aruncă toate detaliile despre un fișier firmware. Harta completă a memoriei
este afișat, împreună cu orice metadate sau informații despre furnizor despre fișierul firmware.

converti FORMAT FILE-IN FILE-OUT [MĂRIMEA]
Această comandă convertește firmware-ul dintr-un format în altul, opțional padding
la o anumită mărime. Valori posibile pentru destinație FORMAT includ: brut, ihex,
dfu și dfuse. The FILE-IN și FILE-OUT valorile pot fi aceleași dacă fișierul sursă
este de suprascris. Deși umplutura crește dimensiunea fișierului fără aparent
avantaje poate fi folosit pentru a susține dispozitive care nu stochează imaginea de rulare
dimensiunea și unde este necesară validarea firmware-ului scris.

de exemplu dfu-instrument converti DFU firmware.hex firmware.dfu 8000

criptați FILENAME-IN FILENAME-OUT TIP CHEIE
Această comandă criptează datele firmware-ului. Doar conținutul imaginii este de fapt
modificate, subsolul DFU și antetul DfuSe rămân nealterate. Valori posibile pentru
destinatia TIP includ: xtea și nop. Dacă CHEIE nu este din cele necesare
lungime este folosită ca intrare pentru o funcție hash care poate produce o cheie a
dimensiunea cerută.

de exemplu dfu-instrument criptați firmware.dfu firmware.xdfu xtea deadef

decripta FILENAME-IN FILENAME-OUT TIP CHEIE
Această comandă decriptează datele firmware-ului. Doar conținutul imaginii este de fapt
modificate, subsolul DFU și antetul DfuSe rămân nealterate. Valori posibile pentru
destinatia TIP includ: xtea și nop. Dacă CHEIE nu este din cele necesare
lungime este folosită ca intrare pentru o funcție hash care poate produce o cheie a
dimensiunea cerută.

de exemplu dfu-instrument decripta firmware.xdfu firmware.dfu xtea deadef

îmbina FILE-OUT DOSAR1 DOSAR2 [FIȘIER 3...]
Această comandă îmbină mai multe fișiere firmware într-un singur fișier. Deși poți fuziona
fișiere cu același ALT-ID sau ALT-NAME probabil că nu este ceea ce doriți să faceți.

de exemplu dfu-instrument îmbina combinate.dfu lib.dfu app.dfu

set-alt-setare FILE ALT-ID
Această comandă modifică numărul alternativ din fișierul firmware.

de exemplu dfu-instrument set-alt-setare firmware.dfu 1

set-alt-setting-name
Această comandă modifică numele alternativ pe fișierul firmware.

de exemplu dfu-instrument set-alt-setting-name firmware.dfu SRAM

set-metadate FILE CHEIE VALUE
Această comandă adaugă sau modifică metadatele existente pe un fișier firmware. NOTĂ: Există
doar spațiu de stocare a metadatelor foarte limitat în fișierele DFU, așa că cheile și valorile ar trebui să fie
ţinut cât mai scurt posibil. În special, valoarea licenței ar trebui specificată în
format SPDX.

de exemplu dfu-instrument set-metadate firmware.dfu licență GPL-2.0+

set-vânzător FILE VID
Această comandă setează ID-ul furnizorului pe un fișier firmware care va fi folosit pentru a se potrivi cu anumite
dispozitive. Valorile lui ffff se vor potrivi cu orice furnizor de dispozitiv.

de exemplu dfu-instrument set-vânzător firmware.dfu 273f

set-produs FILE PID
Această comandă setează ID-ul produsului pe un fișier firmware care va fi folosit pentru a se potrivi
dispozitive specifice. Valorile lui ffff se vor potrivi cu orice produs de dispozitiv.

de exemplu dfu-instrument set-produs firmware.dfu 1004

set-eliberare FILE ELIBERARE
Această comandă setează versiunea de lansare a fișierului firmware care va fi folosit pentru a se potrivi
dispozitive specifice. Valorile lui ffff se vor potrivi cu orice versiune de dispozitiv.

de exemplu dfu-instrument set-eliberare firmware.dfu ffff

Utilizați dfu-tool online folosind serviciile onworks.net