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

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

Compilar e instalar o exemplo de dispositivo HID virtual do CFU

1. Instale o Visual Studio 2019 e o WDK (Windows Driver Kit), conforme descrito no Download do WDK (Windows Driver Kit).

2. Clonar o repositório de 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 submodule DMF (Driver Module Framework) necessário para compilar o exemplo:

   git submodule init

   git submodule update

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

   1. Navegue até o local do arquivo 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 Compilar, selecione Compilar Solução. Você deverá ver o texto de saída indicando que a solução foi criada com êxito:

      

5. Instalar 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ê deverá 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 , conforme mostrado aqui:

   

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

9. Selecione a guia Detalhes na janela de diálogo Propriedades do Dispositivo CfuVirtualHid e 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ó do CfuVirtualHid, expanda o nó do dispositivo Virtual HID Framework (VHF) e selecione o item de 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 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ê deverá ver HID\VID_045E&UP:FA00_U:00F5 na lista de valores Valor, conforme mostrado aqui:

    

Instalar uma atualização de firmware para o dispositivo HID virtual da 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 usando a ferramenta de linha de comando devcon.exe, conforme descrito na seção acima.

1. Navegue até o local dos arquivos .inf, de oferta de firmware e dos arquivos de carga útil .bin para o seu 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 do firmware, vá para a seção [Standard.NTamd64] 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

   Esse comando retornará a saída do Utilitário PnP . Por exemplo:

   

5. No Gerenciador de Dispositivos, navegue até o nó do dispositivo CfuVirtualHid e expanda o nó para verificar se a Atualização de Firmware cfuVirtualHidDevice foi instalada, conforme mostrado aqui:

   

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

   

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

   

8. Verifique se o dispositivo HID\VID_045E&UP:FA00_U:00F5 aparece nos IDs de HardwareValor da Firmware Update do CfuVirtualHidDevice.

   

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