Simulazione dell'aggiornamento del firmware del dispositivo HID virtuale CFU

In questo argomento viene fornita una procedura dettagliata di un aggiornamento del firmware simulato in un dispositivo HID virtuale.

Compilare e installare l'esempio di dispositivo HID virtuale CFU

1. Installare Visual Studio 2019 e Windows Driver Kit (WDK) come descritto in Scaricare Windows Driver Kit (WDK).

2. Clonare il repository Microsoft CFU in una directory del repository locale

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

3. Nella directory del repository CFU locale, al prompt dei comandi, eseguire i comandi Git seguenti per ottenere il modulo secondario DMF (Driver Module Framework) necessario per compilare l'esempio:

   git submodule init

   git submodule update

4. Compilare la soluzione del dispositivo CfuVirtualHid in Visual Studio

   1. Passare al percorso del file CfuVirtualHid.sln nel sistema di sviluppo. Ad esempio:

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

   2. Aprire il file CfuVirtualHid.sln in Visual Studio.

   3. Dal menu Compila scegliere Compila soluzione. Verrà visualizzato il testo di output che indica che la soluzione è stata compilata correttamente:

      

5. Installare il driver e il dispositivo CfuVirtualHid

   1. Passare al percorso del file cfuvirtualhid.inf nel sistema di sviluppo. Ad esempio:

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

   2. Al prompt dei comandi amministrativi eseguire il comando seguente:

      devcon.exe install cfuvirtualhid.inf HID\CFU_VIRTUAL_DEVICE
      

      Verrà visualizzato il testo di output che indica che il dispositivo virtuale è stato installato correttamente:

      

6. Da Pannello di controllo aprire Gestione dispositivi, selezionare il menu Visualizza e selezionare la voce di menu Dispositivi per tipo.

7. Nell'elenco dei dispositivi espandere il nodo Firmware e selezionare il dispositivo CfuVirtualHid come illustrato di seguito:

   

8. Fare clic con il pulsante destro del mouse sul dispositivo CfuVirtualHid per aprire il menu di scelta rapida, quindi scegliere la voce di menu Proprietà per aprire la finestra di dialogo Proprietà dispositivo CfuVirtualHid.

9. Selezionare la scheda Dettagli nella finestra di dialogo Proprietà dispositivo CfuVirtualHid, quindi selezionare ID hardware nell'elenco a discesa Proprietà .

   Nella casella di riepilogo Valore dovrebbe essere visualizzato HID\CFU_VIRTUAL_DEVICE come illustrato di seguito:

   

10. Nel menu Gestione dispositivi selezionare il menu Visualizza e selezionare la voce di menu Dispositivi per connessione.

    

11. Passare al dispositivo CfuVirtualHid ed espandere il nodo Dispositivo CfuVirtualHid, espandere il nodo dispositivo HID Framework virtuale (VHF) HID e selezionare la voce di elenco di dispositivi conformi a HID come illustrato di seguito:

    

12. Fare clic con il pulsante destro del mouse sul dispositivo conforme a HID per aprire il menu di scelta rapida, quindi scegliere la voce di menu Proprietà per aprire la finestra di dialogo Proprietà dispositivo conforme a HID.

13. Selezionare la scheda Dettagli nella finestra di dialogo Proprietà dispositivo conforme a HID, quindi selezionare ID hardware nell'elenco a discesa Proprietà .

    Nella casella di riepilogo Valore dovrebbe essere visualizzato HID\VID_045E&UP:FA00_U:00F5:

    

Installare un aggiornamento del firmware per il dispositivo HID virtuale CFU

Questa sezione fornisce un esempio di installazione di un aggiornamento del firmware nel dispositivo CfuVirtualHid di esempio integrato in Visual Studio 2019 e installato usando lo strumento da riga di comando devcon.exe come descritto nella sezione precedente.

1. Passare al percorso del file inf e all'offerta del firmware e ai file di payload .bin per il dispositivo di destinazione. Ad esempio:

   

2. In un editor di testo aprire il file INF di aggiornamento del firmware. In questo esempio si userà il file CfuVirtualHidDeviceFwUpdate.inf descritto nella configurazione inF CFU.

3. Nel file INF di aggiornamento del firmware passare alla [Standard.NTamd64] sezione e verificare che esistano le informazioni seguenti per il 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. Al prompt dei comandi amministrativi eseguire il comando seguente:

   pnputil /add-driver CfuVirtualHidDeviceFwUpdate.inf /install

   Questo comando restituirà l'output dell'utilità PnP. Ad esempio:

   

5. In Gestione dispositivi passare al nodo CfuVirtualHid Device (Dispositivo CfuVirtualHid), quindi espandere il nodo per verificare che l'aggiornamento del firmware CfuVirtualHidDevice sia stato installato, come illustrato di seguito:

   

6. Selezionare il nodo CfuVirtualHidDevice Firmware Update e quindi aprire la finestra CfuVirtualHidDevice Firmware Update Properties , come illustrato di seguito:

   

7. Nella finestra CfuVirtualHidProprietà aggiornamento firmware del dispositivo selezionare la scheda Dettagli, quindi selezionare ID hardware nell'elenco a discesa Proprietà, come illustrato di seguito:

   

8. Verificare che il dispositivo HID\VID_045E&UP:FA00_U:00F5 sia visualizzato nel valore ID hardware di CfuVirtualHidDevice Firmware Update.

   

9. Usare l'applicazione TraceView per visualizzare le informazioni sui messaggi di log per l'installazione del dispositivo HID virtuale CFU. Ad esempio: