dfu-tool - Online di Cloud

PROGRAM:

NAMA

dfu-tool - Alat Peningkatan Firmware Perangkat

RINGKASAN

dfu-alat [ --bertele-tele ] [ --Versi: kapan ] [ --memaksa ] [ --perangkat=VID:PID ] [ --transfer-
ukuran = BYTES ]

DESKRIPSI

Halaman manual ini mendokumentasikan secara singkat dfu-alat perintah.

dfu-alat memungkinkan pengguna untuk menulis berbagai jenis firmware ke perangkat yang mendukung USB
Protokol Peningkatan Firmware Perangkat. Alat ini dapat digunakan untuk mengganti perangkat dari
mode runtime normal ke `mode DFU' yang memungkinkan pengguna membaca dan menulis firmware.
Baik seluruh perangkat dapat ditulis dalam satu operasi, atau `target' individu dapat
ditentukan dengan nama atau nomor alternatif.

dfu-alat menggunakan perpustakaan bersama libdfu untuk melakukan tindakan. Semua tindakan sinkron dapat
dibatalkan dengan aman dan jika gagal akan mengembalikan kesalahan dengan tipe dan tekstual lengkap
keterangan. libdfu mendukung DFU 1.0, DFU 1.1 dan ekstensi vendor ST DfuSe, dan
menangani banyak perangkat `quirks' yang diperlukan untuk implementasi DFU di dunia nyata.

Selain itu dfu-alat dapat digunakan untuk mengonversi firmware dari berbagai format berbeda, atau
untuk mengubah detail tentang elemen, gambar, dan metadata yang terdapat di dalam firmware
mengajukan. Misalnya, Anda dapat dengan mudah mengonversi firmware DFU 1.1 menjadi DfuSe khusus vendor
format, ubah file Intel HEX menjadi file mentah yang diisi dengan ukuran tertentu, atau tambahkan yang baru
informasi hak cipta dan lisensi ke file yang ada. Bidang seperti vendor dan
ID produk dapat diubah, dan elemen firmware dapat dienkripsi dan didekripsi menggunakan
berbagai metode yang berbeda. Menggabungkan dua file DfuSe bersama-sama juga dimungkinkan, meskipun
menentukan nomor pengaturan alt yang berbeda sebelum menggabungkan adalah ide yang baik untuk menghindari kebingungan.

Meskipun dfu-alat mencoba memberikan sejumlah besar perintah yang mudah digunakan, itu mungkin hanya
mungkin untuk melakukan operasi tertentu menggunakan perpustakaan libdfu secara langsung. Ini lebih mudah daripada
kedengarannya, karena perpustakaan dibangun dengan dukungan Introspeksi GObject sehingga dapat digunakan di
banyak bahasa seperti C, Javascript dan Python. Selain itu, menggunakan perpustakaan adalah hal yang baik
ide jika Anda ingin melakukan beberapa operasi pada file firmware besar, misalnya,
mengonversi dari file Intel HEX, mengisi ke ukuran tertentu, mengatur vendor, dan menambahkan
informasi lisensi dan kemudian menyimpan ke lokasi yang jauh.

PILIHAN

Program ini mengikuti sintaks baris perintah GNU biasa, dengan opsi panjang dimulai dengan
dua garis (-). Ringkasan opsi disertakan di bawah ini.

--membantu
Tampilkan ringkasan semua perintah yang tersedia untuk digunakan.

--Versi: kapan
Tampilkan versi dfu-alat diinstal.

--bertele-tele
Tampilkan informasi debug tambahan.

--perangkat=VID:PID
Jika beberapa perangkat berkemampuan DFU terpasang, Anda dapat menentukan vendor tertentu
dan ID produk perangkat DFU yang ingin Anda tanyakan.

--ukuran transfer=BYTES
Ganti ukuran setiap transfer USB secara manual, yang mungkin Anda inginkan karena tidak dapat diandalkan
perangkat keras atau ketika perangkat terletak tentang ukuran paket maksimum yang diterimanya.

--memaksa
Paksa operasi, mengabaikan peringatan atau pemeriksaan kewarasan seperti file CRC dan
checksum. Ini berguna jika Anda benar-benar tahu apa yang Anda lakukan, atau dalam
kasus khusus libdfu pengujian fuzz.

ALAT PERINTAH

Perintah-perintah ini digunakan untuk berinteraksi dengan perangkat berkemampuan DFU.

daftar
Perintah ini mencantumkan perangkat berkemampuan DFU yang terpasang saat ini. Beberapa perangkat tidak
mendukung mode runtime DFU resmi dan dengan demikian tidak mendukung penggunaan auto-discovery
perintah ini. Untuk perangkat tersebut, menempatkan perangkat ke mode DFU secara manual (mis
dengan menahan tombol saat me-reboot perangkat) akan membuatnya muncul di sini.

Lepaskan
Perintah ini melepaskan perangkat berkemampuan DFU yang terpasang saat ini menjadi perangkat khusus
modus pemrograman. Sementara perangkat dalam mode DFU khusus ini tidak dapat digunakan
sebagai perangkat biasa. Misalnya, printer tidak akan menerima dokumen saat berada di DFU
mode.

melampirkan
Perintah ini melampirkan perangkat berkemampuan DFU kembali ke runtime sehingga dapat digunakan sebagai
perangkat biasa. Beberapa perangkat tidak mendukung pemasangan, dan perlu dilakukan secara manual
terputus dan terhubung sebelum mengubah mode.

menonton
Perintah ini melihat perangkat DFU sedang dicolokkan dan dapat digunakan untuk memverifikasi libdfu
cocok dengan mode runtime dan DFU saat memasang dan melepaskan. Menggunakan CTRL + C untuk
membuat perintah ini berhenti.

Baca baca NAMA FILE
Perintah ini mengunggah semua firmware dari perangkat ke dalam file. Jika perangkat memiliki
beberapa partisi diekspor sebagai bagian alternatif yang berbeda maka semuanya akan
dibaca ke dalam file format DfuSe multi-gambar. Jika Anda hanya ingin isi satu
partisi, baca-alt adalah perintah yang Anda inginkan.

baca-alt NAMA FILE NAMA-ALT-PERANGKAT|ID-ALT-PERANGKAT
Perintah ini mengunggah firmware dari satu partisi ke dalam file. Anda dapat menentukan
partisi dengan ALT-ID atau ALT-NAME jika disetel.

misalnya dfu-alat baca-alt cadangan.dfu SRAM

menulis
Perintah ini mengunduh firmware dari file ke semua kemungkinan partisi a
perangkat. Jika Anda hanya ingin menulis satu partisi, menulis-alt adalah perintah kamu
ingin.

menulis-alt NAMA FILE NAMA-ALT-PERANGKAT|ID-ALT-PERANGKAT [NAMA-ALT-GAMBAR|ID-GAMBAR-ALT]
Perintah ini mengunduh firmware dari file ke dalam satu partisi. Anda dapat menentukan
partisi dengan ALT-ID atau ALT-NAME jika disetel.

misalnya dfu-alat menulis-alt sram.dfu SRAM __SRAM

PERANGKAT LUNAK PERINTAH

Perintah ini digunakan untuk membaca dan memodifikasi file firmware yang ada.

membuang NAMA FILE
Perintah ini membuang semua detail yang diketahui tentang file firmware. Peta memori lengkap
ditampilkan, bersama dengan metadata atau informasi vendor tentang file firmware.

mengubah FORMAT FILE-IN KELUAR FILE [UKURAN]
Perintah ini mengonversi firmware dari satu format ke format lainnya, opsional padding
ke ukuran tertentu. Kemungkinan nilai untuk tujuan FORMAT termasuk: mentah, ihex,
dfu dan dfuse. NS FILE-IN dan KELUAR FILE nilainya bisa sama jika file sumber
adalah untuk ditimpa. Meskipun padding meningkatkan ukuran file tanpa terlihat
keuntungan dapat digunakan untuk mendukung perangkat yang tidak menyimpan gambar runtime
ukuran dan di mana validasi firmware tertulis diperlukan.

misalnya dfu-alat mengubah dfu firmware.hex firmware.dfu 8000

mengenkripsi NAMA FILE-IN NAMA FILE- KELUAR JENIS KUNCI
Perintah ini mengenkripsi data firmware. Hanya konten gambar yang sebenarnya
dimodifikasi, footer DFU dan header DfuSe dibiarkan tidak berubah. Nilai yang mungkin untuk
tempat tujuan JENIS termasuk: xtea dan nop. jika KUNCI bukan dari yang dibutuhkan
panjang itu digunakan sebagai input ke fungsi hash yang dapat menghasilkan kunci dari
ukuran yang dibutuhkan.

misalnya dfu-alat mengenkripsi firmware.dfu firmware.xdfu xtea deadbeef

mendekripsi NAMA FILE-IN NAMA FILE- KELUAR JENIS KUNCI
Perintah ini mendekripsi data firmware. Hanya konten gambar yang sebenarnya
dimodifikasi, footer DFU dan header DfuSe dibiarkan tidak berubah. Nilai yang mungkin untuk
tempat tujuan JENIS termasuk: xtea dan nop. jika KUNCI bukan dari yang dibutuhkan
panjang itu digunakan sebagai input ke fungsi hash yang dapat menghasilkan kunci dari
ukuran yang dibutuhkan.

misalnya dfu-alat mendekripsi firmware.xdfu firmware.dfu xtea deadbeef

bergabung KELUAR FILE FILE1 FILE2 [FILE3...]
Perintah ini menggabungkan beberapa file firmware menjadi satu file. Meskipun Anda dapat menggabungkan
file dengan ALT-ID atau ALT-NAME yang sama, ini mungkin bukan yang ingin Anda lakukan.

misalnya dfu-alat bergabung gabungan.dfu lib.dfu app.dfu

set-alt-pengaturan FILE ID-ALT
Perintah ini mengubah nomor alternatif pada file firmware.

misalnya dfu-alat set-alt-pengaturan firmware.dfu 1

set-alt-nama-pengaturan
Perintah ini mengubah nama alternatif pada file firmware.

misalnya dfu-alat set-alt-nama-pengaturan firmware.dfu SRAM

set-metadata FILE KUNCI NILAI
Perintah ini menambahkan atau memodifikasi metadata yang ada pada file firmware. CATATAN: Ada
hanya ruang penyimpanan metadata yang sangat terbatas dalam file DFU, jadi kunci dan nilai harus
disimpan sesingkat mungkin. Secara khusus, nilai Lisensi harus ditentukan dalam
format SPDX.

misalnya dfu-alat set-metadata firmware.dfu lisensi GPL-2.0+

vendor set FILE VID
Perintah ini menetapkan ID vendor pada file firmware yang akan digunakan untuk mencocokkan tertentu
perangkat. Nilai ffff akan cocok dengan vendor perangkat mana pun.

misalnya dfu-alat vendor set firmware.dfu 273f

set-produk FILE PID
Perintah ini mengatur ID produk pada file firmware yang akan digunakan untuk mencocokkan
perangkat tertentu. Nilai ffff akan cocok dengan produk perangkat apa pun.

misalnya dfu-alat set-produk firmware.dfu 1004

set-rilis FILE RELEASE
Perintah ini mengatur versi rilis pada file firmware yang akan digunakan untuk mencocokkan
perangkat tertentu. Nilai ffff akan cocok dengan rilis perangkat apa pun.

misalnya dfu-alat set-rilis firmware.dfu ffff

Gunakan dfu-tool online menggunakan layanan onworks.net