dfu-tool - Dalam Talian di Awan

JADUAL:

NAMA

dfu-tool - Alat Naik Taraf Perisian Tegar Peranti

SINOPSIS

dfu-tool [ --verbose ] [ --versi ] [ - kekuatan ] [ --device=VID:PID ] [ --pemindahan-
saiz=BYTES ]

DESCRIPTION

Halaman manual ini mendokumentasikan secara ringkas dfu-tool perintah.

dfu-tool membenarkan pengguna menulis pelbagai jenis perisian tegar pada peranti yang menyokong USB
Protokol Peningkatan Perisian Tegar Peranti. Alat ini boleh digunakan untuk menukar peranti daripada
mod masa jalan biasa kepada `mod DFU' yang membolehkan pengguna membaca dan menulis perisian tegar.
Sama ada keseluruhan peranti boleh ditulis dalam satu operasi, atau `sasaran' individu boleh
dinyatakan dengan nama atau nombor alternatif.

dfu-tool menggunakan perpustakaan kongsi libdfu untuk melakukan tindakan. Semua tindakan segerak boleh
dibatalkan dengan selamat dan apabila gagal akan mengembalikan ralat dengan kedua-dua jenis dan teks penuh
penerangan. libdfu menyokong DFU 1.0, DFU 1.1 dan sambungan vendor ST DfuSe, dan
mengendalikan banyak `kebiasaan' peranti yang diperlukan untuk pelaksanaan dunia sebenar DFU.

Selain itu dfu-tool boleh digunakan untuk menukar perisian tegar daripada pelbagai format yang berbeza, atau
untuk mengubah suai butiran tentang elemen, imej dan metadata yang terkandung dalam perisian tegar
fail. Contohnya, anda boleh menukar perisian tegar DFU 1.1 dengan mudah kepada DfuSe khusus vendor
format, tukar fail Intel HEX kepada fail mentah berlapik kepada saiz tertentu atau tambah baharu
maklumat hak cipta dan pelesenan kepada fail sedia ada. Medan seperti vendor dan
ID produk boleh ditukar, dan elemen perisian tegar boleh disulitkan dan dinyahsulit menggunakan
pelbagai kaedah yang berbeza. Menggabungkan dua fail DfuSe bersama-sama juga mungkin, walaupun
menyatakan nombor tetapan alt yang berbeza sebelum digabungkan adalah idea yang baik untuk mengelakkan kekeliruan.

Walaupun dfu-tool cuba menyediakan sejumlah besar arahan yang mudah digunakan, mungkin sahaja
mungkin untuk melakukan operasi tertentu menggunakan perpustakaan libdfu secara langsung. Ini lebih mudah daripada
kedengarannya, kerana perpustakaan dibina dengan sokongan GObject Introspection menjadikannya boleh digunakan
banyak bahasa seperti C, Javascript dan Python. Tambahan pula, menggunakan perpustakaan adalah satu kebaikan
idea jika anda ingin melakukan berbilang operasi pada fail perisian tegar yang besar, contohnya,
menukar daripada fail Intel HEX, padding kepada saiz tertentu, menetapkan vendor dan menambah
maklumat pelesenan dan kemudian menyimpan ke lokasi terpencil.

PILIHAN

Program ini mengikut sintaks baris arahan GNU yang biasa, dengan pilihan panjang bermula dengan
dua sengkang (-). Ringkasan pilihan disertakan di bawah.

- membantu
Tunjukkan ringkasan semua arahan yang tersedia untuk digunakan.

--versi
Tunjukkan versi dfu-tool dipasang.

--verbose
Tunjukkan maklumat penyahpepijatan tambahan.

--device=VID:PID
Jika berbilang peranti berkemampuan DFU dilampirkan, anda boleh menentukan vendor tertentu
dan ID produk peranti DFU yang anda ingin tanyakan.

--transfer-size=BYTES
Gantikan saiz setiap pemindahan USB secara manual, yang mungkin anda inginkan kerana tidak boleh dipercayai
perkakasan atau apabila peranti terletak mengenai saiz paket maksimum yang diterimanya.

- kekuatan
Paksa operasi, tidak menghiraukan amaran atau semakan kewarasan seperti fail CRC dan
jumlah semak. Ini berguna jika anda benar-benar tahu apa yang anda lakukan, atau dalam
kes khusus libdfu ujian fuzz.

PERANTI PERINTAH

Arahan ini digunakan untuk antara muka dengan peranti berkemampuan DFU.

senarai
Perintah ini menyenaraikan peranti berkemampuan DFU yang dilampirkan pada masa ini. Sesetengah peranti tidak
menyokong mod masa jalan DFU rasmi dan dengan itu tidak menyokong penggunaan auto-penemuan
perintah ini. Untuk peranti tersebut, meletakkan peranti ke dalam mod DFU secara manual (cth
dengan menahan butang ke bawah semasa but semula peranti) akan memaparkannya di sini.

lepaskan
Perintah ini menanggalkan peranti berkemampuan DFU yang sedang dilampirkan ke dalam peranti khas
mod pengaturcaraan. Semasa peranti berada dalam mod DFU khas ini ia tidak boleh digunakan
sebagai peranti biasa. Sebagai contoh, pencetak tidak akan menerima dokumen apabila berada dalam DFU
mod.

melampirkan
Perintah ini melampirkan peranti berkemampuan DFU kembali ke masa jalan supaya ia boleh digunakan sebagai a
peranti biasa. Sesetengah peranti tidak menyokong pemasangan dan perlu dibuat secara manual
diputuskan dan disambungkan sebelum menukar mod.

menonton
Perintah ini melihat peranti DFU sedang disambungkan dan boleh digunakan untuk mengesahkan libdfu
memadankan masa jalan dan mod DFU apabila memasang dan menanggalkan. guna CTRL + C kepada
buat arahan ini berhenti.

membaca NAMA FAIL
Perintah ini memuat naik semua perisian tegar daripada peranti ke dalam fail. Jika peranti mempunyai
berbilang partition dieksport sebagai bahagian alternatif yang berbeza maka semuanya akan
dibaca ke dalam fail format DfuSe berbilang imej. Jika anda hanya mahu kandungan satu
partition, baca-alt adalah perintah yang anda mahukan.

baca-alt NAMA FAIL DEVICE-ALT-NAME|DEVICE-ALT-ID
Perintah ini memuat naik perisian tegar dari satu partition ke dalam fail. Anda boleh menentukan
partition sama ada dengan ALT-ID atau ALT-NAME jika ditetapkan.

contohnya dfu-tool baca-alt backup.dfu SRAM

menulis
Perintah ini memuat turun perisian tegar daripada fail ke dalam semua sekatan yang mungkin a
peranti. Jika anda hanya mahu menulis satu partition, tulis-alt adalah perintah anda
mahu.

tulis-alt NAMA FAIL DEVICE-ALT-NAME|DEVICE-ALT-ID [IMAGE-ALT-NAME|IMAGE-ALT-ID]
Perintah ini memuat turun perisian tegar daripada fail ke dalam satu partition. Anda boleh menentukan
partition sama ada dengan ALT-ID atau ALT-NAME jika ditetapkan.

contohnya dfu-tool tulis-alt sram.dfu SRAM __SRAM

PERISIAN PERINTAH

Arahan ini digunakan untuk membaca dan mengubah suai fail perisian tegar sedia ada.

membuang NAMA FAIL
Perintah ini membuang semua butiran yang mengetahui tentang fail perisian tegar. Peta ingatan yang lengkap
ditunjukkan, bersama-sama dengan sebarang metadata atau maklumat vendor tentang fail perisian tegar.

menukar FORMAT FAIL MASUK KELUAR FAIL [SAIZ]
Perintah ini menukar perisian tegar daripada satu format ke format yang lain, secara pilihan berlapik
kepada saiz tertentu. Nilai yang mungkin untuk destinasi FORMAT termasuk: mentah, ihex,
dfu dan dfuse. The FAIL MASUK and KELUAR FAIL nilai boleh sama jika fail sumber
adalah untuk ditimpa. Walaupun padding meningkatkan saiz fail tanpa jelas
kelebihan ia boleh digunakan untuk menyokong peranti yang tidak menyimpan imej masa jalan
saiz dan di mana pengesahan perisian tegar bertulis diperlukan.

contohnya dfu-tool menukar dfu firmware.hex firmware.dfu 8000

menyulitkan FILENAME-IN NAMA FAIL KELUAR JENIS UTAMA
Perintah ini menyulitkan data perisian tegar. Hanya kandungan imej sebenarnya
diubah suai, pengaki DFU dan pengepala DfuSe dibiarkan tanpa diubah. Nilai yang mungkin untuk
destinasi JENIS termasuk: xtea dan nop. Sekiranya UTAMA bukan daripada yang diperlukan
panjang ia digunakan sebagai input kepada fungsi cincang yang boleh menghasilkan kunci bagi
saiz yang diperlukan.

contohnya dfu-tool menyulitkan firmware.dfu firmware.xdfu xtea deadbeef

menyahsulit FILENAME-IN NAMA FAIL KELUAR JENIS UTAMA
Perintah ini menyahsulit data perisian tegar. Hanya kandungan imej sebenarnya
diubah suai, pengaki DFU dan pengepala DfuSe dibiarkan tanpa diubah. Nilai yang mungkin untuk
destinasi JENIS termasuk: xtea dan nop. Sekiranya UTAMA bukan daripada yang diperlukan
panjang ia digunakan sebagai input kepada fungsi cincang yang boleh menghasilkan kunci bagi
saiz yang diperlukan.

contohnya dfu-tool menyahsulit firmware.xdfu firmware.dfu xtea deadbeef

bergabung KELUAR FAIL FAIL1 FAIL2 [FAIL3...]
Perintah ini menggabungkan beberapa fail perisian tegar ke dalam satu fail. Walaupun anda boleh bergabung
fail dengan ALT-ID atau ALT-NAME yang sama ini mungkin bukan perkara yang anda mahu lakukan.

contohnya dfu-tool bergabung digabungkan.dfu lib.dfu app.dfu

set-alt-setting FAIL ALT-ID
Perintah ini mengubah suai nombor alternatif pada fail perisian tegar.

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

set-alt-setting-name
Perintah ini mengubah suai nama alternatif pada fail perisian tegar.

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

set-metadata FAIL UTAMA NILAI
Perintah ini menambah atau mengubah suai metadata sedia ada pada fail perisian tegar. NOTA: Ada
hanya ruang storan metadata yang sangat terhad dalam fail DFU, jadi kunci dan nilai sepatutnya
disimpan sesingkat mungkin. Khususnya, nilai Lesen hendaklah dinyatakan dalam
Format SPDX.

contohnya dfu-tool set-metadata firmware.dfu Lesen GPL-2.0+

set-vendor FAIL VID
Perintah ini menetapkan ID vendor pada fail perisian tegar yang akan digunakan untuk memadankan tertentu
peranti. Nilai ffff akan sepadan dengan mana-mana vendor peranti.

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

set-produk FAIL PID
Perintah ini menetapkan ID produk pada fail perisian tegar yang akan digunakan untuk dipadankan
peranti tertentu. Nilai ffff akan sepadan dengan mana-mana produk peranti.

contohnya dfu-tool set-produk firmware.dfu 1004

set-pelepasan FAIL SIARAN
Perintah ini menetapkan versi keluaran pada fail perisian tegar yang akan digunakan untuk dipadankan
peranti tertentu. Nilai ffff akan sepadan dengan mana-mana keluaran peranti.

contohnya dfu-tool set-pelepasan firmware.dfu ffff

Gunakan dfu-tool dalam talian menggunakan perkhidmatan onworks.net