dfu-tool - クラウドでオンライン

プログラム：

NAME

dfu-tool - デバイスファームウェアアップグレードツール

SYNOPSIS

dfu ツール [ -詳細 ] [ - バージョン ] [ - 力 ] [ --device=VID:PID ] [ - 移行-
サイズ=バイト ]

DESCRIPTION

このマニュアルページでは、 dfu ツール

dfu ツール ユーザーは、USB をサポートするデバイスにさまざまな種類のファームウェアを書き込むことができます。
デバイスファームウェアアップグレードプロトコル。 このツールを使用して、デバイスを
通常のランタイム モードから、ユーザーがファームウェアの読み書きを可能にする「DFU モード」に変更します。
デバイス全体を XNUMX 回の操作で書き込むことも、個々の「ターゲット」を書き込むこともできます。
代替の名前または番号で指定します。

dfu ツール libdfu 共有ライブラリを使用してアクションを実行します。 すべての同期アクションは、
安全にキャンセルでき、失敗するとタイプと全文の両方のエラーが返されます。
説明。 libdfu は、DFU 1.0、DFU 1.1、および ST DfuSe ベンダー拡張をサポートします。
DFU の実際の実装に必要な多くのデバイスの「癖」を処理します。

さらに dfu ツール ファームウェアをさまざまな形式から変換するために使用できます。または
ファームウェア内に含まれる要素、画像、メタデータの詳細を変更するため
ファイル。 たとえば、DFU 1.1 ファームウェアをベンダー固有の DfuSe に簡単に変換できます。
フォーマット、Intel HEX ファイルを特定のサイズにパディングされた RAW ファイルに変換するか、新しいファイルを追加します
著作権とライセンス情報を既存のファイルに追加します。 ベンダーや
製品 ID は変更でき、ファームウェア要素は次の方法で暗号化および復号化できます。
さまざまな方法。 XNUMX つの DfuSe ファイルを結合することも可能ですが、
混乱を避けるために、マージする前に別の alt 設定番号を指定することをお勧めします。

しかし dfu ツール 使いやすいコマンドを多数提供しようとしていますが、
libdfu ライブラリを直接使用して特定の操作を実行することが可能です。 これよりも簡単です
このライブラリは GObject Introspection サポートを使用して構築されているため、次のような場合に使用できるようです。
C、JavaScript、Python などの多くの言語。 また、図書館を利用するのも良いですね
たとえば、大きなファームウェア ファイルに対して複数の操作を実行したい場合に考えられます。
Intel HEX ファイルからの変換、特定のサイズへのパディング、ベンダーの設定、および追加
ライセンス情報を取得して、リモートの場所に保存します。

OPTIONS

このプログラムは通常のGNUコマンドライン構文に従い、長いオプションはで始まります
XNUMX つのダッシュ (-)。 オプションの概要を以下に示します。

- 助けて
使用可能なすべてのコマンドの概要を表示します。

- バージョン
のバージョンを表示する dfu ツール インストールされています。

-詳細
追加のデバッグ情報を表示します。

--device=VID:PID
複数の DFU 対応デバイスが接続されている場合は、特定のベンダーを指定できます
およびクエリする DFU デバイスの製品 ID。

--transfer-size=バイト
各 USB 転送のサイズを手動でオーバーライドします。これは、信頼性が低い場合に必要となる場合があります。
ハードウェアの問題、またはデバイスが受け入れる最大パケット サイズについて嘘をついている場合。

- 力
警告やファイル CRC などの健全性チェックを無視して操作を強制します。
チェックサム。 これは、自分が何をしているのかを本当に理解している場合、または
ファズテスト libdfu の特殊なケース。

デバイス コマンド

これらのコマンドは、DFU 対応デバイスとのインターフェースに使用されます。

