dfu-tool - Online na nuvem

PROGRAMA:

NOME

dfu-tool - Ferramenta de atualização de firmware do dispositivo

SINOPSE

ferramenta dfu [ --verbose ] [ --versão ] [ --força ] [ --device = VID: PID ] [ --transferir-
tamanho = BYTES ]

DESCRIÇÃO

Esta página de manual documenta resumidamente o ferramenta dfu comando.

ferramenta dfu permite que um usuário escreva vários tipos de firmware em dispositivos que suportam o USB
Protocolo de atualização do firmware do dispositivo. Esta ferramenta pode ser usada para trocar o dispositivo do
modo de tempo de execução normal para `modo DFU 'que permite ao usuário ler e escrever firmware.
Tanto o dispositivo inteiro pode ser escrito em uma operação, ou 'alvos' individuais podem ser
especificado com o nome ou número alternativo.

ferramenta dfu usa a biblioteca compartilhada libdfu para realizar ações. Todas as ações síncronas podem
ser cancelado com segurança e em caso de falha retornará erros com um tipo e um texto completo
Descrição. libdfu suporta DFU 1.0, DFU 1.1 e a extensão do fornecedor ST DfuSe, e
lida com muitas 'peculiaridades' de dispositivos necessárias para as implementações do DFU no mundo real.

Adicionalmente ferramenta dfu pode ser usado para converter firmware de vários formatos diferentes, ou
para modificar detalhes sobre os elementos, imagens e metadados contidos no firmware
Arquivo. Por exemplo, você pode converter facilmente o firmware DFU 1.1 no DfuSe específico do fornecedor
formato, converta um arquivo Intel HEX em um arquivo bruto preenchido com um tamanho específico ou adicione um novo
copyright e informações de licenciamento para um arquivo existente. Campos como o vendedor e
IDs de produto podem ser alterados e os elementos de firmware podem ser criptografados e descriptografados usando
vários métodos diferentes. Mesclar dois arquivos DfuSe também é possível, embora
especificar diferentes números de configuração alt antes de mesclar é uma boa ideia para evitar confusão.

Apesar ferramenta dfu tenta fornecer um grande número de comandos fáceis de usar, pode ser apenas
possível fazer certas operações usando a biblioteca libdfu diretamente. Isso é mais fácil do que
parece, como a biblioteca é construída com suporte GObject Introspection tornando-o utilizável em
muitas linguagens como C, Javascript e Python. Além disso, usar a biblioteca é uma boa
ideia se você deseja realizar várias operações em grandes arquivos de firmware, por exemplo,
conversão de um arquivo Intel HEX, preenchimento para um determinado tamanho, configuração do fornecedor e adição
informações de licenciamento e salvá-las em um local remoto.

OPÇÕES

Este programa segue a sintaxe de linha de comando GNU usual, com longas opções começando com
dois travessões (-). Um resumo das opções está incluído abaixo.

--Socorro
Mostra o resumo de todos os comandos disponíveis para uso.

--versão
Mostra a versão de ferramenta dfu instalado.

--verbose
Mostra informações extras de depuração.

--device = VID: PID
Se vários dispositivos compatíveis com DFU estiverem conectados, você pode especificar o fornecedor específico
e o ID do produto do dispositivo DFU que você deseja consultar.

--transfer-size = BYTES
Substitua manualmente o tamanho de cada transferência USB, o que você pode desejar para não confiável
hardware ou quando o dispositivo está sobre o tamanho máximo de pacote que aceita.

--força
Força a operação, desconsiderando avisos ou verificações de integridade como arquivo CRC e
somas de verificação. Isso é útil se você realmente sabe o que está fazendo, ou no
caso especializado de fuzz-testing libdfu.

DISPOSITIVO COMANDOS

Esses comandos são usados ​​para fazer interface com dispositivos compatíveis com DFU.

Lista
Este comando lista os dispositivos compatíveis com DFU atualmente conectados. Alguns dispositivos não
suportam o modo de tempo de execução oficial DFU e, portanto, não suportam descoberta automática usando
este comando. Para esses dispositivos, colocar o dispositivo no modo DFU manualmente (por exemplo
mantendo um botão pressionado ao reiniciar o dispositivo) fará com que apareça aqui.

desanexar
Este comando desconecta o dispositivo compatível com DFU conectado em um
modo de programação. Embora o dispositivo esteja neste modo DFU especial, ele não pode ser usado
como um dispositivo normal. Por exemplo, uma impressora não aceitará documentos quando em DFU
modo.

anexar
Este comando anexa um dispositivo capaz de DFU de volta ao tempo de execução para que possa ser usado como um
dispositivo normal. Alguns dispositivos não suportam conexão e precisam ser manualmente
desconectado e conectado antes de alterar os modos.

Assistir
Este comando observa dispositivos DFU sendo hotplugados e pode ser usado para verificar libdfu
corresponde aos modos de tempo de execução e DFU ao conectar e desconectar. Usar CTRL + C para
faça este comando sair.

ler NOME DO ARQUIVO
Este comando carrega todo o firmware do dispositivo em um arquivo. Se o dispositivo tiver
múltiplas partições exportadas como diferentes seções alternativas, então todas
ser lido em um arquivo de formato DfuSe de várias imagens. Se você quer apenas o conteúdo de um
partição, leitura-alt é o comando que você deseja.

leitura-alt NOME DO ARQUIVO DEVICE-ALT-NAME | DEVICE-ALT-ID
Este comando carrega firmware de uma partição em um arquivo. Você pode especificar o
partição por ALT-ID ou ALT-NAME, se definido.

por exemplo, ferramenta dfu leitura-alt backup.dfu SRAM

escrever
Este comando baixa o firmware de um arquivo em todas as partições possíveis de um
dispositivo. Se você quiser gravar apenas uma partição, escrever-alt é o comando que você
quer.

escrever-alt NOME DO ARQUIVO DEVICE-ALT-NAME | DEVICE-ALT-ID [IMAGEM-ALT-NOME | IMAGEM-ALT-ID]
Este comando baixa o firmware do arquivo em uma partição. Você pode especificar
a partição por ALT-ID ou ALT-NAME, se definido.

por exemplo, ferramenta dfu escrever-alt sram.dfu SRAM __SRAM

FIRMWARE COMANDOS

Esses comandos são usados ​​para ler e modificar arquivos de firmware existentes.

despejar NOME DO ARQUIVO
Este comando despeja todos os detalhes conhecidos sobre um arquivo de firmware. O mapa de memória completo
é mostrado, junto com quaisquer metadados ou informações do fornecedor sobre o arquivo de firmware.

converter FORMATO ARQUIVO EM SAÍDA DE ARQUIVO [TAMANHO]
Este comando converte o firmware de um formato para outro, opcionalmente preenchendo
até um certo tamanho. Valores possíveis para o destino FORMATO incluem: cru, ihex,
dfu e dfuse. o ARQUIVO EM e SAÍDA DE ARQUIVO os valores podem ser os mesmos se o arquivo de origem
deve ser sobrescrito. Embora o preenchimento aumente o tamanho do arquivo sem aparente
vantagens pode ser usado para suportar dispositivos que não armazenam a imagem em tempo de execução
tamanho e onde a validação do firmware escrito é necessária.

por exemplo, ferramenta dfu converter dfu firmware.hex firmware.dfu 8000

criptografar NOME DO ARQUIVO-IN NOME DO ARQUIVO-OUT TIPO KEY
Este comando criptografa os dados do firmware. Apenas o conteúdo da imagem é realmente
modificado, o rodapé DFU e o cabeçalho DfuSe permanecem inalterados. Valores possíveis para
o destino TIPO incluem: xtea e nop. Se o KEY não é do necessário
comprimento é usado como uma entrada para uma função hash que pode produzir uma chave do
tamanho necessário.

por exemplo, ferramenta dfu criptografar firmware.dfu firmware.xdfu xtea carne morta

descriptografar NOME DO ARQUIVO-IN NOME DO ARQUIVO-OUT TIPO KEY
Este comando descriptografa os dados do firmware. Apenas o conteúdo da imagem é realmente
modificado, o rodapé DFU e o cabeçalho DfuSe permanecem inalterados. Valores possíveis para
o destino TIPO incluem: xtea e nop. Se o KEY não é do necessário
comprimento é usado como uma entrada para uma função hash que pode produzir uma chave do
tamanho necessário.

por exemplo, ferramenta dfu descriptografar firmware.xdfu firmware.dfu xtea carne morta

fundir SAÍDA DE ARQUIVO ARQUIVO 1 ARQUIVO 2 [FILE3 ...]
Este comando mescla vários arquivos de firmware em um arquivo. Embora você possa mesclar
arquivos com o mesmo ALT-ID ou ALT-NAME provavelmente não é o que você deseja fazer.

por exemplo, ferramenta dfu fundir combinado.dfu lib.dfu aplicativo.dfu

definir-alt-configuração ARQUIVO Alt ID
Este comando modifica o número alternativo no arquivo de firmware.

por exemplo, ferramenta dfu definir-alt-configuração firmware.dfu 1

set-alt-nome-da-configuração
Este comando modifica o nome alternativo no arquivo de firmware.

por exemplo, ferramenta dfu set-alt-nome-da-configuração firmware.dfu SRAM

set-metadados ARQUIVO KEY VALOR
Este comando adiciona ou modifica metadados existentes em um arquivo de firmware. NOTA: Existe
espaço de armazenamento de metadados muito limitado em arquivos DFU, portanto, as chaves e os valores devem ser
mantido o mais curto possível. Em particular, o valor da licença deve ser especificado em
Formato SPDX.

por exemplo, ferramenta dfu set-metadados firmware.dfu Licença GPL-2.0 +

set-vendedor ARQUIVO VID
Este comando define o ID do fornecedor em um arquivo de firmware que será usado para corresponder
dispositivos. Os valores de ffff corresponderão a qualquer fornecedor de dispositivo.

por exemplo, ferramenta dfu set-vendedor firmware.dfu 273f

produto conjunto ARQUIVO PID
Este comando define o ID do produto em um arquivo de firmware que será usado para corresponder
dispositivos específicos. Os valores de ffff corresponderão a qualquer produto do dispositivo.

por exemplo, ferramenta dfu produto conjunto firmware.dfu 1004

lançamento definido ARQUIVO DIVULGAÇÃO
Este comando define a versão de lançamento no arquivo de firmware que será usado para corresponder
dispositivos específicos. Os valores de ffff corresponderão a qualquer versão do dispositivo.

por exemplo, ferramenta dfu lançamento definido firmware.dfu ffff

Use a ferramenta dfu online usando os serviços onworks.net