dfu-tool - Online sa Cloud

PROGRAMA:

NAME

dfu-tool - Tool sa Pag-upgrade ng Firmware ng Device

SINOPSIS

dfu-tool [ --verbose ] [ --bersyon ] [ --puwersa ] [ --device=VID:PID ] [ --transfer-
laki=BYTES ]

DESCRIPTION

Ang manu-manong pahinang ito ay nagdodokumento ng maikling dfu-tool utos.

dfu-tool nagbibigay-daan sa isang user na magsulat ng iba't ibang uri ng firmware sa mga device na sumusuporta sa USB
Protocol ng Pag-upgrade ng Firmware ng Device. Maaaring gamitin ang tool na ito upang ilipat ang device mula sa
normal runtime mode sa `DFU mode' na nagpapahintulot sa user na magbasa at magsulat ng firmware.
Maaaring maisulat ang buong device sa isang operasyon, o maaaring ang mga indibidwal na `target'
tinukoy kasama ang alternatibong pangalan o numero.

dfu-tool gumagamit ng libdfu shared library para magsagawa ng mga aksyon. Lahat ng magkakasabay na aksyon ay maaari
ligtas na kanselahin at sa pagkabigo ay magbabalik ng mga error na may parehong uri at isang buong teksto
paglalarawan. Sinusuportahan ng libdfu ang DFU 1.0, DFU 1.1 at ang extension ng vendor ng ST DfuSe, at
pinangangasiwaan ang maraming `quirks' ng device na kinakailangan para sa mga totoong pagpapatupad ng DFU.

Bilang karagdagan dfu-tool ay maaaring gamitin upang i-convert ang firmware mula sa iba't ibang mga format, o
upang baguhin ang mga detalye tungkol sa mga elemento, larawan at metadata na nasa loob ng firmware
file. Halimbawa, madali mong mako-convert ang DFU 1.1 firmware sa DfuSe na partikular sa vendor
format, i-convert ang isang Intel HEX file sa isang raw file na may palaman sa isang partikular na laki, o magdagdag ng bago
impormasyon sa copyright at paglilisensya sa isang umiiral na file. Mga field tulad ng vendor at
maaaring baguhin ang mga ID ng produkto, at ang mga elemento ng firmware ay maaaring i-encrypt at i-decrypt gamit ang
iba't ibang paraan. Ang pagsasama-sama ng dalawang DfuSe file ay posible rin, bagaman
Ang pagtukoy ng iba't ibang mga alt-setting na numero bago pagsamahin ay isang magandang ideya upang maiwasan ang pagkalito.

Bagaman dfu-tool sumusubok na magbigay ng malaking bilang ng madaling gamitin na mga utos, maaaring ito lang
posibleng gawin ang ilang partikular na operasyon gamit ang libdfu library nang direkta. Ito ay mas madali kaysa sa
ito ay tunog, dahil ang library ay binuo na may suporta sa GObject Introspection na ginagawa itong magagamit
maraming wika tulad ng C, Javascript at Python. Higit pa rito, ang paggamit ng silid-aklatan ay mabuti
ideya kung gusto mong magsagawa ng maraming operasyon sa malalaking file ng firmware, halimbawa,
pag-convert mula sa isang Intel HEX file, padding sa isang tiyak na laki, pagtatakda ng vendor at pagdaragdag
impormasyon sa paglilisensya at pagkatapos ay i-save sa isang malayong lokasyon.

Opsyon

Ang program na ito ay sumusunod sa karaniwang GNU command line syntax, na may mahabang opsyon na nagsisimula sa
dalawang gitling (-). Ang isang buod ng mga opsyon ay kasama sa ibaba.

- Tumulong
Ipakita ang buod ng lahat ng mga utos na magagamit para sa paggamit.

--bersyon
Ipakita ang bersyon ng dfu-tool -install.

--verbose
Magpakita ng karagdagang impormasyon sa pag-debug.

--device=VID:PID
Kung maraming DFU-capable na device ang naka-attach maaari mong tukuyin ang partikular na vendor
at product ID ng DFU device na gusto mong i-query.

--transfer-size=BYTES
Manu-manong i-override ang laki ng bawat USB transfer, na maaaring gusto mo para sa hindi mapagkakatiwalaan
hardware o kapag nagsinungaling ang device tungkol sa maximum na laki ng packet na tinatanggap nito.

--puwersa
Pilitin ang operasyon, binabalewala ang mga babala o mga pagsusuri sa katinuan tulad ng file CRC at
mga checksum. Ito ay kapaki-pakinabang kung talagang alam mo kung ano ang iyong ginagawa, o sa
espesyal na kaso ng fuzz-testing libdfu.

DEVICE UTOS

Ang mga command na ito ay ginagamit upang mag-interface sa mga device na may kakayahang DFU.

listahan
Inililista ng command na ito ang kasalukuyang naka-attach na mga device na may kakayahang DFU. Ang ilang mga aparato ay hindi
suportahan ang opisyal na DFU runtime mode at sa gayon ay hindi sumusuporta sa paggamit ng auto-discovery
utos na ito. Para sa mga device na iyon, manu-manong inilalagay ang device sa DFU mode (hal
sa pamamagitan ng pagpindot sa isang button pababa kapag nire-reboot ang device) ay lalabas ito dito.

tanggalin
Inalis ng command na ito ang kasalukuyang naka-attach na device na may kakayahang DFU sa isang espesyal
programming mode. Habang ang device ay nasa espesyal na DFU mode na ito, hindi ito magagamit
bilang isang normal na aparato. Halimbawa, hindi tatanggap ng mga dokumento ang isang printer kapag nasa DFU
mode.

ikabit
Ang utos na ito ay nag-attach ng isang aparatong may kakayahang DFU pabalik sa runtime upang magamit ito bilang a
normal na aparato. Hindi sinusuportahan ng ilang device ang pag-attach, at kailangang manu-mano
nadiskonekta at nakakonekta bago magpalit ng mga mode.

panoorin
Pinapanood ng command na ito ang mga DFU device na naka-hotplugged at maaaring gamitin para i-verify ang libdfu
tumutugma sa runtime at DFU mode kapag nag-attach at nagde-detach. Gamitin CTRL + C sa
itigil ang utos na ito.

basahin FILENAME
Ina-upload ng command na ito ang lahat ng firmware mula sa device papunta sa isang file. Kung mayroon ang device
maramihang mga partisyon na na-export bilang iba't ibang mga alternatibong seksyon pagkatapos ay lahat sila
basahin sa isang multi-image na DfuSe-format na file. Kung gusto mo lang ang laman ng isa
pagkahati, basahin-alt ay ang utos na gusto mo.

basahin-alt FILENAME DEVICE-ALT-NAME|DEVICE-ALT-ID
Ang command na ito ay nag-a-upload ng firmware mula sa isang partition patungo sa isang file. Maaari mong tukuyin ang
partition sa pamamagitan ng alinman sa ALT-ID o ALT-NAME kung nakatakda.

hal dfu-tool basahin-alt backup.dfu SRAM

magsulat
Ang command na ito ay nagda-download ng firmware mula sa isang file papunta sa lahat ng posibleng partition ng a
aparato. Kung gusto mo lang magsulat ng isang partition, write-alt ay ang utos mo
gusto mo.

write-alt FILENAME DEVICE-ALT-NAME|DEVICE-ALT-ID [IMAGE-ALT-NAME|IMAGE-ALT-ID]
Ang command na ito ay nagda-download ng firmware mula sa file sa isang partition. Maaari mong tukuyin
ang partition sa pamamagitan ng alinman sa ALT-ID o ALT-NAME kung itinakda.

hal dfu-tool write-alt sram.dfu SRAM __SRAM

FIRMWARE UTOS

Ang mga utos na ito ay ginagamit upang basahin at baguhin ang mga kasalukuyang file ng firmware.

tambakan ng basura FILENAME
Ang command na ito ay nagtatapon ng lahat ng alam na detalye tungkol sa isang firmware file. Ang kumpletong mapa ng memorya
ay ipinapakita, kasama ng anumang metadata o impormasyon ng vendor tungkol sa firmware file.

palitan FORMAT FILE-IN FILE-OUT [SIZE]
Kino-convert ng command na ito ang firmware mula sa isang format patungo sa isa pa, opsyonal na padding
sa isang tiyak na sukat. Mga posibleng halaga para sa destinasyon FORMAT isama ang: raw, ihex,
dfu at dfuse. Ang FILE-IN at FILE-OUT maaaring pareho ang mga value kung ang source file
ay dapat ma-overwrite. Bagama't pinapataas ng padding ang laki ng file nang hindi nakikita
mga pakinabang na maaari itong magamit upang suportahan ang mga device na hindi nag-iimbak ng runtime na imahe
laki at kung saan kinakailangan ang pagpapatunay ng nakasulat na firmware.

hal dfu-tool palitan dfu firmware.hex firmware.dfu 8000

encrypt FILENAME-IN FILENAME-OUT TYPE KEY
Ini-encrypt ng command na ito ang data ng firmware. Tanging ang mga nilalaman ng imahe ay talagang
binago, ang DFU footer at DfuSe header ay hindi nababago. Mga posibleng halaga para sa
ang destinasyon TYPE isama ang: xtea at nop. Kung ang KEY ay hindi sa kinakailangan
haba ito ay ginagamit bilang isang input sa isang hash function na maaaring makabuo ng isang susi ng
kinakailangang laki.

hal dfu-tool encrypt firmware.dfu firmware.xdfu xtea patay na

decrypt FILENAME-IN FILENAME-OUT TYPE KEY
Ang utos na ito ay nagde-decrypt ng data ng firmware. Tanging ang mga nilalaman ng imahe ay talagang
binago, ang DFU footer at DfuSe header ay hindi nababago. Mga posibleng halaga para sa
ang destinasyon TYPE isama ang: xtea at nop. Kung ang KEY ay hindi sa kinakailangan
haba ito ay ginagamit bilang isang input sa isang hash function na maaaring makabuo ng isang susi ng
kinakailangang laki.

hal dfu-tool decrypt firmware.xdfu firmware.dfu xtea patay na

pagsamahin FILE-OUT FILE1 FILE2 [FILE3...]
Pinagsasama ng command na ito ang maraming file ng firmware sa isang file. Kahit na maaari mong pagsamahin
mga file na may parehong ALT-ID o ALT-NAME na malamang na hindi ito ang gusto mong gawin.

hal dfu-tool pagsamahin pinagsama.dfu lib.dfu app.dfu

set-alt-setting FILE ALT-ID
Binabago ng command na ito ang alternatibong numero sa firmware file.

hal dfu-tool set-alt-setting firmware.dfu 1

set-alt-setting-name
Binabago ng command na ito ang alternatibong pangalan sa firmware file.

hal dfu-tool set-alt-setting-name firmware.dfu SRAM

set-metadata FILE KEY VALUE
Ang command na ito ay nagdaragdag o nagbabago ng umiiral na metadata sa isang firmware file. NOTE: Meron
napakalimitado lamang na espasyo ng storage ng metadata sa mga DFU file, kaya dapat ang mga key at value
pinananatiling maikli hangga't maaari. Sa partikular, ang halaga ng Lisensya ay dapat na tinukoy sa
SPDX na format.

hal dfu-tool set-metadata firmware.dfu Lisensya GPL-2.0+

set-vendor FILE vID
Itinatakda ng command na ito ang vendor ID sa isang firmware file na gagamitin upang tumugma sa partikular
mga device. Tutugma ang mga halaga ng ffff sa anumang vendor ng device.

hal dfu-tool set-vendor firmware.dfu 273f

set-produkto FILE PID
Itinatakda ng command na ito ang product ID sa isang firmware file na gagamitin upang tumugma
mga partikular na device. Tutugma ang mga halaga ng ffff sa anumang produkto ng device.

hal dfu-tool set-produkto firmware.dfu 1004

set-release FILE RELEASE
Itinatakda ng command na ito ang bersyon ng release sa firmware file na gagamitin upang tumugma
mga partikular na device. Tutugma ang mga value ng ffff sa anumang release ng device.

hal dfu-tool set-release firmware.dfu ffff

Gumamit ng dfu-tool online gamit ang mga serbisyo ng onworks.net