リスト
このコマンドは、現在接続されている DFU 対応デバイスを一覧表示します。 一部のデバイスではサポートされません
公式の DFU ランタイム モードをサポートしているため、次を使用した自動検出はサポートされていません。
このコマンド。 これらのデバイスの場合、デバイスを手動で DFU モードにします (例:
デバイスを再起動するときにボタンを押し続けると、ここに表示されます。

デタッチ
このコマンドは、現在接続されている DFU 対応デバイスを特別なデバイスに接続解除します。
プログラミングモード。 デバイスがこの特別な DFU モードにある間は使用できません。
通常のデバイスとして。 たとえば、DFU の場合、プリンタはドキュメントを受け入れません。
モード。

アタッチ
このコマンドは、DFU 対応デバイスをランタイムに接続して戻し、デバイスをランタイムとして使用できるようにします。
通常のデバイス。 一部のデバイスはアタッチをサポートしていないため、手動でアタッチする必要があります
モードを変更する前に切断と接続を行ってください。

watch
このコマンドは、ホットプラグされている DFU デバイスを監視し、libdfu を検証するために使用できます。
アタッチおよびデタッチ時にランタイム モードと DFU モードを一致させます。 使用 CTRL + C 〜へ
このコマンドを終了させます。

read ファイル名
このコマンドは、すべてのファームウェアをデバイスからファイルにアップロードします。 デバイスに
複数のパーティションが異なる代替セクションとしてエクスポートされると、それらはすべてエクスポートされます。
マルチイメージ DfuSe 形式ファイルに読み込むことができます。 XNUMX つのコンテンツだけが必要な場合
パーティション、 読み取り代替 は必要なコマンドです。

読み取り代替 ファイル名 デバイスの代替名|デバイスの代替ID
このコマンドは、ファームウェアを XNUMX つのパーティションからファイルにアップロードします。 指定できるのは、
ALT-ID または ALT-NAME が設定されている場合は、そのいずれかによってパーティション化されます。

マシン情報の記入> という構文でなければなりません。例えば、 dfu ツール 読み取り代替 バックアップ.dfu SRAM

書きます
このコマンドは、ファイルからファームウェアを、可能なすべてのパーティションにダウンロードします。
デバイス。 XNUMXつのパーティションのみを書き込みたい場合は、 書き込み-代替 あなたの命令ですか
欲しいです。

書き込み-代替 ファイル名 デバイスの代替名|デバイスの代替ID [画像の代替名|画像の代替ID]
このコマンドは、ファームウェアをファイルから XNUMX つのパーティションにダウンロードします。 指定できます
ALT-ID または ALT-NAME (設定されている場合) によるパーティション。

マシン情報の記入> という構文でなければなりません。例えば、 dfu ツール 書き込み-代替 sram.dfu SRAM __SRAM

ファームウェア コマンド

これらのコマンドは、既存のファームウェア ファイルの読み取りと変更に使用されます。

ダンプ ファイル名
このコマンドは、ファームウェア ファイルに関する既知の詳細をすべてダンプします。 完全なメモリマップ
ファームウェア ファイルに関するメタデータまたはベンダー情報とともに表示されます。

変換 FORMAT ファイルイン ファイルアウト [サイズ]
このコマンドは、ファームウェアをある形式から別の形式に変換し、オプションでパディングを行います。
ある程度の大きさまで。 宛先に可能な値 FORMAT 含まれるもの: raw、ihex、
dfuとdfus。 の ファイルイン & ファイルアウト ソース ファイルの場合、値は同じにすることができます。
上書きされることになります。 パディングによってファイル サイズが増加することは明らかではありませんが、
ランタイム イメージを保存しないデバイスのサポートに使用できるという利点
サイズと、書き込まれたファームウェアの検証が必要な場合。

マシン情報の記入> という構文でなければなりません。例えば、 dfu ツール 変換 豆腐 ファームウェア.hex ファームウェア.dfu 8000

暗号化する ファイル名入力 ファイル名出力 タイプ キー
このコマンドはファームウェアデータを暗号化します。 実際にあるのは画像の内容だけです
変更しても、DFU フッターと DfuSe ヘッダーは変更されません。 可能な値
目的地 タイプ xtea と nop が含まれます。 もし キー 必須ではありません
長さは、キーを生成できるハッシュ関数への入力として使用されます。
必要なサイズ。

マシン情報の記入> という構文でなければなりません。例えば、 dfu ツール 暗号化する ファームウェア.dfu ファームウェア.xdfu エクスティー デッドビーフ

復号化 ファイル名入力 ファイル名出力 タイプ キー
このコマンドはファームウェアデータを復号化します。 実際にあるのは画像の内容だけです
変更しても、DFU フッターと DfuSe ヘッダーは変更されません。 可能な値
目的地 タイプ xtea と nop が含まれます。 もし キー 必須ではありません
長さは、キーを生成できるハッシュ関数への入力として使用されます。
必要なサイズ。

マシン情報の記入> という構文でなければなりません。例えば、 dfu ツール 復号化 ファームウェア.xdfu ファームウェア.dfu エクスティー デッドビーフ

マージ ファイルアウト ファイル1 ファイル2 [ファイル3...]
このコマンドは、複数のファームウェア ファイルを XNUMX つのファイルにマージします。 合併はできるものの、
同じ ALT-ID または ALT-NAME を持つファイルの場合、これはおそらくあなたがやりたいことではないでしょう。

マシン情報の記入> という構文でなければなりません。例えば、 dfu ツール マージ 結合.dfu lib.dfu アプリ.dfu

セット-alt-設定 FILE 代替 ID
このコマンドは、ファームウェア ファイルの代替番号を変更します。

マシン情報の記入> という構文でなければなりません。例えば、 dfu ツール セット-alt-設定 ファームウェア.dfu 1

セット代替設定名
このコマンドは、ファームウェア ファイルの代替名を変更します。

マシン情報の記入> という構文でなければなりません。例えば、 dfu ツール セット代替設定名 ファームウェア.dfu SRAM

セットメタデータ FILE キー VALUE
このコマンドは、ファームウェア ファイルの既存のメタデータを追加または変更します。 注: あります
DFU ファイル内のメタデータの保存スペースは非常に限られているため、キーと値は次のようにする必要があります。
できるだけ短くしてください。 特に、ライセンス値は次のように指定する必要があります。
SPDX形式。

マシン情報の記入> という構文でなければなりません。例えば、 dfu ツール セットメタデータ ファームウェア.dfu 資格 GPL-2.0+

セットベンダー FILE VID
このコマンドは、特定の照合に使用されるファームウェア ファイルにベンダー ID を設定します。
デバイス。 ffff の値は、どのデバイス ベンダーにも一致します。

マシン情報の記入> という構文でなければなりません。例えば、 dfu ツール セットベンダー ファームウェア.dfu 273f

セット商品 FILE PID
このコマンドは、照合に使用されるファームウェア ファイルに製品 ID を設定します。
特定のデバイス。 ffff の値は、どのデバイス製品にも一致します。

マシン情報の記入> という構文でなければなりません。例えば、 dfu ツール セット商品 ファームウェア.dfu 1004

セットリリース FILE RELEASE
このコマンドは、一致するために使用されるファームウェア ファイルのリリース バージョンを設定します。
特定のデバイス。 ffff の値は、どのデバイスのリリースにも一致します。

マシン情報の記入> という構文でなければなりません。例えば、 dfu ツール セットリリース ファームウェア.dfu FFFF

onworks.net サービスを使用してオンラインで dfu-tool を使用する