dfu-tool - Bulutta Çevrimiçi

Program:

ADI

dfu-tool - Aygıt Ürün Yazılımı Yükseltme Aracı

SİNOPSİS

dfu aracı [ --ayrıntılı ] [ --versiyon ] [ --Kuvvet ] [ --cihaz=VID:PID ] [ --Aktar-
boyut=BAYT ]

TANIM

Bu kılavuz sayfası kısaca şunları belgelemektedir: dfu aracı Komut.

dfu aracı kullanıcının USB'yi destekleyen cihazlara çeşitli türlerde ürün yazılımı yazmasına izin verir.
Cihaz Ürün Yazılımı Yükseltme protokolü. Bu araç, cihazdan geçiş yapmak için kullanılabilir.
normal çalışma zamanı modu, kullanıcının bellenimi okumasına ve yazmasına izin veren 'DFU modu'na.
Ya tüm aygıt tek bir işlemle yazılabilir ya da bireysel "hedefler" yazılabilir.
alternatif ad veya numara ile belirtilir.

dfu aracı eylemleri gerçekleştirmek için libdfu paylaşılan kitaplığını kullanır. Tüm senkron eylemler
güvenli bir şekilde iptal edilebilir ve başarısızlık durumunda hem tür hem de tam metin ile ilgili hatalar döndürülür.
tanım. libdfu, DFU 1.0, DFU 1.1 ve ST DfuSe satıcı uzantısını destekler ve
DFU'nun gerçek dünyadaki uygulamaları için gerekli olan birçok cihaz "tuhaflığını" ele alır.

Ayrıca dfu aracı bellenimi çeşitli farklı biçimlerden dönüştürmek için kullanılabilir veya
bellenimin içerdiği öğeler, resimler ve meta verilerle ilgili ayrıntıları değiştirmek için
dosya. Örneğin, DFU 1.1 ürün yazılımını satıcıya özel DfuSe yazılımına kolayca dönüştürebilirsiniz.
biçimlendirin, bir Intel HEX dosyasını belirli bir boyuta doldurulmuş ham bir dosyaya dönüştürün veya yeni
mevcut bir dosyaya telif hakkı ve lisans bilgileri. Satıcı gibi alanlar ve
ürün kimlikleri değiştirilebilir ve ürün yazılımı öğeleri kullanılarak şifrelenebilir ve şifresi çözülebilir.
çeşitli farklı yöntemler. İki DfuSe dosyasını birleştirmek de mümkündür, ancak
birleştirmeden önce farklı alt-ayar numaraları belirtmek, karışıklığı önlemek için iyi bir fikirdir.

Rağmen dfu aracı çok sayıda kullanımı kolay komut sağlamaya çalışırsa, yalnızca
libdfu kitaplığını doğrudan kullanarak belirli işlemleri yapmak mümkündür. Bu daha kolay
kütüphane GObject Introspection desteği ile oluşturulduğu için kulağa hoş geliyor.
C, Javascript ve Python gibi birçok dil. Ayrıca, kütüphaneyi kullanmak iyi bir
örneğin, büyük üretici yazılımı dosyalarında birden çok işlem yapmak istiyorsanız,
Intel HEX dosyasından dönüştürme, belirli bir boyuta doldurma, satıcı ayarlama ve ekleme
lisans bilgileri ve ardından uzak bir konuma kaydetme.

SEÇENEKLER

Bu program, uzun seçeneklerle başlayan olağan GNU komut satırı sözdizimini izler.
iki tire (-). Seçeneklerin bir özeti aşağıda yer almaktadır.

--yardım et
Kullanılabilir tüm komutların özetini göster.

--versiyon
sürümünü göster dfu aracı yüklü.

--ayrıntılı
Ekstra hata ayıklama bilgilerini göster.

--cihaz=VID:PID
Birden fazla DFU özellikli cihaz takılıysa, belirli satıcıyı belirtebilirsiniz
ve sorgulamak istediğiniz DFU cihazının ürün kimliği.

--transfer-boyutu=BAYT
Güvenilir olmayan durumlar için isteyebileceğiniz her bir USB aktarımının boyutunu manuel olarak geçersiz kılın.
donanım veya cihaz kabul ettiği maksimum paket boyutu hakkında yalan söylediğinde.

