dfu-tool - Интернет в облаке

ПРОГРАММА:

ИМЯ

dfu-tool - Инструмент обновления прошивки устройства

СИНТАКСИС

dfu-инструмент [ --подробный ] [ --версия ] [ --сила ] [ --device = VID: PID ] [ --передача-
size = BYTES ]

ОПИСАНИЕ

Эта страница руководства кратко документирует dfu-инструмент команда.

dfu-инструмент позволяет пользователю записывать различные типы прошивки на устройства, поддерживающие USB
Протокол обновления прошивки устройства. Этот инструмент можно использовать для переключения устройства из
от нормального рабочего режима до «режима DFU», который позволяет пользователю читать и записывать микропрограммное обеспечение.
Либо все устройство может быть записано за одну операцию, либо отдельные `` цели '' могут быть
указан с альтернативным именем или номером.

dfu-инструмент использует разделяемую библиотеку libdfu для выполнения действий. Все синхронные действия могут
будет безопасно отменен, и в случае сбоя будет возвращать ошибки как с типом, так и с полным текстом
описание. libdfu поддерживает DFU 1.0, DFU 1.1 и расширение поставщика ST DfuSe, а также
обрабатывает многие "причуды" устройства, необходимые для реальной реализации DFU.

Дополнительно dfu-инструмент может использоваться для конвертации прошивки из различных форматов или
для изменения сведений об элементах, изображениях и метаданных, содержащихся в прошивке
файл. Например, вы можете легко преобразовать прошивку DFU 1.1 в специфичную для производителя версию DfuSe.
форматировать, преобразовать файл Intel HEX в необработанный файл, дополненный до определенного размера, или добавить новый
информация об авторских правах и лицензировании существующего файла. Такие поля, как поставщик и
идентификаторы продуктов могут быть изменены, а элементы прошивки могут быть зашифрованы и расшифрованы с помощью
различные разные методы. Также возможно объединение двух файлов DfuSe, хотя
чтобы избежать путаницы, рекомендуется указать разные номера альтернативных настроек перед слиянием.

Несмотря на то, что dfu-инструмент пытается предоставить большое количество простых в использовании команд, это может быть только
можно выполнять определенные операции напрямую с помощью библиотеки libdfu. Это легче чем
это звучит, поскольку библиотека построена с поддержкой GObject Introspection, что делает ее пригодной для использования в
многие языки, такие как C, Javascript и Python. Кроме того, использование библиотеки - хороший
идея, если вы хотите выполнить несколько операций с большими файлами прошивки, например,
преобразование из файла Intel HEX, заполнение до определенного размера, установка поставщика и добавление
информацию о лицензировании, а затем сохраните ее в удаленном месте.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Эта программа следует обычному синтаксису командной строки GNU с длинными параметрами, начинающимися с
два тире (-). Сводка опций приведена ниже.

--Помогите
Показать сводку всех доступных для использования команд.

--версия
Показать версию dfu-инструмент установлен.

--подробный
Показать дополнительную отладочную информацию.

--device = VID: PID
Если подключено несколько устройств с поддержкой DFU, вы можете указать конкретного поставщика.
и идентификатор продукта устройства DFU, которое вы хотите запросить.

--transfer-size = БАЙТЫ
Вручную измените размер каждой передачи USB, что может потребоваться из-за ненадежности
оборудования или когда устройство не соответствует максимальному размеру пакета, который оно принимает.

--сила
Принудительно выполнить операцию, игнорируя предупреждения или проверки работоспособности, такие как CRC файла и
контрольные суммы. Это полезно, если вы действительно знаете, что делаете, или в
специализированный кейс фазз-тестирования libdfu.

УСТРОЙСТВО КОМАНДЫ

Эти команды используются для взаимодействия с устройствами с поддержкой DFU.

список
Эта команда выводит список подключенных в настоящее время устройств с поддержкой DFU. Некоторые устройства не
поддерживают официальный режим выполнения DFU и, следовательно, не поддерживают автоматическое обнаружение с помощью
эту команду. Для этих устройств перевод устройства в режим DFU вручную (например,
удерживая кнопку при перезагрузке устройства) отобразит его здесь.

DETACH
Эта команда отключает подключенное в данный момент устройство с поддержкой DFU в специальный
режим программирования. Пока устройство находится в этом специальном режиме DFU, его нельзя использовать.
как обычный аппарат. Например, принтер не принимает документы в DFU.
Режим.

прикреплять
Эта команда подключает устройство с поддержкой DFU обратно к среде выполнения, чтобы его можно было использовать в качестве
нормальный аппарат. Некоторые устройства не поддерживают подключение, и их необходимо вручную
отключены и подключены перед изменением режимов.

