dfu-tool - En ligne dans le Cloud

PROGRAMME:

Nom

dfu-tool - Outil de mise à niveau du micrologiciel de l'appareil

SYNOPSIS

dfu-outil [ --verbeux ] [ --version ] [ --Obliger ] [ --device=VID:PID ] [ --transfert-
taille=octets ]

DESCRIPTION

Cette page de manuel documente brièvement les dfu-outil commander.

dfu-outil permet à un utilisateur d'écrire différents types de micrologiciels sur des appareils prenant en charge l'USB
Protocole de mise à niveau du micrologiciel de l'appareil. Cet outil peut être utilisé pour faire passer l'appareil de la
mode d'exécution normal au « mode DFU » qui permet à l'utilisateur de lire et d'écrire le firmware.
Soit l'ensemble du périphérique peut être écrit en une seule opération, soit des « cibles » individuelles peuvent être
spécifié avec le nom ou le numéro alternatif.

dfu-outil utilise la bibliothèque partagée libdfu pour effectuer des actions. Toutes les actions synchrones peuvent
être annulé en toute sécurité et en cas d'échec renverra des erreurs avec à la fois un type et un texte intégral
la description. libdfu prend en charge DFU 1.0, DFU 1.1 et l'extension du fournisseur ST DfuSe, et
gère de nombreuses « bizarreries » de périphérique nécessaires aux implémentations réelles de DFU.

En outre dfu-outil peut être utilisé pour convertir le firmware de différents formats, ou
pour modifier les détails des éléments, images et métadonnées contenus dans le firmware
déposer. Par exemple, vous pouvez facilement convertir le micrologiciel DFU 1.1 en DfuSe spécifique au fournisseur
format, convertir un fichier Intel HEX en un fichier brut rembourré à une taille spécifique, ou ajouter de nouveaux
les informations de copyright et de licence dans un fichier existant. Des champs tels que le fournisseur et
les ID de produit peuvent être modifiés et les éléments du micrologiciel peuvent être chiffrés et déchiffrés à l'aide
diverses méthodes différentes. La fusion de deux fichiers DfuSe est également possible, bien que
spécifier différents nombres de paramètres alt avant de fusionner est une bonne idée pour éviter toute confusion.

Bien que dfu-outil essaie de fournir un grand nombre de commandes faciles à utiliser, il se peut
possible de faire certaines opérations en utilisant directement la bibliothèque libdfu. C'est plus facile que
cela sonne, car la bibliothèque est construite avec la prise en charge de GObject Introspection, ce qui la rend utilisable dans
de nombreux langages tels que C, Javascript et Python. De plus, l'utilisation de la bibliothèque est une bonne
idée si vous souhaitez effectuer plusieurs opérations sur de gros fichiers de firmware, par exemple,
conversion à partir d'un fichier Intel HEX, remplissage à une certaine taille, définition du fournisseur et ajout
les informations de licence, puis l'enregistrement dans un emplacement distant.

OPTIONS

Ce programme suit la syntaxe habituelle de la ligne de commande GNU, avec de longues options commençant par
deux tirets (-). Un résumé des options est inclus ci-dessous.

--Aidez-moi
Afficher le résumé de toutes les commandes disponibles pour une utilisation.

--version
Afficher la version de dfu-outil installé.

--verbeux
Afficher des informations de débogage supplémentaires.

--device=VID:PID
Si plusieurs appareils compatibles DFU sont connectés, vous pouvez spécifier le fournisseur spécifique
et l'ID de produit de l'appareil DFU que vous souhaitez interroger.

--transfer-size = octets
Remplacez manuellement la taille de chaque transfert USB, ce que vous souhaiterez peut-être pour des raisons de fiabilité
matériel ou lorsque le périphérique se trouve à propos de la taille de paquet maximale qu'il accepte.

--Obliger
Forcer l'opération, sans tenir compte des avertissements ou des vérifications d'intégrité comme le fichier CRC et
sommes de contrôle. Ceci est utile si vous savez vraiment ce que vous faites, ou dans le
cas spécialisé de fuzz-testing libdfu.

DISPOSITIF COMMANDES

Ces commandes sont utilisées pour l'interface avec les appareils compatibles DFU.

liste
Cette commande répertorie les périphériques compatibles DFU actuellement connectés. Certains appareils ne
prend en charge le mode d'exécution officiel DFU et ne prend donc pas en charge la découverte automatique à l'aide
cette commande. Pour ces appareils, mettre l'appareil en mode DFU manuellement (par ex.
en maintenant un bouton enfoncé lors du redémarrage de l'appareil) le fera apparaître ici.

détacher
Cette commande détache le périphérique compatible DFU actuellement connecté dans un
mode de programmation. Tant que l'appareil est dans ce mode DFU spécial, il ne peut pas être utilisé
comme un appareil normal. Par exemple, une imprimante n'acceptera pas les documents lorsqu'elle est en DFU
mode.

joindre
Cette commande rattache un périphérique compatible DFU à l'exécution afin qu'il puisse être utilisé comme
appareil normal. Certains appareils ne prennent pas en charge la connexion et doivent être manuellement
déconnecté et connecté avant de changer de mode.

montre de luxe.
Cette commande surveille les périphériques DFU en cours de branchement à chaud et peut être utilisée pour vérifier libdfu
correspond aux modes d'exécution et DFU lors de l'attachement et du détachement. Utilisation CTRL + C à
faire quitter cette commande.

lire NOM DE FICHIER
Cette commande télécharge tout le firmware de l'appareil dans un fichier. Si l'appareil a
plusieurs partitions exportées en tant que différentes sections alternatives, elles seront toutes
être lu dans un fichier multi-images au format DfuSe. Si vous voulez juste le contenu d'un
cloison, lecture-alt est la commande que vous voulez.

lecture-alt NOM DE FICHIER APPAREIL-ALT-NOM|APPAREIL-ALT-ID
Cette commande télécharge le firmware d'une partition dans un fichier. Vous pouvez spécifier le
partition par ALT-ID ou ALT-NAME s'il est défini.

par exemple dfu-outil lecture-alt sauvegarde.dfu SRAM

écrire
Cette commande télécharge le firmware d'un fichier dans toutes les partitions possibles d'un
dispositif. Si vous ne voulez écrire qu'une seule partition, écriture-alt est la commande que vous
vouloir.

écriture-alt NOM DE FICHIER APPAREIL-ALT-NOM|APPAREIL-ALT-ID [IMAGE-ALT-NAME|IMAGE-ALT-ID]
Cette commande télécharge le micrologiciel du fichier dans une partition. Vous pouvez spécifier
la partition par l'ALT-ID ou ALT-NAME s'il est défini.

par exemple dfu-outil écriture-alt sram.dfu SRAM __SRAM

FIRMWARE COMMANDES

Ces commandes sont utilisées pour lire et modifier les fichiers de firmware existants.

déverser NOM DE FICHIER
Cette commande vide tous les détails connus sur un fichier de micrologiciel. La carte mémoire complète
s'affiche, ainsi que toutes les métadonnées ou informations sur le fournisseur concernant le fichier du micrologiciel.

convertir Format ENREGISTREMENT FILE-SORTIE [TAILLE]
Cette commande convertit le micrologiciel d'un format à un autre, en remplissant éventuellement
à une certaine taille. Valeurs possibles pour la destination Format inclure : brut, ihex,
dfu et dfuse. Les ENREGISTREMENT ainsi que FILE-SORTIE les valeurs peuvent être les mêmes si le fichier source
doit être écrasé. Bien que le rembourrage augmente la taille du fichier sans
avantages, il peut être utilisé pour prendre en charge les périphériques qui ne stockent pas l'image d'exécution
taille et où la validation du micrologiciel écrit est requise.

par exemple dfu-outil convertir Dfu firmware.hex firmware.dfu 8000

crypter NOM DE FICHIER-IN FILENAME-OUT TYPE clé - KEY
Cette commande crypte les données du micrologiciel. Seul le contenu de l'image est réellement
modifiés, le pied de page DFU et l'en-tête DfuSe restent inchangés. Valeurs possibles pour
la destination TYPE comprennent: xtea et nop. Si la clé - KEY n'est pas du nécessaire
longueur, il est utilisé comme entrée d'une fonction de hachage qui peut produire une clé de la
taille requise.

par exemple dfu-outil crypter firmware.dfu firmware.xdfu xtéa boeuf mort

décrypter NOM DE FICHIER-IN FILENAME-OUT TYPE clé - KEY
Cette commande décrypte les données du micrologiciel. Seul le contenu de l'image est réellement
modifiés, le pied de page DFU et l'en-tête DfuSe restent inchangés. Valeurs possibles pour
la destination TYPE comprennent: xtea et nop. Si la clé - KEY n'est pas du nécessaire
longueur, il est utilisé comme entrée d'une fonction de hachage qui peut produire une clé de la
taille requise.

par exemple dfu-outil décrypter firmware.xdfu firmware.dfu xtéa boeuf mort

fusionner FILE-SORTIE FICHIER1 FICHIER2 [FICHIER3...]
Cette commande fusionne plusieurs fichiers de firmware en un seul fichier. Bien que vous puissiez fusionner
fichiers avec le même ALT-ID ou ALT-NAME, ce n'est probablement pas ce que vous voulez faire.

par exemple dfu-outil fusionner combiné.dfu lib.dfu app.dfu

set-alt-setting DOSSIER ALT-ID
Cette commande modifie le numéro alternatif sur le fichier du firmware.

par exemple dfu-outil set-alt-setting firmware.dfu 1

set-alt-nom-du-paramètre
Cette commande modifie le nom alternatif sur le fichier du firmware.

par exemple dfu-outil set-alt-nom-du-paramètre firmware.dfu SRAM

ensemble-métadonnées DOSSIER clé - KEY VALEURE
Cette commande ajoute ou modifie des métadonnées existantes sur un fichier de firmware. REMARQUE : il y a
seulement un espace de stockage de métadonnées très limité dans les fichiers DFU, donc les clés et les valeurs doivent être
aussi courte que possible. En particulier, la valeur de la licence doit être spécifiée dans
format SPDX.

par exemple dfu-outil ensemble-métadonnées firmware.dfu Licence GPL-2.0 +

set-vendeur DOSSIER VID
Cette commande définit l'ID du fournisseur sur un fichier de micrologiciel qui sera utilisé pour correspondre à des
dispositifs. Les valeurs de ffff correspondront à n'importe quel fournisseur de périphérique.

par exemple dfu-outil set-vendeur firmware.dfu 273f

ensemble-produit DOSSIER PID
Cette commande définit l'ID du produit sur un fichier de micrologiciel qui sera utilisé pour correspondre
appareils spécifiques. Les valeurs de ffff correspondront à n'importe quel produit d'appareil.

par exemple dfu-outil ensemble-produit firmware.dfu 1004

ensemble-libération DOSSIER PRESSE
Cette commande définit la version de version sur le fichier de firmware qui sera utilisé pour correspondre
appareils spécifiques. Les valeurs de ffff correspondront à n'importe quelle version de l'appareil.

par exemple dfu-outil ensemble-libération firmware.dfu ffff

Utiliser dfu-tool en ligne en utilisant les services onworks.net