--Kuvvet
CRC dosyası gibi uyarıları veya sağlık kontrollerini göz ardı ederek işlemi zorlayın ve
sağlama toplamı. Bu, ne yaptığınızı gerçekten biliyorsanız veya
fuzz testi libdfu'nun özel durumu.

CİHAZ KOMUTLAR

Bu komutlar, DFU özellikli cihazlarla arayüz oluşturmak için kullanılır.

liste
Bu komut, şu anda bağlı olan DFU özellikli cihazları listeler. Bazı cihazlar
resmi DFU çalışma zamanı modunu destekleyin ve bu nedenle kullanarak otomatik bulmayı desteklemeyin
bu komut. Bu cihazlar için cihazı manuel olarak DFU moduna almak (örn.
cihazı yeniden başlatırken bir düğmeyi basılı tutarak) burada görünmesini sağlayacaktır.

DETACH
Bu komut, halihazırda takılı olan DFU özellikli aygıtı özel bir
programlama modu Cihaz bu özel DFU modundayken kullanılamaz.
normal bir cihaz olarak Örneğin, bir yazıcı DFU'dayken belgeleri kabul etmeyecektir.
modu.

iliştirmek
Bu komut, DFU özellikli bir cihazı çalışma zamanına geri ekler, böylece bir
normal cihaz. Bazı cihazlar eklemeyi desteklemez ve manuel olarak yapılması gerekir.
modları değiştirmeden önce bağlantı kesildi ve bağlandı.

izle
Bu komut, çalışırken takılı olan DFU aygıtlarını izler ve libdfu'yu doğrulamak için kullanılabilir
takarken ve çıkarırken çalışma zamanı ve DFU modlarıyla eşleşir. Kullanmak CTRL + C için
bu komutu kapatın.

okumak DOSYA ADI
Bu komut, cihazdaki tüm bellenimi bir dosyaya yükler. cihaz varsa
farklı alternatif bölümler olarak dışa aktarılan birden fazla bölüm, o zaman hepsi
çok görüntülü bir DfuSe-format dosyasına okunabilir. Sadece birinin içeriğini istiyorsanız
bölüm, alt oku istediğiniz komuttur.

alt oku DOSYA ADI CİHAZ-ALT-ADI|CİHAZ-ALT-ID
Bu komut, bellenimi bir bölümden bir dosyaya yükler. belirtebilirsiniz
ayarlanmışsa, ALT-ID veya ALT-NAME ile bölün.

Örneğin dfu aracı alt oku yedekleme.dfu SRAM

yazmak
Bu komut, bellenimi bir dosyadan bir dosyanın tüm olası bölümlerine indirir.
cihaz. Yalnızca bir bölüm yazmak istiyorsanız, alt yaz komut sen misin
istemek.

alt yaz DOSYA ADI CİHAZ-ALT-ADI|CİHAZ-ALT-ID [RESİM-ALT-NAME|GÖRÜNTÜ-ALT-ID]
Bu komut, bellenimi dosyadan tek bir bölüme indirir. belirtebilirsiniz
ayarlanmışsa, ALT-ID veya ALT-NAME ile bölüm.

Örneğin dfu aracı alt yaz sram.dfu SRAM __SRAM

YAZILIM KOMUTLAR

Bu komutlar, mevcut üretici yazılımı dosyalarını okumak ve değiştirmek için kullanılır.

dökmek DOSYA ADI
Bu komut, bir bellenim dosyasıyla ilgili tüm bilinen ayrıntıları atar. Tam hafıza haritası
bellenim dosyasıyla ilgili herhangi bir meta veri veya satıcı bilgisi ile birlikte gösterilir.

dönüştürmek FORMAT DOSYASINDA DOSYA ÇIKIŞI [BOYUT]
Bu komut, bellenimi isteğe bağlı olarak dolgu olmak üzere bir biçimden diğerine dönüştürür.
belirli bir boyuta. Hedef için olası değerler FORMAT şunları içerir: ham, ihex,
dfu ve dfuse. NS DOSYASINDA ve DOSYA ÇIKIŞI kaynak dosya varsa değerler aynı olabilir
üzerine yazılmasıdır. Dolgu, dosya boyutunu belirgin bir şekilde artırmasa da
çalışma zamanı görüntüsünü saklamayan cihazları desteklemek için kullanılabilir avantajları
boyutu ve yazılı ürün yazılımının doğrulanmasının gerekli olduğu yerler.

