Firmwareupdatesimulation für virtuelle CFU-HID-Geräte

Dieses Thema enthält eine exemplarische Vorgehensweise für ein simuliertes Firmwareupdate auf einem virtuellen HID-Gerät.

Hinweis

CFU ist in Windows 10, Version 2004 (Windows 10 Mai 2020 Update) und höheren Versionen verfügbar.

Erstellen und Installieren des virtuellen CFU-HID-Gerätebeispiels

1. Installieren Sie Visual Studio 2019 und das Windows Driver Kit (WDK), wie unter "Herunterladen des Windows Driver Kit (WDK)" beschrieben.

2. Klonen des Microsoft CFU-Repositorys in ein lokales Repositoryverzeichnis

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

3. Führen Sie in Ihrem lokalen CFU-Repositoryverzeichnis an einer Eingabeaufforderung die folgenden Git-Befehle aus, um das zum Erstellen des Beispiels erforderliche DMF-Untermodul (Driver Module Framework) abzurufen:

   git submodule init

   git submodule update

4. Erstellen der CfuVirtualHid-Gerätelösung in Visual Studio

   1. Navigieren Sie zum Speicherort der datei CfuVirtualHid.sln in Ihrem Entwicklungssystem. Zum Beispiel:

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

   2. Öffnen Sie die datei CfuVirtualHid.sln in Visual Studio.

   3. Klicken Sie im Menü Build (Erstellen) auf Build Solution (Projektmappe erstellen). Ausgabetext sollte angezeigt werden, der angibt, dass die Lösung erfolgreich erstellt wurde:

      

5. Installieren des CfuVirtualHid-Geräts und -Treibers

   1. Navigieren Sie zum Speicherort der Datei "cfuvirtualhid.inf" auf Ihrem Entwicklungssystem. Zum Beispiel:

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

   2. Führen Sie an einer Administratorbefehlsaufforderung den folgenden Befehl aus:

      devcon.exe install cfuvirtualhid.inf HID\CFU_VIRTUAL_DEVICE
      

      Ausgabetext sollte angezeigt werden, der angibt, dass das virtuelle Gerät erfolgreich installiert wurde:

      

6. Öffnen Sie in Systemsteuerung Geräte-Manager, wählen Sie das Menü "Ansicht" und dann das Menüelement "Geräte" aus.

7. Erweitern Sie in der Geräteliste den Firmwareknoten , und wählen Sie das CfuVirtualHid-Gerät aus, wie hier gezeigt:

   

8. Klicken Sie mit der rechten Maustaste auf das CfuVirtualHid-Gerät , um das Kontextmenü zu öffnen, und klicken Sie dann auf das Menüelement "Eigenschaften" , um das Dialogfeld "CfuVirtualHid Device Properties " zu öffnen.

9. Wählen Sie im Dialogfeld "Eigenschaften von CfuVirtualHid Device Properties" die Registerkarte "Details" und dann in der Dropdownliste "Eigenschaft" die Option "Hardware-IDs" aus.

   Die HID\CFU_VIRTUAL_DEVICE sollte wie hier gezeigt im Listenfeld "Wert " angezeigt werden:

   

10. Wählen Sie im menü Geräte-Manager das Menü "Ansicht" und dann das Menüelement "Geräte nach Verbindungsmenü" aus.

    

11. Navigieren Sie zum CfuVirtualHid-Gerät , und erweitern Sie den Knoten "CfuVirtualHid Device ", erweitern Sie den HID-Geräteknoten (Virtual HID Framework, VHF) und wählen Sie das HID-kompatible Gerätelistenelement aus, wie hier gezeigt:

    

12. Klicken Sie mit der rechten Maustaste auf das HID-kompatible Gerät , um das Kontextmenü zu öffnen, und klicken Sie dann auf das Menüelement "Eigenschaften ", um das Dialogfeld "HID-kompatible Geräteeigenschaften " zu öffnen.

13. Wählen Sie die Registerkarte "Details" im Dialogfeld "HID-kompatible Geräteeigenschaften" und dann in der Dropdownliste "Eigenschaft" die Option "Hardware-IDs" aus.

    HiD\VID_045E&FA00_U:00F5 sollte im Listenfeld "Wert" angezeigt werden, wie hier gezeigt:

    

Installieren eines Firmwareupdates für das virtuelle CFU-HID-Gerät

Dieser Abschnitt enthält ein Beispiel für die Installation eines Firmwareupdates auf dem in Visual Studio 2019 integrierten CfuVirtualHid-Gerätegerät, das mit dem Befehlszeilentool devcon.exe installiert wurde, wie im obigen Abschnitt beschrieben.

1. Navigieren Sie zum Speicherort der INF-Datei und des Firmwareangebots und der Nutzlast .bin Dateien für Ihr Zielgerät. Zum Beispiel:

   

2. Öffnen Sie in einem Text-Editor ihre Firmwareupdate-INF-Datei. In diesem Beispiel verwenden wir die Datei CfuVirtualHidDeviceFwUpdate.inf , die in der CFU INF-Konfiguration beschrieben ist.

3. Wechseln Sie in der [Standard.NTamd64] INF-Datei des Firmwareupdates zum Abschnitt, und überprüfen Sie, ob die folgenden Informationen für das HID\VID_045E&UP:FA00_U:00F5-Gerät vorhanden sind:

   [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. Führen Sie an einer Administratorbefehlsaufforderung den folgenden Befehl aus:

   pnputil /add-driver CfuVirtualHidDeviceFwUpdate.inf /install

   Dieser Befehl gibt die PnP Utility-Ausgabe zurück. Zum Beispiel:

   

5. Navigieren Sie in Geräte-Manager zum CfuVirtualHid Device-Knoten, und erweitern Sie dann den Knoten, um zu überprüfen, ob das CfuVirtualHidDevice Firmware Update installiert wurde, wie hier gezeigt:

   

6. Wählen Sie den CfuVirtualHidDevice Firmware Update-Knoten aus, und öffnen Sie dann das Fenster "CfuVirtualHidDevice Firmware Update Properties ", wie hier gezeigt:

   

7. Wählen Sie im Fenster "CfuVirtualHidDevice Firmware Update Properties " die Registerkarte "Details " und dann "Hardware-IDs " in der Dropdownliste "Eigenschaft " aus, wie hier gezeigt:

   

8. Vergewissern Sie sich, dass das HID\VID_045E&VID_045E:FA00_U:00F5-Gerät im Hardware-ID-Wert des CfuVirtualHidDevice Firmware-Updates angezeigt wird.

   

9. Verwenden Sie die TraceView-Anwendung , um Protokollnachrichteninformationen für die installation des virtuellen CFU-HID-Geräts anzuzeigen. Zum Beispiel: