dfu-tool - Online in de cloud

PROGRAMMA:

NAAM

dfu-tool - Upgradetool voor apparaatfirmware

KORTE INHOUD

dfu-tool [ --uitgebreid ] [ --versie ] [ --kracht ] [ --apparaat=VID:PID ] [ --overdracht-
grootte=BYTES ]

PRODUCTBESCHRIJVING

Deze handleiding documenteert in het kort de: dfu-tool opdracht.

dfu-tool stelt een gebruiker in staat om verschillende soorten firmware te schrijven naar apparaten die USB ondersteunen
Apparaat Firmware Upgrade-protocol. Deze tool kan worden gebruikt om het apparaat van de
normale runtime-modus naar `DFU-modus' waarmee de gebruiker firmware kan lezen en schrijven.
Of het hele apparaat kan in één bewerking worden geschreven, of individuele `doelen' kunnen dat zijn
gespecificeerd met de alternatieve naam of het nummer.

dfu-tool gebruikt de gedeelde bibliotheek libdfu om acties uit te voeren. Alle synchrone acties kunnen
veilig worden geannuleerd en bij falen worden fouten geretourneerd met zowel een type als een volledige tekst
beschrijving. libdfu ondersteunt DFU 1.0, DFU 1.1 en de ST DfuSe leveranciersextensie, en
behandelt veel 'eigenaardigheden' van apparaten die nodig zijn voor de real-world implementaties van DFU.

Daarnaast dfu-tool kan worden gebruikt om firmware van verschillende formaten te converteren, of
om details over de elementen, afbeeldingen en metadata in de firmware te wijzigen
bestand. U kunt bijvoorbeeld DFU 1.1-firmware eenvoudig converteren naar de leverancierspecifieke DfuSe
formaat, converteer een Intel HEX-bestand naar een onbewerkt bestand opgevuld tot een specifieke grootte, of voeg nieuwe toe
copyright- en licentie-informatie toe aan een bestaand bestand. Velden zoals de leverancier en
product-ID's kunnen worden gewijzigd en de firmware-elementen kunnen worden gecodeerd en gedecodeerd met behulp van
verschillende verschillende methodes. Het samenvoegen van twee DfuSe-bestanden is echter ook mogelijk
het specificeren van verschillende alt-setting nummers voor het samenvoegen is een goed idee om verwarring te voorkomen.

Hoewel dfu-tool probeert een groot aantal eenvoudig te gebruiken commando's aan te bieden, het kan alleen zijn
mogelijk om bepaalde bewerkingen rechtstreeks met de libdfu-bibliotheek uit te voeren. Dit is makkelijker dan
het klinkt, aangezien de bibliotheek is gebouwd met GObject Introspection-ondersteuning waardoor deze bruikbaar is in
vele talen zoals C, Javascript en Python. Verder is het gebruik van de bibliotheek een goede zaak
idee als u meerdere bewerkingen op grote firmwarebestanden wilt uitvoeren, bijvoorbeeld
converteren van een Intel HEX-bestand, opvullen tot een bepaalde grootte, leverancier instellen en toevoegen
licentie-informatie en vervolgens opslaan op een externe locatie.

OPTIES

Dit programma volgt de gebruikelijke GNU-opdrachtregelsyntaxis, met lange opties die beginnen met
twee streepjes (-). Hieronder vindt u een overzicht van de mogelijkheden.

--help
Toon samenvatting van alle commando's die beschikbaar zijn voor gebruik.

--versie
Toon de versie van dfu-tool geïnstalleerd.

--uitgebreid
Toon extra foutopsporingsinformatie.

--apparaat=VID:PID
Als er meerdere DFU-compatibele apparaten zijn aangesloten, kunt u de specifieke leverancier opgeven
en product-ID van het DFU-apparaat dat u wilt opvragen.

--overdrachtsgrootte=BYTES
Overschrijf handmatig de grootte van elke USB-overdracht, die u misschien onbetrouwbaar wilt hebben
hardware of wanneer het apparaat liegt over de maximale pakketgrootte die het accepteert.

--kracht
Forceer de operatie, negeer waarschuwingen of sanity checks zoals bestand CRC en
controlesommen. Dit is handig als je echt weet wat je doet, of in de
gespecialiseerd geval van fuzz-testen libdfu.

APPARAAT COMMANDO'S

Deze opdrachten worden gebruikt om te communiceren met DFU-compatibele apparaten.

lijst
Deze opdracht geeft een lijst weer van momenteel aangesloten DFU-compatibele apparaten. Sommige apparaten niet
ondersteunen de officiële DFU-runtime-modus en ondersteunen dus geen auto-discovery met behulp van
deze opdracht. Voor die apparaten, zet het apparaat handmatig in de DFU-modus (bijv
door een knop ingedrukt te houden bij het opnieuw opstarten van het apparaat) zal het hier verschijnen.

DETACH
Met deze opdracht wordt het momenteel aangesloten DFU-compatibele apparaat losgekoppeld van een speciaal
programmeermodus. Zolang het apparaat zich in deze speciale DFU-modus bevindt, kan het niet worden gebruikt
als een normaal apparaat. Een printer accepteert bijvoorbeeld geen documenten in DFU
modus.

hechten
Deze opdracht koppelt een DFU-compatibel apparaat terug aan runtime, zodat het kan worden gebruikt als een
normaal toestel. Sommige apparaten bieden geen ondersteuning voor koppelen en moeten handmatig worden gedaan
losgekoppeld en aangesloten voordat u van modus verandert.

horloge
Deze opdracht kijkt hoe DFU-apparaten hotplugged worden en kan worden gebruikt om libdfu te verifiëren
komt overeen met de runtime- en DFU-modi bij het bevestigen en losmaken. Gebruik CTRL + C naar
laat deze opdracht stoppen.

dit artikel lezen BESTANDSNAAM
Deze opdracht uploadt alle firmware van het apparaat naar een bestand. Als het apparaat heeft
meerdere partities geëxporteerd als verschillende alternatieve secties, dan zullen ze dat allemaal doen
worden ingelezen in een DfuSe-bestand met meerdere afbeeldingen. Als je alleen de inhoud van een wilt
partitie, lees-alt is de opdracht die u wilt.

lees-alt BESTANDSNAAM APPARAAT-ALT-NAAM|APPARAAT-ALT-ID
Deze opdracht uploadt firmware van één partitie naar een bestand. U kunt de
partitie door de ALT-ID of ALT-NAME indien ingesteld.

bv dfu-tool lees-alt back-up.dfu SRAM

schrijven
Deze opdracht downloadt firmware van een bestand naar alle mogelijke partities van een
apparaat. Als u slechts één partitie wilt schrijven, schrijf-alt is de opdracht u
willen.

schrijf-alt BESTANDSNAAM APPARAAT-ALT-NAAM|APPARAAT-ALT-ID [IMAGE-ALT-NAAM|IMAGE-ALT-ID]
Deze opdracht downloadt firmware van het bestand naar één partitie. U kunt specificeren
de partitie door de ALT-ID of ALT-NAME indien ingesteld.

bv dfu-tool schrijf-alt sram.dfu SRAM __SRAM

FIRMWARE COMMANDO'S

Deze opdrachten worden gebruikt om bestaande firmwarebestanden te lezen en aan te passen.

storten BESTANDSNAAM
Deze opdracht dumpt alle bekende details over een firmwarebestand. De volledige geheugenkaart
wordt weergegeven, samen met eventuele metadata of leveranciersinformatie over het firmwarebestand.

converteren FORMAT BESTAND IN BESTAND UIT [MAAT]
Deze opdracht converteert de firmware van het ene formaat naar het andere, optioneel padding
tot een bepaalde maat. Mogelijke waarden voor de bestemming FORMAT omvatten: rauw, ihex,
dfu en dfuse. De BESTAND IN en BESTAND UIT waarden kunnen hetzelfde zijn als het bronbestand
is te overschrijven. Hoewel opvulling de bestandsgrootte vergroot zonder dat dit duidelijk is
voordelen het kan worden gebruikt om apparaten te ondersteunen die de runtime-image niet opslaan
grootte en waar validatie van de geschreven firmware vereist is.

bv dfu-tool converteren dfu firmware.hex firmware.dfu 8000

encrypt BESTANDSNAAM-IN BESTANDSNAAM-UIT TYPE KEY
Deze opdracht versleutelt firmwaregegevens. Alleen de inhoud van de afbeelding is eigenlijk
gewijzigd, blijven de DFU-voettekst en DfuSe-koptekst ongewijzigd. Mogelijke waarden voor
de bestemming TYPE onder andere: xtea en nop. Als de KEY is niet van de vereiste
lengte wordt gebruikt als invoer voor een hash-functie die een sleutel kan produceren van de
vereiste maat.

bv dfu-tool encrypt firmware.dfu firmware.xdfu xthee deadbeef

decoderen BESTANDSNAAM-IN BESTANDSNAAM-UIT TYPE KEY
Deze opdracht ontsleutelt firmwaregegevens. Alleen de inhoud van de afbeelding is eigenlijk
gewijzigd, blijven de DFU-voettekst en DfuSe-koptekst ongewijzigd. Mogelijke waarden voor
de bestemming TYPE onder andere: xtea en nop. Als de KEY is niet van de vereiste
lengte wordt gebruikt als invoer voor een hash-functie die een sleutel kan produceren van de
vereiste maat.

bv dfu-tool decoderen firmware.xdfu firmware.dfu xthee deadbeef

samensmelten BESTAND UIT FILE1 FILE2 [BESTAND3...]
Deze opdracht voegt meerdere firmwarebestanden samen tot één bestand. Hoewel je kunt samenvoegen
bestanden met dezelfde ALT-ID of ALT-NAME is dit waarschijnlijk niet wat u wilt doen.

bv dfu-tool samensmelten gecombineerd.dfu lib.dfu app.dfu

set-alt-instelling FILE ALT-ID
Deze opdracht wijzigt het alternatieve nummer in het firmwarebestand.

bv dfu-tool set-alt-instelling firmware.dfu 1

set-alt-instellingsnaam
Deze opdracht wijzigt de alternatieve naam in het firmwarebestand.

bv dfu-tool set-alt-instellingsnaam firmware.dfu SRAM

set-metagegevens FILE KEY WAARDE
Deze opdracht voegt bestaande metagegevens aan een firmwarebestand toe of wijzigt deze. LET OP: er is
slechts een zeer beperkte opslagruimte voor metadata in DFU-bestanden, dus sleutels en waarden zouden dat moeten zijn
zo kort mogelijk gehouden. In het bijzonder moet de licentiewaarde worden gespecificeerd in
SPDX-formaat.

bv dfu-tool set-metagegevens firmware.dfu Licentie GPL-2.0+

set-verkoper FILE VID
Met deze opdracht wordt de leverancier-ID ingesteld op een firmwarebestand dat zal worden gebruikt om specifiek te matchen
apparaten. Waarden van ffff komen overeen met elke apparaatleverancier.

bv dfu-tool set-verkoper firmware.dfu 273f

set-product FILE PID
Met deze opdracht wordt de product-ID ingesteld op een firmwarebestand dat zal worden gebruikt om te matchen
specifieke apparaten. Waarden van ffff komen overeen met elk apparaatproduct.

bv dfu-tool set-product firmware.dfu 1004

set-release FILE RELEASE
Met deze opdracht wordt de releaseversie van het firmwarebestand ingesteld die zal worden gebruikt om te matchen
specifieke apparaten. Waarden van ffff komen overeen met elke apparaatversie.

bv dfu-tool set-release firmware.dfu ffff

Gebruik dfu-tool online met behulp van onworks.net-services