Simulação de atualização de firmware do dispositivo HID virtual CFU

Este tópico fornece um passo a passo de uma atualização de firmware simulada em um dispositivo HID virtual.

Criar e instalar o exemplo de dispositivo HID virtual CFU

1. Instale o Visual Studio 2019 e o Kit de Driver do Windows (WDK) conforme descrito em Baixar o Kit de Driver do Windows (WDK).

2. Clone o repositório CFU da Microsoft em um diretório de repositório local

   git clone https://github.com/microsoft/CFU.git

3. No diretório do repositório CFU local, em um prompt de comando, execute os seguintes comandos git para obter o submódulo DMF (Driver Module Framework) necessário para criar o exemplo:

   git submodule init

   git submodule update

4. Crie a solução de dispositivo CfuVirtualHid no Visual Studio

   1. Navegue até o local do arquivo de CfuVirtualHid.sln em seu sistema de desenvolvimento. Por exemplo:

      C:\<your_repo_folder>\CFU\Host\CFUFirmwareSimulation\CfuVirtualHid.sln

   2. Abra o arquivo CfuVirtualHid.sln no Visual Studio.

   3. No menu Build, selecione a opção Build Solution. Você verá o texto de saída indicando que a solução foi criada com êxito:

      

5. Instale o dispositivo e o driver CfuVirtualHid

   1. Navegue até o local do arquivo cfuvirtualhid.inf em seu sistema de desenvolvimento. Por exemplo:

      C:\<your_repo_folder>\CFU\Host\CFUFirmwareSimulation\x64\Debug\CfuVirtualHid

   2. Em um prompt de comando administrativo, execute o seguinte comando:

      devcon.exe install cfuvirtualhid.inf HID\CFU_VIRTUAL_DEVICE
      

      Você verá o texto de saída indicando que o dispositivo virtual foi instalado com êxito:

      

6. No Painel de Controle, abra o Gerenciador de Dispositivos, selecione o menu Exibir e selecione o item de menu Dispositivos por tipo .

7. Na lista de dispositivos, expanda o nó Firmware e selecione o dispositivo CfuVirtualHid como mostrado aqui:

   

8. Clique com o botão direito do mouse no dispositivo CfuVirtualHid para abrir o menu de contexto e, em seguida, clique no item de menu Propriedades para abrir a janela de diálogo Propriedades do dispositivo CfuVirtualHid .

9. Selecione o separador Detalhes na janela de diálogo Propriedades do dispositivo CfuVirtualHid e, em seguida, selecione IDs de Hardware na lista suspensa Propriedade.

   Você deve ver o HID\CFU_VIRTUAL_DEVICE na caixa de listagem Valor , conforme mostrado aqui:

   

10. No menu Gerenciador de dispositivos , selecione o menu Exibir e selecione o item de menu Dispositivos por conexão .

    

11. Navegue até o Dispositivo CfuVirtualHid e expanda o nó Dispositivo CfuVirtualHid, expanda o nó Virtual HID Framework (VHF) dispositivo HID e selecione o item da lista Dispositivo compatível com HID conforme mostrado aqui:

    

12. Clique com o botão direito do mouse no dispositivo compatível com HID para abrir o menu de contexto e, em seguida, clique no item de menu Propriedades para abrir a janela de diálogo Propriedades do dispositivo compatível com HID .

13. Selecione a guia Detalhes na janela de diálogo Propriedades do dispositivo compatível com HID e, em seguida, selecione Ids de hardware na lista suspensa Propriedade .

    Você deve ver HID\VID_045E&UP:FA00_U:00F5 na caixa de listagem Valor , conforme mostrado aqui:

    

Instalar uma atualização de firmware para o dispositivo HID virtual CFU

Esta seção fornece um exemplo de instalação de uma atualização de firmware no dispositivo de exemplo CfuVirtualHid Device criado no Visual Studio 2019 e instalado utilizando a ferramenta de linha de comando devcon.exe, conforme descrito na seção acima.

1. Navegue até ao local do ficheiro .inf e dos ficheiros de firmware e de carga útil .bin para o dispositivo de destino. Por exemplo:

   

2. Em um editor de texto, abra o arquivo INF de atualização de firmware. Neste exemplo, usaremos o arquivo CfuVirtualHidDeviceFwUpdate.inf descrito na configuração CFU INF.

3. No arquivo INF de atualização de firmware, vá para a [Standard.NTamd64] seção e verifique se as seguintes informações existem para o dispositivo HID\VID_045E&UP:FA00_U:00F5 :

   [Standard.NTamd64]
   %CfuVirtualHidDeviceFwUpdate.DeviceDesc%=CfuVirtualHidDeviceFwUpdate, HID\VID_045E&UP:FA00_U:00F5 ; HardwareID for VirtualHidDevice MCU
   
   [CfuVirtualHidDeviceFwUpdate.NT]
   Include            = HidCfu.inf
   Needs              = HidCfu.NT
   CopyFiles          = CfuVirtualHidDeviceFwUpdate.CopyFiles
   
   [CfuVirtualHidDeviceFwUpdate.NT.Wdf]
   Include            = HidCfu.inf
   Needs              = HidCfu.NT.Wdf
   

4. Em um prompt de comando administrativo, execute o seguinte comando:

   pnputil /add-driver CfuVirtualHidDeviceFwUpdate.inf /install

   Este comando retornará a saída do utilitário PnP . Por exemplo:

   

5. No Gerenciador de dispositivos, navegue até o nó Dispositivo CfuVirtualHid e expanda o nó para verificar se a atualização de firmware CfuVirtualHidDevice foi instalada, conforme mostrado aqui:

   

6. Selecione o nó Atualização de firmware CfuVirtualHidDevice e, em seguida, abra a janela Propriedades de atualização de firmware CfuVirtualHidDevice , conforme mostrado aqui:

   

7. Na janela Propriedades de Atualização de Firmware CfuVirtualHidDevice , selecione a guia Detalhes e, em seguida, selecione Ids de Hardware na lista suspensa Propriedade , conforme mostrado aqui:

   

8. Verifique se o dispositivo HID\VID_045E&UP:FA00_U:00F5 aparece no Hardware IdsValor da atualização de firmware do CfuVirtualHidDevice.

   

9. Use o aplicativo TraceView para exibir informações de mensagens de log para a instalação do dispositivo HID virtual CFU. Por exemplo: