dfu-tool - 云端在线

程序：

您的姓名

dfu-tool - 设备固件升级工具

概要

dfu工具 [ --详细 [ - 版 [ - 力量 [ --设备=VID:PID [ - 转移-
大小=字节 ]

商品描述

本手册页简要记录了 dfu工具 命令。

dfu工具 允许用户将各种固件写入支持 USB 的设备上
设备固件升级协议。 此工具可用于从设备切换设备
正常运行模式到“DFU 模式”，允许用户读写固件。
可以在一次操作中写入整个设备，也可以写入单个“目标”
用替代名称或编号指定。

dfu工具 使用 libdfu 共享库来执行操作。 所有同步动作都可以
被安全取消，失败时将返回带有类型和全文的错误
描述。 libdfu 支持 DFU 1.0、DFU 1.1 和 ST DfuSe 供应商扩展，以及
处理 DFU 的实际实现所需的许多设备“怪癖”。

另外 dfu工具 可用于转换各种不同格式的固件，或
修改固件中包含的元素、图像和元数据的详细信息
文件。 例如，您可以轻松地将 DFU 1.1 固件转换为供应商特定的 DfuSe
格式，将 Intel HEX 文件转换为填充到特定大小的原始文件，或添加新的
现有文件的版权和许可信息。 诸如供应商和
可以更改产品 ID，并且可以使用以下方法对固件元素进行加密和解密
各种不同的方法。 将两个 DfuSe 文件合并在一起也是可能的，尽管
在合并之前指定不同的 alt 设置数字是避免混淆的好主意。

尽管 dfu工具 试图提供大量易于使用的命令，它可能只是
可以直接使用 libdfu 库执行某些操作。 这比
听起来，因为该库是使用 GObject Introspection 支持构建的，因此可用于
许多语言，如 C、Javascript 和 Python。 此外，使用图书馆是一个很好的
如果你想对大型固件文件执行多项操作，例如，
从 Intel HEX 文件转换，填充到特定大小，设置供应商并添加
许可信息，然后保存到远程位置。

配置

该程序遵循通常的 GNU 命令行语法，长选项以
两个破折号 (-)。 下面是选项的摘要。

- 帮帮我
显示所有可用命令的摘要。

- 版
显示版本 dfu工具 安装。

--详细
显示额外的调试信息。

--设备=VID:PID
如果连接了多个支持 DFU 的设备，您可以指定特定的供应商
以及要查询的DFU设备的产品ID。

--传输大小=字节
手动覆盖每个 USB 传输的大小，这可能会导致不可靠
硬件或当设备处于它接受的最大数据包大小时。

- 力量
强制操作，无视警告或健全性检查，如文件 CRC 和
校验和。 如果您真的知道自己在做什么，或者在
模糊测试 libdfu 的特例。

支持装置 指令

这些命令用于与支持 DFU 的设备连接。

名单
此命令列出当前连接的支持 DFU 的设备。 有些设备没有
支持官方 DFU 运行时模式，因此不支持使用自动发现
这个命令。 对于这些设备，手动将设备置于 DFU 模式（例如
通过在重新启动设备时按住按钮）将使其显示在此处。

DETACH
此命令将当前连接的支持 DFU 的设备分离到一个特殊的
编程模式。 当设备处于这种特殊的 DFU 模式时，它无法使用
作为普通设备。 例如，打印机在 DFU 中将不接受文档
模式。

连接
此命令将支持 DFU 的设备连接回运行时，以便将其用作
正常设备。 部分设备不支持挂载，需要手动
在更改模式之前断开和连接。

看
此命令监视正在热插拔的 DFU 设备并可用于验证 libdfu
在附加和分离时匹配运行时和 DFU 模式。 用 CTRL + C 至
使这个命令退出。

读 文件名
此命令将设备中的所有固件上传到一个文件中。 如果设备有
多个分区导出为不同的替代部分，然后它们都将
读入多图像 DfuSe 格式文件。 如果你只想要一个的内容
划分， 阅读替代 是你想要的命令。

阅读替代 文件名 设备替代名称|设备替代 ID
此命令将固件从一个分区上传到一个文件中。 您可以指定
如果设置，则按 ALT-ID 或 ALT-NAME 进行分区。

例如 dfu工具 阅读替代 备份文件 SRAM

写
此命令将固件从文件下载到所有可能的分区
设备。 如果只想写一个分区， 写替代 是你的命令
想。

写替代 文件名 设备替代名称|设备替代 ID [图像-ALT-名称|图像-ALT-ID]
此命令将固件从文件下载到一个分区。 您可以指定
如果设置了 ALT-ID 或 ALT-NAME 的分区。

例如 dfu工具 写替代 sram文件 SRAM __静态随机存取存储器

固件 指令

这些命令用于读取和修改现有固件文件。

倾倒 文件名
此命令转储有关固件文件的所有已知详细信息。 完整的内存映射
显示，以及有关固件文件的任何元数据或供应商信息。

兑换 FORMAT 文件输入 文件输出 [尺寸]
此命令将固件从一种格式转换为另一种格式，可选择填充
到一定的规模。 目的地的可能值 FORMAT 包括：原始，ihex，
dfu 和 dfuse。 这 文件输入 和 文件输出 如果源文件，值可以相同
将被覆盖。 虽然填充增加了文件大小，但没有明显的
优点 可用于支持不存储运行时映像的设备
大小以及需要验证写入的固件的地方。

例如 dfu工具 兑换 DFU 固件.hex 固件.dfu 8000

加密 文件名输入 文件名输出 型 KEY
此命令加密固件数据。 实际上只有图像内容
修改后，DFU 页脚和 DfuSe 页眉保持不变。 可能的值
目的地 型 包括：xtea 和 nop。 如果 KEY 不是必需的
length 它用作散列函数的输入，该函数可以生成
所需尺寸。

例如 dfu工具 加密 固件.dfu 固件.xdfu 茶 死牛

解码 文件名输入 文件名输出 型 KEY
此命令解密固件数据。 实际上只有图像内容
修改后，DFU 页脚和 DfuSe 页眉保持不变。 可能的值
目的地 型 包括：xtea 和 nop。 如果 KEY 不是必需的
length 它用作散列函数的输入，该函数可以生成
所需尺寸。

例如 dfu工具 解码 固件.xdfu 固件.dfu 茶 死牛

合并 文件输出 文件1 文件2 [文件3...]
此命令将多个固件文件合并为一个文件。 虽然可以合并
具有相同 ALT-ID 或 ALT-NAME 的文件，这可能不是您想要做的。

例如 dfu工具 合并 结合.dfu dfu文件 应用程序.dfu

设置-alt-设置 文件 ALT-ID
此命令修改固件文件上的替代编号。

例如 dfu工具 设置-alt-设置 固件.dfu 1

设置替代设置名称
此命令修改固件文件上的备用名称。

例如 dfu工具 设置替代设置名称 固件.dfu SRAM

设置元数据 文件 KEY VALUE
此命令添加或修改固件文件上的现有元数据。 注意：有
DFU 文件中只有非常有限的元数据存储空间，所以键和值应该是
保持尽可能短。 特别是，License 值应该在
SPDX 格式。

例如 dfu工具 设置元数据 固件.dfu 执照 GPL-2.0 +

设置供应商 文件 VID
此命令在固件文件上设置供应商 ID，该文件将用于匹配特定的
设备。 ffff 的值将匹配任何设备供应商。

例如 dfu工具 设置供应商 固件.dfu 273f

套装产品 文件 PID
此命令在将用于匹配的固件文件上设置产品 ID
特定设备。 ffff 的值将匹配任何设备产品。

例如 dfu工具 套装产品 固件.dfu 1004

设置释放 文件 RELEASE
此命令在固件文件上设置将用于匹配的发布版本
特定设备。 ffff 的值将匹配任何设备版本。

例如 dfu工具 设置释放 固件.dfu FFFF

使用 onworks.net 服务在线使用 dfu-tool