смотреть
Эта команда отслеживает горячее подключение устройств DFU и может использоваться для проверки libdfu.
согласовывает режимы выполнения и DFU при присоединении и отсоединении. Использовать CTRL + C в
закрыть эту команду.

читать ИМЯ ФАЙЛА
Эта команда загружает всю прошивку с устройства в файл. Если на устройстве есть
несколько разделов, экспортированных как разные альтернативные разделы, тогда все они будут
быть прочитанным в файл формата DfuSe с несколькими изображениями. Если вам просто нужно содержимое одного
раздел, чтение-альт это та команда, которую вы хотите.

чтение-альт ИМЯ ФАЙЛА УСТРОЙСТВО-ALT-NAME | УСТРОЙСТВО-ALT-ID
Эта команда загружает прошивку из одного раздела в файл. Вы можете указать
разделение по ALT-ID или ALT-NAME, если установлено.

например dfu-инструмент чтение-альт резервная копия.dfu SRAM

записывать
Эта команда загружает прошивку из файла во все возможные разделы
устройство. Если вы хотите записать только один раздел, писать-альтернативный это команда, которую вы
хотеть.

писать-альтернативный ИМЯ ФАЙЛА УСТРОЙСТВО-ALT-NAME | УСТРОЙСТВО-ALT-ID [ИЗОБРАЖЕНИЕ-ALT-NAME | ИЗОБРАЖЕНИЕ-ALT-ID]
Эта команда загружает прошивку из файла в один раздел. Вы можете указать
раздел с помощью ALT-ID или ALT-NAME, если он установлен.

например dfu-инструмент писать-альтернативный срам.дфу SRAM __SRAM

МИКРОПРОГРАММЫ КОМАНДЫ

Эти команды используются для чтения и изменения существующих файлов прошивки.

дамп ИМЯ ФАЙЛА
Эта команда выводит все известные сведения о файле прошивки. Полная карта памяти
отображается вместе с любыми метаданными или информацией о поставщике файла микропрограммы.

конвертировать ФОРМАТ ПОДПИСАТЬСЯ ФАЙЛ-ВНЕ [РАЗМЕР]
Эта команда преобразует прошивку из одного формата в другой, при желании дополняя
до определенного размера. Возможные значения для пункта назначения ФОРМАТ включают: raw, 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 чай говядина

слияние ФАЙЛ-ВНЕ FILE1 FILE2 [ФАЙЛ3 ...]
Эта команда объединяет несколько файлов прошивки в один файл. Хотя можно слить
файлы с одинаковым ALT-ID или ALT-NAME, вероятно, это не то, что вы хотите делать.

например dfu-инструмент слияние комбинированный.dfu lib.dfu app.dfu

set-alt-настройка ФАЙЛОВ ALT-ID
Эта команда изменяет альтернативный номер в файле прошивки.

например dfu-инструмент set-alt-настройка прошивка.dfu 1

set-alt-имя-настройки
Эта команда изменяет альтернативное имя в файле прошивки.

например dfu-инструмент set-alt-имя-настройки прошивка.dfu SRAM

набор метаданных ФАЙЛОВ KEY VALUE
Эта команда добавляет или изменяет существующие метаданные в файле прошивки. ПРИМЕЧАНИЕ: есть
только очень ограниченное пространство для хранения метаданных в файлах DFU, поэтому ключи и значения должны быть
сохранены как можно короче. В частности, значение Лицензии должно быть указано в
Формат SPDX.

например dfu-инструмент набор метаданных прошивка.dfu Лицензия GPL-2.0 +

набор-продавец ФАЙЛОВ AT
Эта команда устанавливает идентификатор поставщика в файле прошивки, который будет использоваться для соответствия определенным
устройств. Значения ffff будут соответствовать любому поставщику устройства.

например dfu-инструмент набор-продавец прошивка.dfu 273f

набор-продукт ФАЙЛОВ PID
Эта команда устанавливает идентификатор продукта в файле прошивки, который будет использоваться для сопоставления
конкретные устройства. Значения ffff будут соответствовать любому устройству продукта.

например dfu-инструмент набор-продукт прошивка.dfu 1004

набор-релиз ФАЙЛОВ РЕЛИЗ
Эта команда устанавливает версию выпуска в файле прошивки, которая будет использоваться для соответствия
конкретные устройства. Значения ffff соответствуют любой версии устройства.

например dfu-инструмент набор-релиз прошивка.dfu FFFF

Используйте dfu-tool онлайн с помощью сервисов onworks.net