dfu-tool - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

dfu-tool - інструмент оновлення мікропрограми пристрою

СИНТАКСИС

dfu-інструмент [ -багатослівний ] [ -- версія ] [ --сила ] [ --device=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 у необроблений файл із доповненням до певного розміру або додайте новий
інформацію про авторські права та ліцензії на наявний файл. Такі поля, як постачальник і
Ідентифікатори продуктів можна змінювати, а елементи мікропрограми можна шифрувати та розшифровувати за допомогою
різні різні методи. Хоча також можливо об’єднання двох файлів DfuSe
Щоб уникнути плутанини, перед об’єднанням бажано вказати різні номери налаштувань альтернативи.

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

ВАРІАНТИ

Ця програма дотримується звичайного синтаксису командного рядка GNU з довгими параметрами, які починаються з
дві риски (-). Нижче наведено короткий опис варіантів.

--допомога
Показати підсумок усіх команд, доступних для використання.

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

-багатослівний
Показати додаткову інформацію про налагодження.

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

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

--сила
Примусово виконувати операцію, нехтуючи попередженнями чи перевірками працездатності, як-от файл CRC і
контрольні суми. Це корисно, якщо ви дійсно знаєте, що робите, або в
спеціалізований випадок fuzz-тестування libdfu.

ПРИСТРІЙ КОМАНДИ

Ці команди використовуються для взаємодії з пристроями, які підтримують DFU.

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

від'єднати
Ця команда від’єднує поточний під’єднаний пристрій із підтримкою DFU у спец
режим програмування. Поки пристрій знаходиться в цьому спеціальному режимі DFU, його не можна використовувати
як звичайний пристрій. Наприклад, принтер не прийматиме документи в DFU
Режим.

приєднувати
Ця команда повертає пристрій із підтримкою DFU до середовища виконання, щоб його можна було використовувати як
нормальний пристрій. Деякі пристрої не підтримують підключення, і їх потрібно вручну
від’єднано та під’єднано перед зміною режимів.

дивитися
Ця команда спостерігає за гарячим підключенням пристроїв DFU і може використовуватися для перевірки libdfu
відповідає режимам виконання та DFU під час приєднання та від’єднання. Використовуйте CTRL + C до
змусити цю команду вийти.

зчитування ФІЛЕНАМ
Ця команда завантажує все мікропрограмне забезпечення з пристрою у файл. Якщо пристрій має
кілька розділів експортуються як різні альтернативні розділи, то всі вони будуть
зчитуватися у файл у форматі DfuSe з кількома зображеннями. Якщо ви хочете лише вміст одного
перегородка, читання-альт це команда, яку ви хочете.

читання-альт ФІЛЕНАМ DEVICE-ALT-NAME|DEVICE-ALT-ID
Ця команда завантажує мікропрограму з одного розділу у файл. Ви можете вказати
розділити за ALT-ID або ALT-NAME, якщо встановлено.

наприклад dfu-інструмент читання-альт backup.dfu SRAM

запис
Ця команда завантажує мікропрограму з файлу в усі можливі розділи a
пристрій. Якщо ви хочете написати лише один розділ, запис-альт це наказ тобі
хочеш

запис-альт ФІЛЕНАМ DEVICE-ALT-NAME|DEVICE-ALT-ID [IMAGE-ALT-NAME|IMAGE-ALT-ID]
Ця команда завантажує мікропрограму з файлу в один розділ. Ви можете вказати
розділ за допомогою ALT-ID або ALT-NAME, якщо встановлено.

наприклад dfu-інструмент запис-альт sram.dfu SRAM __SRAM

ФІРМА КОМАНДИ

Ці команди використовуються для читання та зміни існуючих файлів мікропрограми.

дамп ФІЛЕНАМ
Ця команда видає всі відомості про файл мікропрограми. Повна карта пам'яті
відображається разом з будь-якими метаданими або інформацією про постачальника про файл мікропрограми.

конвертувати ФОРМАТ FILE-IN FILE-OUT [РІЗМ]
Ця команда перетворює мікропрограму з одного формату в інший, за бажанням заповнюючи
до певного розміру. Можливі значення для призначення ФОРМАТ включають: raw, ihex,
dfu і dfuse. The FILE-IN та FILE-OUT значення можуть бути однаковими, якщо вихідний файл
підлягає перезапису. Хоча заповнення збільшує розмір файлу без видимого
переваги його можна використовувати для підтримки пристроїв, які не зберігають образ під час виконання
розмір і де потрібна перевірка написаного мікропрограмного забезпечення.

наприклад dfu-інструмент конвертувати dfu прошивка.hex firmware.dfu 8000

шифрувати FILENAME-IN FILENAME-OUT TYPE KEY
Ця команда шифрує дані мікропрограми. Фактично лише вміст зображення
змінено, нижній колонтитул DFU і заголовок DfuSe залишаються незмінними. Можливі значення для
пункт призначення TYPE включають: xtea і nop. Якщо KEY не є обов'язковим
довжина використовується як вхідні дані для хеш-функції, яка може створити ключ
необхідний розмір.

наприклад dfu-інструмент шифрувати firmware.dfu firmware.xdfu xtea deadbeef

розшифровувати FILENAME-IN FILENAME-OUT TYPE KEY
Ця команда розшифровує дані прошивки. Фактично лише вміст зображення
змінено, нижній колонтитул DFU і заголовок DfuSe залишаються незмінними. Можливі значення для
пункт призначення TYPE включають: xtea і nop. Якщо KEY не є обов'язковим
довжина використовується як вхідні дані для хеш-функції, яка може створити ключ
необхідний розмір.

наприклад dfu-інструмент розшифровувати firmware.xdfu firmware.dfu xtea deadbeef

злиття FILE-OUT ФАЙЛ1 ФАЙЛ2 [ФАЙЛ3...]
Ця команда об’єднує декілька файлів мікропрограми в один файл. Хоча можна об’єднати
файли з однаковим ALT-ID або ALT-NAME, ймовірно, це не те, що ви хочете зробити.

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

встановити-альт-налаштування Фото ALT-ID
Ця команда змінює альтернативний номер у файлі мікропрограми.

наприклад dfu-інструмент встановити-альт-налаштування firmware.dfu 1

set-alt-setting-name
Ця команда змінює альтернативну назву файлу мікропрограми.

наприклад dfu-інструмент set-alt-setting-name firmware.dfu SRAM

набір метаданих Фото KEY VALUE
Ця команда додає або змінює наявні метадані у файлі мікропрограми. ПРИМІТКА: Є
лише дуже обмежений простір для зберігання метаданих у файлах DFU, тому ключі та значення мають бути
якомога коротше. Зокрема, слід вказати вартість ліцензії в
Формат SPDX.

наприклад dfu-інструмент набір метаданих firmware.dfu Ліцензія GPL-2.0+

набір-постачальник Фото VID
Ця команда встановлює ідентифікатор постачальника у файлі мікропрограми, який буде використовуватися для відповідності певному
пристроїв. Значення ffff будуть відповідати будь-якому постачальнику пристрою.

наприклад dfu-інструмент набір-постачальник firmware.dfu 273f

набір-продукт Фото PID
Ця команда встановлює ідентифікатор продукту у файлі мікропрограми, який буде використовуватися для відповідності
конкретні пристрої. Значення ffff відповідатимуть будь-якому продукту пристрою.

наприклад dfu-інструмент набір-продукт firmware.dfu 1004

встановити-звільнити Фото РЕЛІЗ
Ця команда встановлює версію випуску у файлі мікропрограми, яка буде використовуватися для відповідності
конкретні пристрої. Значення ffff відповідатимуть будь-якому випуску пристрою.

наприклад dfu-інструмент встановити-звільнити firmware.dfu ffff

Використовуйте dfu-tool онлайн за допомогою служб onworks.net