Örneğin dfu aracı dönüştürmek dfu bellenim.hex bellenim.dfu 8000

şifrelemek DOSYA ADI-GİRİŞİ DOSYA ADI ÇIKIŞI TİP ANAHTAR
Bu komut, bellenim verilerini şifreler. Yalnızca görüntü içerikleri aslında
değiştirildiğinde, DFU altbilgisi ve DfuSe üstbilgisi değiştirilmeden bırakılır. için olası değerler
hedef TİP şunları içerir: xtea ve nop. Eğer ANAHTAR gerekli değil
uzunluğunun bir anahtarını üretebilen bir karma işlevine girdi olarak kullanılır.
gerekli boyut.

Örneğin dfu aracı şifrelemek bellenim.dfu bellenim.xdfu çay sığır eti

şifresini DOSYA ADI-GİRİŞİ DOSYA ADI ÇIKIŞI TİP ANAHTAR
Bu komut, bellenim verilerinin şifresini çözer. Yalnızca görüntü içerikleri aslında
değiştirildiğinde, DFU altbilgisi ve DfuSe üstbilgisi değiştirilmeden bırakılır. için olası değerler
hedef TİP şunları içerir: xtea ve nop. Eğer ANAHTAR gerekli değil
uzunluğunun bir anahtarını üretebilen bir karma işlevine girdi olarak kullanılır.
gerekli boyut.

Örneğin dfu aracı şifresini bellenim.xdfu bellenim.dfu çay sığır eti

birleştirme DOSYA ÇIKIŞI DOSYA1 DOSYA2 [DOSYA3...]
Bu komut, birden çok üretici yazılımı dosyasını tek bir dosyada birleştirir. Birleştirebilsen de
aynı ALT-ID veya ALT-NAME ile dosyalar, muhtemelen yapmak istediğiniz şey bu değil.

Örneğin dfu aracı birleştirme kombine.dfu kitap.dfu uygulama.dfu

set-alt-ayar DOSYA ALT-ID
Bu komut, bellenim dosyasındaki alternatif numarayı değiştirir.

Örneğin dfu aracı set-alt-ayar bellenim.dfu 1

set-alt-ayar-adı
Bu komut, bellenim dosyasındaki alternatif adı değiştirir.

Örneğin dfu aracı set-alt-ayar-adı bellenim.dfu SRAM

set-meta verisi DOSYA ANAHTAR DEĞER
Bu komut, bir bellenim dosyasındaki mevcut meta verileri ekler veya değiştirir. NOT: var
DFU dosyalarında yalnızca çok sınırlı meta veri depolama alanı olduğundan, anahtarlar ve değerler
mümkün olduğunca kısa tutulmuştur. Özellikle, Lisans değeri şurada belirtilmelidir:
SPDX formatı.

Örneğin dfu aracı set-meta verisi bellenim.dfu Lisans GPL-2.0 +

set satıcısı DOSYA VID
Bu komut, belirli eşleştirmek için kullanılacak bir üretici yazılımı dosyasında satıcı kimliğini ayarlar.
cihazlar. ffff değerleri herhangi bir cihaz satıcısıyla eşleşecektir.

Örneğin dfu aracı set satıcısı bellenim.dfu 273f

set-ürün DOSYA PID
Bu komut, ürün kimliğini eşleştirmek için kullanılacak bir ürün yazılımı dosyasında ayarlar.
belirli cihazlar. ffff değerleri herhangi bir cihaz ürünüyle eşleşecektir.

Örneğin dfu aracı set-ürün bellenim.dfu 1004

set bırakma DOSYA RELEASE
Bu komut, eşleştirmek için kullanılacak ürün yazılımı dosyasındaki yayın sürümünü ayarlar.
belirli cihazlar. ffff değerleri herhangi bir cihaz sürümüyle eşleşecektir.

Örneğin dfu aracı set bırakma bellenim.dfu ffff

onworks.net hizmetlerini kullanarak dfu aracını çevrimiçi kullanın